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.

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:

• COS
  • Setting up your computer environment to work with COS data
  • Downloading COS Data from the archive
  • Beginning to work with COS data in Python: plotting, binning, calculating SNR, & evaluating a spectrum
  • Modifying or creating an association file
  • Running the COS pipeline (CalCOS)
  • Filtering out COS data taken during the day or night
  • Breaking COS TIME-TAG data into multiple sub-exposures
  • Working with the COS Line Spread Function (LSF)
  • Editing the extraction boxes in a BOXCAR-method spectral extraction file (XTRACTAB)
• 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

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.

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