Editing RSF Comprehensive Description (section)

==Encoded information==
A RSF dataset consists of: (1) the sequence of numerical values in the array and (2) of information about this "out-of-core array" (metainformation -- data about data). This section attempts to ''define'' the information contained in a RSF dataset is, without concerning itself with the way this information is encoded, which will be done in the section that follows.

A discrete sequence of numbers is quite simple and needs no further explanation. The metainformation requires a more detailed definition. Its distinct components  will be assigned names in italics, to help define the encoding later.

To the extent that is technically practical, each program that acted on the array will record:

* Name of program (''prog'')
* Directory in which the program was run (''dir'')
* User that ran the program (''user'')
* Short hostname of machine on which the program was run (''host''). For example, this would be <tt>machine</tt> instead <tt>machine.university.edu</tt> 
* Date and time (up to seconds) at which the program was started (''datetime'')
* A pointer to the binary data (''pointer'')
* Data type, i.e. integer, real or complex (''type'')
* Data encoding, i.e. name of protocol for representing the data (''format'')
* Size of each data sample in bytes (''esize'')
* For each dimension # in the dataset (1 <= # <= 9), specify:
** Number of elements in that dimension: n#, i.e.: n1, n2, n3... (''nelem_axis#'')
** Origin on that axis: o#, i.e.: o1, o2, o3... (''orig_axis#'')
** Sampling interval on that axis: d#, i.e.: d1, d2, d3... (''sampl_axis#'')
** Label for that axis: label#, i.e.: label1, label2, label3... (''label_axis#'')
** Physical unit for that axis: unit#, i.e.: unit1, unit2, unit3... (''unit_axis#'')