JWST user documentation is under development; current versions are preliminary and subject to revision.

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content Layer
id277319515
Content Column
id277319517
classpdf-full
Content Block
overflowauto
nameSummary
id277319516

The "Scenes and Sources" page in the JWST Exposure Time Calculator (ETC) contains an overview of all scenes and sources in a workbook. Users can also create, edit, and inspect their scenes and sources. 

Content Block
overflowauto
nameContent
id277805920

Introduction

The "Scenes and Sources" page contains an overview and an editor for all scenes and sources within the workbook. From this page, it is possible to create new scenes, associate sources with scenes, edit scene and source parameters, view a representation of your scene, inspect the spectrum of your sources, and view which calculations currently contain your sources.

 


Anchor
scene_source_tables
scene_source_tables
Scene and source tables

Tables in the "Scenes and Sources" page are interactively linked, and provide visual cues for the relationship of scenes and sources. When a scene is selected in the "Scene" table, all sources contained in that scene will be highlighted in green in the "Source" table. Conversely, when a source is selected in the "Source" table, all scenes containing that source will be highlighted in green in the "Scene" table. For convenience, we refer to green highlighted rows as affected by the selected row in the other table. It is possible for a row to be both selected in its own table (yellow) and affected by the selection in the other table (green): in this case, the row appears with yellow and green striping.

Both tables are also interactively linked with the "Used in Calculations" table in the lower right. This table lists all calculations in the workbook. All calculations that are affected by the selected scene (i.e., it uses that scene) or source (i.e., the scene it uses contains that source) will be highlighted in green. All affected calculations will be automatically updated when the selected source or scene is changed.

These tables allow the user to see and manage the scope of any changes to sources and scenes. A recommended workflow is to perform detailed manipulation on sources and scenes that are not yet used by any calculations.

 


Defining scenes and sources

Sources

Creating a source

Sources contain the spatio-spectral information that will be used in the scenes and calculations. Creating a new source via the 

Status
colourBlue
titleNew
button within the "Select a Source" pane will result in a new default source (point source, flat spectrum). This source is initially not associated with any scene, and must be explicitly added to a scene using the 
Status
colourBlue
titleAdd Source
button within the "Select a Scene" pane.

Editing a source

The specific information for the source can be edited in the "Source Editor" pane. To edit the source information, the user must first select a source from the "Select a Source" pane. Navigation is done by selecting a tab within the editor, as listed below:

Restrict Content
groupsjdox_editors

Reminder to shireen: come up with a standard way for presenting "how to" content in a light easily readable format.

ID

Contains the identity information for both the source and the scene. It is where the user can change the default name and create descriptive references to the source or scene.

Continuum

Contains options for the spectral energy distribution, extinction to be applied, and the redshift information for the source's spectrum.

Renormalization

Allows a user to renormalize a source's flux either at a particular wavelength, or in a normalization bandpass. Instrument-specific HST and JWST bandpasses are offered, as well as more general photometric bandpasses.
Note: Currently the renormalization in surface brightness units for extended sources is not supported.

Lines

Allows the user to add spectral lines to the source's spectrum. Currently, only emission features are supported.

  • To add a line, the user must first input four values: a user-defined name for the line, the line center (in μm), the line width (in km/s), and the line strength (in erg/cm2/s). Once these values have been provided in their respective fields, clicking the
    Status
    colourGreen
    titleAdd
    button will include the line in the line table.
  • To edit a line, simply select the line by clicking the appropriate row in the line table. The input fields will be automatically populated with the current values of that line. Simply change the values displayed in the input fields to edit the currently selected line. Once changes have been made, click the
    Status
    colourBlue
    titleUpdate
    button. The line table row should now be updated with the new values.
  • To remove a line select the appropriate row in the line table and click the
    Status
    colourRed
    titleRemove
    button.

Note: After defining all the lines, you must click the

Status
colourBlue
titleSave
button to apply them to the source spectrum.

Shape

Allows the user to define the source as either a point source or an extended source. Choosing extended allows for flux distribution and axial extent options.

Offset

Contains options for the position of the selected source within the selected scene such as adding spatial offsets, or giving the source some orientation.
Note: There must be a source added to a scene before entries in the Offset tab will take effect.

Info
titleSaving and Resetting

You may move between these tabs while editing the source, but you must click 

Status
colourBlue
titleSave
before selecting a different source in the source table, or your changes will be lost. Clicking the
Status
colourYellow
titleReset
button will revert your changes to the most recently saved values.

 


Scenes

Scenes are idealized representations of spatial (two angular coordinates) and spectral brightness distributions, before being observed by a telescope. They are composed on 'postage stamps,' that is, relatively small areas of ~10–20 square arc seconds (Table 1 shows the default and maximum scene size that will be used in the calculation, centered on scene center for each instrument/mode pairing). Although not a fundamental limitation, this restriction conserves computational resources and reduces the time for calculations. Scenes also contain the source targets of an observation, and all other nearby sources that could contribute to both the observed target and background fluxes.

 

Table 1. Default and maximum scene size used in the calculation

InstrumentModeDefault scene size (arcsecs)Max scene size (arcsecs)Dynamic
MIRIImaging6.0540.0True
 LRS Slitted6.0510.0True
 LRS Slitless6.0030.0True
      MRS IFU     False
 Coronagraphy     False
NIRCAMLW Imaging4.0020.0True
 SW Imaging2.0010.0True
 SS Grism2.0010.0True
 WF Grism2.0010.0True
 Coronagraphy     False
