FIMS V.2.32 installation instructions

Installing SkyCat V.2.6.5

1. Retrieve and Install SkyCat V.2.6.5 . (SkyCat version supported for HP-UX-B 11.00).

 

Installing FIMS V.2.32

1. Change directory to where you want to install the FIMS system. (e.g. cd /usr/local/packages)

1. Retrieve the FIMS V.2.32 delivery package from USG anonymous ftp.

 
2. At this point you should have a gzipped tar file in your current directory. Execute:

 

gunzip -c fims-V.2.32.tar.gz | tar xovf -

This will create a directory called fims.
 

3. At this point you may remove the gzipped tar file. rm fims-V.2.32.tar.gz

 

---

Check if there are patch levels for V.2.32

retrieve the patches, example:
fims-2.32_2_2.32.p1.tar.gz
fims-2.32.p1_2_2.32.p2.tar.gz

and
gunzip -c fims-2.32_2_2.32.p1.tar.gz | tar xovf -
gunzip -c fims-2.32.p1_2_2.32.p2.tar.gz | tar xovf -

This will copy the patches for several files to
fims/src. 

---


 
4. Adapt Perl path for Perl-script

 which perl

and include the result string (this is on most systems /usr/bin/perl or /usr/local/bin/perl ) in the first line of both Perl scripts
fims/src/gerber2ps.perl
and
fims/src/gerber2eps.perl

(e.g. #!/usr/bin/perl )

The script language Perl is not mandatory for FIMS. The two scripts are only to create postscript files from a MXU setup of FORS2.
 

5. For installation with USER-privileges only (This applies to all users who want to install FIMS only locally on their own machine and who do not have system manager privileges)

Execute the command sequence:

cd fims
setenv FIMSROOT $PWD
cd src

• Only when using Tcl7.6 or older Tcl versions:

start conversion script
new2old

and install modified source files via
make -f old.makefile
 

• Only when using Tcl8.0.5 or newer Tcl versions:

make
 

To avoid having to reset the environment variables every time you login, you could, for example, include the following two lines permanently in your .cshrc or .tcshrc file:

setenv FIMSROOT $HOME/fims #(if you unwrapped the FIMS package in $HOME)
setenv PATH ${PATH}:$FIMSROOT/bin
 

6. For installation with ROOT-privileges only

Execute the command sequence:

cd fims
setenv FIMSROOT $PWD
cd src
 

• make p (if using Tcl8.0.5 or newer)
• new2old; make -f old.makefile p (if using Tcl7.6 or older)
# copy Tcl plugins
make a # compile AutoPos C++ sources
make d # copy FORS database

Edit $FIMSROOT/src/fims.sh to adapt it to your local site:

• If FIMS is used on a single workstation replace local_site_host_name by the value of your $HOST variable.
• If FIMS is used in a LAN (more than one host), edit the FIMSROOT variable in the the default case *) according to your local site preferences.
When you are done with editing fims.sh :

make s # copy start script to fims/bin

Make FIMS accessable to all USER:

cd /usr/local/bin
ln -s $FIMSROOT/bin/fims.sh fims.sh
 

7. For installation on hosts with VLTSW only

The VLT-Makefile can be used alternatively to install fims as an ordinary VLTSW-module:

make -f Makefile all
 

Environment variables for FIMS-V.2.32

• FIMSROOT (defaults to $HOME/fims)

must point to the package directory. The variable can be overwritten by the setenv FIMSROOT command.
• 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 cataloges be loaded by SkyCat.

Additionally  you should set SKYCAT_VER environment locally to the skycat version needed by FIMS (new starting from fims 2.32)
For example use the following:
      setenv SKYCAT_VER 2.6.5

By default this value is set to 2.5.3 inside the code.
 

Running FIMS V.2.32

• instrument number is one digit [0-2] and controls the menu bar.

1: only [FORS1] menu button (for FORS1 observers)
2: only [FORS2] menu button (for FORS2 observers)
0: both [FORS1] and [FORS2] menu buttons
• skycat option is a list of SkyCat command line options embedded in a pair of "-characters
• DEBUG is an optional flag to print all environmant variables of fims.sh This flag is only suitable in case of installation errors.

fims.sh
Start FIMS without options. Equivalent to fims.sh 2
 
 
• fims.sh 2 "-float_panel 1 -file /home/smith/.fims/PREP/test.fits -cat /home/smith/.fims/PREP/objects.ptl" DEBUG

Starts FIMS for FORS2 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.
• fims.sh 1

for FORS1 only
• fims.sh 2

for FORS2 only

