Next: , Previous: , Up: SPV Legacy Detail Member XML Format   [Contents][Index]


D.4.10 The facetLayout Element

Parent: graph
Contents: tableLayout facetLevel+ setCellProperties*

The tableLayout Element

Parent: facetLayout
Contents: empty

Required: verticalTitlesInCorner

Always set to true.

Optional: style

The id of a style element.

Optional: fitCells

Always set to ticks.

The facetLevel Element

Parent: facetLayout
Contents: axis

Each facetLevel describes a variableReference or layer, and a table has one facetLevel element for each such element. For example, an SPV detail member that contains four variableReference elements and two layer elements will contain six facetLevel elements.

In the corpus, facetLevel elements and the elements that they describe are always in the same order. The correspondence may also be observed in two other ways. First, one may use the level attribute, described below. Second, in the corpus, a facetLevel always has an id that is the same as the id of the element it describes with _facetLevel appended. One should not formally rely on this, of course, but it is usefully indicative.

Required: level

A 1-based index into the variableReference and layer elements, e.g. a facetLayout with a level of 1 describes the first variableReference in the SPV detail member, and in a member with four variableReference elements, a facetLayout with a level of 5 describes the first layer in the member.

Required: gap

Always observed as 0pt.

The axis Element

Parent: facetLevel
Contents: label? majorTicks

Attribute: style

The id of a style element.

The label Element

Parent: axis or labelFrame
Contents: text+ | descriptionGroup

This element represents a label on some aspect of the table. For example, the table’s title is a label.

The contents of the label can be one or more text elements or a descriptionGroup.

Attribute: style
Optional: textFrameStyle

Each of these is the id of a style element. style is the style of the label text, textFrameStyle the style for the frame around the label.

Optional: purpose

The kind of entity being labeled, one of title, subTitle, layer, or footnote.

The descriptionGroup Element

Parent: label
Contents: (description | text)+

A descriptionGroup concatenates one or more elements to form a label. Each element can be a text element, which contains literal text, or a description element that substitutes a value or a variable name.

Attribute: target

The id of an element being described. In the corpus, this is always faceting.

Attribute: separator

A string to separate the description of multiple groups, if the target has more than one. In the corpus, this is always a new-line.

Typical contents for a descriptionGroup are a value by itself:

<description name="value"/>

or a variable and its value, separated by a colon:

<description name="variable"/><text>:</text><description name="value"/>

The description Element

Parent: descriptionGroup
Contents: empty

A description is like a macro that expands to some property of the target of its parent descriptionGroup.

Attribute: name

The name of the property. Only variable and value appear in the corpus.

The majorTicks Element

Parent: axis
Contents: gridline?

Attribute: labelAngle
Attribute: length

Both always defined to 0.

Attribute: style
Attribute: tickFrameStyle

Each of these is the id of a style element. style is the style of the tick labels, tickFrameStyle the style for the frames around the labels.

The gridline Element

Parent: majorTicks
Contents: empty

Represents “gridlines,” which for a table represents the lines between the rows or columns of a table (XXX?).

Attribute: style

The style for the gridline.

Attribute: zOrder

Observed as a number between 28 and 31. Does not seem to be important.

The setCellProperties Element

Parent: facetLayout
Contents: setMetaData setStyle* setFormat+ union?

This element sets style properties of cells designated by the target attribute of its child elements, as further restricted by the optional union element if present. The target values often used, e.g. graph or labeling, actually affect every cell, so the union element is a useful restriction.

Optional: applyToConverse

If present, always true. This appears to invert the meaning of the target of sub-elements: the selected cells are the ones not designated by target. This is confusing, given the additional restrictions of union, but in the corpus applyToConverse is never present along with union.

The setMetaData Element

Parent: setCellProperties
Contents: empty

This element is not known to have any visible effect.

Required: target

The id of an element whose metadata is to be set. In the corpus, this is always graph, the id used for the graph element.

Required: key
Required: value

A key-value pair to set for the target.

In the corpus, key is cellPropId or, rarely, diagProps, and value is always the id of the parent setCellProperties.

The setStyle Element

Parent: setCellProperties
Contents: empty

This element associates a style with the target.

Required: target

The id of an element whose style is to be set. In the corpus, this is always the id of an interval, labeling, or, rarely, graph element.

Required: style

The id of a style element that identifies the style to set on the target.

The setFormat Element

Parent: setCellProperties
Contents:
    format
  | numberFormat
  | stringFormat+
  | dateTimeFormat

This element sets the format of the target, “format” in this case meaning the SPSS print format for a variable.

The details of this element vary depending on the schema version, as declared in the root visualization element’s version attribute (see SPV Detail visualization Element). In version 2.5 and earlier, setFormat contains one of a number of child elements that correspond to the different varieties of print formats. In version 2.7 and later, setFormat instead always contains a format element.

XXX reinvestigate the above claim about versions: it appears to be incorrect.

The setFormat element itself has the following attributes.

Required: target

The id of an element whose style is to be set. In the corpus, this is always the id of an majorTicks or labeling element.

Optional: reset

If this is true, this format overrides the target’s previous format. If it is false, the adds to the previous format. In the corpus this is always true. The default behavior is unknown.


Next: , Previous: , Up: SPV Legacy Detail Member XML Format   [Contents][Index]