# Introduction to ecoteach

    library(ecoteach)

## Introduction

The `ecoteach` package provides a collection of curated educational datasets for teaching ecology and agriculture concepts. Each dataset is derived from published scientific research and includes comprehensive documentation to facilitate its use in teaching environments.

## Available Datasets

The package includes the following datasets:

- `badger_energy`: Energy expenditure data for European badgers with tuberculosis
- `barnswallow_brightness`: Plumage brightness data for barn swallows
- `berberis_treatment`: Data on invasive Berberis management treatments
- `carrion_arrivals`: Vertebrate scavenger visits to roe deer carrion
- `chimpanzee_cameras`: Camera trap detection data for wild chimpanzees
- `dormouse_hibernation`: Hibernation and reproduction data for edible dormice
- `Dsimulans_matechoice`: Mate copying data for fruit flies
- `elephant_farmers`: Agricultural use metrics for elephants
- `lion_reproduction`: Reproductive data for Galapagos sea lions
- `magellanic_penguins`: Long-term monitoring data on Magellanic penguins
- `pangolin_habitat`: Habitat occupancy data for Chinese pangolins
- `raccoondog_environment`: Raccoon dog activity and environmental factors in China
- `scavenger_community`: Scavenger community structure along environmental gradients
- `vulture_diet`: Diet composition analysis of African vultures
- `whale_brains`: Brain size evolution data for cetaceans

## Using the Datasets

To use any of the datasets in the package, load them with the `data()` function:

    # Example with dormouse hibernation dataset
    data(dormouse_hibernation)
    head(dormouse_hibernation)
    #>   animal_id year_birth age log_age body_mass_before body_mass_after
    #> 1         1       2002   2  0.3010              261             167
    #> 2         1       2002   4  0.6021              265             227
    #> 3         1       2002   5  0.6990              315             182
    #> 4         1       2002   6  0.7782              318             173
    #> 5         1       2002   7  0.8451              264             189
    #> 6         1       2002   8  0.9031              190             135
    #>   hibernation_duration hibernation_start hibernation_end
    #> 1                  237          20.08.04        14.04.05
    #> 2                  335          23.05.06        23.04.07
    #> 3                  264          26.07.07        15.04.08
    #> 4                  357          07.05.08        29.04.09
    #> 5                  335          27.05.09        27.04.10
    #> 6                  181          21.09.10        21.03.11
    #>   hibernation_end_year_before body_mass_spring year  sex     diet age_death
    #> 1                        <NA>               NA 2004 male   medium        11
    #> 2                    10.05.06              215 2006 male   medium        11
    #> 3                    23.04.07              227 2007 male high fat        11
    #> 4                    15.04.08              182 2008 male   medium        11
    #> 5                    29.04.09              173 2009 male  protein        11
    #> 6                    27.04.10              189 2010 male high fat        11
    #>   repro_active
    #> 1          yes
    #> 2           no
    #> 3          yes
    #> 4           no
    #> 5           no
    #> 6          yes

    # Example with vulture diet dataset
    data(vulture_diet)
    head(vulture_diet)
    #>     d13C  d15N d34S species  tissue
    #> 1  -9.76 12.41 6.31     AWB feather
    #> 2  -8.89 12.00 9.72     AWB feather
    #> 3  -9.09 11.82 8.47     AWB feather
    #> 4 -10.44 12.72 8.18     AWB feather
    #> 5 -10.73 11.84 9.73     AWB feather
    #> 6 -12.58 13.22 9.41     AWB feather

For more detailed information about each dataset, refer to the dataset documentation:

    # E.G.:
    # ?dormouse_hibernation
    # ?vulture_diet
    # ?berberis_treatment
    # etc.