# agridatasets

[![CRAN status](https://www.r-pkg.org/badges/version/agridatasets)](https://CRAN.R-project.org/package=agridatasets)
[![License: GPL (>= 2) | GPL-3](https://img.shields.io/badge/License-GPL%20(%3E%3D%202)%20%7C%20GPL--3-blue.svg)](https://www.gnu.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)
```

## License

All datasets in this package are provided under their respective original licenses, as documented in `LICENSES_DETAILS.md`. Users must comply with the licensing terms specified by each original source.

This package, `agridatasets`, is licensed under the **GPL (>= 2) | GPL-3** license.
