Page tree

Versions Compared

Key

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


Content Block
overflowauto
meta-propertiestrue
nameSummary
id277319516
classpdf-full

Example Science Program #24

The JWST NIRSpec Team provides this set of step-by-step instructions to create multi-object spectroscopy observations of pre-main sequence stars in the star forming region NGC 346.


Content Block
overflowauto
nameContent
id277805920
classpdf-full

Introduction 

As a working example of the multi-object spectroscopy mode of NIRSpec, we introduce a science case of extragalactic stellar astronomy. In this example we study the stellar populations of star-forming region NGC 346 in the Small Magellanic Cloud, with emphasis on the pre-main sequence and red giant branch sources using the NIRSpec MOS observing mode.

In this multi-object spectroscopy example we follow all the steps in the MSA Planning Tool (MPT) guide and MPT-related articles. The example starts with the ingestion of a parent catalog of sources and the creation of candidate sets. Using these sets of sources, we explain how to create several plans and we compare the plans and asses their quality. Finally we show how to create an observation and how to access the visit planner. Each step in the process contains links to the MPT articles for more detailed explanations. 

We also provide example ETC calculations to bound the sensitivity estimates for the interesting candidate sources in the NGC 346 region.

This article is divided into two main sections: 

APT step-by-step instructions

ETC step-by-step instructions

 


Anchor
apt-ngc346
apt-ngc346
APT step-by-step instructions

Creating and ingesting a source catalogv

We base this article on the source catalog produced for the star-forming region NGC 346 by Gouilermis, D, et al. (2006). In this paper, the authors share a catalog with more than 99,000 stars with PSF photometry measured using HST/ACS imaging in filters F555W and F814W.

Data for this paper was obtained under HST GO Program 10248 (PI: A. Nota). Figure 1 shows a drizzled data product for this region, using images from two filters: F555W and F814W. The image was built using 3 color channels: red (F814W), blue (F555W), and green (F814W+F555W). Over-plotted are (in red) the 4 MSA quadrants and (in yellow) the NIRSpec IFU aperture to give an idea of the available field of view for obtaining spectroscopy. 

Figure container


Figure title

Figure 1. NGC 346 as seen by HST

Figure caption

Color image of NGC 346 based on HST observations. The footprint of the MSA quadrants are plotted at an angle of 30°.


Figure 2 is a representation of the [F555W-F814W, F555W] color magnitude diagram with the Vegamag photometry obtained in NGC 346. The authors observed several stellar populations: main sequence (lower and upper), a red giant branch, and a population of pre-main sequence stars.

Sources of interest for the MSA follow up spectroscopy are certainly the red giant branch stars, and the pre-main sequence stars. We identified subsets of those groups and assigned them a weight value in the source catalog. We modified the public NGC 346 catalog to preserve the same ID numbers. We transformed the equatorial coordinates to units of degrees and we removed sources with magnitude error larger than 0.1 mag in either filter. We also added a weight value to each source. The weight values are listed in Table 1. Note that for this study we are mostly interested in obtaining the IR spectra of the pre-main sequence stars, hence the higher weight value.

 

Table 1. Weight values assigned to the stellar populations

Source typeWeight value
upper main sequence UMS10
pre-main sequence PMS100
red giant branch RGB40
other 1


Figure container


Figure title

Figure 2. Color magnitude diagrams

Figure caption

NGC 346 color magnitude diagram [F555W-F814W, F555W] showing 99,000 sources in the filed. The left plot shows all sources from the catalog represented as black dots. Regions were defined by the authors and correspond to upper main sequence, lower main sequence, red giant branch, and pre main sequence stars. To build the plot on the right, we selected subsets of sources in each group and highlighted them in color and with a larger symbol.


This catalog is available below. 

You may download the catalog and use it in APT to follow our example. For this exercise, we are using APT version 25.4.3.

We start a new observation in the Observation Folder in APT. Under MSA Planning Tool, we import the catalog of sources. The catalog is in white space separated format. Figure 3 shows the window used to ingest the catalog onto MPT. We name the catalog 'ngc346'.

Figure container


Figure title

Figure 3. Importing the parent catalog

