# agridatasets

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://spdx.org/licenses/GPL-3.0.html)

The `agridatasets` package offers a rich and diverse collection of datasets focused on **agriculture, agronomy, horticulture, animal husbandry, forestry, plant pathology, entomology, soil science, and food production**. It includes comprehensive data on topics such as **crop yields, plant growth and genetics, seed germination, disease and pest infestation, herbicide and insecticide trials, fungicide efficacy, soil suitability and classification, animal weight gain and survival, poultry and livestock production, coffee and wine composition, and market/production statistics**.

The package contains a wide variety of data types, including experimental field trials, uniformity trials, split-plot and split-split-plot designs, Latin square designs, randomized complete block designs, dose-response bioassays, survival data, and observational/market data. These datasets encompass **crop and orchard yields (apple, grape, peach, tomato, strawberry, cotton, wheat, corn, rice, soybean, turnip), plant growth regulators and hormones, herbicide and pesticide efficacy trials, insect and fungal infestation studies, animal growth and reproduction data (cattle, pigs, sheep, poultry, ducks, guinea pigs, fish, bees), soil taxonomy and land-suitability classifications (Munsell color, coffee-growing suitability), and coffee and wine chemical composition data**.

## Installation

You can install the `agridatasets` package from CRAN with the following R function:

```R
install.packages("agridatasets")
```

You can install the `agridatasets` package from its GitHub repository with the following R function:

```R
devtools::install_github("lightbluetitan/agridatasets")
```

## Load the Package

```R
library(agridatasets)
```

## Example Datasets

Below are selected example datasets included in the `agridatasets` package:

- `bamboo_growth`: Bamboo shoot growth measurements across compartments and transects.
- `rice_wheat_production`: Historical rice and wheat area, production, and yield statistics.
- `wheat_splitsplit`: Split-split-plot wheat trial with inoculation, genotype, moisture, and seed-treatment factors.
- `cattle_butterfat`: Butterfat content in cattle by breed and age.
- `soil_munsell_colors`: Munsell soil color notations and their traditional descriptive names.
- `avocado_us_sale`: U.S. avocado sales and pricing data by week and type.

## Example Code

```R
# Load the package
library(agridatasets)

# List all datasets in the package
view_datasets_agridatasets()

# Load dataset
data(wheat_splitsplit)

# Preview the dataset
head(wheat_splitsplit)

# Open in Viewer
View(wheat_splitsplit)
```

## Data Sources and Licensing

The datasets included in `agridatasets` are sourced from several existing R packages (including `gpk`, `AgroR`, `ALUES`, `mcprofile`, `plm`, `aqp`, `live`, `smbdata`, `boot`, `collett`, `agridat`, `biometrics`, `Sleuth3`, `EnTraineR`, `easynem`, `avocado`, `GLMsData`, `spData`, and `IMIFA`) as well as from Zenodo. Dataset names and, where applicable, formats have been adapted for consistency within this package; the underlying data values have not been altered. Each dataset retains the license of its original source (GPL-2, GPL (>= 2), GPL (>= 3), MIT + file LICENSE, Unlimited, or CC0, depending on origin). Full attribution and per-dataset licensing details are documented in `LICENSES_DETAILS.md`.

## License

All datasets in this package are provided under the same licenses as their original sources. The licensing information and any specific attribution required for each dataset can be found in `LICENSES_DETAILS.md`.

This package, `agridatasets`, is licensed under the GPL-3 License.
