Changes
/* Operating Mookodi */
Mookodi is a low resolution spectrograph and imager, designed to be operated fully robotically. It was designed and built by Liverpool John Moores University (LJMU), and installed on the Lesedi telescope in December 2021 and . It will undergo a period of science commissioning and 'high risk' observations during the first trimester of 2022, with the ability to do spectroscopy and low-cadence imaging.
== Instrument Description ==
=== Description Specifications === *'''Camera''': [[Media:Andor iKon-M 934 Specifications.pdf|Andor DU934P]] deep depletion camera, 1024 × 1024 CCD, 13 μm pixels ([[Media:Mookodi iKon test.pdf|CCD performance test sheet]])*'''Spectral range:''' 400.5 – 799.5 nm <ref name="spec">Preliminary values based on lab tests at LJMU or original spec. Actual values to be confirmed during commissioning.</ref>*'''Spectral resolution:''' *:'''Dispersion:''' 3.88 Å/px*:'''Resolution:'''*::80µm slit*:::R = 301.0 @4671.23 Å*:::R = 374.4 @5823.89 Å*:::R= 492.5 @7642.02 Å*::160µm slit*:::R = 172 @4671.23 Å*'''Plate scale:''' 0.588 arcsec/px*'''Field of view:''' 10.07' × 10.07'*'''Slit:''' Long slit with narrow (80µm, 2") and wide (160µm, 4") sections. <!--*: 8.4' × 2 arcsec*: 8.4' × 4 arcsec --> *'''Filters:''' *:'''Filter Slide A:''' [[Filter Plots and Data|Full set of SDSS filters]] (u', g', r', i', z')*:'''Filter Slide B:''' Longpass [[Media:OB_Datasheet.pdf|order blocking (OB)]] filter, and clear filter. There are three empty slots in this slide available for future use.----<references />
=== Suitable Uses ===
*Spectroscopy
*Low-cadence imaging: the camera is not a frame transfer camera, and in normal operation exposures are readout after the closure of an iris shutter. The shutter is life-cycle limited and not suitable for high-cadence observations.
*High-cadence imaging: it is possible to deactivate the shutter and take continues short exposure but users should be aware that the camera is not a frame transfer camera and this mode will result in some readout smearing. There is currently also no GPS triggering of the exposures and that the time recorded in the header (Keyword = DATE-OBS, note: is the start of the exposure) is obtained from the CPU time that is NTP synched. However, the header time has been measured to be accurate within at least 100ms of exact time (see [[Mookodi time-stamp tests|here]]). '''NB. High cadence observing (e.g. multiple continues exposures with exposure times < 60sec) SHOULD NOT be done with the shutter on AUTO mode. It is very important to set the shutter to "ALWAYS OPEN" which will deactivate the shutter in the open state but flush the CCD before the start of each new exposure. Failure to do so will likely cause serious damage to the camera's shutter'''
== Data Reduction Pipelines ==
=== Spectroscopy ===
*These instructions should be identical for a Linux or Mac environment and Python 3.7 or a later version is recommended.*TEA-Phot-SAAO can be directly downloaded from [https://bitbucket.org/saao/tea-phot-saao here] or the repository can quickly be cloned through the following command in the terminal: git clone https://bitbucket.org/saao/tea-phot-saao.git* TEA-Phot-SAAO requires only four additional Python modules. To install (if not already) run the following command in the terminal: pip install numpy matplotlib sep astropy NB. you may need to use "pip3" if you haven't linked your pip to python 3.6+ ==== Usage Instructions ==== * To reduce and extract photometry from Mookodi data using TEA-phot-SAAO, in the terminal navigate to the folder that contains the '''TEA-Phot.py''' file.* To display basic usage and optional arguments run: python TEA-Phot.py -hNB. you may need to use "python3" if you haven't linked your python to python 3.6+* A typical example to reduce and extract photomery from Mookodi data would be something like this: python TEA-Phot.py SAAO Mookodi MKD --bias MKD --flat MKD --image_dir /full/path/to/science/fits/files/ --bias_dir /full/path/to/bias/fits/files/ --flat_dir /full/path/to/flat/fits/files/ --out_dir /full/path/to/chosen/output/directory/ --do_plot True --source_sigma 1.5NB. you may need to use "python3" if you haven't linked your python to python 3.6+* Wait for window to appear and select target and comparison star with mouse-clicks.* Follow further prompts from the pipeline for inputs (aperture size etc.) in the terminal. Note: Dark TEA-phot will NOT do bias and flat field corrections if not BOTH flat AND bias frames cannot files are supplied. == Operating Mookodi == Prepare the Lesedi telescope by following the [https://topswiki.saao.ac.za/index.php/Lesedi#Start-up_recipes Lesedi start-up recipes]. As Mookodi is on the old SHOC port, any relic references to the SHOC port should be taken via to mean the web GUI at this stageMookodi port.'' They Mookodi can only be taken operated via a web GUI. Fully scripted observations (incl. auto-focus of the [[#Operation via instrument, automatically positioning a target on the command line interface (CLIslit, and activating auto-guiding)|command line interface (CLI)]]will be available soon.
=== Operation via the web GUI ===
Open the web GUI at [http://mookodi.suth.saao.ac.za:5000 mookodi.suth.saao.ac.za:5000]. The GUI is roughly divided into four five sections. From top to bottom: Instrument opto-mechanic configuration(lamps, slit, filters etc.), target acquisition(auto acquisition of a user defined sky-coordinate on a user specified x and y pixel position), camera exposure configuration, and (exposure time, binning etc.), higher level instrument control(start exposures, auto-focus instrument etc. At this stage the target acquisition features are not implemented), and an image display.
# '''Instrument Opto-Mechanic Configuration:'''#* Select the desired configuration for each component. The components moved in/out of the beam via pneumatics (eg. mirrors, slit, grism) and lamps will respond on the push of the button, and indicate when they are busy or in the desired configuration. '''To conserve lamp lifetime, do not leave them on unneccessary for extended periods of time.'''
#* Select the required filter via the dropdown menu under the Filter A or Filter B headings and press the SET button to activate the filter slides. The box above the dropdown indicates the name of the filter in position for each slide, or BUSY if the slide is still finding its requested position.
# '''Target Acquisition:''' NOT IMPLEMENTEDTO DO# '''Camera Exposure Configuration:'''<br /> Select the desired configuration for each setting using the dropdown menu below the relevant heading, then press the SET button to issue the command to the camera. #*'''Binning:''' Options are 1x11×1, 2x22×2, 3x33×3, and 4x44×4.
#*'''Gain:''' High (faint objects), medium, and low (bright objects)
#*'''Rate (readout rate):''' Fast (5 MHz)- read-noise of 13.6 electrons, and slow (0.05 MHz)- read-noise of 3.3 electrons#*'''Image Type:''' This has no physical effect on the instrument configuration and only populates a header keyword with the selection (possibly useful for automated data reduction)#*'''Instrument Mode:''' NOT IMPLEMENTEDThis has no physical effect on the instrument configuration and only populates a header keyword with the selection (possibly useful for automated data reduction)#*'''Number of exposures:''' NOT IMPLEMENTEDThe number of exposures to take at the set camera/instrument configuration. '''NB. see note on [[#Suitable_Uses|high cadence imaging]] in the Suitable uses section at the top of this page.'''
#*'''Exposure time (in ms):''' Note the exposure time display does not update when the SET button is pushed, it only updates after the exposure is started. This is a [[#Known Issues|known issue]].
#'''Exposure Higher Level Instrument Control:'''<br /> This contains an image display of the last completed exposure, using [https#*'''Exposure Control://js9.si.edu/ JS9].'''#**'''Take exposure/Start:''' Starts an exposure with the SET camera exposure configuration#**'''Abort:''' Aborts the current exposure. #*'''Guider Control:''' TODO#*'''Shutter Control:''' TODO#*'''Save images:''' TODO#*'''Exposure Information:''' TODO#*'''Nudge telescope pointing:''' TODO#*'''Focus control:''' TODO#*'''CCD TemperatureControl:''' Displays the current CCD temperature, and buttons for cooling down and warming up. The camera takes 10 - 15 minutes to cool, and will stabilise at approximately -70 ºC. Cool the camera at the start of observations and warm it up once you are done.# '''Image Display:'''#*Contains an image display of the last completed exposure, using [https://js9.si.edu/ JS9].#*A red and blue circle will appear where the preset values are for the pixel positions for the narrow and wide slit locations. Known bug: only appears after the second image is taken and only displays correctly for 1×1 binning. #*TIPS: TODO.
From a terminal window:
== Start-up Procedures ==
*The Mookodi host machine is set to boot automatically when powered.
*There are three services that need to be run before Mookodi can be operated via the web GUI: opto-mechanics, camera, and web server.
== Daily Rounds ==
