CRIRES p2 tutorial: NGS AO spectroscopy

The Phase 2 process begins when you receive an email from ESO telling you that the allocation of time for the coming period has finalized and that you can view the results by logging into the User Portal and clicking on "Check the web letters." Note that the username and password that you need to use for the User Portal are the same as those you will use to prepare your OBs.

You follow the instructions given by ESO and find that time was allocated to your run with CRIRES. Therefore, you decide to start preparing your Phase 2 material, which consists of a README file, and one or more OBs equipped with finding charts.

In what follows we will discuss and focuss on concepts that are only specific to CRIRES observations, therefore assuming you have read the p2 documentation and, as such, you are familiar with the general concepts of p2, and its new features.  

Goal of the run

In this tutorial we will prepare an OB for a simple example observing run, consisting of one spectroscopic observation of the young star RU Lup RA(2000)=15:56:42.31, DEC(200)=-37:49:15.47 in the NGS AO mode in a J-band setting.  We will not consider any offset between the Target and the NGS (NGS=Target).

1. Creating and setting up the OB

For the sake of this tutorial, we will use the p2 demo facility, which allows users who do not have their own p2 login data to still use p2 and prepare example OBs (for instance during the Phase 1 preparation to get the overheads right!).  You cannot use it to prepare actual OBs intended to be executed.  When you prepare OBs that should be executed in PARANAL you must use your ESO User Portal credentials to log into the p2 (with http://www.eso.org/p2).

After directing your browser to the p2, and creating an empty new OB under your SM CRIRES run ID by clicking on the OB icon.

Click to see the fullsize image.

You can change the name of the OB by clicking on the "No Name" field between the OB number and the blue box "Exp Time". Here, we changed the name of the OB to AO Spectroscopy.

Click to see the fullsize image.

 

Selecting the right acquisition template

At this point, one can start to set up the observing strategy. After adding a name in the Observing Description Name field, we select the acquisition template "CRIRES_spec_acq_NGS", and click "Add Template".

Click to see the fullsize image.

 

Several parameters of the OB are already set to default values, and should not be changed unless there is a reason for doing that. In particular, for this example the parameters "Target = AO Guide Star" and "SV Guide Star = AO Guide Star" should be left to "yes". Other parameters have to be set, in particular:

  • Derotator Mode (SKY, allowing rotation of the slit to a specific angle, or ELEV, fixing the angle to parallactic), which we set as ELEV to reduce slit losses and since we are not interested in a specific position angle for the observations.
  • Metrology: please select it to "yes" unless you have a specific reason not to do that
  • Entrance slit width (0.2" or 0.4")
  • Reference wavelength (see the various settings here)
For this example we select a slit width of 0.2", and a reference wavelength of 1232.490 nm, which are needed for the science to be done with this observation.

Click to see the fullsize image.

 
The parameters with the information about the magnitude of the NGS or of the SVGS can be set manually, or with the help of ObsPrep. To use ObsPrep, select the tab on p2, move to the "AO Stars" subtab, and select the target. 

Click to see the fullsize image.

This will automatically copy the information from ObsPrep to the acquisition template.

Click to see the fullsize image.

 
NOTE: The R and H-band magnitudes given in ObsPrep are extrapolated from Gaia G-band magnitudes and colours. Especially in the H-band large errors may occur in these converted magnitudes (in particular for very red stars). The user should check the validity of these magnitudes, especially for stars which are close to the magnitude limit for SV guiding.
 
NOTE: if an angle different than parallactic should be used, ObsPrep can help to identify which is the best angle, for example to include two components of a binary system in the slit.

Adding a science template

The science observations are then described by the Science Template. For this example we use the template CRIRES_spec_obs_AutoNodOnSlit, which can be added by selecting it below the Acquisition Template.

Click to see the fullsize image.

Among the various parameters, one should set here the length of the DIT, and the number of DIT to be concatenated (NDIT), as well as the Reference Wavelength of the observations. In this example, we set DIT = 10 s and NDIT = 10. With this setting, according to the CRIRES ETC, we should obtain a S/N=80@1230 nm. We report this information in the Instrument Comments field of the OB.

 

NOTE: the nod throw and other parameters can be set and checked with ObsPrep.  

 

To the top

 

 

2. Target coordinates and Constraint Set

The Target coordinates can be set by clicking on the Target tab, writing the name of the target and pressing the "Resolve" button. This automatically sets the coordinates and proper motion for the target. If the target cannot be resolved, this information can be entered manually.

Click to see the fullsize image.

 

By clicking on to the Constraint Set tab you access the corresponding section, where you will have to provide constraint on airmass, Sky Transparency (i.e., Photometric, Clear, Variable thin cirrus, Variable thick cirrus, the latter not selectable for AO-mode), Lunar Illumination, Image Quality (to be set to 2 for AO observation), Moon Angular Distance, Twilight (min), Turbulence Category and Precipitable Water Vapor (mm).

While defining the OB constraints you should always remember that Phase 2 constraint must agree with Phase 1 request. Details on each specific constraint (i.e., range and meaning) can be found in the general and specific observing conditions pages.

For our example, we will select the following constraints:

Click to see the fullsize image.

 

To the top

3. Additional settings

If needed, time intervals for the observations can be set (e.g., to observe a transit of an exoplanet). Information on this and other steps can be found in this video.

 
The Finding Charts for the OB can then be automatically generated with p2fc, by selecting the "Finding Chart" tab and pressing "Generate Finding Chart".

Click to see the fullsize image.

 

 

Alternatively, you can provide your own-made finding charts (please consult this page to check all the requirements), which you must manually attach to the OB (i.e., click on the "Upload Finding Chart" button you find in the Finding Charts section).

To the top

 

Finishing the preparation: Check, Certify and Notify ESO

With the completion of the standard star OB, we consider the examples developed in this tutorial to be finished. 

Though, for a real run, you would also make sure to:

  1. click the "Check" button (to the right of the Exec. Time button) for each OB.  Check performs consistency checks on the selected OB(s).
  2. click on the Certify" button (to the right of the Check button).  Certify does the same as Check, but additionally (if the check was successful) marks the OB(s) as fully compliant and reaxdy for ESO's review.  It also marks the OB(s) as readonly.
  3. (optionally) select one or more certified OBs and click on the "Revise" button (to the right of the Certify button) to revoke the certified status and allow re-editing.  If this is done it steps 1 and 2 above should be re-done for the OB(s) in question.
  4. complete the information in the README file
  5. click on the "Notify ESO" button (to the right of the Revise button).  This will lock all certified OBs as well as the README, in preparation for ESO's Phase 2 review process.

As mentioned above, all users have access to the p2 demo facility.  And, unlike the situation that existed with p2's predessesor, P2PP3, all OBs are created directly on the ESO database (there is no longer a "check-in" requirement).  Hence, all users can see what you leave behind.  Indeed, after a while, if not properly maintained, the p2 demo runs could and would get cluttered with all manner of OBs, containers, etc.  Thus, as a courtesy to the next user who follows this tutorial, we would like to ask you to finish these exercises by deleting the OBs, containers, etc. that you make.

Finally, please note that when looking at the tutorial run in the p2 demo facility you will see that both OBs are marked as (+) Accepted (see the small screenshot below).  This is a state that these OBs have been set in (by ESO) solely to avoid them being inadvertently deleted from p2.

Access to the final OB

By logging into the p2 demo, under the programme ID 60.A-9253(K) you can access to the USD-Tutorials folder where this OB have been created and stored. In the same folder you can also find a sample of OBs designed for different modes and observing strategy. The example OBs are not editable but can be exported if needed. We kindly ask you to please refrain from creating new OBs in the USD-Tutorials folder.

In the folder, you will also find an example of how to concatenate this OB with the observation of a telluric standard star.

 




Instrument selector