Use Case: Observing Preparation: Set Up to Observe a Multi-Field mosaic, Multiple Line Project.

This ObsPrep usage scenario is based on the SSR Use Case 4.7.2 (Setup Multi-Field) from the SSR memo 11 (ALMA-SW-0011). It should not be considered as a replacement of the UCs in the SSR Memo 11. It has been developed to aid in testing the ability of the design of the OT to support the specific case of the described observation setup.

Goal:   Define a program using the ALMA observing tool for a multi-field mosaic, dual spectral line program.

Contact Authors:   D. Shepherd & L. Testi

Role(s)/Actor(s):
Primary:   The observer (follows the basic course for this UseCase)
Secondaries:  
  Observing Preparation Tool
  Spectral Line Catalogs
  Source Catalogues and Databases
  DSS/2MASS Image Library
  Local User Resources (Position Catalog of sources & images of 6 cm emission)

Priority:   Critical

Performance:   Response to user inputs in near real time.

Frequency of Use:   Perform this ObsPrep Use Case for each multi-field, multi-spectral line imaging experiment that has been approved by the TAC for ALMA observations.

Preconditions:

1. Proposal written by PI and submitted to ALMA TAC.
2. Project approved by the TAC for ALMA observations and ready for phase 2.
3. Project goals and constraint are:
   Primary Science Goal:
   Image a molecular outflow in three spectral lines (12CO(J=2-1), 13CO(J=2-1), & C18O(J=2-1) and in the nearby continuum to get SED of driving source between 230 & 219 GHz. Mosaic must be sensitive to size scales between 1" and 60" in an outflow. The aims are to recover all emission in the flow in the CO isotopes to estimate optical depth and energetics, and trace high velocity emission to specific regions.
   Secondary Science Goal:
   Image, at a suitable spectral resolution, other interesting lines that may be observed with the main target lines if this does not degrade too much the continuum sensitivity.
   Primary Science Constraints:
   - Spatial Resolution <= 1 arcsec (2000 AU @ 2kpc).
   - Spectral Resolution <= 0.6 km/s (to resolve the velocity pattern).
   - Range of Spatial Scales = 1 to 60 arcsec.
   - Line RMS <= 10 mJy/beam/channel (to find faint, high velocity features).
   - Continuum RMS <= 0.03 mJy/beam
   

Basic Course:   Set up for Observations (User steps and OT responses)

NOTE: All steps in the Basic Course should be able to be saved in the micro-archive or as stand-alone disk file these can be saved & reloaded for later processing and/or share between different Co-I (e.g. via e-mail exchange).

1. Select Project Type:
   Choose Standard Imaging; Spectroscopy
   
2. Select Target & Velocity: 
•  Source Name [found by SIMBAD and coordinates presented] and/or enter name and coordinates manually [Galactic or Equitoral 1950/2000]
• Specify velocity and velocity system.
  
3. Select the Lines:
   Use one or more selection methods:
   
   • Name
   •  Catalog
   • Pull-down-menu
   •  Frequency/Wavelength
4. Define Area to be mapped
   
• Specify size of the mosaic (not necessarily) centered on coordinates:
  15 x 15 arcminutes.
• Selecting one of the TA shapes as defined by the SSR (circle, ellipse, rect, polygon)
• Entering parameters of TA either via text editor or usign the Visual Editor (and mouse), this latter option is really useful only when displaying some image on the Visual Editor.
  
• Specify optimal sampling of fields (just less than Nyquist sampling) or user-supplied sample spacing. OT should provide a warning if user-supplied sample spacing is less than optimal and an estimation of image degradation due to sampling.
5. View the mosaic field displayed on a DSS/2MASS if available. Also view the mosaic against a 6cm continuum image supplied from the user's local directory (supplied image will be in fits format).
   OT provides proposed layout of fields overlayed on images (DSS/2MASS/VLA) and shows primary beam on the images.
6. The user may want to refine the central pointing position using either the Visual Editor (e.g. click/drag with the mouse) or by changing the coordinates. If so, the entire mosaic will shift in position.
7. Enter Spatial Resolution and Range of Scales:
   The OT should give feedback on whether one array configuration is enough and whether ACA/TP measurements are required to cover the max scale range of the mosaic. The user should be able to change the parameters and have immediate feedback. Multi-field/ACA/TP should be needed for this mosaic.
8. Enter Resolution/Bandwidth for each line:
   The OT should provide a warning if more than one correlator setup is required to match the desired bandwidth at the requested resolution.
   The OT provides feedback: total bandwidth of the spectral window at the selected resolution.
   All other correlator bands are set to continuum observations with maximum bandwidth.
9. Enter Required RMS desired in Line or Continuum:
   The OT provides feedback on the total on-source time required and displays the corresponding RMS in the other case (continuum if one specifies line and vice-versa), it should be possible to change which of the two the user sets, reset the value and get immediate feedback.
10. Set Up the Correlator with the following steps:
    • The OT shows a template spectrum around the selected lines. It should be possible to switch between the "Orion hot core" template and/or other astronomical templates, a schematic view based on a line list, and a user spectrum (ASCII file with nu and intensities, can be theoretical or observed).
    • The user zooms in on the line of interest with a click, adjusts the band center to cover all the line components that the user can/wish given the available bandwidth of the spectral window.
    • The user zooms out for other possible lines of interest.
    • The user adjusts LO freq in order to cover the lines of interest.
      Note: The primary line can slip out of the originally selected correlator window domain and into another correlator window. The OT should be sure that the line is covered and not allow the user to select an LO frequency that prevents the observation of the primary line. The OT should be able to switch between correlator bands to ensure that the line is always covered with the required bandwidth/resolution.
    • The user should be able to zoom in on lines of interest and modify correlator bands to set resolution and bandwidth for these. The OT should update the continuum sensitivity for the bands that are subtracted from continuum to observe lines and should show the expected sensitivity in the "new" spectral bands in the given amount of integration time.
    • Low Priority: The user may want to select as "bad" some ranges (channels) of the continuum bands in order to avoid strong lines in the pipeline processed continuum image.
11. The user reviews the default calibration choices:
    • The OT can be required to show the calibration choices (calibrator, calibration options, integration times, duration of observing cycles, etc...).
    • The advanced user can change the (allowed) parameters and receive warnings/feedback on the expected calibration accuracy.
12. Required Feedback (TDB on where and when this feedback should be provided to the user):
    • Beam information (expected beam ellipticity and axes)
    • Total duration
    • Weather constraints - stringency and likelihood to achieve
    • Configurations required - availability and timescales
    • Warnings related to data quality (due to calibration scheme chosen)
    • Map sizes, data rate, total data volume
    • Scheduling Block breakdown

Postconditions:

1. User saves the observing setup on their local machine. It should be possible to save the project in the OT local micro-Archive or as an external file to share the work with other CoIs (via e-mail). The actual scheduling blocks (SBs) should also be saved to the local directory if desired by the user. Note: the 'saved file' for the OT and the SBs can be the same thing.
2. The user requests that the programme and associated SBs are validated.
3. If validated, User submits the complete programme and associated SBs from OT.

Issues to be Determined or Resolved:   Required feedback listed in point 10. of the Basic Course above.

Notes:   The relevant UCs from SSR Memo 11 are: 4.1 (Observe with ALMA), 4.2.1 (Create Observing Program), 4.2.2 (Create Observing Proposal), 4.2.3 (Validate Observing Program), 4.2.6 (Create Scheduling Blocks), 4.2.8 (Submit Scheduling Blocks), and for the specific observing mode described above: 4.7.2 (Setup Multi-Field).

Last modified: 08jul03