param.ini - Section [Configure]
This section defines the parameters used during the configuration step.
[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.
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.