Additional Resources and Examples
π Helpful Resources
The 3-PG website hosted by the UBC Faculty of Forestry contains several helpful documents related to model development, descriptions, studies and additional background information: UBC 3-PG Website.
π Example Parameter Files
Below is an example of a generic site template. Note how variables can be provided as a constant or a raster (Site.txt):
"Model mode", 3PG
// Where we want the output to be stored:
"Output directory", D:\3PG_BP_CO2\Output
//Initial values - all of these inputs can also be rasters (for example I use a latitude raster for every pixel in other runs for example)
"Latitude", D:\3PG_BP_CO2\Data_10\latitude.tif
//"Latitude", 59
"Fertility rating", D:\3PG_BP_CO2\Data_10\fertility.tif
//"Fertility rating", 0.7
"Soil class", 3
"Maximum ASW", D:\3PG_BP_CO2\Data_10\max_asw.tif
//"Maximum ASW", 150
"Minimum ASW", 0.0
"Start age", 1
"End year", 2050
"Start month", 1
// This is for the STATIC CO2 version - when sliding CO2 use "Co2start", 350 and "Co2end", 450 (example values)
"CO2", 450
// year planted is coming from a forest age raster from ntems
//"yearplanted", 1900
"yearplanted", D:\3PG_BP_CO2\Data_10\Forest_Age_2019_2025.tif
// these are the starting biomass values for foliage, roots, and stem - initial values come from literature
"WFi", 1
"WRi", 3
"WSi", 6
//"StemNoi", 4000
"StemNoi", D:\3PG_BP_CO2\Data_10\stemno_init.tif
"ASWi", 150
//Series data_100 - this is the climate data that is required
"Tmin", D:\3PG_BP_CO2\Data_10\tmin01.tif D:\3PG_BP_CO2\Data_10\tmin02.tif D:\3PG_BP_CO2\Data_10\tmin03.tif D:\3PG_BP_CO2\Data_10\tmin04.tif D:\3PG_BP_CO2\Data_10\tmin05.tif D:\3PG_BP_CO2\Data_10\tmin06.tif D:\3PG_BP_CO2\Data_10\tmin07.tif D:\3PG_BP_CO2\Data_10\tmin08.tif D:\3PG_BP_CO2\Data_10\tmin09.tif D:\3PG_BP_CO2\Data_10\tmin10.tif D:\3PG_BP_CO2\Data_10\tmin11.tif D:\3PG_BP_CO2\Data_10\tmin12.tif
"Tmax", D:\3PG_BP_CO2\Data_10\tmax01.tif D:\3PG_BP_CO2\Data_10\tmax02.tif D:\3PG_BP_CO2\Data_10\tmax03.tif D:\3PG_BP_CO2\Data_10\tmax04.tif D:\3PG_BP_CO2\Data_10\tmax05.tif D:\3PG_BP_CO2\Data_10\tmax06.tif D:\3PG_BP_CO2\Data_10\tmax07.tif D:\3PG_BP_CO2\Data_10\tmax08.tif D:\3PG_BP_CO2\Data_10\tmax09.tif D:\3PG_BP_CO2\Data_10\tmax10.tif D:\3PG_BP_CO2\Data_10\tmax11.tif D:\3PG_BP_CO2\Data_10\tmax12.tif
"Rain", D:\3PG_BP_CO2\Data_10\ppt01.tif D:\3PG_BP_CO2\Data_10\ppt02.tif D:\3PG_BP_CO2\Data_10\ppt03.tif D:\3PG_BP_CO2\Data_10\ppt04.tif D:\3PG_BP_CO2\Data_10\ppt05.tif D:\3PG_BP_CO2\Data_10\ppt06.tif D:\3PG_BP_CO2\Data_10\ppt07.tif D:\3PG_BP_CO2\Data_10\ppt08.tif D:\3PG_BP_CO2\Data_10\ppt09.tif D:\3PG_BP_CO2\Data_10\ppt10.tif D:\3PG_BP_CO2\Data_10\ppt11.tif D:\3PG_BP_CO2\Data_10\ppt12.tif
"Solar Radtn", D:\3PG_BP_CO2\Data_10\rad01.tif D:\3PG_BP_CO2\Data_10\rad02.tif D:\3PG_BP_CO2\Data_10\rad03.tif D:\3PG_BP_CO2\Data_10\rad04.tif D:\3PG_BP_CO2\Data_10\rad05.tif D:\3PG_BP_CO2\Data_10\rad06.tif D:\3PG_BP_CO2\Data_10\rad07.tif D:\3PG_BP_CO2\Data_10\rad08.tif D:\3PG_BP_CO2\Data_10\rad09.tif D:\3PG_BP_CO2\Data_10\rad10.tif D:\3PG_BP_CO2\Data_10\rad11.tif D:\3PG_BP_CO2\Data_10\rad12.tif
"Frost", D:\3PG_BP_CO2\Data_10\nffd01.tif D:\3PG_BP_CO2\Data_10\nffd02.tif D:\3PG_BP_CO2\Data_10\nffd03.tif D:\3PG_BP_CO2\Data_10\nffd04.tif D:\3PG_BP_CO2\Data_10\nffd05.tif D:\3PG_BP_CO2\Data_10\nffd06.tif D:\3PG_BP_CO2\Data_10\nffd07.tif D:\3PG_BP_CO2\Data_10\nffd08.tif D:\3PG_BP_CO2\Data_10\nffd09.tif D:\3PG_BP_CO2\Data_10\nffd10.tif D:\3PG_BP_CO2\Data_10\nffd11.tif D:\3PG_BP_CO2\Data_10\nffd12.tif
//Outputs - these are what we are outputing, and how frequently
"avDBH", dbh.tif 1900 10 month 7
"WF", wf.tif 1900 10 month 7
"WS", ws.tif 1900 10 month 7
"WR", wr.tif 1900 10 month 7
"ASW", asw.tif 1900 10 month 7
"StemNo", stemno.tif 1900 10 month 7
A generic species template for pine is provided below (Species_Generic_Pine.txt):
// Species File
"Foliage:stem partitioning ratio @ D=2 cm", 1.53
"Foliage:stem partitioning ratio @ D=20 cm", 0.55
"Constant in the stem mass v. diam. relationship", 0.0073
"Power in the stem mass v. diam. relationship", 3.282
"Maximum fraction of NPP to roots", 0.8
"Minimum fraction of NPP to roots", 0.25
"Minimum temperature for growth", -7
"Optimum temperature for growth", 15
"Maximum temperature for growth", 30
"Days production lost per frost day", 1.0
"Moisture ratio deficit for fq = 0.5", 0.7
"Power of moisture ratio deficit", 9
"Value of 'm' when FR = 0", 0
"Value of 'fNutr' when FR = 0", 1
"Power of (1-FR) in 'fNutr'", 1
"Maximum stand age used in age modifier", 200
"Power of relative age in function for fAge" , 4
"Relative age to give fAge = 0.5", 0.95
"Maximum litterfall rate", 0.015
"Litterfall rate at t = 0", 0.01
"Age at which litterfall rate has median value", 36
"Average monthly root turnover rate", 0.015
"Maximum canopy conductance", 0.02
"LAI for maximum canopy conductance", 3.33
"Defines stomatal response to VPD", 0.055
"Canopy boundary layer conductance", 0.2
"Max. stem mass per tree @ 1000 trees/hectare", 200
"Power in self-thinning rule", 1.5
"Fraction mean single-tree foliage biomass lost per dead tree", 1
"Fraction mean single-tree root biomass lost per dead tree", 1
"Fraction mean single-tree stem biomass lost per dead tree", 1
"Branch and bark fraction at age 0", 0.75
"Branch and bark fraction for mature stands", 0.15
"Age at which fracBB = (fracBB0+fracBB1)/2", 2
"Minimum basic density - for young trees", 0.45
"Maximum basic density - for older trees", 0.5
"Intercept of net v. solar radiation relationship", -90
"Slope of net v. solar radiation relationship", 0.8
"Molecular weight of dry matter", 24
"Conversion of solar radiation to PAR", 2.3
"Specific leaf area at age 0", 5.75
"Specific leaf area for mature leaves", 3.1
"Age at which specific leaf area = (SLA0+SLA1)/2", 2
"Extinction coefficient for absorption of PAR by canopy", 0.5
"Age at canopy cover", 20
"Maximum proportion of rainfall evaporated from canopy", 0.15
"LAI for maximum rainfall interception", 3.1
"Canopy quantum efficiency", 0.04
"Ratio NPP/GPP", 0.47
// Example Comment
"Age at which rho = (rho0+rho1)/2", 4.0
"Constant in the stem volume relationship", 0
"Power of DBH in the stem volume relationship", 0
"Power of stocking in the stem volume relationship", 0
"Mortality rate for large t", 0
"Seedling mortality rate (t = 0)", 0
"Age at which mortality rate has median value", 0
"Shape of mortality response", 1.0
"Constant in the stem height relationship", 0
"Power of DBH in the stem height relationship", 0
"Power of stocking in the stem height relationship", 0
"fCalpha700", 1.4
"fCg700", 0.7
An example of the command line prompt necessary to run this example, if the executable and the paths are stored on your D drive in a folder called β3PG_Exampleβ:
D:/3PG_Example/3PG.exe -d D:/3PG_Example/Species_Generic_Pine.txt -s D:/3PG_Example/Site.txt