SoilBGC-Datashare / sidb

Soil Incubation Database sidb
https://soilbgc-datashare.github.io/sidb/
MIT License
17 stars 11 forks source link
database open-data science scientific soil

DOI Build Status

Soil Incubation Database (SIDb)

Introduction

This repository contains all the SIDb data files and source code. The database contains information on laboratory soil incubation experiments, with emphasis on time series of CO2 release.

Scroll down to learn how to work with SIDb data, contribute new data, properly cite the database, and get to know the inner workings of SIDb...

Structure

Data

This folder contains all the data currently in SIDb. For each incubation study there is a yaml file with metada and a time series data file in .csv format. A list of the studies currently in SIDb (studies_list.csv), as well as a guide for entering new data (Readme.md), an annotated blank template file (template_metadata.yaml), and a blank initConditions.csv file are also located in this folder.

The data are stored in software agnostic formats (.yaml, .csv) to facilitate data access via your preferred workflow. A pre-compiled version of the database (v1) can be obtained by installing the R package. See the next section (Rpkg) for more information.

Rpkg

This folder contains an R package for loading entries from the database as well as tools for data manipulation, querying the database, and generating reports. To install, open R and run:

install.packages("devtools")
devtools::install_github('SoilBGC-Datashare/sidb/Rpkg', build_vignettes = TRUE)

Scripts

This folder contains R code and other scripts useful for visualizing and analyzing the data.

docs

Files for generating the SIDb website.

Out

This folder contains specific reports of the database generated from scripts in the Scripts folder

Demo

This folder contains R markdown files with reproducible code to demonstrate specific data analyses. (Currently out of date). For current examples and tutorials showing how to load SIDb data in R and work with it see: vignettes.

Tests

This folder contains tests to guarantee the integrity of the database. Make sure that you can run all tests without errors before contributing to the database.

Contribute

This database is public and everybody is welcome to use it for scientific research. Users are also encouraged to contribute their own data and scripts to the dataset. To contribute please send a pull request. Pull requests will only be accepted if submitted code/data pass our code and data validation tests. Information on how to run these tests yourself can be found here: QA/QC Readme.

How to cite

Schädel, C., Beem-Miller, J., Aziz Rad, M., Crow, S. E., Hicks Pries, C. E., Ernakovich, J., Hoyt, A. M., Plante, A., Stoner, S., Treat, C. C., and Sierra, C. A.: Decomposability of soil organic matter over time: the Soil Incubation Database (SIDb, version 1.0) and guidance for incubation procedures, Earth Syst. Sci. Data, 12, 1511–1524, https://doi.org/10.5194/essd-12-1511-2020, 2020.