Back to the Fuel Manager home page.
This dialog permits to generate a 3D vegetation scene of the Fuel Manager throughout this user interface. Back to Quick Start Guide.
Modify the different optional parameters for scene generation (Optional) and load the input file required for Fuel item parametrization (Mandatory). Then, click on either
3D Editor > if you want to see and edit your scene in 3D, or on
Finish (skip the 3D editor).
Fuel Manager loads a file containing the allometric models and parameters for a list of species and corresponding models (for height, crown base height, loads, etc.). By default, the speciesFile is located in capsis4/data/fuelmanager, but this can be modified (for example, the file speciesFileTallTimbers.txt contains a few american species). New species can be easily integrated in the FuelManager by adding the model parameters in this species file.
The seed value is used to parametrize the stochasticity of the Fuel Manager. When 0 (default value) or a another positive number is chosen, it will be used as a seed to initialize pseudo random number for the run. If the same number is used on different architecture, but on the same version of the software, a same sequence of action will produce exactly the same data. These is a useful property for run and study replicability. When a negative number is chosen, random number sequences will always be different so that runs will always produce slightly different results. This mode is useful for sensitivity analysis of the fuel manager, but also of the fire model (if one is used).
The third option permits to speed up the computation of tree locations. By default, a sophisticated hard core algorithm is used when the number of trees in each polygon is smaller than 50,000. Above this number a Gibbs distribution with minimal distance between trees is used. However, because these computations can be very long, activating the speed up option leads to a much faster computation, based on either Gibbs distribution when tree number is lower than 10,000 and simply random above.
The Fuel Manager user can optionaly store models of fuel layerSets and fuelLayers that are frequently used (general parametrization of fuel types such as grasslands (eg. West american grassland), shrubland (eg. Quercus coccifera garrigue) or understorey representative of typical fuel types) in two optional files. These models can then be loaded from either in Fuel item parameter files or the scene editor (interactively, once a polygon has been selected). These too files are located in capsis4/data/fuelmanager/fuelModels, but this can be modified
Several file examples can be found in capsis4/data/fuelmanager/fuelParameterFiles.
We recommend to start with files basicExample.txt or basicExampleTallTimbers.txt. The first one contains a 200mX200m terrain, 3 polygons, a single Aleppo pine (Plant), a layerSet containing two layers (small Quercus coccifera bushes and some herbs), as well as a group of Pinus banksiana (Plant group) with diameters ranging between20 and 30 cm in polygon 1. The second one contains a 200mX200m terrain, 4 polygons, a few individual plants, as well as a groups of Pinus banksiana (Plant group) and three different layerSets.
Three different format are currently available.
The format definition is described below.
Here below, polygon 1 is a square polygon of 50×50 m2.
|PolygonId||list of polygon summits|
With this format, bulk density corresponding to the different fuel particles and their distributions are computed accordingly with the allometric models defined in the speciesFile
This format is very similar to the previous one, but in this case, height, crown diameter and crown base height are computed accordingly with the allometric models defined in the speciesFile (as for bulk density and their distribution)
Stem density with a range of DBH of pinus banksiana in polygon with PolygonId=2
|Plant group number||species||polygonId||lDBH||uDBH||age||N||liveLMC||liveTMC||deadTMC|
Within a polygon as a function of stand parameters.
|Plant Group number||species||polygonId||hDom50||age||N||gHaET Factor||Gibbs||liveLMC||liveTMC||deadTMC|
Eg, LayerSet 1 is attached polygon 1
|LayerSet Number||species||h||cbh||C||d||spatial Group||lMC||dMC||lBD||dBD||mvr||svr|
|WithModel||4||West american grassland|
e.g. in file data/fireparadox/fromFieldParameters/Dynamic_stand.txt
Succession model layerSet characteristics
Succession model layer characteristics
This format is relatively similar to the previous one (terrain, etc.), but it can also contains some information regarding plant damage due to fire, in order to compute and visualize fire effects. An example is given in file capsis4/data/fireparadox/fuelParameterFileWithFireEffects/Mixed_stand_with_fire_effects.txt
Note: the “pattern sketcher” render for tree should be selected (with the option “by fire damage”) to visualized damage with the 3D Editor is NOT AVAILABLE in the current version of the fuel manager.
An empty scene can be generated by giving the dimensions of the terrain. Items (Plants, Polygons, LayerSets) can be added interactively from the scene editor.