JDox Updates 12 July - 6 December 2022

JWST User Documentation articles updated between 12 July and 6 December 2022 are provided in this page.

On this page

New JDox articles for the Cycle 2 Call for Proposals


Updated  

Article TitlePublication date
Home Page

 
(updated , , , ,  ) 

Proposing Opportunities

 

 

 

JWST Cycle 2 Guaranteed Time Observations Call for Proposals

  

JWST Cycle 2 GTO Proposal Submission Policies

 

JWST Cycle 2 GTO Proposal Submission Process

 

Observatory

JWST Micrometeoroid Avoidance Zone

 
Updated  to include a video tutorial called "APT and the Micrometeoroid Avoidance Zone"

Instruments: MIRI
MIRI Instrument Features and Caveats

 

Instruments: NIRCam

NIRCam Absolute Flux Calibration and Zeropoints

 

NIRCam Instrument Features and Caveats

 

NIRCam Dragon's Breath

 

NIRCam Dragon's Breath Type II

 

NIRCam Claws and Wisps

 

NIRCam Ginkgo Leaf

 

 

Instruments: NIRISS

NIRISS Instrument Features and Caveats

 

Instruments: NIRSpec

NIRSpec Instrument Features and Caveats

 

Methods and Roadmaps

Moving Target Scattered Light Considerations

 

JWST Time-Series Observations Known Issues

 

Proposing Tools: Astronomers Proposal Tool

APT Micrometeoroid Avoidance

 
Updated  to include a video tutorial called "APT and the Micrometeoroid Avoidance Zone"

Proposing Tools: Exposure Time Calculator

JWST Time Definitions

 

JWST ETC NIRCam Coronagraphic Imaging

 

JWST ETC Target Acquisition Strategy

 

Data

NIRSpec Time Series Observations Pipeline Caveats

 

How to Cite JWST Data Processing Versions and Reference Files

 

JWST Operations Pipeline Build 9.0 Release Notes

 

JWST MIRI LRS Pipeline Caveats

 

JWST Operations Pipeline Build 8.1.2 Release Notes

 

JWST Operations Pipeline Build 8.1.1 Release Notes

 

JWST Imaging Pipeline Caveats

 

Data Artifacts and Features

 

Snowballs and Shower Artifacts

 

JWST Calibration Pipeline Caveats

 

JWST General Calibration Pipeline Caveats

 

JWST Aperture Masking Interferometry Pipeline Caveats

 

JWST Time Series Observations Pipeline Caveats

 

MIRI Time Series Observations Pipeline Caveats

 

NIRCam Time Series Observations Pipeline Caveats

 

NIRISS Time Series Observations Pipeline Caveats

 

 

 

 

 

Jdaviz Tutorials

 





Updated JDox articles for the Cycle 2 Call for Proposals


All articles have been reviewed for Cycle 2.
Only articles with notable updates are listed here.
Articles with minor changes are not listed below but you will see an update timestamp at the bottom of each updated page.

Updated  

ArticleUpdated onUpdate description
Home page

Recent Developments 
Published  

 

Announcement about release of APT v2022.7.2 

Announcement of Cycle 2 software and documentation freeze

 

Announcement about Cycle 2 Call for Proposals and the micrometeoroid avoidance zone (MAZ)

MIRI MRS resumed operations, JWST PUB CRDS server to be decommissioned

 

Update on how to express the heritage of data products in publications

Updated information on MIRI MRS and NIRSpec performance 

 

Added pointer to DOI information in the Publication section

JWST User Video Tutorials

 

Added new information on JWST data analysis tools

Observatory: Hardware
JWST Telescope

 

Updated to reflect in-flight performance

JWST Wavefront Sensing and Control

 

Added updates based on commissioning data

JWST Momentum Management

 

Post launch text updates

Observatory: Observatory Characteristics

JWST Pointing Performance

 

Updated with information for on-orbit performance from commissioning and early operations.

 

Updated with information for on-orbit performance from commissioning and early operations

JWST Position Angles, Ranges, and Offsets

 

Added micrometeoroid avoidance zone (MAZ) awareness warning box for Cy. 2 and forward

 

Updated description of Reference Angle Definitions

JWST Target Observability and Observatory Coordinate System

 

