JWST JDox Latest Updates

Lists of recently updated articles in the JWST User Documentation (JDox) website are provided in this page. 

On this page

New JDox articles since January 1, 2024

Updated  

Article TitlePublication date

 

 

 

 

 

 

JWST Call for Proposals for Cycle 4 and its associated pages

 

 

 

 

Articles about the JWST observatory—under JWST Observatory Hardware and JWST Observatory Characteristics and Performance—have been extensively reorganized, including the addition of new pages. Articles with new content include: 

 

 

 

 

 

The JWST Data articles have been extensively reorganized, including the addition of new pages and some depreciated pages

 



Notable updates to JDox articles since Jan 1, 2024

Updated  

ArticleUpdated onUpdate description
Proposing Opportunities
Cycle 3 Director's Discretionary (DD) Time Proposals

 

Clarifications made for types of DDT proposals|
JWST New and Important Features

 

Added information regarding the new Discovery DD time proposals
Instruments → MIRI
Step-by-Step APT Guide for MIRI MRS and NIRSpec IFU Observations of Cassiopeia A

 

Updated language to match APT 2024.5 

JWST Mid Infrared Instrument

 

Updated PCE plots (Figures 3, 4, 6) using ETC 4.0 for Cycle 4.

Updated sensitivity plots using ETC 4.0 for Cycle4

MIRI Sensitivity

 

Updated table and plot based on ETC 4.0

 

Added section on imaging time dependent sensitivity
MIRI Bright Source Limits

 

Tables and plot updated for Cycle 4 based on ETC 4.0
MIRI Filters and Dispersers

 

Updated PCE plots (Figures 2, 3, 5) for Cycle 4.
MIRI LRS Slit Target Acquisition

 

Added section on TA verification image

 

Updated information on offset TA target distance
MIRI LRS Slitless Target Acquisition

 

Added information about TA verification image

MIRI LRS APT Template

 

Updates to reflect cycle 4 changes to LRS slitless TA

MIRI Imaging Recommended Strategies

 

Removed the dwell time section, as this is covered in the cross-mode recommendations page.

 

Made correction to recommendation comments in Table 2
Removed reference to ground test data, which is superseded by in-flight experience
MIRI Coronagraphic Imaging APT Template

 

Added text to indicate that offset TA is now allowed for MIRI coronagraphy

MIRI Cross-Mode Recommended Strategies

 

Updated with recommendations relating to FASTR1 and SLOWR1 readout modes

MIRI Parallel Observations

 

Added full list of supported coordinated parallel modes

Removed outdated content and added additional links to complementary pages

MIRI Imaging Target Acquisition

 

Imaging TA is not supported
MIRI LRS TSOs

 

Added exposure limitations information, subarray comments
MIRI Imaging TSOs

 

Updated target acquisition and dithering sections, added exposure time limitations
MIRI Coronagraphic Imaging Target Acquisition

 

Added new section to indicate that offset-TAs are now possible for coronagraphic observations
MIRI Imaging Dithering

 

Cycling is now default pattern
MIRI TSO Recommended Strategies

 

Added new info on verification images
MIRI LRS Recommended Strategies

 

Added new information for verification image
Instruments → NIRCam
NIRCam Detector Readout Patterns

 

Added MEDIUMDEEP patterns
NIRCam Imaging APT Template

 

Added two new readout patterns to Table 2, MEDIUMDEEP2 and MEDIUMDEEP8
NIRCam Grism Time-Series APT Template

 

Updated page to include information about new SW grism time-series mode
Step-by-Step ETC Guide for NIRCam Parallel Imaging and NIRISS WFSS of Galaxies in Lensing Clusters

 

Updated to be consistent with sensitivity values for ETC v. 4.0
Step-by-Step APT Guide for NIRCam Parallel Imaging and NIRISS WFSS of Galaxies in Lensing Clusters

 

Updated to be consistent with APT 2024.5.
NIRCam Bright Source Limits

 

  • ETC v4 updates to figures and tables
  • Added section with saturation limits for new SW grism time series mode
NIRCam Detector Subarrays

 

Added pointers to the SW grism time-series and NIRCam multistripe subarrays articles
NIRCam Grism Time Series

 

Updated text for synergy with new SW grism time-series page
NIRCam Imaging Sensitivity

 

