INSTALLATION (Feb05)             decsim0            INSTALLATION (Feb05)



           DECSIM0: DARK ENERGY CAMERA TOOLS FOR SIMULATION 0
              Release Notes and Installation Instructions



SUMMARY
The DECSIM0 external package provides  tools  for  handling  the  ImSim0
data  from  Fermilab.  The main tool is for converting the Fermilab data
to a format with 124 extensions, a WCS, and additional keywords suitable
for MSCRED based tasks.



RELEASE INFORMATION
The  following  summary  only  highlights the major changes.  There will
also be minor changes and bug fixes as needed.


V1.2: March 18, 2005
    DS0CONVERT uses a list  of  CCD  indices  rather  than  a  range  to
    selected  a  subset  of  CCDs to convert.  Also placeholder keywords
    were added to the global header to avoid a later recopy when  adding
    keywords during processing.

V1.1: February 24, 2005
    DS0CONVERT  was  modified  to support processing a list of input, to
    allow converting a subset of the CCDs, and to add TELRA  and  TELDEC
    keywords  which  point to the center of the field which is different
    than the WCS tangent point.  The  header  reference  file  was  also
    modified.

V1.0: February 3, 2005
    Initial version with two tasks for converting formats and making bad
    pixel masks.



INSTALLATION INSTRUCTIONS
Installation of this external package consists of obtaining  the  files,
creating   a   directory   containing  the  package,  and  defining  the 
environment to load and run the package.  The package may  be  installed
for  a  site or as a personal installation.  If you need help with these
installation  instructions  contact  iraf@noao.edu  or  call  the   IRAF 
HOTLINE at 520-318-8160.

[1-site]
    If  you  are  installing  the package for site use login as IRAF and
    edit the IRAF file defining the packages.
    
        % cd $hlib
        % vi extern.pkg
    
    Add the following to the file.
    
        reset decsim0 = <path>/decsim0/
        task  decsim0.pkg = decsim0$decsim0.cl
    
    Near the end of the hlib$extern.pkg file, update the  definition  of
    helpdb  so it includes the decsim0 help database, copying the syntax
    already  used  in  the  string.   Add  this  line  before  the  line 
    containing a closing quote:
    
        ,decsim0$lib/helpdb.mip\

[1-personal]
    In your login.cl or loginuser.cl file make the following definitions
    somewhere before the "keep" statement.
    
        reset decsim0 = /mydir/decsim0/
        task  decsim0.pkg = decsim0$decsim0.cl
        printf ("reset helpdb=%s,decsim0$lib/helpdb.mip\nkeep\n",
            envget("helpdb")) | cl
        flpr

[2] Login into IRAF.  Create a directory to contain the package files as
    defined  above.   This directory should be outside the standard IRAF
    directory tree.
    
        cl> mkdir decsim0$
        cl> cd decsim0

[3] The package is distributed as a tar archive.
    
        cl> ftp iraf.noao.edu (140.252.1.1)
        login: anonymous
        password: [your email address]
        ftp> cd pub/valdes
        ftp> get decsim0.readme
        ftp> binary
        ftp> get decsim0.tar.gz
        ftp> quit
        cl> !gunzip decsim0.tar
    
    The readme file contains these instructions.

[4] Extract the source files from the tar archive using 'rtar".
    
        cl> softools
        so> rtar -xrf decsim0.tar
        so> bye
    
    The tar file can be deleted once it has been successfully installed.

This should complete the installation.  You can  now  load  the  package
and begin testing and use.

To use the package first load it.