Name

gfs-csv — dump scalar octree data in gerris (gfs) files to uniform grids in CSV format.

Synopsis

gfs-csv [-d delimiter] [-h ] [-i ] [-o file] {-s variable} [-v ] [-V ] file

DESCRIPTION

The gfs-csv utility reads gfs files produced by gerris2D (1) simulations and writes scalar fields defined in them to a uniform grid, as x, y, z CSV data.

Such output data can be processed with many other programs, in particular the GMT (1) suite of plotting programs. The main purpose is to simplify the plotting of Gerris scalars (such as vorticity) alongside the arrows produced by vfplot (1) .

OPTIONS

-d --delimiter character

Use the passed character as delimiter in the output rather than the default comma.

-h --help

Brief help.

-i --index

Write the i, j indices instead of x, y values.

-o --output file

Write output to file rather than standard output.

-s --scalar name

Specify the scalar quantity to extract from the file. The argument can be a GtsVariable such as "Vorticity", or a GtsFunction such as "(Vorticity/2.0 + U)". In the latter case take care to quote shell metacharacters.

This option must be specified at least once, and may be specified multiple times; the effect being to have the columns corresponding to these in the output CVS file.

-v --verbose

Verbose operation.

-V --version

Version information.

EXAMPLES

To extract the scalar field Vorticity from the simulation frame-2.0.gfs

gfs-csv -v -s Vorticity -o v1.dat frame-2.0.gfs

Likewise, but extracting the velocity components

gfs-csv -v -s 'U,V' -o v2.dat frame-2.0.gfs

AUTHOR

J.J. Green ()

SEE ALSO

gerris2D (1) , vfplot-csv (5) , GMT (1) , csv-grd (1) .