ETC v4 update to Figure 1 depths
NIRCam Imaging

 

ETC v4 updates to sensitivity & saturation plots
NIRCam Observing Modes

 

Noted extended wavelength coverage and resolving power for grism time series due to the addition of DHS grisms in the SW channel.
NIRCam Persistence

 

Added description of observational strategy for persistence mitigation of SPR beginning in Cycle 3. Reorganized existing text and figures and re-cast them as an"Analytical Strategy for Persistence Mitigation."
NIRCam Sensitivity

 

  • ETC v4 updates to imaging and grism sensitivities
  • Added section with sensitivity for new SW grism time-series mode
NIRCam Time-Series Imaging

 

ETC v4 updates to saturation plots

NIRCam Time-Series Observation Recommended Strategies

 

Updated text for synergy with new SW Grism Time Series page

NIRCam Time-Series Observations

 

Includes mention of DHS as a short wavelength grism time-series mode

NIRCam Wide Field Slitless Spectroscopy

 

Sensitivity plots were updated with ETC v4

NIRCam Coronagraphic Imaging Recommended Strategies

 

Added references and notes on imaging point sources inside IWA

NIRCam Grism Time-Series Target Acquisition

 

Figure 1 updated to show LW grism pairing with SW grism or SW imaging

NIRCam Apertures

 

All values updated to reflect current distortion and relative alignment knowledge based on all Cycle 1 calibration data.

JWST Near Infrared Camera

 

Added information on using the DHS for grism time series

 

NIRCam Detector Readout

 

Added pointers to information about the multistripe subarrays used for SW grism time series.

NIRCam Filters for Coronagraphy

 

Added a reference (Girard et al.) and Figure 1 

NIRCam Subarray Primary Dithers

 

Updated to make it clearer that this is a legacy dither pattern, and that the STANDARD dither pattern is recommended instead.

Step-by-Step ETC Guide for NIRCam Deep Field Imaging with MIRI Imaging Parallels

 

Updated for ETC v3.2

Step-by-Step APT Guide for NIRCam Deep Field Imaging with MIRI Imaging Parallels

 

Updated the position angle to avoid the MAZ and updated charged time to results from APT 2024.1.

NIRCam Flat Fields

 

Added Technical Report reference for Cycle 1 flat field updates.

NIRCam Filters

 

Updated throughput curves, figures, and table values with latest results

NIRCam Target Acquisition

 

Added details about box sizes

Instruments → NIRISS
NIRISS Aperture Masking Interferometry APT Template

 

Updated for APT 2024.5 to account for the new way of specifying optional direct images for an AMI exposure

Step-by-Step ETC Guide for NIRISS AMI Observations of Extrasolar Planets Around a Host Star

 

Updated for ETC 4.0 (new charge migration signal limit) and to use the recommended 5-step subpixel dither pattern

Step-by-Step APT Guide for NIRISS AMI Observations of Extrasolar Planets Around a Host Star

 

Updated for ETC 4.0 (new charge migration signal limit) and to use the recommended 5-step subpixel dither pattern

NIRISS SOSS Time-Series Observations of a Transiting Exoplanet

 

Updated to add optional F277W+GR700XD exposure

Step-by-Step ETC Guide for NIRISS SOSS Time-Series Observations of a Transiting Exoplanet

 

Updated to add an ETC calculation for an exposure with the F277W filter

Step-by-Step APT Guide for NIRISS SOSS Time-Series Observations of a Transiting Exoplanet

 

Updated to add optional F277W exposure

Step-by-Step ETC Guide for NIRISS WFSS and Parallel NIRCam Imaging of Galaxies in Lensing Clusters

 

Updated to be consistent with sensitivity values for ETC v. 4.0

Step-by-Step APT Guide for NIRISS WFSS and NIRCam Parallel Imaging of Galaxies in Lensing Clusters

 

Updated to be consistent with APT 2024.5

NIRISS Bright Limits

 

Updated bright limits to be consistent with ETC v. 4.0. AMI bright limits are changed due to a charge migration signal limit update from 20,000 e- to 26,000 e-. The WFSS and Imaging bright limits were updated due to a signal limit decrease from 72,000 e- (full well depth assumed for the ETC) to 34,4000 e- (charge migration signal limit for imaging and WFSS in the F090W filter). SOSS bright limits are unchanged. 