Added a note about the micrometeoroid avoidance zone

JWST Orbit

 

Updated with actual JWST orbit information

Instruments: MIRI

MIRI Imaging

 

Updated filter PCEs to show in-flight measurements

MIRI Point Spread Functions

 

Updated with in-flight measurements

MIRI LRS Recommended Strategies

 

Added information on TSO backgrounds

JWST Mid Infrared Instrument

 

Updated based on in-flight measurements

MIRI Sensitivity

 

Updated based on in-flight measurements

MIRI TSO Recommended Strategies

 

Updated to replace "pre-flight" predictions with in-flight information

MIRI Coronagraphic Recommended Strategies

 

Added Cycle 2 warning about background images

MIRI Imaging Recommended Strategies

 

Updated dither recommendations for Cycle 2

MIRI Cross-Mode Recommended Strategies

 

Updated with recommendations based on in-flight data

MIRI Detector Performance

 

Updated based on in-flight measurements

MIRI Filters and Dispersers

 

Updated based on commissioning data

MIRI Detector Subarrays

 

Updated starting row of 5 subarrays (changed in commissioning)

MIRI Instrument Features and Caveats

 

Updated cruciform figure
Added several issues related to MRS, and minor updates to LRS

MIRI MRS Dedicated Sky Observations

 

Significantly revised guidance based on lessons learned during commissioning and early Cycle 1 observations.

MIRI MRS PSF and Dithering

 

Significant revisions to figures and guidance based on results from MIRI commissioning

MIRI MRS Field and Coordinates

 

Updated figures and values for Cycle 2

MIRI Observing Modes

 

Updated MRS and LRS to in-flight numbers

MIRI Coronagraphic Imaging Dithering

 

Added information about the use of these dither patterns, and a published reference describing ERS results

MIRI Coronagraphic Imaging APT Template

 

Added information for background quadrant and repeat background option; changed Figure 1 to accurately reflect quadrant naming

MIRI Coronagraphic Imaging Target Acquisition

 

Added alerts about Cycle 2 coronagraphic observing restrictions based on commissioning data

MIRI Medium Resolution Spectroscopy

 

Updated Wavelength range and FOV of MRS to inflight numbers

Instruments: NIRCam

NIRCam Filters for Coronagraphy

 

Added information on SW+LW filter combinations

NIRCam Coronagraphic Imaging APT Template

 

Added information about simultaneous SW/LW operations

NIRCam Coronagraphic Imaging

 

Added information on FoV considerations and a note about MASK430R.
Changed contrast curves, added information about SW+LW

NIRCam Coronagraphic Imaging Recommended Strategies

 

Added information on dual SW+LW mode for Cycle 2

NIRCam Imaging APT Template

 

Updated for APT 2022.7.1

NIRCam Small Grid Dithers


 

Added on-sky examples of SGD (fig 2)

 

Added updated dither ASCII tables 

NIRCam Coronagraph Astrometric Confirmation Images

 

Added on-sky example (Figure 2)

NIRCam Coronagraphic Occulting Masks and Lyot Stops

 

Added focal plane images (on-sky)

NIRCam Flat Fields

 

Updated all figures/text with in-flight flat corrections, and added new bad pixel regions on B5

NIRCam Grism Time Series

 

ETC v2.0 updated grism saturation limits Figure 5 
Added subsections "Tilt events," "Detector settling time," and "SW and LW timing synchronization"
Updated Table 3 using ETC v2.0

NIRCam Point Spread Functions

 

Updated all figures and tables with the simulated PSF used in the Cycle 2 ETC
Included FWHM and EE measurements from the Cycle 1 Absolute Flux Calibration Program

NIRCam Bright Source Limits

 

ETC v2 updates to figures and tables

NIRCam Filters

 

Updated throughputs in tables and figures using in-flight data

 

Updated throughputs from in-flight data entered in tables; figures updated to reflect those changes

NIRCam Sensitivity

 

ETC v2 updates to imaging sensitivities (not grism)

NIRCam Imaging Sensitivity

 

ETC v2 update to Figure 1 showing depth vs. exposure time

NIRCam Imaging

 

ETC v2 updates to sensitivity & saturation plots
Field of view plot updated

NIRCam Wide Field Slitless Spectroscopy Dithers

 

