# olympicAthletes
A tidy R data package covering every athlete-event participation in the
modern Olympic Games, **Athens 1896 through Milano-Cortina 2026** —
about 315,000 rows.
## Installation
Install the released version from CRAN:
``` r
install.packages("olympicAthletes")
```
Or the development version from GitHub:
``` r
# install.packages("remotes")
remotes::install_github("moderndive/olympicAthletes")
```
## Datasets
``` r
library(olympicAthletes)
data(olympic_athletes) # ~315,000 athlete-event rows, 1896-2026
data(medal_table) # verified medal table for every edition, 1896-2026
data(editions) # metadata for every Games, 1896-2026
# Convenience subsets of olympic_athletes (same 16 columns)
data(athletics_athletes) # sport == "Athletics"
data(gymnastics_athletes) # sport == "Gymnastics"
data(basketball_athletes) # sport == "Basketball"
data(volleyball_athletes) # sport == "Volleyball"
data(curling_athletes) # sport == "Curling"
data(olympic_athletes_2024) # Paris 2024 Summer Games only
data(team_sport_athletes) # Basketball + Volleyball + Curling
data(art_competitions_athletes) # the 1912-1948 Art Competitions entrants
data(usa_summer_medals) # medal_table rows: USA at each Summer Games
# Pre-counted summaries for plotting examples
data(paris_2024_top_medals) # top-10 countries x Gold/Silver/Bronze (long format)
data(season_counts) # athlete-event rows per season (2 rows)
?olympic_athletes
```
| Dataset | Rows | Description |
|----|---:|----|
| `olympic_athletes` | 315,094 | One row per (athlete, Games, event). 16 columns. |
| `medal_table` | 1,929 | One row per (Games, NOC) with Gold/Silver/Bronze counts. |
| `editions` | 62 | Year, season, host city, dates, participant counts. Includes cancelled Games. |
| `athletics_athletes` | 43,062 | Subset of `olympic_athletes` where `sport == "Athletics"`. |
| `gymnastics_athletes` | 29,413 | Subset where `sport == "Gymnastics"`. |
| `basketball_athletes` | 5,159 | Subset where `sport == "Basketball"`. |
| `volleyball_athletes` | 4,792 | Subset where `sport == "Volleyball"`. |
| `curling_athletes` | 961 | Subset where `sport == "Curling"`. |
| `olympic_athletes_2024` | 13,660 | Subset where `year == 2024 & season == "Summer"` (Paris 2024). |
| `team_sport_athletes` | 10,912 | Subset where `sport` is Basketball, Volleyball, or Curling. |
| `art_competitions_athletes` | 3,578 | Subset where `sport == "Art Competitions"` (1912–1948). |
| `usa_summer_medals` | 30 | `medal_table` rows for the USA at each Summer Games attended. |
| `paris_2024_top_medals` | 30 | Top-10 countries by total medals at Paris 2024, long format (`country`, `noc`, `medal`, `count`). For barplot examples. |
| `season_counts` | 2 | Athlete-event rows per season (Summer/Winter), pre-counted for `geom_col()` examples. |
`olympic_athletes` extends the original
[rgriff23/Olympic_history](https://github.com/rgriff23/Olympic_history)
dataset. Column names are lowercase snake_case (e.g. `noc`, `medal`)
rather than the upstream TitleCase, and the host-city column has been
split into `city_local_latin` and `city_english`. `city_local_latin`
always uses the Latin alphabet — non-Latin-script cities are romanized
(`"Moskva"`, `"Tokyo"`, `"Beijing"`, `"PyeongChang"`), not rendered in
their native script.
## Provenance
Rows for 1896-2016 come from the rgriff23 dataset (originally scraped
from sports-reference.com). Rows for 2018-2026 were scraped from
[olympedia.org](https://www.olympedia.org/) using the pipeline in the
[olympic-moderndive-data](https://github.com/ismayc/olympic-moderndive-data)
repository. See `data-raw/DATASET.R` for the reproducible build.
## Caveats
- **Medal counts are per-player, not per-team-event.** A team gold
(e.g. Ice Hockey Men) produces one `medal = "Gold"` row per roster
member. Group by `medal` and `noc` and divide team-event medals by
team size to reproduce the IOC medal table — or use the `medal_table`
companion dataset which uses the IOC convention.
- **Bio coverage:** as of the v0.4.0 bio refresh, `age` is ~100%
complete for all five 2018-2026 editions. `height`/`weight` coverage
ranges from _(96%/)93% for 2018 Winter down to _(34%/)29% for Paris
2024 — highest for Winter team sports (Ice Hockey rosters are
near-complete on olympedia) and lowest for the largest, most-recent
Summer Games, where olympedia simply hasn’t published measurements for
many athletes — same pattern as in the original 1896-2016 source.
## License
CC BY 4.0. Please cite this package, the rgriff23 source, and Olympedia.
## Citation
Run `citation("olympicAthletes")` for citations that always reflect your
installed package version. It renders three entries — the package itself
plus its two upstream data sources:
Ismay C (2026). olympicAthletes: Olympic Athlete Event Data, Athens
1896 to Milano-Cortina 2026. R package version 0.5.9,
.
Griffin R (2018). "Olympic history: longitudinal data scraped from
sports-reference.com." .
OlyMADMen (2026). "Olympedia." .
# Package index
## Package overview
Top-level entry point and shared documentation.
- [`olympicAthletes`](https://moderndive.github.io/olympicAthletes/reference/olympicAthletes-package.md)
[`olympicAthletes-package`](https://moderndive.github.io/olympicAthletes/reference/olympicAthletes-package.md)
: olympicAthletes: Olympic Athlete Event Data, Athens 1896 to
Milano-Cortina 2026
## Athlete-event data
The headline long-format dataset — one row per (athlete, Games, event)
across every modern Olympic Games from 1896 to 2026.
- [`olympic_athletes`](https://moderndive.github.io/olympicAthletes/reference/olympic_athletes.md)
: Olympic athlete-event participations, 1896-2026
## Medal tables
Verified per-team-event medal totals for the five new editions
(PyeongChang 2018 through Milano-Cortina 2026).
- [`medal_table`](https://moderndive.github.io/olympicAthletes/reference/medal_table.md)
: Verified medal tables for every Olympic edition, 1896-2026
- [`paris_2024_top_medals`](https://moderndive.github.io/olympicAthletes/reference/paris_2024_top_medals.md)
: Top-10 countries by medals at the Paris 2024 Summer Olympics
## Edition metadata
Host city, dates, participant counts, and discipline counts for each of
the new editions added on top of the rgriff23 source.
- [`editions`](https://moderndive.github.io/olympicAthletes/reference/editions.md)
: Edition-level metadata for every Olympic Games, 1896-2026
## Convenience subsets
Smaller slices of olympic_athletes for teaching examples that focus on a
single sport, a single Games, or recent Games without needing to
filter().
- [`athletics_athletes`](https://moderndive.github.io/olympicAthletes/reference/athletics_athletes.md)
: Olympic athletics (track and field) athlete-event participations,
1896-2026
- [`gymnastics_athletes`](https://moderndive.github.io/olympicAthletes/reference/gymnastics_athletes.md)
: Olympic gymnastics athlete-event participations, 1896-2026
- [`basketball_athletes`](https://moderndive.github.io/olympicAthletes/reference/basketball_athletes.md)
: Olympic basketball athlete-event participations, 1896-2026
- [`volleyball_athletes`](https://moderndive.github.io/olympicAthletes/reference/volleyball_athletes.md)
: Olympic volleyball athlete-event participations, 1896-2026
- [`curling_athletes`](https://moderndive.github.io/olympicAthletes/reference/curling_athletes.md)
: Olympic curling athlete-event participations, 1896-2026
- [`olympic_athletes_2024`](https://moderndive.github.io/olympicAthletes/reference/olympic_athletes_2024.md)
: Olympic athlete-event participations at the Paris 2024 Summer Games
- [`usa_summer_medals`](https://moderndive.github.io/olympicAthletes/reference/usa_summer_medals.md)
: USA Summer Olympics medal-table rows, 1896-2024
- [`art_competitions_athletes`](https://moderndive.github.io/olympicAthletes/reference/art_competitions_athletes.md)
: Olympic Art Competitions entries, 1912-1948
- [`team_sport_athletes`](https://moderndive.github.io/olympicAthletes/reference/team_sport_athletes.md)
: Olympic team-sport athlete-event participations (Basketball,
Volleyball, Curling)
- [`season_counts`](https://moderndive.github.io/olympicAthletes/reference/season_counts.md)
: Athlete-event rows per Olympic season, pre-counted
# Articles
### Articles
- [Getting started with
olympicAthletes](https://moderndive.github.io/olympicAthletes/articles/olympicAthletes.md):
A tour of the core datasets in olympicAthletes — what they contain,
how they fit together, and a few starter analyses.