diff --git a/.github/build-environment.yml b/.github/build-environment.yml
new file mode 100644
index 0000000..4cb577c
--- /dev/null
+++ b/.github/build-environment.yml
@@ -0,0 +1,10 @@
+name: build-env
+channels:
+ - conda-forge
+dependencies:
+ - python
+ - pip
+ - jupyter_server
+ - jupyterlite-core >=0.7
+ - jupyterlite-xeus >=4.3
+ - notebook >=7.5
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
new file mode 100644
index 0000000..20bcf92
--- /dev/null
+++ b/.github/workflows/deploy.yml
@@ -0,0 +1,56 @@
+name: Build and Deploy
+
+on:
+ push:
+ branches:
+ - main
+ pull_request:
+ branches:
+ - '*'
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Setup Python
+ uses: actions/setup-python@v5
+ with:
+ python-version: '3.12'
+
+ - name: Install mamba
+ uses: mamba-org/setup-micromamba@v1
+ with:
+ micromamba-version: '1.5.8-0'
+ environment-file: .github/build-environment.yml
+ cache-environment: true
+
+ - name: Build the JupyterLite site
+ shell: bash -l {0}
+ run: |
+ cp README.md content
+ jupyter lite build --contents content --output-dir dist
+
+ - name: Upload artifact
+ uses: actions/upload-pages-artifact@v3
+ with:
+ path: ./dist
+
+ deploy:
+ needs: build
+ if: github.ref == 'refs/heads/main'
+ permissions:
+ pages: write
+ id-token: write
+
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+
+ runs-on: ubuntu-latest
+ steps:
+ - name: Deploy to GitHub Pages
+ id: deployment
+ uses: actions/deploy-pages@v4
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..d693e0c
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,119 @@
+*.bundle.*
+lib/
+node_modules/
+.yarn-packages/
+*.egg-info/
+.ipynb_checkpoints
+*.tsbuildinfo
+
+# Created by https://www.gitignore.io/api/python
+# Edit at https://www.gitignore.io/?templates=python
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+# Usually these files are written by a python script from a template
+# before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# OS X stuff
+*.DS_Store
+
+# End of https://www.gitignore.io/api/python
+
+# jupyterlite
+*.doit.db
+_output
+
+# virtual environment
+.venv/
diff --git a/.nojekyll b/.nojekyll
new file mode 100644
index 0000000..e69de29
diff --git a/MatplotlibExample.ipynb b/MatplotlibExample.ipynb
index 63f42af..ec07cf4 100644
--- a/MatplotlibExample.ipynb
+++ b/MatplotlibExample.ipynb
@@ -205,7 +205,7 @@
"outputs": [],
"source": [
"dat = np.genfromtxt('data/MOD_LSTD_E_2021-08-29_gs_720x360.CSV', delimiter=',')\n",
- "dat = np.where(dat<1000, dat, np.NaN)\n",
+ "dat = np.where(dat<1000, dat, np.nan)\n",
"dat = dat[::-1, :]\n",
"lon = np.arange(-180.0, 180.1, 0.5)\n",
"lat = np.arange(-90.0, 90.1, 0.5)\n",
diff --git a/MatplotlibExample.md b/MatplotlibExample.md
index ed86f13..6164293 100644
--- a/MatplotlibExample.md
+++ b/MatplotlibExample.md
@@ -108,7 +108,7 @@ Matplotlib can also plot two-dimensional data as in this example of land surface
```python
dat = np.genfromtxt('data/MOD_LSTD_E_2021-08-29_gs_720x360.CSV', delimiter=',')
-dat = np.where(dat<1000, dat, np.NaN)
+dat = np.where(dat<1000, dat, np.nan)
dat = dat[::-1, :]
lon = np.arange(-180.0, 180.1, 0.5)
lat = np.arange(-90.0, 90.1, 0.5)
diff --git a/README.md b/README.md
index d56a9b3..f14c13e 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,19 @@
# mpl-brochure-binder
-See binder at https://mybinder.org/v2/gh/matplotlib/mpl-brochure-binder/main?labpath=MatplotlibExample.ipynb
+Interactive Matplotlib visualization examples.
-Note that we use jupytext to synchronize with a markdown file; if we edit the markdown file, be sure to run jupyterlab with jupytext enabled to get the actual notebook synchronized before committing. (Note not 100% sure this works across different installs, but lets try it and see).
+## JupyterLite
+
+Try it in your browser (no installation required):
+
+[](https://matplotlib.github.io/mpl-brochure-binder/lab/index.html?path=MatplotlibExample.ipynb)
+
+## Binder
+
+Launch with Binder:
+
+[](https://mybinder.org/v2/gh/matplotlib/mpl-brochure-binder/main?labpath=MatplotlibExample.ipynb)
+
+## Development
+
+We use jupytext to synchronize notebooks with markdown files. If editing the markdown file, be sure to run JupyterLab with jupytext enabled to synchronize the notebook before committing.
diff --git a/_PreProcess.ipynb b/_PreProcess.ipynb
index 38d6311..fd41bd9 100644
--- a/_PreProcess.ipynb
+++ b/_PreProcess.ipynb
@@ -119,10 +119,10 @@
" datetime += [np.datetime64(st)] \n",
"datetime = np.asarray(datetime)\n",
"temp = data[:, 9]\n",
- "temperature = np.where(temp>-1000, temp, np.NaN)\n",
+ "temperature = np.where(temp>-1000, temp, np.nan)\n",
"\n",
"solar = data[:, 13]\n",
- "solar = np.where(solar>-1000, solar, np.NaN)\n",
+ "solar = np.where(solar>-1000, solar, np.nan)\n",
"\n",
"\n",
"fig, (ax0, ax1) = plt.subplots(2, 1, sharex=True, constrained_layout=True)\n",
@@ -249,7 +249,7 @@
"outputs": [],
"source": [
"dat = np.genfromtxt('data/MOD_LSTD_E_2021-08-29_gs_720x360.CSV', delimiter=',')\n",
- "dat = np.where(dat<1000, dat, np.NaN)\n",
+ "dat = np.where(dat<1000, dat, np.nan)\n",
"dat = dat[::-1, :]\n",
"lon = np.arange(0, 360, 0.5)\n",
"lat = np.arange(-90, 90, 0.5)\n"
diff --git a/_PreProcess.md b/_PreProcess.md
index d19bc76..1a0b0c0 100644
--- a/_PreProcess.md
+++ b/_PreProcess.md
@@ -82,10 +82,10 @@ for d, t in zip(date, time):
datetime += [np.datetime64(st)]
datetime = np.asarray(datetime)
temp = data[:, 9]
-temperature = np.where(temp>-1000, temp, np.NaN)
+temperature = np.where(temp>-1000, temp, np.nan)
solar = data[:, 13]
-solar = np.where(solar>-1000, solar, np.NaN)
+solar = np.where(solar>-1000, solar, np.nan)
fig, (ax0, ax1) = plt.subplots(2, 1, sharex=True, constrained_layout=True)
@@ -135,7 +135,7 @@ a = 10
```python
dat = np.genfromtxt('data/MOD_LSTD_E_2021-08-29_gs_720x360.CSV', delimiter=',')
-dat = np.where(dat<1000, dat, np.NaN)
+dat = np.where(dat<1000, dat, np.nan)
dat = dat[::-1, :]
lon = np.arange(0, 360, 0.5)
lat = np.arange(-90, 90, 0.5)
diff --git a/content/MatplotlibExample.ipynb b/content/MatplotlibExample.ipynb
new file mode 100644
index 0000000..ec07cf4
--- /dev/null
+++ b/content/MatplotlibExample.ipynb
@@ -0,0 +1,297 @@
+{
+ "cells": [
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "# Matplotlib interactive examples\n",
+ "\n",
+ "This is a small example of using Matplotlib for interactive data visualization. \n",
+ "\n",
+ "To get interactive visualization you must \"run\" the notebook cells (in order). You can hit the \"play\" triangle above, or the \"play-all\" double triangle to run all the cells, or select a cell and hit \"Shift-Enter\". Once active, you can zoom and pan in the provided data using the GUI toolbar at left of each figure."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 1,
+ "metadata": {},
+ "outputs": [],
+ "source": [
+ "import numpy as np\n",
+ "import matplotlib.pyplot as plt\n",
+ "\n",
+ "# this sets up the Matplotlib interactive windows:\n",
+ "%matplotlib widget\n",
+ "\n",
+ "# this changes the default date converter for better interactive plotting of dates:\n",
+ "plt.rcParams['date.converter'] = 'concise'"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "## Time series example: temperature at Dinosaur, Co\n",
+ "\n",
+ "Data is from https://www.ncei.noaa.gov/pub/data/uscrn/products/hourly02/ and is hourly temperature and solar radiation at Dinosaur, Colorado.\n",
+ "\n",
+ "### Load the data"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 2,
+ "metadata": {},
+ "outputs": [],
+ "source": [
+ "# Note the use of datetimes in the file complicate loading a bit.\n",
+ "# We recommend using pandas or xarray for more elegant solutions\n",
+ "# to handling complex timeseries data. \n",
+ "with open('data/small.txt', 'r') as f:\n",
+ " data = np.genfromtxt(f, dtype='datetime64[s],f,f,f', \n",
+ " names=['date', 'doy', 'temp', 'solar'])\n",
+ "datetime = data['date']\n",
+ "dayofyear = data['doy']\n",
+ "temperature = data['temp']\n",
+ "solar = data['solar']\n",
+ "\n",
+ "# make two-day smoothed versions:\n",
+ "temp_low = np.convolve(temperature, np.ones(48)/48, mode='same')\n",
+ "solar_low = np.convolve(solar, np.ones(48)/48, mode='same')"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "### Plot timeseries\n",
+ "\n",
+ "Here we plot the time series, add labels, title, and a small annotation about where the data came from. Using the toolbar on the left you can zoom in on the data to see, for instance, the day/night warming and cooling. You can also pan along the time series using the icon with four arrows. Note that because we have said `sharex=True` when creating the axes, the time window remains connected in both time seroes."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 3,
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "application/vnd.jupyter.widget-view+json": {
+ "model_id": "2986d273194e4c66b6bcec4c2c21110f",
+ "version_major": 2,
+ "version_minor": 0
+ },
+ "text/html": [
+ "\n",
+ " \n",
+ "
\n",
+ " Figure\n",
+ "
\n",
+ "
\n",
+ "
\n",
+ "
\n",
+ " Figure\n",
+ "
\n",
+ "
\n",
+ "
\n",
+ "
\n",
+ " Figure\n",
+ "
\n",
+ "
\n",
+ "
\n",
+ "
\n",
+ " Figure\n",
+ "
\n",
+ "
\n",
+ "
\n",
+ "
\n",
+ " Figure\n",
+ "
\n",
+ "
\n",
+ "
\n",
+ "
\n",
+ " Figure\n",
+ "
\n",
+ "
\n",
+ "