FIMS: Download and Installation

The FORS Instrumental Mask Simulator (FIMS) is a SkyCat plugin to specify the FORS instrumental setup (e.g. the 19 slit positions in MOS) during Phase 2 Proposal Preparation. FIMS creates and manages the instrumental setup by Target Setup Files (TSFs). These TSFs can be loaded by the P2PP tool to become part of an Observation Block (OB) for FORS. For further information, see the FIMS User Manual.



Important Note concerning Releases

During ESO period 92 a new version of FIMS (version 237649) was released. This new FIMS version contains a number of important bug fixes, and offers new functionalities for users of the HIT-S and HIT-MS modes. For ESO periods 92, 93 and 94, users may prepare their fims configuration files with either the old FIMS version 2.60 or this new version of FIMS.

FIMS is released as a tarball which also includes the appropriate SkyCat version (3.1.2) and an additional plugin for making ESO-compliant finding charts.

Supported Platforms

The latest version of the FORS Instrumental Mask Simulator (FIMS) is supported on the following platforms:

  • Linux RedHat 9
  • Fedora 14
  • Scientific Linux 5.3

If you do not have access to a PC or workstation running one of these operating system, please contact the ESO's User Support Department (USD) for assistance.

Downloading and installing FIMS

For periods 92, 93 and 94 users of FORS may either prepare their masks using FIMS version 2.60 (P84) or FIMS version 237649 (P91), available below.

Installation kit

For users of Linux 32 bit systems, a version of the installation kit for fims version "P91" (FIMS 237649) which includes a pre-complied version of skycat 3.1.2 is avaible:  fims-P91-Linux.tar.gz

Installing FIMS

  • Once you have downloaded the FIMS tarball, Unpack it by executing:gunzip -c fims-<version>.tar.gz | tar xvf -This will create a directory called fims-<version>.
  • You may now remove the gzipped tar file:rm fims-<version>.tar.gz
  • Execute the command sequence:cd fims-<version>
    ./fims_install.sh

    Follow the instructions on the screen. The installation script will first ask you where you want to install the FIMS tool. The default directory is the one created when you unpacked the tarball, but you can specify any other directory provided you have write access to it. The script will complain if this condition is not met.
    It will then try to guess where the Perl interpreter is located on your machine, so as to adapt two auxiliary scripts to your local configuration. If it doesn't find the perl executable in your path, the script will offer you to provide this information by hand. However, the script language Perl is not mandatory for FIMS. The two scripts are only to create Postscript files from a MXU setup of FORS2. You can thus choose to skip this step if you do not need this functionality.

    The script will then proceed with the installation of the tool. At the end of the installation, the full path to the startup script needed to launch FIMS (fims.sh) is displayed. Depending on your preferences, you may want to create an alias to this script, or add the directory in which it is contained (i.e.<fims-install-directory>/bin) to your PATH variable.

Environment variables for FIMS

FIMS uses a number of environment variables, and provides defaults.They are all defined in the startup script <fims-install-directory>/bin/fims.sh Only FC_DIR can be overwritten by the setenv (or export in bash and ksh) command. All other variables are hard coded in the<fims-install-directory>/bin/fims.sh startup script. Running this script for the first time will create the directory INS_USER and its subdirectories, LOG_DIR,SET_DIR,and PREP_DIR with the defaults given below, if these do not exist already.

  • FIMSROOT: points to the FIMS installation directory
  • INS_ROOT (default is $HOME): this is the root directory for all FIMS output
  • INS_USER (default is .fims): this is the project (user)-related subdirectory
  • LOG_DIR (default is $INS_ROOT/$INS_USER/LOG): the directory where FIMS writes the log-file and the control file for automatic positioning
  • SET_DIR (default is $INS_ROOT/$INS_USER/SET): the directory where FIMS writes the acquisition files. This path variable can be redefined during a fims session [SetUpDir].
  • PREP_DIR (default is $INS_ROOT/$INS_USER/PREP): the initial directory to select FITS files to be loaded by SkyCat. The initial directory to select local catalogs be loaded by SkyCat.
  • FC_DIR (default is the directory from which SKYCAT was started): the directory in which the finding chart tool saves the jpeg files. This variable is not mandatory.

How to Use FIMS

User Manual

The use of FIMS is described in the FIMS User Manual. It is indispensable for you to read this document, particularly if you are not familiar with the tool yet.

Quick start

FIMS can be started with fims.sh [camera] [skycatoptions] [DEBUG]

  • camera is one digit and controls the CCD for which you prepare your masks.
    B: blue FORS camera
    R: red FORS camera
  • skycat option is a list of SkyCat command line options embedded in a pair of ""-characters
  • DEBUG is an optional flag to print all environment variables of fims.shThis flag is only suitable in case of installation errors.

Examples are (for user smith):

  • fims.sh R (red camera)
  • fims.sh B (blue camera)
  • fims.sh R "-float_panel 1 -file /home/smith/.fims/PREP/test.fits -cat/home/smith/.fims/PREP/objects.ptl" DEBUG
    Starts FIMS for the red camera and specify the command line options for SkyCat. (Here SkyCat loads a fits image and a target catalog). Don't forget to use the double quotes. Additionally all environment variables are shown.

When "fims.sh R" is used, the following output will appear:Calling FIMS for FORS Red...

