Biological, Ancillary, Disturbance, and Metadata (BADM) are non-continuous information that describe and complement continuous Flux/Met data. Browse BADM Standards for variables, definitions, and units.
BADM Organization
If there are subgroups…
Required and Optional variables
Mutually-exclusive variables cannot be submitted together
Rules for unique variable combinations Ⓒ
Use specified units, including predefined lists
BADM Organization
BADM are organized by the following hierarchy:
BADM types were previously known as templates.
BADM groups contain variables that describe related metadata or an observation with related metadata. Example groups include canopy height, LAI, soil chemistry, biomass and disturbance/management.
The variables included within a group or subgroup may include the metadata/observation value, date, method, and/or other information needed to interpret the value. All required variables within the group or subgroup must be submitted (see Required and Optional Variables below).
If there are subgroups…
A BADM group has subgroups if there are more than one shaded grey titles on the Overview and Customize CSV tabs of the BADM group page:
The “Applies to All” section contains variables that apply to all subgroups.
Subgroups are also indicated by a number prefix in the Requirements (e.g., 1-Required, 1-Optional) on the Definitions & Units tab:
And in the downloadable custom CSV reporting file:
If there are subgroups:
- At least one subgroup within the group must be submitted to form a valid group entry.
- Required variables are required within the subgroup as indicated by the prefix number.
- “Applies to All” required variables without the prefix number must be included with the subgroup variables to make a complete group.
Required and Optional Variables
Required and Optional variables are noted on each BADM group page. All required variables within the subgroups (if present) or group being submitted must have values and be included in a group entry. Unused optional variables do not need to be submitted.
Mutually-exclusive variables cannot be submitted together
Mutually-exclusive variables are indicated by an “OR” on the Overview and Customize CSV* tabs of each BADM group page:
* Mutually-exclusive variables can both be included in a CSV file, but values cannot be submitted for both variables in the same row. See details below.
Mutually-exclusive variables are also indicated by a letter suffix in the Requirements (e.g., Required-a, Optional-b) on the Definitions & Units tab:
And in the downloadable custom CSV reporting file as illustrated below.
Mutually exclusive variables with letter suffix (e.g., “-c”) can be included in the CSV file, but only one variable per row can be reported.
Enter mutually-exclusive variables on separate rows. | |
Do not enter more than one mutually-exclusive variable per row. | |
Watch for matching suffixes (e.g., “-c”). |
HEIGHTC | HEIGHTC_DATE | HEIGHTC_DATE_START | HEIGHTC_DATE_END | |
1-Required | Required-c | Required-c | Optional | |
m | YYYYMMDDHHMM | YYYYMMDDHHMM | YYYYMMDDHHMM | |
11.5 | 2003 | |||
12.2 | 20040605 | 20040610 | ||
11.5 | 2003 | 20040605 | 20040610 |
Rules for unique variable combinations Ⓒ
Most BADM support site-level information. Typically a single characteristic for the site is reported for a give time period. Thus, within a subgroup and group, one observation for a unique combination of variables is allowed. Variables included in a unique combination are marked with Ⓒ for groups that support multiple entries.
Only one observation for the same combination of Ⓒ variables is permitted.
Combination of Ⓒ variables are unique. | |
Do not enter combination of Ⓒ variables that are the same. |
Observation | Ⓒ | Ⓒ | Contextual variable | |
---|---|---|---|---|
HEIGHTC | HEIGHTC_STATISTIC | HEIGHTC_DATE | HEIGHTC_APPROACH | |
1-Required | 1-Required | Required-c | Optional | |
m | LIST(STATISTIC) | YYYYMMDDHHMM | free text | |
9.8 | Mean | 2003 | 5 2x2m plots | |
10.2 | Mean | 2004 | 5 2x2m plots | |
0.4 | Standard Deviation | 2004 | 5 2x2m plots | |
13.2 | Maximum | 2004 | 5 2x2m plots | |
14.4 | Maximum | 2004 | extracted from LIDAR |
Continuing the example with the subgroup Canopy Height from the HEIGHTC group, the minimum set of required variables that have a unique combination are as follows:
- HEIGHTC, HEIGHT_STATISTIC, HEIGHT_DATE
- HEIGHTC, HEIGHT_STATISTIC, HEIGHT_DATE_START
Considering the optional variables, the additional unique combinations are as follows:
- HEIGHTC, HEIGHT_STATISTIC, HEIGHT_DATE, HEIGHTC_SPP
- HEIGHTC, HEIGHT_STATISTIC, HEIGHT_DATE_START, HEIGHT_SPP
- HEIGHTC, HEIGHT_STATISTIC, HEIGHT_DATE, HEIGHT_VEGTYPE
- HEIGHTC, HEIGHT_STATISTIC, HEIGHT_DATE_START, HEIGHT_VEGTYPE
Any other additional subgroup or group variables can also be included in these 6 options.
Use specified units, including predefined lists
BADM variables have specified units. When submitting BADM, report observations and metadata in the specified units. When using BADM, find units in the BADM Group Definitions & Units tab (see below).
Some units are predefined lists, indicated by “LIST(Vocabulary)”. “Vocabulary” is specific to the variable. For example HEIGHTC_STATISTIC has units LIST(STATISTIC).
“Show” Vocabulary Options on the BADM Group Definitions & Units tab:
For variables with a predefined list, like FLUX_MEASUREMENTS_METHOD, use one of the “Options” to report the variable:
Biological, Ancillary, Disturbance, and Metadata (BADM) are non-continuous information that describe and complement continuous Flux/Met data. Browse BADM Standards for variables, definitions, and units.
Using BADM
Read about the BIF (BADM Interchange Format) here.
Browse BADM Standards pages Definitions & Units tab for details on BADM.
Submitting BADM
Use SPP or VEGTYPE variables only if the observation is specific to a species or vegetation type within the site.
For example, only report HEIGHTC_SPP if the HEIGHTC observation is specific to a particular species. If the HEIGHTC observation is for the entire site, do not enter SPP or VEGTYPE values.
Use the BADM group SPP (Species composition) to report the species or vegetation types present at a site.
Some variables are mutually-exclusive and cannot be entered together:
- Don’t enter SPP and VEGTYPE together.
- Don’t enter DATE and DATE_START together.
While mutually-exclusive variables cannot be entered together, they can both be included in a customizable CSV file. See the mutually-exclusive section on the BADM Basics Key Concepts tab for more detail.
If you are using a variable marked Ⓒ, figure out what it means on the BADM Basics Key Concepts tab.
BADM are submitted in various “reporting” formats: online editors, customizable CSV files, and standard excel files. See BADM Submission Instructions for details.
To customize a CSV file for submission, visit the BADM group page via Browse BADM Standards.
Consider using 2 windows when customizing your CSV file for submission: