Observation requests for Lesedi+Mookodi

If you have been allocated queue-scheduled time on Lesedi, you will need to submit observation requests via the SAAO Observatory Control System (OCS).  Note that you need to have accepted the time allocation first, as instructed in the email informing you that your telescope time application was successful. This is done on the Accept a Proposal page on the SAAO website, where you will be prompted to log in with your Observer Portal credentials, then click the link again.

You will need to create an account on the OCS by submitting the registration form. You should then send an email to Ramotholo Sefako informing him of your username, so that he can link your telescope time to your OCS account. 

Once your account has been activated, you can sign in at the OCS login page.

To submit an observation to the queue, click “Submit Observation” in the top left of the landing page, which will present you with the form to fill in. The first two sections - RequestGroup and Request - can be explained for all types of observations. Beyond that, there are recipes to follow for different types of observations.

Note that while we use the OCS developed by Las Cumbres Observatory (LCO), not all of the options available on the submission form have been implemented. If you are familiar with the LCO OCS, you will notice some differences in the functionality here.

RequestGroup

The first section of the observation request form should look like the image below. Note that you can toggle between the form, the API view and a list of Drafts using the buttons in the panel along the top. You can save a draft any time using the blue button to the right, then load it from the Drafts tab at the top. In this way you can abandon a partially completed submission. It is also particularly useful to save a completed form as a draft once you're happy with it, so that you can load it later to use as a template for future observation requests.

The options for a RequestGroup are as follows:

• Name: Give your request an identifier that is appropriate for your target/proposal/observation type.  This is only for your purposes and need not take a specific format, but you should be able to recognise it in a list of all users’ request groups.

• Proposal: Your proposals that have time allocated to them will be available in the dropdown list.  Select the appropriate proposal for your observation.  If there is nothing in the list and you have accepted your proposal and registered as instructed above, contact Ramotholo Sefako.

• Type: The options are:

1. Queue scheduled: this is a “normal” observation that can be made by the queue when it is feasible to do so, when the other parameters of your request are met.
2. Time critical: if your observation is time sensitive (e.g. a transit, eclipse, etc.), you can specify a window within which it must be executed.  Note that your proposal will need to have been approved as time critical, and have time critical hours allocated to it in order for this to work.
3. Rapid response: this is for observations that need to be triggered as soon as possible, and will interrupt the scheduled queue (but not an observation in progress).  Again, you will need rapid response hours allocated to your proposal to successfully use this option.

• IPP Factor: Intra/Inter Proposal Priority factor.  This will largely be of interest if you would like to prioritise different observations within your proposal; you would give a larger number to a higher priority observation.  Values must be between 0.5 and 2.  If you’re happy for all your observations to have equal priority, stick with the default value of 1.05.  This is a very basic summary, the full explanation of IPP can be found here.

Request

• Acceptability Threshold: Here you would specify the percentage of the request that would need to be done in order for you to accept it as having been completed.  E.g. if you requested 10 exposures and only 9 were taken, the default of 90% would accept this as complete.  Had you specified 100%, the observation would be rescheduled and that time would be deducted from your allocation.

• Configuration Repeats: This must be 1.

• Optimization Type: The options are:

1. Time: favours scheduling the observation earlier in the observing window. Use this option as the default, especially as you can apply an airmass constraint in a later section. Definitely select this for time-critical observations.
2. Airmass: will aim to observe the target at lower airmass.  Note that specifying this results in a slightly lower chance of the request being observed if the queue is full. 

• Mosaic: This has not been commissioned with Lesedi+Mookodi, so should be left as None.

This recipe describes the Configuration and Instrument Configuration options for Mookodi's imaging mode.

Configuration: single filter imaging

• Instrument Category: IMAGE
• Instrument: 1M0a_Mookodi-Img
• Guide Mode: For single short exposures (~60s) guiding isn’t necessary (Off), but for longer exposures, or multiple short exposures, it is advisable to use the autoguider (On). The "optional" tick box is not implemented so you can ignore it.
• Type: Choose Expose here.  Other applicable options are Bias and Sky_flat, but these are taken automatically on a regular basis, so you will have access to them without observing them as part of your proposal.
• Acquire Mode: The options are as follows, where AcN stands for "acquire nearest star" and "Acq" means to "acquire RA & Dec":

1. AcN:OFF&Acq:OFF: this option simply points the telescope and starts the observation without making any pointing adjustments. In other words, you are reliant on the telescope's pointing accuracy.
2. AcN:OFF&Acq:ON: this option will centre the requested coordinates on the centre of the CCD. This is a good default option, but should definitely be used if (i) you have entered the coordinates of a space between stars, e.g. to fit both an target and a comparison star in the field; (ii) the field is crowded; and (iii) the target wouldn't be visible in a four second acquisition image.
3. AcN:ON&Acq:ON: this option first centres the specified coordinates on the centre of the CCD, then adjusts the pointing to recentre on the brightest star found within a 3 arcsec search area around that position. This is useful for transients which may not have such accurate coordinates.

• Dither: Select None as this is not commissioned on Lesedi+Mookodi.

Instrument Configuration: single filter imaging

For a single filter, you will only need one instrument configuration.

• Exposure Count: Enter the number of consecutive images to take with this instrument configuration and the specified Exposure Time.
• Readout Mode: The options are 1x1HighFastOpen, 1x1HighFastAuto, 1x1HighSlowAuto, 2x2HighFastAuto with the format Binning_Gain_Readout_Shutter and the following definitions:

1. Binning: 1x1 (platescale 0.59 arcsec/pix) or 2x2 (1.18 arcsec/pix)
2. Gain: High (for faint targets) or Low (bright targets)
3. Readout rate: Fast (5 MHz - read noise 13.6 electrons) or Slow (0.05 MHz read noise 3.3 electrons)
4. Shutter: Open must be selected for multiple exposures <60 seconds (time series will therefore typically be 1x1HighFastOpen).  Otherwise Auto for longer exposures.

• Filter: Mookodi has two filter magazines, which the OCS calls Filter and Obfilter (below).  There needs to be one filter – and only one filter – in the beam at any time, so you need to select one from one of the two magazines.  In this box you can select an SDSS filter.  If you want to use a clear filter, it is in the next field, so select OUT here.
• Obfilter: If you have selected an SDSS filter in the Filter option, select OUT here.  Otherwise select Clear.  Do not select OrdBlk_Fltr - this is for spectroscopy.
• Slit: must be OUT.
• Grism: must be OUT.
• Offset RA/Dec: this is not implemented so should be left blank.

If you would like to cycle repeatedly through multiple filters, you can do that by specifying multiple Instrument Configurations (one per filter) and selecting the REPEAT_EXPOSE optio, as described below.

Configuration: multiple filter cycling

• Instrument Category: IMAGE
• Instrument: 1M0a_Mookodi-Img
• Guide Mode: For single short exposures (~60s) guiding isn’t necessary (Off), but for longer exposures, or multiple short exposures, it is advisable to use the autoguider (On). The "optional" tick box is not implemented so you can ignore it.
• Type: Choose REPEAT_EXPOSE and a box will appear requesting a duration. In this example, your instrument configurations (filters) will be repeated in turn for two hours. (Do not use REPEAT_EXPOSE to take multiple images in only one filter as it will add a short delay between exposures - for single filter runs rather specify the number of images in Instrument Configuration Exposure Count.)

Other applicable options are Bias and Sky_flat, but these are taken automatically on a regular basis, so you will have access to them without observing them as part of your proposal.

• Acquire Mode: The options are as follows, where AcN stands for "acquire nearest star" and "Acq" means to "acquire RA & Dec":

1. AcN:OFF&Acq:OFF: this option simply points the telescope and starts the observation without making any pointing adjustments. In other words, you are reliant on the telescope's pointing accuracy.
2. AcN:OFF&Acq:ON: this option will centre the requested coordinates on the centre of the CCD. This is a good default option, but should definitely be used if (i) you have entered the coordinates of a space between stars, e.g. to fit both an target and a comparison star in the field; (ii) the field is crowded; and (iii) the target wouldn't be visible in a four second acquisition image.
3. AcN:ON&Acq:ON: this option first centres the specified coordinates on the centre of the CCD, then adjusts the pointing to recentre on the brightest star found within a 3 arcsec search area around that position. This is useful for transients which may not have such accurate coordinates.

• Dither: Select None as this is not commissioned on Lesedi+Mookodi.

Instrument Configuration: multiple filter cycling

For a multiple filters, you will need one instrument configuration per required filter, then use the REPEAT_EXPOSE function to cycle through those filters in turn.

• Exposure Count: Enter 1 here to take one exposure in each filter before moving on to the next filter.
• Readout Mode: The options are 1x1HighFastOpen, 1x1HighFastAuto, 1x1HighSlowAuto, 2x2HighFastAuto with the format Binning_Gain_Readout_Shutter and the following definitions:

1. Binning: 1x1 (platescale 0.59 arcsec/pix) or 2x2 (1.18 arcsec/pix)
2. Gain: High (for faint targets) or Low (bright targets)
3. Readout rate: Fast (5 MHz - read noise 13.6 electrons) or Slow (0.05 MHz read noise 3.3 electrons)
4. Shutter: Open must be selected for multiple exposures <60 seconds (time series will therefore typically be 1x1HighFastOpen).  Otherwise Auto for longer exposures.

