README.md

Notebooks

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:

• DrizzlePac
  • Initialization
  • Aligning HST images to an absolute reference catalog
  • Aligning HST Mosaics
  • Optimizing Image Alignment for Multiple HST Visits
  • Aligning Deep Exposures of Sparse Fields
  • Drizzling WFPC2 Images to use a Single Zeropoint
  • Satellite Trail Masking Techniques
  • Optimizing the Image Sampling
  • Sky Matching
  • Using DS9 Regions to Include and Exclude Sources in HST Image Alignment with TWEAKREG
• MAST
  • Hubble Source Catalog
    • MAST Table Access Protocol Hubble Source Catalog Demo
  • Kepler
    • See notebooks/MAST/Kepler/README.md
  • PanSTARRS
    • PanSTARRS1 DR2 TAP Demo
  • TESS
    • Beginner: Read and Plot A TESS Data Validation Timeseries File
    • Beginner: Read and Display a TESS Full Frame Image
    • Beginner: Read and Plot A TESS Light Curve File
    • Beginner: Read and Display A TESS Target Pixel File
    • Beginner: Search The TESS Input Catalog Centered On HD 209458
    • Beginner: A Tour of the Contents of the TESS 2-minute Cadence Data
    • Beginner: Cutout of the TESS FFIs using Astrocut and Astroquery
    • Intermediate: Search and Download GI Program Light Curves
    • Intermediate: Create TESS FFI Cutout using Python Requests

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.