MOIRCS Mask Design Program Manual

Chihiro Tokoku


Updated: 2006-08-01

Japanese


0. Introduction
1. Preparation
2. MDP Startup
3. Mask Design
4. Save the images
5. Submit the results
6. Acknowledgment

0. Introduction


1. Preparation

1.0 System requirement

  1. Computers with Unix / Linux / Solaris or related OS is required. Performance on the Mac OS is not confirmed. MDP program does not work on the Windows 2000/XP.
  2. The IDL Virtual Machine ( IDL VM ) is required to run the MDP program. IDL VM is a free software and runs on the various OS without IDL. IDL VM can be downloaded from the following web site. Please download and install a proper IDL VM to your computer.
    IDL Virtual Machine ( http://www.ittvis.com/idlvm/ )
  3. Ask the MOIRCS team for current MDP program file ( wmdp_moircs.sav ) for IDL VM.

1.1 Preparing the images

1.2 Target selection

1.3 Creating *.mdp file

Obj1-X[PIX] Obj1-Y[PIX] Length1[PIX] Width1[PIX] Angle1[DEG] 1 B, comments...
Obj2-X[PIX] Obj2-Y[PIX] Length2[PIX] Width2[PIX] Angle2[DEG] 1 B, comments...
Obj3-X[PIX] Obj3-Y[PIX] Length3[PIX] Width3[PIX] Angle3[DEG] 1 B, comments...
.
.
.
Star1-X[PIX] Star1-Y[PIX] 35(HoleSize)[PIX] 35(HoleSize)[PIX] 0 1 C, Alignment Hole
Star2-X[PIX] Star2-Y[PIX] 35(HoleSize)[PIX] 35(HoleSize)[PIX] 0 1 C, Alignment Hole
Star3-X[PIX] Star3-Y[PIX] 35(HoleSize)[PIX] 35(HoleSize)[PIX] 0 1 C, Alignment Hole
.
.
.

2. MDP start-up

  1. Type "idl -vm=wmdp_moircs.sav" in your computer.
  2. Click IDL logo window, and the MDP program window shows up.
  3. Select [ File ] - [ Read FITS image ] from the pull-down menu, and select a mosaicked FITS image in a pop-up window.
  4. A FITS image will show up. Click "Auto-Intensity Scale" or "Change Intensity Scale" to show image.
  5. Select [ File ] - [ Read MDP file ], and select a MDP file you created as shown above in "Input MDP file" window.
    If you do not have a MDP file, just push "Cancel" button for interactive mask design for all slits. In this case, one dummy slit will be set.
  6. Select [ Option ] - [ Grism select ], and select an appropriate grism in "Grism Selection" window.
  7. Click on "Redraw" or "Draw Slit" buttons to see the image and the slits.
  8. Now you are ready to start editing the masks.

2.1 Explanation of the Main MDP window

    Click for detail.

  1. Pull-down menus - File : Tasks for file I/O.
    - Option : Grism selection, Set parameters for slits and holes, etc.
    - WCS : Set coordinate for center of FOV, etc.
  2. Main window Your FITS image is shown in the detector coordinates (pixel), not in the sky coordinates (NSEW).
    Wavelength is in vertical direction. See also this figure.
    upper detector ( detector 2 ) : upper=redder, lower = bluer)
    lower detector ( detector 1 ) : upper=bluer, lower = redder)
    Items shown in above figure:
    - Main FITS image display (entire view of the image at reduced size)
    - Slit marker (small elongated rectangle on targets)
    - Spectra marker (long rectangle elongated vertically)
    - Slit ID number (small number just right of the slit pointers)
    - Slits available area (large circle showing the available area for slit cutting)
    - Center line of FOV (Continuous line at the center)
    - Edge line of detectors (Dashed lines upper and lower of the center line. Upper one is a edge line of the detector 1 and lower one is that of the detector 2.)
  3. Mode selection switches - Object pick-up mode (apply Gaussian fitting on the image around the clicked position, or simply adopt the clicked position as a final position)
    - FOV circle display switch
    - "Slit ID display" switch does not work, and the slit IDs are always shown on the main display.
  4. Zoom image display Display for zoomed (non-reduced) FITS image around the selected region for slit review. This display is also used for object selection by mouse.
  5. Buttons for controlling the image display Display intensity adjustment, image redraw button, etc.
  6. Buttons for slit editing Buttons for editing slits and alignment holes.
  7. Information panel Panel showing default slit parameters and current mouse positions.

3. Mask Design

3.1 Adjusting intensity scale

3.2 Set the mask center position

3.3 Design of alignment holes

3.4 Design of slits