• Filter: Mookodi has two filter magazines, which the OCS calls Filter and Obfilter (below).  There needs to be one filter – and only one filter – in the beam at any time, so you need to select one from one of the two magazines.  In this box you can select an SDSS filter.  If you want to use a clear filter, it is in the next field, so select OUT here.
• Obfilter: If you have selected an SDSS filter in the Filter option, select OUT here.  Otherwise select Clear.  Do not select OrdBlk_Fltr - this is for spectroscopy.
• Slit: must be OUT.
• Grism: must be OUT.
• Offset RA/Dec: this is not implemented so should be left blank.

Assuming the only change you wish to make between exposures is the filter, it's easiest to complete one Instrument Configuration, then click on the green "copy" icon in the section title bar to add another pre-populated Instrument Configuration for as many filters as you need, then edit the Filter or Obfilter field as appropriate. This example will continuously cycle 20s in g', then 25s in r' for 7200s.

Being an imaging spectrograph, Mookodi has two different Configurations in the OCS. Instrument Category SPECTRA makes specific spectroscopic functions available.

Configuration: spectroscopy

• Instrument Category: SPECTRA
• Instrument: 1M0a_Mookodi_Spec
• Guide Mode: Always select On for spectroscopy to prevent the target from drifting off the slit.
• Type: Choose Expose here.  An arc lamp spectrum is automatically taken after each science spectrum, so there’s no need to make a configuration using Arc_lamp.  Other applicable options are Bias, Sky_flat and Standard, but these are taken automatically on a regular basis, so you will have access to them without observing them as part of your proposal.
• Acquire Mode: The options are as follows, where AcN stands for "acquire nearest star" and "Acq" means to "acquire RA & Dec":

1. AcN:OFF&Acq:OFF: do not use this for spectroscopy, the target will not land on the slit.
2. AcN:OFF&Acq:ON: this option will centre the requested coordinates on the centre of the CCD. This should be used if the field is crowded and/or the target wouldn't be visible in a four second acquisition image.
3. AcN:ON&Acq:ON: this option first centres the specified coordinates on the centre of the CCD, then adjusts the pointing to recentre on the brightest star found within a 3 arcsec search area around that position. This is useful for transients which may not have such accurate coordinates.

• Dither: Select None as this is not commissioned on Lesedi+Mookodi.

Instrument Configuration: spectroscopy

• Exposure Count: Enter the number of consecutive images to take with this instrument configuration and the specified Exposure Time.
• Readout Mode: The options are 1x1HighFastAuto or 1x1HighSlowAuto with the format Binning_Gain_Readout_Shutter and the following definitions:

1. Binning: 1x1 (platescale 0.59 arcsec/pix)
2. Gain: High (for faint targets)
3. Readout rate: Fast (5 MHz - read noise 13.6 electrons) or Slow (0.05 MHz read noise 3.3 electrons)
4. Shutter: Auto triggers automatically between exposures.

• Filter: Select OUT for spectroscopy.
• Obfilter: Select OrdBlk_Fltr for spectroscopy.
• Slit: There are two options for slit width - corresponding resolutions can be found on the Mookodi wiki:

1. mk-narrow (2 arcsec)
2. mk-wide (4 arcsec)

• Grism: must be IN for spectroscopy.
• Offset RA/Dec: this is not implemented so should be left blank.

Target

You can add one target per Configuration.

• Name: Enter the target name.  Any format is allowed by the form, but ideally it should be searchable in the data archive.  
• Type: Options are:

1. Sidereal

For sidereal objects, you will enter the target coordinates and epoch. The format for RA and Dec is flexible - you can enter sexagesimal with either space (HH MM SS.SS -DD MM SS.SS) or colon delimiters (HH:MM:SS.SS -DD:MM:SS.SS), or decimal degrees (ddd.ddddddd -dd.ddddddd). Whichever format you use is converted to the other by the form, so you can double check. The fields for proper motion and parallax aren't implemented, so leave them blank.

1. Non-sidereal

If your target moves at a non-sidereal rate, specify it here to add orbital elements to enable your target’s coordinates to be determined at the time the observation starts.  Note that if your Instrument Category is set to SPECTRA, this option will automatically activate non-sidereal tracking, but not for imaging.  If your imaging target moves slowly enough (and your exposures are short enough) that you’re happy to have it move across a stationary field, select sidereal, otherwise see the section for non-sidereal tracking in imaging mode.

The only option currently available for non-sidereal targets is for asteroids, and requests parameters in the following units/formats:

• Scheme: the only option implemented at this stage is MPC Minor Planet.
• Epoch of the elements (format as a Modified Julian Date (MJD))
• Orbital Inclination (in degrees)
• Longitude of Ascending Node (in degrees)
• Argument of Perihelion (in degrees)
• Eccentricity 
• Semimajor Axis (in AU)
• Mean Anomaly (in degrees)