BADM Group Overview
BADM variables in this group are organized as shown below. The overview highlights what variables are required per group. It also indicates which variables cannot be specified together ( OR ) in the same group entry. See BADM Basics for more details.
Multiple entries of this BADM group can be reported per site. However, combinations of Ⓒ variables must be unique. Read more:
Optional Variable
Ⓒ Combinations
Examples
Required  Optional  

Soil Water Content 

BADM variables: Definitions, Units, Requirements
See Overview tab or BADM Basics for explanation of Required and Optional variables.
Multiple entries of this BADM group can be reported per site. However, combinations of Ⓒ variables must be unique. Read more:
Optional Variable
Ⓒ Combinations
Examples
Variable Requirements  Units  Description 

SWC Required  %  Soil water content (not continuous measurements) Report continuous halfhourly or hourly measurements with flux/met data. 
SWC_STATISTIC Ⓒ Required  LIST(STATISTIC) Show  Soil water content statistic The statistic for the measurement reported. Use predefined list (e.g., mean, min / max, standard deviation, etc). 
SWC_STATISTIC_METHOD Ⓒ Optional  LIST(STATISTIC_METHOD) Show  Soil water content statistic method Method used to generate the reported statistic (e.g., aggregate of individuals, aggregate of sample aggregates) from observations representing the same time period. Use predefined list. The aggregation method is not meant to describe temporal aggregations for example in calculations of higher frequency observations (e.g., subminute) to lower frequency observations (e.g., hourly) at a single location. 
SWC_STATISTIC_NUMBER Optional  integer number  Number of observations used to determine soil water content statistic Number of observations (samples / replicates) used to calculate the STATISTIC for the reported measurement. 
SWC_UNIT Ⓒ Required  LIST(UNIT_SWC) Show  Measurement unit of Soil water content Use the predefined list to specify gravimetric (mass water / mass dry soil) or volumetric (volume water / volume soil) water content. 
SWC_PROFILE_ZERO_REF Ⓒ Optional  LIST(PROFILE_ZERO_REF) Show  Soil water content profile zero reference Profile Zero Reference is the horizontal plane from which the soil profile minimum and maximum depths are measured. For example, top of mineral soil or top of litter layer. Use predefined list. 
SWC_PROFILE_MIN Ⓒ Optional  cm  Soil water content profile minimum depth Profile minimum depth is the vertical distance from profile zero reference to the top of soil layer being measured. 
SWC_PROFILE_MAX Ⓒ Optional  cm  Soil water content profile maximum depth Profile maximum depth is the vertical distance from profile zero reference to the bottom of soil layer being measured. 
SWC_HORIZON Optional  free text  Soil water content horizon Use soil horizon scheme best suited for your soil. Examples include O, Oa, B, Bt, C. 
SWC_APPROACH Optional  free text  Soil water content measurement approach 
SWC_DATE Ⓒ Requireda  YYYYMMDDHHMM  Soil water content measurement date Please report the date at the precision known. Allowed reporting precisions are YYYY, YYYYMM, YYYYMMDD, and YYYYMMDDHHMM. For soil moisture campaigns or temporal averages, SWC_DATE_START and SWC_DATE_END can be used. 
SWC_DATE_START Ⓒ Requireda  YYYYMMDDHHMM  Start date of Soil water content measurment Start date of a soil moisure measurement campaign or start date of a temporal average. Please report the date at the precision known. Allowed reporting precisions are YYYY, YYYYMM, YYYYMMDD, and YYYYMMDDHHMM. 
SWC_DATE_END Required  YYYYMMDDHHMM  End date of Soil water content measurement End date of a soil moisure measurement campaign or end date of a temporal average. Please report the date at the precision known. Allowed reporting precisions are YYYY, YYYYMM, YYYYMMDD, and YYYYMMDDHHMM. 
SWC_DATE_UNC Optional  days  Uncertainty in the Date(s) of Soil water content measurement 
SWC_COMMENT Optional  free text  Soil water content comments 
BADM Examples
Choose a variable marked with to show examples of how to submit and interpret these BADM. See BADM Basics for more details.
Combinations of Ⓒ variables must be unique. Read more: .
Optional Variable
Ⓒ Combinations
Examples
Soil Water Content 
STATISTIC Variables
Many BADM groups have a required and several optional STATISTIC variables. Specific examples of their use are given after an overview the variables basics.
STATISTIC Basics
BADM typically describe sitelevel descriptions and observations. The STATISTIC variables allow for full characterization of the reported information if desired. BADM groups, such as canopy height, LAI, soil chemistry, phenology, and biomass, contain the following STATISTIC variables:
var_STATISTIC Required  The type of value reported. Options: 
var_STATISTIC_METHOD Optional  The method of aggregation used to generate the statistic. Options: Statistics generated by this approach may represent spatial characteristics of the measurement within the site (e.g., spatial heterogeneity) and/or characteristics due to other factors (e.g., population variability). Aggregate of sample aggregates Statistics generated by this approach are often used to highlight the spatial characteristics within the site (i.e., the spatial heterogeneity of measurement within the site). Expert estimate See the Examples for more details. 
var_STATISTIC_NUMBER Optional  The number of observations used in calculating the statistic. 
STATISTIC Examples
Example 1: DBH calculated from a single sampling area
Example 2: DBH calculated from 8 plots
Example 3: DBH calculated from randomly selected trees within the site
Example 4: Biomass calculated from 8 plots each with 5 subplots
Example 5: Soil carbon calculated from replicate samples at 10 locations
Example 1: DBH calculated from a single sampling area
For DBH observations of individual trees in a single sample area at the site:
STATISTIC* = Mean, Minimum, Maximum, Percentiles, or Standard Deviation
STATISTIC_METHOD = Aggregate of individual observations
STATISTIC_NUMBER = # of individual samples
* Minimum, Maximum, and Percentiles should only be calculated if the sample size is adequately large.
Example 2: DBH calculated from 8 plots
For DBH observations of individual trees in 8 sample plots at the site:
If the individual DBH observations are first aggregated at the plot level and then the plot values are are used to calculate the sitelevel STATISTICs to highlight spatial variability:
STATISTIC* = Mean, Minimum, Maximum, or Standard Deviation
STATISTIC_METHOD = Aggregate of sample aggregates
STATISTIC_NUMBER = 8
If the individual DBH observations are aggregated across all plots to calculate the sitelevel STATISTIC:
STATISTIC* = Mean, Minimum, Maximum, Percentiles, or Standard Deviation
STATISTIC_METHOD = Aggregate of individual observations
STATISTIC_NUMBER = # of individual samples
* Minimum, Maximum, and Percentiles should only be calculated if the sample size is adequately large.
Example 3: DBH calculated from randomly selected trees within the site
For DBH observations of individual trees randomly selected at the site:
STATISTIC* = Mean, Minimum, Maximum, Percentiles, or Standard Deviation
STATISTIC_METHOD = Aggregate of individual observations
STATISTIC_NUMBER = # of individual samples
* Minimum, Maximum, and Percentiles should only be calculated if the sample size is adequately large.
Example 4: Biomass calculated from 8 plots each with 5 subplots
For Biomass observations collected from 5 subplots located in each of 8 sample plots at the site:
In many cases, the subplot biomass observations are first aggregated at the plot level. Then the plot values are are used to calculate the sitelevel STATISTICs:
STATISTIC* = Mean, Minimum, Maximum, or Standard Deviation
STATISTIC_METHOD = Aggregate of sample aggregates
STATISTIC_NUMBER = 8
If pseudoreplication or spatial autocorrelation is not an issue, the subplot observations may be aggregated across all plots to calculate the sitelevel STATISTIC:
STATISTIC* = Mean, Minimum, Maximum, Percentiles, or Standard Deviation
STATISTIC_METHOD = Aggregate of individual observations
STATISTIC_NUMBER = 40
* Minimum, Maximum, and Percentiles should only be calculated if the sample size is adequately large.
Example 5: Soil carbon calculated from replicate samples at 10 locations
For replicate soil carbon observations at 10 randomlyselected points within the site:
To calculate Mean, Minimum, Maximum, Percentiles, and Standard Deviation, the replicates at each location should first be averaged. Then the average values at each location can be used to calculate the STATISTIC:
STATISTIC* = Mean, Minimum, Maximum, Percentiles, or Standard Deviation
STATISTIC_METHOD = Aggregate of sample aggregates
STATISTIC_NUMBER = 10
* Minimum, Maximum, and Percentiles should only be calculated if the sample size is adequately large.
The average difference between the replicates can be used to estimate the Measurement Uncertainty:
STATISTIC = Measurement Uncertainty
STATISTIC_METHOD = Aggregate of individual observations
STATISTIC_NUMBER = 10
DATE Variables
Many groups have several DATE Variables that can be used to describe the time period that the metadata or ancillary data represents.
Dates should be entered at the precision known and most suitable to the observation. Supported precision include year, month, day, and minute in ISO formats: YYYY, YYYYMM, YYYYMMDD, YYYYMMDDHHMM.
DATE or DATE_START / DATE_END
Either a single DATE or a DATE_START / DATE_END pair is required. Do not enter both for the same observation.
 Use DATE when the observation represents a single point in time. Typical resolutions used are a year, month, or day: YYYY, YYYYMM, YYYYMMDD.
 Use DATE_START / DATE_END when the observation represents a period of time. Start and end dates are often used when observations are collected as part of a campaign. Typically resolution is reported with day (YYYYMMDD), but month is also common (YYYYMM).
