param.ini
Configuring the modeling chain with param.ini file
Tip
The different parameters used by the modeling chains all have default values, so that none of the possible entries is required.
Info
All set of parameters used in ZephyFarm sub-applications may contain some comment entries. These entries are only used by the web-client and are not processed by the modelling chain.
Danger
The default sets of parameters proposed in ZephyFarm sub-applications may contain entries set between % characters (ie. wrg_heights=%heights%
).
These entries are to be modified by the web-client on a latter stage.
If the entry set with a value, the value will be applied and the project will differ from how it was defined in the app.
The parameters are gathered in various subgroups:
-
Configure: parameters used during the configuration step.
-
Mesh-M1-*: parameters used by during the mesh generation step.
-
Calc-C1-*: parameters used by the "calc_C1" step
-
[Extern]: parameters defining the configuration of the extern programs (as OpenFoam)
-
[Client]: defines the execution client used to run the modeling chain
-
[Pictures]: parameters defining the visualizations
-
[Company]: information related to the company
-
[Project]: information related to the project
-
[Zephy*]: chain related parameters
-
[AutoConf]: parameters defining how the mesh and the calculation parameters will be automatically chosen in the case they are not provided as arguments to the program
[Configure] section
This section defines the parameters used during the configuration step.
[Configure]
comment="default for all"
meso_auto=False
terrain=srtm3
roughness=glc17
xc=-1.e+8
yc=-1.e+8
centre=AUTO
method=mid
diamin=-1
diavisu=-1
diaslope=-1
resvisu=-1
wrg_auto=True
wrg_extradist=250.
wrg_reso=20.
wrg_limit=1000
dz_shear=100.
wrg_heights=[]
visu_heights=[]
slope_gres=50.
slope_rad=100.
slope_res=100.
slope_ncalc=8
slope_autocontour=8.
slope_contourlengthlimit=5000.
slope_contournumberlimit=10
rix_rad=10000.
rix_slope=15.
rix_res=50.
rix_ncalc=72
rix_nsect=12
Below, possible parameters for the configuration step are enumerated and described.
meso_auto - automatic mesoscale point generation
Defines if a mesoscale point should be automatically generated for the project.
meso_auto=False
; automatic mesoscale point generation [-]
; boolean
; validity: in [True,False]
; default: False
terrain - orography data source
Selects the data source for the elevation background data.
terrain=srtm3
; orography data source [-]
; string
; validity: in [none, srtm3, aster3]
; default: srtm3
Warning
terrain is automatically switched to "aster3" when project centers lies at at latitude greater than 59. degrees.
Warning
terrain is automatically switched to "none" when the project's georeference is "Fictive".
Tip
terrain=none
can be used to force the exclusive use of the user-defined orography data, removing any use of background data.
roughness - roughness data source
Selects the data source for the roughness background data.
roughness=glc17
; roughness data source [-]
; string
; validity: in [none, glc17, glc15]
; default: glc17
Warning
roughness is automatically switched to "none" when the project's georeference is "Fictive".
Tip
roughness=none
can be used to force the exclusive use of the user-defined roughness data, removing any use of background data.
xc - project center X-coordinate
Defines the project X-coordinate of the project centre.
xc=-1.e+8
; project center X-coordinate [m] or [decimal degrees]
; float ; if < -1.e+7 : automatic evaluation
; default: -1.e+8
Automatic evaluation
xc is automatically evaluated from the layout, the "centre" and the "method" parameters
yc - project center y-coordinate
Defines the project y-coordinate of the project centre.
yc=-1.e+8
; project center y-coordinate [m] or [decimal degrees]
; float ; if < -1.e+7 : automatic evaluation
; default: -1.e+8
Automatic evaluation
yc is automatically evaluated from the layout, the "centre" and the "method" parameters
centre - entity type for centre evaluation
Defines the type of entities used to evaluate the automatic centre coordinate.
Note
This parameter is only used when automatic evaluation of the project centre is activated.
centre=AUTO
; entity type for centre evaluation
; string
; validity: in [AUTO, bc, mast, wt, lidar, point, meso, wrg, interest, lidmap]
; default: AUTO
Automatic evaluation
centre is set to first existing type from interest / lidmap / meso / wrg / wt / mast / lidar / point.
Info
When centre is set to "bc", coordinates of both masts and wind turbines are used.
method - centre evaluation method
Defines the method to consider for automatic evaluation of the centre coordinates.
Note
This parameter is only used when automatic evaluation of the project centre is activated.
Info
When "bary" method is selected, centre coordinates are evaluated by averaging the entities coordinates.
Info
When "mid" method is selected, centre coordinates are evaluated by averaging minimal and maximal coordinates of the list of entities.
diamin - reference size for the project
Defines the size of the circular domain of interest around the project centre.
diamin=-1
; reference size for the project [m]
; float > 0. ; if < 0: automatic evaluation
; validity: diamin ≤ 100000.
; default: -1
Automatic evaluation
diamin is evaluated using expression: diamin = max(dia0, 1000.)
dia0 refers to the minimal diameter surrounding the entities defined for the project
diavisu - visualization grid diameter
Defines diameter of the visualization grid for the flow model iso-height results.
diavisu=-1
; visualization grid diameter [m]
; float > 0. ; if < 0: automatic evaluation
; validity: 200. ≤ diavisu ≤ 100000.
; default: -1
Automatic evaluation
diavisu is evaluated using expression: diavisu = diamin + 1000.
diaslope - slope grid diameter
Defines diameter of grid used for the slope analysis results
diaslope=-1
; slope grid diameter [m]
; float > 0. ; if < 0: automatic evaluation
; validity: 2000. ≤ diaslope ≤ 100000.
; default: -1
Automatic evaluation
diaslope is evaluated using expression: diaslope = diamin + 3000.
Danger
ZIX number depends on this parameter.
Within ZephyFarm-ZephyCFD, some automatic settings derived from ZIX value are automatically chosen in the web application; this automatic selection might not work properly as soon as this parameter is modified.
resvisu - visualization grid resolution
Defines the grid resolution for the visualization grid.
resvisu=-1
; visualization grid resolution
; float > 0. ; if < 0: automatic evaluation
; validity: 5. ≤ resvisu ≤ 200.
; default: -1
Automatic evaluation
resvisu is evaluated using expression: resvisu = max(20., diavisu / 200.)
wrg_auto - automatic wind resource grid generation
Activates automatic generation of of extra wind resource grids, for each of the wind turbine groups defined in the layout.
wrg_auto=True
; automatic wind resource grid generation [-]
; boolean
; validity: in [True,False]
; default: True
Info
If no wind turbine is defined for the project, it uses the met masts as the entities to include in the wind resource grid being generated.
wrg_extradist - extra distance for automatic wind resource grids
Defines extra distance around the entities to include in the wind resource grids.
Note
This parameter is only used when automatic wind resource grid generation is activated.
wrg_extradist=250.
; extra distance for automatic wind resource grids [m]
; float
; validity: 100. ≤ wrg_extradist ≤ 2000.
; default: 250.
wrg_reso - resolution for automatic wind resource grids
Defines the grid resolution for the automatically generated wind resource grids.
Note
This parameter is only used when automatic wind resource grid generation is activated.
wrg_reso=20.
; resolution for automatic wind resource grids [m]
; float
; validity: 5. ≤ wrg_reso ≤ 200.
; default: 20.
Warning
wrg_reso might not be applied, as soon as the wind resource grids limitation number becomes reached.
wrg_limit - wind resource grids limitation number
Defines the maximal number of elements that can be generated in a given direction for each of the wind resource grids.
wrg_limit=1000
; wind resource grids limitation number [-]
; integer
; validity: 100 ≤ wrg_limit ≤ 5000
; default: 1000
dz_shear - height difference for shear evaluation
Defines the vertical distance (centered on the evaluated height) used to evaluate the shear maps.
Info
Shear maps are evaluated for all the wind resource grids (including the user-defined and automatic ones).
dz_shear=100.
; height difference for shear evaluation [m]
; float
; validity: 4. ≤ dz_shear ≤ 200.
; default: 100.
Info
On a wrg per wrg basis, dz_shear may be automatically decreased if the wind resource height does not allow for result extraction at the lowest height.
Tip
Expected wind turbine diameter should be chosen.
wrg_heights - heights for automatic wind resource grids
Defines the heights used for the automatically generated wind resource grids.
Note
This parameter is only used when automatic wind resource grid generation is activated.
wrg_heights=[]
; heights for automatic wind resource grids [m]
; list(float)
; validity: 5. ≤ wrg_height ≤ 500.
; default: []
Warning
When multiple heights are specified in list, no whitespace should be written to separate the heights, as in: [50.,53.2,88.8]
Info
Heights of the wind resource grids defined within the inp_project are appended to this list.
Info
Heights defined in this list are appended to visu_heights.
It implies all the flow visualizations are to be generated at each of these heights.
visu_heights - heights for visualization results
Defines the heights used for the visualization results.
visu_heights=[]
; heights visualization results [m]
; list(float)
; validity: 5. ≤ visu_height ≤ 500.
; default: []
Warning
When multiple heights are specified in list, no whitespace should be written to separate the heights, as in: [50.,53.2,88.8]
Info
Heights defined in wrg_heights, as well as the heights of the interest areas defined within the inp_project, are appended to this list.
slope_gres - slope grid resolution
Defines the grid resolution for evaluating the slope maps.
slope_gres=50.
; slope grid resolution [m]
; float
; validity: 10. ≤ slope_gres ≤ 300.
; default: 50.
Danger
ZIX number depends on this parameter.
Within ZephyFarm-ZephyCFD, some automatic settings derived from ZIX value are automatically chosen in the web application; this automatic selection might not work properly as soon as this parameter is modified.
slope_rad - slope evaluation radius
Defines reference distance used to assess the directional slopes around each slope point.
slope_rad=100.
; slope evaluation radius [m]
; float
; validity: 100. ≤ slope_rad ≤ 1000.
; default: 100.
Danger
ZIX number depends on this parameter.
Within ZephyFarm-ZephyCFD, some automatic settings derived from ZIX value are automatically chosen in the web application; this automatic selection might not work properly as soon as this parameter is modified.
slope_res - slope evaluation resolution
Defines the resolution used to build the segments over which the slopes are to be evaluated.
slope_res=100.
; slope evaluation resolution [m]
; float
; validity: 1. ≤ slope_res ≤ 100.
; default: 100.
Danger
ZIX number depends on this parameter.
Within ZephyFarm-ZephyCFD, some automatic settings derived from ZIX value are automatically chosen in the web application; this automatic selection might not work properly as soon as this parameter is modified.
slope_ncalc - slope number of sectors
Defines the number of sectors for the slopes evaluation.
slope_ncalc=8
; slope number of sectors [-]
; integer
; validity: in [8, 12, 16, 24, 36, 48, 72, 144, 360]
; default: 8
Danger
ZIX number depends on this parameter.
Within ZephyFarm-ZephyCFD, some automatic settings derived from ZIX value are automatically chosen in the web application; this automatic selection might not work properly as soon as this parameter is modified.
slope_autocontour - initial slope criterion
Defines the initial slope criterion used to build the high slope areas.
slope_autocontour=8.
; initial slope criterion [deg]
; float
; validity: 1. ≤ slope_autocontour ≤ 20.
; default: 8.
slope_contourlengthlimit - high slope contours maximal length
Defines the maximal total length of the areas contours allowed for the high slope areas.
slope_contourlengthlimit=5000.
; high slope contours maximal length [m]
; float
; validity: 1000. ≤ slope_contourlengthlimit ≤ 10000.
; default: 5000.
Info
If the considered slope criterion generates too large set of contours (in terms of length), it is iteratively decreased to meet the maximal length condition.
slope_contournumberlimit - high slope contours maximal number
Defines the maximal number of areas contours allowed for the high slope areas.
slope_contournumberlimit=10
; high slope contours maximal number [-]
; integer
; validity: 5 ≤ slope_contournumberlimit ≤ 20
; default: 10
Info
If considered slope criterion generates to large set of contours (in terms of amount), the slope criterion is iteratively decreased to meet the maximal number condition.
rix_rad - RIX evaluation radius
Defines the distance over which the slope analysis is performed around an entity, in order to evaluate its associated RIX index.
rix_rad=10000.
; RIX evaluation radius [m]
; float
; validity: 500. ≤ rix_rad ≤ 10000.
; default: 10000.
Danger
ZIX number depends on this parameter.
Within ZephyFarm-ZephyCFD, some automatic settings derived from ZIX value are automatically chosen in the web application; this automatic selection might not work properly as soon as this parameter is modified.
rix_slope - RIX evaluation slope
Defines the slope criterion over which a slope segment is accounted in the high slope group.
Danger
ZIX number depends on this parameter.
Within ZephyFarm-ZephyCFD, some automatic settings derived from ZIX value are automatically chosen in the web application; this automatic selection might not work properly as soon as this parameter is modified.
rix_res - RIX evaluation resolution
Defines the size of the slope segments built during RIX analysis.
Danger
ZIX number depends on this parameter.
Within ZephyFarm-ZephyCFD, some automatic settings derived from ZIX value are automatically chosen in the web application; this automatic selection might not work properly as soon as this parameter is modified.
rix_ncalc - RIX number of evaluated directions
Defines the number of directions evaluated during the RIX analyses.
rix_ncalc=72
; RIX number of evaluated directions [-]
; integer
; validity: in [72, 90, 120, 180, 360]
; default: 72
Danger
ZIX number depends on this parameter.
Within ZephyFarm-ZephyCFD, some automatic settings derived from ZIX value are automatically chosen in the web application; this automatic selection might not work properly as soon as this parameter is modified.
rix_nsect - RIX number of reported directions
Defines the number of output directions evaluated during the RIX analyses.
rix_nsect=12
; RIX number of reported directions [-]
; validity: in [8, 12, 16, 24, 36, 48, 72]
; default: 12
Danger
ZIX number depends on this parameter.
Within ZephyFarm-ZephyCFD, some automatic settings derived from ZIX value are automatically chosen in the web application; this automatic selection might not work properly as soon as this parameter is modified.
[Mesh-M1-*] sections
Several sets of parameters can be configured in the same file.
Info
If new sets are to be introduced, new names should be chosen as a section name can only be used once.
Below, two sets of parameters are configured for the mesher M1 (sample1 and sample2). Sets of parameters are only described with one entry, defining "resfine" (all other variables will be configured with default parameters).
[Mesh-M1-default]
comment="default for all"
nsect=72
diaref=-1
diadom=-1
resfine=30.
rescoarse=-1
resratio=4
resdist=200.
Below, possible parameters for the mesher are enumerated and described.
nsect - number of computable directions
Drives the nodes location near boundaries, allowing the specified number of computable directions.
nsect=72
; number of computable directions [-]
; integer in [8,12,16,18,24,36,48,72,90,120,144,180,240,360]
; default: 72
diaref - refined zone diameter
Defines the central zone area where the mesh is to be refined.
diaref=-1
; refined zone diameter [m]
; float > 0. ; if < 0: automatic evaluation
; validity: diaref ≤ diamin + 100.
; default: -1
Automatic evaluation
diaref is set using expression: diaref = diamin + 2000.
diamin refers to the reference size of the project
diadom - domain diameter
Defines the diameter of the computation domain.
diadom=-1
; computation domain diameter [m]
; float > 0. ; if < 0: automatic evaluation
; validity: diaref + 5000. ≤ diadom ≤ 100000.
; default: -1
Automatic evaluation
diadom is set using expression: diadom = diaref + 20000.
resfine - fine resolution criterion
Defines the refined horizontal mesh resolution for the "Fine" mesh version.
resfine=30.
; fine resolution criterion [m]
; float > 0. ; if < 0: automatic evaluation
; validity: 1. ≤ resfine ≤ 250.
; default: 25.
Automatic evaluation
Automatic evaluation ⇒ resfine evaluated iteratively from specified meshlim condition
rescoarse - coarse resolution criterion
Defines the refined horizontal mesh resolution for the "Coarse" mesh version.
rescoarse=-1
; coarse resolution criterion [m]
; float > 0. ; if < 0: automatic evaluation
; validity: 1. ≤ rescoarse ≤ 500.
; default: -1
Automatic evaluation
When resratio == 1 ⇒ rescoarse is set using expresion: rescoarse = 2 × resfine
When resratio > 1 ⇒ rescoarse is set using expresion: rescoarse = resratio × resfine
Warning
When consistent_grids is set to True, rescoarse is forced to resfine.
resratio - heterogeneous refinement ratio
Defines the ratio between the resolution applied at refined central zone and the resolution applied at entity-related zones.
resratio=4
; heterogeneous refinement ratio [-]
; integer
; validity: 1 ≤ resratio ≤ 20
; default: 4
Info
When resratio is set to 1, it results in a homogeneous refinement over the refined zone diameter.
resdist - heterogeneous refinement distance
Drives the size of the refined areas surrounding each entity.
Note
This parameter is only used when resratio > 1.
resdist=200.
; heterogeneous refinement distance [m]
; float
; validity: 100. ≤ resdist ≤ 1000.
; default: 200.
multizone - multiple refinement criterion
Activates multiple refinement zones.
multizone=False
; multiple refinement criterion [-]
; boolean
; validity: in [True, False]
; default: False
Info
When set to False, one single refinement zone is generated.
contcrit - high slopes refinement criterion
Activates the use of the high slope contours for defining the refined areas.
contcrit=False
; high slopes refinement criterion [-]
; boolean
; validity: in [True, False]
; default: False
meshlim - number of cells criterion
Defines the maximal number of cells for the targeted mesh.
Note
This parameter is only used when resfine is defined with a negative value.
meshlim=(MEMMAX-0.1*MEMMAX)/1.e+6
; number of cells criterion [Millions of Cells]
; float
; validity: 0.1 ≤ meshlim ≤ 200.
; default: (MEMMAX-0.1*MEMMAX)/1.e+6
Info
MEMMAX is the local amount of RAM in kB.
relax_distratio - relaxation distance ratio
Defines the distance ratio from diamin to diadom to locate the relaxation.
relax_distratio=0.5
; relaxation distance ratio [-]
; float
; validity condition: 0.5 ≤ relax_distratio ≤ 0.9
; default: 0.5
relax_resfactor - relaxation factor
Defines factor applied to resfine to drive the relaxed mesh resolution.
relax_resfactor=20;
; relaxation factor [-]
; float
; validity: 2. ≤ relax_resfactor ≤ 100.
; default: 20.
Which effects?
The highest relaxation factor, the less cells for the resulting mesh.
The highest relaxation factor, the less accuracy for the flow model runs.
consistent_grids - consistent grids criterion
Defines if Coarse and Fine mesh versions should be forced to share the same ground nodes distribution.
consistent_grids=False
; consistent grids criterion [-]
; boolean
; validity: in [True, False]
; default: False
Info
When activated, vertical discretization solely drives the variations between the Coarse and Fine mesh versions.
What for?
This parameter was introduced in order to have smoother transitions between Coarse and Fine runs.
It was introduced as some robustness troubles were found after remapping from Coarse to Fine whith the canopy model being activated.
Since Canopy run was introduced, this parameter is to be depreciated.
htop - top boundary minimum height
Defines the minimal height that should be considered to evaluate the elevation of the top boundary condition.
htop=-1
; top boundary minimum height [m]
; float > 0. ; if < 0: automatic evaluation
; validity: 200. ≤ diavisu ≤ 100000.
; default: -1
Automatic evaluation
htop is evaluated from orography data, using: htop = 6 * (Zmax - Zmin)
Zmin and Zmax are the minimal and maximal ground elevations.
Info
The constant elevation used for defining the top boundary condition is then evaluated using:
Ztop = Zmin + htop
hturb - turbine zone height
Defines the height of the wind turbine refinement zone.
Info
The vertical size of the cells generated in the wind turbine zone is controlled using the turbine zone maximal vertical resolution.
hcanop - canopy zone height
Defines the height of the canopy refinement zone.
Info
The vertical size of the cells generated in the canopy zone is controlled using the canopy zone maximal vertical resolution.
Automatic Evaluation
hcanop is evaluated from roughness data, using: htop = max(10., 30 * zmax_rou)
zmax_rou is the maximal ground roughness length.
dzmin_coarse - coarse mesh minimal vertical resolution
Defines the height of the first layer of cells above the Coarse mesh version ground boundary.
dzmin_coarse=2.
; coarse mesh minimal vertical resolution [m]
; float
; validity: 0.01. ≤ dzmin_coarse ≤ 5.
; default: 2.
dzmin_fine - fine mesh minimal vertical resolution
Defines the height of the first layer of cells above the Fine mesh version ground boundary.
dzmin_fine=1.
; fine mesh minimal vertical resolution [m]
; float
; validity: 0.01. ≤ dzmin_coarse ≤ 2.
; default: 1.
dzcanop_coarse - coarse mesh canopy zone maximal vertical resolution
Defines the upper limit of the vertical size of the cells in the canopy zone of the Coarse mesh version.
dzcanop_coarse=4.
; coarse mesh canopy zone maximal vertical resolution [m]
; float
; validity: 2. ≤ dzcanop_coarse ≤ 10.
; default: 4.
dzcanop_fine - fine mesh canopy zone maximal vertical resolution
Defines the upper limit of the vertical size of the cells in the canopy zone of the Fine mesh version.
dzcanop_fine=2.
; coarse mesh canopy zone maximal vertical resolution [m]
; float
; validity: 2. ≤ dzcanop_coarse ≤ 5.
; default: 4.
dzturb_coarse - coarse mesh turbine zone maximal vertical resolution
Defines the upper limit of the vertical size of the cells in the turbine zone of the Coarse mesh version.
dzturb_coarse=10.
; coarse mesh turbine zone maximal vertical resolution [m]
; float
; validity: 5. ≤ dzturb_coarse ≤ 40.
; default: 10.
dzturb_fine - fine mesh turbine zone maximal vertical resolution
Defines the upper limit of the vertical size of the cells in the turbine zone of the Fine mesh version.
dzturb_fine=5.
; coarse mesh turbine zone maximal vertical resolution [m]
; float
; validity: 5. ≤ dzturb_coarse ≤ 20.
; default: 5.
dztop_coarse - coarse mesh maximal vertical resolution
Defines the upper limit of the vertical size of the cells for the Coarse mesh version.
dztop_coarse=2000.
; coarse mesh maximal vertical resolution [m]
; float
; validity: 100. ≤ dztop_coarse ≤ 2000.
; default: 2000.
dztop_fine - fine mesh maximal vertical resolution
Defines the upper limit of the vertical size of the cells for the Fine mesh version.
dztop_fine=1000.
; fine mesh maximal vertical resolution [m]
; float
; validity: 100. ≤ dztop_fine ≤ 1000.
; default: 1000.
expcanop_coarse - coarse mesh canopy zone expansion coefficient
Defines the expansion coefficient in the canopy zone of the Coarse mesh version.
expcanop_coarse=1.15
; coarse mesh canopy zone expansion coefficient [-]
; float
; validity: 1. ≤ expcanop_coarse ≤ 1.5
; default entry: 1.15
expcanop_fine - fine mesh canopy zone expansion coefficient
Defines the expansion coefficient in the canopy zone of the Fine mesh version.
expcanop_fine=1.1
; fine mesh canopy zone expansion coefficient [-]
; float
; validity: 1. ≤ expcanop_fine ≤ 1.5
; default: 1.1
expturb_coarse - coarse mesh turbine zone expansion coefficient
Defines the expansion coefficient in the turbine zone of the Coarse mesh version.
expturb_coarse=1.15
; coarse mesh turbine zone expansion coefficient [-]
; float
; validity: 1. ≤ expturb_coarse ≤ 1.5
; default: 1.15
expturb_fine - fine mesh turbine zone expansion coefficient
Defines the expansion coefficient in the turbine zone of the Fine mesh version.
expturb_fine=1.1
; fine mesh turbine zone expansion coefficient [-]
; float
; validity: 1. ≤ expturb_fine ≤ 1.5
; default: 1.1
exptop_coarse - coarse mesh top zone expansion coefficient
Defines the expansion coefficient in the top zone of the Coarse mesh version.
exptop_coarse=1.2
; coarse mesh top zone expansion coefficient [-]
; float
; validity: 1. ≤ exptop_coarse ≤ 1.5
; default: 1.2
exptop_fine - fine mesh top zone expansion coefficient
Defines the expansion coefficient in the top zone of the Fine mesh version.
exptop_fine=1.15
; fine mesh top zone expansion coefficient [-]
; float
; validity condition: 1. ≤ exptop_fine ≤ 1.5
; default entry: 1.15
nsmoo - number of smoothing loops
Defines the number of smoothing loops for the ground mesh.
smoocoef - smoothing coefficient
Defines how strong will be the smoothing in each of the smoothing loop.
insmoo - inlet smoothing method
Defines the smoothing method near site boundaries of the domain.
insmoo=extra
; inlet smoothing method [-]
; string
; validity: in [flat, without, extra]
; default: extra
Info
insmoo=without ⇒ no specific smoothing is applied
insmoo=extra ⇒ the terrain near the side boundaries is smoothed
insmoo=flat ⇒ the terrain near the side boundaries is smoothed toward a flat terrain
roudist - no canopy boundary ring length
Defines the size of the boundary ring in which the canopy modelling is not activated.
roudist=-1.
; no canopy boundary ring length [m]
; float > 0. ; if < 0: automatic evaluation
; validity: 0. <= roudist <= 100000.
; default: -1.
Automatic evaluation
roudist is evaluated using expression: roudist = diaref / 2. + 1000.
roulim - roughness length limit
Defines the roughness length limit below which the canopy modelling is not activated.
roufact - roughness length ratio
Defines the roughness length ratio used to evaluate the canopy height.
Info
Canopy height is evaluated using expression: Hcano = roufact * r
where r is the roughness length given to the ground cell.
[Calc-C1-*] sections
Several sets of parameters can be configured in the same file.
Info
If new sets are to be introduced, new names should be chosen as a section name can only be used once.
Below, two sets of parameters are configured for the flow model C1 (sample1 and sample2). Sets of parameters are only described with one entry, defining "canopy" (all other variables will be configured with default parameters).
rotor
'rotor': {'type': 'bool', 'def': False, 'list': [False, True]},
hrotor
'hrotor': {'type': 'float', 'def': 90., 'min': 50., 'max': 250.},
drotor
'drotor': {'type': 'float', 'def': 80., 'min': 50., 'max': 250.},
fvsolution_coarse
'fvsolution_coarse': {'type': 'str', 'def': 'simplec_pcg_normal'},
fvsolution_fine
'fvsolution_fine': {'type': 'str', 'def': 'simplec_pcg_normal'},
fvsolution_canop
'fvsolution_canop': {'type': 'str', 'def': 'canopy'},
fvschemes_coarse
'fvschemes_coarse': {'type': 'str', 'def': 'normal'},
fvschemes_fine
'fvschemes_fine': {'type': 'str', 'def': 'normal'},
fvschemes_canop
'fvschemes_canop': {'type': 'str', 'def': 'normal'},
init
'init': {'type': 'bool', 'def': True, 'list': [False, True]},
init_vel
'init_vel': {'type': 'bool', 'def': True, 'list': [False, True]},
init_k
'init_k': {'type': 'float', 'def': -1., 'min': 1.e-8, 'max': 1.e+8},
'init_eps': {'type': 'float', 'def': -1., 'min': 1.e-8, 'max': 1.e+8},
inlet_vel
'inlet_vel': {'type': 'float', 'def': -1., 'min': 1.e-8, 'max': 1.e+8},
'inlet_k': {'type': 'float', 'def': -1., 'min': 1.e-8, 'max': 1.e+8},
inlet_eps
'inlet_eps': {'type': 'float', 'def': -1., 'min': 1.e-8, 'max': 1.e+8},
turb
'turb': {'type': 'str', 'def': 'krng', 'list': ['keps', 'keps_mod1', 'krea', 'krng', 'keps_mod2', 'kl']},
z0min_wall
'z0min_wall': {'type': 'float', 'def': 0.001, 'min': 0.0, 'max': 1.},
cmu_wall
'cmu_wall': {'type': 'float', 'def': -1., 'min': 0.001, 'max': 1000.},
kappa_wall
'kappa_wall': {'type': 'float', 'def': 0.41, 'min': 0.001, 'max': 1000.},
wall_nut
'wall_nut': {'type': 'str', 'def': 'atmNutk', 'list': ['atmNutk', 'atmNutkBounded', 'atmNut', 'atmNutU']},
outlet_k
'outlet_k': {'type': 'str', 'def': 'inletOutlet', 'list': ['inletOutlet', 'zeroGradient']},
outlet_eps
'outlet_eps': {'type': 'str', 'def': 'zeroGradient', 'list': ['inletOutlet', 'zeroGradient']},
itmax_coarse
'itmax_coarse': {'type': 'int', 'def': 3000, 'min': 0, 'max': 10000},
itmax_fine
'itmax_fine': {'type': 'int', 'def': 5000, 'min': 0, 'max': 10000},
itmax_canop
'itmax_canop': {'type': 'int', 'def': 5000, 'min': 0, 'max': 10000},
cvgcrit_alpha_coarse
'cvgcrit_alpha_coarse': {'type': 'float', 'def': 5e-05, 'min': 1.e-8, 'max': 1.e-2},
cvgcrit_alpha_fine
'cvgcrit_alpha_fine': {'type': 'float', 'def': 5e-05, 'min': 1.e-8, 'max': 1.e-2},
cvgcrit_alpha_canop
'cvgcrit_alpha_canop': {'type': 'float', 'def': 5e-05, 'min': 1.e-8, 'max': 1.e-2},
cvgcrit_turb_coarse
'cvgcrit_turb_coarse': {'type': 'float', 'def': 5e-03, 'min': 1.e-8, 'max': 1.e-2},
cvgcrit_turb_fine
'cvgcrit_turb_fine': {'type': 'float', 'def': 5e-03, 'min': 1.e-8, 'max': 1.e-2},
cvgcrit_turb_canop
'cvgcrit_turb_canop': {'type': 'float', 'def': 5e-03, 'min': 1.e-8, 'max': 1.e-2},
cvgratio_mt_coarse
'cvgratio_mt_coarse': {'type': 'float', 'def': 100., 'min': 0., 'max': 100.},
cvgratio_lid_coarse
'cvgratio_lid_coarse': {'type': 'float', 'def': 100., 'min': 0., 'max': 100.},
cvgratio_wt_coarse
'cvgratio_wt_coarse': {'type': 'float', 'def': 100., 'min': 0., 'max': 100.},
cvgratio_pt_coarse
'cvgratio_pt_coarse': {'type': 'float', 'def': 60., 'min': 0., 'max': 100.},
cvgratio_mt_fine
'cvgratio_mt_fine': {'type': 'float', 'def': 100., 'min': 0., 'max': 100.},
cvgratio_lid_fine
'cvgratio_lid_fine': {'type': 'float', 'def': 100., 'min': 0., 'max': 100.},
cvgratio_wt_fine
'cvgratio_wt_fine': {'type': 'float', 'def': 100., 'min': 0., 'max': 100.},
cvgratio_pt_fine
'cvgratio_pt_fine': {'type': 'float', 'def': 60., 'min': 0., 'max': 100.},
cvgratio_mt_canop
'cvgratio_mt_canop': {'type': 'float', 'def': 100., 'min': 0., 'max': 100.},
cvgratio_lid_canop
-
'
cvgratio_lid_canop': {'type': 'float', 'def': 100., 'min': 0., 'max': 100.},
cvgratio_wt_canop
'cvgratio_wt_canop': {'type': 'float', 'def': 100., 'min': 0., 'max': 100.},
cvgratio_pt_canop
'cvgratio_pt_canop': {'type': 'float', 'def': 60., 'min': 0., 'max': 100.},
canopy_fine
p.canopy_fine = get_config(config, 'Calc-' + p.name, 'canopy_fine', p.logger, p.cloud)
canopy_coarse
p.canopy_coarse = get_config(config, 'Calc-' + p.name, 'canopy_coarse', p.logger, p.cloud)
canopy_final
p.canopy_final = get_config(config, 'Calc-' + p.name, 'canopy_final', p.logger, p.cloud)
plantcd
p.plantcd = get_config(config, 'Calc-' + p.name, 'plantcd', p.logger, p.cloud)
leafareadensity
p.leafareadensity = get_config(config, 'Calc-' + p.name, 'leafareadensity', p.logger, p.cloud)
coriolis_fine
p.coriolis_fine = get_config(config, 'Calc-' + p.name, 'coriolis_fine', p.logger, p.cloud)
coriolis_coarse
p.coriolis_coarse = get_config(config, 'Calc-' + p.name, 'coriolis_coarse', p.logger, p.cloud)
smoothres
p.smoothres = get_config(config, 'Calc-' + p.name, 'smoothres', p.logger, p.cloud)
vtkres
p.vtkres = get_config(config, 'Calc-' + p.name, 'vtkres', p.logger, p.cloud)
daemon_wait
p.daemon_wait = get_config(config, 'Calc-' + p.name, 'daemon_wait', p.logger, p.cloud)
halpha1
p.halpha1 = get_config(config, 'Calc-' + p.name, 'halpha1', p.logger, p.cloud)
halpha2
p.halpha2 = get_config(config, 'Calc-' + p.name, 'halpha2', p.logger, p.cloud)
halpha3
p.halpha3 = get_config(config, 'Calc-' + p.name, 'halpha3', p.logger, p.cloud)
bloc format
Info
bla bla
Note
bla bla
Warning
bla bla
Danger
bla bla
Missing
CONFIGURE
resvisu_lid
diavisu_lid
lidmap_reso
checklidar