Previous: Definition of SDDS Protocol
Up: Definition of SDDS Protocol
Next: Structure of SDDS ASCII Data Tables
Previous Page: Definition of SDDS Protocol
Next Page: Data Set Description

Structure of the SDDS Header

The SDDS header consists of a series of namelist-like constructs, called namelist commands. These constructs differ from FORTRAN namelists in that the SDDS routines scan each construct, determine which it is, and use the data appropriately. There are seven namelist commands recognized under Version 1. Each is listed below along with the data type and default values.

For each command, an example of usage is given. Several styles of entering the namelist commands are exhibited. I suggest that the user choose a style that makes it easy to pick out the beginning of each command. Note that while each namelist command may occupy one or more lines, no two commands may occupy portions of the same line.

Any field value containing a dollar-sign or ampersand must be enclosed in double quotes, as must string values containing white-space characters.

Another character with special meaning is the exclamation point, which introduces a comment. An exclamation point anywhere in a line indicates that the remainder of the line is a comment and should be ignored. A literal exclamation point is obtained with the sequence \!, or by enclosing the exclamation point in double quotes.

The commands are briefly described in the following list, and described in detail in the following subsections:

• description --- Specifies a data set description, consisting of informal and formal text descriptions of the data set.
• column --- Defines an additional column for the tabular-data section of the data tables.
• parameter -- Defines an additional parameter data element for the data tables.
• array --- Defines an additional array data element for the data tables.
• associate --- Defines an additional associated file.
• include --- Directs that header lines be read from a named file.
• data --- Defines the data mode (ASCII or binary) along with layout parameters, and is always the last command in the header.

• Data Set Description
• Tabular-Data Column Definition
• Parameter Definition
• Array Data Definition
• Associate File Definition
• Header File Include Specification
• Data Mode and Arrangement Defintion