Display Data in Output

Select menu: Data | Display Data in Output

Display Data in Output provides facilities for displaying the contents of Genstat data structures in the Output window. There are many options that let you easily control the style and format of the data. The general layout of the output can be controlled with the Display Data in Output Options dialog.

After you have imported your data, from the menu select Data | Display Data in Output.

Available data

This lists the structures that are available for displaying. Double-clicking an identifier name will copy it to the end of the Data structure list. You can select multiple items using the Ctrl and Shift keys and move them to the list in one action by clicking the arrow button.

The check boxes below the list let you subset the type of data structures displayed in the list:

Vectors	Displays variates, factors and texts in the list.
Tables	Displays tables in the list.
Matrices	Displays matrices (rectangular, symmetric and diagonal) in the list.
Scalars	Displays scalars in the list.

When Allow mixed length vectors is selected, does not subset the list to the structures of matching length to the first structure; otherwise, after adding one structure to the Data structure list, the structures in the Available data list are reduced to those of the same length as that first structure.

Data structure list

Lists the data that is to be displayed in the Output window. The contents of the data structures will be displayed in the order that they appear in the list. The columns in this list, Data structure, Type, Decimals, Width, Justify, Factors, Dates, Characters show the name, data type (variate, text, factor etc.) and display attributes for each structure.

The display attributes correspond to the settings in the same order as those found the in Attribute for displaying structure field. If a column entry is empty, this indicates either the default value for that attribute will be used for that structure, or that this option is not available for that type of data structure. You can change the ordering within the list by selecting a name and clicking Up or Down.

You can also delete data structures from the list by selecting the structure and clicking Remove. The Remove all button removes all the entries in the list. A right-click menu is also available, which lets you edit a structure’s attributes, delete a structure, or delete all the structures.

You can add structures to the list either by double-clicking structures in the Available data list or by selecting one or more structures in the list and using the arrow button. The Add button can be used to add structures to this list that are not shown in the Available data list, such as unnamed structures, for example !(1…N), specialized structures like trees, pointers or LRVs and hidden structures which have an underscore at the start of their name such as _counts.

The Attribute for displaying structure items set the default attributes when structures are added to the list. You can edit the attributes of a data structure in the Display Attributes menu. To open this, either click Attributes, double-click a structure in the list or right-click the structure and select Edit Attributes. Using the Attributes button or menu lets you change the attributes for all the selected structures in the list.

When a structure in the list is selected, you can modify its attributes by using the current attributes in the Attribute for displaying structure fields and clicking Apply. If multiple structures in the list are selected, these will be all changed together.

Decimals

Number of decimal places for numbers. If you do not enter a value a default is determined which outputs the mean absolute value to 4 significant figures.

Field width

Specifies the field width in which to display the values of the data structure. If you do not enter a value a default is determined (for numbers, this is usually 12; for text, the width is one more character than the longest line). A negative field width can be given to display numbers in scientific format, so that value -n outputs numbers in scientific format with width n. scientific format gives an power of ten multiplier after an E (e.g. 1.234E3 = 1.234 x 10**3 = 1234 and 1.234E-3 = 1.234 x 10**-3 = 0.001234).

Justification

Specifies how to position the values within a field. The default justification is left for text and right for numbers.

Factor representation

Specifies how the contents of a factor are to be displayed. You can display either the levels, labels or ordinals of a factor. The default is to use labels if present, otherwise levels if present and otherwise the ordinal values.

Date format

Specifies that numbers are to be displayed as dates (the number is assumed to contain the number of days from 1 March 1600, and the fractional part represents the time of day so for example 0.25 = 6 a.m., 0.5 = 12 a.m. and 0.75 = 6 p.m). The list of available formats is given in the help for the PRINT directive.

Number of characters

Controls the number of characters that are to be displayed for text structures or factor labels. Text longer than this limit will be truncated.

Apply

Apply the settings in the Attributes for displaying structure to all the selected structures in the Data structure list.

Clear

Reset the settings in the Attributes for displaying structure field to their default settings.

Action buttons

Run	Display the selected structures.
Cancel	Close the dialog without further changes.
Options	Open the Display Data in Output Options menu.
Defaults	Resets options to their defaults. Right clicking on this button allows the selection of either User or Genstat defaults.

Action Icons

	Pin	Controls whether to keep the dialog open when you click Run. When the pin is down the dialog will remain open, otherwise when the pin is up the dialog will close.
	Restore	Restore names into edit fields and default settings.
	Clear	Clear all fields and list boxes.
	Help	Open the Help topic for this dialog.