Defining acronyms

notebooks/roman_cutouts/roman_cutouts.ipynb

@@ -45,9 +45,9 @@
  "source": [
  "The Roman Space Telescope will introduce a new file type that will be used to store astronomical data in a seemless fashion. This file type is called ASDF which is short for [Advanced Scientific Data Format](https://asdf.readthedocs.io/en/latest/).\n",
  "\n",
- "The `astrocut` service allows users to generate cutouts out of large images from survey satellites such as the [Transiting Exoplanet Survey Satellite (TESS)](https://archive.stsci.edu/missions-and-data/tess). Future plans for `astrocut` involve expanding its functionality so that it supports generating cutouts from different missions, including the [Roman Space Telescope](https://archive.stsci.edu/missions-and-data/roman) mission, which will involve supporting the ASDF file type.\n",
+ "The [`astrocut`](https://astrocut.readthedocs.io) service allows users to generate cutouts out of large images from survey satellites such as the [Transiting Exoplanet Survey Satellite (TESS)](https://archive.stsci.edu/missions-and-data/tess). Future plans for `astrocut` involve expanding its functionality to generate cutouts from different missions, including the [Roman Space Telescope](https://archive.stsci.edu/missions-and-data/roman) mission, which will use the ASDF file type.\n",
  "\n",
- "This notebook demonstrates an initial proof-of-concept script created for this expansion of the astrocut functionality, which takes in a single Roman calibrated file and generates a cutout from the input image.\n",
+ "This notebook demonstrates an initial proof-of-concept script. It loads a single Roman calibrated file and generates cutouts from the input image.\n",
  "\n",
  "---"
  ]
@@ -127,7 +127,7 @@
  "id": "1d01819b-7745-47e4-9871-f543dc3f6baa",
  "metadata": {},
  "source": [
- "After launch, Roman data will be available through MAST. For testing purposes, some simulated data has been placed in a separate S3 bucket. We can access this bucket and peruse the available files similarly to a Unix terminal. A full list of commands can be found in the `s3fs` documentation [here.](https://s3fs.readthedocs.io/en/latest/api.html#)"
+ "After launch, Roman data will be available through the [Mikulski Archive for Space Telescopes (MAST)](https://archive.stsci.edu/). For testing purposes, some simulated data has been placed in a separate S3 bucket. We can access this bucket and peruse the available files similarly to a Unix terminal. A full list of commands can be found in the [`s3fs` documentation](https://s3fs.readthedocs.io/en/latest/api.html#)."
  ]
  },
  {
@@ -146,7 +146,7 @@
  "id": "51f2e580-53ab-414c-8c47-39c962fc18e2",
  "metadata": {},
  "source": [
- "Above, we see the data available from the romanism simulations. The directories listed contain test data for Roman level 1 ramps (`_uncal.asdf`) and level 2 images (`_cal.asdf`), for all 18 detectors on 2 exposures. This POC currently only supports cutouts on level 2 images. The relevant filename syntax is: `r[program]xxx_xxxx_[exposure_num]_WFI[detector]_cal.asdf`"
+ "Above, we see the data available from the romanism simulations. The directories listed contain test data for Roman level 1 ramps (`_uncal.asdf`) and level 2 images (`_cal.asdf`), for all 18 detectors on 2 exposures. This proof-of-concept currently only supports cutouts on level 2 images. The relevant filename syntax is: `r[program]xxx_xxxx_[exposure_num]_WFI[detector]_cal.asdf`"
  ]
  },
  {
@@ -177,7 +177,7 @@
  "\n",
  "### GWCS\n",
  "\n",
- "Roman ASDF images use [GWCS](https://gwcs.readthedocs.io/en/latest/index.html) to handle coordinate transformations, as opposed to FITS WCS. GWCS is more flexible than FITS WCS, and contains a pipeline of transformations from detector to world coordinates. It is stored in the image files within the `roman['meta']['wcs']` dictionary. Let's extract the gwcs object and examine the sky and pixel coordinates. "
+ "Roman ASDF images use [Generalized World Coordinate System (GWCS)](https://gwcs.readthedocs.io/en/latest/index.html) to handle coordinate transformations, as opposed to the [World Coordinate System (WCS)](https://fits.gsfc.nasa.gov/fits_wcs.html) used in [Flexible Image Transport System (FITS)](https://fits.gsfc.nasa.gov/fits_primer.html) files. GWCS is more flexible than FITS WCS, and contains a pipeline of transformations from detector to world coordinates. It is stored in the image files within the `roman['meta']['wcs']` dictionary. Let's extract the gwcs object and examine the sky and pixel coordinates."
  ]
  },
  {
@@ -486,7 +486,7 @@
  "metadata": {},
  "source": [
  "## Create Image Cutout in ASDF Format\n",
- "Now, we will create the image cutout as an ASDF file. This time, we will take the cutout from a different section of the original image, and make it a bit longer on each side."
+ "Now, we will create the image cutout as an ASDF file. This time, we will take the cutout from a different section of the original image, and make it 300 pixels on each side."
  ]
  },
  {
@@ -606,16 +606,8 @@
  "\n",
  "# convert to sky coordinates\n",
  "edge_coord = gwcs(edge_x, edge_y, with_units=True)\n",
- "edge_coord"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "id": "15743bb8-9815-4472-8d15-48f51bf70651",
- "metadata": {},
- "outputs": [],
- "source": [
+ "edge_coord\n",
+ "\n",
  "# plot expected cutout on original image\n",
  "pc, ww = get_center_pixel(gwcs, edge_coord.ra, edge_coord.dec)\n",
  "plt.imshow(data.value, vmin=0, vmax=5, origin='lower')\n",