NIRISS Imaging Recommended Strategies

 

Updated for Cycle 4 to note that the ETC v. 4.0 uses the charge migration signal limit to determine (effective) "saturation" in a NIRISS calculation for imaging.

NIRISS Sensitivity

 

Updated to match ETC 4.0 sensitivities where new PSFs were created to include effects of IPC and an updated background model was implemented. Imaging sensitivities changed by several percent in the long wavelength filters due to changes in the background.

NIRISS AMI Recommended Strategies

 

Updated charge migration signal limit to 26,000e- based on measurements from in-flight data in the F480M filter. Removed discussion about filter-dependent offsets after TA since these offsets are now applied automatically by APT.

NIRISS SOSS Recommended Strategies

 

Added information about obtaining optional SOSS background exposures.

 

Added some more information about obtaining an optional F277W+GR700XD exposure.

NIRISS WFSS Recommended Strategies

 

Updated for Cycle 4 to note that the ETC v. 4.0 uses the charge migration signal limit to determine (effective) "saturation" in a NIRISS calculation for WFSS.

NIRISS Wide Field Slitless Spectroscopy APT Template

 

Updated to add note about average pixel scale in the dithers section. Renamed "Science Observation" heading to "Science (Grism) Exposures" to be consistent with wording used as of APT version 2024.3.

NIRISS WFSS Dithers

 

Updated to quote average pixel scale of NIRISS in the dithers section. Also noted that a minimum of 4 dither steps is recommended.

NIRISS Dithers

 

Updated to note that 5-point SUBPIXEL dithering is recommended for the AMI mode.

NIRISS Operations

 

Updated to note that the 5-point subpixel dither pattern is recommended for the AMI mode.

NIRISS Point Spread Functions

 

Updated to highlight time-dependence of OPD files available in WebbPSF

NIRISS GR150 Grisms

 

Updated to plot the Photon-to-electron conversion efficiency rather than the grism only throughputs. Also provided data files for the PCE curves.

NIRISS GR700XD Grism

 

Updated to show the Photon-to-electron conversion efficiency curves for GR700XD rather than grism-only throughput. Also uploaded the data file for the curves.

Instruments → NIRSpec

 

Updated language to match APT 2024.5

 

Added section on adding a Leakage exposure in APT

 

Changed TA exposure time to match ETC V4.0

 

IFU, MOS, and FS limiting sensitivity figures replaced and text edited for ETC v4.0

 

FS, MOS, and IFU bright limits figures updated for ETC 4.0

 

Updated WATA brightness limit table and other magnitudes for ETC v4.0

 

Table 3 revised for ETC v4.0.

 

Updated Table 2 and text for IFU 4-point nod for implementation in ETC v4.0

 

Added text to attention box stating that the number of sources can have decreased slightly due to increased distance between spectra in the dispersion direction.

 

Updated text regarding operability and model updates after commissioning.

 

Clarified that APA restrictions should be present in the proposal submission

 

Clarified recommendations about adding an APA special requirement, but only if necessary.

 

Updated numbers for shutter operability and replaced Fig 5, based on March 2024 results of Peter Zeidler

 

Clarified the addition of an APA special requirement at proposal submission. 

 

  • Added recommendations on when to use each TA type.
  • Added recommendation for more cycling dithers.
  • Added Figure 7 for Leakcal specification in APT.
  • Added text on how to specify Leakcal observations in APT template.

 

Corrected text for grating-filter combinations and added text for non-science target WATA source.

 

Updates to G235H and G395H dispersion fits files

 

Candidate sets can now be filtered by coordinates

 

Noted that Verify_Only selection in APT now has appropriate warnings.

 

Noted what is needed to move a MOS program from implementation to scheduling.

Proposal Preparation → JWST General Support

 

Updated MIRI section to include definition of FASTR1 & SLOWR1

Proposal Preparation → Methods and Roadmaps
HCI APT Coronagraphic Sequence Examples

 

All information has been updated to represent APT 2024.5
HCI MIRI Limiting Contrast

 

Added link and reference to published in-flight updates to MIRI coronagraphic performance
JWST Imaging

 

Updated Figure 3, JWST imaging sensitivity, to use sensitivities from ETC 4.0.
Moving Target Acquisition and Tracking

 

