> For the complete documentation index, see [llms.txt](https://ess-dive.gitbook.io/sample-id-and-metadata/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ess-dive.gitbook.io/sample-id-and-metadata/guide.md).

# Guide

Here you will find proposed guidelines for standardizing sample metadata to describe interdisciplinary samples within DOE's Environmental Systems Science research.

Most of the sample metadata follows [SESAR's metadata guidelines](http://doi.org/10.5281/zenodo.3874923). However, we modified some metadata elements, specific requirements, and vocabularies based on ESS researcher needs. This includes additional fields, which mostly come from biodiversity standards [Darwin Core](https://dwc.tdwg.org/), or genomic standards [Minimum Information about any Sequence (MIxS)](https://gensc.org/mixs/).

We seek any additional feedback, with the goal of making ESS sample information **F**indable, **A**ccessible, **I**nteroperable, and **R**eusable (FAIR).

***

## Sample Metadata Content - Link to More Details

\*Required fields are marked with an asterisk, and indicated in detailed tables below.

[**Header Rows**](#header-rows):\
[Object Type\*](#object-type) |[User Code\*](#user-code)

[**Sample IDs and Related Identifiers**](https://github.com/ess-dive-workspace/essdive-sample-id-metadata/blob/main/sample-ids-and-related-identifiers/README.md):\
[Sample Name\*](#sample-name) |[Other names](#other-names) |[IGSN](#igsn) |[Parent IGSN](#parent-igsn) |[Collection ID](#collection-id) |[Event ID](#event-id) |[Location ID](#location-id)

[**Sample Description**](#sample-description):\
[Material\*](#material) |[Field name informal classification](#field-name-informal-classification) |[Sample Description](#sample-description) |[Purpose](#purpose) |[Size](#size) |[Size unit](#size-unit) |[Filter Size](#filter-size) |[Filter Size Unit](#filter-size-unit) |[Scientific Name](#scientific-name) |[Sample Remarks](#sample-remarks)

[**Sample Collection Details**](#sample-collection-details):\
[Collector Chief Scientist\*](#collector-chief-scientist) |[Collection Date\*](#collection-date) |[Collection Time](#collection-time) |[Collection Method Description\*](#collection-method-description) |[Sample Processing](#sample-processing) |[Field Program or Project Name\*](#field-program-or-project-name)

[**Location**](#location):\
[Latitude Coordinate system WGS 84\*](#latitude-coordinate-system-wgs-84) |[Longitude Coordinate system WGS 84\*](#longitude-coordinate-system-wgs-84) |[Navigation Type](#navigation-type) |[Location Description](#location-description) |[Country](#country) |[Elevation start](#elevation-start) |[Elevation end](#elevation-end) |[Elevation unit](#elevation-unit) |[Minimum Depth in Meters](#minimum-depth-in-meters) |[Maximum Depth in Meters](#maximum-depth-in-meters) |[Depth scale](#depth-scale) |[Minimum Distance above Surface in Meters](#minimum-distance-above-surface-in-meters) |[Maximum Distance above Surface in Meters](#maximum-distance-above-surface-in-meters) |

[**Environmental Context**](#environmental-context):\
[Physiographic feature\*](#primary-physiographic-feature) |[Biome](#biome)

[**Sample Access**](#sample-access):\
[Release Date\*](#release-date) |[Current Archive](#current-archive) |[Current Archive Contact](#current-archive-contact)

***

## Header Rows

### Object Type

| ESS-DIVE Proposed Element   | objectType  `Required`                                                                                                                                                                         |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | Broad characterization of the nature of a sample or specimen.                                                                                                                                  |
| **Format**                  | [SESAR Controlled List](https://www.geosamples.org/help/vocabularies#object). See [object type list](/sample-id-and-metadata/term-lists/objecttype.md) for revised terms proposed for ESS-DIVE |
| **Additional Instructions** | Provide feedback on additional terms or revisions needed.                                                                                                                                      |
| **Examples**                | Core; Individual Sample; Organism                                                                                                                                                              |

### User Code

| ESS-DIVE Proposed Element   | userCode  `Required`                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Globally unique IGSN code that will be used as a prefix<br>for IGSNs in the submitted batch template.</p>                                                                                                                                                                                                                                                                                                                                                    |
| **Format**                  | Five-letter code                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Additional Instructions** | <p>User codes should be unique to an individual or large project managed by a team;<br>avoid creating multiple user codes. If assigning IGSNs in the IGSN column,<br>the user code must match the user code in the IGSNs. For example, if the user<br>specifies IEMEG is the user code, any user-specified IGSNs must begin with IEMEG.<br>If you do not specify the user code to be used, a default user code belonging<br>to the registrant will be used.</p> |
| **Examples**                | IEMEG, IEJDE                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

***

## Sample IDs and Related Identifiers

### Sample Name

| ESS-DIVE Proposed Element   | sampleName  `Required`                                                                                                  |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Collector's project-specific sample name, which must be unique for each sample that<br>you are submitting.</p>       |
| **Format**                  | free text, unique                                                                                                       |
| **Additional Instructions** | <p>You can develop a sample ID that has meaning to you and may help in your internal,<br>project sample management.</p> |
| **Examples**                | 001-ER18-FO                                                                                                             |

### Other names

| ESS-DIVE Proposed Element   | otherName  `Optional`                                    |
| --------------------------- | -------------------------------------------------------- |
| **Definition**              | Other sample name(s) that have been used in the past.    |
| **Format**                  | free text                                                |
| **Additional Instructions** | Use a semi-colon to delimit multiple names where needed. |
| **Examples**                | 001ER18FO; 001ER18-FO                                    |

### IGSN

| ESS-DIVE Proposed Element   | IGSN  `Recommended`                                                                                                                                                                                                                                                                                                    |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Globally unique and persistent identifier for the sample. Leave blank if you want<br>SESAR to assign the IGSN, which is recommended.</p>                                                                                                                                                                            |
| **Format**                  | semi-opaque, alphanumeric characters (9 recommended)                                                                                                                                                                                                                                                                   |
| **Additional Instructions** | <p>For split samples/subsamples, you can assign your own 1-2 character extensions from<br>the Parent IGSN, and submit your own IGSNs for registering these child samples.<br>This is not required, but is an option if desired. For assigning your own<br>IGSNS, you must use upper-case alpha-numeric characters.</p> |
| **Examples**                | IEWER7214, IEMEG0215                                                                                                                                                                                                                                                                                                   |

### Parent IGSN

| Proposed ESS-DIVE Element   | parentIGSN  if relevant,`Required`                                                                                                                                                                                                                                                                                                            |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>The larger sample from which a child sample was derived. For example, a core section<br>may be the parent of a series of subsamples or split samples. Parent<br>and child samples are linked in the SESAR catalog. Sibling samples are inferred<br>from parent-child relationships and are linked on the landing page for a<br>sample.</p> |
| **Format**                  | semi-opaque, alphanumeric characters (9 recommended)                                                                                                                                                                                                                                                                                          |
| **Additional Instructions** | Leave blank if a parent IGSN does not exist.                                                                                                                                                                                                                                                                                                  |
| **Examples**                | IEMEG0002                                                                                                                                                                                                                                                                                                                                     |

### Collection ID

*Not a SESAR Field*

| Proposed ESS-DIVE Element   | collectionID  `Optional`                                                                                                                                                                                                                                                                                                                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>A unique identifier for the set of information associated with a collection of<br>samples; collections may be organized around a particular project, data set,<br>field season, region, site, etc.</p>                                                                                                                                                                                               |
| **Format**                  | free text, unique                                                                                                                                                                                                                                                                                                                                                                                       |
| **Additional Instructions** | <p>Must be unique within the data package (project-assigned, and does not need<br>to be globally unique). See link to diagram that demonstrates linking related<br>collection, site, event, and sample IDs. A collection identifier can be<br>used to link a set of samples together, and/or to enable efficient entry of<br>metadata that is the same across all samples in a "sample collection."</p> |
| **Examples**                | WSFA\_June2019                                                                                                                                                                                                                                                                                                                                                                                          |

### Event ID

*Not a SESAR Field*

| Proposed ESS-DIVE Element   | eventID  `Optional`                                                                                                                                                                                                                                                                                                                                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Definition**              | <p>A unique identifier for the set of information associated with an Event<br>(something that occurs at a place and time).</p>                                                                                                                                                                                                                                                                   |
| **Format**                  | free text, unique                                                                                                                                                                                                                                                                                                                                                                                |
| **Additional Instructions** | <p>Must be unique within the data package (project-assigned, and does not need<br>to be globally unique). See link to diagram that demonstrates linking related<br>collection, site, event, and sample IDs. An event identifier can be used to<br>link a set of samples collected on a specific date, and/or to enable efficient<br>entry of metadata that is the same across these samples.</p> |
| **Examples**                | WSFA\_20191023                                                                                                                                                                                                                                                                                                                                                                                   |

### Location ID

*Not a SESAR Field*

| Proposed ESS-DIVE Element   | locationID  `Optional`                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Definition**              | <p>A unique identifier for the set of location information. May be a global<br>unique identifier or an identifier specific to the data set.</p>                                                                                                                                                                                                                                                  |
| **Format**                  | free text, unique                                                                                                                                                                                                                                                                                                                                                                                |
| **Additional Instructions** | <p>Must be unique within the data package (project-assigned, and does not need to<br>be globally unique). See link to diagram that demonstrates linking related<br>collection, site, event, and sample IDs. A site identifier can be used to link<br>a set of samples collected from a specific site, and/or to enable<br>efficient entry of metadata that is the same across these samples.</p> |
| **Examples**                | CoyoteRiver\_D22                                                                                                                                                                                                                                                                                                                                                                                 |

***

## Sample Description

### Material

| Proposed ESS-DIVE Element   | material  `Required`                                                                                                                                                                                                                  |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | Material that the sample consists of.                                                                                                                                                                                                 |
| **Format**                  | <p><a href="https://app.geosamples.org/reference/materials.php">SESAR controlled list.</a>See ESS-DIVE's proposed <a href="/sample-id-and-metadata/term-lists/material.md">material terms</a> from Environment<br>Ontology (ENVO)</p> |
| **Additional Instructions** | <p>Use a semi-colon to delimit multiple materials where needed. Please provide feedback<br>on any other terms needed.</p>                                                                                                             |
| **Examples**                | Soil; Sediment; Gas; Liquid>aqueous                                                                                                                                                                                                   |

### Field name informal classification

| Proposed ESS-DIVE Element   | classification, or remove  `Optional`                                                                                    |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Definition**              | Informal classification of sample                                                                                        |
| **Format**                  | free text                                                                                                                |
| **Additional Instructions** | <p>Here you can add additional material classifications that are not in the current SESAR<br>IGSN controlled fields.</p> |
| **Examples**                | leaf, root, surface water, groundwater                                                                                   |

### Sample Description

| Proposed ESS-DIVE Element   | sampleDescription  `Recommended`                                                                                                                                     |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Description of sample features, such as its components, texture, color, shape,<br>treatments, plot ID from which the sample was taken, etc.</p>                   |
| **Format**                  | free-text                                                                                                                                                            |
| **Additional Instructions** |                                                                                                                                                                      |
| **Examples**                | <p>Example 1) Day 223 core section from unheated control plot 1C of a deep soil warming<br>experiment; Example 2) Filter used for filtered surface water samples</p> |

### Purpose

| Proposed ESS-DIVE Element   | purpose  `Recommended`                                                                                                                                                                                                                                                                                                                                                              |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | The scientific purpose for collecting the sample.                                                                                                                                                                                                                                                                                                                                   |
| **Format**                  | free text                                                                                                                                                                                                                                                                                                                                                                           |
| **Additional Instructions** | <p>Purpose may often be the same across a series/collection of samples;<br>To avoid entering the same information across numerous samples, you can create<br>a separate file with metadata to describe a sample collection, which contains<br>a "collectionID", and any associated metadata fields (e.g.<br>"collectionMethodDescription", "Purpose", "Chief Scientist", etc.).</p> |
| **Examples**                | <p>Characterize the biogeochemistry, geochemistry and microbiology of soils<br>associated with trees and shrubs.</p>                                                                                                                                                                                                                                                                |

### Size

| Proposed ESS-DIVE Element   | size  `Optional`                                                                                       |
| --------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Definition**              | <p>Size of the registered object, such as the surface area, length of a core, weight,<br>or volume</p> |
| **Format**                  | Number                                                                                                 |
| **Additional Instructions** | Must be associated with Size unit.                                                                     |
| **Examples**                | 4; 6.8                                                                                                 |

### Size unit

| Proposed ESS-DIVE Element   | sizeUnit  only if Size provided,`Required`                                                                     |
| --------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Definition**              | Unit for the numerical value provided for ‘size’.                                                              |
| **Format**                  | [Controlled List](/sample-id-and-metadata/term-lists/units.md)                                                 |
| **Additional Instructions** | Use any additional unit terms from [Units Ontology](http://www.ontobee.org/ontology/UO), and provide feedback. |
| **Examples**                | square centimeter; kilogram                                                                                    |

### Filter Size

*Not a SESAR Field*

| Proposed ESS-DIVE Element   | <p>filterSize  only if object type is "fitrate" or<br>"material captured in filter",<code>Required</code></p> |
| --------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Filtering pore size used in sample preparation (filter size value range). Filter size<br>value range.</p>  |
| **Format**                  | Number range (float-float)                                                                                    |
| **Additional Instructions** |                                                                                                               |
| **Examples**                | 0-0.22                                                                                                        |

### Filter Size Unit

*Not a SESAR Field*

| Proposed ESS-DIVE Element   | <p>filterSizeUnit  only if object type is "fitrate" or<br>"material captured in filter",<code>Required</code></p> |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Definition**              | Filtering pore size unit.                                                                                         |
| **Format**                  | unit (float-float unit)                                                                                           |
| **Additional Instructions** |                                                                                                                   |
| **Examples**                | micrometer                                                                                                        |

### Scientific Name

*Not a SESAR Field*

| Proposed ESS-DIVE Element   | <p>scientificName  only if object type is Organism,<br><code>Required</code></p>                                                                                                                             |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Definition**              | <p>The full scientific name, with authorship and date information if known. When<br>forming part of an Identification, this should be the name in lowest level taxonomic<br>rank that can be determined.</p> |
| **Format**                  |                                                                                                                                                                                                              |
| **Additional Instructions** |                                                                                                                                                                                                              |
| **Examples**                | Vochysia ferruginea; Miconia borealis; Terminalia amazonia                                                                                                                                                   |

### Sample Remarks

*Not a SESAR Field*

| Proposed ESS-DIVE Element   | sampleRemarks  `Optional`                               |
| --------------------------- | ------------------------------------------------------- |
| **Definition**              | Comments or notes about the sample.                     |
| **Format**                  | free text                                               |
| **Additional Instructions** | You can include weather descriptions here, if relevant. |
| **Examples**                |                                                         |

***

## Sample Collection Details

### Collector Chief Scientist

| Proposed ESS-DIVE Element   | collector  `Required`                                                                                                                                                                                                             |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | Name of the person(s) who collected the sample.                                                                                                                                                                                   |
| **Format**                  |                                                                                                                                                                                                                                   |
| **Additional Instructions** | <p>You can enter multiple collectors/sampling team for large sampling efforts, separated<br>with a semi-colon. If the collector(s) of the sample(s) is/are not known,<br>enter name of the person responsible for the sample.</p> |
| **Examples**                | John Smith; Jane Johnson                                                                                                                                                                                                          |

### Collection Date

| Proposed ESS-DIVE Element   | collectionDate  `Required`                                                                                                                                                                                                                            |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | Date when the sample was collected.                                                                                                                                                                                                                   |
| **Format**                  | YYYY-MM-DD                                                                                                                                                                                                                                            |
| **Additional Instructions** | <p>All dates and times must be reported in Coordinated Universal Time (UTC) and follow<br>the ISO 8601 standard (RFC 3339). Temporal data using different standards can be<br>provided as a separate variable (column) in addition to UTC format.</p> |
| **Examples**                | 2019-08-14                                                                                                                                                                                                                                            |

### Collection Time

| Proposed ESS-DIVE Element   | collectionTime  `Optional`                                                                                                                                                                                                                            |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | Time when the sample was collected.                                                                                                                                                                                                                   |
| **Format**                  | HH:MM:SSZ                                                                                                                                                                                                                                             |
| **Additional Instructions** | <p>All dates and times must be reported in Coordinated Universal Time (UTC) and follow<br>the ISO 8601 standard (RFC 3339). Temporal data using different standards can be<br>provided as a separate variable (column) in addition to UTC format.</p> |
| **Examples**                | 12:05:03Z                                                                                                                                                                                                                                             |

### Collection Method Description

| Proposed ESS-DIVE Element   | collectionMethodDescription  `Required`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Description of the collection method for the sample. Include any important terms<br>and details for potential users to understand how your sample was collected.</p>                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Format**                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Additional Instructions** | <p>Collection methods may often be the same across a series/collection of samples;<br>there are two options for providing collection method details at a higher level.<br>Option 1: Create a separate file with metadata to describe a sample<br>collection, which contains a "collectionID", and any associated metadata fields<br>(e.g. "collectionMethodDescription", "Purpose", "Chief Scientist", etc.).<br>Option 2: Create a methods file, with a series of methods descriptions<br>that are each associated with a "methodID" and an associated "methodDescription."</p> |
| **Examples**                | <p>Example 1) Collect soil samples from top 10 cm using 2-3 cores from with meadow<br>plot or under the bulk of tree/shrub canopies. Example 2) Excised branch.<br>Example 3) Pumped water at specific depths using tubing connected to CTD.</p>                                                                                                                                                                                                                                                                                                                                 |

### Sample Processing

*Not a SESAR Field*

| Proposed ESS-DIVE Element   | sampleProcessing  if relevant, `Recommended`                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Any processing applied to the sample during or after retrieving the sample from the<br>environment. Can provide a list of preparations and preservation<br>methods for the sample.</p>                                                                                                                                                                                                                                                                                              |
| **Format**                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Additional Instructions** | <p>Sample processing may often be the same across a series/collection of samples.<br>To avoid entering the same information across numerous samples, you can create<br>a separate file with metadata to describe a sample collection, which contains<br>a "collectionID", and any associated metadata fields (e.g.<br>"sampleProcessing", "collectionMethodDescription", "Purpose", "Chief Scientist",<br>etc.). Separate multiple sample processing methods<br>with a semi-colon.</p> |
| **Examples**                | filter water; store samples in ethanol                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

### Field Program or Project Name

*SESAR name is "Field Program/Cruise"*

| Proposed ESS-DIVE Element   | projectName  `Required`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | Enter the name of the DOE project to associate with this/these sample(s).                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Format**                  | free text                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Additional Instructions** | <p>Required at dataset level, but want to associate with samples for data search<br>and integration. Project details may often be the same across a series/collection<br>of samples; To avoid entering the same information across numerous samples,<br>you can create a separate file with metadata to describe a project or<br>sample collection, which contains a "collectionID" or "Field Program/Cruise",<br>and any associated metadata fields (e.g. "Collection Method Description",<br>"Purpose", "Chief Scientist"...</p> |
| **Examples**                | <p>Next Generation Ecosystem Experiments (NGEE) Tropics; LBNL Watershed Function<br>SFA</p>                                                                                                                                                                                                                                                                                                                                                                                                                                        |

***

## Location

### Latitude Coordinate system WGS 84

| Proposed ESS-DIVE Element   | decimalLatitude  if relevant, `Required`                                                                                                               |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Definition**              | <p>Latitude of the location where the sample was collected, entered in decimal<br>degrees. Negative values for South latitudes.</p>                    |
| **Format**                  | Decimal degrees, coordinate system: WGS 84                                                                                                             |
| **Additional Instructions** | <p>Please supply no more than 6 decimal places (meter scale resolution) in the actual<br>number (not just display format.) No letters are allowed.</p> |
| **Examples**                | 5.89634                                                                                                                                                |

### Longitude Coordinate system WGS 84

| Proposed ESS-DIVE Element   | decimalLongitude if relevant, `Required`                                                                                                               |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Definition**              | <p>Longitude of the location where the sample was collected. Negative values<br>for ‘West’ longitudes.</p>                                             |
| **Format**                  | Decimal degrees, coordinate system: WGS 84                                                                                                             |
| **Additional Instructions** | <p>Please supply no more than 6 decimal places (meter scale resolution) in the actual<br>number (not just display format.) No letters are allowed.</p> |
| **Examples**                | -103.785                                                                                                                                               |

### Navigation Type

| Proposed ESS-DIVE Element   | geolocationInstrument `Recommended`                                                                           |
| --------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Definition**              | Type of geolocation instrument used to obtain geographic coordinates.                                         |
| **Format**                  | [Controlled list](http://www.marine-geo.org/tools/search/vocab.php?use_is_displayed=T\&vocab=vocab_nav_type). |
| **Additional Instructions** | Provide feedback on additional terms needed.                                                                  |
| **Examples**                | GPS; RTK GPS                                                                                                  |

### Location Description

| Proposed ESS-DIVE Element   | locationDescription `Recommended`                                                                                                                   |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | Free text description of the location.                                                                                                              |
| **Format**                  |                                                                                                                                                     |
| **Additional Instructions** | <p>You can also include details here about the location type, e.g. whether it is an<br>absolute or reference location, plot ID and description.</p> |
| **Examples**                | 300 year old low-land tropical rainforest in Parque Natural San Lorenzo, Panama                                                                     |

### Country

| Proposed ESS-DIVE Element   | country `Required`                                                                                    |
| --------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Definition**              | Country where the sample was collected.                                                               |
| **Format**                  | [SESAR controlled list](https://www.geosamples.org/help/vocabularies/country).                        |
| **Additional Instructions** | Use SESAR list, but may change controlled list to [GAZ ontology](http://purl.obolibrary.org/obo/gaz). |
| **Examples**                | United States                                                                                         |

### Elevation start

| Proposed ESS-DIVE Element   | minimumElevationInMeters  `Optional`                                                                           |
| --------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Elevation at which a sample was collected. Minimum elevation value, if elevation<br>taken over a range.</p> |
| **Format**                  | Number                                                                                                         |
| **Additional Instructions** | Provide elevation in meters where possible.                                                                    |
| **Examples**                | 678.5                                                                                                          |

### Elevation end

| Proposed ESS-DIVE Element   | maximumElevationInMeters  `Optional`                                                                            |
| --------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Maximum elevation at which a sample was collected, if elevation was taken over a<br>range.</p>               |
| **Format**                  | Number                                                                                                          |
| **Additional Instructions** | <p>Leave blank if elevation is a single value and not range. Provide elevation in<br>meters where possible.</p> |
| **Examples**                | 689.2                                                                                                           |

### Elevation unit

| Proposed ESS-DIVE Element   | elevationUnit (recommend meters)  if relevant, `Required`               |
| --------------------------- | ----------------------------------------------------------------------- |
| **Definition**              | Unit that elevation start and/or end are provided in.                   |
| **Format**                  | Recommend meters.                                                       |
| **Additional Instructions** | This will be removed when elevation field is changed to specify meters. |
| **Examples**                | meters                                                                  |

### Minimum Depth in Meters

*Note that SESAR field is "Depth in Core (min)"*

| Proposed ESS-DIVE Element   | minimumDepthInMeters  if relevant, `Required`                                                                           |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Depth, or minimum depth (if taken over a range) at which a sample was collected,<br>below ground or under water.</p> |
| **Format**                  | Number                                                                                                                  |
| **Additional Instructions** | Recommend using meters.                                                                                                 |
| **Examples**                | 0.001                                                                                                                   |

### Maximum Depth in Meters

*Note that SESAR field is "Depth in Core (max)"*

| Proposed ESS-DIVE Element   | maximumDepthInMeters  if relevant, `Required`                               |
| --------------------------- | --------------------------------------------------------------------------- |
| **Format**                  | Number                                                                      |
| **Definition**              | Maximum depth at which a sample was collected, below ground or under water. |
| **Additional Instructions** | Recommend using meters.                                                     |
| **Examples**                | 0.003                                                                       |

### Depth scale

| Proposed ESS-DIVE Element   | depthUnit (recommend meters)  if relevant, `Required`                               |
| --------------------------- | ----------------------------------------------------------------------------------- |
| **Format**                  | Recommend meters.                                                                   |
| **Definition**              | Unit in which the depth is provided, should be meters.                              |
| **Additional Instructions** | This field will be deleted when we change the depth field to be required in meters. |
| **Examples**                | meters                                                                              |

### Minimum Distance above Surface in Meters

*Not a SESAR Field*

| Proposed ESS-DIVE Element   | minimumDistanceAboveSurfaceInMeters  `Optional`                                                                                 |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Minimum height above the ground surface, in meters. If no range of values collected,<br>provide height measurement here.</p> |
| **Format**                  | Number                                                                                                                          |
| **Additional Instructions** |                                                                                                                                 |
| **Examples**                | 4.2                                                                                                                             |

### Maximum Distance above Surface in Meters

*Not a SESAR Field*

| Proposed ESS-DIVE Element   | maximumDistanceAboveSurfaceInMeters  `Optional`     |
| --------------------------- | --------------------------------------------------- |
| **Definition**              | Maximum height above the ground surface, in meters. |
| **Format**                  | Number                                              |
| **Additional Instructions** |                                                     |
| **Examples**                | 7.2                                                 |

***

## Environmental Context

### Physiographic feature

| Proposed ESS-DIVE Element   | localEnvironmentalContext  `Recommended`                                                                                                                                                                                                                                                                                                                                                               |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Definition**              | <p>Entity or entities which are in your sample or specimen’s local vicinity and<br>which you believe have significant causal influences on your sample or<br>specimen.</p>                                                                                                                                                                                                                             |
| **Format**                  | <p><a href="https://www.ebi.ac.uk/ols/ontologies/envo">Terms from Environment Ontology (ENVO)</a>. Provide the appropriate term and<br>ENVO identifier - see examples below.</p>                                                                                                                                                                                                                       |
| **Additional Instructions** | <p>Choose environmental context that is a smaller spatial grain than your entry<br>for biome. Delimit multiple values using semi-colon. If needed, request new<br>terms on the ENVO tracker, <a href="http://www.obofoundry.org/ontology/envo.html">identified here</a>.</p>                                                                                                                           |
| **Examples**                | <p>river \[ENVO:00000022]; pond \[ENVO:00000033]; wet meadow ecosystem<br>\[ENVO:01000449]; mountain \[ENVO:00000081]<br><em>For annotating a pooled sample taken from various</em><br><em>vegetation layers in a forest, consider:</em> canopy \[ENVO:00000047]; herb and<br>fern layer \[ENVO:01000337]; litter layer \[ENVO:01000338];<br>understory \[01000335]; shrub layer \[ENVO:01000336].</p> |

### Biome

*Not a SESAR Field*

| Proposed ESS-DIVE Element   | biome  `Recommended`                                                                                                                                                                                                                                                                                              |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Major environmental system your sample or specimen came from. The systems<br>identified should have a coarse spatial grain, to provide the general environmental<br>context of where the sampling was done (e.g. were you in the desert or a<br>rainforest?).</p>                                              |
| **Format**                  | <p><a href="https://www.ebi.ac.uk/ols/ontologies/envo">Terms from Environment Ontology (ENVO)</a>. Provide the appropriate term and ENVO<br>identifier - see examples below.</p>                                                                                                                                  |
| **Additional Instructions** | <p>We recommend using subclasses of <a href="http://purl.obolibrary.org/obo/ENVO_00000428">ENVO’s biome class</a>. Use a semi-colon to delimit multiple biomes where needed. If needed, request new<br>terms on the ENVO tracker, <a href="http://www.obofoundry.org/ontology/envo.html">identified here</a>.</p> |
| **Examples**                | <p>shrubland biome \[ENVO:01000176]; tropical moist broadleaf forest biome<br>\[ENVO:01000228]; estuarine biome \[ENVO:01000020]</p>                                                                                                                                                                              |

***

## Sample Access

### Release Date

| Proposed ESS-DIVE Element   | releaseDate  `Required`                                                                                                                              |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Date when sample metadata should be publicly accessible and searchable. If null<br>, defaults to date of registration in SESAR (recommended).</p> |
| **Format**                  | YYYY-MM-DD                                                                                                                                           |
| **Additional Instructions** | <p>SESAR recommends that sample metadata become public within 2 years of sample<br>registration.</p>                                                 |
| **Examples**                | 2018-03-15                                                                                                                                           |

### Current Archive

| Proposed ESS-DIVE Element   | currentArchive  `Optional`                                                                            |
| --------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Definition**              | Name of institution, museum, or repository where the sample is currently stored.                      |
| **Format**                  |                                                                                                       |
| **Additional Instructions** | <p>Only applies to physical samples that are archived in a collection for some period<br>of time.</p> |
| **Examples**                | <p>Geosciences and Environmental Change Science Center, USGS Federal Center, Lakewood,<br>CO</p>      |

### Current Archive Contact

| Proposed ESS-DIVE Element   | currentArchiveContact  `Optional`                                                                                   |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Definition**              | <p>Address and/or email of the person who should be contacted for information about<br>or access to the sample.</p> |
| **Format**                  | free text                                                                                                           |
| **Additional Instructions** | Email is not mandatory, but helps with communication about samples.                                                 |
| **Examples**                | <scientist@lbl.gov>                                                                                                 |
