Skip to content

agridatasets Documentation

Welcome

The agridatasets package provides a curated collection of agricultural, agronomic, and livestock datasets for data analysis, statistical modeling, and machine learning research. It includes datasets related to crop yield trials, soil Munsell mineral classifications, field uniformity experiments, forestry genetics, plant disease infestations, pesticide efficacy, biological pest controls, and dairy cattle and broiler chicken development tracking.

The package contains datasets related to bamboo growth observations, cow insemination and conception records, seasonal earthworm population data, earthworm density and biomass from cultivated soils, rabbit body weight and hind foot length measurements, and much more from curated R packages on CRAN.

Philosophy

The author's vision is to create specialized dataset packages focused on specific themes and topics. Instead of searching through multiple generic data packages to find relevant datasets, users can go directly to a thematic package where all datasets are carefully curated around a particular subject.

In the case of agridatasets, every dataset is exclusively focused on agricultural, agronomic, and livestock research, making it the go-to resource for researchers, data scientists, statisticians, agronomists, and students working in the fields of agronomy, soil science, plant pathology, entomology, forestry, animal science, and machine learning.

Getting Started

Installation

The easiest way to install agridatasets is directly from PyPI:

pip install agridatasets

From GitHub (Latest Development Version)

To get the latest development version with the newest features and bug fixes:

pip install git+https://github.com/lightbluetitan/agridatasets-py

Quick Start Tutorial

1. Import the Package

import agridatasets as agd

2. List Available Datasets

See all datasets included in the package:

# Get list of all datasets
datasets = agd.list_datasets()
print(datasets)

3. Load a Dataset

Load any dataset as a pandas DataFrame:

# Load earthworm_population
df = agd.load_dataset('earthworm_population')

# Display first rows
print(df.head())

# Check dataset dimensions
print(f"Shape: {df.shape}")

4. Describe a dataset


# Describe a dataset
print(agd.describe("rabbit_body_mass"))

Basic Concepts

Dataset Naming Convention

All dataset names in agridatasets follow a consistent naming pattern:

  • Lowercase with underscores: earthworm_crop_soils
  • Descriptive names that reflect content

Some Datasets available at agridatasets

Every dataset is exclusively focused on agricultural, agronomic, livestock, and related topics for data analysis, statistical modeling, and machine learning:

  • bamboo_growth: Bamboo growth observations across different geographic locations and transects.
  • cows_insemination: Cow insemination and conception records across time intervals.
  • earthworm_population: Seasonal earthworm population data, including density and biomass measurements.
  • earthworm_crop_soils: Earthworm density and biomass data from cultivated soils under different crops.
  • rabbit_body_mass: Rabbit body weight and hind foot length measurements.

Disclaimer: The datasets included in agridatasets are provided strictly for educational, research, and informational purposes. For agronomic advice, crop management, or any agriculture-related decision-making, always consult a qualified agricultural professional or agronomist.

Data Licenses

All datasets are sourced from the R package ecosystem (CRAN) and maintain their original open-source licenses:

  • Most datasets use GPL (>= 2), GPL-2, or GPL-3
  • Some use MIT + file LICENSE
  • The agridatasets package itself is licensed under MIT License