Differences

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

--- file_format_specifications [2012/07/02 18:37] – 134.93.180.188
+++ file_format_specifications [2012/07/06 19:13] – [Overview] 134.93.180.188
@@ Line 12: / Line 12: @@
   - [[Main Section: Building Height]]
   - [[Main Section: Building Bottoms]] (optional)
-  - [[Main Section: Additional Plants]] (optional)
+  - [[Additional Plants|Main Section: Additional Plants]] (optional)
   - [[Main Section: Soils]]
@@ Line 27: / Line 27: @@
 I admit that this is not very straight forward, but I also have to say again, that the normal ENVI-met users does not have to mess around with these internals because the editor is taking care of it. For the normal user this way is the most comfortable, because any ENVI-met input file from Version 1.0 on can be loaded into the recent model version. If you are going to program something for ENVI-met... well I'm sorry to tell but you are on the compatibility boat, too.
-===== I. File Header =====
-The file header contains the basic information about the model dimensions and other metadata required to construct the computer model.
-<file>
-: 2Z-V5
-: % Model description
-: ENVI-met test area
-: % Number of grids in x, y and z direction
-: 20
-: 26
-: 25
-: % Base Horizontal Gridsize dx, dy
-: 2.00
-: 2.00
-: % Vertical Gridsize
-: 2.00
-: % Telecoping vertical Grid? 0= No 1= Yes
-: 0 or 1
-a: % Telecoping factor in %
-b: 20
-c: % Start z-level for telecoping
-d: 30.00
-: % Model rotation out of grid north in deg
-: 0.0
-: % Number of nesting grids
-: 3
-: % Soil Profile ID for Nesting Grid A
-: cl
-: % Soil Profile ID for Nesting Grid
-: as
-: % Geographical Projection System
-: GK
-: % Real world coordinate lower left grid x and y
-: 2000.00
-: 2000.00
-: % Name of location (city,..)
-: Essen/Germany
-: % Position on earth (longitude and latitude)
-: 53.00
-: 7.00
-: % Name of reference time zone
-: CET/UTC+1
-: % Definition longitude of time zone
-: 15.00
-: % Define where area data are located
-: [INTERNAL]
-(...)
-</file>
-Most of the lines are self-explaining, however, a brief description what they mean follows next.\\
-**In general, lines beginning with "%" are remark lines. Even if they do not contain information, they must
-be kept and they cannot be extended by more remark lines in order to fullfill the format of the file.**
-=== 01 Format ID ===
-Defines the number of characters defining one number in the matrix blocks. See annotations [[here]].\\
--V5 indicates an area input file in format version 5 used by ENVI-met V3.1 and newer.\\
-Other formats are no longer supported by ENVI-met, but can be loaded and then saved in the Editor!
-=== 02-03: Model Description ===
-Free text line describeing the model area
-=== 04-07: Number of Grids in x-, y- and z-Direction ===
-The values for x- and y- must correspond to the matrix data following later in the file.\\
-The number of z-values must be defined by the user.\\
-When using the equidistant grid method, the lowest grid box above the surface is automatically split into 5 sub-boxes with Δzs=0.2 Δz. These additional 4 boxes are not included in the number of z-grids given here.\\
-The final model size is increased by the [[nesting grids]] and the additional 4 surface-boxes mentioned above. Make sure, that your area is not too big to run ENVI-met.
-=== 08-12: Base Grid Size in x-, y- and z-Direction ===
-Defines the size of one grid point in meters in the x- y- and z-direction.\\
-Equidistant spacing is used in this version except of the nesting grids and the z-grids if a telecoping grid is used.\\
-For more details see [[Vertical Grid Layout]].
-=== 13-14: Usage of Telecoping Vertical Grid yes/no ===
-If a telecoping grid is used ("1" in line 14) the lines 14 a- d follow.\\
-If no telecoping gird is used, the next line will be line 15 .
-=== 15-16: Model Rotation Settings ===
-Model rotation out of grid north in degrees. For more information [[see here]].
-=== 17-22: Nesting Grid Settings ===
-L 18 defines the number of nesting grids. For more information [[see here]].\\
-Ls 20, 22 define the ID of the soil profiles to be assigned alternating to the nesting grids (e.g. "cl").\\
-[[For more information see here]].
-=== 23-27: Georeference Settings ===
-Defines the geographical projection system (not used yet) and the real world reference of the lower left grid.\\
-Will be used for model management later on, for the moment only for information.
-=== 28-36: Geographical Position of the Domain ===
-Defines the location in terms of name, longitude, latitude and time zone reference.\\
-See ENVI-met editor for details.
-=== 37-38:  Data File Link ===
-In version 3.1, only the [INTERNAL] format is supported which means that the geometry data are included inside this area input file.
-===== II. Main Section: Building Height =====
-If the [INTERNAL] format is used, the header is followed by the main section defining the position and height of **buildings**.\\
-[[Click here to see an example section]]\\
-The format chosen in the first line of the file ([[Format-ID]]) is used here. Buildings are set into the area by assigning their height to the corresponding grid points ("**20**" in the [[example]]).\\
-Only integer values are allowed as height information.
-ENVI-met will assign the building to the corresponding grid boxes. In the vertical direction, the following rule is used to decide if a grid box is occupied by a building or not: If a grid cell is covered 50% or more by a building, it becomes part of the building. In the other case, it remains free.
-<fs smaller>**Example**\\
-A 14m high building covers 3 grid cells with Δz=5m (split surface grid not counted).\\
-Contrary, a 12m building will only be represented by 2 grids in the vertical.</fs>
-=== Avoiding Captured Grids ===
-Captured grids can cause problems in the model simulation.\\
-A "captured grid" is a free grid cell that is surrounded by occupied grid cells only.\\
-[[Click here to see an example for captured grids]]
-===== III. Main Section: Building Bottoms (optional) =====
-Buildings defined using the section explained above all start at ground surface (z=0) as houses normally do.\\
-If you want to define buildings beginning at a different height, an additional Building Bottom Section is needed.\\
-[[Click here to see an example section]]\\
-This section begins with the keyword "\BOTTOM" followed by a structure similar to the main section shown before.\\
-Again, the height to building bottom is given in meters. Bottom information without a building on the grid or bottoms higher than the roof level of the associated building are ignored. The vertical grid resolution limits the possibilities of defining overhanging structures.
-If you don't need non-zero bottoms, the "\BOTTOM" keyword must be replaced with a single remark line "%....".
-===== IV. Main Section: Plants =====
-This section saves the plants defined in your model area. Contrary to previous formats, plants will not be mixed with buildings in the first section of the input file.\\
-Each plants is defined by its unique two-char ID.\\
-[[Click here to see an example section]]
-<fs smaller>**Hint**\\
-Don't forget, that planting trees on a roof increases the total height of the model domain a lot!\\
-Make sure that the total vertical extension of the domain is sufficient!\\
-(see also [[here]])</fs>
-===== V. Main Section: Soils =====
-For every grid in the area, a soil profile and surface material can be chosen individually.\\
-There are two ways to provide this information:
-=== Case A: Each grid in the domain has the same soil profile ===
-In this case no individual information is needed for each single grid point.\\
-A common soil is defined by placing the line <fs smaller>''\ALLSOILS=" l"''</fs>\\
-(if all soils are supposed to be of the " l" type or any other valid soil ID)
-=== Case B: Grids have different soil profiles ===
-In this case, a complete ''\SOILS'' section has to be used to provide this information.\\
-[[Click here to see an example section]]\\
-===== =====
-In both cases, the soil profiles are defined by a two-digit ID (like the vegetation).\\
-All used IDs must be stored in the file ''[[PROFILES.DAT]]''.\\
-Invalid profile definitions will be replaced by the default soil profile, which is the first profile defined in ''PROFILES.DAT''.\\
-For more information about databases and their internal connections refer to [[Database Files Overview]].
-===== A. Additional Optional Sections: Sources =====
-The Sources section begins with the keyword ''\SOURCES'' followed by the complete grid matrix like in the ''\PLANTS'' section.\\
-This section defines the position of different sources in the model domain. As the concept is the same as for plants, this section is not displayed here.\\
-Any source will be referenced using the two-char ID as defined in ''[[SOURCES.DAT]]'' or a [[local database]]. The two-char ID is non-case sensitive, "XX" is the same as "xx"!\\
-Sources that are inserted in the Area Input File but cannot be found in a database when starting the model will be ignored.
-===== B. Additional Optional Sections: Receptors =====
-Receptors inside the model area are defined using the ''\RECEPTOR'' section. The concept is the same as for the plants explained in the section before. Each receptor is defined by a unique two-char ID. If duplicate receptors are found, the first defined receptor is used, the others are ignored. For more information about receptors click [[here]].
-===== C. Additional Optional Sections: DB-Links =====
-The database section has no function in ENVI-met. It is used for other programs such as BOTworld (see ''UNCONVERTED WINHELP MACRO:! ExecFile'' www.botworld.info) to link certain grid points with database entries.
-===== D. Additional Optional Sections: DEM =====
-This sections defines a so-called "inline" digital elevation model. The recent version of ENVI-met does not support orography, but ENVI-met already holds a number of interfaces to include it in future versions.