/notebooks

Curated Notebooks from STScI

Primary LanguageJupyter NotebookBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Notebooks

CircleCI

This repository contains a curated set of Jupyter notebooks related to the work that we do at STScI. These notebooks follow a consistent style guide in terms of layout/structure, coding conventions etc.

These notebooks are also under continuous integration to ensure that astronomers using these notebooks have a high level of confidence that they will work.

Contents

This repository holds the notebooks themselves, but in a harder-to-read unexecuted form. If you want to view the notebooks online, you should view the rendered versions. At present this includes:

Building Locally

Python 3 is required for use of these notebooks.

To quickly create an environment with everything needed to run and convert, please first install Conda or Miniconda to your machine using Conda Installation Instructions.

Once you have Conda installed, complete the following from a command line:

git clone https://github.com/spacetelescope/notebooks
cd notebooks
conda env create -f environment.yml
conda activate notebooks_env
python convert.py

Doing so will clone this repo, create and activate a conda environment with all needed dependencies, and convert the notebooks to html. For all current notebooks, this can take around 30 minutes.

After converting, you can access the converted HTML of the notebooks in each notebook directory. These can be opened in any web browser. You can also open the index.html file in the root of the repo after converting that links to all converted notebooks.

If you would like to view the notebooks in Jupyter, from the command line in the notebooks directory use:

jupyter notebook

Your web browser will open a new page and you can navigate the notebook directories and click the a notebook file (ends in .ipynb) to open.

Contributing

If you want to suggest changes to this content (or new content!), check out the contributing guide.