From 61ef840f157fe4aba26d3e81afa2fce16282dc66 Mon Sep 17 00:00:00 2001 From: Ben Pfaff Date: Sun, 17 Jan 2016 00:19:53 -0800 Subject: [PATCH] Add documentation for SPV file format. --- acinclude.m4 | 28 + configure.ac | 1 + doc/automake.mk | 15 + doc/dev/spv-file-format.texi | 1229 ++++++++++++++++++++++++++++++++++++++++++ doc/dev/spv-structure.eps | 626 +++++++++++++++++++++ doc/dev/spv-structure.gv | 25 + doc/dev/spv-structure.pdf | Bin 0 -> 16814 bytes doc/pspp-dev.texi | 4 +- 8 files changed, 1927 insertions(+), 1 deletion(-) create mode 100644 doc/dev/spv-file-format.texi create mode 100644 doc/dev/spv-structure.eps create mode 100644 doc/dev/spv-structure.gv create mode 100644 doc/dev/spv-structure.pdf diff --git a/acinclude.m4 b/acinclude.m4 index 3e16c6887..292404723 100644 --- a/acinclude.m4 +++ b/acinclude.m4 @@ -303,3 +303,31 @@ AC_DEFUN([PSPP_ENABLE_WERROR], CFLAGS="$CFLAGS -Werror -Wno-error=deprecated-declarations" fi])]) +# The following comes from Open vSwitch: +# ---------------------------------------------------------------------- +# Copyright (c) 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015 Nicira, Inc. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +dnl Checks for dot. +AC_DEFUN([PSPP_CHECK_DOT], + [AC_CACHE_CHECK( + [for dot], + [pspp_cv_dot], + [dnl "dot" writes -V output to stderr: + if (dot -V) 2>&1 | grep '^dot - [[gG]]raphviz version' >/dev/null 2>&1; then + pspp_cv_dot=yes + else + pspp_cv_dot=no + fi]) + AM_CONDITIONAL([HAVE_DOT], [test "$pspp_cv_dot" = yes])]) diff --git a/configure.ac b/configure.ac index 5fa4ea384..9ce769983 100644 --- a/configure.ac +++ b/configure.ac @@ -19,6 +19,7 @@ AC_PROG_LIBTOOL PKG_PROG_PKG_CONFIG m4_pattern_forbid([PKG_CHECK_MODULES]) PSPP_CHECK_CLICKSEQUENCE +PSPP_CHECK_DOT PSPP_ENABLE_WERROR diff --git a/doc/automake.mk b/doc/automake.mk index b4d93ce1b..28866ca2e 100644 --- a/doc/automake.mk +++ b/doc/automake.mk @@ -41,9 +41,24 @@ doc_pspp_dev_TEXINFOS = doc/version-dev.texi \ doc/dev/system-file-format.texi \ doc/dev/pc+-file-format.texi \ doc/dev/portable-file-format.texi \ + doc/dev/spv-file-format.texi \ doc/dev/encrypted-file-wrappers.texi \ doc/dev/q2c.texi +if HAVE_DOT +$(PDFS): doc/dev/spv-structure.pdf +$(srcdir)/doc/dev/spv-structure.pdf: doc/dev/spv-structure.gv + dot -Tpdf < $< > $@ + +$(DVIS): doc/dev/spv-structure.eps +$(srcdir)/doc/dev/spv-structure.eps: doc/dev/spv-structure.gv + dot -Teps < $< > $@ +endif +EXTRA_DIST += \ + doc/dev/spv-structure.gv \ + doc/dev/spv-structure.pdf \ + doc/dev/spv-structure.eps + dist_man_MANS += doc/pspp.1 \ doc/psppire.1 diff --git a/doc/dev/spv-file-format.texi b/doc/dev/spv-file-format.texi new file mode 100644 index 000000000..7db97d9da --- /dev/null +++ b/doc/dev/spv-file-format.texi @@ -0,0 +1,1229 @@ +@node SPSS Viewer File Format +@chapter SPSS Viewer File Format + +SPSS Viewer or @file{.spv} files, here called SPV files, are written +by SPSS 16 and later to represent the contents of its output editor. +This chapter documents the format, based on examination of a corpus of +about 500 files from a variety of sources. This description is +detailed enough to read SPV files, but probably not enough to write +them. + +SPSS 15 and earlier versions use a completely different output format +based on the Microsoft Compound Document Format. This format is not +documented here. + +An SPV file is a Zip archive that can be read with @command{zipinfo} +and @command{unzip} and similar programs. The final member in the Zip +archive is a file named @file{META-INF/MANIFEST.MF}. This structure +makes SPV files resemble Java ``JAR'' files (and ODF files), but +whereas a JAR manifest contains a sequence of colon-delimited +key/value pairs, an SPV manifest contains the string +@samp{allowPivoting=true}, without a new-line. (This string may be +the best way to identify an SPV file; it is invariant across the +corpus.) + +The rest of the members in an SPV file's Zip archive fall into two +categories: @dfn{structure} and @dfn{detail} members. Structure +member names begin with @file{outputViewer@var{nnnnnnnnnn}}, where +each @var{n} is a decimal digit, and end with @file{.xml}, and often +include the string @file{_heading} in between. Each of these members +represents some kind of output item (a table, a heading, a block of +text, etc.) or a group of them. The member whose output goes at the +beginning of the document is numbered 0, the next member in the output +is numbered 1, and so on. + +Structure members contain XML. This XML is sometimes self-contained, +but it often references detail members in the Zip archive, which named +as follows: + +@table @asis +@item @file{@var{prefix}_table.xml} and @file{@var{prefix}_tableData.bin} +@itemx @file{@var{prefix}_lightTableData.bin} +The structure of a table plus its data. Older SPV files pair a +@file{@var{prefix}_table.xml} file that describes the table's +structure with a binary @file{@var{prefix}_tableData.bin} file that +gives its data. Newer SPV files (the majority of those in the corpus) +instead include a single @file{@var{prefix}_lightTableData.bin} file +that incorporates both into a single binary format. + +@item @file{@var{prefix}_warning.xml} and @file{@var{prefix}_warningData.bin} +@itemx @file{@var{prefix}_lightWarningData.bin} +Same format used for tables, with a different name. + +@item @file{@var{prefix}_notes.xml} and @file{@var{prefix}_notesData.bin} +@itemx @file{@var{prefix}_lightNotesData.bin} +Same format used for tables, with a different name. + +@item @file{@var{prefix}_chartData.bin} and @file{@var{prefix}_chart.xml} +The structure of a chart plus its data. Charts do not have a +``light'' format. + +@item @file{@var{prefix}_model.scf} +@itemx @file{@var{prefix}_pmml.scf} +Not yet investigated. The corpus contains only one example of each. + +@item @file{@var{prefix}_stats.xml} +Not yet investigated. The corpus contains few examples. +@end table + +The @file{@var{prefix}} in the names of the detail members is +typically an 11-digit decimal number that increases for each item, +tending to skip values. Older SPV files use different naming +conventions. Structure member refer to detail members by name, and so +their exact names do not matter to readers as long as they are unique. + +@menu +* SPV Structure Member Format:: +* SPV Light Detail Member Format:: +* SPV Legacy Detail Member Binary Format:: +* SPV Legacy Detail Member XML Format:: +@end menu + +@node SPV Structure Member Format +@section Structure Member Format + +Structure members' XML files claim conformance with a collection of +XML Schemas. These schemas are distributed, under a nonfree license, +with SPSS binaries. Fortunately, the schemas are not necessary to +understand the structure members. To a degree, the schemas can even +be deceptive because they document elements and attributes that are +not in the corpus and do not document elements and attributes that are +commonly found there. + +Structure members use a different XML namespace for each schema, but +these namespaces are not entirely consistent. In some SPV files, for +example, the @code{viewer-tree} schema is associated with namespace +@indicateurl{http://xml.spss.com/spss/viewer-tree} and in others with +@indicateurl{http://xml.spss.com/spss/viewer/viewer-tree} (note the +additional @file{viewer/}). Under either name, the schema URIs are +not resolvable to obtain the schemas themselves. + +One may ignore all of the above in interpreting a structure member. +The actual XML has a simple and straightforward form that does not +require a reader to take schemas or namespaces into account. + +The elements found in structure members are documented below. For +each element, we note the possible parent elements and the element's +contents. The contents are specified as pseudo-regular expressions +with the following conventions: + +@table @asis +@item text +XML text content. + +@item CDATA +XML CDATA content. + +@item @code{element} +The named element. + +@item (@dots{}) +Grouping multiple elements. + +@item [@var{x}] +An optional @var{x}. + +@item @var{a} @math{|} @var{b} +A choice between @var{a} and @var{b}. + +@item @var{x}* +Zero or more @var{x}. +@end table + +@ifnottex +For a diagram illustrating the hierarchy of elements within an SPV +structure member, please refer to a PDF version of the manual. +@end ifnottex + +@iftex +The following diagram shows the hierarchy of elements within an SPV +structure member. Edges point from parent to child elements. +Unlabeled edges indicate that the child appears exactly once; edges +labeled with *, zero or more times; edges labeled with ?, zero or one +times. +@center @image{dev/spv-structure, 5in} +@end iftex + +@menu +* SPV heading Element:: +* SPV label Element:: +* SPV container Element:: +* SPV text Element (Inside @code{container}):: +* SPV html Element:: +* SPV table Element:: +* SPV tableStructure Element:: +* SPV dataPath Element:: +* SPV pageSetup Element:: +* SPV pageHeader and pageFooter Elements:: +* SPV pageParagraph Element:: +* SPV @code{text} Element (Inside @code{pageParagraph}):: +@end menu + +@node SPV heading Element +@subsection The @code{heading} Element + +Parent: Document root or @code{heading} @* +Contents: [@code{pageSetup}] @code{label} (@code{container} @math{|} @code{heading})* + +The root of a structure member is a @code{heading}, which represents a +section of output beginning with a title (the @code{label}) and +ordinarily followed by content containers or further nested +(sub)-sections of output. + +The document root heading, only, may also contain a @code{pageSetup} +element. + +The following attributes have been observed on both document root and +nested @code{heading} elements. + +@defvr {Optional} creator-version +The version of the software that created this SPV file. A string of +the form @code{xxyyzzww} represents software version xx.yy.zz.ww, +e.g.@: @code{21000001} is version 21.0.0.1. Trailing pairs of zeros +are sometimes omitted, so that @code{21}, @code{210000}, and +@code{21000000} are all version 21.0.0.0 (and the corpus contains all +three of those forms). +@end defvr + +@noindent +The following attributes have been observed on document root +@code{heading} elements only: + +@defvr {Optional} @code{creator} +The directory in the file system of the software that created this SPV +file. +@end defvr + +@defvr {Optional} @code{creation-date-time} +The date and time at which the SPV file was written, in a +locale-specific format, e.g. @code{Friday, May 16, 2014 6:47:37 PM +PDT} or @code{lunedì 17 marzo 2014 3.15.48 CET} or even @code{Friday, +December 5, 2014 5:00:19 o'clock PM EST}. +@end defvr + +@defvr {Optional} @code{lockReader} +Whether a reader should be allowed to edit the output. The possible +values are @code{true} and @code{false}, but the corpus only contains +@code{false}. +@end defvr + +@defvr {Optional} @code{schemaLocation} +This is actually an XML Namespace attribute. A reader may ignore it. +@end defvr + +@noindent +The following attributes have been observed only on nested +@code{heading} elements: + +@defvr {Required} @code{commandName} +The locale-invariant name of the command that produced the output, +e.g.@: @code{Frequencies}, @code{T-Test}, @code{Non Par Corr}. +@end defvr + +@defvr {Optional} @code{visibility} +To what degree the output represented by the element is visible. The +only observed value is @code{collapsed}. +@end defvr + +@defvr {Optional} @code{locale} +The locale used for output, in Windows format, which is similar to the +format used in Unix with the underscore replaced by a hyphen, e.g.@: +@code{en-US}, @code{en-GB}, @code{el-GR}, @code{sr-Cryl-RS}. +@end defvr + +@defvr {Optional} @code{olang} +The output language, e.g.@: @code{en}, @code{it}, @code{es}, +@code{de}, @code{pt-BR}. +@end defvr + +@node SPV label Element +@subsection The @code{label} Element + +Parent: @code{heading} or @code{container} @* +Contents: text + +Every @code{heading} and @code{container} holds a @code{label} as its +first child. The root @code{heading} in a structure member always +contains the string ``Output''. Otherwise, the text in @code{label} +describes what it labels, often by naming the statistical procedure +that was executed, e.g.@: ``Frequencies'' or ``T-Test''. Labels are +often very generic, especially within a @code{container}, e.g.@: +``Title'' or ``Warnings'' or ``Notes''. Label text is localized +according to the output language, e.g.@: in Italian a frequency table +procedure is labeled ``Frequenze''. + +The corpus contains one example of an empty label, one that contains +no text. + +This element has no attributes. + +@node SPV container Element +@subsection The @code{container} Element + +Parent: @code{heading} @* +Contents: @code{label} [@code{table} @math{|} @code{text}] + +A @code{container} serves to label a @code{table} or a @code{text} +item. + +This element has the following attributes. + +@defvr {Required} @code{visibility} +Either @code{visible} or @code{hidden}, this indicates whether the +container's content is displayed. +@end defvr + +@defvr {Optional} @code{text-align} +Presumably indicates the alignment of text within the container. The +only observed value is @code{left}. Observed with nested @code{table} +and @code{text} elements. +@end defvr + +@defvr {Optional} @code{width} +The width of the container in the form @code{@var{n}px}, e.g.@: +@code{1097px}. +@end defvr + +@node SPV text Element (Inside @code{container}) +@subsection The @code{text} Element (Inside @code{container}) + +Parent: @code{container} @* +Contents: @code{html} + +This @code{text} element is nested inside a @code{container}. There +is a different @code{text} element that is nested inside a +@code{pageParagraph}. + +This element has the following attributes. + +@defvr {Required} @code{type} +One of @code{title}, @code{log}, or @code{text}. +@end defvr + +@defvr {Optional} @code{commandName} +As on the @code{heading} element. For output not specific to a +command, this is simply @code{log}. The corpus contains one example +of where @code{commandName} is present but set to the empty string. +@end defvr + +@defvr {Optional} @code{creator-version} +As on the @code{heading} element. +@end defvr + +@node SPV html Element +@subsection The @code{html} Element + +Parent: @code{text} @* +Contents: CDATA + +The CDATA contains an HTML document. In some cases, the document +starts with @code{} and ends with @code{}. The actual content ranges from trivial to simple: +just discarding the CSS and tags yields readable results. + +This element has the following attributes. + +@defvr {Required} @code{lang} +This always contains @code{en} in the corpus. +@end defvr + +@node SPV table Element +@subsection The @code{table} Element + +Parent: @code{container} @* +Contents: @code{tableStructure} + +This element has the following attributes. + +@defvr {Required} @code{commandName} +As on the @code{heading} element. +@end defvr + +@defvr {Required} @code{type} +One of @code{table}, @code{note}, or @code{warning}. +@end defvr + +@defvr {Required} @code{subType} +The locale-invariant name for the particular kind of output that this +table represents in the procedure. This can be the same as +@code{commandName} e.g.@: @code{Frequencies}, or different, e.g.@: +@code{Case Processing Summary}. Generic subtypes @code{Notes} and +@code{Warnings} are often used. +@end defvr + +@defvr {Required} @code{tableId} +A number that uniquely identifies the table within the SPV file, +typically a large negative number such as @code{-4147135649387905023}. +@end defvr + +@defvr {Optional} @code{creator-version} +As on the @code{heading} element. In the corpus, this is only present +for version 21 and up and always includes all 8 digits. +@end defvr + +@node SPV tableStructure Element +@subsection The @code{tableStructure} Element + +Parent: @code{table} @* +Contents: @code{dataPath} + +This element has no attributes. + +@node SPV dataPath Element +@subsection The @code{dataPath} Element + +Parent: @code{tableStructure} @* +Contents: text + +Contains the name of the Zip member that holds the table details, +e.g.@: @code{0000000001437_lightTableData.bin}. + +This element has no attributes. + +@node SPV pageSetup Element +@subsection The @code{pageSetup} Element + +Parent: @code{heading} @* +Contents: @code{pageHeader} @code{pageFooter} + +This element has the following attributes. + +@defvr {Required} @code{initial-page-number} +Always @code{1}. +@end defvr + +@defvr {Optional} @code{chart-size} +Always @code{as-is} or a localization (!) of it (e.g.@: @code{dimensione +attuale}, @code{Wie vorgegeben}). +@end defvr + +@defvr {Optional} @code{margin-left} +@defvrx {Optional} @code{margin-right} +@defvrx {Optional} @code{margin-top} +@defvrx {Optional} @code{margin-bottom} +Margin sizes in the form @code{@var{size}in}, e.g.@: @code{0.25in}. +@end defvr + +@defvr {Optional} @code{paper-height} +@defvrx {Optional} @code{paper-width} +Paper sizes in the form @code{@var{size}in}, e.g.@: @code{8.5in} by +@code{11in} for letter paper or @code{8.267in} by @code{11.692in} for +A4 paper. +@end defvr + +@defvr {Optional} @code{reference-orientation} +Always @code{0deg}. +@end defvr + +@defvr {Optional} @code{space-after} +Always @code{12pt}. +@end defvr + +@node SPV pageHeader and pageFooter Elements +@subsection The @code{pageHeader} and @code{pageFooter} Elements + +Parent: @code{pageSetup} @* +Contents: @code{pageParagraph}* + +This element has no attributes. + +@node SPV pageParagraph Element +@subsection The @code{pageParagraph} Element + +Parent: @code{pageHeader} or @code{pageFooter} @* +Contents: @code{text} + +Text to go at the top or bottom of a page, respectively. + +This element has no attributes. + +@node SPV @code{text} Element (Inside @code{pageParagraph}) +@subsection The @code{text} Element (Inside @code{pageParagraph}) + +Parent: @code{pageParagraph} @* +Contents: [CDATA] + +This @code{text} element is nested inside a @code{pageParagraph}. There +is a different @code{text} element that is nested inside a +@code{container}. + +The element is either empty, or contains CDATA that holds almost-XHTML +text: in the corpus, either an @code{html} or @code{p} element. It is +@emph{almost}-XHTML because the @code{html} element designates the +default namespace as +@code{http://xml.spss.com/spss/viewer/viewer-tree} instead of an XHTML +namespace, and because the CDATA can contain substitution variables: +@code{&[Page]} for the page number and @code{&[PageTitle]} for the +page title. + +Typical contents (indented for clarity): + +@example + + + +

