TSL Examples

New and current examples (as of 2023)

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.
   • Example 1a - Two actions in the same track
   • Example 1b - Using efficient COMMON blocks
   • Example 1c - Simplify with ACTION_LIST
   • Example 1d - Using implied defaults
   • Example 1e - Single string instrument configurations (old format)
   • Example 1f - Human readable values for GASCELL
   
   
2. Subsequent visits for a planet search program.
   • Example 2a - 1 action per track, multiple tracks
   • Example 2b - Using a TRACK_LIST
   • Example 2c - Single string instrument configurations (old format)
   
   
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
   • Example 5
   
   
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
   • Example 7 - a GROUP block of type POOL
   
   
8. Provide a S/N goal, with a baseline exposure time
   • Example 8 - the SNWAVE keyword
   
   
9. Non-standard instrument configurations for special cases
   • Example 9 - the FILTER keyword
   
   
10. Specifiy a URL for a web-accessible finder chart (shared risk)
    • Example 10a - the PICHART keyword
    • Example 10b - Multiple charts