You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+9-6Lines changed: 9 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -1,25 +1,28 @@
1
-
# ESS-DIVE Reporting Format for Soil Respiration
1
+
# ESS-DIVE Reporting Format for Soil Respiration v1.0.1
2
2
3
-
This documentation contains guidance for the content and format of ESS-DIVE soil respiration data and metadata reporting format. This reporting format has been developed to meet the needs of the community for a unified reporting format. This initial effort covers the most common variables and provides templates for metadata reporting.
3
+
This documentation contains guidance for the content and format of ESS-DIVE soil respiration data and metadata reporting format. This reporting format has been developed to meet the needs of the researchers for a unified reporting format. This initial effort covers the most common variables and provides templates for metadata reporting.
4
4
5
5
---
6
6
7
7
## Getting started
8
8
9
-
### Ready to use the reporting format? [Click here for detailed instructions](https://github.com/ess-dive-community/essdive-soil-respiration/blob/main/instructions.md)
9
+
### Ready to use the reporting format? [Click here for detailed instructions](instructions.md)
10
+
11
+
## Updates in v1.0.1
12
+
In March 2025, a patch version of the Soil Respiration reporting format was made to improve the overall experience with the associated reporting format documentation. Additionally, the standard reporting format keyword and standard term were added to the instructions.md file.
10
13
11
14
## How to contribute
12
15
13
-
This reporting format is constantly evolving to meet the needs of the community. To contribute or provide feedback to ESS-DIVE's soil respiration data and metadata reporting format:
16
+
This reporting format is constantly evolving to meet the needs of DOE ESS researchers. To contribute or provide feedback to ESS-DIVE's soil respiration data and metadata reporting format:
14
17
15
-
1. Go to the [new issue page](https://github.com/ess-dive-community/essdive-soil-respiration/issues/new/choose)
18
+
1. Go to the [new issue page](https://github.com/ess-dive-workspace/essdive-soil-respiration/issues/new/choose)
16
19
2. Choose from one of the provided templates, modeled from the Darwin Core, or create your own
17
20
3. Will we respond with a comment on the issue
18
21
19
22
Have a question? Contact us at ess-dive-support@lbl.gov.
20
23
21
24
## Copyright information
22
-
This soil respiration data and metadata reporting format is licensed under [CC BY 4.0](https://github.com/ess-dive-community/essdive-soil-respiration/blob/main/LICENSE.md).
25
+
This soil respiration data and metadata reporting format is licensed under [CC BY 4.0](LICENSE.md).
Copy file name to clipboardExpand all lines: instructions.md
+7-5Lines changed: 7 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -2,11 +2,13 @@
2
2
3
3
A data package containing soil respiration data must include, at a minimum:
4
4
5
-
1. Assemble the data table by downloading and filling in the [data template](https://github.com/ess-dive-community/essdive-soil-respiration/blob/main/templates/data_reportingformat_template.xlsx). These serve as a guide for how the table should be structured. See our [data format guide](https://github.com/ess-dive-community/essdive-soil-respiration/blob/main/data_reporting_format_guide.md) for descriptions and instructions for each data field.
5
+
1. Assemble the data table by downloading and filling in the data template in [XLSX](templates/data_reportingformat_template.xlsx) or [CSV](templates/data_reportingformat_template.csv) format. These serve as a guide for how the table should be structured. See our [data format guide](/data_reporting_format_guide.md) for descriptions and instructions for each data field.
6
6
7
-
2. Assemble the metadata table by downloading and filling in the [chamber-level metadata template](https://github.com/ess-dive-community/essdive-soil-respiration/blob/main/templates/chammetadata_reportingformat_template.xlsx). See our [chamber-level metadata format guide](https://github.com/ess-dive-community/essdive-soil-respiration/blob/main/chamber_level_metadata_guide.md) for descriptions and instructions for each field.
7
+
2. Assemble the metadata table by downloading and filling in the chamber-level metadata template in [XLSX](templates/chammetadata_reportingformat_template.xlsx) or [CSV](templates/chammetadata_reportingformat_template.csv) formats. See our [chamber-level metadata format guide](chamber_level_metadata_guide.md) for descriptions and instructions for each field.
8
8
9
-
4. Ensure that all _required_ data types are included for each table (see required data tables below) and save each file as a `.csv`
9
+
3. Ensure that all _required_ data types are included for each table (see required data tables below) and save each file as a `.csv`
10
+
11
+
4. Within the FLMD file, the [standard](https://github.com/ess-dive-workspace/essdive-file-level-metadata/blob/main/flmd_quick_guide.md#standard) for each soil respiration reporting format related file should be **ESS-DIVE Soil Respiration v1**. If submitting your dataset to ESS-DIVE, include the keyword **ESS-DIVE Soil Respiration Reporting Format** in the package-level metadata.
@@ -26,8 +28,8 @@ A data package containing soil respiration data must include, at a minimum:
26
28
27
29
## Additional information
28
30
29
-
Defined variables should be used where available. For **variables not yet covered** by this reporting format documentation, data contributors should use machine readable variable names that are in common use and follow ESS-DIVE data dictionary format guidelines as described [here](https://github.com/ess-dive-community/essdive-file-level-metadata/blob/master/CSV_dd/CSV_dd_instructions.md).
31
+
Defined variables should be used where available. For **variables not yet covered** by this reporting format documentation, data contributors should use machine readable variable names that are in common use and follow ESS-DIVE data dictionary format guidelines as described [here](https://github.com/ess-dive-workspace/essdive-file-level-metadata/blob/master/CSV_dd/CSV_dd_instructions.md).
30
32
31
33
Inclusion of additional related datasets with soil respiration data is encouraged. This can include measurements made inline, such as soil moisture or temperature, or subsequent analysis of chemical composition or physical properties. Related data should be linked by using common sample identifiers.
32
34
33
-
We will continue to work with the ESS community to improve data and metadata reporting formats for soil respiration data. Please [contribute](contribute.md) by submitting issues, using our issue templates, or contact ess-dive-support@lbl.gov to provide any feedback on the process of formatting data or specific metadata fields.
35
+
We will continue to work with the ESS researchers to improve data and metadata reporting formats for soil respiration data. Please [contribute](contribute.md) by submitting issues, using our issue templates, or contact ess-dive-support@lbl.gov to provide any feedback on the process of formatting data or specific metadata fields.
Copy file name to clipboardExpand all lines: templates/README.md
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@
3
3
Feel free to download and populate either version of the template as they both contain the same information. The `.xlsx` version simply highlights the required variables in blue and orange (as shown in the photos below), making them a bit easier to identify. **Please save your template as a CSV.**
0 commit comments