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:
Read input files
Select grids by timestep, variable, projection, and/or VCS. This is typically done by a series of list, omit, and keep commands.
Set/adjust output file parameters. Typically a series of info, rows, columns, levels, projection, and vertical commands.
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.