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
Creating a source
Sources contain the spatio-spectral information that will be used in the scenes and calculations. Creating a new source via the 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
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:
Reminder to shireen: come up with a standard way for presenting "how to" content in a light easily readable format.
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.
Contains options for the spectral energy distribution, extinction to be applied, and the redshift information for the source's spectrum.
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.
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 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 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 button.
Note: After defining all the lines, you must click the button to apply them to the source spectrum.
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.
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.
|title||Saving and Resetting |
You may move between these tabs while editing the source, but you must click before selecting a different source in the source table, or your changes will be lost. Clicking the button will revert your changes to the most recently saved values.
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
|Instrument||Mode||Default scene size (arcsecs)||Max scene size (arcsecs)||Dynamic†|
| ||LRS Slitted||6.05||10.0||True|
| ||LRS Slitless||6.00||30.0||True|
| || MRS IFU|| || || False|
| ||Coronagraphy|| || || False|
| ||SW Imaging||2.00||10.0||True|
| ||SS Grism||2.00||10.0||True|
| ||WF Grism||2.00||10.0||True|
| ||Coronagraphy|| || || False|
| ||AMI|| || || False|
| ||IFU|| || || False|
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 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 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
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
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 button at the bottom of the pane.
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
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.