data scalar import command


data scalar import s <keyword>

Import scalars from file s. The extension scalar is added automatically if one is not given.

The file format (text or binary) is determined by opening the file and looking for the appropriate header. If the proper header is not found, an error is indicated and no data imported. If the group keyword is specified, imported scalars are assigned the specified group name. In the event of a conflict, this group assignment overrides any in the import file. The relevant file formats are shown below.

group s <slot s >

Assign the group name s to the slot Default. The optional slot keyword can be used to specify the slot.

Text Format

; The line above is a text mode header indicator  —  it is required for the
; file to be recognized as a scalar data text file.
; Comment field  —  any text after a semicolon is ignored. Blank lines are
; ignored.
; The following first
; All data are comma and space delimited.
GROUP s name ; All scalars following are assigned group name name to the
             ; slot s.
             ; GROUP statements can be added later in the file,
             ; adding to or replacing previous GROUP assignments.
EXTRA i val  ; All scalars following are assigned extra data val in the ith
             ; index.
             ; EXTRA statements can be added later in
             ; the file, adding to or replacing previous EXTRA assignments.
x y z  EXTRA i val  ... GROUP s name  ...
x y z  value EXTRA i val  ... GROUP s name  ...
; Each line indicates a single scalar object. The EXTRA and GROUP keywords
; are optional.
; each EXTRA and GROUP keyword (there can be more than one per line) can
; be followed
; by any number of index value pairs, indicating the index of slot the
; value should be made to.
; Group names are strings (" delimited for embedded spaces).
; EXTRA data can be a string, an integer, or a real.

Binary Format

0x03714711 (unsigned 32 bit integer indicating it is binary scalar data)
3 (unsigned 8 bit integer indicating 2 or 3 dimensions)
Each scalar:
  x y z as double precision
  value as double precision
  uint32 as number of extra, following by that many extra.
  uint32 as number of group names, following by that many strings.
extra:  uint8 as type code (0= 64 bit signed int, 1 = 64 bit double
  precision, 2 = string).
string: uint16 as string length, that many uint16 as string contents.