Instructor guide#
While this is meant as internal documentation for the instructor, others are welcome to read it.
Adding/updating packages#
Modify
environment.yml
Run
./extras/scripts/update_packages.sh
Manually update the notebooks with interactivity
Slides#
While the lecture notes can be viewed as a plain notebook, they are also visible as slides.
make slides lec=N
Site#
The site is generated using JupyterBook and deployed to ReadTheDocs. Markdown (.md
) files and the files and folders that start with an underscore (_
) are related to JupyterBook.
The HTML can be downloaded as an artifact from the latest Publish
Action.
Building locally#
Stage changes in Git, as they will be overwritten.
If on the
columbia
branch, run:./extras/scripts/school.sh <school> ./extras/scripts/build.sh
If on
main
or other branches, run:./extras/scripts/school_ci.sh <school>
Checking broken links#
Once the site is built, you can check broken links with:
make linkcheck
Notebook cleanup#
To ensure that notebooks have the correct execution order and output, run them non-interactively.
./extras/scripts/update.sh <file>.ipynb
Start of class checklist#
Put out attendance sheet
Connect to HDMI
On laptop, turn on:
Set phone to Do Not Disturb
Run lecture notebook
Set up Zoom recording
Data sets#
Canonical copies of data are in a Google Drive folder, synced locally with Google Drive for desktop. Data is then compressed and uploaded to a Google Cloud Storage bucket via Terraform. Descriptions of the data sets.
gcloud auth application-default login
Student enrollment activity#
This only shows students coming off the wait list.
Visit SSOL
View the Wait List Activity
Open the Console
Paste the script
Do the same for the other section(s)
Updating the curve#
Open CourseWorks
Go to Grades
Export -> Export Entire Gradebook
In the curve notebook, update the CSV filename
Re-run the notebook
Spot-check the new cutoffs
Update the course grading scheme
Contacts#
-
Primary contact: Jenny Labuga-Rumenik
Job posts: sipajobs@sipa.columbia.edu