MMTF Instrument Scientist's Guide
Installation
Etalon
  1. Note: The etalon weight is 19.5 kg, not including the mounting plate.
  2. If the MMTF etalon is not attached to its mounting plate, attach it. The orientation of the etalon is important. In the left figure below, the CS-100 cable ports are in the correct rotational orientation (at the bottom of the picture) with respect to the mounting plate flanges. In the right figure below, the ports are such that the etalon is right-side up.

    A top view of the MMTF, attached to its mounting plate. Note the correct orientation of the CS-100 cable ports (at bottom) with respect to the mounting flanges. (Click for a larger image.)

    A side view of the MMTF, attached to its mounting plate. Note the correct orientation of the CS-100 cable ports, ensuring that the etalon is right-side up. (Click for a larger image.)

  3. Ensure that the two clear, protective covers covering the etalon aperture are in place.
  4. Secure the etalon in the disperser wheel using the same procedure as for other IMACS gratings. In the disperser wheel service position, the MMTF cable sockets will be pointing out and down, as shown in the image below (in the "5 o'clock" position as viewed from the rear of the instrument, looking toward the telescope).

    A view of the MMTF when mounted in the disperser wheel, with CS-100 cables connected. (Click for a larger image.)

  5. Plug into the MMTF the 5 cables connecting the etalon to the CS-100 controller. Be sure that the X, Y, and Z cables are matched properly with their respective sockets.
  6. Remove the two covers protecting either side of the etalon aperture.
Filters and Masks

1. Install the intermediate-band blocking filters specified by the observer.

2. Install MMTF slit mask ID #2049. This mask will be used for checking the position of the optical axis.

3. If charge-shuffling has been specified by the observer, insert MMTF slit mask "A".

Etalon CS-100 Controller

WARNING: Never set the Zcoarse dial on the CS-100 below -2! Doing so may damage the etalon coating.

CAUTION: The cables between the CS-100 controller and etalon should never be attached or removed while the CS-100 power is on.

Front panel of the CS-100. (Click for a larger, more readable image.)

The CS-100 is the electronic brain of MMTF. It is located in the IMACS electronics rack. For a more detailed description than that provided here, read the CS-100 manual.

Features

Initial Configuration

  1. Ensure that the Mode knob is in the Balance setting. Power on the CS-100.
  2. Ensure that the CS-100 Meter Display knob is set to Offset. Using the knobs on the left side of the CS-100, dial in the following numbers to balance the capacitance feedback loop and parallelize the etalon. Replace ? with the Zcoarse specified by the observer.
        coarse fine  quad
    X   -1     7.11  4.20
    Y    0     6.80  3.78
    Z    ?     4.10  4.34
    
  3. Turn the Mode knob to Operate. After a few seconds, the Operate light should illuminate, indicating the feedback loop is now in active operation and functioning properly. If instead the Out of Range light illuminates, the etalon must be re-balanced; follow the balancing instructions.

Changing Zcoarse

Follow this procedure.

Startup

Once the CS-100 in the rack is powered on, you are ready to initialize the IMACS software for MMTF use and perform set-up calibrations.

Procedure when starting MMTF at the beginning of a run:
  1. If the IMACS software is already loaded, exit the software.
  2. Run the IMACS Setup Tool (command % imacs setuptool, which must be run from the imacs account) to input the CS-100 settings that presently appear on the front panel dials . The settings are those originally dialed in, plus any changes made to tweak the balance.
  3. As the imacs user (type: "su imacs"), go to the home directory (type: "cd") and initialize the MMTF software by typing: "touch .imacs_use_script"
  4. Exit superuser account.
  5. Start up the IMACS software (% imacs).
  6. Run standard IMACS initialization procedures.
  7. Open the HardHat GUI to enable changes to Xfine and Yfine.
  8. Parallelize the etalon. [procedure]
  9. Check the position of the optical axis. [procedure]
  10. Take a reference ring and data sausage in each filter the observer will use. Be sure to first optimize the parallelism in each filter. [procedure]
