How rougier/numpy-100 works
This repository is a collection of 100 NumPy exercises, distributed as Markdown and Jupyter notebooks for learners and teachers. The main workflow is to author exercise and header content in keyed-text files, generate learning materials, then read or run them. Notebook setup exposes question, hint, answer, and random-pick helpers. The README also documents Binder access. The source tree and README differ on the exercise-data filename; this map uses the exact path present in the tree. Binder wiring is documented, not implemented here.
Main entry points: generators.py Material generator · initialise.py Notebook helpers · 100_Numpy_exercises.ipynb Exercise notebook · 100_Numpy_random.ipynb Random exercise notebook
Components 13
Exercise content
- Exercise data
source/exercises100.ktx - Document headers
source/headers.ktx
Material generation
- Material generator
generators.py
Learning materials
- Exercise notebook
100_Numpy_exercises.ipynb - Random exercise notebook
100_Numpy_random.ipynb - Markdown exercises
100_Numpy_exercises.md - Markdown with hints
100_Numpy_exercises_with_hints.md - Markdown with solutions
100_Numpy_exercises_with_solutions.md - Markdown with hints and solutions
100_Numpy_exercises_with_hints_with_solutions.md - Notebook helpers
initialise.py
Other components
- Learner or teacher
- NumPy random
- Binder
Connections 18
- Material generator → Exercise data: reads exercises
- Material generator → Document headers: reads headers
- Material generator → Exercise notebook: generates
- Material generator → Random exercise notebook: generates
- Material generator → Markdown exercises: generates
- Material generator → Markdown with hints: generates
- Material generator → Markdown with solutions: generates
- Material generator → Markdown with hints and solutions: generates
- Exercise notebook → Notebook helpers: runs setup
- Random exercise notebook → Notebook helpers: runs setup
- Notebook helpers → Material generator: reads exercise data
- Notebook helpers → NumPy random: selects random index
- Learner or teacher → Markdown exercises: reads
- Learner or teacher → Markdown with hints: reads
- Learner or teacher → Markdown with solutions: reads
- Learner or teacher → Markdown with hints and solutions: reads
- Learner or teacher → Exercise notebook: opens and runs
- Binder → Random exercise notebook: hosts notebook