Skip to main content

Bayesian confidence intervals for RateMyProfessors ratings (inspired by 3Blue1Brown)

Project description

rmp-ci

Bayesian confidence intervals for RateMyProfessors ratings.

Inspired by 3Blue1Brown's video on binomial distributions and the beta distribution — why you shouldn't trust online ratings at face value.

The Problem

A professor with 2 ratings averaging 5.0/5 looks better than one with 200 ratings averaging 4.5/5. But the first professor's true quality is far more uncertain. This tool computes a Bayesian confidence interval using the Beta distribution to quantify that uncertainty.

Install

pip install rmp-ci
# or
uv tool install rmp-ci
# or
pipx install rmp-ci

Usage

rmp-ci "Chao Zhang" -s "Georgia Tech"
rmp-ci "Mark Riedl" -s "Georgia Tech"
rmp-ci "Lingming Zhang" -s "UIUC"

# JSON output for piping
rmp-ci "Chao Zhang" -s "Georgia Tech" --json | jq .bayesian

# Custom confidence level
rmp-ci "Chao Zhang" -s "Georgia Tech" -c 0.90

How It Works

  1. Fetches the rating distribution (1-5★) from RMP's GraphQL API
  2. Treats 4-5★ as "positive" and 1-3★ as "negative"
  3. Applies a Beta(1,1) prior (uniform / Laplace)
  4. Computes the posterior Beta(positive+1, negative+1)
  5. Reports the 95% credible interval for P(positive rating)

Zero dependencies — pure Python stdlib.

License

MIT

Project details


Download files

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

Source Distribution

rmp_ci-0.1.0.tar.gz (5.2 kB view details)

Uploaded Source

Built Distribution

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

rmp_ci-0.1.0-py3-none-any.whl (2.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: rmp_ci-0.1.0.tar.gz
  • Upload date:
  • Size: 5.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for rmp_ci-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f35d23b153e0599c2ab51841a2ddec833c136e64da5c4e503fc05c62d51a1dad
MD5 b564ae7f2c34648369a3b8fa882167c9
BLAKE2b-256 dbc95c463292ed6055d0f302a28de5cb3e4ead8665d01cbe2e19ba21e89d3d3d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: rmp_ci-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 2.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for rmp_ci-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 688b54648ecf4b375ccec4f38981424afc69d46f152f3dfc74d2ecb91e137d8c
MD5 abca14003296c8a12b6d62aca95a29a3
BLAKE2b-256 8975f86c033b9ec5a41aca2052329e9a693f05123c043ab44e3413a1b9dae229

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