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
Next revisionBoth sides next revision
filereference:output:start [2015/12/09 22:44] – [Level 1: Storage by folder name] enviadminfilereference:output:start [2019/05/31 13:16] – [Overview] enviadmin
Line 5: Line 5:
 In general, there are two different types of output files regardless their content: In general, there are two different types of output files regardless their content:
   * **Simple Text Files**: Files which contain data in pure ASCII text format. Usually, the content of the file are described in the first row of the file. These file can be read and visiualized with any software that can read text files (which should be about every piece of software that can visiualize data).   * **Simple Text Files**: Files which contain data in pure ASCII text format. Usually, the content of the file are described in the first row of the file. These file can be read and visiualized with any software that can read text files (which should be about every piece of software that can visiualize data).
-  * **Binary Files (EDX/EDT)**: The main ENVI-met output files are stored in a binary format and require special software to be read. The [[leonardo:start|LEONARDO 2014]] software included in the ENVI-met system offers a comfortable and visual access to all data and give various options for 2D and 3D visualisation. In addition, with the help of the reference for the [[filereference:edx_edi|EDX/EDT file format]], own reader routines can easily be developed.+  * **Binary Files (EDX/EDT)**: The main ENVI-met output files are stored in a binary format and require special software to be read. The [[leonardo:start|LEONARDO]] software included in the ENVI-met system offers a comfortable and visual access to all data and give various options for 2D and 3D visualisation. In addition, with the help of the reference for the [[filereference:edx_edi|EDX/EDT file format]], own reader routines can easily be developed.  Moreover, ENVI-met provides the option to convert EDX/EDT data to the [[wp>NetCDF|NetCDF format]]  via the **NetCDF application** found in the Headquarter
  
 ===== Name and storage logic ===== ===== Name and storage logic =====
Line 16: Line 16:
 ==== Level 1: Storage by folder name ==== ==== Level 1: Storage by folder name ====
  
-[{{ :filereference:output:outputfolders.png ?nolink 600 |Root output folders of ENVI-met 4}}]+{{ :filereference:output:outputfolders.png ?nolink 600 |Root output folders of ENVI-met 4}}
  
-The uppermost level of file organisation starts by sorting the output files into subfolders of the selected output folders. The figure above shows the folder structure of a typical ENVI-met output folder (some folders are only existing in the Advanced version of ENVI-met). 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, click on the "→Read more..." below+The uppermost level of file organisation starts by sorting the output files into subfolders of the selected output folders. The figure above shows the folder structure of a typical ENVI-met output folder (some folders are only existing in the Advanced version of ENVI-met). 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, click on the "→Read more..." below.
  
