diff --git a/.gitignore b/.gitignore index 0d20b64..69435bb 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,2 @@ *.pyc +.ipynb_checkpoints diff --git a/00.value-of-dataviz/slides.md b/00.value-of-dataviz/slides.md index 2e0fd46..1394bbd 100644 --- a/00.value-of-dataviz/slides.md +++ b/00.value-of-dataviz/slides.md @@ -233,7 +233,7 @@ Final project will have a place where D3 will be helpful, but other options will After introductory lecture, some examples will continue to be in D3, but you will not need to understand their inner workings. + +--- + +## Learning Altair + +To master a library like Altair, you'll go through the following phases: + +1. Learn the key concepts. + - Goal: Understand how the authors of Altair think about visualization. + - Achieved by: Reading user guide & watching tutorials. +2. Internalize concepts & API. + - Goal: Be able to do common tasks without referring to documentation. (You'll always lean on documentation for specifics.) + - Achieved by: Working on assignments & experimentation. Reading API reference as needed. +3. Mastery (not this quarter!) + - Goal: Be able to manipulate library to achieve most tasks. Understand limits. + - Achieved by: Regular use over months/years. Reading API reference and/or source code. + +--- + +## Altair Assignment + + diff --git a/01.gog-altair/vega.png b/01.gog-altair/vega.png new file mode 100644 index 0000000..fb5a9a2 Binary files /dev/null and b/01.gog-altair/vega.png differ diff --git a/README.md b/README.md index 979b67a..918cb64 100644 --- a/README.md +++ b/README.md @@ -14,19 +14,20 @@ Inside each directory, you're likely to find: - `slides.md` - My slides in raw markdown. - `slides.html` - My slides converted to a presentation. (using [`marp`](https://marpit.marp.app)) You can open this in your web browser (Type `open slides.html` from the command line.) -- `*-notebook.py` - These are marimo notebooks (see below). +- `*.ipynb` - These are Jupyter notebooks (see below). -Not every week will have slides & a notebook, but one or the other should generally exist. +Not every week will have both slides & a notebook. Other files, such as images & data will be kept in the appropriate folder. -### Marimo Notebooks +### Jupyter Notebooks -Marimo notebooks are similar to Jupyter notebooks, but work much better with Git and have some other nice features I appreciate. +You have a few options for working with `.ipynb` notebooks: -If you have ever looked at a Jupyter notebook file (.ipynb) in an editor, you know they are large JSON files, and once they are checked into Git changes become very difficult to track. +- `uv run jupyter lab` - the newer UI, will start a server and +- `uv run jupyter notebook` - the older UI, perfectly functional still +- VS Code will open these in it's own editor -To interact with a notebook, run: - -`uv run marimo edit ` +If you run one of the `uv run` options, you'll need to navigate to the .ipynb file in the window that opens in your browser. +**Note:** To stop a server, press `Ctrl-C` and then 'y' to the prompt.