DragonFly On-Line Manual Pages

Search: Section:  

NC2XY(1)                     Generic Mapping Tools                    NC2XY(1)


NAME

       nc2xy - Converting netCDF column file(s) to ASCII xy data


SYNOPSIS

       nc2xy files [ -Fvar1/var2/... ] [ -S[r] ] [ -V ] [ -fcolinfo ] [ -bo ]


DESCRIPTION

       nc2xy reads one or more netCDF files with column data and writes out
       those columns in ASCII format to standard output, so that they can be
       used by psxy, psxyz, or xyz2grd.  Modify the precision of the ASCII
       output format by editing the D_FORMAT parameter in your .gmtdefaults4
       file or use --D_FORMAT=value on the command line.

       files  Names of netCDF files to be converted.


OPTIONS

       -F     Specify up to 10 names of the variables (separated by slashes)
              to be printed out. All variables to be 1-dimensional and be of
              equal length. When omited, the first two variables in the netCDF
              file will be printed.

       -S     Suppress output for records with one or more NaN values [Default
              outputs all nodes].  Append r to reverse the suppression, i.e.,
              only output the records with at least one NaN value.

       -V     Selects verbose mode, which will send progress reports to stderr
              [Default runs "silently"].

       -bo    Selects binary output.  Append s for single precision [Default
              is d (double)].  Uppercase S or D will force byte-swapping.
              Optionally, append ncol, the number of desired columns in your
              binary output file.

       -f     Special formatting of input and/or output columns (time or
              geographical data).  Specify i or o to make this apply only to
              input or output [Default applies to both].  Give one or more
              columns (or column ranges) separated by commas.  Append T
              (absolute calendar time), t (relative time in chosen TIME_UNIT
              since TIME_EPOCH), x (longitude), y (latitude), or f (floating
              point) to each column or column range item.  Shorthand -f[i|o]g
              means -f[i|o]0x,1y (geographic coordinates).  See also TIME
              COORDINATES below.


TIME COORDINATES

       Time coordinates in netCDF files will be recognized as such.  The
       variable's unit attribute is parsed to determine the unit and epoch of
       the time coordinate in the grid.  Values are then converted to the
       internal time system specified by TIME_UNIT and TIME_EPOCH in the
       .gmtdefaults file or on the command line.  The default output is
       relative time in that time system, or absolute time when using the
       option -f0T, -f1T, etc.


EXAMPLES

       To print out latitude, longitude and height in a netCDF file as ASCII
       records, while suppressing all NaN values:

       nc2xy -F lat/lon/height -S trackfile.nc > trackfile.xy


SEE ALSO

       gmtdefaults(1), GMT(1), psxy(1), psxyz(1), xyz2grd(1)

GMT 4.5.14                        1 Nov 2015                          NC2XY(1)

Search: Section: