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 ]
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=format 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       -f     Special  formatting of input and/or output columns (time or geo‐
34              graphical data).  Specify i or o to  make  this  apply  only  to
35              input  or  output  [Default  applies to both].  Give one or more
36              columns (or column ranges) separated by commas.  Append T (abso‐
37              lute  calendar time), t (relative time in chosen TIME_UNIT since
38              TIME_EPOCH), x (longitude), y (latitude), or f (floating  point)
39              to  each  column or column range item.  Shorthand -f[i|o]g means
40              -f[i|o]0x,1y (geographic coordinates).  See  also  TIME  COORDI‐
41              NATES below.
42

TIME COORDINATES

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

EXAMPLES

53       To  print  out latitude, longitude and height in a netCDF file as ASCII
54       records, while suppressing all NaN values:
55
56       nc2xy -Flat/lon/height -S trackfile.nc > trackfile.xy
57

SEE ALSO

59       gmtdefaults(1), GMT(1), psxy(1), psxyz(1), xyz2grd(1)
60
61
62
63GMT 4.3.1                         15 May 2008                         NC2XY(1)
Impressum