Updated the visit splitting distance
JWST Imaging

 

Updated Figure 3, JWST imaging sensitivity, to use sensitivities from ETC 4.0.

HCI Inner Working Angle

 

Added table note on effective diameter of 5.2m for NIRCam (due to Lyot stop)

JWST Multi-Object Spectroscopy

 

Updated references from SpecViz and MOSViz to JDaviz
Moving Target APT Instructions

 

Added a link to documentation describing the visualization of a moving target ephemeris in Aladin.
Moving Target Overheads

 

Updated the default slew time
Proposing Tools → Exposure Time Calculator 
JWST ETC Point Spread Functions

 

Updated WebbPSF version numbers for ETC 4.0
JWST ETC NIRCam Target Acquisition

 

Updated saturation limits for ETC 4.0
JWST ETC Images and Plots

 

Updated for ETC 4.0—replaced images to show new aperture drawing feature
JWST ETC Cosmic Ray Implementation

 

Updated for ETC 4.0 to account for ramps with a single group
JWST ETC Batch Expansions

 

Updated for ETC 4.0 to account for the new support for single-group ramps and the NIRCam SW grism time-series mode
JWST ETC Aperture Spectral Extraction Strategy

 

Updated for ETC 4.0 to describe support for square apertures and pixel units
JWST ETC Saturation

 

Updated for ETC 4.0. Updated NIRISS saturation values, added saturation limit for NIRCam SW grism time series, and updated the full saturation definition to account for ramps with a single group.
JWST ETC Scenes and Sources Page Overview

 

Added row for NIRCam SW time-series grism in scene size table
JWST ETC Time-Series Modes

 

Updated for ETC 4.0 to add a link for the new NIRCam SW grism time-series mode
Pandeia Quickstart

 

Updated examples for ETC 4.0
Pandeia Reports

 

Updated definition of duty cycle and plots for ETC 4.0
Pandeia Batch Mode

 

Updated figures for ETC 4.0
Pandeia Reference Data

 

Updated example meta data for ETC 4.0
Pandeia Configuration Dictionaries

 

Updated figures for ETC 4.0
Pandeia Order of Operations

 

Updated code examples for ETC 4.0
JWST ETC IFU Strategies

 

Added a new section for the "IFU On-Target N-Point Nod" strategy.
Proposing Tools → Astronomer's Proposal Tool
APT Pure Parallel Observations

 

Added point #10 on "Filling out APT forms for pure parallel proposals"
APT Submitting Your JWST Proposal

 

Added Figure 1, APT submission interface
APT Smart Accounting

 

Updated Figure 5, smart accounting report output
Data → Accessing JWST Data
JWST Time Definitions

 

Updated for ETC 4.0 to provide the correct duty cycle definition

Data → Science Calibration Pipeline

 

Updated build information table for quarterly calibration update model.

 

Updated for build 11.0

 

Updated for build 10.2

 

Updated CRDS information to reflect new quarterly calibration update model

 

Updated to reflect build 10.2

Data → Calibration status

 

Updated to report photometric accuracy as of jwst_1296.pmap and link to the imaging photometry technical report.

 

Updated description about charge migration to note the signal limit used for all filters as of CRDS context jwst_1254.pmap.

 

Updated accuracy in spectral trace positions for the F115W filter which is reflected in the specwcs reference file as of CRDS context jwst_1252.pmap and accuracy in spectral trace positions for the F150W filter which is reflected in the specwcs reference file as of CRDS context jwst_1263.pmap.

 

Updated list of recent calibration changes in Table 1 for June and August 2024.

 

Added links to the time-dependent sensitivity decline

 

Added a table with detector position and orientation in V2/V3

 

Updates about wavelength calibration for slit

Data → Known issues with JWST data

 

Updated mitigation plan for issue NS-BOTS03

 

Created issue NS-BOTS06: Fluxes are too low at the red and blue wavelength extremes of extracted 1-D spectra for M- and H-grating observations

 

Updated issues NS-BOTS02, NS-BOTS03, NS-BOTS04

 

Updated mitigation plan for issues NS-FS07, NS-FS10

 

  • Updated issues NS-FS05, NS-FS07, NS-FS08
  • Added issue NS-FS10: Discrepancies in extracted 1D fluxes at the 3-5% level when changing the assign_wcs step slit width.

 

 