Added updated dither tables and figures

NIRCam Standard Subpixel Dithers

 

Added updated dither ASCII tables

NIRCam Time-Series Imaging

 

ETC v2 updates to saturation plots

NIRCam Detector Subarrays

 

Added subarrays for simultaneous SW+LW coronagraphy, available starting in Cycle 2

 

Added subarrays for simultaneous SW+LW coronagraphy, available starting in Cycle 2

NIRCam Pupil and Filter Wheels

 

Updated coronagraph filter availability in Fig. 3

NIRCam Grism Time-Series APT Template

 

Figure 1 was updated to reflect the referenced location of the spectra. FULLP subarray was replaced with FULL.

NIRCam Primary Dithers

 

Added NIRCamDitherPatterns.zip file (replacing previous file) with updates from in-flight data, and corresponding updates to the text.

NIRCam Subpixel Dithers

 

Added NIRCamDitherPatterns.zip file (replacing previous file) with updates from in-flight data, and corresponding updates to the text.

NIRCam Field of View

 

Updated Figure 1 plot based on commissioning data. Alignment between SW and LW in module B has improved.

NIRCam Time-Series Imaging Target Acquisition

 

TA is no longer required to put targets in SUB64P subarray overlap.
Updated Figure 1 to reflect changes to subarrays made during commissioning.
Updated Figure 1 to show FULLP reference position.

NIRCam Detector Performance

 

Updated correlated double sampling (CDS) and effective noise with in-flight results

NIRCam Subarray Primary Dithers

 

Updated for Cycle 2 using results from commissioning

NIRCam Imaging Recommended Strategies

 

Added "Position angle" section
Updated "Mid-size target" offset recommendation
Added "Other scattered light and detector features" section
Updated "Data volume & data excess" section

NIRCam Apertures

 

Added coronagraphic apertures for Cycle 2. Several clarifications in the text. Added tables in Idl coordinates.

NIRCam Persistence

 

Added in-flight persistence plots and info

 

Updated to mention persistence is somewhat worse than expected (details forthcoming)

NIRCam WFSS Field of View

 

Added commissioning update

Instruments: NIRISS

NIRISS GR700XD Grism

 

Updated with new GR700XD throughput and resolving power figures informed by in-flight performance

NIRISS GR150 Grisms


 

Updated grism throughput curves and trace angles measured from in-flight data

 

Added measured dispersion solution from commissioning data

NIRISS AMI Recommended Strategies

 

Updated to add Figure 1 to show the target offset relative to TA location. Other Cycle 2 updates made.

NIRISS Bright Limits

 

Updated to reflect in-flight performance as measured during JWST commissioning

NIRISS Sensitivity

 

Updated to use in-flight sensitivities measured during JWST commissioning

NIRISS Imaging APT Template

 

Updated to support imaging as a prime observing mode

NIRISS APT Templates

 

Updated to support imaging as a prime observing mode

NIRISS Filters

 

Updated to reflect in-flight performance. Added a table with filter zeropoints.

NIRISS Imaging

 

Updated to support NIRISS Imaging as a prime mode in Cycle 2 and to use in-flight values for pixel scale and filter plot.

NIRISS Target Acquisition

 

Updated TA magnitude limits to reflect in-flight performance

NIRISS Imaging Dithers

 

Updated to support NIRISS imaging as a prime mode in Cycle 2

NIRISS Operations

 

Updated to support NIRISS imaging as a prime mode for Cycle 2

NIRISS Instrumentation

 

Updated pixel scale to measurements from in-flight observation

NIRISS Generic Recommended Strategies

 

Added information on mitigating snowball artifacts

NIRISS Imaging Recommended Strategies

 

Updated to support NIRISS imaging as  prime mode in Cycle 2

NIRISS WFSS Recommended Strategies

 

Updated for Cycle 2

NIRISS Observing Strategies

 

Updated to support NIRISS Imaging as a prime mode in Cycle 2

NIRISS Detector Subarrays


 

Added subarray corner pixel locations as new columns to Tables 1 and 2

 

Updated frame times for SUBTASOSS and SUBTAAMI

NIRISS Optics and Focal Plane

 

Updated pixel scale based on-flight observations and updated Figure 4 to use an in-flight image

