the 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 JWST Exposure Time Calculator (ETC) uses a scene for the calculations. A scene may contain one or multiple sources and is an idealized representation of the spatial distribution of a target and nearby sources with defined intrinsic spectral properties.

Content Block
overflowauto
nameContent
id277805920

Introduction

The JWST Exposure Time Calculator (ETC) uses a scene for performing its calculations, and a scene can include one or more sources. Scenes are idealized representations in two spatial dimensions (angular coordinates) with sources properties determining the brightness distribution and shapes. The scene sizes are roughly  10-20 roughly 10–20 square arcseconds depending on the instrument and mode. The user can create many scenes and have a scene library with unique scene IDs or names. The scenes and sources defined in a workbook are persistent and can be reused in various calculations. 

 


Creating a New Scene 

The default workbook that is created when a user creates a new workbook contains a default scene with one default source (a point source with flat continuum) on the Scenes and Sources page (figure Figure 1). The user can create a new scene by clicking on the 

Status
colourBlue
titleNew
button in the "Select a Scene" pane. The new row in the scene list will show that there are no sources and that the scene has not yet been used in any calculations. When the scene is populated with sources, and then used in the ETC calculations, the information about sources and number of calculations in which the scene is used gets updated. An empty scene with no sources can be useful for examining the sky background by using it in a calculation and defining the sky background parameters under "backgrounds" in the Calculations page. To add sources to the new scene, there must be an existing list of one or more sources in the "select a source" pane.

Figure container

Figure 1: The Scenes and Sources Page Layout

Figure with title

Image Modified

Adding Sources

The source to be added to a scene is first selected by clicking the row containing the source in the "Select a Source" pane. The scene into which the source has to be placed is selected by clicking the row in the "Select a Scene" pane. The selected rows are indicated by yellow highlighting. From the "Select a Scene" pane click on 

Status
colourBlue
titleAdd Source
and the scene is populated with the currently selected source. The same procedure can be repeated by selecting the desired sources from the source list one at a time. At every step make sure that the correct source and scene are highlighted in yellow. 

Source offsets

The "Offset" tab under source editor (see figure Figure 1) is directly linked to the scene. The offsets and orientation define the placement or location of the sources in the scene and their orientation. To change the offsets of a source in a scene, both the source and the scene for which the change is to be applied has to be highlighted in yellow. This is particularly important because the same source may be used in multiple scenes, and when the source is selected, all the scenes that contain the source will be highlighted in green. Clicking on a particular scene will activate the yellow highlighting to indicate this is now the active scene. On the Source Editor pane, edit the X- and Y-offsets and orientation and use the save button to apply the changes. The offsets are defined in arcsecs with respect to the center of the scene. 

The use of larger offsets will make the scene bigger. While there is no fundamental limitation to how big a scene can be, the restrictions offered by the maximum scene size conserves computational resources and reduces the time for the calculations.

Removing sources

A source that has already been placed in a scene can be removed by using the

Status
colourYellow
titleRemove Source
button in the "Select a Scene" pane. Before this task is performed, make sure that the source to be removed is highlighted yellow by selecting it from the source list, and the scene from which it needs to be removed is also highlighted. 

 


Viewing the Scene

The newly created scene can be selected and viewed in the "Scene Sketch" pane. The scene sketch is interactively linked to the source table, such that a source selected in the source table will appear yellow in the sketch. Similarly if the source is selected in the sketch then it is also selected in the table. 

 


Deleting a Scene

To delete a scene, select the row corresponding to that scene by clicking it and it will be highlighted in yellow. If the scene has been used in any ETC calculation after it was created, this information will be displayed in the "Used in Calculations" pane, with all the calculations using the selected scene shown highlighted in green. Users should be aware of the calculations that will be affected, before performing the scene deletion. The scene may be deleted by using the 

Status
colourRed
titleDelete
button on the "Select a Scene" pane.

 


 

Content Block
overflowauto
nameRelated links
id280628021
classpdf-hide

Related links

JWST User Documentation Home
JWST Exposure Time Calculator, ETC
JWST ETC Overview
JWST ETC Calculations page Overview
JWST ETC Scenes and Sources page Overview
JWST ETC Creating a new ETC Calculation
JWST ETC Defining a New Source

 

Content Block
overflowauto
nameReferences
id33748143
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 
"
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, 2016
Open commentsNo
TeamETC
AuthorRavindranath
Page properties
idlayout
UpdatedDecember 30, 2016
Fix pageNo
Type-
Teameditors