NAME

eincdpar -- edit the eincdrom package wide parameters

USAGE

eincdpar

DESCRIPTION

eincdpar contains the parameters which are made available to all of the tasks in eincdrom . It contains directory names for the various Einstein CDROMs and pathnames to tables which contain information on the various datasets.

A user can edit the eincdpar parameter set by calling the eincdpar task. This will put the user in an eparam session of the parameter file eincdpar.par.

PARAMETERS

ipcevtN = "ipcevtN$" (for N=1,2,3,4)

These parameters contain the directories of the four Einstein IPC event CDROMs.

hrievtN = "hrievtN$" (for N=1,2)

These parameters contain the directories of the two Einstein HRI event CDROMs.

eoscatN = "eoscatN$" (for N=1,2,3)

These parameters contain the directories of the three EOSCAT (IPC image) CDROMs.

hriimgN = "hriimgN$" (for N=1,2)

These parameters contain the directories of the two Einstein HRI image CDROMs.

slewcd = "slewcd$"

The directory holding the Einstein slew survey CDROM.

ipcuN = "ipcuN$" (for N=1,2,3,...,18)

These parameters contain the directories of the eighteen Einstein IPC unscreened CDROMs.

ipcevt_info = "eincdromdata$ipcevt_info.tab"

This is the table which holds the information about the IPC event dataset. See info tables below.

hrievt_info = "eincdromdata$hrievt_info.tab"

This is the table which holds the information about the HRI event dataset. See info tables below.

eoscat_info = "eincdromdata$eoscat_info.tab"

This is the table which holds the information about the IPC image dataset. See info tables below.

hriimg_info = "eincdromdata$hriimg_info.tab"

This is the table which holds the information about the HRI image dataset. See info tables below.

slew_info = "eincdromdata$slew_info.tab"

This is the table which holds the information about the IPC SLEW dataset. See info tables below.

ipcu_info = "eincdromdata$ipcu_info.tab"

This is the table which holds the information about the IPC unscreened dataset. See info tables below.

ipcevtindex = "ipcevt1$lists/unix/seqnindx.asc" [OBSOLETE PARAMETER]

This file holds the index file which maps sequence numbers into fits file names for the ipc event CDROMs. This index file must be in the following format:

    I00027 14h/i1409n73.xpa
    I00029 17h/i1710n71.xpa
    I00030 21h/i2109s68.xpa
      .
      .
    (etc.)

hrievtindex = "hrievt2$lists/unix/seqnindx.asc" [OBSOLETE PARAMETER]

This file holds the index file which maps sequence numbers into fits file names for the hri event CDROMs. This index file must be a text file containing columns separated by spaces. The first column must be the sequence number and the third column must be the fits file name. The tag "OGS" may appear directly after the sequence number in the first column. The following is an example of this format:

      .
      .
     585   585 H0951N69.XPA 147.87490  69.30386   29820    62
     586   586 H0951N69.XPB 147.91650  69.91382   13111     7
     587   587 H1334S29.XPB 203.54240 -29.61290   24575     6
     630   630 H1656N35.XPB 254.03690  35.40384    2014    29
  631OGS   631 H1656N35.XPC 254.00690  35.41798   13105   588
      .
      .
    (etc.)

eoscatindex = "eoscat2$lists/unix/seqnindx.asc" [OBSOLETE PARAMETER]

This file holds the index file which maps sequence numbers into fits file names for the EOSCAT CDROMs. This index file must be a text file containing columns separated by spaces. The seventh column must be the sequence number and the ninth column must be the fits file name. The exposure file names (with extensions .R**) will be skipped. The following is an example of this format:

     This file is in order of increasing sequence number

   Right           Declination   Seq      CDROM   Filename
   Ascension                     Num      Dir.


   14h  9m 59s     73d  0m  0s     27      14H    I1409N73.REA
   14h  9m 59s     73d  0m  0s     27      14H    I1409N73.XIA
   17h 10m  0s     71d 10m  1s     29      17H    I1710N71.REA
   17h 10m  0s     71d 10m  1s     29      17H    I1710N71.XIA

The first seven lines on this index file will be ignored.

hriimgindex = "hriimg1$lists/unix/seqnindx.asc" [OBSOLETE PARAMETER]

This file holds the index file which maps sequence numbers into fits file names for the hri image CDROMs. This index file must be a text file containing columns separated by spaces. The first column must be the sequence number and the third column must be the fits file name. The tag "OGS" may appear directly after the sequence number in the first column. The following is an example of this format:

      .
      .
     702   702 H1734S03.XIA 263.74910  -3.24997    2948     2
     706   706 H1759S08.XIA 269.77420  -8.94997    2261     2
  708OGS   708 H1820S30.XIE 275.10770 -30.38884   14317  1020
     709   709 H1820S30.XIF 275.10770 -30.38884    1801  1647
  710OGS   710 H1636S53.XID 249.22480 -53.65102   14158   852
      .
      .
    (etc.)

INFO TABLES

There is one table of information for each dataset. These STSDAS tables store the following information: sequence, fits-root, fits-extension, CD number holding data, RA, DEC, sequence hour, event offset, livetime, and title. See the task ecdinfo for more information on these columns.

These tables make the index tables above obsolete; they will be removed by the next release.

EXAMPLES

1. List the eincdrom parameters in eincdpar.

        xs> lparam eincdpar

2. Edit the eincdrom parameters in eincdpar.

        xs> eincdpar

3. Edit the eincdpar parameters from within the ecdinfo parameter file.

    xs> eparam ecdinfo

        ... edit a few ecdinfo parameters

        ... move down to the eincdpar parameter and type :e

        ... edit the eincdpar parameters and type :q

        ... finish editing the ecdinfo parameters and type :q or ^X

4. Changing a eincdpar parameter from the command line.

    xs> eincdpar.ipcevt1="/mydata/ipcevt1"

SEE ALSO

lparam, eparam, ecdinfo, explain_eincdrom.