debian man page for nc2xy

NC2XY(1gmt)						       Generic Mapping Tools						       NC2XY(1gmt)

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.  Option-
	      ally, 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  .gmt-
       defaults  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 -Flat/lon/height -S trackfile.nc > trackfile.xy

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

GMT 4.5.7							    15 Jul 2011 						       NC2XY(1gmt)