About the reporting format

This reporting format is recommended for data from chemical concentration measurements of water, soil, and sediment samples.

Quickstart Guide

  1. Read the instructions for each file type in this reporting format: main instructions, terminology, methods, data, data dictionary

  2. Use term list to fill in templates

  3. Save all templates as CSV files and upload to ESS-DIVE as dataset

How to contribute

This reporting format is evolving and adapting to meet the needs of the community. Feedback and new contributions are welcome. If you would like to suggest a change, please submit a GitHub issue using one of the templates we provide.

Though our intent is to provide a reporting format that will enable data producers to gain wider recognition for their data and data users to gain more streamlined options for automated download and synthesis of datasets, the result is a reporting format that will not fully please anyone and that leaves a lot to be desired from everybody.

If you have any questions about this reporting format, you can also email ESS-DIVE support at ess-dive-support at lbl.gov.

Liscensing information

This repository content is license for use under the CC BY 4.0 license

Funding and acknowledgments

Funding for the development of ESS-DIVE's generic water/soil/sediment sample data and metadata reporting format was provided by the U.S. Department of Energy, Office of Science, Office of Biological and Environmental Research, Climate and Environmental Science Division, Data Management program under contract number DE-AC02-05CH11231.

Boye, K., Crystal-Ornelas, R., O’Ryan, D., Goldman, A. E., Damerow, J., Varadharajan, C., & Agarwal, D. (2022). ESS-DIVE Reporting Format for Sample-based Water and Soil Chemistry Measurements. Environmental Systems Science Data Infrastructure for a Virtual Ecosystem (ESS-DIVE), ESS-DIVE repository. https://doi.org/10.15485/1865731


Our reporting format was loosely based on those used by the EPA and USGS through the Water Quality Portal (WQP), but were also inspired from other standards, best practices, and recommendations within the water quality, soil science, and geological survey communities. Most importantly the reporting format and templates were developed to fit with needs, recommendations, and advice from the DOE-BER-ESS community including both data producers and data users – a summary of the community member feedback and list of consulted members can be found as part of the dataset cited above.

Last updated