1NC2XY(1)                     Generic Mapping Tools                    NC2XY(1)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

21       -F     Specify  up  to 10 names of the variables (separated by slashes)
22              to be printed out. All variables to be 1-dimensional and  be  of
23              equal length. When omited, the first two variables in the netCDF
24              file will be printed.
25
26       -S     Suppress output for records with one or more NaN values [Default
27              outputs  all nodes].  Append r to reverse the suppression, i.e.,
28              only output the records with at least one NaN value.
29
30       -V     Selects verbose mode, which will send progress reports to stderr
31              [Default runs "silently"].
32
33       -bo    Selects  binary  output.  Append s for single precision [Default
34              is d (double)].  Uppercase S  or  D  will  force  byte-swapping.
35              Optionally,  append  ncol, the number of desired columns in your
36              binary output file.
37
38       -f     Special formatting of input and/or output columns (time or  geo‐
39              graphical  data).   Specify  i  or  o to make this apply only to
40              input or output [Default applies to both].   Give  one  or  more
41              columns (or column ranges) separated by commas.  Append T (abso‐
42              lute calendar time), t (relative time in chosen TIME_UNIT  since
43              TIME_EPOCH),  x (longitude), y (latitude), or f (floating point)
44              to each column or column range item.  Shorthand  -f[i|o]g  means
45              -f[i|o]0x,1y  (geographic  coordinates).   See also TIME COORDI‐
46              NATES below.
47

TIME COORDINATES

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

EXAMPLES

58       To print out latitude, longitude and height in a netCDF file  as  ASCII
59       records, while suppressing all NaN values:
60
61       nc2xy -Flat/lon/height -S trackfile.nc > trackfile.xy
62

SEE ALSO

64       gmtdefaults(1), GMT(1), psxy(1), psxyz(1), xyz2grd(1)
65
66
67
68GMT 4.5.6                         10 Mar 2011                         NC2XY(1)
Impressum