% Photoelectric Photometric Johnson UBVRI (Lanz 1986) Documentation
%
% Document Number: STX-T-25-3002-0022-87
%
% Written: Oct. 1987 by Anne Raugh
% Converted to LaTeX: Oct. 1990 by Lee Brotzman
%
\documentstyle [adc,11pt]{article}
%
\newcommand{\dmv}{Documentation for the Computer-Readable Version of the}
\newcommand{\catone}{Photoelectric Photometric Catalogue in the}
\newcommand{\cattwo}{Johnson UBVRI System}
\newcommand{\abbr}{UBVRI}
\newcommand{\catref}{Lanz (1986)}
\newcommand{\pcatref}{Lanz 1986}
\newcommand{\docnum}{STX-T-25-3002-0022-87}
%
\begin{document}
%
\setcounter{page}{0}
\thispagestyle{empty}
\null \vfil \vskip 1in
\begin{center}
\begin{tabular}{c}
      {\LARGE \catone} \\
      {\LARGE \cattwo} \\
      \\
      {\Large (\pcatref)} \\
      \\
      Documentation for the Computer-Readable Version \\
      \\
      Anne C. Raugh \\
      October 1987 \\
      \\
      {\small Doc. No. \docnum} \\
      {\small Contract NAS 5-28752} \\
      \\
      \\
      {\small Prepared for:} \\
      {\small National Aeronautics and Space Administration} \\
      {\small Goddard Space Flight Center} \\
      {\small Greenbelt, MD 20771} \\
      \\
      \\
      {\small Prepared by:} \\
      {\small ST Systems Corporation} \\
      {\small 4400 Forbes Blvd.} \\
      {\small Lanham, Maryland 20706}
\end{tabular}
\end{center}
\vfil \null
\pagebreak

\begin{abstract}

This document describes the computer-readable version of the {\em \catone\
\cattwo } (\pcatref) distributed by the Astronomical Data Center, NASA
Goddard Space Flight Center. This catalog is a compilation of photoelectric
photometry in the Johnson {\em UBVRI} system published prior to mid-1984.
Included are data reduced with the Johnson {\em UBVRI} standard stars as well
as three other secondary sets of standards. Listed are code number, {\em V},
$U-B$, $B-V$, $V-R$, $R-I$, {\em I}, number of observations, references, and
mean values for a total of 6,849 stars in the original Johnson system (Morel
and Magnenat 1978), 467 stars in the system of Kunkel and Rydgren (1979), 1,150
stars in the system of Moffett and Barnes III (1979), and 252 stars in the
system of Neckel and Chini (1980).

The catalog is in 14 files. Three files are included for each standard system:
the first file lists the published data; the second file lists the mean values
from the data in the first homogenized to the standard system; and the third
file lists references. Two additional files contain (1) a description of the
numbering system of Mermilliod (1978) used to identify catalog objects, and (2)
a summary file with introductory information and references formatted for
printing. The present document describes the overall file structure and the
individual data fields.

\end{abstract}

\section{Introduction}

{\bf A copy of this document should be distributed with every copy of the
computer-readable catalog.}

\subsection{Description}

The {\em \catone\ \cattwo } (\abbr ; \pcatref ) is a compilation of
photoelectric photometry in the Johnson {\em UBVRI} system published prior to
mid-1984. Included are the data compiled by Morel and Magnenat (1978) along
with more recent observations in the Johnson standard system; and, in separate
files, data reduced using the secondary standards of Kunkel and Rydgren (1979),
Moffett and Barnes III (1979), and Neckel and Chini (1980).

The catalog is in 14 files: the first 12 files list observational data, mean
values, and references for each of the four standard systems; one file
describes the numbering scheme of Mermilliod (1978) used to identify objects in
this catalog; and a final file contains a summary of Lanz (1986) with several
tables of mean results and references for HD/BD stars and cluster stars.

There are three files for each standard system: the first file lists
identification, $V$, $U-B$, $B-V$, $V-R$, $R-I$, $I$, number of observations,
and reference; the second file lists the homogenized, mean values of the data
in the first file; and the third file lists the full forms of the references
cited in the first file.

\subsection{Reference}

\begin{references}

\item Lanz, T. 1986, {\em Astron. Astrophys. Suppl. Ser.}, {\bf 65}, 195.

\end{references}

\section{Structure}

\subsection{Each File as a Whole}

The \abbr\ consists of 14 files.  Table \ref{t:files} gives the file attributes
that are the same no matter what computer the catalog is copied for.  All
records are of fixed length.  The first file for each standard system contains
the observational data (Table \ref{t:obs}), the second file lists the mean
values of the data in the first file (Table \ref{t:means}), and the third file
lists the full forms of the references cited by code number in the first file
(Table \ref{t:refs}).  The thirteenth file contains a description of the
numbering system used to identify objects in this catalog.  The fourteenth file
contains a summary of Lanz (1986), tables of mean values for HD/BD stars and
cluster stars, and references.  Detailed descriptions of each file are given in
the following sections.

