X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=spv-file-format.texi;h=15eef0eedf19814fb4429f93d3cdab04b4f4e1de;hb=b0ea6e3d2705778be5e6ff8d079c72278d06b7b7;hp=dd4b0b8f5a05bc4f42661c2ee153e416b36ca0f4;hpb=5763c3751c67a228c6ab3e33934c66247551af52;p=pspp diff --git a/spv-file-format.texi b/spv-file-format.texi index dd4b0b8f5a..15eef0eedf 100644 --- a/spv-file-format.texi +++ b/spv-file-format.texi @@ -1267,6 +1267,7 @@ elements are assigned @code{id} attributes that are never referenced. * SPV Detail location Element:: * SPV Detail coordinates Element:: * SPV Detail faceting Element:: +* SPV Detail facetLayout Element:: @end menu @node SPV Detail visualization Element @@ -1752,6 +1753,7 @@ When present, this is always @code{nest}. Parent: @code{graph} @* Contents: @code{tableLayout} @code{facetLevel}@math{+} @code{setCellProperties}* + @subsubheading The @code{tableLayout} Element Parent: @code{facetLayout} @* @@ -1775,7 +1777,7 @@ Parent: @code{facetLayout} Contents: @code{axis} Each @code{facetLevel} describes a @code{variableReference} or -@code{layer}, and thus a table has one @code{facetLevel} element for +@code{layer}, and a table has one @code{facetLevel} element for each such element. For example, an SPV detail member that contains four @code{variableReference} elements and two @code{layer} elements will contain six @code{facetLevel} elements. @@ -1801,3 +1803,140 @@ and in a member with four @code{variableReference} elements, a @defvr {Required} gap Always observed as @code{0pt}. @end defvr + +@subsubheading The @code{setCellProperties} Element + +Parent: @code{facetLayout} @* +Contents: @code{setMetaData} @code{setStyle}* @code{setFormat}@math{+} @code{union}? + +This element sets style properties of cells designated by the +@code{target} attribute of its child elements. + +@defvr {Optional} applyToConverse +If present, always @code{true}. This appears to invert the meaning of +the @code{target} of sub-elements: the selected cells are the ones +@emph{not} designated by @code{target}. +@end defvr + +@subsubheading The @code{setMetaData} Element + +Parent: @code{setCellProperties} @* +Contents: empty + +It's really not clear what visible effect this element has, if any. + +@defvr {Required} target +The @code{id} of an element whose metadata is to be set. In the +corpus, this is always @code{graph}, the @code{id} used for the +@code{graph} element. +@end defvr + +@defvr {Required} key +@defvrx {Required} value +A key-value pair to set for the target. + +In the corpus, @code{key} is @code{cellPropId} or, rarely, +@code{diagProps}, and @code{value} is always the @code{id} of the +parent @code{setCellProperties}. +@end defvr + +@subsubheading The @code{setStyle} Element + +Parent: @code{setCellProperties} @* +Contents: empty + +This element associates a style with the target. + +@defvr {Required} target +The @code{id} of an element whose style is to be set. In the corpus, +this is always the @code{id} of an @code{interval}, @code{labeling}, +or, rarely, @code{graph} element. +@end defvr + +@defvr {Required} style +The @code{id} of a @code{style} element that identifies the style to +set on the target. +@end defvr + +@subsubheading The @code{setFormat} Element + +@format +Parent: @code{setCellProperties} +Contents: + @code{format} + @math{|} @code{numberFormat} + @math{|} @code{stringFormat}@math{+} + @math{|} @code{dateTimeFormat} +@end format + +This element sets the format of the target, ``format'' in this case +meaning an the SPSS print format for a variable. + +The details of this element vary depending on the schema version, as +declared in the root @code{visualization} element's @code{version} +attribute (@pxref{SPV Detail visualization Element}). In version 2.5 +and earlier, @code{setFormat} contains one of a number of child +elements that correspond to the different varieties of print formats. +In version 2.7 and later, @code{setFormat} instead always contains a +@code{format} element. + +@subsubheading The @code{format} Element + +Parent: @code{sourceVariable}, @code{derivedVariable}, @code{formatMapping}, @code{labeling}, @code{formatMapping}, @code{setFormat} @* +Contents: (@code{affix}@math{+} @math{|} @code{relabel})? + +This element determines a format, equivalent to an SPSS print format. +The following attribute determines the high-level kind of formatting +in use: + +@defvr {Optional} baseFormat +One of @code{date}, @code{time}, @code{dateTime}, or +@code{elapsedTime}. When this attribute is omitted, this element is a +numeric or string format. +@end defvr + +@noindent +Whether other attributes are required (``yes''), prohibited (``no''), +or optional (``opt'') depends on @code{baseFormat}: + +@multitable {maximumFractionDigits} {@code{dateTime}} {@code{elapsedTime}} {number} {string} +@headitem Attribute @tab @code{dateTime} @tab @code{elapsedTime} @tab number @tab string +@item errorCharacter @tab yes @tab yes @tab yes @tab opt +@item maximumFractionDigits @tab no @tab yes @tab yes @tab no +@item minimumFractionDigits @tab no @tab yes @tab yes @tab no +@item separatorChars @tab yes @tab no @tab no @tab no +@item +@item useGrouping @tab no @tab opt @tab no @tab no +@item mdyOrder @tab yes @tab no @tab no @tab no +@item +@item showYear @tab yes @tab no @tab no @tab no +@item yearAbbreviation @tab yes @tab no @tab no @tab no +@item +@item showMonth @tab yes @tab no @tab no @tab no +@item monthFormat @tab yes @tab no @tab no @tab no +@item +@item showDay @tab yes @tab opt @tab no @tab no +@item dayPadding @tab yes @tab opt @tab no @tab no +@item dayOfMonthPadding @tab yes @tab no @tab no @tab no +@item dayType @tab yes @tab no @tab no @tab no +@item +@item showHour @tab yes @tab opt @tab no @tab no +@item hourFormat @tab yes @tab opt @tab no @tab no +@item hourPadding @tab yes @tab yes @tab no @tab no +@item +@item showMinute @tab yes @tab no @tab no @tab no +@item minutePadding @tab yes @tab yes @tab no @tab no +@item +@item showSecond @tab yes @tab yes @tab no @tab no +@item secondPadding @tab no @tab yes @tab no @tab no +@item +@item showMillis @tab no @tab yes @tab no @tab no +@item +@item tryStringsAsNumbers @tab no @tab no @tab no @tab no +@item +@item minimumIntegerDigits @tab no @tab no @tab yes @tab no +@item scientific @tab no @tab no @tab yes @tab no +@item small @tab no @tab no @tab opt @tab no +@item +@item suffix @tab no @tab no @tab opt @tab no +@end multitable