Updated mitigation plan for issues NS-G05, NS-G08

 

Created issue NS-G09: Uncertainties in the combined background images produced in the background step are not propagated into science data.

 

  • Updated issues NS-G03, NS-G05, NS-G06, NS-G07
  • Created issue NS-G08: Data with associated background or imprint observations that is reprocessed locally with 1/f cleaning using the nsclean step does not remove 1/f noise.

 

Updated mitigation plan for issues NS-MOS04, NS-MOS07, NS-MOS08, NS-MOS09

 

Created issue NS-MOS10: Uncertainties in the background spectrum are not accounted for when using the master_background_mos step.

 

Updated issues NS-MOS01, NS-MOS03NS-MOS04, NS-MOS05, NS-MOS06NS-MOS07, NS-MOS08, NS-MOS09 

 

  • New section, "Spectral and spatial distortions"
  • Added issue NS-IFU07: The spectral centroid of emission lines shows unexpected structure across IFU-slices.
  • Updated issues NS-IFU03NS-IFU05, NS-IFU06.

 

Added information on resampling images onto common pixel grid. Updated Wisp information.

 

Minor updates to the alignment section to improve clarity. Added NC-I07 to the table in order to summarize the issue already described in the page text.

 

Added issue NC-I06: Point source aperture photometry results may show a filter-dependent discrepancy compared to PSF photometry results when using NIRCam aperture correction reference files in CRDS.

 

Updated to discuss major updates in the calwebb_ami3 stage deployed in pipeline build 10.2

 

Added new section "Electromagnetic interference (EMI) pattern noise"

 

Updates on wavelength calibration.

 

Updated to reflect jwst software patch 1.14.1 for build 10.2 (fixing a numpy dependency issue)

 

Updated to reflect jwst software patch 1.14.1 for build 10.2 (fixing a numpy dependency issue)

 

Resolved issue NR-WFSS04: WCS keywords in the header of pure parallel WFSS observations (both direct images and grism exposures) taken prior to June 12, 2024, are "off" by of order 0.1 arcsec no matter which SI is prime, and the offset is generally different for different dither positions. 

 

Updated issue NR-WFSS01: the field dependence of the spectral trace shape is now calibrated for both grisms in the F200W filter.

 

Added issue NR-WFSS04: WCS keywords in the header of pure parallel WFSS observations are "off" by about 0.1 arcsec

NIRCam Scattered Light Artifacts

 

Updated claw/wisp example with higher SNR stack with no galaxy contaminant so they are more clear.

 

Updated information on claws, wisps, and msa short contam with latest findings. Changed claw example picture to one not impacted by wisps so the claw is more clear.

 

NC-TS02 was fixed in build 10.2. NC-TS01 - added note about running notebook on prior pipeline versions. 

 

Updated to indicate snowball correction is turned on by default

 

Updated to note that the default source finding algorithm in tweakreg for NIRISS (specified by the "pars-tweakreg" parameter reference file) is IRAFStarFinder as of pipeline build 10.2 and CRDS context jwst_1223.pmap.

 

Added issue NR-I02: WCS keywords in the header of pure parallel imaging observations are "off" by about 0.1 arcsec

NIRCam Coronagraphy Known Issues

 

For issue NC-CI02, added another workaround to reduce excessive outlier flagging.

 

 

Added a warning that the most recent WFSS photom reference files are designed to work with pipeline v.1.14.0 or later. Previous reffiles are designed for pipeline versions prior to 1.14.0

Added issue NC-WFSS04: Calibrated flux values in WFSS or grism time series products are too large or too small by a factor of ~10.

 

Article rewritten for build 10.2, reorganized and added figure about typical snowball corrections.

 

Updated accuracy in spectral trace positions for the F200W filter which is reflected in the specwcs reference file as of CRDS context jwst_1228.pmap.



Articles updated prior to Jan 1, 2024

Articles updated between June 1 and December 31, 2023 are listed at JDox Updates 1 June - 31 December 2023

Articles updated between January 28 and May 31, 2023 are listed at JDox Updates 28 Jan - May 31 2023.

Articles updated prior to January 27 2023 are listed at JDox Updates 12 July - 6 December 2022.




Notable updatesSee the tables above
Originally published