Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
filereference:output:start [2021/11/10 10:10] – [Text Files: Overview and description] enviadminfilereference:output:start [2023/02/26 18:43] (current) – [Level 1: Storage by folder name] enviadmin
Line 22: Line 22:
 ==== Level 1: Storage by folder name ==== ==== Level 1: Storage by folder name ====
  
-{{ :filereference:output:outputfolders.png ?nolink 600 |Example Root output folders of ENVI-met}} +The uppermost level of file organisation starts by sorting the output files into subfolders of the selected output folders. Some folders are only existing in the full version of ENVI-met, others may be added in the course of time. All files in one folder are of the same structure and contain the same set of information, some of the output folders are further organized in sub folders. The following list summarizes the basic content of the folders. For more information on the file types, see sections below.
- +
-The uppermost level of file organisation starts by sorting the output files into subfolders of the selected output folders. The figure above shows an example of the folder structure of a typical ENVI-met output folder (some folders are only existing in the Advanced version of ENVI-met, others may be added in the course of time). All files in one folder are of the same structure and contain the same set of information, some of the output folders are further organized in sub folders. The following list summarizes the basic content of the folders. For more information on the file types, see sections below.+
  
 +  - **InputData:**   //This folder contains a copy of all relevant simulation files (.INX, .SIMX,...),  database files and forcing data used in the simulation. Using this folder, you can reconstruct your model settings as they have been at the time of simulation even if they have been changed afterwards. This folder is required by several tools such as BIO-met. (Added with V5.0.3)//
   -  **Atmosphere:**  All information about the state of the atmosphere at different times of model simulation. Definitely the largest set of data and mostly considered as "the" model result (which is not true as the other data are very important, too).    -  **Atmosphere:**  All information about the state of the atmosphere at different times of model simulation. Definitely the largest set of data and mostly considered as "the" model result (which is not true as the other data are very important, too). 
   - **Buildings:**   Detailed data for the facades and roofs of the buildings. Folder includes static data such as material, albedo (folder ''STATIC'') as well as dynamic data of meteorology along the building and building physics data like temperatures and fluxes (folder ''DYNAMIC'', not in ENVI-met LITE). In addition, summary files about the different buildings are included.   - **Buildings:**   Detailed data for the facades and roofs of the buildings. Folder includes static data such as material, albedo (folder ''STATIC'') as well as dynamic data of meteorology along the building and building physics data like temperatures and fluxes (folder ''DYNAMIC'', not in ENVI-met LITE). In addition, summary files about the different buildings are included.
   - **[[filereference:output:inflow | → Inflow:]]**  Data about the inflow model of ENVI-met used to represent the surroundings of the model domain that cannot be modelled in the given scale.    - **[[filereference:output:inflow | → Inflow:]]**  Data about the inflow model of ENVI-met used to represent the surroundings of the model domain that cannot be modelled in the given scale. 
   - **Log:**  A copy of the ENVI-met outputs generated during the model run.    - **Log:**  A copy of the ENVI-met outputs generated during the model run. 
-  - **[[filereference:output:pollutants | → Pollutants:]]**  Data about pollutant concentration in the model atmosphere (only present if pollutants are used in the model).  +  - **Pollutants:**  Data about pollutant concentration in the model atmosphere (only present if pollutants are used in the model).  
-  - **[[filereference:output:radiation | → Radiation:]]**  Detailed data sets about the different radiation fluxes in the model.+  - **Radiation:**  Detailed data sets about the different radiation fluxes in the model.
   - **[[filereference:output:receptors | → Receptors:]]**  Time series and profile data at defined receptor points in the model (if defined)     - **[[filereference:output:receptors | → Receptors:]]**  Time series and profile data at defined receptor points in the model (if defined)  