Notes:
 Do not enter DATE and DATE_START for the same observation. See “Mutuallyexclusive variables cannot be submitted together” on BADM Basics: Key Concepts.
 Within a BADM group (e.g., HEIGHTC), different observations cannot be reported for the same DATE and DATE_START. See “Rules for unique variable combinations Ⓒ” on BADM Basics: Key Concepts.
 DATE_END must be reported if DATE_START is reported.
DATE_UNC
Uncertainty in the DATE or DATE_START / DATE_END is an optional variable that can also be reported.
Date uncertainty is most commonly reported when the single DATE variable is used.
Report a date uncertainty that is commensurate with the DATE or DATE_START / DATE_END reported. For example if a day is reported for the DATE, date uncertainty should be on the order of days rather than months or years. If a year is reported for the DATE, date uncertainty should be greater than a year.
Customize and Download CSV for BADM Submission
After selecting your desired variables, download the customized CSV file for submission of BADM. For additional submission details, see BADM Submission Instructions. See BADM Basics for general BADM details.
Multiple entries of this BADM group can be reported per site. However, combinations of Ⓒ variables must be unique. Read more: . See BADM Basics for more details.
Optional Variable
Ⓒ Combinations
Examples
Required  Optional  



Submit completed CSV file at Upload Data using the BADM option (login required).