TABLE directive

Declares one or more table data structures.


Options

CLASSIFICATION = factors
Factors classifying the tables; default *

MARGINS = string
Whether to add margins (yes, no); default no

VALUES = numbers
Values for all the tables; default *

MODIFY = string
Whether to modify (instead of redefining) existing structures (yes, no); default no

IPRINT = strings
Information to be used by default to identify the tables in output (identifier, extra, associatedidentifier); if this is not set, they will be identified in the standard way for each type of output


Parameters

IDENTIFIER = identifiers
Identifiers of the tables

VALUES = identifiers
Values for each table

DECIMALS = scalars
Number of decimal places for printing

EXTRA = texts
Extra text associated with each identifier

UNKNOWN = identifiers
Identifier for scalar to hold summary of unclassified data associated with each table

MINIMUM = scalars
Minimum value for the contents of each structure

MAXIMUM = scalars
Maximum value for the contents of each structure

DREPRESENTATION = scalars or texts
Default format to use when the contents represent dates and times


Description

Tables are used to store numerical summaries of data that are classified into groups. With GenStat, the classification into groups is specified by a set of factors. The table contains an element, called a cell, for each combination of the levels of the factors that classify it.

   Tables are declared using the TABLE directive. The CLASSIFICATION option specifies the factors classifying the table.

   Values can be assigned to the tables by either the VALUES option or the VALUES parameter. The option defines a common value for all the tables in the declaration, while the parameter allows them each to be given a different value. If both the option and the parameter are specified, the parameter takes precedence.

   If the MODIFY option is set to yes any existing attributes and values of the tables are retained (if still appropriate); otherwise these are lost.

   The DECIMALS parameter allows you to define a number of decimal places to be used by default when each table is printed. You can associate a text of extra annotation with each table using the EXTRA parameter. The MINIMUM and MAXIMUM parameters allow you to define lower and upper limits on the values in each table. GenStat then prints warnings if any values outside that range are allocated to the table. The DREPRESENTATION parameter allows a scalar or a single-valued text to be specified for each table to indicate that the table stores dates and times, and to define a format to be used for these, by default, when they are printed; details are given in the description of the PRINT directive.

   A table can also have margins. There is then a margin for each classifying factor; this contains some sort of summary over the levels of that factor. For example, if you have a table in which the cells contain totals of the observations, you would want the marginal cells to contain totals across the levels of the factor. You can define a table to have margins when you declare it, by setting the MARGINS option of the TABLE directive to yes. Alternatively you can add margins later by the MARGIN directive.

   Tables also have an associated scalar which collects a summary of all the observations for which any of the classifying factors has a missing value; these observations cannot be assigned to any cell of the table itself. This scalar can be given an identifier, so that you can refer to it, using the UNKNOWN parameter of the TABLE directive.

   The IPRINT option can be set to specify how the tables will be identified in output:

    identifier
uses the identifier;

    extra
uses the EXTRA text;

    associatedidentifier
is relevant if the TABLE command is being used to modify a table originally formed by the TABULATE directive - with each table, TABULATE stores the identifier of the variate from which it has been constructed, and this provides the "associated identifier".

If IPRINT is not set, the tables will be identified in whatever way is usual for the section of output concerned.

 

Options: CLASSIFICATION, MARGINS, VALUES, MODIFY, IPRINT.

Parameters: IDENTIFIER, VALUES, DECIMALS, EXTRA, UNKNOWN, MINIMUM, MAXIMUM, DREPRESENTATION.