fims.sh 0
for FORS1 and FORS2
 
 

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

 +--------------------+                +------------------+
 | FIMS          2.32 |----plugin----> | SkyCatTool 2.6.5 |
 +--------------------+                +------------------+

 +------------------------------------------+
 | last checkin : 2000/12/17 GD 12:04:19 UT | INPUT : /home/smith/.fims/PREP
 | now is       : 2000/12/17 GD 09:10:53 UT | OUTPUT: /home/smith/.fims/SET
 | FIMS requires: SkyCat 2.6.5              | LOGS  : /home/smith/.fims/LOG
 +------------------------------------------+


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

 FORS_INS            = FORS1+FORS2

 FIMSROOT            = /home/smith/CMM/fims
 INS_ROOT            = /home/smith
 INS_ROOT/INS_USER   = /home/smith/.fims
 SET_DIR             = /home/smith/.fims/SET
 LOG_DIR             = /home/smith/.fims/LOG
 PREP_DIR            = /home/smith/.fims/PREP
 ISF_DIR             = /home/smith/CMM/fims/lib/fors
 FORS1.isf from       /home/smith/CMM/fims/lib/fors/FORS1.isf
 FORS2.isf from       /home/smith/CMM/fims/lib/fors/FORS2.isf

 ESO_PLUG            = /home/smith/CMM/fims/lib/libesoPlugins.tcl

 SKYSEARCH_PLUGIN    = /home/smith/CMM/fims/lib/libfimsPlugins.tcl/SkySearch_plugin.tcl
 SKYCAT_PLUG01       = /home/smith/CMM/fims/lib/libfimsPlugins.tcl/SkyCat_plugin.tcl
 SKYCAT_PLUG02       = /home/smith/CMM/fims/lib/libesoPlugins.tcl/PE_SkyCat_plugin.tcl

 test if file exists

 found: /home/smith/CMM/fims/lib/libfimsPlugins.tcl/SkySearch_plugin.tcl
 found: /home/smith/CMM/fims/lib/libfimsPlugins.tcl/SkyCat_plugin.tcl
 found: /home/smith/CMM/fims/lib/libesoPlugins.tcl/PE_SkyCat_plugin.tcl

 SKYCAT_PLUGIN       = >/home/smith/CMM/fims/lib/libesoPlugins.tcl/PE_SkyCat_plugin.tcl:
                        /home/smith/CMM/fims/lib/libfimsPlugins.tcl/SkyCat_plugin.tcl<

Verification of FIMS V.2.32

• Verify the SkyCat version: Press [Help] [About SkyCat]. SkyCat version number must be 2.6.5
• Verify the FIMS version: Press [Help] [About FIMS]. FIMS Version number must be cmm 2.32
• 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.
• Press [FORS2] [Enter Mode] [MOS] to create the FORS mask for MultiObjectSpectroscopy.
If there appears the message
skycat: error while autoloading "fors::FORS::FORSInit": wrong # args: should be "namespace name ?-local? ?-enforced val? ?--? ?commands?"
try
new2old; make -f old.makefile p
( See section 6 of this manual) and start FIMS again.

NEW MODE -->SkyCat V2.6.5 -->  FIMS V2.32 2000/09/23 12:04:21 for FORS2
FORS2 at UT2
load FORS2.isf
19 gris-filt combinations read from  FORS2.isf

modus: mos with mask mos
label: 0
BPM: 0
width: 1.0
length: real
lslit: 0.5
filter:         none 19  2 >> OS filter found ok
 >> 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/mmCD   1.2 A/pix   6.0  12.0 A/''   3.2   6.3 A/mmfc
 >>BLU    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>RED    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>USD    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>SPE    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>CCD total range = 2462.1 A (SR) = 2433.8 A (HR)

grism :         none 17  2                     
 >> 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/mmCD   1.2 A/pix   6.0  12.0 A/''   3.2   6.3 A/mmfc
 >>BLU    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>RED    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>USD    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>SPE    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>CCD total range = 2462.1 A (SR) = 2433.8 A (HR)

colli: COLL_SR+6
FORS2 at UT2
NOMI SCALE : 0.200000''/p = 5.555556e-05 o/p  0.100000''/p = 2.777778e-05 o/p  1
.900729''/mm ff
Ok     : Filter does match Grism
grism :         none 19  2                     
 >> 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/mmCD   1.2 A/pix   6.0  12.0 A/''   3.2   6.3 A/mmfc
 >>BLU    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>RED    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>USD    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>SPE    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>CCD total range = 2462.1 A (SR) = 2433.8 A (HR)

 >> 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/mmCD   1.2 A/pix   6.0  12.0 A/''   3.2   6.3 A/mmfc
 >>BLU    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>RED    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>USD    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>SPE    0.0 A =    0.0 pixel =    0.0 '' =  0.000 ' =     0.000 mm(fp)
 >>CCD total range = 2462.1 A (SR) = 2433.8 A (HR)

mask initialized

Send comments to <[email protected]> Last update: March 14, 2000