{\bf Quotations in any of the following descriptions come from
\catref\ unless otherwise noted}.

\begin{table}[htb]
\label{t:files}
\centering
\begin{tabular}{|c|l|c|c|r|}                    \hline
\multicolumn{5}{|c|}{\catone}                \\
\multicolumn{5}{|c|}{\cattwo\ (\pcatref)}   \\ \hline
     &                               & Record & Record &
\multicolumn{1}{c|}{Number of}               \\
File & \multicolumn{1}{c|}{Contents} & Format & Length &
\multicolumn{1}{c|}{Records}                 \\ \hline
  1  & Johnson Observations          &  Fixed &   65   &  8,372  \\
  2  & Johnson Means                 &  Fixed &   60   &  6,849  \\
  3  & Johnson References            &  Fixed &   80   &    361  \\
  4  & K \& R Observations           &  Fixed &   65   &    467  \\
  5  & K \& R Means                  &  Fixed &   60   &    467  \\
  6  & K \& R References             &  Fixed &   80   &     61  \\
  7  & M \& B Observations           &  Fixed &   65   &  1,159  \\
  8  & M \& B Means                  &  Fixed &   60   &  1,150  \\
  9  & M \& B References             &  Fixed &   80   &     36  \\
 10  & N \& C Observations           &  Fixed &   65   &    252  \\
 11  & N \& C Means                  &  Fixed &   60   &    252  \\
 12  & N \& C References             &  Fixed &   80   &     30  \\
 13  & Numbering                     &  Fixed &   80   &  1,656  \\
 14  & Summary                       &  Fixed &  118   &  8,253  \\ \hline
\end{tabular}
\caption{Summary Description of Catalog Files}
\end{table}

\subsection{Observations (Files 1, 4, 7, and 10 of 14)}
\label{s:obs}

These files list the observational data with references for each of
the standard systems.
A blank field indicates no data.

\begin{table}[htb]
\label{t:obs}
\centering
\begin{tabular}{|c|c|c|c|l|}                                          \hline
        &       & Suggested & Default &                            \\
  Bytes & Units &   Format  &  Value  & \multicolumn{1}{c|}{Data}  \\ \hline
 1-11   &  ---  &    I11    &   ---   & Identification             \\
 12     &  ---  &    A1     &   ---   & Multiplicity flag          \\
 13     &  ---  &    A1     &   ---   & Variability flag           \\
 14-20  &  mag  &    F7.3   &   ---   & {\em V}                    \\
 21-27  &  mag  &    F7.3   &   ---   & {\em U-B}                  \\
 28-34  &  mag  &    F7.3   &   ---   & {\em B-V}                  \\
 35-41  &  mag  &    F7.3   &   ---   & {\em V-R}                  \\
 42-48  &  mag  &    F7.3   &   ---   & {\em R-I}                  \\
 49     &  ---  &    1X     &   ---   & Blank                      \\
 50-54  &  mag  &    F5.2   &   ---   & {\em I}                    \\
 55     &  ---  &    1X     &   ---   & Blank                      \\
 56     &  ---  &    A1     &   ---   & Count flag                 \\
 57-59  &  ---  &    I3     &   ---   & Number of obs.             \\
 60     &  ---  &    1X     &   ---   & Blank                      \\
 61-65  &  ---  &    I5     &   ---   & Reference                  \\ \hline
\end{tabular}
\caption{Observations File Record Format}
\end{table}

\begin{definition}{20ex}

\item[Identification] Code number of the star in the system of
Mermilliod (1978).

\item[Multiplicity flag] Single-character code: ``D'' indicates an unresolved
binary system; a number identifies one component of a multiple system.

\item[Variability flag] ``V'' if the star is variable.

\item[Count flag] Single-character code qualifying the number in bytes 57-59.
The following codes are used:

   \begin{definition}{3ex}

   \item[/] Indicates that the actual number of observations was not listed in
   the source reference; ``1'' has been assumed.

   \item[*] Indicates that there were at least as many observations as
   indicated in bytes 57-59.

   \item[S] Indicates a standard star for which the the exact number of
   observations is not known. This appears only once, in the Johnson standard
   observations file.

   \end{definition}

\item[Reference] Code number of the source reference for this data. The full
forms of these references are listed in separate files for each standard system
(see Section \ref{s:refs}).

\end{definition}

\subsection{Means (Files 2, 5, 8, and 11 of 14)}
\label{s:means}

These files list the mean values derived from the observational data,
homogenized to the standard system. A blank field indicates no data. Mean color
has not been calculated for variable stars, ``as it was preferred to retain one
measurement, generally that with the brightest {\em V} magnitude.''

