Outputs¶
There are two main output files generated by SIPNET:
1. sipnet.out: Model state variables and fluxes at each timestep.
2. events.out: Contains a record of agronomic events processed during the simulation (if event handling is enabled).
Model Outputs¶
The sipnet.out file contains a time series of state variables and fluxes from the simulation.
| # | Symbol | Output Name | Definition / Notes | Units |
|---|---|---|---|---|
| 1 | year | Year of start of timestep | (integer) | |
| 2 | day | Day-of-year of start of timestep | (integer) | |
| 3 | time | Hour-of-day (fractional) at start of timestep | hours | |
| 4 | plantWoodC | Woody plant carbon | g C m\(^{-2}\) | |
| 5 | plantLeafC | Leaf carbon | g C m\(^{-2}\) | |
| 6 | soil | (Single) soil organic carbon (or mineral soil C pool) | g C m\(^{-2}\) | |
| 7 | microbeC | Microbial carbon (0 if microbes flag off) | g C m\(^{-2}\) | |
| 8 | coarseRootC | Coarse root carbon | g C m\(^{-2}\) | |
| 9 | fineRootC | Fine root carbon | g C m\(^{-2}\) | |
| 10 | litter | Litter carbon (0 if litter pool disabled) | g C m\(^{-2}\) | |
| 11 | soilWater | Soil water content | cm | |
| 12 | \(f_{\text{WHC}}\) | soilWetnessFrac | Soil water as fraction of holding capacity | unitless |
| 13 | snow | Snow water equivalent | cm | |
| 14 | npp | Net primary production for timestep | g C m\(^{-2}\) | |
| 15 | nee | Net ecosystem exchange (sign convention per code: - (NPP - RH)) | g C m\(^{-2}\) | |
| 16 | cumNEE | Cumulative NEE since simulation start | g C m\(^{-2}\) | |
| 17 | \(GPP\) | gpp | Gross primary production | g C m\(^{-2}\) |
| 18 | rAboveground | Aboveground autotrophic respiration (leaves + wood) | g C m\(^{-2}\) | |
| 19 | \(R_H\) | rSoil | Heterotrophic respiration (maintenance + microbe terms per configuration) | g C m\(^{-2}\) |
| 20 | rRoot | Root (autotrophic) respiration | g C m\(^{-2}\) | |
| 21 | ra | Total autotrophic respiration (rAboveground + rRoot) | g C m\(^{-2}\) | |
| 22 | rh | Total heterotrophic respiration (litter + soil components) | g C m\(^{-2}\) | |
| 23 | \(R\) | rtot | Total ecosystem respiration (ra + rh) | g C m\(^{-2}\) |
| 24 | evapotranspiration | ET (transpiration + immedEvap + evaporation + sublimation) for timestep | cm | |
| 25 | fluxestranspiration | Transpiration component only | cm |
An example output file can be found in tests/smoke/sipnet.out.
Notes: PlantWoodC, PlantLeafC, Soil and Litter in g C/m^2; Water and Snow in cm; SoilWetness is fraction of WHC;
year day time plantWoodC plantLeafC soil microbeC coarseRootC fineRootC litter litterWater soilWater soilWetnessFrac snow npp nee cumNEE gpp rAboveground rSoil rRoot ra rh rtot evapotranspiration fluxestranspiration
1998 305 0.00 5759.77 1133.88 16000.06 8.00 1919.90 1919.64 0.500 6.00 0.500 0.00 -0.32 0.74 0.74 0.00 0.164 0.578 0.159 0.324 0.419 0.742 0.00302126 0.0000
1998 305 7.00 5759.63 1133.71 16000.08 8.00 1919.77 1919.10 0.500 5.99 0.500 0.00 -0.30 0.97 1.71 0.22 0.271 0.917 0.251 0.522 0.666 1.188 0.00240544 0.0022
1998 305 17.00 5759.16 1133.48 16000.15 8.00 1919.57 1918.37 0.500 5.99 0.499 0.00 -0.67 1.56 3.27 0.00 0.338 1.219 0.335 0.673 0.884 1.557 0.00662149 0.0000
Events output¶
When event handling is enabled, SIPNET will create a file named events.out.
This file is designed primarily for testing and debugging.
It contains one row for each agronomic event that is processed.
Each row lists the year, day, event type, and parameter name/value pairs.
The name/value pairs represent the state variables that are directly changed by an event, recording the change (delta) applied to each.
Information in events.out can, in principle, be reconstructed or inferred from events.in and sipnet.out though this may be confounded if simultaneous events affect the same variable.
Still, sipnet.out is the authoritative source for information about system state and evolution in time, including responses to events.
Below is an example events.out, with header enabled for clarity.
Note the delimiters: spaces separate columns, commas separate name/value pairs, and = map names with their values (deltas).
year day type param_name=delta[,param_name=delta,...]
2023 65 plant envi.plantLeafC=3.00,envi.plantWoodC=4.00,envi.fineRootC=5.00,envi.coarseRootC=6.00
2023 70 irrig envi.soilWater=5.00
2023 200 harv env.litter=5.46,envi.plantLeafC=-5.93,envi.plantWoodC=-4.75,envi.fineRootC=-3.73,envi.coarseRootC=-3.89
2024 65 plant envi.plantLeafC=3.00,envi.plantWoodC=5.00,envi.fineRootC=7.00,envi.coarseRootC=9.00
2024 70 irrig fluxes.immedEvap=2.50,envi.soilWater=2.50
2024 200 harv env.litter=4.25,envi.plantLeafC=-1.39,envi.plantWoodC=-1.63,envi.fineRootC=-2.52,envi.coarseRootC=-2.97