# README.Release
# $Header: /imaging/config/dev/src/issa/src/RCS/README,v 2.7 1993/05/06 21:02:44 rick Rel $

  issaffld is a utility for determining which ISSA (IRAS Sky Survey Atlas)
  fields cover a given position on the sky.   The program also reports
  which CDs, from the combined 1991 release (of |Ecliptic Latitude|>50 degrees)
  and 1993 release,  contain the fields.  (CD Numbers 0 and 1 contain coadded
  versions of all the released fields (rejected fields are stored in a
  separate subdirectory on each disk.  CD's 2,3 & 4 were released in 1991 and
  contain HCON data and coadds.  CD's 5-9 contain HCON and coadds for the
  remainder of the sky surveyed by IRAS.  CD's 7,8, & 9 contain images for
  rejected fields (criteria for inclusion of fields are given in the ISSA
  Explanatory supplement.)

  An earlier version of this program, issa_ffield, was included in the
  1991 release.  issaffld is an expanded version of that program, but with
  a shortened name in order that it might conform to the all too common
  "8+3" filename restriction (8 characters plus 3 character extension).

  A typical example of the use of issaffld would look like this:


   system_prompt%> issaffld 00h30m01.8s 45d10m12.0s Equ
   

    Input Coordinates:
     00h30m01.8s   +45d10m12.0s   (Equ 1950.00)
     00h30m01.8s   +45d10m12.0s   (equatorial 1950.00)
     7.507500(deg)  45.170000(deg)
   
   
    R
    e
    j
    e B
    c e        Nearest                  ISSA Disk#
    t s Field   Edge    Field Center   Coadd  Coadd
    ? t Number (arcmin)  RA     DEC     only  & HCON 
    =================================================
         337    49.0      0.0   40.0     1     6    
         338    56.0     13.0   40.0     1     6    
         365    56.0      0.0   50.0     1     4    
      >  366    56.6     15.0   50.0     1     4    

   
  Below are instructions for building and using issaffld.

  We would appreciate your comments and suggestions regarding this software.
  Send comments to

      imaging@ipac.caltech.edu



  Rick Ebert  <rick@ipac.caltech.edu>
  John White
  Xiuqin Wu

  Infrared Processing and Analysis Center (IPAC)
  Jet Propulsion Laboratory (JPL)
  California Institute of Technology (CalTech)
  MS 100/22, Pasadena, CA 91125

  Wed May  5 18:31:12 1993 (UTC-0700)

#  

--------
Building
--------
  
  Release (Version 3.0) has been compiled and tested on the
  following systems:

  SunOS Release 4.1.2 (cc & gcc 2.3.3)
  DEC3100 & Ultrix V4.2 (rev 96)
  HP9000 & HP-UX
  Borland C
    IBM PC/XT
    i486 
    Toshiba Laptop


 * UNIX

  To compile issaffld on unix systems,
  copy the accompanying files to a writable directory, renaming the file
  "makefile." to "makefile" if necessary.  Edit Makefile or copy one of
  the supplied makefiles to "makefile" for your system.

  makefile.unx  - for "generic" unix
  makefile.hp   - slight twist for HP unix
  makefile.ans  - Unix with ANSI-C compiler environment (read the header).
  
  Change to that directory and type:

  make unix     - for "generic" unix
  make dec      - DEC3100 with Ultrix
  make sun      - Sun sparcstation with SunOS 4.1.2
  make hp       - HP9000 with HP-UX


  * DOS

  To compile issaffld on a DOS system with a BorlandC compiler, copy the
  files to a writable directory and edit makefile.dos for your system.

  makefile.dos  - PC/Borland C combination (A issaffld.exe file is included)

  Then change to that directory and run:

  make -fmakefile.dos


 * VMS

  To compile issaffld on VMS systems copy the accompanying files
  to a writable directory, set the default to that directory and type:

  @ buildvms.com

  Complete the setup by defining a symbol for issa_ffield:

  issaffld :== $ISSADIR:issaffld.exe

  (of course, ISSADIR is name the directory in which issaffld.exe resides).

#



 -------
 Using
 -------

  The issaffld program is self-documenting.  Execute the program with
  no arguments and it will print out usage and version information.
  A copy of this information is included below. 

Usage: issaffld [-v] Long  Lat  Coord  [Equinox [Band [HCON]]]
   or: issaffld -c[v] RA(degrees)  Dec(degrees) [Band [HCON]]

   -v turns off verbose output (default is on) and
      returns only the filename for the best plate
   -c bypasses the use of the coordinate calculator
      so that RA and DEC inputs are interpreted as decimal
      degrees in B1950 coordinates.

      Inputs Long, Lat and Coord specify the Longitude,
      Latitude, and Coordinate System (first 2 characters,
      upper or lower case) of the desired position.
      Coordinate Systems are:

           Equatorial     (eq)
           Ecliptic       (ec)
           Galactic       (ga)
           Supergalactic  (su)

      If the Coordinate System is Equatorial the fourth
      argument, if present, is expected to be the equinox.
      Band (optional) is the IRAS band number (1,2,3,4).
      HCON (optional) is the IRAS HCON (0 for coadd,1,2,3).
      Sexagesimal notation maybe used (without the -c option).

      Coordinates may be specified:
         nnHnnMnn.nS    nnDnnMnn.nS
         nnH nnM nn.nS  nnD nnM nn.nS
         nn:nn:nn.n
         nnnnn.nS        (for decimal arc seconds)
         nnnnn.nnn       (for decimal degrees)

    EXAMPLES:
         issaffld 7 45 eq
         issaffld 00h30m01.8s 45d10m12.0s Equ
         issaffld 00h27m19.7s 44d53m37.8s Equ 2000
         issaffld 00d28m00.0s 63d59m28.0s Ecliptic
         issaffld 00d28m00.0s 63d59m28.0s ec 4 3
         issaffld 128d45m40.5s -37d22m28.1s ga 3

 Output
 Column:       Description:

 Reject?       -Contains 'R' if the field was rejected in processing
 Best          -Field with largest target to edge distance has '>'
 Field Number  -ISSA Field number (1<=Fn<=430)
 Nearest Edge  -Distance to edge from target position (arc minutes)
 Field Center  -Decimal RA/Dec (B1950) at the center of field
 ISSA Disk#    -CDROM numbers on which this field is located
                Disks 0 and 1 contain only coadded images
                  (Reject plates are in separate subdirectory
                   on disks 0 and 1.
                Disks 2-9  contain coadded and HCON images
                Disks 7-9  contain rejected coadd and HCON images
 File          -If a particular IRAS Band or HCON was specified
                   this field will be present giving the image
                   file name:
                     iFFFbBhH.fit (FFF-field#, B-Band, H-HCON )

   Authors: Rick Ebert, J. White & Xiuqin Wu
            Infrared Processing and Analysis Center
            (c) 1991,1993 California Institute of Technology
   Revision Number: 3.0 (May 5, 1993)
   CDROM Manifest: ISSA 1993 Release

# End of README
