Vis5D Documentation
<<< Previous | The v5dimport Utility | Next >>>

# 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:

exit | exit v5dimport
help | online help
list | show lists of grids, timesteps, variables, map projections, or vertical coordinate systems.
read | read an input file
keep/omit | used to select which grids, according to timestep, variable, map projection or vcs, are to be included in or omitted from the output file.
info | display parameters of output file
rows | specify number of grid rows for output file
columns | specify number of grid columns for output file
levels | specify max number of grid levels for output file
projection | specify the output file's map projection
vertical | specify the output file's vertical coordinate system
make | make the output file
visualize | make 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
         exit

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

<<< Previous | Home | Next >>>
The v5dimport User Interface Embedded in Vis5D | Up | Adding support for new file format