Figure caption

Once the catalog of sources was ingested, some of the column types were recognized automatically, others had to be assigned by hand.


The catalog contains 83,184 sources

Following Figure 4 in the NIRSpec MPT - Catalogs article, we next need to specify the Catalog 'Astrometric Accuracy' and the 'Pre-Image Availability'. We assign it an accuracy of 10 mas because it was generated using HST imaging. We set 'Pre-image availability' to 'not requiered'.

HST/ACS drizzled products generated with images obtained in the past decade deliver an astrometric accuracy of 10 mas or less, depending on the filter. The same applies to HST/WFC/UVIS.

Creating candidate sets

The main scientific goal in this example is obtaining IR spectra of pre-main sequence stars. A secondary goal is to measure some red giant branch stars.

Our primary sources are the pre-main sequence stars, so we create a candidate set called 'pms' that contains only those sources. This is easy to do in MPT by highlighting the parent catalog, and selecting 'New Candidate Set'. A pop-up window will allow us to select a sub-set of sources with a Weight of 100. This candidate set contains 3,319 sources.

We next  create a candidate set that contains both types of sources: pre-main sequence stars and red giant stars. In this case, we highlight the parent catalog, and select 'New Candidate Set'.  In the  pop-up window we select a sub-set of sources with a Weight between 40 and 100. We will call the new candidate set 'pms-rgb'.  After clicking 'Make Candidate Set', we find that it has 5,881 sources as shown in Figure 4.

Figure container


Figure title

Figure 4. Viewing candidate sets in MPT

Figure caption

Two candidates sets (pms and pms-rgb) are listed below the parent catalog ngc346. Showing here is the candidate set 'pms' which contains 3,319 sources with a weight of 100. Since it has been highlighted, the data on that candidate set is presented to the right.


Visibility analysis

As a "quick look" tool for pre-planning purposes, STScI has developed the General Target Visibility Tool which is a Python command-line tool for calculating visibility of a given target (RA, Dec). This code provides the aperture position angle (APA) for NIRSpec as a function of time.

Using this tool it is possible to obtain ranges of viable angles to use in the MPT Planner.

Please note that the ability to schedule any given target observation is more complex that just its visibility. It also involves the availability of guide stars as a function of time and other observatory constraints.

Tip

For any NIRSpec MSA observation, it is highly recommended to experiment with a range of aperture position angles in the MSA planning tool, as opposed to one single fixed angle. This recommendation is made to encourage users to understand the visit and timing overheads between plans created at different angles.

More information on planning for the aperture position angle is in the MPT - Planner article. A more general approach is in the article JWST Position Angles, Ranges, and Offsets.

Creating plans

We now move to the Planner pane and create a series of plans. 

plan ngc346-01

We assign an Aperture PA value of 120.0. The Primary Candidate List is our list 'pms' and the Filler Candidate List would be 'pms-rgb'. By keeping the primary sources in the Filler list,  we increase the chance to observe more pre-main sequence sources. 

For the slitlet setup, let us use the default of a 3 Shutter Slitlet and the Entire Open Shutter Area as centering constraint. We set the Dither type as Fixed Dither and use a 5 shutter offset in the dispersion direction, which corresponds to ~1.25 arcsec.

For the Exposure Setup, let us start with a high resolution grating/filter combination  G140H/F070LP, NRS IRS2 readout pattern, 10 groups and 2 integrations. 

Under Parameters, we check 'Use Weights' and set Number of configuration to 10. This will generate 5 target sets, each with two dithers as explained in the article NIRSpec MPT - PlannerWe name this first plan ngc346-01.

Click on Generate Plan, and after a few seconds the plan should be finished. When finished, we land in the Plans pane where plans are reviewed.  

Lets go on to make some additional plans first. Returning to the Planner, you will see that the parameters from the last plan are still selected. This was done to make it easier to quickly modify a few values and generate additional plans.

plan ngc346-02

In this plan we change the centering constraint to 'Tightly Constrained' to see the differences with the previous plan. We keep all other parameters the same and call this plan ngc346-02

plan ngc346-03

