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)