Capsis

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 a [0 200] x [0 200] m².
• the cellWidth is used to speed up Plant localization. It has to be a multiple of xMax-xMin and yMax-yMin.

Here below, polygon 1 is a square polygon of 50×50 m².

• Plant number: this number does not matter but is useful to organize in files when numerous Plants.
• x, y, z: location of the plant base in m.
• dbh: diameter at breast height in cm.
• h, cbh, cd: height, crown base height, crown diameter (m)
• liveMC, liveTMC, deadTMC: live/dead, Leaves/Twigs Moisture content (% of dry mass)

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

• Plant number: this number does not matter but is useful to organize in files when numerous Plants.
• x, y, z: location of the plant base in m.
• dbh: diameter at breast height in cm.
• liveMC, liveTMC, deadTMC: live/dead, Leaves/Twigs Moisture content (% of dry mass)

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: this number does not matter but is useful to organize in files when numerous plant groups.
• lDBH,uDBH: lower and upper boundary for diameter at breast height in cm.
• age : in year. Only matters when allometric equations for this species account for age (eg, Pinus pinaster).
• N: stem density in polygon (stem/hectare), hectare = 10000 m².
• liveMC, liveTMC, deadTMC: live/dead, Leaves/Twigs Moisture content (% of dry mass).

Within a polygon as a function of stand parameters.

• Plant group number: this number does not matter but is useful to organize in files when numerous plant groups.
• Age : stand age in year
• N: stem density in polygon (stem/hectare), hectare = 10000 m²
• Gibbs: parameter for aggregation. 0=random
• gHaETfactor: st deviation for basal area (m<sub>2</sup>ha<sub>-1</sup>) computation from tree space index (from -2 to 2..)

Eg, LayerSet 1 is attached polygon 1

• A polygon can be attached to several layerSets.
• When the RGB is not correct (typically -1,-1,-1), a RGB will be computed for the LayerSet according to the load of water available inside (from yellow for dry and low fuel load to green for wet and high fuel load).

• h, cbh, d: height, crown base height, characteristicSize of clump (m).
• spatialGroup:
  • when same spatialGroup number in a LayerSet: layer horizontal distributions are independent (one to the other).
  • when different spatialGroup number in a LayerSet: layer horizontal distribution are dependent (the two fuel type will be at different locations).
• liveMC, liveTMC, deadTMC: live/dead, Leaves/Twigs Moisture content (% of dry mass).

• “WithModel” should be typed in the first field in this format (to ease parsing).
• LayerSetId corresponds to the Id of the layerSet (see above the format with LayerSetId, PolygonId and RGV)
• The layerSetModel “West american grassland” is defined in separately in the list of LayerSetModels

e.g. in file data/fireparadox/fromFieldParameters/Dynamic_stand.txt

Succession model layerSet characteristics

• age: LayerSet age since last clearing.
• fertility: from 0 (best) to 3.
• treatmentEffect: unused yet.

Succession model layer characteristics

• shrubC, shrubD: shrub cover fraction and clump size (m).
• shrubLiveFraction: fraction of live fuel in shrub mass (between 0 and 1).
• herbC, herbD: herb cover fraction and clump size (m).
• liveMC, deadTMC: live/dead Moisture content (% of dry mass).

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

• x, y, z: location of the tree trunk base in m.
• dbh: diameter at breast height in cm.
• h, cbh, cd: height, crown base height, crown diameter (m)
• minBLC, maxBLC, meanBLC: min, max and mean Bole Length Charred (m)
• CSH, CVS: crown scortch height (m), crown volume scorched (%)
• status: 0:dead, 1: alive, -1 unknown (will be computed from damage by empirical fire effect models

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.