Skip to main content

truewise-data

Clean, ready-to-use data on the economic value of US college programs, median earnings versus a typical high-school graduate, derived from the U.S. Department of Education's College Scorecard. No API key, no 178-column bulk files, no decoding suppression flags: one clean table, offline.

pip install truewise-data
import truewise_data as tw

df = tw.load_value_check()  # one row per school x field of study x credential
df = tw.load_value_check(decided_only=True)  # drop insufficient-data rows

# Which programs leave graduates earning less than a typical HS grad?
fails = df[df.value_flag == "fails_earnings_premium"]
fails.groupby("cip_desc").size().sort_values(ascending=False).head(10)

tw.load_summary()  # national + state summary stats
tw.meta()  # dataset version, source release, license

What's in it

One row per institution × 4-digit CIP code × credential level. Key columns:

column meaning
earnings median earnings 4 years after completion (USD)
earnings_threshold_state / _national typical high-school-graduate earnings benchmark
earnings_premium_state / _national earnings minus the threshold (negative = below)
value_flag passes_earnings_premium / fails_earnings_premium / insufficient_data
debt_median, debt_to_earnings_ratio median debt at graduation; debt ÷ annual earnings

Suppressed small-cohort values are NULL, never imputed. Earnings mirror what ED publishes on the consumer College Scorecard site (4-year measure). Full methodology and an accuracy audit: https://github.com/ndranandraj/truewise.

License

Code MIT. Data is CC-BY-4.0, free to use with attribution to Truewise (https://truewise.dev). Underlying figures are US federal public-domain works.

Citation

If you use this dataset, please cite it (a DOI is minted per release via Zenodo, see the repository releases page).

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

truewise_data-0.1.0.tar.gz (2.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

truewise_data-0.1.0-py3-none-any.whl (1.9 MB view details)

Uploaded Python 3

File details

Details for the file truewise_data-0.1.0.tar.gz.

File metadata

  • Download URL: truewise_data-0.1.0.tar.gz
  • Upload date:
  • Size: 2.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.2

File hashes

Hashes for truewise_data-0.1.0.tar.gz
Algorithm Hash digest
SHA256 3fa7a68330f9803696574721dcb1b86b094d29965396be88b6f6278f1647d165
MD5 d6c2f6ed8b66cd192d647133a2005f87
BLAKE2b-256 dfcdb1c94c3fa9b950ba6ba4464dbc8b000eb298acbd06480bf6cf0c3465ff80

See more details on using hashes here.

File details

Details for the file truewise_data-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: truewise_data-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 1.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.2

File hashes

Hashes for truewise_data-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d921d314b28a5e5508a71ecfc3de88543e1ba858dc698458b86c050e171f7a5d
MD5 2cabcd0363672dd45443a4ec6828bbc9
BLAKE2b-256 4612171f4d3dc474062519e571a20e91106ae7c1e20397e5284d8157081aae77

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page