IOOS CodeLab

The IOOS CodeLab is a collection of tutorials and examples of how to access and utilize the many IOOS technologies and data sources available. This site is geared towards scientists and environmental managers interested in “diving deep” into the numbers and creating original plots and data analysis. Most notebook examples are written in Python, however, we also have a growing number of notebooks written in Matlab, and R.

See the rendered version at https://ioos.github.io/ioos_code_lab

To suggest a notebook or ask questions please open an issue at: https://github.com/ioos/ioos_code_lab/issues

Citation

Build the JupyterBook locally

Resources:

• Jupyter-book command line interface: https://jupyterbook.org/basics/build.html

Requirements:

• Git: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
• Jupyter{Book}: https://jupyterbook.org/intro.html
• Web Browser

Installation

Install jupyter-book:

conda install jupyter-book

Clone the ioos_code_lab repository.

git clone https://github.com/ioos/ioos_code_lab.git

Once you have cloned the repository, you have all the required notebooks cloned onto your system (in the /jupyterbook/content directory).

Build the JupyterBook

Run the following command to build the JupyterBook.

jupyter-book build jupyterbook/

The command should be run relative to the jupyterbook/ directory.

If you are in the jupyterbook/ directory, you can build the book using

juyter-book build .

View the built JupyterBook

Your book's HTML pages are here:

jupyterbook\_build\html\

You can look at your book by opening this file in a browser:

jupyterbook\_build\html\index.html

Or, use the full link displayed in the terminal to view the website.

Clean up the book's generated files

To entirely remove the folders in the _build/ directory:

jupyter-book clean jupyterbook/ --all