% Documentation for A Catalog of Stellar Spectrophotometry (Adelman et al. 1989) % % Document Number: NSSDC/WDC-A-R&S 90-03 % % Written: January 1990 by W.H. Warren Jr. and S.J. Adelman % TeX Ver: March 1991 by L.E. Brotzman % \documentstyle [adc,11pt]{article} % \newcommand{\dmv}{Documentation for the Machine-Readable Version of} \newcommand{\cat}{A Catalog of Stellar Spectrophotometry} \newcommand{\catref}{Adelman {\em et al.} 1989} \newcommand{\adc}{Astronomical Data Center} \newcommand{\docnum}{NSSDC/WDC-A-R\&S 90-03} % \begin{document} % \setcounter{page}{0} \thispagestyle{empty} \null \vfil \vskip 1in \begin{center} \begin{tabular}{c} {\LARGE \cat} \\ \\ {\Large (\catref)} \\ \\ Documentation for the Computer-Readable Version \\ \\ {\small Wayne H. Warren Jr.} \\ {\small National Space Science Data Center} \\ \\ {\small Saul J. Adelman} \\ {\small The Citadel} \\ \\ {\small January 1990} \\ \\ {\small Doc. No. \docnum} \\ \\ \\ {\small National Space Science Data Center (NSSDC)/} \\ {\small World Data Center A for Rockets and Satellites (WDC-A-R\&S)} \\ {\small National Aeronautics and Space Administration} \\ {\small Goddard Space Flight Center} \\ {\small Greenbelt, MD 20771} \end{tabular} \end{center} \vfil \null \pagebreak \begin{abstract} The machine-readable version of the catalog, as it is currently being distributed from the astronomical data centers, is described. The catalog is a collection of spectrophotometric observations made by Adelman, Pyper, Shore, and White using rotating grating scanners and calibrated with the fluxes of Vega. The observations cover various wavelength regions between about 330 nm and 1080 nm. \end{abstract} \section{Introduction} \subsection{Description} {\em \cat} is a collection of spectrophotometric measurements obtained with rotating grating scanners attached to various telescopes at the Kitt Peak National, Mount Wilson, and Palomar Observatories. The observations were made during the 1970s and early 1980s, both individually and jointly, by S. J. Adelman, D. M. Pyper, S. N. Shore, and R. E. White, and are contained and analyzed in several series of papers included in the bibliography for this documents and in the source reference. All measurements were calibrated with the fluxes of $\alpha$ Lyrae (Vega), as presented by Hayes and Latham (1975). The catalog was compiled for purposes of making the collection of digital data available in a single, convenient location and to make permanent archiving and distribution of the complete set of observations possible. This document describes the machine-readable version of {\em \cat} as it is currently being distributed from the international network of astronomical data centers. It is intended to enable users of the machine version to read and process the data without problems and guesswork. Although this document may be used without reference to the source publication, which is essentially only an announcement of the catalog's availability, the original series of papers referred to in the bibliography should be consulted before the spectrophotometric observations are used for scientific purposes. {\bf A copy of this document should be transmitted to any recipient of the machine-readable catalog originating from the data centers}. \subsection{Source Reference} \begin{references} \item Adelman, S. J., Pyper, D. M., Shore, S. N., White, R. E., and Warren, W. H. Jr. 1989, {\em Astron. Astrophys. Suppl.} {\bf 81}, 221-223. \end{references} \pagebreak \section{Structure} \subsection{File Summary} \label{s:FS} The machine version of {\em \cat} consists of two files. The first file contains textual information, such as introductory remarks, a complete bibliography of original papers where the observations were first presented and discussed, and an index of observed stars. The second file contains the spectrophotometric data. Table \ref{t:sumtab} gives the machine-independent file attributes. All logical records are of fixed length, and, if the atlas is received on magnetic tape, it will contain blocks of fixed length (as noted below) except that the last block of each file may be short. \begin{table}[htbp] \centering \begin{tabular}{|c|l|c|c|r|} \hline \multicolumn{5}{|c|}{\cat} \\ \multicolumn{5}{|c|}{(\catref)} \\ \hline & & Record & Record & \multicolumn{1}{c|}{Number of} \\ File & \multicolumn{1}{c|}{Contents} & Format & Length & \multicolumn{1}{c|}{Records} \\ \hline 1 & Text & Fixed & 80 & 311 \\ 2 & Data & Fixed & 70 & 9492 \\ \hline \end{tabular} \caption{Summary Description of Catalog Files} \label{t:sumtab} \end{table} The information contained in the above table is sufficient for a user to describe the indigenous characteristics of the machine-readable version of {\em \cat} to a computer. Information easily varied from installation to installation, such as block size (physical record length), blocking factor (number of logical records per physical record), total number of blocks, density, number of tracks and character coding (ASCII, EBCDIC) for tapes, is not included, but should always accompany secondary copies if any are supplied to other users or installations. \subsection{Text File (File 1 of 2)} \label{s:cathdi} This file contains free-field textual information only and should be used only as reference material. A brief description of the data that may be given for each star is followed by a complete bibliography of the source papers and an index, arranged by right ascension, of the stars in the catalog. \begin{table}[htbp] \centering \begin{tabular}{|c|c|l|} \hline & Suggested & \\ Bytes & Format & \multicolumn{1}{c|}{Data} \\ \hline 1-80 & A80 & Mixed case text \\ \hline \end{tabular} \caption{Text File Record Format} \label{t:catint} \end{table} \subsection{Catalog (File 2 of 2)} \label{s:cathdc} The data file contains all spectrophotometric observations of the catalog. Each observation is preceded by a set of two header records giving object identifications and other relevant information. The observations are presented as data pairs with wavelength (in \AA) and the normalized magnitude at that wavelength. The number of data pairs in a spectrum varies depending on the instrument used and the $\lambda$ range, but the number of pairs is given in the second header record, as described below. Thus, after reading the header records, the following simple Fortran statements can be used to read the data array (there are five data pairs per logical record): \begin{verbatim} Real*4 Lam(500),Mag(500) Read (1,10) (Lam(n),Mag(N), N=1,NWL) 10 Format (5(F7.0,F7.3)) \end{verbatim} \noindent where NWL is the number of wavelengths read from the second header record. The following tables describe the formats of the header records that must be read before processing the data points. The suggested format specifications are given for reference purposes only and can be modified depending on individual programming and processing requirements; {\em e.g.}, a user may wish to read star identifiers from the major catalogs as numbers (only character formats are given in the tables, except for NWL, which must be read with a numerical format so that it can be used as a DO loop index). The descriptions of the data indicate the bytes that should be used to read with numerical specifications. \begin{table}[htbp] \centering \begin{tabular}{|c|c|c|c|l|} \hline & & Suggested & Default & \\ Bytes & Units & Format & Value & \multicolumn{1}{c|}{Data} \\ \hline 2-9 & --- & A8 & --- & Star name \\ 10-18 & --- & A9 & --- & HD number \\ 19 & --- & 1X & --- & Blank \\ 20-27 & --- & A8 & --- & HR number \\ 28-32 & --- & 5X & --- & Blank \\ 33-41 & --- & A9 & --- & {\em B-V} \\ 42-43 & --- & 2X & --- & Blank \\ 44-70 & --- & A27 & --- & Spectral type and comments \\ \hline \end{tabular} \caption{Contents of the First Record in Each Spectrum} \label{t:recone} \end{table} \begin{definition}{15ex} \item[Star name] Name of star, usually a Bayer designation and constellation identification or variable-star designation. \item[HD number] Number in the {\em Henry Draper Catalogue} (Cannon and Pickering 1918-24). The letters ``HD'' occur in bytes 10-11 and the number in 13-18. \item[HR number] Number in the {\em Bright Star Catalogue} (Hoffleit 1982). The letters ``HR'' occur in bytes 20-21, the number in 23-26, and a component designation in 27 (if applicable). \item[B-V] {\em B-V} in the Johnson and Morgan {\em UBV} system, taken from a variety of sources. The characters ``B-V'' occur in bytes 33-35 and the value in 37-41. \item[Spectral type] Spectral types taken from a variety of sources. The characters ``SP'' occur in bytes 44-45. The spectral type may be followed by comments. \end{definition} \begin{table}[htbp] \centering \begin{tabular}{|c|c|c|c|l|} \hline & & Suggested & Default & \\ Bytes & Units & Format & Value & \multicolumn{1}{c|}{Data} \\ \hline 2-6 & --- & A5 & --- & Bandwidth \\ 7-8 & --- & 2X & --- & Blank \\ 9-16 & --- & A8 & --- & Paper identification \\ 17-18 & --- & 2X & --- & Blank \\ 19-23 & --- & A5 & --- & Number of scans \\ 24-25 & --- & 2X & --- & Blank \\ 26-41 & --- & A16 & --- & Heliocentric Julian date \\ 42-47 & --- & 2X & --- & Blank \\ 48-50 & --- & A3 & --- & The letters NWL \\ 51-53 & --- & I3 & --- & Number of data pairs (wavelengths) \\ 54-58 & --- & 5X & --- & Blank \\ 59-70 & --- & A12 & --- & Magnitude at 5000 \AA \\ \hline \end{tabular} \caption{Contents of the Second Record in Each Spectrum} \label{t:rectwo} \end{table} \begin{definition}{17ex} \item[Bandwidth] Bandwidth in the second order (\AA). \item[Paper] The number of the paper in which the original data appeared, as given in the bibliography included in the text file. \item[Number of scans] Number of separate scans included in the average spectrum. \item[HJD] Heliocentric Julian date for variables. \item[NWL] Number of wavelengths (data pairs) in the spectrum. \item[m5000] The magnitude at 5000 \AA. \end{definition} \pagebreak \section{History} \label{s:history} \subsection{Remarks} The text and data files were prepared initially at The Citadel by S. J. Adelman following discussions about an acceptable structure and format for the catalog. Proofreading was done with the assistance of Carol J. Adelman and Jeffrey A. Garret. The data were transferred to the \adc\ via BITnet. Extensive checks of the header records resulted in minor corrections and changes, {\em e.g.}, to correct shifted data and to insert mixed case characters where appropriate. \section{Acknowledgments and References} \subsection{Acknowledgments} Appropriate acknowledgments are given in the source reference. The preparation of the machine version was greatly assisted by the proofreading of Carol J. Adelman and Jeffrey A. Garret. \subsection{References} \begin{references} \item Adelman, S. J. 1978, {\em Astrophys. J.} {\bf 222}, 547. \item Adelman, S. J. 1979, {\em Publ. Astron. Soc. Pac.} {\bf 91}, 198. \item Adelman, S. J. 1980{\em a}, {\em Astron. Astrophys.} {\bf 86}, 149. \item Adelman, S. J. 1980{\em b}, {\em Astron. Astrophys. Suppl.} {\bf 42}, 375. \item Adelman, S. J. 1981{\em a}, {\em Astron. Astrophys. Suppl.} {\bf 43}, 25. \item Adelman, S. J. 1981{\em b}, {\em Astron. Astrophys. Suppl.} {\bf 43}, 183. \item Adelman, S. J. 1981{\em c}, {\em Astron. Astrophys. Suppl.} {\bf 44}, 265. \item Adelman, S. J. 1981{\em d}, {\em Astron. Astrophys. Suppl.} {\bf 44}, 309. \item Adelman, S. J. 1982, {\em Astron. Astrophys. Suppl.} {\bf 49}, 663. \item Adelman, S. J. 1983, {\em Astron. Astrophys. Suppl.} {\bf 51}, 511. \item Adelman, S. J., Hensberge, H., and van Rensbergen, W. 1984, {\em Astron. Astrophys. Suppl.} {\bf 57}, 121. \item Adelman, S. J. and Pyper, D. M. 1979{\em a}, {\em Astron. J.} {\bf 84}, 1603. \item Adelman, S. J. and Pyper, D. M. 1979{\em b}, {\em Astron. J.} {\bf 84}, 1726. \item Adelman, S. J. and Pyper, D. M. 1983{\em a}, {\em Astrophys. J.} {\bf 266}, 732. \item Adelman, S. J. and Pyper, D. M. 1983{\em b}, {\em Astron. Astrophys.} {\bf 118}, 313. \item Adelman, S. J. and Pyper, D. M. 1985, {\em Astron. Astrophys. Suppl.} {\bf 62}, 279. \item Adelman, S. J., Pyper, D. M., Shore, S. N., White, R. E., and Warren, W. H. Jr. 1989, {\em Astron. Astrophys. Suppl.} {\bf 81}, 221-223. \item Adelman, S. J., Pyper, D. M., and White, R. E. 1980, {\em Astron. Astrophys. Suppl.} {\bf 43}, 491. \item Adelman, S. J. and Shore, S. N. 1982, {\em Astron. J.} {\bf 87}, 665. \item Adelman, S. J. and White, R. E. 1980, {\em Astron. Astrophys. Suppl.} {\bf 42}, 289. \item Cannon, A. J. and Pickering, E. C. 1918-24, {\em The Henry Draper Catalogue}, {\em Ann. Astron. Obs. Harvard College} {\bf 91-99}. \item Hoffleit, D. (with the collaboration of Jaschek, C.) 1982, {\em The Bright Star Catalogue}, 4th revised edition (New Haven: Yale University Observatory). \item Johnson, H. R., Adelman, S. J., Ake, T. B., and Hunt, T. 1990, in preparation. \item Hayes, D. S. and Latham, D. W. 1975, {\em Astrophys. J.} {\bf 197}, 593. \item Pyper, D. M. and Adelman, S. J. 1983, {\em Astron. Astrophys. Suppl.} {\bf 51}, 365. \item Pyper, D. M. and Adelman, S. J. 1985, {\em Astron. Astrophys. Suppl.} {\bf 59}, 369. \item Pyper, D. M. and White, R. E. 1990, in preparation. \item Shore, S. N. and Adelman, S. J. 1984, {\em Astrophys. J.} {\bf 54}, 151. \item Shore, S. N. and Adelman, S. J. 1989, private communication. \item White, R. E., Pyper, D. M., and Adelman, S. J. 1980, {\em Astron. J.} {\bf 85}, 836. \end{references} \end{document}