# Data Reporting Formats

The DOE's Office of Science Biological and Environmental Research program supported the development of the data reporting formats.

{% hint style="info" %}
Each reporting format has documentation hosted on both **GitBook** and **Github**. Content is exactly the same on both platforms; however, the **GitBook** interface is generally more user-friendly, while on **GitHub** visitors can more easily submit comments and suggestions thorough ***GitHub issues**.* Additionally, for ease of access to the reporting format templates, links to the respective templates are linked with each reporting format table.&#x20;
{% endhint %}

| Which type of data are you collecting or archiving? | Relevant Reporting Format                                                                                                                    |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| All data types                                      | [File Level Metadata](https://docs.ess-dive.lbl.gov/contributing-data/data-reporting-formats#file-level-metadata)                            |
| Data stored in Comma-Separated Value (CSV) files    | [CSV Reporting Format](https://docs.ess-dive.lbl.gov/contributing-data/data-reporting-formats#csv-file-structure)                            |
| Samples of any type                                 | [Sample ID and Metadata Reporting Format](https://docs.ess-dive.lbl.gov/contributing-data/data-reporting-formats#sample-id-metadata)         |
| Soil respiration                                    | [Soil Respiration Reporting Format](https://docs.ess-dive.lbl.gov/contributing-data/data-reporting-formats#soil-respiration)                 |
| Leaf-level gas exchange                             | [Leaf-level Gas Exchange Reporting Format](https://docs.ess-dive.lbl.gov/contributing-data/data-reporting-formats#leaf-level-gas-exchange)   |
| Hydrologic monitoring                               | [Hydrologic Monitoring Reporting Format](https://docs.ess-dive.lbl.gov/contributing-data/data-reporting-formats#hydrologic-monitoring)       |
| Water and soil chemistry                            | [Water and Soil Chemistry Reporting Format](https://docs.ess-dive.lbl.gov/contributing-data/data-reporting-formats#water-and-soil-chemistry) |
| 16S amplicon sequencing                             | [Amplicon Sequencing Reporting Format](https://docs.ess-dive.lbl.gov/contributing-data/data-reporting-formats#16s-amplicon-sequencing)       |
| Model data                                          | [Model Data Archiving Guidelines](https://docs.ess-dive.lbl.gov/contributing-data/data-reporting-formats#model-data-archiving)               |
| Location metadata                                   | [Location metadata Reporting Format](https://docs.ess-dive.lbl.gov/contributing-data/data-reporting-formats#location-metadata)               |
| Unoccupied Aerial System data                       | [UAS Reporting Format](https://docs.ess-dive.lbl.gov/contributing-data/data-reporting-formats#unoccupied-aerial-system-data)                 |

## File Level Metadata

| **File Level Metadata** | Status: **READY TO USE**                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Purpose                 | Provide metadata for each data file uploaded to ESS-DIVE                                                                                                                                                                                                                                                                                                                                      |
| Who should use          | Anyone submitting files to ESS-DIVE, regardless of file type                                                                                                                                                                                                                                                                                                                                  |
| Documentation           | [GitHub](https://github.com/ess-dive-community/essdive-file-level-metadata) or [GitBook](https://ess-dive.gitbook.io/file-level-metadata-reporting-format/); [FLMD](https://github.com/ess-dive-community/essdive-file-level-metadata/blob/main/flmd_template.csv) and [DD](https://github.com/ess-dive-community/essdive-file-level-metadata/blob/main/CSV_dd/CSV_dd_template.csv) Templates |
| Authors                 | Terri Velliquette; Ranjeet Devarakonda; Jessica N. Welch; Michael Crow; Susan Heinz                                                                                                                                                                                                                                                                                                           |
| Institution             | Oak Ridge National Laboratory                                                                                                                                                                                                                                                                                                                                                                 |

## CSV File Structure

| **CSV File Structure** | Status: **READY TO USE**                                                                                                                             |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Purpose                | Guidance for formatting CSV files submitted to ESS-DIVE                                                                                              |
| Who should use         | Anyone submitting tabular data stored in CSV files to ESS-DIVE                                                                                       |
| Documentation          | [GitHub](https://github.com/ess-dive-community/essdive-csv-structure) or [GitBook](https://ess-dive.gitbook.io/csv-file-structure-reporting-format/) |
| Authors                | Terri Velliquette; Ranjeet Devarakonda; Jessica N. Welch; Michael Crow; Susan Heinz                                                                  |
| Institution            | Oak Ridge National Laboratory                                                                                                                        |

## Sample ID Metadata

| Sample ID Metadata | **Status: READY TO USE**                                                                                                                                                                                                                                  |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Purpose            | Provide guidelines for assigning sample identifiers, describing sample collection details, and linking samples to related data in ESS-DIVE and elsewhere                                                                                                  |
| Who should use     | Anyone submitting biological and/or environmental sample data to ESS-DIVE                                                                                                                                                                                 |
| Documentation      | [GitHub](https://github.com/ess-dive-community/essdive-sample-id-metadata) or [GitBook](https://ess-dive.gitbook.io/sample-id-and-metadata/); [Template](https://github.com/ess-dive-community/essdive-sample-id-metadata/blob/master/sampleTemplate.xls) |
| Authors            | Joan Damerow                                                                                                                                                                                                                                              |
| Institution        | Lawrence Berkeley National Laboratory                                                                                                                                                                                                                     |

## Soil Respiration

| Soil Respiration | Status: **READY TO USE**                                                                                                                                                                                                                               |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Purpose          | Guidance for structuring data and metadata for soil respiration observations                                                                                                                                                                           |
| Who should use   | Anyone submitting soil respiration data to ESS-DIVE                                                                                                                                                                                                    |
| Documentation    | [GitHub](https://github.com/ess-dive-community/essdive-soil-respiration) or [GitBook](https://ess-dive.gitbook.io/soil-respiration-reporting-format/); [Templates](https://github.com/ess-dive-community/essdive-soil-respiration/tree/main/templates) |
| Authors          | Ben Bond-Lamberty and Stephanie Pennington                                                                                                                                                                                                             |
| Institution      | Pacific Northwest National Laboratory                                                                                                                                                                                                                  |

## Leaf-level Gas Exchange

| Leaf-level Gas Exchange | Status: **READY TO USE**                                                                                                                                                                                                                         |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Purpose                 | Provides guidance for leaf-level gas exchange data and metadata                                                                                                                                                                                  |
| Who should use          | Anyone submitting leaf gas exchange data to ESS-DIVE                                                                                                                                                                                             |
| Documentation           | [GitHub](https://github.com/ess-dive-community/essdive-leaf-gas-exchange) or [GitBook](https://ess-dive.gitbook.io/leaf-level-gas-exchange/); [Templates](https://github.com/ess-dive-community/essdive-leaf-gas-exchange/tree/master/templates) |
| Authors                 | Kim Ely and Alistair Rogers                                                                                                                                                                                                                      |
| Institution             | Brookhaven National Laboratory                                                                                                                                                                                                                   |

## Hydrologic Monitoring

| Hydrologic Monitoring | Status: **READY TO USE**                                                                                                                                                                                                                                               |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Purpose               | Guidance for reporting metrics such as water level, temperature, conductivity and more.                                                                                                                                                                                |
| Who should use        | Anyone submitting hydrologic monitoring data to ESS-DIVE                                                                                                                                                                                                               |
| Documentation         | [GitHub](https://github.com/ess-dive-community/essdive-hydrologic-monitoring) or [GitBook](https://ess-dive.gitbook.io/hydrologic-monitoring-data-and-metadata/); [Templates](https://github.com/ess-dive-community/essdive-hydrologic-monitoring/tree/main/templates) |
| Authors               | Amy Goldman                                                                                                                                                                                                                                                            |
| Institution           | Pacific Northwest National Laboratory                                                                                                                                                                                                                                  |

## Water and Soil Chemistry

| Water and Soil Chemistry | Status: **READY TO USE**                                                                                                                                                                                                                                                  |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Purpose                  | Provide guidance to format chemical concentration data for water, soil and sediment                                                                                                                                                                                       |
| Who should use           | Anyone submitting water soil chemistry data to ESS-DIVE                                                                                                                                                                                                                   |
| Documentation            | [GitHub](https://github.com/ess-dive-community/essdive-water-soil-sed-chem) or [GitBook](https://ess-dive.gitbook.io/water-soil-sediment-chemistry-reporting-format/); [Templates](https://github.com/ess-dive-community/essdive-water-soil-sed-chem/tree/main/templates) |
| Authors                  | Kristin Boye                                                                                                                                                                                                                                                              |
| Institution              | SLAC National Accelerator Lab                                                                                                                                                                                                                                             |

## 16S Amplicon Sequencing

| Sample ID Metadata | Status: **READY TO USE**                                                                                                                                                                                                                           |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Purpose            | Provide guidance for scientists producing 16S abundance data products                                                                                                                                                                              |
| Who should use     | Anyone submitting 16S amplicon abundance tables to ESS-DIVE                                                                                                                                                                                        |
| Documentation      | [GitHub](https://github.com/ess-dive-community/essdive-amplicon) or [GitBook](https://ess-dive.gitbook.io/amplicon-sequencing-reporting-format/); [Templates](https://github.com/ess-dive-community/essdive-amplicon/tree/main/templates_and_maps) |
| Authors            | Pamela Weisenhorn                                                                                                                                                                                                                                  |
| Institution        | Argonne National Lab                                                                                                                                                                                                                               |

## Model Data Archiving

| Sample         | Status: **READY TO USE**                                                                                                                                           |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Purpose        | Provide guidance to structure model data submissions                                                                                                               |
| Who should use | Anyone submitting model data to ESS-DIVE                                                                                                                           |
| Documentation  | [GitHub](https://github.com/ess-dive-community/essdive-model-data-archiving-guidelines) or [GitBook](https://ess-dive.gitbook.io/model-data-archiving-guidelines/) |
| Authors        | Maegen Simmons                                                                                                                                                     |
| Institution    | Lawrence Berkeley National Lab                                                                                                                                     |

## Location metadata

| Location       | Status: READY TO USE                                                                                                                                                                                                                     |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Purpose        | Provide recommendations about describing research locations                                                                                                                                                                              |
| Who should use | Researchers submitting data about locations to ESS-DIVE                                                                                                                                                                                  |
| Documentation  | [GitHub](https://github.com/ess-dive-community/essdive-location-metadata) or [GitBook](https://ess-dive.gitbook.io/location-metadata/); [Templates](https://github.com/ess-dive-community/essdive-location-metadata/tree/main/templates) |
| Authors        | Rob Crystal-Ornelas                                                                                                                                                                                                                      |
| Institution    | Lawrence Berkeley National Lab                                                                                                                                                                                                           |

## Unoccupied Aerial System data

| UAS Data       | Status: READY TO USE                                           |
| -------------- | -------------------------------------------------------------- |
| Purpose        | Metadata content and data organization recommendations for UAS |
| Who should use | Researchers collecting and formatting UAS data                 |
| Documentation  | [GitHub](https://github.com/ess-dive-community/essdive-uas)    |
| Authors        | Kim Ely and Shawn Serbin                                       |
| Institution    | Brookhaven National Lab                                        |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ess-dive.lbl.gov/contributing-data/data-reporting-formats.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
