There are two main output files generated by SIPNET:
sipnet.out: Model state variables and fluxes at each timestep.events.out(name configurable): Contains a record of events processed during the simulation if event handling is enabled.
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 (structural wood plus nppStorage) |
g C m$^{-2}$ | |
| 5 | plantLeafC | Leaf carbon | g C m$^{-2}$ | |
| 6 | woodCreation | Carbon allocated to wood during timestep | g C m$^{-2}$ | |
| 7 | soil | (Single) soil organic carbon (or mineral soil C pool) | 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 | soilWetnessFrac | Mean soil wetness as fraction of water holding capacity over timestep 1 | 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 | Gross primary production | g C m$^{-2}$ | |
| 18 | rAboveground | Aboveground autotrophic respiration (leaves + wood) | g C m$^{-2}$ | |
| 19 | rSoil | Total belowground respiration (rRoot + rh). | 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 | 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 (as a flux) | cm day$^{-1}$ | |
| 26 | minN | Soil mineral nitrogen | g N m$^{-2}$ | |
| 27 | soilOrgN | Soil organic nitrogen | g N m$^{-2}$ | |
| 28 | litterN | Litter nitrogen | g N m$^{-2}$ | |
| 29 | plantStorageN | Plant nitrogen storage pool; zero when nitrogen-cycle is off |
g N m$^{-2}$ | |
| 30 | n2o | Nitrous oxide production | g N m$^{-2}$ | |
| 31 | nLeaching | Nitrogen lost to leaching | g N m$^{-2}$ | |
| 32 | nFixation | Nitrogen demand met by fixation | g N m$^{-2}$ | |
| 33 | nUptake | Nitrogen demand met by uptake from soil | g N m$^{-2}$ | |
| 34 | ch4 | Methane production | g C m$^{-2}$ | |
| 35 | nppStorage | Carbon accounting / storage term tracked separately for mass balance; included in plantWoodC
|
g C m$^{-2}$ | |
| 36 | lai | Leaf area index (plantLeafC / leafCSpWt) |
m$^2$ m$^{-2}$ |
An example output file can be found in tests/smoke/russell_1/sipnet.out.
year day time plantWoodC plantLeafC woodCreation soil coarseRootC fineRootC litter soilWater soilWetnessFrac snow npp nee cumNEE gpp rAboveground rSoil rRoot ra rh rtot evapotranspiration fluxestranspiration minN soilOrgN litterN plantStorageN n2o nLeaching nFixation nUptake ch4 nppStorage lai
1998 305 0.00 5759.61 1133.88 0.00 16000.06 1919.91 1919.79 0.00 5.997 0.500 0.00 -0.324 0.742 0.742 0.000 0.164 0.578 0.159 0.324 0.419 0.742 0.00302126 0.0000 0.0000 0.0000 0.0000 0.0000 0.000000 0.0000 0.0000 0.0000 0.0000 -0.3236 4.1996
1998 305 7.00 5759.24 1133.71 -0.01 16000.08 1919.79 1919.48 0.00 5.995 0.500 0.00 -0.301 0.967 1.710 0.221 0.271 0.917 0.251 0.522 0.666 1.188 0.00240544 0.0022 0.0000 0.0000 0.0000 0.0000 0.000000 0.0000 0.0000 0.0000 0.0000 -0.5976 4.1989
1998 305 17.00 5758.50 1133.46 -0.01 16000.15 1919.60 1919.03 0.00 5.988 0.499 0.00 -0.673 1.558 3.267 0.000 0.338 1.219 0.335 0.673 0.884 1.558 0.00662149 0.0000 0.0000 0.0000 0.0000 0.0000 0.000000 0.0000 0.0000 0.0000 0.0000 -1.1978 4.1980
When event handling is enabled, SIPNET will create events.out by default, or
<EVENTS_PREFIX>.out when a custom events prefix is configured.
This file is designed primarily for testing and debugging.
It contains one row for each user-specified or internally computed event that is processed.
Each row lists the year, day, event type, and parameter name/value pairs.
The name/value pairs record event-specific deltas and diagnostics written by the model.
Information in the events output file can, in principle, be reconstructed or
inferred from the corresponding events input file 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 output file, 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 eventLeafC=3.00,eventWoodC=4.00,eventFineRootC=5.00,eventCoarseRootC=6.00,eventInputC=18.00,eventInputN=0.00
2023 70 irrig eventSoilWater=5.00,eventEvap=0.00
2023 200 harv eventSoilC=1.90,eventLitterC=3.56,eventLeafC=-5.93,eventWoodC=-4.75,eventFineRootC=-3.73,eventCoarseRootC=-3.89,eventSoilOrgN=0.00,eventLitterN=0.00,eventOutputC=12.83,eventOutputN=0.00
2023 245 leafon eventLeafOnCreation=4.00,eventLeafOnCreationFromWood=2.50
2023 300 plantdeath harvestFracRemoved=1.00,harvestFracTransferred=0.00,totalWoodC=-0.02,totalRootC=0.15
2024 65 plant eventLeafC=3.00,eventWoodC=5.00,eventFineRootC=7.00,eventCoarseRootC=9.00,eventInputC=24.00,eventInputN=0.00
2024 70 irrig eventSoilWater=2.50,eventEvap=2.50
2024 200 harv eventSoilC=2.74,eventLitterC=1.51,eventLeafC=-1.39,eventWoodC=-1.63,eventFineRootC=-2.52,eventCoarseRootC=-2.97,eventSoilOrgN=0.00,eventLitterN=0.00,eventOutputC=4.25,eventOutputN=0.00
Footnotes
-
Mean soilWetnessFrac (ratio of soil water / water holding capacity) calculated as average between previous and current time step. Reported for diagnostics only, and it can exceed 1 when
floodingis enabled. Internal moisture dependency functions use instantaneous $W_{soil}/W_{WHC}$ (not this average), and clip that ratio to [0,1] where those dependency functions are defined. ↩