The AAS Journal machine-readable (MR) tables
are formated ASCII tables which are preceeded by a meta-data header
that provides details on how to read and interpret the data. The
following forms will step you through the process of creating a MR
table from your data. Links in the text will provide additional
instructions and information on the AAS standards for MR tables.
The standards are based on those developed at the
CDS and the
ADC for their libraries of formated ASCII tables.
To see examples of various table formats, units, labels, and explanations,
use the example buttons below.
The example data and meta-data header information will be
loaded into each step. Go directly to the ``Create a MR table''
button at step 6 to view the MR output of a given example table. A new
window will also be created that shows what the example table looks like
in print and gives further explanations for the meta-data values used.
The ``Reset'' button will clear all of the fields and close the example
The first step is to input the data that you wish to put into a
MR format. The data should be ASCII and properly formated (Note:
a true MR table has all data flags and non-numeric values such as
footnotes, uncertainty ":" flags, > or < signs, etc., placed
in their own column). Make sure that your entry contains only data and no
extra carriage returns or newlines at the end or else the program will
interpret these as extra lines. You will get a
error for these line when you submit the job if you forget.
The current size limit is 10MB. Please contact the AAS Staff
Scientist, Dr. Greg Schwarz, at Greg.Schwarz(at)aas.org if you have
uploads bigger than this.
Indicate if the data file from step 1 is formated
or delimited. Use delimited when converted tables
created from spreadsheets (i.e. Tab or comma delimited)
or from TeX or LaTeX tables (i.e. & delimited). Since the
program must format these tables, the resulting MR table may have
extra trailing decimal zeros added in non-integer columns due to the
way Perl writes formated output. The formated option avoids
this problem since the data file is not operated upon.
Enter the format code in the text line below. Use these
codes and separate each column code by either a blank or comma.
In the next 3 text fields, you need to input information useful
to read and interpret the data in your table. This information
will be used to construct the meta-data header of the final MR table
Enter the units for each column in the text window below with
each column's units on its own row (followed by a hard return).
Use this link to obtain
and allowed standard unit names. The symbol for unitless
columns is ---.
Enter a label for each column in the text window below with
each column's label on its own row (followed by a hard return).
Use this link to obtain more
information on the standard label names and rules.
Enter a short explanation for each column in the text window. Put
each column's short explanation on its own row (followed by a hard
return). Click here for more information about the
Note that numeric columns that contain one or more blank rows must
have explanations that begin with the "?" flag (see Examples 2 and 3).
The information entered in fields 2-5 will be combined
used to check the format of the data from field 1 and do some basic data
checking of any columns with standard labels. If there are no errors
the output will be a MR table.