NIRISS Point Spread Functions

 

Updated to in-flight measurements based on commissioning data

NIRISS Detector Overview

 

Updated with in-flight performance values

NIRISS Detector Performance

 

Updated with in-flight performance values

NIRISS Observing Modes

 

Updated imaging pixel scale

Instruments: NIRSpec

NIRSpec FS Dither and Nod Patterns

 

Values in Tables 2 and 3 have been updated for on-orbit performance

NIRSpec MSA Target Acquisition

  

Revised text to explicitly mention the 30" roll accuracy requirement for catalogs

NIRSpec MOS Dither and Nod Patterns

 

NIRSpec MSA slitlet nods (Table 2) updated based on commissioning data

NIRSpec MSATA Reference Star Selection Recommended Strategies

 

Updated to state our current understanding of MSATA with compact galaxies

NIRSpec MOS and MSATA Observing Process

 

Updated MOS process deadlines 

NIRSpec Target Acquisition Recommended Strategies

 

Added warning on need for accurate coordinates, proper motions and for correct specification of epoch, and details of epoch.
Added note on need for PI to manually update moving target coordinates from Horizons.

NIRSpec Detector Performance

 

Major updates to reflect in-orbit data

NIRSpec Wide Aperture Target Acquisition

 

Added a warning about the PI's responsibility in ensuring accurate coordinates, proper motion and epoch. Updated "brightness limits" section.

NIRSpec Verify Only Target Acquisition

 

Added clarification that the use of custom MSA configs is not currently supported; added some additional information clarifying saturation risks

NIRSpec Target Acquisition

 

Changed language regarding protective MSA configurations 

NIRSpec Performance

 

Figures 2 and 3 replaced to show relative difference in PCE between pre-launch predictions and on-orbit performance

NIRSpec Sensitivity

 

Figures updated to present instrument on-orbit performance

NIRSpec Bright Source Limits

 

Figures updated to present instrument on-orbit performance

NIRSpec IFU Spectroscopy APT Template

 

Major updates to latest TA recommendations for WATA and MSATA

NIRSpec IFU Operations

 

Major changes in target acquisition information

NIRSpec Instrument Features and Caveats


 

Added note about repeating observations impacted by MSA shorts

 

Added availability of new flat field reference files

NIRSpec MPT - Catalogs

 

Corrected the advice to users about registering to GAIA and NIRCam pre-images

 

Reviewed and edited to give advice about target ID values, and to emphasize limits on values for stellarity, target ID, and Weight

NIRSpec IFU Spectroscopy

 

Major change to target acquisition recommendations

NIRSpec Multi-Object Spectroscopy APT Template

 

Added warning to Table 1 row 1 that observation number should not be changed during program implementation

NIRSpec MSA Planning Tool, MPT

 

Added warning that users should not change MOS observation number during program implementation

Proposal Preparation: JWST General Support

JWST Background Model

 

Updated based on commissioning data

JWST Slew Times and Overheads

 

Updated Figure 1 and Tables 1 and 2 to APT 2022.7

Proposal Preparation: Methods and Roadmaps

HCI NIRCam Limiting Contrast

 

Added a NIRCam in-flight contrast example (Fig. 2)

2024-07-22_20-47-44_Moving Target Calibration and Processing

 

Updated extensively using in-flight knowledge

Moving Target Field of Regard

 

Added information about the micrometeoroid avoidance zone (MAZ)

JWST High-Contrast Imaging Roadmap

 

Updated MIRI performance metrics
Added step to check for features and caveats
Included cycle 2 background and TA warnings for MIRI in the appropriate places

HCI Small Grid Dithers

 

Added offset sizes (in mas) for MIRI and NIRCam 

HCI Inner Working Angle

 

Updated inner working angle values in Table 1 

HCI Optics

 

Updated coronagraph filter properties

HCI NIRISS Limiting Contrast

 

Updated to use in-flight measurements from JWST commissioning

HCI APT Instructions

 

Added information for adding dedicated background targets; added warning about MIRI dedicated backgrounds to mitigate glow sticks

JWST Imaging

 

Updated for Cycle 2, including updated sensitivities in Figure 3 and to note that NIRISS imaging is now supported as a prime observing mode

JWST Imaging Roadmap

 

