README file for CALDB 2.0 DE Graessle, Chandra CALDB Manager December 4, 2000 Includes brief Intro, Download instructions, Unpacking instructions, Pointers for further assistance. Chandra CALDB version 2.0 will be required for running CIAO 2.0. This is because the Chandra ARDLIB and certain other user tools now reverence the CALDB index automatically, unless the user specifies a path to particular files in the corresponding parameter file (via "pset"). To learn more about the Chandra CALDB, and to find this information on the WEB, you are referred to http://cxc.harvard.edu/caldb/index.html For Release Notes to the Chandra CALDB 2.0, see http://cxc.harvard.edu/caldb/version_release_notes.html Most of the included information is available at http://cxc.harvard.edu/caldb/download.html. 12/04/2000: LAST MINUTE CHANGES to RELEASE: 1) The new meta-FEF's we have been preparing for CALDB 2.0 will not be available for a few days, at current estimate. Instead we are providing tar'd files of the previous FEF library, for *temporary* inclusion in the CALDB 2.0. The old FEF library is not indexed, but acis_fef_lookup will still find them if they are located properly, in the absence of the meta-FEFs. 2) We are preparing LETG/ACIS-S grating RMF's for release in CALDB 2.0, but they will also not be released for a few days at present estimate. Watch the CXC CALDB web page for updates on these files. Instructions for Downloading and Unpacking CALDB 2.0 -------------------------------------------------------------------------------- Instructions for Downloading: Download all files into the same directory, where you intend to install your Chandra CALDB 2.0. You will need at least 136 MBytes free to unpack the basic structure. The FEF library v1 requires an additional The PSF library requires approximately 6.5GB, fully unpacked, but you might not need all of it at once. See the following ftp links to acquire the CALDB download tar files for version 2.0: MAIN CALDB DIRECTORY AND FILES: 1. ftp://cda.harvard.edu/arcftp/caldb/caldb_2.0.main_nf.tar.gz SIZE=28,886,134 byts. Unpacked = 67.7MB [NOTE: this file does not contain the new meta-FEF library, which is still being developed; a new version of this file with the new meta-FEFs will be out later, called caldb_2.0.main.tar.gz. Watch the web page for updates on the much more user-friendly meta-FEF's.] NEW PSF LIBRARIES: (You only need these if using mkpsf. They are LARGE!) 2. ftp://cda.harvard.edu/arcftp/caldb/acis_psflib_2.0.tar 3. ftp://cda.harvard.edu/arcftp/caldb/hrc_psflib_2.0.tar NOTE: The PSF files are gzip'd first and then tar'd. You can unzip any, all, or none at a time until you are ready to use them. Site managers with multiple users may be better off to unzip all. PREVIOUS FEF LIBRARY (Version 1) in lieu of new meta-FEF's: 4. ftp://cda.harvard.edu/arcftp/caldb/acis_fefs_90_v1.tar.gz 5. ftp://cda.harvard.edu/arcftp/caldb/acis_fefs_100_v1.tar.gz (BI's only!) 6. ftp://cda.harvard.edu/arcftp/caldb/acis_fefs_110_v1.2.tar.gz 7. ftp://cda.harvard.edu/arcftp/caldb/acis_fefs_120_v1.tar.gz TABLE 1: Files and sizes: FILENAME Ship Size(byte) Unpacking space cksum 1. caldb_2.0.main_nf.tar.gz 28,886,134 64 MB 1315386545 2. acis_psflib_2.0.tar 174,506,496 175 MB* 2888233756 3. hrc_psflib_2.0.tar 186,465,792 187 MB* 3802649049 4. acis_fefs_90_v1.tar.gz 61,976,973 124 MB 518917292 5. acis_fefs_100_v1.tar.gz 55,492,267 113 MB 4126801809 6. acis_fefs_110_v1.2.tar.gz 257,812,073 441 MB 1921012585 7. acis_fefs_120_v1.tar.gz 257,251,809 441 MB 2981407815 * The individual PSF files will still be gzip'd when unpacked. NOTE: The -90C and -100C files go together, as the BI chips only changed between -90C and -100C temperatures. The FI's (sigh) were independent of temperature at that time, before CTI due to radiation damage set in. Instructions for unpacking: 1. Locate a place for your CALDB. Designate an empty directory to be assigned to the value of $CALDB. Unpack file 1 above from that location. 2. Edit the $CALDB/software/tools/caldbinit.* files to include the literal absolute path of your $CALDB directory. Currently that is set to "/data/CALDB/CALDB_2.0" in those files. 3. Unpack the psf tar files 2 and/or 3 from the $CALDB directory if your site needs them. Verify that the gzip'd files are in ./data/chandra/acis/cpf/2dpsf and ./data/chandra/hrc/cpf/2dpsf directories. 4. You may gunzip the psf files as needed, keeping in mind they gunzip to large volumes. Site managers may be well-advised to provide the space and unzip them all immediately, depending on usage. 5. The FEF library is divided up into different temperatures. Unzip and tar xvf these files from your CALDB ($CALDB) main directory as well, and they will go to ./data/chandra/acis/cpf/fefs/FP-***/, one subdirectory for each ACIS temperature. 6. Delete the tar files The latest versions will be maintained online at CXC at all times. ------------------------------------- Instructions for Editing the $CALDB/software/tools/caldbinit.* files: --------------------------------------------------------------------- See the CALDB download page for instructions and examples of how to set this up at your site. http://cxc.harvard.edu/caldb/download.html, Section 3. These files are used in various shells to set the $CALDB environment variable, and two others. The default location is /data/CALDB/CALDB_2.0, which is fine if you have it, but may not exist at your site, and may not be what you have used to locate the CALDB. *** After editting the caldbinit.* files appropriately: At this point, you should be ready to proceed with CIAO 2.0 installation completion. You will be assigning the default CALDB within CIAO 2.0 to the directory tree you have just unpacked. -- Chandra CALDB Manager