FOCASRED (= "FOCAS" Data "RED"uction Package)

Overview

FOCASRED is the compilation of various kinds of software for FOCAS.

• Maintenance package: Mainly used by SS and operators at Summit

  CCD alignment
  Grism alignment
  Slit alignment
  Focusing tool for telescope
  Focusing tool for FOCAS

• MOS support software: MOS observers use MDP. Mask Pointing tool sill be used by SS and operators at Summit

  Mask Design Program (MDP)
  Mask Pointing Tool

• Data Reduction Software
  • Imaging

    Combine chip 1, 2 (default)
    Distortion correction (option)
    Simple bias subtraction (option)
    Simple flat fielding (option)

    Software asks you to choose from available options within the software.

    e.g., You may do your bias subtraction and flat fielding for each image, and then use this software just for combining chips.

  • Spectroscopy

    Distortion-considered flat fielding and 2-D spectrum image extraction for target and arc-calibration images (default)
    Simple bias subtraction (option)

Where you can get this software? and How to use them?

• Ask SS for the newest package.

  You will get FOCASRED.tar.gz.

• Inflate gzip-compressed file, and extract the tar archive

  tar xvzf FOCASRED.tar.gz

• "FOCASRED" directory will be created.

  <DIR>/FOCASRED/DATA --- Chip information files, etc.
  <DIR>/FOCASRED/AWK --- Some useful AWK files for mask design
  <DIR>/FOCASRED/IDL --- Main part of the package: Original software
  <DIR>/FOCASRED/SYSTEM --- Main part of the package: IDL library taken from idlastro.gsfc.nasa.gov + others
  <DIR>/FOCASRED/IRAF --- IRAF CL scripts
  <DIR>/FOCASRED/bin --- Some useful scripts
  <DIR>/FOCASRED/DATA --- Chip information files, etc.
  <DIR>/FOCASRED/OUTPUT --- Directory for data output from FOCASRED

• IDL setup

  Edit <DIR>/FOCASRED/setup_focasred_local (change the directory names for your computer), and then "source setup_focasred_local".

Example:

setenv FOCASRED_FITS_IN /wr25/ohyama/MRC/                      <--- Input dir. for FITS data: specify your working dir. containing FOCAS images
setenv FOCASRED_FITS_OUT /wr25/ohyama/MRC/                     <--- Output dir. for FITS data: specify your working dir.
setenv FOCASRED_DATA_IN /remote/home1/ohyamayi/FOCASRED/DATA/  <--- Input dir. for FOCASRED system: specify ?/FOCASED/DATA/
setenv FOCASRED_DATA_OUT /remote/home1/ohyamayi/FOCASRED/DATA/ <--- Output dir. for FOCASRED system: specify ?/FOCASRED/DATA/

• Startup IDLDE (IDL Developing Environment)

Type "idlde" in your computer terminal.

In IDLDE, include path for the package <DIR>/FOCASRED

In <FILE><Preferences><Paths>, include "<DIR>/FOCASRED". Be sure to include subdirectories (check the box)

In <FILE><Preferences><Graphics>, set Backing Store as PIXMAP (retain=2). This is optional, but will be useful.

Close IDLDE once, then re-start IDLDE again (for the first time only)

type "focasmenu" or other commands at the bottom of the IDLDE window.

• IRAF setup

  Add the followings at the end of login.cl or loginuser.cl

  set stdimage = imt4096
  task $focasred.pkg='<DIR>/FOCASRED/IRAF/focasred.cl'
  focasred
  keep

  Start-up iraf by CL, and type focasred for loading package

Requirements

IDL: Version 5.3, 5.4, and 5.5 (Developers use version 5.4)
IRAF: Any recent versions

Tips for non-Sun users

If you find an error something like this:

Unsupported X Window visual (class: StaticGray, depth: 0).

Substituting default (class: <UndefinedVisual>, Depth: 0).

Execution halted at: $MAIN$

(Parameters may change according to your computer environment)

and found any IDL windows show up in your display, try the following:

type

DEVICE, PSEUDO_COLOR = 8

in the command line at the bottom of the IDLDE window. If you fail again, see the IDL help (from upper right of the IDLDE window) on "The X Windows Device" (in "IDL reference"/"IDL Graphics Devices").

I know this kind of troubles happened when one uses an X-window on Linux.