<< >> Up Title Contents

load


load <form>,<fname>[,<par>,<par>]

Reads a data set from file <fname>. The format of the input file is given by the value of <form>. Some formats require additional parameters <par>.

Here is a list of the available formats:

cr

load cr,<file>

Reads a "crystal" file format which contains coordinates for the atoms and typ, colour and size for the marker for the specific atom. Those code numbers for typ, colour and size are the same used with the 'mtyp', 'mcol' and 'msiz' commands. The points are plotted in the xy plane, i.e. projected along z.

  0.5 0.5 0.5   5 3 1.00
  1.0 1.0 1.0   5 6 0.75

The first atom at (0.5 0.5 0.5) is represented by a red (col=3) filled square (typ =5) of the size 1.00 whereas the second atom is a black (col=6) filled smaller square. The size is given relative to the size set with -> 'msiz'. The first atom is plotted with the full size set with 'msiz' whereas the second atom is only 75% of that size.

de

load de,<file>,<gridx>,<gridy>

This command works similar to the 'load zz,..' command but rather that reading a xyz-file, a histogram of a xy-file is calculated, i.e. z represents the number of points x,y which fall in a grid of the size <gridx> and <gridy>.

ma

load ma,<file>

This commands reads a "marker" file which is a normal xy-file, but the program will only use the x coordinate , y is set to zero. So tick marks at the x-axis can be drawn.

ni

load ni,<file>[,<white>]

This file format is also an old "Garching format" used by an even older plot program. It contains gridded 3d data in the following format:

line 1    : nx ny                    ! number of points in x and y
line 2    : xmin xmax ymin ymax      ! range in x and y
line 3-xx : z z z z z z z            ! z-values increasing in x and y
NOTE: The way KUPLOT stores the data point requires that the LARGEST
      3D file is loaded FIRST, otherwise the error message 'Number of
      data points exceeds limits' will appear.

pg

load pg,<file>

Here is finally a universal 3d data file format known by KUPLOT, PGM files (from netpbm library). The current KUPLOT version can only read ascii PGM files which have the code P2 in the first line of the program.

NOTE: The way KUPLOT stores the data point requires that the LARGEST
      3D file is loaded FIRST, otherwise the error message 'Number of
      data points exceeds limits' will appear.

xy

load xy,<file>

Reads "xy"-file which contains the coordinated of each point in a row followed by optional errors for x and y. Blank lines are ignored. Here are two simple examples for xy-files:

(1) without errors  (x y)
    21.322 2.111
    17.221 2.444
(2) with errors (x y dx dy)
    21.322 2.111 0.65 0.12
    17.221 2.444 0.32 0.22

yx

load yx,<file>

Reads the same file typ as 'load xy,..' just in opposite order, i.e. "y x" or "y x dy dx".

zz

load zz,<file>,<gridx>,<gridy>

This command reads a xyz-file, each xyz triplett on a single line. The data points are binned to a regular grid of the size <gridx> and <gridy>. The number of points in each direction is calculated by the program. This command can also be used to rebin data on a regular grid to a broader one.

NOTE: The way KUPLOT stores the data point requires that the LARGEST
      3D file is loaded FIRST, otherwise the error message 'Number of
      data points exceeds limits' will appear.

special

load <form>,<file>

KUPLOT can read certain special file formats produced by the program MAN2 and MAN1 used at the Institut fuer Kristallographie of the University Munich. Those formats are summed up in the following list:

T1/T2   MAN2-Pfausdatei            2-Theta gegen Zaehlrohr 1/2
C1/C2   MAN2-Pfausdatei            Chi     gegen Zaehlrohr 1/2
P1/P2   MAN2-Pfausdatei            Phi     gegen Zaehlrohr 1/2
O1/O2   MAN2-Pfausdatei            Omega   gegen Zaehlrohr 1/2
H1/H2   MAN2-Pfausdatei            H gegen Zaehlrohr 1/2
K1/K2   MAN2-Pfausdatei            K gegen Zaehlrohr 1/2
K1/K2   MAN2-Pfausdatei            K gegen Zaehlrohr 1/2
L1/L2   MAN2-Pfausdatei            L gegen Zaehlrohr 1/2
 TE     MAN2-Pfausdatei            Messpunktnummer gegen Temperatur (822)
 DM     MAN2-Pfausdatei            Messpunktnummer gegen DMM-Wert
 ZE     MAN2-Pfausdatei            Messpunktnummer gegen Messzeit
Z1/Z2   Messdatei von PULx         Zaehlrohr 1 bzw. 2

Two other special formats are the output files of the FAST data collection software of the area detector used in Munich. The two formats are:

 DA     MP-Datei (binaer)          Flaechenzaehlerdatei
 AS     MP-Datei (ascii)           Flaechenzaehlerdatei


<< >> Up Title Contents