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.
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.
columbia
branch#
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:
ruby ./extras/scripts/broken_links.rb
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#
Zoom
Start meeting
From Zoom Classroom,
Join Meeting
If there’s a guest, make them a co-host
On laptop, mute mic and speakers
Turn on the wireless mic
From the control panel
Open
Settings
and ensure the wireless mic is unmutedGo to
Camera Control
and selectB-Board
Confirm audio being received in Zoom
Share screen
Set phone to Do Not Disturb
Run lecture notebook
Put out power strips
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.
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