Mon, May 12, 2008
Products Services Download News Company Contact

 


Olis 3D ASCII File Type Specification

The file MUST be written as a tab-delimited ASCII file with the following format:

OLIS-3D-ASCII	Z(1)         Z(2)         Z(3)         Z(...)	      Z(n)
X(1)		Y(x1,  z1)   Y(x1,  z2)   Y(x1,  z3)   Y(x1,  z...)   Y(x1,  zn)
X(2)		Y(x2,  z1)   Y(x2,  z2)   Y(x2,  z3)   Y(x2,  z...)   Y(x2,  zn)
X(3)		Y(x3,  z1)   Y(x3,  z2)   Y(x3,  z3)   Y(x3,  z...)   Y(x3,  zn)
X(...)		Y(x...,z1)   Y(x...,z2)   Y(x...,z3)   Y(x...,z...)   Y(x...,zn)
X(n)		Y(xn,  z1)   Y(xn,  z2)   Y(xn,  z3)   Y(xn,  z...)   Y(xn,  zn)

Where the following is true:

  1. The string "OLIS-3D-ASCII" MUST be the first value in the file because it acts as a file header. Without this as the header, GlobalWorks will NOT be able to read the file. The header string "OLIS-3D-ASCII" is NOT case-sensitive.
  2. All values other than the "OLIS-3D-ASCII" header are written and read as double-precision (64-bit, signed) floating-point values.
  3. On the same line (the FIRST line) as the "OLIS-3D-ASCII" header, after the header, are the Z-axis values for each scan/assay taken.
  4. All subsequent lines (rows) in the file MUST take the form of the X-axis point followed by a tab-delimited series of Y-axis points for each Z-axis scan/assay. A simple means of thinking of this is that the first "column" of data (except for the header, of course) are the X-axis values for all scans/assays (all scans/assays have a common X-axis). All remaining "columns" are the data for each subsequent scan/assay, except for the first row, which is the Z-axis data). For example, a 100 scan dataset with 100 points per scan should have 101 columns and 101 rows. The "extra" column is the FIRST column (the common X-axis data), and the "extra" row is the FIRST row (the header, and the Z-axis values).
  5. ASCII is a means of storing information such that it is easily readable by humans (text). It should NOT be confused with the file format (how the ASCII text is layed-out in the file).
  6. The file will be written by GlobalWorks with an ".o3a" file extension when 'Save as ASCII' is selected, however the extension is unimportant as long as the format is as noted above.
  7. For clarification, an example graph is shown below with the axes labelled.

	Y		    Z

	     
	Y12
	Y11
	Y10        z10
	Y9        z9
	Y8       z8
	Y7      z7
	Y6     z6
	Y5    z5
	Y4   z4
	Y3  z3
	Y2 z2
	Y1z1
	  X1 X2 X3 X4 X5 X6 X7 X... Xn   X




 ©1996-2006 On-Line Instrument Systems, Inc. (800) 852-3504 Site Index Questions or comments?