% 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}
