Input files

For detailed notes see User's Guide for Biome-BGC MuSo v6 [PDF] .

Do not use non-ASCII characters in your input files!

Meteorological data

• The file can contain any number of header lines, followed by numeric values for the meteorological data.
• The file can contain long meteorological data file covering many years and the model will use the appropriate years if model run is initiated for a subset of years (use ‘first simulation year’ field in project creation)
• 9 values are required for each day: year, yday, Tmax, Tmin, Tday, prcp, VPD, srad, daylen
• The file can contain any number of years of data, and each year must have exactly 365 days (except the last one), with one line of data per day, and no separations between years. (We suggest eliminating December 31 of a leap year.) Last year can be shorter than 365 days (truncated year).
• You have to use the *.mtc43 (or *.txt) extension for file name.

CO2 and NDEP data

• These files must have one line for each simulation year: the first value on the line is the year, and the second value is the CO2 concentration and/or N-deposition data.
• These files can contain long CO2/NDEP data file covering many years and the model will use the appropriate years if model run is initiated for a subset of years (like meteorological data).
• You have to use the *.txt extension for file name.

Soil and EPC data

• See User's Guide for Biome-BGC MuSo v6 [PDF]
• You have to use the *.soi, *.epc (or *.txt) extensions for file name.

Management data

• Contrary to other input data you should not upload MGM file, instead of it you have to provide managment files for planting, thinning, mowing, grazing, harvesting, ploughing, fertilizing, irrigating.
• Do not use input file field!
• Instead of input file field you have to use management files field for upload.
• You have to upload all required management files together.
• You have to use the *.plt, *.thn, *.mow, *.grz, *.hrv, *.plg, *.frz, *.irr extensions for file name.

Other data

In order to enable more realistic simulation in special cases (see User's Guide).

• mortality, conductance, groundwater, onday and offday data
• the filenames are fixed:
  mortality_spinup.txt, mortality_transient.txt, mortality_normal.txt
  conductance_spinup.txt, conductance_transient.txt, conductance_normal.txt
  groundwater_spinup.txt, groundwater_normal.txt
  onday_spinup, onday_transient.txt, onday_normal.txt
  offday_spinup, offday_transient.txt, offday_normal.txt
• You can upload only one file per input data.
• You have to use the *.txt extension for file name.

Other data: mortality and conductance

• These files must have one line for each simulation year: the first value on the line is the year, and the second value is the mortality and/or stomatal conductance data.
• Note that (unlike CO2 and NDEP file) the current model version does NOT take into account the year field in the mortality.txt or conductance.txt file: for the first year of the simulation the first line is used (regardless of the value of the year field); for the second year the second line is used etc.
• If external file(s) are provided by the User, the settings of whole plant mortality and/or maximum stomatal conductance within the EPC file are ignored by the model.
• During the spinup, transient and the normal phase of the simulation the model can either use constant mortality and stomatal conductance, or it can read annually varying mortality and/or conductance defined by a text file.

Other data: groundwater

• These files must have one line for each day of each simulation year: the first value on the line is the day of year, then groundwater depth in meters (positive value!) for the given day (note that in the other external files the first column is typically the year, so this file format is a special one).
• During the spinup and transient phase of the simulation the model can only use daily average data for one typical simulation year, defined by a text file (groundwater_spinup.txt; it must contain data exactly for 365 days => 365 lines).
• During the normal phase of the simulation the model can read daily groundwater information defined by another external text file (groundwater_normal.txt)
• Note that the current model version does NOT take into account the day of year field in the file: for the first day of the simulation the first line is used (regardless of the value of the day field); for the second day the second line is used etc.
• You should check whether the length of the groundwater file is in accordance with the length of the normal simulation. The length must have 365 × number of simulation years.

Other data: onday and offday

• The structure of these files is the same as the structure of the CO2 and NDEP file.
• Note that the current model version does NOT take into account the year field in the txt file (similar to conductance and mortality files).
• During the spinup, transient and the normal phase of the simulation the model can either use constant onday and/or offday, or it can read annually varying onday and/or offday defined by a text file.