Preserve and document inputs
See this course’s project requirements
An executable notebook and script that regenerate checked attendance totals, with raw data, an exclusion log, a data dictionary and a controlled rerun.
Keep your working files in your own notebook or software. Save a private description, checklist, and work link in My Proof.
What to include
- Question and inclusion rules.
- Preserved input and four-field dictionary.
- Executable analysis with exclusion reasons.
- Checked site/total reconciliation and interpretation.
- Clean-session baseline, correction test and complete handoff.
Review and revise
Use these criteria to check your work and choose what to improve.
- The stated metric matches the code.
- Exclusions and guards are explicit.
- Clean runs reproduce expected totals.
- The package contains enough information to rerun and interpret it.
Want more background?
The idea in everyday life
Rebuild a fictional attendance result from preserved data and executable steps.
Raw data is evidence; transformations and reports should be reproducible from it.
Preserve and document inputs — guided practice
Separate raw input, executable analysis and generated output.
Use free local JupyterLab with a Python 3 kernel, or an equivalent notebook environment that can read uploaded local files. Put analysis.ipynb and attendance.csv in the same new practice folder; no extra Python packages are used by the analysis. The CSV rows are S1 north 8 held; S2 south 6 held; S3 north blank held; S4 south 0 canceled; S5 north 7 held; S6 south 5 held; S7 north 4 held; S8 south 9 held. The supplied analyze.py runs the same calculation with Python from this folder. Use only these fictional records.
1. Inspect the folder
Confirm attendance.csv, analysis.ipynb and analyze.py are together.
You should see: Input and executable files have distinct names.
A known folder layout prevents hidden path dependencies.
2. Create a dictionary
In README.md define session_id, site, attended and status, including blank and canceled meanings.
You should see: Another person can interpret all four columns.
Column names alone rarely capture all assumptions.
3. Read the code paths
Find raw_path and the output directory creation.
You should see: The code reads attendance.csv and writes only under output.
The original input is not overwritten.
4. Record provenance
Write fictional fixture, version 1, supplied with this course, and date of your run.
You should see: The origin and version are explicit.
Reproducibility needs the exact input, not only a filename.
What to finish
A documented folder and four-field data dictionary.
Watch for this
Editing the only raw copy during cleaning without keeping the original evidence.
How can I tell I understand it?
Complete the changed case, explain your result, and pass the three application checks.
Quick knowledge check
Answer all 3 questions. Get at least 2 right and the lesson completes automatically.
You’ll get an explanation for each answer. Signed in? Your results save to your account.
Pass the check. We’ll save the progress.
Answer all 3 questions above and get at least 2 right. You can review the explanations and try again.
Go to the knowledge checkOptional course overview video · same video as Lesson 1
Jupyter Notebook Tutorial: Introduction, Setup, and Walkthrough
From Corey Schafer. Watch here or open it on YouTube .
Optional course overview. Follow the written steps below at your own pace.Tools, templates, and lesson sources
Tools and templates
Tools open in a new tab so you can keep your place here.
Sources and further reading
Explore the references behind this lesson.
Source & access notes · checked 2026-09-12
Opened and inspected on 2026-09-12: Preserving raw data and recording transformations.
Access: Free public web page; no paid enrollment required.
Reuse: The linked curriculum license page identifies instructional material as CC BY 4.0. Link only; LifeStarter data, code and explanations are independently authored.
Source & access notes · checked 2026-09-12
Opened and inspected on 2026-09-12: Directory structure, metadata and project handoff.
Access: Free public web page; no paid enrollment required.
Reuse: The linked curriculum license page identifies instructional material as CC BY 4.0. Link only; LifeStarter data, code and explanations are independently authored.
Report a problem with this lesson
Tell us what went wrong. Please leave out personal information and private project contents.