3.4.1 Add slits interactively

  1. Select [ Option ] - [ Change Default Slit Params ] from the pull-down menu, and input "Default Slit Width" and "Default Slit Length" in pixel unit.
    e.g.) Since a pixel scale of MOIRCS is 0.117"/pix, width = 6.84 (pix) means a slit width of 0.8".
    Both length and width of each slit can be modified after locating the slits.
  2. Select a mode for the target selection at upper left of the MDP window. You may choose "pick-object" mode in which Gaussian fitting is used to find the object coordinates, or "click-point" mode in which mouse click position itself is used as the object coordinates. "Pick-object" mode is suitable for point or compact sources, and "click-object" mode is for diffuse and extended sources.
  3. Click "Add slit by click" button.
  4. Click on the object on the main image display. Region around the clicked position is shown on the zoom image display.
  5. Click on the target again on the zoom display. In "pick-object" mode, Gaussian fitting is performed around the clicked position, and the detected source is shown at the center of the zoom display as well as the rectangles for the calculated slit position. In "click point" mode, click on your favorite position on the zoom display, and the image is re-displayed around the clicked position.
  6. Regions occupied by the spectrum will be shown as an elongated rectangle both on the zoom and the main window. Red frames are for the spectra in the detector 1, and green frames are for the spectra in the detector 2.
  7. Click on "Redraw" or "Draw Slit" buttons to see the updated image and the slits.
  8. "Newly Added Slit" comment is shown in a comment field of *.mdp file for slits which are generated interactively in the MDP program.

3.4.2 Check the slit/hole parameters.

  1. Click the region of your interest on the main image display, and the zoom image around the selected region is shown in the zoom image display.
  2. Click "Show nearest slit" button and click near your interest slit on the main image display. Nearest slit is found automatically, and the zoom image around the slit is shown in the zoom image display. A small pop-up window shows the slit information as well as the slit ID selected.
  3. Click "Show slit(ID)" button and then input the slit ID number shown beside the slit. The zoom image around the selected slit is shown in zoom image window. A small pop-up window shows the slit information as well as the slit ID selected.
  4. Click "Show Slit List" button to make a slit list which displays all slit information as well as comments (if any). Radio buttons at the left of each slit ID number can be used to activate/delete slits/holes. Deleted slits/holes can be re-activated from this slit list later if you wish.

3.4.3 Adjusting/modify the slit length

  1. Click "Change Slit Params" button and click near the slit you want to modify on the main image display. The nearest slit is automatically selected.
  2. Input the new slit coordinates (X coordinates of the left and right side of the slit) and/or slit width/angle in the new popup window.
      Left = X coordinate of the left side of the slit of space direction (pixel unit)
      Right = X coordinate of right side of the slit of dispersion direction (pixel unit)
      Width ( PIX ) = Slit Width (pixel unit)
      Angle ( DEG ) = Slit Angle (degree unit)
    e.g.) Since a pixel scale of MOIRCS is 0.117"/pix, width = 6.84 (pix) means a slit width of 0.8".
  3. Click on "Redraw" or "Draw Slit" buttons to see the updated image and the slits.

3.4.4 Deleting slits/holes

3.5. Saving the results

3.5.1 Save *.mdp file

3.5.2 Save *.sbr file

  1. Select [ WCS ] - [ Set FOV Center ], and confirm "arcsec/pix" at the bottom column is 0.117.
  2. Click "Draw FOV: botton and write down the coordinate information (X, Y).
  3. Select [ File ] - [ Save SBR ] from the pull-down menu. Input the file name with an extension of *.sbr and click "OK".
  4. You are asked to input the coordinate of the FOV center. The (X, Y) values you can see in the "Draw FOV" button will be shown as default values, and you do not normally have to change the values.

    Note

    While writing the *.sbr file, MDP checks the slit positions whether slits are out of the FOV or on the detector gap. When MDP finds any possibly wrong slits, warning messages are shown in the warning pop-up window. If you find such a message, check the slit design again to find out the cause of the warning. If you have intentionally put the slits near the FOV edge or the detector gap, there will be no problem, and just ignore the warning. If you find something wrong in the mask design, try to delete/modify the slits, or move the FOV center. Note that *.sbr will be created even when there are warning messages.

3.6 Quitting the MDP

3.7 Other notes

3.7.1 Dummy slit (0th slit)

3.7.2 Coordinate system convention

3.7.3 Care for extremely out-of-FOV slits

3.7.4 Other functions


4. Take a snapshot image of MDP


5. Submitting the results


6. Acknowledgment




Document Preparation by Chihiro Tokoku (July 2006) / Revised by Ichi Tanaka (2006-08-01)