Using v5dimport's text interface

The text/type-in interface to v5dimport is useful when X is not availableor when you want to run v5dimport with a script. To start v5dimport in text mode enter:

v5dimport -t [-path pathname] [files]

where [files] is an optional list of input files and [-path pathname] specifies that the directory named "pathname" is to be used as the default, in place of the current directory, for the input file browser and for making output files. Through the text interface it's possible to run v5dimport with a script by using your shell's import redirection feature:

v5dimport -t < script

After you've invoked v5dimport with the -t option you'll see a >> prompt at which you can issue any of these commands:

exitexit v5dimport
helponline help
listshow lists of grids, timesteps, variables, map projections, or vertical coordinate systems.
readread an input file
keep/omitused to select which grids, according to timestep, variable, map projection or vcs, are to be included in or omitted from the output file.
infodisplay parameters of output file
rowsspecify number of grid rows for output file
columnsspecify number of grid columns for output file
levelsspecify max number of grid levels for output file
projectionspecify the output file's map projection
verticalspecify the output file's vertical coordinate system
makemake the output file
visualizemake the output file and start Vis5D

Using the text interface to v5dimport is similar in strategy to the graphical interface:

  1. Read input files

  2. Select grids by timestep, variable, projection, and/or VCS. This is typically done by a series of list, omit, and keep commands.

  3. Set/adjust output file parameters. Typically a series of info, rows, columns, levels, projection, and vertical commands.

  4. Make the output file, or make the output file and start Vis5D.

Use the help command to learn the exact syntax for each command.

A v5dimport script is simply an ASCII file of v5dimport commands and their arguments. In the simplest case it may contain only a few commands such as:

     # read my file, omit two vars, write v5d file
     read mydata.dat
     omit var CW
     omit var RW
     make outdata.v5d

As v5dimport executes a script it prints each command and its result. Lines that start with a "#" are considered comments and ignored.