# `Dux.Datasets`
[🔗](https://github.com/elixir-dux/dux/blob/v0.3.0/lib/dux/datasets.ex#L1)

Embedded datasets for learning and testing.

All datasets are CC0 (public domain) unless noted.

## Available datasets

| Dataset | Rows | Description |
|---------|------|-------------|
| `penguins/0` | 344 | Palmer penguins — species, measurements, island |
| `gapminder/0` | 1,704 | Country-level life expectancy, population, GDP |
| `flights/0` | 6,099 | NYC flights (Jan 1-7 2013) — the fact table |
| `airlines/0` | 16 | Carrier code → name lookup |
| `airports/0` | 1,458 | Airport code → name, lat/lon |
| `planes/0` | 3,322 | Tail number → manufacturer, model, seats |

## Examples

    require Dux

    Dux.Datasets.penguins()
    |> Dux.filter(species == "Gentoo")
    |> Dux.group_by(:island)
    |> Dux.summarise(avg_mass: avg(body_mass_g))
    |> Dux.to_rows()

    # Star schema join
    Dux.Datasets.flights()
    |> Dux.join(Dux.Datasets.airlines(), on: :carrier)
    |> Dux.group_by(:name)
    |> Dux.summarise_with(n: "COUNT(*)")
    |> Dux.sort_by(desc: :n)
    |> Dux.to_rows()

# `airlines`

Airline carrier codes and names (16 rows). CC0.

# `airports`

US airport codes, names, and coordinates (1,458 rows). CC0.

# `flights`

NYC flights, Jan 1-7 2013 (6,099 rows). CC0.

# `gapminder`

Gapminder excerpt — country, continent, year, lifeExp, pop, gdpPercap (1,704 rows). CC0.

# `karate_club`

Zachary's Karate Club graph (34 nodes, 78 undirected edges). CC BY 4.0.

Returns a `Dux.Graph` with bidirectional edges (156 directed edges).
The classic social network dataset from a 1977 study of friendships
in a university karate club.

# `penguins`

Palmer penguins dataset (344 rows). CC0.

# `planes`

Aircraft tail numbers, manufacturers, models (3,322 rows). CC0.

---

*Consult [api-reference.md](api-reference.md) for complete listing*