\begin{table}[htb]
\label{t:means}
\centering
\begin{tabular}{|c|c|c|c|l|}                                          \hline
        &       & Suggested & Default &                            \\
  Bytes & Units &   Format  &  Value  & \multicolumn{1}{c|}{Data}  \\ \hline
  1-11  &  ---  &    I11    &   ---   & Identification             \\
 12     &  ---  &    A1     &   ---   & Multiplicity flag          \\
 13     &  ---  &    A1     &   ---   & Variability flag           \\
 14-20  &  mag  &    F7.3   &   ---   & $V$                        \\
 21-27  &  mag  &    F7.3   &   ---   & $U-B$                      \\
 28-34  &  mag  &    F7.3   &   ---   & $B-V$                      \\
 35-41  &  mag  &    F7.3   &   ---   & $V-R$                      \\
 42-48  &  mag  &    F7.3   &   ---   & $R-I$                      \\
 49     &  ---  &    1X     &   ---   & Blank                      \\
 50-54  &  mag  &    F5.2   &   ---   & $I$                        \\
 55     &  ---  &    1X     &   ---   & Blank                      \\
 56-58  &  ---  &    I3     &   ---   & Weight                     \\
 59-60  &  ---  &    2X     &   ---   & Blank                      \\ \hline
\end{tabular}
\caption{Means File Record Format}
\end{table}

\begin{definition}{20ex}

\item[Identification] Code number of the star in the system of Mermilliod.
(1978)

\item[Multiplicity flag] Single-character code: ``D'' indicates an unresolved
binary system; a number identifies one component of a multiple system.

\item[Variability flag] ``V'' if the star is variable.

\item[Weight] This is ``not directly a quality, but is derived from the total
number of measurements.''

\end{definition}

\subsection{References (Files 3, 6, 9, and 12 of 14)}
\label{s:refs}

These files list the code numbers and full forms of the references specific to
each standard system.

\begin{table}[htb]
\label{t:refs}
\centering
\begin{tabular}{|c|c|l|}                                          \hline
        &  Suggested &                             \\
  Bytes &    Format  &  \multicolumn{1}{c|}{Data}  \\ \hline
  1- 5  &     I5     &  Number                     \\
  6- 8  &     3X     &  Blank                      \\
  9-80  &     A72    &  Text                       \\ \hline
\end{tabular}
\caption{Numbering File Record Format}
\end{table}

\begin{definition}{20ex}

\item[Number] Code number by which this reference is cited in the corresponding
observational data file for this standard system.

\item[Text] Full form of the reference. When bytes 1-5 are blank, this field
continues the reference of the previous record.

\end{definition}

\subsection{Numbering (File 13 of 14)}
\label{s:numbering}

This file contains a description of the numbering system of Mermilliod (1978)
used to identify objects in this catalog. It includes references as well as
tables of code numbers, and it is formatted as 80-byte lines of text, which can
be read and printed out with a FORTRAN A80 format.

\subsection{Summary (File 14 of 14)}
\label{s:summary}

This file can be broken down into four parts:

\begin{enumerate}

\item A summary of Lanz (1986), including a list of general references to the
catalog, a short explanation of the numbering system of Mermilliod (1978), and
a brief description of the tables which follow

\item A single long table listing identifications, homogenized mean values, and
references for HD and BD stars.

\item A series of short tables listing mean values and references for cluster
stars, by cluster.

\item A list of the full forms of the references cited by code number in the
preceding data tables.

\end{enumerate}

This file is formatted as 118-byte lines of text which can be read and printed
out with a FORTRAN A118 format.

\section{History}
\label{s:history}

\subsection{Remarks and Modifications}

The {\em \catone\ \cattwo } (\abbr ) was received by the Astronomical Data
Center (ADC), NASA Goddard Space Flight Center, from the Centre de Donn\'{e}es
Astronomiques, Strasbourg (CDS), in December 1986.

The original tape consisted of 15 text files. The first contained a description
of the 14 catalog files and has been incorporated into this document; the
remaining files were formatted as described in the preceding sections. A
FORTRAN program was run to check the validity of each field according to its
data type and value. As a result, the character ``S'', found in the {\bf number
of obs.} field in one record of the Johnson standard observation file, was
moved to the {\bf count flag } field and the {\bf number of obs.} field left
blank so that this field could be read by the FORTRAN I3 format indicated. No
other changes were made to any of the files.

\subsection{References to the Documentation}

\begin{references}

\item Kunkel, W. E. and Rydgren, A. E. 1979, {\em Astron. J.}, {\bf 84}, 633.

\item Lanz, T. 1986, {\em Astron. Astrophys. Suppl. Ser.}, {\bf 65}, 195.

\item Lanz, T. 1986, unpublished documentation received with the catalog from
the CDS.

\item Mermilliod, J.-C. 1978, {\em Bull. Inform. CDS}, {\bf 14}, 32.

\item Moffett, T. J. and Barnes III, T. G. 1979, {\em Publ. Astron. Soc. Pac.},
{\bf 91}, 180.

\item Morel, M. and Magnenat, P. 1978, {\em Astron. Astrophys. Suppl. Ser.},
{\bf 34}, 477.

\item Neckel, T. and Chini, R. 1980, {\em Astron. Astrophys. Suppl. Ser.}, {\bf
39}, 411.

\end{references}

\end{document}
