Psych Stats with Python — Book 1 Launcher

The current Book 1 route is PyStatsV1 v0.25.2 with Companion v0.2.1, a synthetic-only, inspectable local companion for Psych Stats with Python. Companion v0.2.1 corrects the Chapter 8 synthetic participant identifiers so all 48 rows have globally unique IDs. The analytical columns, row order, reported statistics, APA sentence, Python/R parity, and Chapter 8 figure remain unchanged.

The launcher creates a new directory from a versioned package asset. It does not overwrite existing work, upload data, run an analysis automatically, or make a real-data claim.

Quick start

python -m pip install "pystatsv1[book1]==0.25.2"
pystatsv1 book1 init
cd psych_stats_with_python_companion_v0_2_1
python -m pip install -r requirements-book1-companion.txt
make figures
make all
pystatsv1 book1 verify --dest .

make all requires Rscript because the full Book 1 workflow compares named Python and base-R reportable fields. make figures builds six source-faithful high-contrast grayscale synthetic-data teaching plots with Matplotlib and writes an evidence manifest.

Historical proof boundary

The prior proof route remains preserved as PyStatsV1 v0.25.0 with Companion v0.2:

python -m pip install "pystatsv1[book1]==0.25.0"
pystatsv1 book1 init
cd psych_stats_with_python_companion_v0_2

The historical v0.2 source snapshot, package asset, portal-handoff receipt, and 0.25.0 requirement are retained as immutable lineage evidence. New installs should use the corrected v0.25.2/v0.2.1 route.

Commands

pystatsv1 book1 info: Displays the packaged companion version and source-file count.
pystatsv1 book1 init --dest PATH: Creates a new local companion folder. The command refuses to overwrite an existing path.
pystatsv1 book1 verify --dest PATH: Checks the extracted source data, scripts, figure specification, maintenance receipt, and reader files against the package manifest. It intentionally ignores generated outputs/ because students create those by running the companion.

Maintenance evidence

Companion v0.2.1 includes BOOK1_MAINTENANCE_RECEIPT.json. The receipt records the old and new Chapter 8 CSV hashes, the deterministic ch08_001 through ch08_048 identifier sequence, the ID-only change contract, unchanged Python/R reported fields, passing parity, the unchanged APA sentence, and the byte-identical Chapter 8 figure.

Figure evidence

Chapter 10 correlation and Chapter 11 regression have separate source-faithful figures. Their manifest records source CSV, analysis script, result path, caption, accessibility text, SHA-256, and a minimum effective print resolution of 300 PPI at the documented Book 1 image slot.

Scope boundary

The companion uses synthetic teaching data only. Its Python scripts use pandas, NumPy, SciPy, and statsmodels for the named calculations; local scripts write evidence files; optional base-R scripts independently check named values; and PyStatsV1 provides the versioned package environment and launcher. None of these tools substitute for study design, authorization, privacy protection, or research judgment.