-  - **[[filereference:output:soil | → Soil:]]**   State of the ENVI-met soil model  +  - **Soil:**   State of the ENVI-met soil model  
-  - **[[filereference:output:solar | → Solar Access:]]**   Detailed analysis on solar access data such as solargrams, sun hours, etc (Full versions of ENVI-met  only) +  - **Solar Access:**   Detailed analysis on solar access data such as solargrams, sun hours, etc (Full versions of ENVI-met  only) 
-  - **[[filereference:output:surface | → Surface:]]**   State of the soil surface as an interface between the atmosphere and the soil model +  - **Surface:**   State of the soil surface as an interface between the atmosphere and the soil model 
   - **Vegetation:**   State of the vegetation including detailed log of observed 3D plants. Contains 3D data and text data for observed plants which are organized in a ''STATIC'' folder for constant properties and a ''DYNAMIC'' folder with time-dependent properties of the plants.   - **Vegetation:**   State of the vegetation including detailed log of observed 3D plants. Contains 3D data and text data for observed plants which are organized in a ''STATIC'' folder for constant properties and a ''DYNAMIC'' folder with time-dependent properties of the plants.
 + 
 In addition, the BIOMet tool will create further folders, by default labled "**Biomet**", but with a free choice of names. In addition, the BIOMet tool will create further folders, by default labled "**Biomet**", but with a free choice of names.
-Future versions or additional modules of ENVI-met will create further folders and file, but the general concept of storge will be the same. +Future versions or additional modules of ENVI-met will create further folders and file, but the general concept of storage will be the same. 
  
 ==== Level 2: Classification by file name or extension ==== ==== Level 2: Classification by file name or extension ====
Line 71: Line 70:
 ^ID  ^Content  ^Remark  ^Details ^ ^ID  ^Content  ^Remark  ^Details ^
 | AT | Atmospheric data  | 3D Data Main state of the atmosphere with most of the variables in it |   [[filereference:output:atmosphere|{{:filereference:output:about_24.png?nolink |}}]] | | AT | Atmospheric data  | 3D Data Main state of the atmosphere with most of the variables in it |   [[filereference:output:atmosphere|{{:filereference:output:about_24.png?nolink |}}]] |
