# 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                                        |