Remember to copy any MXU technical masks to /home/smith/.fims/SET


  W E L C O M E     T O     F I M S
 -----------------------------------

 +----------------+                +---------------------+
 | FIMS    237649 |----plugin----> | SkyCatTool    3.1.2 |
 +----------------+                +---------------------+

 +------------------------------------------+
 | last checkin : 2012-11-30 GD 21:47:34 UT | INPUT : /home/smith/.fims/PREP
 | now is       : 2013-04-19 GD 07:47:45 UT | OUTPUT: /home/smith/.fims/SET
 | FIMS requires: SkyCat 3.1.2              | LOGS  : /home/smith/.fims/LOG
 +------------------------------------------+


skycat -with_grid 1 -scrollbars 1 -rtd 0...
Loading the graphics features plugin....
Loading the FIMS plugin...

A FITS image taken with FORS2 (tar.gz file; 5.0 Mbytes) is available for practising with FIMS.

Verification of FIMS

  • Verify the SkyCat version: Press [Help] [About SkyCat]. SkyCat version number must be 3.1.2.
  • Verify the FIMS version: Press [Help] [About FIMS]. FIMS Version number must be 236128 (version P91).
  • If not done so far, load a FITS image with World Coordinates, e.g. with[Data-Servers][Image Servers] [DSS] and a image size of 7 arcmin.
  • With FIMS started for the FORS2 instrument, press [FORS2] [Enter Mode] [MOS] to create the FORS mask for Multi Object Spectroscopy. The output in the run-time window should be similar to NEW MASK --> SkyCat V3.1.2 -->  FIMS V236128 2012-11-30 21:47:34 for FORS2+1
    Executing load_instrument ...
    load_instrument /home/smith/fims-P91/fimsLINUXRH9/config/FORS2.isf
    Closed /home/smith/fims-P91/fimsLINUXRH9/config/FORS2.isf

    filter: none
     filter:         none, good = 21, prio =  2 >> OS filter found ok <<
    Wave Limits:
     INS_DISP: 5.00 (nm/mm)
     FOCSCALE: 1.901679 (arcsec/mm)
     PIX:      0.030 (mm/pix) unbinned
     CCDscale_standard: 0.250124 (arcsec/pix)
     CCDscale_highres:  0.1250626 (arcsec/pix)
     
     FORS CCD Frame
     ==============
     >> 500.0 < 500.0 < 500.0 < 500.0 < 500.0
     >> 500.0 < 500.0 < 500.0 < 500.0 < 500.0 none none
     >>  DISP  50.0 A/mmCCD   1.5 A/pix   6.0  12.0 A/''   3.2   6.3 A/mmfoc
     >>  BLU    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mmfoc
     >>  RED    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mmfoc
     >>  USD    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mmfoc
     >>  SPE    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mmfoc
     >> Field Stop total range = 2518.5 A (SR) = 2433.8 A (HR)
     >> CCD total range        = 3085.5 A (SR) = 3083.0 A (HR)
     ==============


    WAVE CONFIG MASK by filter none
    WAVE CONFIG MASK END


    grism: none
     Ok     : Filter does match Grism
     grism:         none, good = 21, prio =  2                    
    Wave Limits:
     INS_DISP: 5.00 (nm/mm)
     FOCSCALE: 1.901679 (arcsec/mm)
     PIX:      0.030 (mm/pix) unbinned
     CCDscale_standard: 0.250124 (arcsec/pix)
     CCDscale_highres:  0.1250626 (arcsec/pix)
     
     FORS CCD Frame
     ==============
     >> 500.0 < 500.0 < 500.0 < 500.0 < 500.0
     >> 500.0 < 500.0 < 500.0 < 500.0 < 500.0 none none
     >>  DISP  50.0 A/mmCCD   1.5 A/pix   6.0  12.0 A/''   3.2   6.3 A/mmfoc
     >>  BLU    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mmfoc
     >>  RED    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mmfoc
     >>  USD    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mmfoc
     >>  SPE    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mmfoc
     >> Field Stop total range = 2518.5 A (SR) = 2433.8 A (HR)
     >> CCD total range        = 3085.5 A (SR) = 3083.0 A (HR)
     ==============


    WAVE CONFIG MASK by grism none
    WAVE CONFIG MASK END

    WCS: world_x =    world_y =
    Frameless mode...
    FORS2 at UT1
    NOMINAL SCALE : 0.125062''/p = 3.473944e-05 o/p (SR)  0.062531''/p = 1.736981e-05 o/p (HR)  1.901679''/mm ff (UT)
    world2: Dataless mode
    world2: reference pixel   0.0000   0.0000 512.0000 512.0000
    world2: BONSAI ON
    Mask initialized



    The output is explained in the FORS User Manual

Problem and Bug Reports

Please report all FIMS problems and bugs to the ESO User Support Department  (USD).

WCS keywords in wide field mosaics

At present FIMS does not support WCSs where the CRPIXn keyword value is outside the range 0 < CRPIXn <= NAXISn (ie. outside of the field of view). This is ONLY important for you if you, instead of having obtained new pre-imaging with FORS, are going to use a sub-image extracted from a large field, for instance from a mosaic or from wide field imaging.

This means that despite the fact that the global image may have correctlyset WCS, if the mosaic is split and only part of it used for mask preparation with FIMS the error message "Error: out of coordinate range" will appear if that part of the mosaic does not contain the reference pixel of the center (CRPIX1 and CRPIX2 keywords).

Right handed WCS (North up, East to the right)

FIMS does not treat properly the images taken with other telescopes/instruments if they have WCS oriented with North up and East to the right. In order to prepare a correct FIMS setup files a possible work-around is to edit the WCS, and therefore modify the image so that it has the "standard" orientation with North up and East to the left. This should be done with care in case of significant distortions in the images. If unsure of the distortions, it is better to take the new pre-images with FORS2.


Instrument selector

This page is specific to FORS

FIMS