Procedure if MMTF has already been set up, and you are simply changing the value of Zcoarse in the middle of a run:
  1. Release computer control of the CS-100 with the Etalon button in the HardHat GUI. [procedure]
  2. At the CS-100 front panel, switch to Balance mode. Turn the Zcoarse dial by one unit in the direction of the desired Zcoarse. Switch back to Operate mode. If the Operate light illuminates, repeat this procedure until the desired Zcoarse is reached. If instead the Out of Range light illuminates, follow these steps.
  3. Run the IMACS Setup Tool (% imacs setuptool) to input the new Zcoarse setting, plus any changes made to tweak the balance.
  4. Re-acquire computer control of the CS-100 with the Etalon button in the HardHat GUI. [procedure]
  5. Parallelize the etalon at the new value of Zcoarse. [procedure]
  6. Take a reference ring and data sausage in each filter the observer will use. Be sure to first optimize the parallelism in each filter. [procedure]
Cam GUI

When MMTF is properly initialized by touching the .imacs_use_script file in the observer's directory, a new version of the f/2 CamGUI is enabled:

MMTF version of the CamGUI.

The additional Script section of CamGUI allows the following tasks:

There is also a new ExpType: MMTF-Shuffle, for the charge shuffling / freqency straddle observing mode. Selecting this opens a dialog box.

HardHat GUI

Part of the HardHat GUI is specifically devoted to MMTF:

MMTF area of the HardHat GUI.

This additional area enables the following:

NOTE: The X, Y, and Z fine computer units uniquely specify the absolute plate spacing only in reference to the CS-100 front panel dials. When the front panel dials are set and control of the CS-100 is acquired by the IMACS computer, the computer X, Y and Z fine values are set to a reference value of 2048. Changes in X, Y, and Z fine are then defined such that 2048 computer units = 1.00 front panel units, or 1/10 of a full dial turn. (However, the values initially displayed in the HardHat GUI when IMACS is started may not always be the reference values.)

Takedown

When the etalon needs to be dismounted from the IMACS disperser wheel, the CS-100 needs to first be turned off and unplugged from the etalon. Use the following procedure:

  1. Release computer control of the CS-100 with the Etalon button in the HardHat GUI.
  2. At the CS-100 front panel: Turn the Mode knob to Balance. Once the Balance light illuminates, turn the CS-100 off using the Power switch.
  3. At the IMACS disperser wheel: Attach a clear fiberglass cover to side of the MMTF aperture. Remove the MMTF cables from their sockets.
  4. Dismount MMTF!
Troubleshooting

Common problems:

  1. "Etalon" button does not appear in the CamGUI
  2. Data analysis commands (i.e. ring, sausage, etc) are unrecognized on Burro/Llama
  3. Can't find location of data on data analysis computer (Burro)
  4. The line profile has changed drastically and is no longer narrow/symmetric
  5. The wavelength calculator settings have been lost (i.e. browser crashed, navigated away from page, etc.)
  6. PGPLOT has launched a huge window that cannot be resized.
  7. Etalon is "out of balance"
1. Initializing the IMACS software to recognize MMTF

If the "Etalon" button is not appearing in the CamGUI, the most likely problem is that the software hasn't been initialized properly. This generally happens on the first night of an MMTF run and should only need to be done once over consecutive nights with MMTF. The following steps should solve this problem:

This process won't work without the "su imacs" step, because the .imacs_use_script file needs to have certain permissions for the software to access it.

2. Finding the analysis software on Burro

MMTF users typically perform real-time analysis of the calibration data (rings, sausages) on either Llama (the computer which controls IMACS) or Burro (the computer next to Llama). In order to link to the most up-to-date software, the user must type "mmtf" each time a new terminal window is opened. If the "mmtf" command cannot be found, you should contact one of the instrument scientists so that they can properly link the software, which is kept in the /usr/local/magellan/ directory. If immediate assistance is unavailable, you can do the following as a temporary solution.

You should then have all the binaries you need to analyze calibration data. In order to make things run smoother, you could set up aliases for ring, ringbatch, ringdrift, sausage and fitsausage so that you don't need to type the full path in each time.

Example: alias ringbatch '< path to source code >/bin/ringbatch'

