hydra.asutexas.edu

 


 


 




 

TSL Examples

TSL Examples

New and current examples (as of 2023)

  1. HPF observations:
    • Example 18a - three HPF targets with different setups and comparison lamp requests
    • Example 18b - one HPF target with a synoptic frequency constraint


  2. LRS2 observations
    • Example 19a - three targets with LRS2-B
    • Example 19b - two targets observed in SEQ groups with LRS2-B and LRS2-R
    • Note that we strongly discourage the use of multiple exposures per visit with LRS2 (e.g., do not use CRSPLIT)


  3. VIRUS observations
    • Example 20a - three galaxies observed on a specific VIRUS IFU at different priorities
    • Example 20b - six fields to be observed in a HETDEX-like way, with OCD and PIPRI ranking
    • See also this page for TSL keywords associated with VIRUS mapping observations



 







Old examples which may or may not still function as expected:

  1. Simple LRS2 examples
    • Example 11a - Observing a single target with LRS2-B, with automatic determination of proper motion
    • Example 11b - Observing a list of targets for LRS2-R (automatic proper motion)
    • Example 11c - Observing a list of targets for LRS2-R, all with zero proper motion.
    • Example 11d - Observing a list of targets for LRS2-R, with varying proper motion.

  2. Examples using both LRS2-B and LRS2-R in the same track.
    • Example 12a - Using a sequence group to take an LRS2-B exposure then an LRS2-R exposure in a single track
    • Example 12b - Using a sequence group to take an LRS2-B exposure then an LRS2-R exposure in a single track for a list of different targets.
    • Example 12c - Using a sequence group to take an LRS2-B exposure, an LRS2-R exposure in a single track and then moving to an offset position for a sky exposure for a list of different targets. Note that LRS2 exposes both LRS2-B and LRS2-R at the same time so for most cases nodding back and forth between them provides sufficient sky. This example should only be used for targets with very extended backgrounds (> 100").

  3. Examples using other types of groups
    • Example 13a - Request a specific standard star to be observed on the same night as the primary science target. This uses an AND group.
    • Example 13b - Using a POOL group to link East and West tracks so you only do either the East or the West. This uses an POOL group. This can be useful if the East and West tracks are different setups.

  4. Examples using synoptic and phase blocking key words
    • Example 14a - an example of an object we want to fill the phase for, ie. we want exposures every 10th of a phase except around 0.5 and 0.0.
    • Example 14b - A slightly different example of an object we want to fill the phase for, ie. we want exposures every 10th of a phase except around 0.5 and 0.0.
    • Example 14c - An example of an object we want 1 visit in one of two possible phase range pairs for 5 different pairs.
    • Example 14d - An example of an object we want to observe in nearly any phase except for a some avoided phase(s). In this case we don't want to observe near phase 0 or 0.5, or more specifically we don't want to observe near 0.95-0.05 or 0.45-0.55.









Even older examples with the old instruments and tracker


  1. A simplified first visit for a planet program.
  2. Subsequent visits for a planet search program.
  3. Specifying targets with TRACK/TRACK_LIST and ACTION/ACTION LIST
    • Example 3a - Single target with GASCELL in and GASCELL out exposures
    • Example 3b - Two exposures in a single TRACK
    • Example 3c - Multiple tracks, multiple actions per track
    • Example 3d - Multiple sets of multiple tracks, with multiple actions per track

  4. Non-standard calibration requests
    • Example 4a - Explicit keyword STDCALS, Th-Ar lamps (THAR), flat field (FF)
    • Example 4b - Calibration frame within a TRACK
    • Example 4c - Add a radial velocity (RV) standard of 2 or better at end of any night with specified target
    • Example 4d - EXTRACALS keyword
    • Example 4e - Specify number and exposure time of end-of-night calibration frames
    • Example 4f - EXTRACALS for each target
    • Example 4g - Leave EXTRACALS exposure time to RA discretion

  5. Observations with two instruments in a single track
  6. Request a specific standard star be observed on the same night as the primary science target
    • Example 6a - Using a GROUP block of type AND
    • Example 6b - Standard immediately follows primary target - a GROUP block of type SEQ
    • Example 6c - Multiple targets matched to specific standards on the same night - a GROUP block of type AND
    • Example 6d - Multiple targets with associated callibrations immediately following primary targets - GROUP block of type SEQ
    • Example 6e - Add a standard on the same night, as multiple targets with associated callibrations in sequence
    • Example 6f - Order tracks possibly observed on different nights - GROUP block of type ORD
    • Example 6g - Conveniently add GROUP specifications to a TRACK_LIST

  7. Specify a list of 10 targets from which 3 need to be completed
  8. Provide a S/N goal, with a baseline exposure time
  9. Non-standard instrument configurations for special cases
  10. Specifiy a URL for a web-accessible finder chart (shared risk)





Last updated: Sat, 30 Dec 2023 04:58:40 +0000 stevenj



Phase II

Phase II Information for New Users

TSL

Language Structure

Language Syntax

Examples

Keyword Table

Keyword Descriptions

Collecting Efficiency

TSL Control of Calibrations

Program Notes

Finding Charts

Synoptic Targets

Phase Blocking in TSL

Synoptic Date Block

Phase II Management