Dustinhax/tyt

---
license: odc-by
language:
- en
tags:
- politics
- campaign-finance
- elections
- ideology
- united-states
- political-science
- congress
- voting-records
pretty_name: TYT Political Data (Parquet)
size_categories:
- 100M<n<1B
---

# TYT Political Data (Parquet Format)

A comprehensive collection of U.S. political data in Parquet format, combining campaign finance, congressional voting records, and legislator information.

## Datasets

### DIME - Campaign Finance (1979-2024)

The [Database on Ideology, Money in Politics, and Elections](https://data.stanford.edu/dime) compiled by Adam Bonica at Stanford University.

| Directory | Description | Records |
|-----------|-------------|---------|
| `dime/contributions/by_year/` | Itemized political contributions | 850M+ |
| `dime/recipients/` | Candidate and committee CFscores | 156K+ |
| `dime/contributors/` | Individual donor and PAC CFscores | 36M+ |

### Voteview - Congressional Voting (1789-Present)

[Voteview](https://voteview.com/) roll-call voting data from Lewis, Poole, Rosenthal et al.

| File | Description | Records |
|------|-------------|---------|
| `voteview/HSall_members.parquet` | Congressional members with NOMINATE scores | 51K |
| `voteview/HSall_rollcalls.parquet` | Roll call vote metadata | 113K |
| `voteview/HSall_votes.parquet` | Individual vote records | 26M |

### United States Congress Legislators

Legislator data from [@unitedstates/congress-legislators](https://github.com/unitedstates/congress-legislators).

| File | Description | Records |
|------|-------------|---------|
| `unitedstates_congress_github/legislators-current.parquet` | Currently serving legislators | 540 |
| `unitedstates_congress_github/legislators-historical.parquet` | All historical legislators | 12,222 |

## Usage

```python
import polars as pl

# Load DIME contributions
contributions = pl.read_parquet("hf://datasets/Dustinhax/tyt/dime/contributions/by_year/*.parquet")

# Load Voteview voting records
votes = pl.read_parquet("hf://datasets/Dustinhax/tyt/voteview/HSall_votes.parquet")

# Load current legislators
legislators = pl.read_parquet("hf://datasets/Dustinhax/tyt/unitedstates_congress_github/legislators-current.parquet")

# Join legislators with Voteview using ICPSR ID
members = pl.read_parquet("hf://datasets/Dustinhax/tyt/voteview/HSall_members.parquet")
joined = legislators.join(members, left_on="icpsr_id", right_on="icpsr", how="inner")
```

## Cross-Reference Keys

| Dataset | Key Column | Links To |
|---------|------------|----------|
| Voteview Members | `icpsr` | Voteview Votes (`icpsr`), Legislators (`icpsr_id`) |
| Voteview Members | `bioguide_id` | Legislators (`bioguide_id`) |
| Legislators | `icpsr_id` | Voteview data |
| Legislators | `bioguide_id` | Voteview Members, Congress.gov |
| DIME Recipients | `recipient.icpsr` | Voteview Members |

## Licenses & Citations

### DIME
- **License:** Academic use, non-commercial research
- **Citation:** Bonica, Adam. 2024. Database on Ideology, Money in Politics, and Elections: Public version 4.0. Stanford, CA: Stanford University Libraries. https://data.stanford.edu/dime

### Voteview
- **License:** CC BY-NC 4.0 (attribution required, non-commercial)
- **Citation:** Lewis, Jeffrey B., Keith Poole, Howard Rosenthal, Adam Boche, Aaron Rudkin, and Luke Sonnet. 2024. Voteview: Congressional Roll-Call Votes Database. https://voteview.com/

### United States Congress Legislators
- **License:** Public Domain
- **Source:** https://github.com/unitedstates/congress-legislators

## Related Resources

- [DIME Homepage](https://data.stanford.edu/dime)
- [Voteview](https://voteview.com/)
- [unitedstates/congress-legislators](https://github.com/unitedstates/congress-legislators)