Skip to content

Latest commit

 

History

History
48 lines (30 loc) · 4.2 KB

README.md

File metadata and controls

48 lines (30 loc) · 4.2 KB
Raw

Developed For: ACS Powered By: STScI

acs-notebook

This repository contains downloadable versions of several HST/ACS webpages with basic Python examples. These code examples are simple and only designed for a limited scope. Users are advised to visit the ACS website, Instrument Handbook, and Data Handbook for more information about the the current status of ACS, instrument specifications, and data analysis.

Users who need help transitioning from IRAF/PyRAF to Python should see the stak-notebooks repository.

Getting Help

If you have questions about HST data analysis, calibration software, instrument capabilities, and/or the methods discussed in this notebook, please visit the HST Help Desk. Through the help desk portal, you can explore the HST Knowledge Base and request additional help from experts.

Getting Started

To download the notebooks in this repository, simply open a terminal, go to the directory where you would like the notebooks to be, and type

git clone https://github.com/spacetelescope/acs-notebook.git

which will create a new acs-notebook/ directory containing the contents of this repository.

Warning: Before running these examples, you must install or update to the latest version of AstroConda. Additionally, astroquery is not currently included in the AstroConda distribution and a jupyter extension is required for some notebooks. Users will need to run the following:

conda install astroquery
conda install nodejs
jupyter labextension install @jupyter-widgets/jupyterlab-manager
jupyter labextension install @jupyterlab/plotly-extension

before using the notebooks as many of them use this tool to download datasets for the examples.

Jupyter Notebooks allow code to be packaged with formatted text to create illustrative examples. Users who are unfamiliar with Jupyter Notebooks should also see the short guide for how to use these tools. Users may also prefer to use Jupyter Lab, which is another helpful tool that can be used to view these tutorials, but will need to be installed in addition to AstroConda.

Contents

Complex Workflow Notebooks

  • acs_reduction.py: This notebook walks a user through an example of how to: 1) download data from MAST using astroquery, 2) update calibration information in the FITS primary headers, 3) calibration ACS observations using calacs, 4) align images to a common WCS, and 5) combine images using AstroDrizzle.

Simple Example Notebooks

  • acs_subarrays.ipynb: Instructions for how to use the acs_destripe_plus code to calibrate, de-stripe, and correct ACS subarray observations for charge transfer efficiency (CTE). Also included are instructions for updating the OSCNTAB reference file to subtract the bias level from the prescan columns in user-defined subarray observations.

  • acs_zeropoints.ipynb: A description of the ACS photometric systems, header keywords, and topics related to photometrically calibrating ACS data.

  • pixel_area_maps.ipynb: How to use Python to create pixel area maps (PAMs) to account for the effects of geometric distortion in distorted images. This enables users to perform photometry on distorted images if desired.

Contributing

If you have feedback concerning our documentation or examples presented here on GitHub, please open an issue. For feedback concerning content exclusively from the ACS website, Instrument Handbook, or Data Handbook, or for questions about ACS in general, please contact the ACS Branch at STScI via the Hubble Space Telescope Help Desk portal.