Документ взят из кэша поисковой машины. Адрес оригинального документа : http://www.stsci.edu/hst/observatory/crds/documents/mkcomptab.pdf Дата изменения: Unknown Дата индексирования: Sun Mar 2 06:12:55 2014 Кодировка:

Mkcomptab Bernie Simon July 10, 1996
Usage
Mkcomptab is run byentering the name of the task followed by the name of the output le. For example,
mkcomptab hstcomp.tab

The output le is component lookup table. This table is used by the synphot software and associated a component mnemonic with the name of the throughput table containing the component throughput. In order to produce the component lookup table, the software must open each of the throughput tables mentioned in it. Therefore, this task must be run from a machine where the full set of synphot throughput tables is accessible.

Data Files
Mkcomptab uses the directory le to translate between iraf logical directory names and operating system directory names. The name of this le is set bythe macro DIRECTORY NAME in system.h. The directory le has two columns. The rst column contains the name of the iraf logical and the second name contains the translation to the operating system directory name. Subdirectories within the second column are separated by slashes regardless of the host operating system. If the translation does not start with a leading slash, the directory is treated as a subdirectory of the top level CDBS directory, speci ed by the macro CDBSDIR. This allows the same directoy le to be used on di erent systems as long as the same subdirectory structure is used.

Environment Variables
Mkcomptab uses three environment variables that control its access to the database. CDBS SERVER sets the database server the task accesses. CDBS DB set the database that is used by the task. And CDBS USER sets the user name used to access the database. If these three environmentvariables are not found, the values used by the task default to ROBBIE, cdbs ops, and the user's login name, repectively.


Algorithm
The main routine in mkcomptab is named task. It calls mkcomptab to create a load le containing the component lookup table and write sdastab to write it out as an SDAS format table. Mkcomptab calls init comptab to create an empty component lookup table, comptab query to ll the table from the CDBS database, and update comp to modify the table using information from the throughput les. Init comptab writes the required header keywords to the load le and then creates empty table columns. Comptab query retrieves the names of the latest version of each component throughput le from the CDBS database. Along with the lename it also retrieves the component mnemonic, the comment, the installation date, and the useafter date. All this information, except the useafter date, is written to a row in the load le. The useafter dates are used to compute the useafter date of the component lookup table, whichis written to the table header. Update comp looks at each throughput le mentioned in the lookup table. If the name of the column storing the throughput information is some other name than THROUGHPUT, it place the column name in brackets after the lename in the lookup table. If it is a parameterized throughput table, the value of the parameter is removed from the column name rst. Update comp calls getthrucol to get the name of the table column containing the throughput information. It in turn calls getthrulist to get a list of all the throughput columns in the table. If there is more than one, it calls similar to choose which throughput column name most closely matches the component mnemonic. Getthtrulist calls xlate fname to translate the throughput le name from an iraf logical name to a host operating system name. It then opens the table and adds all columns except the wavelength and error columns to the list. If a throughput column is parameterized, it removes the parameter value before adding it to the list. Xlate fname reads the dictionary le and substitutes for any string in the lename ending with a dollar sign. The substitution is done repeatedly, so iraf logicals in the directory le can be de ned in terms of other iraf logicals. If the resulting directory name does not begin with a slash, the directory name is appended to the directory de ned by the macro CDBSDIR.

Test Data
Mkcomptab does not need any input les to run. All information is read from the database and the throughput tables. The argument to mkcomptab is the name of the output le.
mkcomptab hstcomp.tab

2