We now use the same parameters as with plan ngc346-01 but this time we use a finer search grid by changing the Search Step Size from the default 30"  to 5". Note how the number of pointings increases considerably. The computation takes a little longer, but it usually results in better performance in terms of the numbers of observed targets. We name this plan ngc346-03.

plan ngc346-04

Now let's return to the same parameters as with plan ngc346-01 but this time add exposure specifications in all four high-resolution grating/filter combinations.  This will generate four times the exposures of previous plans (for each of the three gratings). We name this plan ngc346-04.

plan ngc346-05

We now use the same parameters as with plan ngc346-01. For this new plan, we change the default slit shape to a single shutter. We name this plan ngc346-05.

plan ngc346-06

We now use the same parameters as with plan ngc346-01 but add a nod within the slitlet which will create three exposures per pointing. We name this plan ngc346-06.

Users are encouraged to experiment with several configurations in the MPT Planner and then use the MPT Plans pane to asses the quality and completeness of these plans. The "success" of a plan is a function of the spatial distribution of sources in the sky, as well as the properties of the MSA. 

Comparing and assessing plans

We now move onto the Plans pane where we can review plan results

Figure container


Figure title

Figure 5. Selecting Plan ngc346-01 to view in the MPT Plans pane

Figure caption

Plans are selected from the pull-down menu on the left. This view shows the plan ngc346-01 with a scrollable description of the used parameters.



It is interesting to compare the target set size for the 10 configurations in each plan. Table 2 shows this comparison. The number of observed targets does not change much between exposures. However, modifying the shape of the slitlet does increase the number of observed sources as shown with plan ngc346-05. This might be useful in some science cases.

Constraining the centering of sources, also affects the number of sources that are observed. By making the allowed area smaller in each shutter, less sources are observed per configuration as shown with plan ngc346-02.

For proper correction for sky emission, it is advisable to nod in slitlet during the dither setup as we show in the plan ngc346-06. Nodding also increases the number of exposures in which a source is observed.

 

Table 2. Target size in ten configurations for each plan

ConfigurationPlan name (ngc346-)
 010203040506
c0e06660696416267
c1e06559676516466
c2e06266676015964
c3e06367676315964
c4e06961696716466
c5e06860686616465
c6e06863686515564
c7e07162686515864
c8e06558646416067
c9e06459656216069


Table 3 compares the number of targets that are in at least one exposure classified according to source type: primary, filler, contaminants, and all targets. These plans have many primary targets observed because the input catalog has a high density (sources per square arcmin). This table is representative of the multiplexing results that can be achieved in this region. Plan number 5 has much higher multiplexing because a single shutter per observed source is used (see description of plan cases above). Figure 6 shows the coverage associated with plan ngc346-06.

 

Table 3. Number of targets in at least one exposure in the 10 MSA configurations for all six generated plans

Target TypePlan Name (ngc346-)
 010203040506
Primary277228290274641278
Filler3564223115630
All targets330319337324806358
Contaminants263028252453


Figure container


Figure title

Figure 6. Number of targets as a function of number of exposures

Figure caption

This histogram from plan ngc346-06 shows that most targets (~300) are observed in six exposures. A few of them were even observed in twelve exposures.


Aladin is the visualization tool used in MPT. In Figure 7 we display the observed sources from two plans in order to check for differences. It is always useful to display the finder image as one of the Aladin planes.

Figure container


Figure title

Figure 7. Aladin view of sources

Figure caption

This Aladin window is showing the targets observed in at least one exposure comparing the output from plans ng346-01 (red crosses) and 02 (blue circles). The HST image used as background is a mosaic of nine F555W images.


Another useful way of assessing the quality of the plans is by looking at sources in the shutter view. Figure 8 shows an example of this type of view for plan ngc346-01 configuration c0e0.

Figure container


Figure title

Figure 8. Shutter view of configuration c0e0 from plan ngc346-01

Figure caption

This shutter view allows observers to zoom into the shutter level and see how sources fit in the MSA configuration. We refer the reader to Tables 1 and 2 in the article NIRSpec MPT: Plans for a complete description of the meaning of symbols and their colors.