-  - **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). [[filereference:output:atmosphere | →Read more...]]  +  -  **[[filereference:output:atmosphere | → 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**  \\ Data along the canvas (facades and roofs) of the buildings. Includes static data such as material, albedo (folder ''STATIC'') as well as dynamic data of meteorology along the building and building physics data (folder ''DYNAMIC'', ENVI-met PLUS/ Xpert only). →Read more... +  - **Buildings**   Data along the canvas (facades and roofs) of the buildings. Includes static data such as material, albedo (folder ''STATIC'') as well as dynamic data of meteorology along the building and building physics data (folder ''DYNAMIC'', not in BASIC). →Read more... 
-  - **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. →Read more...  +  - **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. →Read more...  
-  - **Log** \\ A copy of the ENVI-met outputs generated during the model run. →Read more... +  - **Log**  A copy of the ENVI-met outputs generated during the model run. →Read more... 
-  - **Pollutants** \\ Data about pollutant concentration in the model atmosphere (only present if pollutants are used in the model). →Read more... +  - **Pollutants**  Data about pollutant concentration in the model atmosphere (only present if pollutants are used in the model). →Read more... 
-  - **Radiation** \\ Detailed data sets about the different radiation fluxes in the model. →Read more... +  - **Radiation**  Detailed data sets about the different radiation fluxes in the model. →Read more... 
-  - **Receptors** \\ Time series and profile data at defined receptor points in the model (if defined)   →Read more... +  - **Receptors**  Time series and profile data at defined receptor points in the model (if defined)   →Read more... 
-  - **Soils** \\  State of the ENVI-met soil model  →Read more... +  - **Soils**   State of the ENVI-met soil model  →Read more... 
-  - **SolarAccess** \\  Detailed analysis on solar access data such as solargrams, sun hours, etc (ENVI-met Advanced only) →Read more... +  - **SolarAccess**   Detailed analysis on solar access data such as solargrams, sun hours, etc (ENVI-met PRO/SCIENCE only) →Read more... 
-  - **Surface** \\  State of the soil surface as an interface between the atmosphere and the soil model  →Read more...+  - **Surface**   State of the soil surface as an interface between the atmosphere and the soil model  →Read more... 
 +  - **Vegetation**   State of the vegetation including detailed log of observed 3D plants →Read more...
  
-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 storge will be the same. 
  
Line 37: Line 38:
 Sorting the output files into folders provides a first system of order in the output data. However, once a file has been moved out of its folder or if several simulations come together, this system is not unique and not persistent. As a solution, the ENVI-met file name generation scheme allows a direct identification of the simulation files and their content. Sorting the output files into folders provides a first system of order in the output data. However, once a file has been moved out of its folder or if several simulations come together, this system is not unique and not persistent. As a solution, the ENVI-met file name generation scheme allows a direct identification of the simulation files and their content.
  
-[{{ :filereference:output:filenamegeneration.png ?nolink 300 |Logic of ENVI-met output files file name generation}}]+{{ :filereference:output:filenamegeneration.png ?nolink 300 |Logic of ENVI-met output files file name generation}}
  
 Each ENVI-met output filename consists of 3 parts:  Each ENVI-met output filename consists of 3 parts: 
   - **Simulation Base Name**: This is the given working name for the simulation. You define this name in the .SIMX simulation configuration file. It should be not too log (as more data are added) and unique. In the example above,  ''urbanLayout'' has been selected  as basename.   - **Simulation Base Name**: This is the given working name for the simulation. You define this name in the .SIMX simulation configuration file. It should be not too log (as more data are added) and unique. In the example above,  ''urbanLayout'' has been selected  as basename.
   - **Type identifier**:  The type identifier describes the content of the file following the categories listed above. For example ''_AT_'' defines that this file holds atmospheric data. The different content ids are listed in the description of the output files categories and at the end of this page.    - **Type identifier**:  The type identifier describes the content of the file following the categories listed above. For example ''_AT_'' defines that this file holds atmospheric data. The different content ids are listed in the description of the output files categories and at the end of this page. 
-  - **Time of data**: The last part of the filename represents the model time the data were taken. In the example above, the file represents the stae of the atmosphere (''_AT_'') at 13:00 model time. If the data in the file are not time sensitive, this part of the filename is empty.+  - **Time of data**: The last part of the filename represents the model time the data were taken. In the example above, the file represents the state of the atmosphere (''_AT_'') at 13:00 model time. If the data in the file are not time sensitive, this part of the filename is empty. From Version 4.4.3 (Summer 19) onwards, the order of the time step has been changed to Year-Month-Date (YYYY-MM-DD + Time)
  
  
Line 50: Line 51:
  
  
-=== File Identifiers ===+==== Sumary on File Identifiers ===
 + 
 +<WRAP box left 80%> 
 +^ ID ^ Content ^ Remark ^ 
 +| _AT_ | Atmospheric data  |  | 
 +| _BLDG_ | Building data  | Both STATIC and DYNAMIC   | 
 +| _POLU_ | Pollutants  |  | 
 +| _SO_ | Soil data  |  | 
 +| _SA_ | Solar Access  | Main 3D Model | 
 +| _SAFAC_ | Solar Accerss   | Facade and Single Wall data  | 
 +| _FX_ | Surface data and surface fluxes  |  | 
 +| _VEG_ | Vegetation data  | Main 3D Model, Observed plants are text files | 
 +</WRAP> 
 + 
 +<WRAP clear></WRAP> 
 + 
 +Other files are ASCII files.
  
-_AT_ : Atmospheric data file 
  
-(to be cont.)