Updated to support NIRISS imaging as a prime observing mode starting in Cycle 2

JWST Parallel Observations

 

Updated for Cycle 2

JWST Multi-Object Spectroscopy Roadmap

 

Added warning that users should not change MOS observation number during program implementation

JWST Time-Series Observations Noise Sources

 

Updated for post-commissioning release

JWST Target of Opportunity Observations

 

Revised nomenclature for Cycle 2

Proposing Tools: ETC

JWST ETC Instrument Throughputs

 

Updated MIRI, NIRCam, and NIRSpec information for on-orbit file deliveries, and updated dictionary examples. Updated for ETC 2.0.

JWST ETC Images and Plots

 

Update for ETC 2.0. Added a caveat about the wavelengths reported by the 1-D plots and 2-D images.

JWST ETC Scenes and Sources Page Overview

 

Updated for ETC 2.0. Added additional information to Table 1 (Default and maximum scene size used in the calculation)

JWST Exposure Time Calculator Overview

 

Updated for ETC 2.0. Added information about folders.

JWST ETC Reports

 

Updated for ETC 2.0.

JWST ETC Coronagraphy Strategy

 

Updated for ETC 2.0. Added information on the contrast calculation.

Proposing Tools: APT

APT Special Requirements

 

Updated description of implicit SRs; added reference information about the micrometeoroid avoidance zone.

Proposing Tools: Other Tools

JWST Interactive Sensitivity Tool

 

JIST has been updated for in-orbit performance expectations

JWST General Target Visibility Tool Help

 

Updated for JWST General Target Visibility Tool (GTVT) version 0.3.0.

JWST Moving Target Visibility Tool Help

 

Updated for JWST Moving Target Visibility Tool (MTVT) version 0.3.0.

Data

JWST MIRI MRS Pipeline Caveats


 

Updated with in-flight measurements

 

Added caveats to wavelength calibration

JWST Data Calibration Reference Files

 

Added a link on how to cite JWST data and reference files
Added a list of technical reports on calibration reference files from commissioning

 

Added note that CRDS PUB will be decommissioned

Added information about subscription to mailing list for updates to reference files

Included explanation about the differences between the CRDS JWST OPS and PUB servers.

Included information about status of reference files after commissioning.
How to know which reference files were used with your data.
How to subscribe to MAST to be notified about new reference files

Snowballs and Shower Artifacts

 

Updated with MIRI showers figure and pipeline information

calwebb_spec2

 

Added information about the steps for WFSS contamination removal and wavelength assignments
Added a statement about NIRSpec data in the flux calibration step

JWST MIRI LRS Pipeline Caveats

 

Updated for Cycle 2 with some further discussion of the wave cal issue

 

Minor updates: bad pixels can cause spikes and dips in the extracted products; custom extraction aperture requires use_source_posn to be set to False

MIRI Time Series Observations Pipeline Caveats

 

Figure 1 updated with in-flight data

JWST Calibration Pipeline Caveats






 

Added note that CRDS PUB server will be decommissioned

 

Updated CRDS context for NIRCam imaging and TSO imaging

 

Added a sentence that publications should mention the server used to retrieve reference files for processing data

 

Updated CRDS context for NIRISS WFSS

 

Updated CRDS Context for NIRSpec

 

Updated CRDS Context for NIRISS WFSS

 

Updated MIRI LRS reference file context to jwst_0927.pmap

JWST Operations Pipeline Build 8.1.2 Release Notes

 

Added JWST Science Data Processing subsystem changes included in this build.

calwebb_detector1

 

Additional comments on steps applied to individual detectors and saturation detection

JWST Operations Pipeline Build 8.0.1 Release Notes

 

Added info on source_catalog step in calwebb_image3 reporting large error values due to a bug

 

Updated issues to be only those found in build 8.0.1

JWST Operational Pipeline Build Information

 

Added known issues with the pipeline found during commissioning
Added future enhancements information

JWST Data Analysis Visualization Tool

 

Updates for ERO and commissioning data public release. Added table of videos

JWST Data Analysis Software Packages

 

Updates for ERO and commissioning data public release. Added specreduce package.

JWST Post-Pipeline Data Analysis

 

Updates for ERO and commissioning data public release.






Notable updates

See the date at the top of each table

Originally published