It is also possible to visualize the sources for a given configuration and the shutters used to observe them as two superimposed planes on Aladin as well. Figure 9 shows this view. 

Figure container


Figure title

Figure 9. Visualizing slitlets in Aladin

Figure caption

The targets observed in at least one exposure comparing the output from plans ng346-01 (red crosses) and 02 (blue circles) are shown in the Aladin window. The slitlets are shown for configuration c0e0. We zoom into a small group of sources to show the green three-shutter slitlets in more detail.


Creating an observation

We assume that plan ngc346-06 is the best for our science goal and so we use it to create a placeholder observation to be submitted with our proposal. In the Plans pane, we select this plan and click on the 'Create Observation' button. This populates the fields in the observation template. The visits are located in the Tree Editor inside the Observation Folder. Four visits were created as shown in Figure 10.

Figure container


Figure title

Figure 10. Visits are created for plan ngc346-06

Figure caption

The Visit Planner view in the MSA Planning Tool.


At the bottom of the 'Visit Planner' view there are three buttons: 'Update Display', 'Reports' , and 'Print'.

Once we update the display, APT will study the availability of the observations and try to schedule the visits. In our example, APT was able to schedule these observations in September 2019. Three reports are available for each visit: namely: the 'Guide Star Availability Analysis for Visit', the 'Sun Roll Analysis for Visit', and the 'Total Roll Analysis for Visit'. 

As an example of the graphical output, Figure 11 shows the Sun Roll Analysis.

Figure container


Figure title

Figure 11. Sun roll analysis

Figure caption

The Reports button at the bottom of the Visit Planner view in APT gives access to three reports per visit. Here is the 'Sun Roll Analysis' for Visit 2:1 in our NGC 346 example.


APT File

The APT file containing the plans described above can be found in the link below. 

Example APT file. This is the APT file used to demonstrate the complete example in this article.


Warning

This science use case example was generated using APT version 25.2.3. You may encounter some differences in the user interface if you load the file in the latest version of APT.

 


Anchor
etc-ngc346
etc-ngc346
ETC step-by-step instructions

The signal to noise calculations are performed using the JWST Exposure Time Calculator. For this science case, we provide a few examples to illustrate how to define sources of interest similar to the ones in Figure 2.

Scene and Sources

From Figure 2, we select two sources: a pre-main sequence source with magnitude 24 mag in the F555W band and a red giant star with F555W = 20 mag. We model these sources with Phoenix Stellar Models in the Source Editor by selecting models "M0V 3750 4.5" and "K5III 4000 1.5". Among other possibilities, users can use a black body spectral energy distribution, or upload their own flux density file. 

Here we illustrate the example of the red giant star. Figure 12 shows the ETC Scenes and Sources tab where the Continuum is defined. For the normalization, we assume that this source has a Johnson V magnitude of 20 mag (Figure 13). The plot at the bottom shows the spectrum of the source.

Figure container


Figure title

Figure 12. Designing a scene

Figure caption

The Source view in the source editor. For this example we assume no extinction. The plot at the bottom represents the source spectrum and a simple representation of the scene.



Figure container


Figure title

Figure 13. Flux density normalization

Figure caption

Normalizing the source flux density.


Calculations

Under the Calculations tab, the user can set the background, the instrument, the detector, and the observing strategy. For the background we use a Medium (the default value), under instrument setup (Figure 14)  we select as an example a calculation using the high resolution grating  G140H, and NIRSpec filter F070LP with a wavelength range of 0.7 to  -1.27 μm. We keep the same slitlet shape as the one used in APT: 3 shutters. See below for a discussion of the MSA Location selection.   

Figure container


Figure title

Figure 14. Instrument setup

Figure caption

Setting up the instrument within ETC. The plot shows the NIRSpec throughput for the selected grating filter combination, in this case G140H/F070LP.


For the Detector setup we use a NRSIRS2 readout pattern, 10 groups , 2 integrations, and one exposure as an example. This leads to a total exposure time of ~14 minutes as shown in Figure 15. In this example, these values were selected so that the bright (20 mag) giant source will not saturate in the requested total exposure time.

Tip

