Skip to content

Metadata Input

Joe-Wagstaff edited this page May 13, 2025 · 17 revisions

Metadata

To run crspy-lite (and process CRNS data more broadly) a collection of site descriptors and variables are required. In crspy-lite these are requested to be inputted by the user when the tool is first run. After this they are coverted to and stored in a config.json file, which can be found in "\your-folder\inputs\config.json". Note that not all variables are required. For example some can be calculated within crspy-lite or are included to define limits for different variables: such as rainfall. Please use the table below to view what these variables are, what they do and if they are required:

NAME UNITS DESCRIPTION REQUIRED
COUNTRY - Country code for location of site Yes
SITENUM - Assigned number for site Yes
SITENAME - Name of site Yes
INSTALL_DATE - Date of site installation No
LATITUDE degrees Latitude of site. Values in range -90 to 90 Yes
LONGITUDE degrees Longitude of site. Values in range from 0 to 360 Yes
ELEV m Elevation of site above sea level Yes
TIMEZONE - Timezone of the site No
RC gv Cutoff Rigidity of the site No - crspy-lite can calculate this
LW % (0:1) Percent Lattice Water (as a number between 0 and 1) Yes
SOC % (0:1) Percent Soil Organic Carbon (as a number between 0 and 1) Yes
BD g/cm3 Bulk Density Yes
BETA_COEFF - Store of the calculated beta coefficient for each individual site No - crspy-lite can calculate this
REFERENCE_PRESS mb Reference pressure Yes
N0 - Theoetical neutron count for absolute dry soil conditions No - but must otherwise supply a calibration dataset so crspy-lite can calculate this
PRECIP_MAX mm Maximum value of hourly precipitation. Values above this are removed No - optional limit
SM_MAX cm3/cm3 Maximum value of hourly soil moisture. Values above this are removed No - optional limit
FIELD_CAPACITY cm3/cm3 The amount of soil moisture or water content held in the soil after excess water has drained away No - optional visualisation parameter
WILTING_POINT cm3/cm3 The amount of water that is held so tightly by the soil matrix that roots cannot absorb it and plants will wilt No - optional visualisation parameter

Input Time Series Data

During the first time you run crspy-lite you will also be prompted to input time series data, known as "raw data". Crspy-lite can accomodate .txt and .csv files by reading a filepath, as well as data from online sources by reading a URL. Therefore you must either provide a filepath or a URL of your input data. You can also input a filepath of calibration data, if you wish to use crspy-lite to calibrate your site. The table below summarises the three inputs:

NAME DESCRIPTION REQUIRED
RAW_DATA_FILEPATH File path of input timeseries data from the CRNS Must provide either a RAW_DATA_FILEPATH OR RAW_DATA_URL
RAW_DATA_URL URL of input timeseries data from the CRNS Must provide either a RAW_DATA_FILEPATH OR RAW_DATA_URL
CALIB_DATA_FILEPATH File path of Calibration data Required if no N0 number is given (see table above)

Click on the links for further details on the required format of the Input Timeseries Data of the Calibration Data.

Additional Info

  • http://www.crnslab.org/ is a great resource. It is especially useful in finding site specific cut-off rigidity (RC) if it is not already available in data.

  • Note that the metadata variable 'AGBWEIGHT', used to compute the static biomass correction defined by Baatz et al. (2015), is not used in the current version of CRSPY_lite. Also note the inputs 'MAX_PRECIPITATION’, and ‘SM_MAX' are included so that the user may improve the visualisation of the figures.

Clone this wiki locally