mirror of
https://github.com/Unidata/netcdf-c.git
synced 2024-11-21 03:13:42 +08:00
Fix man pages for ncdump and nccopy
This commit is contained in:
parent
75cb7837fb
commit
458612a06e
@ -1,5 +1,5 @@
|
|||||||
.\" $Id: nccopy.1 400 2010-08-27 21:02:52Z russ $
|
.\" $Id: nccopy.1 400 2010-08-27 21:02:52Z russ $
|
||||||
.TH NCCOPY 1 "$Date$" "Printed: \n(yr-\n(mo-\n(dy" "UNIDATA UTILITIES"
|
.TH NCCOPY 1 "2012-03-08" "Release 4.2" "UNIDATA UTILITIES"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
nccopy \- Copy a netCDF file to specified variant of netCDF format,
|
nccopy \- Copy a netCDF file to specified variant of netCDF format,
|
||||||
optionally compressing or chunking data in the output copy.
|
optionally compressing or chunking data in the output copy.
|
||||||
@ -59,6 +59,7 @@ The possible arguments are as follows.
|
|||||||
.IP "'4', 'hdf5-nc3', 'netCDF-4 classic model', 'enhanced-nc3' => netcdf-4 file format, netcdf-3 type model."
|
.IP "'4', 'hdf5-nc3', 'netCDF-4 classic model', 'enhanced-nc3' => netcdf-4 file format, netcdf-3 type model."
|
||||||
.RE
|
.RE
|
||||||
.RE
|
.RE
|
||||||
|
.IP
|
||||||
If no value for -k is specified, then the output will use the same
|
If no value for -k is specified, then the output will use the same
|
||||||
format as the input, except if the input is classic or 64-bit offset
|
format as the input, except if the input is classic or 64-bit offset
|
||||||
and either chunking or compression is specified, in which case the output will be netCDF-4 classic
|
and either chunking or compression is specified, in which case the output will be netCDF-4 classic
|
||||||
@ -80,7 +81,7 @@ that the output should be netCDF-4 classic model, as that will
|
|||||||
be the default. If this option is not specified and the input file
|
be the default. If this option is not specified and the input file
|
||||||
has compressed variables, the compression will still be preserved
|
has compressed variables, the compression will still be preserved
|
||||||
in the output, using the same chunking as in the input.
|
in the output, using the same chunking as in the input.
|
||||||
.P
|
.IP
|
||||||
Note that \fB nccopy \fP requires all variables to be compressed using
|
Note that \fB nccopy \fP requires all variables to be compressed using
|
||||||
the same compression level, but the API has no such restriction. With
|
the same compression level, but the API has no such restriction. With
|
||||||
a program you can customize compression for each variable independently.
|
a program you can customize compression for each variable independently.
|
||||||
@ -154,13 +155,12 @@ has no such restriction. If you need to customize chunking
|
|||||||
for each variable independently, you will need to use the library API
|
for each variable independently, you will need to use the library API
|
||||||
in a custom utility program.
|
in a custom utility program.
|
||||||
.SH EXAMPLES
|
.SH EXAMPLES
|
||||||
.LP
|
.PP
|
||||||
Make a copy of foo1.nc, a netCDF file of any type, to foo2.nc, a
|
Make a copy of foo1.nc, a netCDF file of any type, to foo2.nc, a
|
||||||
netCDF file of the same type:
|
netCDF file of the same type:
|
||||||
.RS
|
|
||||||
.HP
|
nccopy foo1.nc foo2.nc
|
||||||
nccopy foo1.nc foo2.nc
|
|
||||||
.RE
|
|
||||||
Note that the above copy will not be as fast as use of a
|
Note that the above copy will not be as fast as use of a
|
||||||
simple copy utility, because the file is copied using
|
simple copy utility, because the file is copied using
|
||||||
only the netCDF
|
only the netCDF
|
||||||
@ -170,31 +170,28 @@ netCDF data, those will not be copied, because they are not accessible
|
|||||||
through the netCDF interface. If the original file was generated in
|
through the netCDF interface. If the original file was generated in
|
||||||
`No fill' mode so that fill values are not stored for padding for data
|
`No fill' mode so that fill values are not stored for padding for data
|
||||||
alignment, the output file may have different padding bytes.
|
alignment, the output file may have different padding bytes.
|
||||||
.LP
|
.PP
|
||||||
Convert a netCDF-4 classic model file, compressed.nc, that uses compression,
|
Convert a netCDF-4 classic model file, compressed.nc, that uses compression,
|
||||||
to a netCDF-3 file classic.nc:
|
to a netCDF-3 file classic.nc:
|
||||||
.RS
|
|
||||||
.HP
|
nccopy -k classic compressed.nc classic.nc
|
||||||
nccopy -k classic compressed.nc classic.nc
|
|
||||||
.RE
|
|
||||||
Note that `1' could be used instead of `classic'.
|
Note that `1' could be used instead of `classic'.
|
||||||
.LP
|
.PP
|
||||||
Download the variable `time_bnds' and it's associated attributes from
|
Download the variable `time_bnds' and it's associated attributes from
|
||||||
an OPeNDAP server and copy the result to a netCDF file named `tb.nc':
|
an OPeNDAP server and copy the result to a netCDF file named `tb.nc':
|
||||||
.RS
|
|
||||||
.HP
|
nccopy 'http://test.opendap.org/opendap/data/nc/sst.mnmean.nc.gz?time_bnds' tb.nc
|
||||||
nccopy 'http://test.opendap.org/opendap/data/nc/sst.mnmean.nc.gz?time_bnds' tb.nc
|
|
||||||
.RE
|
|
||||||
Note that URLs that name specific variables as command-line arguments
|
Note that URLs that name specific variables as command-line arguments
|
||||||
should generally be quoted, to avoid the shell interpreting special
|
should generally be quoted, to avoid the shell interpreting special
|
||||||
characters such as `?'.
|
characters such as `?'.
|
||||||
.LP
|
.PP
|
||||||
Compress all the variables in the input file foo.nc, a netCDF file of any
|
Compress all the variables in the input file foo.nc, a netCDF file of any
|
||||||
type, to the output file bar.nc:
|
type, to the output file bar.nc:
|
||||||
.RS
|
|
||||||
.HP
|
nccopy -d1 foo.nc bar.nc
|
||||||
nccopy -d1 foo.nc bar.nc
|
|
||||||
.RE
|
|
||||||
If foo.nc was a classic or 64-bit offset netCDF file, bar.nc will be a
|
If foo.nc was a classic or 64-bit offset netCDF file, bar.nc will be a
|
||||||
netCDF-4 classic model netCDF file, because the classic and 64-bit
|
netCDF-4 classic model netCDF file, because the classic and 64-bit
|
||||||
offset format variants don't support compression. If foo.nc was a
|
offset format variants don't support compression. If foo.nc was a
|
||||||
|
@ -1,5 +1,5 @@
|
|||||||
.\" $Header: /upc/share/CVS/netcdf-3/ncdump/ncdump.1,v 1.10 2009/07/28 14:48:36 russ Exp $
|
.\" $Header: /upc/share/CVS/netcdf-3/ncdump/ncdump.1,v 1.10 2009/07/28 14:48:36 russ Exp $
|
||||||
.TH NCDUMP 1 "$Date: 2009/07/28 14:48:36 $" "Printed: \n(yr-\n(mo-\n(dy" "UNIDATA UTILITIES"
|
.TH NCDUMP 1 "2012-03-08" "Release 4.2" "UNIDATA UTILITIES"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
ncdump \- Convert netCDF file to text form (CDL)
|
ncdump \- Convert netCDF file to text form (CDL)
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
|
Loading…
Reference in New Issue
Block a user