This command tells IVE that the data set may be spread over
multiple files with each file containing data at one point along
the specified coordinate.
Widget:
- Use the file selection widget described in FILE. Click the button to specify the "file
coordinate" and then type in or select one of the files in the data
set. After double-clicking on the entry (or clicking on the OK
button) you will set a set of sliders showing the values of the
"file coordinate" that IVE found. You can set the sliders choose
any continuous subset of the files you would like. If you set the
start value greater that the finish value, the coordinate will be
used in IVE in descending order. When you are finished setting the
sliders, click on the OK button again to finish reading in the data
set information.
Command:
- MULTIPLE_READ=coordinate
- MULTIPLE_READ=-coordinate
- MULTIPLE_READ=coordinate,start,end
Arguments:
- coordinate: is set to one of the following:
- "x", "y", "z", or "t", chooses the "file coordinate" along
which to recombine data that has been written in a series of
separate files. IVE checks if the current data file contains has
the current value of "coordinate" in its alpha-numeric name. If so,
IVE will look for other files in that directory whose names differ
from that of the current data file by only a numerical constant.
IVE will interpret the different numerical constants in this family
of data files as the set of available values for "coordinate", and
create a slider bar for this coordinate. Any any time a new field
is requested IVE will read the data for that field from the entire
family of individual files. (If the current data file name does not
contain the value of this coordinate then only the specified file
is read when a new field is requested.)
- "none": turns multiple read off.
- start: the starting value of the file coordinate to use
- end: the ending value of the file coordinate to use
If start and end are not specified, IVE will read in all available
files. If a "-" is in front of the coordinate value the files are
read in by decreasing values of the file coordinate, otherwise they
are read by increasing values.
If start and end are specified, IVE will only read files within
the specified range. If start < end, then the files are read in
by increasing values of the file coordinate, otherwise they are
read by decreasing values. The "-" option should not be used to
reverse the ordering of the input files when start and end values
are specified.
Examples:
In this example the multiple read coordinate is set to time.
Suppose you then set the current file to be
"/home/ive/data_1000_run.nc" using the widget or the FILE command, and that file contained variable U
with a single time of value 1000. IVE will then look for other
files of the form "/home/ive/data_*_run.nc" that have time values
for "*". When you set the current field to "U" using the widget or
the FIELD command, IVE will read the
values of U out of all of the proper files and act as if all the
time values of U were in one file.
- MULTIPLE_READ=z, 1000, 100
In this example the multiple read coordinate is set to Z. Suppose
you then set the current file to be "/home/ive/data_1000_run.nc"
using the widget or the FILE command, and
that file contained variable U with a single Z of value 1000. IVE
will then look for other files of the form
"/home/ive/data_*_run.nc" that have z values for "*" in the range
of 1000 to 100. When you set the current field to "U" using the
widget or the FIELD command, IVE will read
the values of U out of all of the proper files and act as if all
the Z values of U were in one file. Plots with a Z axis will have Z
decreasing along the axis.
back to index