NIRISSImaging4.0020.0True
 SOSS16.916.9False
 WFSS15.075.0True
 AMI     False
NIRSPECFixed Slit3.0020.0True
 Imaging3.0020.0True
 MSA3.0020.0True†
 IFU    False

Indicates whether the scene is dynamic. If true, the scene will grow to encompass all specified sources up to the maximum scene size. The scene sizes refer to the width on each side. Not all modes support dynamic scenes. If Dynamic scene is False, the scene size is set by the PSF footprint taken from the PSF library, which varies based on the observing mode settings.

Adding sources to scenes

An empty workbook, for a user just starting out, will initially contain a default scene and a default point source. To add a scene, click the 

Status
colourBlue
titleNew
button at the bottom of the "Select a Scene" pane. The user will find that the table has been populated with a new scene, and selecting this scene will allow the user to view an idealized representation in the "Scene Sketch" pane below.

To create a new source, a user must click the

Status
colourBlue
titleNew
button in the "Select a Source" pane, to the right.

After having created a new source object, the user will have to explicitly associate the source with a scene, as it is possible to have multiple scenes that contain the same source. To do so, the user must select the desired source in the source pane, select the scene to which the source will be associated, and click the

Status
colourBlue
titleAdd Source
button. The previously yellow highlighting of the selected scene and source will now be visible as a striped green and yellow pattern. The newly added source will now be visible at the center of the scene sketch. You may now use the Offsets tab to place it at the desired location (refer to the "Sources and Scene" Tables section for a more in-depth explanation of the color scheme). Likewise, the "Scene Sketch" pane should now display the idealized 2D flux image of the scene.

To remove a source, select your scene and the associated source and click the

Status
colourYellow
titleRemove Source
button. This will not delete the source, but only remove its association with the scene object. Again, the user will notice that the source has been removed from the "Scene Sketch" pane.

To delete a scene, select a scene and click the 

Status
colourRed
titleDelete
button at the bottom of the pane.

Info

Note that if there exists a calculation that contains the scene, the user will not be able to remove the scene without first modifying the calculation to use a different scene, or simply deleting the calculation. The column "# Calcs" displays the number of calculations that contain the scene.

 


Viewing scenes and source

Scenes and source properties are presented in the two lower panes: "Scene Sketch", and "Source Spectrum Plots". The Scene Sketch is interactively linked with the Source Table. A selected source will appear yellow in the sketch, and clicking on a source in the sketch will select its row in the Source Table. Selecting a scene will automatically update the "Scene Sketch" pane with an idealized (i.e. before being observed by a telescope) representation of the sources within that scene. The source is directly influenced by the settings within the "Source Editor" pane; e.g. the idealized sources will reflect the shape and offset parameters defined by the user.

Selecting a source will automatically check its "Plot" checkbox and show its spectrum in the "Source Spectrum Plots." Multiple sources can be compared by manually checking their "Plot" check boxes. For convenience, the "Plot" column heading is a drop-down that allows the user to check "All" or "None" of the entries for plotting. The extent of the plot axes may also be controlled by setting the bounds below the spectra plot and clicking the `apply` button.

While the "# Calcs" column of the "Select a Scene" and "Select a Source" panes tell the user how many calculations the scene(s) and/or source(s) are used in, users may wish to refer to the "Used in Calculations" pane to view the specific calculations affected by a change in the selected source or scene. The "Used in Calculations" pane displays any calculations that any source or scene are actively used in, but selecting a source or scene will correspondingly highlight the associated calculation(s) in green.

 


 

Content Block
overflowauto
nameRelated links
id280628021
classpdf-hide

Related links

JWST User Documentation Home
JWST Exposure Time Calculator, ETC
JWST Exposure Time Calculator Overview
JWST ETC Creating a New Calculation
JWST ETC Defining a New Scene
JWST ETC Defining a New Source
JWST ETC User Supplied Spectra

Content Block
overflowauto
nameReferences
id281944791
classpdf-hide

References

Go to the on-line JWST Exposure Time Calculator Tool

Pontoppidan, K. M., Pickering, T. E.,  Laidler, V. G.  et al., 2016, Proc. SPIE 9910, Observatory Operations: Strategies, Processes, and Systems VI, 991016 
"
9910 
Pandeia: a multi-mission exposure time calculator for JWST and WFIRST"

JWST technical documents

Content Column
id277319512
classpdf-hide
Content Block
overflowauto
nameIcon
id278719485
classpdf-hide

Multiexcerpt include
MultiExcerptNameETC icon and name
PageWithExcerptMR:ETC icon and name

Content Block
overflowauto
nameUpdates
id1066359141
classpdf-hide
HTML Wrap
padding0
margin0
idupdatesbox
HTML Wrap
tagspan
classupdatesbox-heading

Last updated

Published December 30, 2016


 

Comment

The format for 'Last updated' is shown below. Enter updates above this internal"Comment" box. Only enter major updates (not typos or formatting changes).


Updated April 05, 2017

  • Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam fermentum vestibulum est. Cras rhoncus. 
  • Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Sed quis tortor. 

Published March 02, 2017


Restrict Content
groupsconfluence-authors

Tables are only visible to JDox content providers

"Updated" refers to the updated or publish dates for the public pages.

Page properties
idcomments
UpdatedDecember 30, 2017
Open commentsYes
TeamETC
AuthorRavindranath, Brooks
Page properties
idlayout
UpdatedDecember 30, 2017
Fix pageNo
Type-
Teameditors