Documentation
Codebook, version history, cautionary notes, and citation guidance for each release. All documents are PDF.
Codebook
Variable definitions
Defines every variable in the v3.0 dataset, organized by category. Covers electoral structure, party system indicators, disproportionality, ideological measures, and demographics, including the additions for the 2024 municipal and regional elections and the 2025 parliamentary election.
Download PDF →
What's New
Changes from v2.0
Documents the differences between version 2.0 and version 3.0. Adds 818 new rows from the 2024 municipal and regional elections and the 2025 parliamentary election, bringing the total to 6,119 observations. Also documents an ideological-scores correction affecting 2,657 existing rows and one row-level fix in the 2021 Gobernador second-round data.
Download PDF →
Cautionary Notes
Methodological edge cases
Methodological decisions, source-data problems, and edge cases that may affect interpretation or distort user calculations. Carries forward all prior notes and adds issues specific to the 2024 and 2025 election rows. Read before computing aggregates.
Download PDF →
Suggested Citation
How to cite v3.0
Recommended citation format for the dataset and accompanying publication. Includes BibTeX entries and DOI links for both the Harvard Dataverse deposit and the Humanities and Social Sciences Communications article. Use when publishing research.
Download PDF →
Version History
| Version | Released | Observations | Coverage | Note |
|---|---|---|---|---|
| 3.0 | 2026-08-07 | 6,119 | 1989-2025 | 2024 + 2025 elections added |
| 2.0 | 2026-01-16 | 5,301 | 1989-2023 | Metadata-only release |
| 1.0 | 2025-11-05 | 5,301 | 1989-2023 | Initial release |