The number of groups and integrations should be set based on the desired signal to noise and total exposure time. Saturation of bright sources should always be avoided. It is always important to check for warnings in the ETC reports.


Figure container


Figure title

Figure 15. Detector Setup

Figure caption

Detector Setup view. Here the user selects the readout pattern of the detector, the number of groups, integrations, and exposures to be performed. The total exposure time is automatically calculated and shown in the boxes highlighted in blue.


Once those parameters have been selected, we perform a calculation and obtain a signal-to-noise ratio (SNR) of 51.44 as shown in Figure 16.

Figure container


Figure title

Figure 16. Calculation results

Figure caption

The results of the calculation is provided in the shape of graphics and reports of values. This particular screen grab corresponds to a slitlet located in the center of Quadrant 4.


Measured Flux as a function of MSA quadrant

The 4 MSA quadrants are physically separated and the gaps between them block out the light from the source. This affects part of the source spectrum, specially when using high resolution gratings. Figure 17 shows the extracted flux from the source, assuming that the slitlet was placed in the center of each MSA quadrant (Q1, Q2, Q3, and Q4).

Figure container


Figure title

Figure 17. Extracted source flux

Figure caption

The extracted source flux is a function of the position of the slitlet in the MSA. The presence of a gap between quadrants is reflected in the spectrum as a box where the flux drops to zero. This figure shows the flux from the same source when the slitlet is placed in the center of quadrants 1, 2, 3, and 4.The position of the gap is a function of the grating/filter combination used in the calculation.


Extinction laws comparison

Under the Continuum tab in the Scene and Sources section of the ETC it is possible to assign and extinction law and magnitude for the sources defined within the scene. Here we calculate the signal to noise for a variety of cases that may be useful for the NGC 346 study. Figure 18 shows the available Extinction Laws provided by the ETC. Although NGC 346 is in the SMC, we will compare calculation results for the following extinction laws: LMC Average, LMC 30 Dor, and SMC Bar, with a range of extinction magnitudes in the V bandpass. Table 4 present the results of the calculations.

Figure container


Figure title

Figure 18. Extinction laws

Figure caption

 



Table 4. Extinction law comparison 

SED modelNormalizationGroups / integrations / exposuresExtinction lawExtinction magnitudeSNR
K5III 4000 1.5
     
V = 20 Vegamag10 / 2 / 1LMC Average051.44
169.05
2 90.96
LMC 30 Dor051.44
169.08
2 91.04
SMC Bar051.44
168.54
289.76
M0V 3750 4.5V = 24 Vegamag10 / 2 / 4LMC Average011.52
118.42
228.14
LMC 30 Dor011.52
118.44
228.17
SMC Bar 011.52
1  18.21
227.57

 

The SNR values fall in the same range for a given extinction magnitude, regardless of the chosen extinction law. Note the increase in the number of exposures in the case of the source with spectral type M0. This number was increased in order to obtain a SNR larger than 10 and it is just for demonstration purpose.

 


 


Content Block
overflowauto
nameReferences
id281944791
classpdf-full

Anchor
ref
ref
References

Gouliermis, D. A., et al. 2006  ApJ, 166, 549 

The star-forming region NGC 346 in the Small Magellanic Cloud with Hubble Space Telescope ACS observations. I. Photometry.

Kozhurina-Platais, V., et al.  STScI-ISR ACS 2015-06 

ACS/WFC Revised Geometric Distortion for DrizzlePac

Kozhurina-Platais, V., et al.  STScI-ISR WFC 2015-02 

Standard Astrometric Catalog and Stability of WFC3/UVIS Geometric Distortion

Nota, A. GO Program 10248
Current star formation in young, compact clusters in the Small Magellanic Cloud





Content Block
overflowauto
nameIcon
id278719485
classpdf-hide

Multiexcerpt include
MultiExcerptNameNIRSpec icon and Name
PageWithExcerptMR:NIRSpec icon and name


Content Block
overflowauto
nameUpdates
id1066359141
classpdf-hide


HTML Wrap
padding0
margin0
idupdatesbox


HTML Wrap
tagspan
classupdatesbox-heading

Last updated

Published October 4, 2017


 

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 5, 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 2, 2017