Skip to content

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.

param.ini - all configuration parameters set to their default values
[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.

method=mid
; centre evaluation method
; string
; validity: in [bary, mid]
; default: mid

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.

rix_slope=15.
; RIX evaluation slope [deg]
; float
; validity: 1. ≤ rix_slope ≤ 45.
; default: 15. 

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.

rix_res=50.
; RIX evaluation resolution [m]
; float
; validity: 1. ≤ rix_res ≤ 100.
; 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.

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-sample1]
resfine=50.

[Mesh-M1-sample2]
resfine=100.
param.ini - all mesh parameters set to their default values
[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 == 1rescoarse is set using expresion: rescoarse = 2 × resfine
When resratio > 1rescoarse 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.

hturb=250.
; turbine zone height [m]
; float
; validity: 80. ≤ hturb ≤ 350.
; default: 250.

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.

hcanop=-1
; canopy refinement zone height [m]
; validity: 10. ≤ hcanop ≤ 80.
; default: -1

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.

nsmoo=1
; number of smoothing loops
; integer
; validity: 0 ≤ nsmoo ≤ 5
; default: 1

Which effects?

The higher nsmoo will be, the stronger will be the applied smoothing.

Smoothing

smoocoef - smoothing coefficient

Defines how strong will be the smoothing in each of the smoothing loop.

smoocoef=0.3
; smoothing coefficient [-]
; float
; validity: 0.1 <= smoocoef <= 0.9
; default: 0.3

Which effects?

The higher smoocoef will be, the stronger will be the applied smoothing.

Smoothing

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

Which effects?

Smoothing

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.

roulim=0.5
; roughness length limit [m]
; float
; validity: 0. <= roulim <= 5.
; default: 0.5

roufact - roughness length ratio

Defines the roughness length ratio used to evaluate the canopy height.

roufact=30
; roughness length ratio [-]
; integer
; validity: 1 <= roufact <= 100
; default: 30

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).

[Mesh-C1-sample1]
canopy=False

[Mesh-C1-sample2]
canopy=True

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_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

Test test

Subscribe to our newsletter Send