For students¶
What you need to know. First-year mathematics (algebra, basic derivatives and integrals), Ohm’s and Kirchhoff’s laws, and a little Python. If you have never used Jupyter, NumPy or Matplotlib, start with the quick start notebook.
Where to run the notebooks.
Binder: nothing to install. Use the Binder badge at the top of each notebook. The first launch can take a few minutes, and your changes are lost when the session ends, so download the notebook if you want to keep it.
Google Colab: use the Colab badge. The first code cell of each notebook installs what Colab is missing.
Your own computer: follow the installation steps in the README.
How to work through a notebook. Answer the Predict question before you run the code: being wrong at that point is the most useful thing that can happen. Then run the cells in order, change the parameters marked for it, and write your answers to the Explain questions in your own words.
For instructors¶
Scope and time. The full module takes about 14–18 hours (seven to nine two-hour sessions). The three blocks are independent, so one block can be used alone as a set of lab sessions or as complementary material.
Adapting it. All content is CC BY 4.0 and all code is BSD-3-Clause: copy, cut, translate and adapt the notebooks to your course, with attribution. Each notebook states its objectives and its estimated time at the top.
Telling us how it went. Reports of classroom use shape the next version. Open an issue with the Teaching suggestion or classroom experience template in the repository.
A teaching guide with suggested schedules and a project rubric will be added to the repository as the blocks are completed.