-| FX | Surface data and surface fluxes  | 2D Data describing state and fluxes at the ground surface | +| FX | Surface data and surface fluxes  | 2D Data describing state and fluxes at the ground surface |    [[filereference:output:surface|{{:filereference:output:about_24.png?nolink |}}]] 
-| SO | Soil data  | 3D Data  about the state of the soil model, mainly temperature and soil water |+| SO | Soil data  | 3D Data  about the state of the soil model, mainly temperature and soil water |    [[filereference:output:soil|{{:filereference:output:about_24.png?nolink |}}]] |
 | VEG | Vegetation data  | Plant data like Leaf Temperature in the context of the 3D Model, Detailed data for observed plants are additional text files of ''.VEG_status'' type (see below)|    [[filereference:output:vegetation|{{:filereference:output:about_24.png?nolink |}}]] | | VEG | Vegetation data  | Plant data like Leaf Temperature in the context of the 3D Model, Detailed data for observed plants are additional text files of ''.VEG_status'' type (see below)|    [[filereference:output:vegetation|{{:filereference:output:about_24.png?nolink |}}]] |
 | BLDG_static | Building data static  | Static building data like material properties (Subfolder ''STATIC'' | [[filereference:output:building_static|{{:filereference:output:about_24.png?nolink |}}]] | | BLDG_static | Building data static  | Static building data like material properties (Subfolder ''STATIC'' | [[filereference:output:building_static|{{:filereference:output:about_24.png?nolink |}}]] |
 | BLDG | Building data dynamic  | Dynamic building data like wall temperatures or state of facade greeings (Subfolder ''DYNAMIC'') | [[filereference:output:building_dynamic|{{:filereference:output:about_24.png?nolink |}}]] | | BLDG | Building data dynamic  | Dynamic building data like wall temperatures or state of facade greeings (Subfolder ''DYNAMIC'') | [[filereference:output:building_dynamic|{{:filereference:output:about_24.png?nolink |}}]] |
-| POLU | Pollutants  | 3D Data containing air pollutants including chemical conversion rates if used  | +| POLU | Pollutants  | 3D Data containing air pollutants including chemical conversion rates if used  |   [[filereference:output:pollutants|{{:filereference:output:about_24.png?nolink |}}]] | 
-| BIO | Biomet Data  | Data generated by BIO-met | +| RD | Radiation Data  | 3D Data with detailed information about shortwave and longwave radiation fluxes|    [[filereference:output:radiation|{{:filereference:output:about_24.png?nolink |}}]] 
-| SA | Solar Access  Main 3D Model +| BIO | BIO-met Data  | Data generated by BIO-met | 
-| SAFAC | Solar Access   | Facade and Single Wall data  | +| SA | Solar Access   Solar Access Data for the ground and Biomet level |   [[filereference:output:solar|{{:filereference:output:about_24.png?nolink |}}]] 
-VEG Vegetation data  | Main 3D Model, Observed plants are text files | +| SAFAC | Solar Access on Facades and Roofs  Solar Access for Facade/ Roofs and Single Walls    [[filereference:output:solarfacade|{{:filereference:output:about_24.png?nolink |}}]] |
-| IVSIndexed View Sphere | Data on the Index View Sphere if used | +
 </WRAP> </WRAP>
  
Line 98: Line 95:
 | .AT_1DR | Receptor Atmospheric data  (Profile) | Vertical profile atmosphere at receptor at a given model time | | .AT_1DR | Receptor Atmospheric data  (Profile) | Vertical profile atmosphere at receptor at a given model time |
 | .AT_1DT | Receptor Atmospheric data  (Time Series)  | Vertical profile atmosphere at receptor for all model times of simulation in one file | | .AT_1DT | Receptor Atmospheric data  (Time Series)  | Vertical profile atmosphere at receptor for all model times of simulation in one file |
-| .FX_1DT | Receptor Surface data (Time Series)  | Time series of gound surface state at receptor for all model times |+| .FX_1DT | Receptor Surface data (Time Series)  | Time series of ground surface state at receptor for all model times |
 | .SO_1DR | Receptor Soil data (Profile)  | Vertical profile soil at receptor at a given model time  | | .SO_1DR | Receptor Soil data (Profile)  | Vertical profile soil at receptor at a given model time  |
 | .SO_1DT | Receptor Soil data (Time Series) | Vertical profile soil at receptor for all model times of simulation in one file  | | .SO_1DT | Receptor Soil data (Time Series) | Vertical profile soil at receptor for all model times of simulation in one file  |
 | .BLDG_status | Single Building Status (Time Series) | Actual status of individual buildings for all model times of simulation in one file (one for each building) | | .BLDG_status | Single Building Status (Time Series) | Actual status of individual buildings for all model times of simulation in one file (one for each building) |
-| .BLDG_statistics | Building Statistics | Summary of static paramters for  the buildings (one for each building) |+| .BLDG_statistics | Building Statistics | Summary of static parameters for the buildings (one for each building) |
 | .BLDG_list | Buildings Inventory | List of all buildings in model (all buildings in one file) | | .BLDG_list | Buildings Inventory | List of all buildings in model (all buildings in one file) |
 | .VEG_status | Vegetation Status (Time Series)  | Actual status of 3D vegetation for all model times of simulation (only for observed plants) | | .VEG_status | Vegetation Status (Time Series)  | Actual status of 3D vegetation for all model times of simulation (only for observed plants) |
Line 120: Line 117:
 import pandas as pd import pandas as pd
  
-# this imports the text file "mysourcefile" into a Panda dataframe object.+# this imports the (ENVI-met) text file "mysourcefile" into a Panda dataframe object. 
 +# Comma "," is selected as seperator sign, 
 # the "DateTime" column is flaged to be handeld as date information  # the "DateTime" column is flaged to be handeld as date information 
 # and also is set as the default index column for data processing # and also is set as the default index column for data processing