Page &[Page]

+ + +@end example + +This element has the following attributes. + +@defvr {Required} @code{type} +Always @code{text}. +@end defvr + +@node SPV Light Detail Member Format +@section Light Detail Member Format + +This section describes the format of ``light'' detail @file{.bin} +members. These members have a binary format which we describe here in +terms of a context-free grammar using the following conventions: + +@table @asis +@item NonTerminal @result{} @dots{} +Nonterminals have CamelCaps names, and @result{} indicates a +production. The right-hand side of a production is often broken +across multiple lines. Break points are chosen for aesthetics only +and have no semantic significance. + +@item 00, 01, @dots{}, ff. +Bytes with fixed values are written in hexadecimal: + +@item i0, i1, @dots{}, i9, i10, i11, @dots{} +32-bit integers with fixed values are written in decimal, prefixed by +@samp{i}. + +@item byte +An arbitrary byte. + +@item int +An arbitrary 32-bit integer. + +@item double +An arbitrary 64-bit IEEE floating-point number. + +@item string +A 32-bit integer followed by the specified number of bytes of +character data. (The encoding is indicated by the Formats +nonterminal.) + +@item @var{x}? +@var{x} is optional, e.g.@: 00? is an optional zero byte. + +@item @var{x}*@var{n} +@var{x} is repeated @var{n} times, e.g. byte*10 for ten arbitrary bytes. + +@item @var{x}[@var{name}] +Gives @var{x} the specified @var{name}. Names are used in textual +explanations. They are also used, also bracketed, to indicate counts, +e.g.@: int[@t{n}] byte*[@t{n}] for a 32-bit integer followed by the +specified number of arbitrary bytes. + +@item @var{a} @math{|} @var{b} +Either @var{a} or @var{b}. + +@item (@var{x}) +Parentheses are used for grouping to make precedence clear, especially +in the presence of @math{|}, e.g.@: in 00 (01 @math{|} 02 @math{|} 03) +00. + +@item count(@var{x}) +A 32-bit integer that indicates the number of bytes in @var{x}, +followed by @var{x} itself. + +@item v1(@var{x}) +In a version 1 @file{.bin} member, @var{x}; in version 3, nothing. +(The @file{.bin} header indicates the version.) + +@item v3(@var{x}) +In a version 3 @file{.bin} member, @var{x}; in version 1, nothing. +@end table + +All integer and floating-point values in this format use little-endian +byte order. + +A ``light'' detail member @file{.bin} consists of a number of sections +concatenated together, terminated by a byte 01: + +@cartouche +@format +LightMember @result{} Header Title Caption Footnotes Fonts Formats Dimensions Data 01 +@end format +@end cartouche + +The following sections go into more detail. + +@menu +* SPV Light Member Header:: +* SPV Light Member Title:: +* PSV Light Member Caption:: +* SPV Light Member Footnotes:: +* SPV Light Member Fonts:: +* SPV Light Member Formats:: +* SPV Light Member Dimensions:: +* SPV Light Member Categories:: +* SPV Light Member Data:: +* SPV Light Member Value:: +* SPV Light Member ValueMod:: +@end menu + +@node SPV Light Member Header +@subsection Header + +An SPV file begins with an 39-byte header: + +@cartouche +@format +Header @result{} + 01 00 + (i1 @math{|} i3)[@t{version}] + 01 (00 @math{|} 01) byte*21 00 00 + int[@t{table-id}] byte*4 +@end format +@end cartouche + +@code{version} is a version number that affects the interpretation of +some of the other data in the member. We will refer to ``version 1'' +and ``version 3'' later on and use v1(@dots{}) and v3(@dots{}) for +version-specific formatting (as described previously). + +@code{table-id} is a binary version of the @code{tableId} attribute in +the structure member that refers to the detail member. For example, +if @code{tableId} is @code{-4154297861994971133}, then @code{table-id} +would be 0xdca00003. + +The meaning of the other variable parts of the header is not known. + +@node SPV Light Member Title +@subsection Title + +@cartouche +@format +Title @result{} + Value[@t{title1}] 01? + Value[@t{c}] 01? 31 + Value[@t{title2}] 01? 00? 58 +@end format +@end cartouche + +The Title, which follows the Header, specifies the pivot table's title +twice, as @code{title1} and @code{title2}. In the corpus, they are +always the same. + +Whereas the Value in @code{title1} and in @code{title2} are +appropriate for presentation, and localized to the user's language, +@code{c} is in English, sometimes less specific, and sometimes less +well formatted. For example, for a frequency table, @code{title1} and +@code{title2} name the variable and @code{c} is simply ``Frequencies''. + +@node PSV Light Member Caption +@subsection Caption + +@cartouche +@format +Caption @result{} 58 @math{|} 31 Value[@t{caption}] +@end format +@end cartouche + +The @code{caption}, if presented, is shown below the table. + +@node SPV Light Member Footnotes +@subsection Footnotes + +@cartouche +@format +Footnotes @result{} int[@t{n}] Footnote*[@t{n}] +Footnote @result{} Value[@t{text}] (58 @math{|} 31 Value[@t{marker}]) byte*4 +@end format +@end cartouche + +Each footnote has @code{text} and an optional customer @code{marker} +(such as @samp{*}). + +@node SPV Light Member Fonts +@subsection Fonts + +@cartouche +@format +Fonts @result{} 00 Font*8 +Font @result{} + byte[@t{index}] 31 string[@t{typeface}] 00 00 + (10 @math{|} 20 @math{|} 40 @math{|} 50 @math{|} 70 @math{|} 80)[@t{f1}] 41 + (i0 @math{|} i1 @math{|} i2)[@t{f2}] 00 + (i0 @math{|} i2 @math{|} i64173)[@t{f3}] + (i0 @math{|} i1 @math{|} i2 @math{|} i3)[@t{f4}] + string[@t{fgcolor}] string[@t{bgcolor}] i0 i0 00 + v3(int[@t{f5}] int[@t{f6}] int[@t{f7}] int[@t{f8}])) +@end format +@end cartouche + +Each Font represents the font style for a different element, in the +following order: title, caption, footnote, row labels, column labels, +corner labels, data, and layers. + +@code{index} is the 1-based index of the Font, i.e. 1 for the first +Font, through 8 for the final Font. + +@code{typeface} is the string name of the font. In the corpus, this +is @code{SansSerif} in over 99% of instances and @code{Times New +Roman} in the rest. + +@code{fgcolor} and @code{bgcolor} are the foreground color and +background color, respectively. In the corpus, these are always +@code{#000000} and @code{#ffffff}, respectively. + +The meaning of the remaining data is unknown. It seems likely to +include font sizes, horizontal and vertical alignment, attributes such +as bold or italic, and margins. + +The table below lists the values observed in the corpus. When a cell +contains a single value, then 99@math{+}% of the corpus contains that value. +When a cell contains a pair of values, then the first value is seen in +about two-thirds of the corpus and the second value in about the +remaining one-third. In fonts that include multiple pairs, values are +correlated, that is, for font 3, f5 = 24, f6 = 24, f7 = 2 appears +about two-thirds of the time, as does the combination of f4 = 0, f6 = +10 for font 7. + +@multitable {font} {40} {f2} {64173} {0/1} {24/11} {10/11} {2/3} {f8} +@headitem font @tab f1 @tab f2 @tab f3 @tab f4 @tab f5 @tab f6 @tab f7 @tab f8 +@item 1 @tab 40 @tab 1 @tab 0 @tab 0 @tab 8 @tab 10/11 @tab 1 @tab 8 +@item 2 @tab 40 @tab 0 @tab 2 @tab 1 @tab 8 @tab 10/11 @tab 1 @tab 1 +@item 3 @tab 40 @tab 0 @tab 2 @tab 1 @tab 24/11 @tab 24/ 8 @tab 2/3 @tab 4 +@item 4 @tab 40 @tab 0 @tab 2 @tab 3 @tab 8 @tab 10/11 @tab 1 @tab 1 +@item 5 @tab 40 @tab 0 @tab 0 @tab 1 @tab 8 @tab 10/11 @tab 1 @tab 4 +@item 6 @tab 40 @tab 0 @tab 2 @tab 1 @tab 8 @tab 10/11 @tab 1 @tab 4 +@item 7 @tab 40 @tab 0 @tab 64173 @tab 0/1 @tab 8 @tab 10/11 @tab 1 @tab 1 +@item 8 @tab 40 @tab 0 @tab 2 @tab 3 @tab 8 @tab 10/11 @tab 1 @tab 4 +@end multitable + +@node SPV Light Member Formats +@subsection Formats + +@cartouche +@format +Formats @result{} + int[@t{n1}] byte*[@t{n1}] + int[@t{n2}] byte*[@t{n2}] + int[@t{n3}] byte*[@t{n3}] + int[@t{n4}] int*[@t{n4}] + string[@t{encoding}] + (i0 @math{|} i-1) (00 @math{|} 01) 00 (00 @math{|} 01) + int + byte[@t{decimal}] byte[@t{grouping}] + int[@t{n-ccs}] string*[@t{n-ccs}] + v1(i0) + v3(count(count(X5) count(X6))) + +X5 @result{} byte*33 int[@t{n}] int*[@t{n}] +X6 @result{} + 01 00 (03 @math{|} 04) 00 00 00 + string[@t{command}] string[@t{subcommand}] + string[@t{language}] string[@t{charset}] string[@t{locale}] + (00 @math{|} 01) 00 (00 @math{|} 01) (00 @math{|} 01) + int + byte[@t{decimal}] byte[@t{grouping}] + byte*8 01 + (string[@t{dataset}] string[@t{datafile}] i0 int i0)? + int[@t{n-ccs}] string*[@t{n-ccs}] + 2e (00 @math{|} 01) (i2000000 i0)? +@end format +@end cartouche + +In every example in the corpus, @code{n1} is 240. The meaning of the +bytes that follow it is unknown. + +In every example in the corpus, @code{n2} is 18 and the bytes that +follow it are @code{00 00 00 01 00 00 00 00 00 00 00 00 00 02 00 00 00 +00}. The meaning of these bytes is unknown. + +In every example in the corpus for version 1, @code{n3} is 16 and the +bytes that follow it are @code{00 00 00 01 00 00 00 01 00 00 00 00 01 +01 01 01}. In version 3, observed @code{n3} varies from 117 to 150, +and its bytes include a 1-byte count at offset 0x34. When the count +is nonzero, a text string of that length at offset 0x35 is the name of +a ``TableLook'', e.g. ``Default'' or ``Academic''. + +Observed values of @code{n4} vary from 0 to 17. Out of 7,060 examples +in the corpus, it is nonzero only 36 times. + +@code{encoding} is a character encoding, usually a Windows code page +such as @code{en_US.windows-1252} or @code{it_IT.windows-1252}. The +rest of the character strings in the member use this encoding. The +encoding string is itself encoded in US-ASCII. + +@code{decimal} is the decimal point character. The observed values +are @samp{.} and @samp{,}. + +@code{grouping} is the grouping character. Usually, it is @samp{,} if +@code{decimal} is @samp{.}, and vice versa. Other observed values are +@samp{'} (apostrophe), @samp{ } (space), and zero (presumably +indicating that digits should not be grouped). + +@code{n-ccs} is observed as either 0 or 5. When it is 5, the +following strings are CCA through CCE format strings. @xref{Custom +Currency Formats,,, pspp, PSPP}. Most commonly these are all +@code{-,,,} but other strings occur. + +@node SPV Light Member Dimensions +@subsection Dimensions + +A pivot table presents multidimensional data. A Dimension identifies +the categories associated with each dimension. + +@cartouche +@format +Dimensions @result{} int[@t{n-dims}] Dimension*[@t{n-dims}] +Dimension @result{} Value[@t{name}] DimUnknown int[@t{n-categories}] Category*[@t{n-categories}] +DimUnknown @result{} + byte[@t{d1}] + (00 @math{|} 01 @math{|} 02)[@t{d2}] + (i0 @math{|} i2)[@t{d3}] + (00 @math{|} 01)[@t{d4}] + (00 @math{|} 01)[@t{d5}] + 01 + int[@t{d6}] +@end format +@end cartouche + +@code{name} is the name of the dimension, e.g. @code{Variables}, +@code{Statistics}, or a variable name. + +@code{d1} is usually 0 but many other values have been observed. + +@code{d3} is 2 over 99% of the time. + +@code{d5} is 0 over 99% of the time. + +@code{d6} is either -1 or the 0-based index of the dimension, e.g.@: 0 +for the first dimension, 1 for the second, and so on. The latter is +the case 98% of the time in the corpus. + +@node SPV Light Member Categories +@subsection Categories + +Categories are arranged in a tree. Only the leaf nodes in the tree +are really categories; the others just serve as grouping constructs. + +@cartouche +@format +Category @result{} Value[@t{name}] (Leaf @math{|} Group) +Leaf @result{} 00 00 00 i2 int[@t{index}] i0 +Group @result{} + (00 @math{|} 01)[@t{merge}] 00 01 (i0 @math{|} i2)[@t{data}] + i-1 int[@t{n-subcategories}] Category*[@t{n-subcategories}] +@end format +@end cartouche + +@code{name} is the name of the category (or group). + +A Leaf represents a leaf category. The Leaf's @code{index} is a +nonnegative integer less than @code{n-categories} in the Dimension in +which the Category is nested (directly or indirectly). + +A Group represents a Group of nested categories. Usually a Group +contains at least one Category, so that @code{n-subcategories} is +positive, but a few Groups with @code{n-subcategories} 0 has been +observed. + +If a Group's @code{merge} is 00, the most common value, then the group +is really a distinct group that should be represented as such in the +visual representation and user interface. If @code{merge} is 01, the +categories in this group should be shown and treated as if they were +direct children of the group's containing group (or if it has no +parent group, then direct children of the dimension), and this group's +name is irrelevant and should not be displayed. (Merged groups can be +nested!) + +A Group's @code{data} appears to be i2 when all of the categories +within a group are leaf categories that directly represent data values +for a variable (e.g. in a frequency table or crosstabulation, a group +of values in a variable being tabulated) and i0 otherwise. + +@node SPV Light Member Data +@subsection Data + +The final part of an SPV light member contains the actual data. + +@cartouche +@format +Data @result{} + int[@t{layers}] int[@t{rows}] int[@t{columns}] int*[@t{n-dimensions}] + int[@t{n-data}] Datum*[@t{n-data}] +Datum @result{} int64[@t{index}] v3(00?) Value +@end format +@end cartouche + +The values of @code{layers}, @code{rows}, and @code{columns} each +specifies the number of dimensions displayed in layers, rows, and +columns, respectively. Any of them may be zero. Their values sum to +@code{n-dimensions} from Dimensions (@pxref{SPV Light Member +Dimensions}). + +The @code{n-dimensions} integers are a permutation of the 0-based +dimension numbers. The first @code{layers} integers specify each of +the dimensions represented by layers, the next @code{rows} integers +specify the dimensions represented by rows, and the final +@code{columns} integers specify the dimensions represented by columns. +When there is more than one dimension of a given kind, the inner +dimensions are given first. + +The format of a Datum varies slightly from version 1 to version 3: in +version 1 it allows for an extra optional 00 byte. + +A Datum consists of an @code{index} and a Value. Suppose there are +@math{d} dimensions and dimension @math{i}, @math{0 \le i < d}, has +@math{n_i} categories. Consider the datum at coordinates @math{x_i}, +@math{0 \le i < d}, and note that @math{0 \le x_i < n_i}. Then the +index is calculated by the following algorithm: + +@display +let @i{index} = 0 +for each @math{i} from 0 to @math{d - 1}: + @i{index} = (@math{n_i \times} @i{index}) @math{+} @math{x_i} +@end display + +For example, suppose there are 3 dimensions with 3, 4, and 5 +categories, respectively. The datum at coordinates (1, 2, 3) has +index @math{5 \times (4 \times (3 \times 0 + 1) + 2) + 3 = 33}. + +@node SPV Light Member Value +@subsection Value + +Value is used throughout the SPV light member format. It boils down +to a number or a string. + +@cartouche +@format +Value @result{} 00? 00? 00? 00? RawValue +RawValue @result{} + 01 ValueMod int[@t{format}] double[@t{x}] + @math{|} 02 ValueMod int[@t{format}] double[@t{x}] + string[@t{varname}] string[@t{vallab}] (01 @math{|} 02 @math{|} 03) + @math{|} 03 string[@t{local}] ValueMod string[@t{id}] string[@t{c}] (00 @math{|} 01)[@t{type}] + @math{|} 04 ValueMod int[@t{format}] string[@t{vallab}] string[@t{varname}] + (01 @math{|} 02 @math{|} 03) string[@t{s}] + @math{|} 05 ValueMod string[@t{varname}] string[@t{varlabel}] (01 @math{|} 02 @math{|} 03) + @math{|} ValueMod string[@t{format}] int[@t{n-args}] Argument*[@t{n-args}] +Argument @result{} + i0 Value + @math{|} int[@t{x}] i0 Value*[@t{x}@math{+}1] /* @t{x} @math{>} 0 */ +@end format +@end cartouche + +There are several possible encodings, which one can distinguish by the +first nonzero byte in the encoding. + +@table @asis +@item 01 +The numeric value @code{x}, intended to be presented to the user +formatted according to @code{format}, which is in the format described +for system files. @xref{System File Output Formats}, for details. +Most commonly, @code{format} has width 40 (the maximum). + +An @code{x} with the maximum negative double value @code{-DBL_MAX} +represents the system-missing value SYSMIS. (HIGHEST and LOWEST have +not been observed.) @xref{System File Format}, for more about these +special values. + +@item 02 +Similar to @code{01}, with the additional information that @code{x} is +a value of variable @code{varname} and has value label @code{vallab}. +Both @code{varname} and @code{vallab} can be the empty string, the +latter very commonly. + +The meaning of the final byte is unknown. Possibly it is connected to +whether the value or the label should be displayed. + +@item 03 +A text string, in two forms: @code{c} is in English, and sometimes +abbreviated or obscure, and @code{local} is localized to the user's +locale. In an English-language locale, the two strings are often the +same, and in the cases where they differ, @code{local} is more +appropriate for a user interface, e.g.@: @code{c} of ``Not a PxP table +for MCN...'' versus @code{local} of ``Computed only for a PxP table, +where P must be greater than 1.'' + +@code{c} and @code{local} are always either both empty or both +nonempty. + +@code{id} is a brief identifying string whose form seems to resemble a +programming language identifier, e.g.@: @code{cumulative_percent} or +@code{factor_14}. It is not unique. + +@code{type} is 00 for text taken from user input, such as syntax +fragment, expressions, file names, data set names, and 01 for fixed +text strings such as names of procedures or statistics. In the former +case, @code{id} is always the empty string; in the latter case, +@code{id} is still sometimes empty. + +@item 04 +The string value @code{s}, intended to be presented to the user +formatted according to @code{format}. The format for a string is not +too interesting, and the corpus contains many clearly invalid formats +like A16.39 or A255.127 or A134.1, so readers should probably ignore +the format entirely. + +@code{s} is a value of variable @code{varname} and has value label +@code{vallab}. @code{varname} is never empty but @code{vallab} is +commonly empty. + +The meaning of the final byte is unknown. + +@item 05 +Variable @code{varname}, which is rarely observed as empty in the +corpus, with variable label @code{varlabel}, which is often empty. + +The meaning of the final byte is unknown. + +@item 31 or 58 +(These bytes begin a ValueMod.) A format string, analogous to +@code{printf}, followed by one or more Arguments, each of which has +one or more values. The format string uses the following syntax: + +@table @code +@item \% +@itemx \: +@itemx \[ +@itemx \] +Each of these expands to the character following @samp{\\}, to escape +characters that have special meaning in format strings. These are +effective inside and outside the @code{[@dots{}]} syntax forms +described below. + +@item \n +Expands to a new-line, inside or outside the @code{[@dots{}]} forms +described below. + +@item ^@var{i} +Expands to a formatted version of argument @var{i}, which must have +only a single value. For example, @code{^1} expands to the first +argument's @code{value}. + +@item [:@var{a}:]@var{i} +Expands @var{a} for each of the values in @var{i}. @var{a} +should contain one or more @code{^@var{j}} conversions, which are +drawn from the values for argument @var{i} in order. Some examples +from the corpus: + +@table @code +@item [:^1:]1 +All of the values for the first argument, concatenated. + +@item [:^1\n:]1 +Expands to the values for the first argument, each followed by +a new-line. + +@item [:^1 = ^2:]2 +Expands to @code{@var{x} = @var{y}} where @var{x} is the second +argument's first value and @var{y} is its second value. (This would +be used only if the argument has two values. If there were more +values, the second and third values would be directly concatenated, +which would look funny.) +@end table + +@item [@var{a}:@var{b}:]@var{i} +This extends the previous form so that the first values are expanded +using @var{a} and later values are expanded using @var{b}. For an +unknown reason, within @var{a} the @code{^@var{j}} conversions are +instead written as @code{%@var{j}}. Some examples from the corpus: + +@table @code +@item [%1:*^1:]1 +Expands to all of the values for the first argument, separated by +@samp{*}. + +@item [%1 = %2:, ^1 = ^2:]1 +Given appropriate values for the first argument, expands to @code{X = +1, Y = 2, Z = 3}. + +@item [%1:, ^1:]1 +Given appropriate values, expands to @code{1, 2, 3}. +@end table +@end table + +The format string is localized to the user's locale. +@end table + +@node SPV Light Member ValueMod +@subsection ValueMod + +A ValueMod can specify special modifications to a Value. + +@cartouche +@format +ValueMod @result{} + 31 i0 (i0 @math{|} i1 string[@t{subscript}]) + v1(00 (i1 @math{|} i2) 00 00 int 00 00) + v3(count(FormatString Style ValueModUnknown)) + @math{|} 31 i1 int[@t{footnote-number}] Format + @math{|} 31 i2 (00 @math{|} 01 @math{|} 02) 00 (i1 @math{|} i2 @math{|} i3) Format + @math{|} 31 i3 00 00 01 00 i2 Format + @math{|} 58 +Style @result{} 58 @math{|} 31 01? 00? 00? 00? 01 string[@t{fgcolor}] string[@t{bgcolor}] string[@t{typeface}] byte +Format @result{} 00 00 count(FormatString Style 58) +FormatString @result{} count((i0 (58 @math{|} 31 string))?) +ValueModUnknown @result{} 58 @math{|} 31 i0 i0 i0 i0 01 00 (01 @math{|} 02 @math{|} 08) 00 08 00 0a 00) +@end format +@end cartouche + +The @code{footnote-number}, if present, specifies a footnote that the +Value references. The footnote's marker is shown appended to the main +text of the Value, as a superscript. + +The @code{subscript}, if present, specifies a string to append to the +main text of the Value, as a subscript. The subscript text is a brief +indicator, e.g.@: @samp{a} or @samp{a,b}, with its meaning indicated +by the table caption. In this usage, subscripts are similar to +footnotes; one apparent difference is that a Value can only reference +one footnote but a subscript can list more than one letter. + +The Format, if present, is a format string for substitutions using the +syntax explained previously. It appears to be an English-language +version of the localized format string in the Value in which the +Format is nested. + +The Style, if present, changes the style for this individual Value. + +@node SPV Legacy Detail Member Binary Format +@section Legacy Detail Member Binary Format + +Whereas the light binary format represents everything about a given +pivot table, the legacy binary format conceptually consists of a +number of named sources, each of which consists of a number of named +series, each of which is a 1-dimensional array of numbers or strings +or a mix. Thus, the legacy binary member format is quite simple. + +This section uses the same context-free grammar notation as in the +previous section, with the following additions: + +@table @asis +@item vAF(@var{x}) +In a version 0xaf legacy member, @var{x}; in other versions, nothing. +(The legacy member header indicates the version; see below.) + +@item vB0(@var{x}) +In a version 0xb0 legacy member, @var{x}; in other versions, nothing. +@end table + +A legacy detail member @file{.bin} has the following overall format: + +@cartouche +@format +LegacyBinary @result{} + 00 byte[@t{version}] int16[@t{n-sources}] int[@t{member-size}] + Metadata*[@t{n-sources}] Data*[@t{n-sources}] +@end format +@end cartouche + +@code{version} is a version number that affects the interpretation of +some of the other data in the member. Versions 0xaf and 0xb0 are +known. We will refer to ``version 0xaf'' and ``version 0xb0'' members +later on. + +A legacy member consists of @code{n-sources} data sources, each of +which has Metadata and Data. + +@code{member-size} is the size of the legacy binary member, in bytes. + +The following sections go into more detail. + +@menu +* SPV Legacy Member Metadata:: +* SPV Legacy Member Data:: +@end menu + +@node SPV Legacy Member Metadata +@subsection Metadata + +@cartouche +@format +Metadata @result{} + int[@t{per-series}] int[@t{n-series}] int[@t{offset}] + vAF(byte*32[@t{source-name}]) + vB0(byte*64[@t{source-name}] int[@t{x}]) +@end format +@end cartouche + +A data source consists of @code{n-series} series of data, with +@code{per-series} data values per series. + +@code{source-name} is a 32- or 64-byte string padded on the right with +zero bytes. The names that appear in the corpus are very generic, +usually @code{tableData} or @code{source0}. + +A given Metadata's @code{offset} is the offset, in bytes, from the +beginning of the member to the start of the corresponding Data. This +allows programs to skip to the beginning of the data for a particular +source; it is also important to determine whether a source includes +any string data (@pxref{SPV Legacy Member Data}). + +The meaning of @code{x} in version 0xb0 is unknown. + +@node SPV Legacy Member Data +@subsection Data + +@cartouche +@format +Data @result{} NumericData StringData? +NumericData @result{} NumericSeries*[@t{n-series}] +NumericSeries @result{} byte*288[@t{series-name}] double*[@t{per-series}] +@end format +@end cartouche + +Data follow the Metadata in the legacy binary format, with sources in +the same order. Each NumericSeries begins with a @code{series-name} +that generally indicates its role in the pivot table, e.g.@: ``cell'', +``cellFormat'', ``dimension0categories'', ``dimension0group0'', +followed by the numeric data, one double per element in the series. A +double with the maximum negative double @code{-DBL_MAX} represents the +system-missing value SYSMIS. + +@cartouche +@format +StringData @result{} i1 string[@t{source-name}] Pairs Labels + +Pairs @result{} int[@t{n-string-series}] PairSeries*[@t{n-string-series}] +PairSeries @result{} string[@t{pair-series-name}] int[@t{n-pairs}] Pair*[@t{n-pairs}] +Pair @result{} int[@t{i}] int[@t{j}] + +Labels @result{} int[@t{n-labels}] Label*[@t{n-labels}] +Label @result{} int[@t{frequency}] int[@t{s}] +@end format +@end cartouche + +A source may include a mix of numeric and string data values. When a +source includes any string data, the data values that are strings are +set to SYSMIS in the NumericSeries, and StringData follows the +NumericData. A source that contains no string data omits the +StringData. To reliably determine whether a source includes +StringData, the reader should check whether the offset following the +NumericData is the offset of the next series, as indicated by its +Metadata (or the end of the member, in the case of the last source). + +StringData repeats the name of the source (from Metadata). + +The string data overlays the numeric data. @code{n-string-series} is +the number of series within the source that include string data. More +precisely, it is the 1-based index of the last series in the source +that includes any string data; thus, it would be 4 if there are 5 +series and only the fourth one includes string data. + +Each PairSeries consists a sequence of 0 or more Pair nonterminals, +each of which maps from a 0-based index within series @code{i} to a +0-based label index @code{j}, e.g.@: pair @code{i} = 2, @code{j} = 3, +means that the third data value (with value SYSMIS) is to be replaced +by the string of the fourth Label. + +The labels themselves follow the pairs. The valuable part of each +label is the string @code{s}. Each label also includes a +@code{frequency} that reports the number of pairs that reference it +(although this is not useful). + +@node SPV Legacy Detail Member XML Format +@section Legacy Detail Member XML Format + +This format is still under investigation. diff --git a/doc/dev/spv-structure.eps b/doc/dev/spv-structure.eps new file mode 100644 index 000000000..af2e21e0c --- /dev/null +++ b/doc/dev/spv-structure.eps @@ -0,0 +1,626 @@ +%!PS-Adobe-3.0 EPSF-3.0 +%%Creator: graphviz version 2.38.0 (20140413.2041) +%%Title: spv_structure +%%Pages: 1 +%%BoundingBox: 36 36 517 487 +%%EndComments +save +%%BeginProlog +/DotDict 200 dict def +DotDict begin + +/setupLatin1 { +mark +/EncodingVector 256 array def + EncodingVector 0 + +ISOLatin1Encoding 0 255 getinterval putinterval +EncodingVector 45 /hyphen put + +% Set up ISO Latin 1 character encoding +/starnetISO { + dup dup findfont dup length dict begin + { 1 index /FID ne { def }{ pop pop } ifelse + } forall + /Encoding EncodingVector def + currentdict end definefont +} def +/Times-Roman starnetISO def +/Times-Italic starnetISO def +/Times-Bold starnetISO def +/Times-BoldItalic starnetISO def +/Helvetica starnetISO def +/Helvetica-Oblique starnetISO def +/Helvetica-Bold starnetISO def +/Helvetica-BoldOblique starnetISO def +/Courier starnetISO def +/Courier-Oblique starnetISO def +/Courier-Bold starnetISO def +/Courier-BoldOblique starnetISO def +cleartomark +} bind def + +%%BeginResource: procset graphviz 0 0 +/coord-font-family /Times-Roman def +/default-font-family /Times-Roman def +/coordfont coord-font-family findfont 8 scalefont def + +/InvScaleFactor 1.0 def +/set_scale { + dup 1 exch div /InvScaleFactor exch def + scale +} bind def + +% styles +/solid { [] 0 setdash } bind def +/dashed { [9 InvScaleFactor mul dup ] 0 setdash } bind def +/dotted { [1 InvScaleFactor mul 6 InvScaleFactor mul] 0 setdash } bind def +/invis {/fill {newpath} def /stroke {newpath} def /show {pop newpath} def} bind def +/bold { 2 setlinewidth } bind def +/filled { } bind def +/unfilled { } bind def +/rounded { } bind def +/diagonals { } bind def +/tapered { } bind def + +% hooks for setting color +/nodecolor { sethsbcolor } bind def +/edgecolor { sethsbcolor } bind def +/graphcolor { sethsbcolor } bind def +/nopcolor {pop pop pop} bind def + +/beginpage { % i j npages + /npages exch def + /j exch def + /i exch def + /str 10 string def + npages 1 gt { + gsave + coordfont setfont + 0 0 moveto + (\() show i str cvs show (,) show j str cvs show (\)) show + grestore + } if +} bind def + +/set_font { + findfont exch + scalefont setfont +} def + +% draw text fitted to its expected width +/alignedtext { % width text + /text exch def + /width exch def + gsave + width 0 gt { + [] 0 setdash + text stringwidth pop width exch sub text length div 0 text ashow + } if + grestore +} def + +/boxprim { % xcorner ycorner xsize ysize + 4 2 roll + moveto + 2 copy + exch 0 rlineto + 0 exch rlineto + pop neg 0 rlineto + closepath +} bind def + +/ellipse_path { + /ry exch def + /rx exch def + /y exch def + /x exch def + matrix currentmatrix + newpath + x y translate + rx ry scale + 0 0 1 0 360 arc + setmatrix +} bind def + +/endpage { showpage } bind def +/showpage { } def + +/layercolorseq + [ % layer color sequence - darkest to lightest + [0 0 0] + [.2 .8 .8] + [.4 .8 .8] + [.6 .8 .8] + [.8 .8 .8] + ] +def + +/layerlen layercolorseq length def + +/setlayer {/maxlayer exch def /curlayer exch def + layercolorseq curlayer 1 sub layerlen mod get + aload pop sethsbcolor + /nodecolor {nopcolor} def + /edgecolor {nopcolor} def + /graphcolor {nopcolor} def +} bind def + +/onlayer { curlayer ne {invis} if } def + +/onlayers { + /myupper exch def + /mylower exch def + curlayer mylower lt + curlayer myupper gt + or + {invis} if +} def + +/curlayer 0 def + +%%EndResource +%%EndProlog +%%BeginSetup +14 default-font-family set_font +1 setmiterlimit +% /arrowlength 10 def +% /arrowwidth 5 def + +% make sure pdfmark is harmless for PS-interpreters other than Distiller +/pdfmark where {pop} {userdict /pdfmark /cleartomark load put} ifelse +% make '<<' and '>>' safe on PS Level 1 devices +/languagelevel where {pop languagelevel}{1} ifelse +2 lt { + userdict (<<) cvn ([) cvn load put + userdict (>>) cvn ([) cvn load put +} if + +%%EndSetup +setupLatin1 +%%Page: 1 1 +%%PageBoundingBox: 36 36 517 487 +%%PageOrientation: Portrait +0 0 1 beginpage +gsave +36 36 481 451 boxprim clip newpath +1 1 set_scale 0 rotate 40 40 translate +% heading +gsave +1 setlinewidth +0 0 0 nodecolor +253.65 425 38.19 18 ellipse_path stroke +0 0 0 nodecolor +14 /Times-Roman set_font +232.15 421.3 moveto 43 (heading) alignedtext +grestore +% heading->heading +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 288.31 432.87 moveto +300.31 432.96 309.99 430.33 309.99 425 curveto +309.99 421.33 305.41 418.95 298.65 417.84 curveto +stroke +0 0 0 edgecolor +newpath 298.53 414.33 moveto +288.31 417.13 lineto +298.04 421.31 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 298.53 414.33 moveto +288.31 417.13 lineto +298.04 421.31 lineto +closepath stroke +0 0 0 edgecolor +14 /Times-Roman set_font +309.99 421.3 moveto 7 (*) alignedtext +grestore +% pageSetup +gsave +1 setlinewidth +0 0 0 nodecolor +173.65 338 47.39 18 ellipse_path stroke +0 0 0 nodecolor +14 /Times-Roman set_font +145.15 334.3 moveto 57 (pageSetup) alignedtext +grestore +% heading->pageSetup +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 238.6 408.01 moveto +226.61 395.27 209.63 377.24 196.04 362.8 curveto +stroke +0 0 0 edgecolor +newpath 198.3 360.09 moveto +188.9 355.21 lineto +193.2 364.89 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 198.3 360.09 moveto +188.9 355.21 lineto +193.2 364.89 lineto +closepath stroke +0 0 0 edgecolor +14 /Times-Roman set_font +218.65 377.8 moveto 7 (?) alignedtext +grestore +% label +gsave +1 setlinewidth +0 0 0 nodecolor +269.65 251 27.9 18 ellipse_path stroke +0 0 0 nodecolor +14 /Times-Roman set_font +256.15 247.3 moveto 27 (label) alignedtext +grestore +% heading->label +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 255.24 406.88 moveto +258.02 377 263.77 315.11 267.11 279.27 curveto +stroke +0 0 0 edgecolor +newpath 270.62 279.33 moveto +268.06 269.05 lineto +263.65 278.68 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 270.62 279.33 moveto +268.06 269.05 lineto +263.65 278.68 lineto +closepath stroke +grestore +% container +gsave +1 setlinewidth +0 0 0 nodecolor +325.65 338 43.59 18 ellipse_path stroke +0 0 0 nodecolor +14 /Times-Roman set_font +300.15 334.3 moveto 51 (container) alignedtext +grestore +% heading->container +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 267.19 408.01 moveto +277.88 395.39 292.97 377.57 305.15 363.2 curveto +stroke +0 0 0 edgecolor +newpath 308.13 365.1 moveto +311.92 355.21 lineto +302.78 360.57 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 308.13 365.1 moveto +311.92 355.21 lineto +302.78 360.57 lineto +closepath stroke +0 0 0 edgecolor +14 /Times-Roman set_font +293.65 377.8 moveto 7 (*) alignedtext +grestore +% pageHeader +gsave +1 setlinewidth +0 0 0 nodecolor +52.65 251 52.79 18 ellipse_path stroke +0 0 0 nodecolor +14 /Times-Roman set_font +20.15 247.3 moveto 65 (pageHeader) alignedtext +grestore +% pageSetup->pageHeader +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 152.01 321.8 moveto +132.89 308.37 104.8 288.63 83.35 273.57 curveto +stroke +0 0 0 edgecolor +newpath 85.1 270.52 moveto +74.91 267.64 lineto +81.08 276.25 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 85.1 270.52 moveto +74.91 267.64 lineto +81.08 276.25 lineto +closepath stroke +grestore +% pageFooter +gsave +1 setlinewidth +0 0 0 nodecolor +173.65 251 50.09 18 ellipse_path stroke +0 0 0 nodecolor +14 /Times-Roman set_font +143.15 247.3 moveto 61 (pageFooter) alignedtext +grestore +% pageSetup->pageFooter +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 173.65 319.8 moveto +173.65 308.16 173.65 292.55 173.65 279.24 curveto +stroke +0 0 0 edgecolor +newpath 177.15 279.18 moveto +173.65 269.18 lineto +170.15 279.18 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 177.15 279.18 moveto +173.65 269.18 lineto +170.15 279.18 lineto +closepath stroke +grestore +% container->label +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 314.58 320.21 moveto +306.37 307.74 295.05 290.56 285.82 276.56 curveto +stroke +0 0 0 edgecolor +newpath 288.54 274.32 moveto +280.12 267.9 lineto +282.7 278.17 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 288.54 274.32 moveto +280.12 267.9 lineto +282.7 278.17 lineto +closepath stroke +grestore +% table +gsave +1 setlinewidth +0 0 0 nodecolor +397.65 251 27.9 18 ellipse_path stroke +0 0 0 nodecolor +14 /Times-Roman set_font +384.15 247.3 moveto 27 (table) alignedtext +grestore +% container->table +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 339.53 320.61 moveto +350.46 307.71 365.83 289.56 378.02 275.17 curveto +stroke +0 0 0 edgecolor +newpath 380.98 277.09 moveto +384.77 267.2 lineto +375.64 272.56 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 380.98 277.09 moveto +384.77 267.2 lineto +375.64 272.56 lineto +closepath stroke +0 0 0 edgecolor +14 /Times-Roman set_font +365.65 290.8 moveto 7 (*) alignedtext +grestore +% text +gsave +1 setlinewidth +0 0 0 nodecolor +281.65 91 27 18 ellipse_path stroke +0 0 0 nodecolor +14 /Times-Roman set_font +271.15 87.3 moveto 21 (text) alignedtext +grestore +% container->text +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 322.55 319.77 moveto +315.01 277.78 295.63 169.86 286.52 119.12 curveto +stroke +0 0 0 edgecolor +newpath 289.95 118.43 moveto +284.74 109.21 lineto +283.06 119.67 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 289.95 118.43 moveto +284.74 109.21 lineto +283.06 119.67 lineto +closepath stroke +0 0 0 edgecolor +14 /Times-Roman set_font +302.65 203.8 moveto 7 (*) alignedtext +grestore +% tableStructure +gsave +1 setlinewidth +0 0 0 nodecolor +413.65 164 59.59 18 ellipse_path stroke +0 0 0 nodecolor +14 /Times-Roman set_font +375.65 160.3 moveto 76 (tableStructure) alignedtext +grestore +% table->tableStructure +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 400.88 232.8 moveto +403.07 221.16 406.01 205.55 408.52 192.24 curveto +stroke +0 0 0 edgecolor +newpath 412 192.65 moveto +410.41 182.18 lineto +405.12 191.36 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 412 192.65 moveto +410.41 182.18 lineto +405.12 191.36 lineto +closepath stroke +grestore +% html +gsave +1 setlinewidth +0 0 0 nodecolor +281.65 18 27.1 18 ellipse_path stroke +0 0 0 nodecolor +14 /Times-Roman set_font +268.65 14.3 moveto 26 (html) alignedtext +grestore +% text->html +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 281.65 72.81 moveto +281.65 64.79 281.65 55.05 281.65 46.07 curveto +stroke +0 0 0 edgecolor +newpath 285.15 46.03 moveto +281.65 36.03 lineto +278.15 46.03 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 285.15 46.03 moveto +281.65 36.03 lineto +278.15 46.03 lineto +closepath stroke +grestore +% dataPath +gsave +1 setlinewidth +0 0 0 nodecolor +413.65 91 40.89 18 ellipse_path stroke +0 0 0 nodecolor +14 /Times-Roman set_font +390.15 87.3 moveto 47 (dataPath) alignedtext +grestore +% tableStructure->dataPath +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 413.65 145.81 moveto +413.65 137.79 413.65 128.05 413.65 119.07 curveto +stroke +0 0 0 edgecolor +newpath 417.15 119.03 moveto +413.65 109.03 lineto +410.15 119.03 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 417.15 119.03 moveto +413.65 109.03 lineto +410.15 119.03 lineto +closepath stroke +grestore +% pageParagraph +gsave +1 setlinewidth +0 0 0 nodecolor +173.65 164 63.09 18 ellipse_path stroke +0 0 0 nodecolor +14 /Times-Roman set_font +133.15 160.3 moveto 81 (pageParagraph) alignedtext +grestore +% pageHeader->pageParagraph +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 74.56 234.61 moveto +93.59 221.24 121.37 201.72 142.68 186.75 curveto +stroke +0 0 0 edgecolor +newpath 144.9 189.47 moveto +151.08 180.85 lineto +140.88 183.74 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 144.9 189.47 moveto +151.08 180.85 lineto +140.88 183.74 lineto +closepath stroke +0 0 0 edgecolor +14 /Times-Roman set_font +120.65 203.8 moveto 7 (*) alignedtext +grestore +% pageFooter->pageParagraph +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 173.65 232.8 moveto +173.65 221.16 173.65 205.55 173.65 192.24 curveto +stroke +0 0 0 edgecolor +newpath 177.15 192.18 moveto +173.65 182.18 lineto +170.15 192.18 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 177.15 192.18 moveto +173.65 182.18 lineto +170.15 192.18 lineto +closepath stroke +0 0 0 edgecolor +14 /Times-Roman set_font +173.65 203.8 moveto 7 (*) alignedtext +grestore +% pageParagraph->text +gsave +1 setlinewidth +0 0 0 edgecolor +newpath 197.61 147.24 moveto +214.44 136.18 236.98 121.37 254.47 109.86 curveto +stroke +0 0 0 edgecolor +newpath 256.67 112.61 moveto +263.11 104.19 lineto +252.83 106.76 lineto +closepath fill +1 setlinewidth +solid +0 0 0 edgecolor +newpath 256.67 112.61 moveto +263.11 104.19 lineto +252.83 106.76 lineto +closepath stroke +grestore +endpage +showpage +grestore +%%PageTrailer +%%EndPage: 1 +%%Trailer +end +restore +%%EOF diff --git a/doc/dev/spv-structure.gv b/doc/dev/spv-structure.gv new file mode 100644 index 000000000..7807ab48d --- /dev/null +++ b/doc/dev/spv-structure.gv @@ -0,0 +1,25 @@ +digraph spv_structure { + "heading" -> "pageSetup" [label="?"]; + "heading" -> "label"; + "heading" -> "container" [label="*"]; + "heading" -> "heading" [label="*"]; + + "container" -> "label"; + "container" -> "table" [label="*"]; + "container" -> "text" [label="*"]; + + "text" -> "html"; + + "table" -> "tableStructure"; + + "tableStructure" -> "dataPath"; + + "pageSetup" -> "pageHeader"; + "pageSetup" -> "pageFooter"; + + "pageHeader" -> "pageParagraph" [label="*"]; + + "pageFooter" -> "pageParagraph" [label="*"]; + + "pageParagraph" -> "text"; +} diff --git a/doc/dev/spv-structure.pdf b/doc/dev/spv-structure.pdf new file mode 100644 index 0000000000000000000000000000000000000000..b54a268cb930e41e99761431ad41c3fde296d277 GIT binary patch literal 16814 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 O8z(#kg}9;w{Qm_MQp=M7 literal 0 HcwPel00001 diff --git a/doc/pspp-dev.texi b/doc/pspp-dev.texi index 07512fd88..a1c623ce0 100644 --- a/doc/pspp-dev.texi +++ b/doc/pspp-dev.texi @@ -37,7 +37,7 @@ This manual is for GNU PSPP version @value{VERSION}, software for statistical analysis. -Copyright @copyright{} 1997, 1998, 2004, 2005, 2007, 2010, 2014, 2015 Free Software Foundation, Inc. +Copyright @copyright{} 1997, 1998, 2004, 2005, 2007, 2010, 2014, 2015, 2016 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -84,6 +84,7 @@ Free Documentation License". * Portable File Format:: Format of PSPP portable files. * System File Format:: Format of PSPP system files. * SPSS/PC+ System File Format:: Format of SPSS/PC+ system files. +* SPSS Viewer File Format:: Format of SPSS Viewer (SPV) files. * Encrypted File Wrappers:: Common wrapper for encrypted SPSS files. * q2c Input Format:: Format of syntax accepted by q2c. @@ -103,6 +104,7 @@ Free Documentation License". @include dev/portable-file-format.texi @include dev/system-file-format.texi @include dev/pc+-file-format.texi +@include dev/spv-file-format.texi @include dev/encrypted-file-wrappers.texi @include dev/q2c.texi -- 2.11.4.GIT