Skip to content

param.ini - Section [Configure]

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=fabdem12
roughness=esa200
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=fabdem12
; orography data source [-]
; string
; validity: in [none, fabdem12, srtm, aster]
; default: fabdem12

Warning

terrain is automatically switched to "fabdem12" when "srtm" is selected and project centers lies 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, esa200, glc17]
; default: esa200

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.