3. Cross-mounting the data directory on Burro

In order to analyze the calibration data, it is easiest to cross-mount the Llama drive onto Burro. The commands to do this are as follows:

Once mounted, the data can be found on Burro at: /Volumes/Data_Llama/IMACS/

4. Solutions if the shape of the line profile is seriously degraded

MMTF users should be monitoring the shape and position of their reference ring throughout the night using the "ringdrift" command. If you find that the line profile is seriously degraded (i.e. very broad/asymmetric), you can do the following:

  1. The first thing to check is that the gravity angle is ~ 0°. The parallelism is a strong function of gravity angle, so ALL observations and calibrations should be performed at ~ 0°.
  2. If you're confident that the gravity angle is ~ 0°, you should try taking a second ring. Sometimes the asymmetry can be a "hiccup" that is not reproducible in future observations.
  3. If the line profile remains degraded, you should perform a complete re-parallelism (procedure). Occasionally parallelism can be lost during the night when the gravity angle goes beyond +30° (even if you return to 0° afterwards) due to hysteresis in the system. If you do need to re-parallelize the system, be aware that you should keep using the same reference ring that is associated with the current wavelength solution.
5. Recovering input values for the online wavelength calculator

The easiest solution here is to always write down the values of A and B when you determine them from the data sausage and before you enter them into the wavelength calculator. However, if this wasn't done, you still have a couple options:

If you're successful in recovering the calculator input values, be sure to write them down to avoid future stress!

6. Resizing an oversized PGPLOT window

Sometimes the initial window opened by PGPLOT is so large that the re-size arrow is outside the field of view. To fix this, maximize the window using the green "+" arrow in the upper corner. Once maximized, the grey resize box in the bottom right corner will be reachable. Click and drag this to resize the window.

7. Balancing the Etalon

Ocassionally the etalon will go out of balance while being controlled from the IMACS computer. If this happens, open "Hardhat", and click the "remote" button to the right of the CS100 label. More often than not, this will solve the problem and you can continue to observe.

During the instrument setup, the etalon will sometimes fail to operate when the Mode knob is first turned to Operate, as indicated by the Out of Range light. (This occurs most often at very low or high values of Zcoarse.) Alternatively, the CS-100 will operate only briefly, or go Out of Range when changes are made to X, Y, or Z at the computer. If computer control is enabled, this failure state should be accompanied by a message from the IMACS observing software, but will also manifest itself as an absence of coherent Fabry-Perot rings in images.

If the etalon goes Out of Range while at the IMACS computer, first release computer control of the CS-100.

At the CS-100 panel, turn the Mode knob from Operate to Balance and back again. If the etalon is still Out of Range, use the following procedure, which involves adjusting the quadrature balances at a Zcoarse value near the one at which you are working.

  1. Raise or lower Zcoarse by 1 unit (while in Balance Mode).
  2. Turn the Mode knob to Operate and the Meter Display knob to Quadrature Error.
  3. You may find that the meter voltages in X, Y, and/or Z deviates significantly from zero. Re-null the proper channel(s) using the quadrature balance knob(s) while in Operate mode.
  4. Switch to Balance, move Zcoarse back to the desired value, and switch back to Operate.
  5. If the etalon operates without going out of range, you're done. Write down the new values of X, Y, and Zquad from the quadrature balance knobs, and enter them into the computer with the IMACS Setup Tool before (re-)acquiring computer control.

We include here for completeness the procedure for re-balancing the etalon from scratch. However, this should not be needed under practical circumstances.

  1. Ensure that the Mode knob is set to Balance and the Meter Display knob set to Offset.
  2. Adjust the X, Y, and Z coarse and fine dials so that the three meters are nulled (the needles should point to 0, or straight up).
  3. Switch the Meter Display knob to Quadrature Error.
  4. Adjust the X, Y, and Z quadrature balance dials so that the three meters are nulled.
  5. Repeat steps 1-4.
  6. Switch the Mode knob to Operate. If the Operate light illuminates, the feedback loop is in operation and functioning properly. If instead the Out of Range light illuminates, the feedback loop is not properly balanced. Repeat the above procedure.