The Task INSTALL_CALDB.PERL


General questions, bug reports etc concerning this task should be e-mailed to caldbhelp@oheasarc.gsfc.nasa.gov

Task Author: Lorraine Breedon


Current Version

The current version can be downloaded from ftp://heasarc.gsfc.nasa.gov/caldb/software/tested/install_caldb.perl. Note:
  1. You'll need to change the first line of the script from
    #!/usr1/local/bin/perl5
    to point to your local perl installation (type % which perl at the unix prompt to find your local perl installation)
  2. You'll need to have the PERL libnet module which includes the NET::FTP perl modules already installed.


Overview

This script prompts the user for the full path to their local CALDB. Then using this path as the cwd it downloads the file caldb_setup_files.tar.Z and *.tar.Z files for requested mission/instruments via anonymous ftp from the HEASARC CALDB.

As input, no parameters are required. However an optional input parameter (dspace_check) will force the script to perform disk space checks prior to uncompression and untarring of each file. If omitted no checks performed!

For each tar file the script then:

  • Uncompresses and untars the file
  • Creates the appropriate directory structures
  • Populates the directory tree with files
  • Moves the /data/tarredcif to data/{mission}/{instrument}/caldb.indx (if NOT caldb_setup_files.tar!).
  • Edits the appropriate CALDB initialisation files such that the line which defines the environment variable CALDB points to the top=level directory of the local CALDB.

Each compressed tar file for a given mission/instrument contains :

  • ./data/{mission}/{instrument}/../../calfilenames
  • ./data/tarredcif (the caldb.indx file for the {mission}/{instrument}).
  • ** ./data/{missn}/{instr}/goodfiles_{missn}_{instr}_special.ASCII (list of all good quality cal files within the caldb.indx together with last-modification-date info ....this ASCII file is necessary to perform any future up-dates to the local caldb.indx of a HEASARC-supported mission but with personal/locally produced datasets added).
  • ** ./data/input.ASCII (contains 4 lines..{mission};{instrment}, {instrument alias}; name of special ASCII file).

The file caldb_setup_files.tar.Z contains :

  • ./software/tools/caldbinit.unix (for initialising environment variables or unix-style systems running FTOOLS outside IRAF).
  • ./software/tools/caldbinit_iraf.unix file (for initialising environment variables for unix-style systems running FTOOLS from within IRAF).
  • ./software/tools/caldbinit.sh (for initialising environment variables in Bourneshell).
  • ./software/tools/caldb.config file (to indicate the location of caldb.indx files).
  • ./software/tools/alias_config.fits file (for instrument alias info).

Page author:
Michael F. Corcoran
Last updated: Wednesday, 20-Oct-2021 10:29:15 EDT.