ncdump - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

ncdump - Chuyển đổi tệp netCDF sang dạng văn bản (CDL)

SYNOPSIS

ncdump [-chistxw] [-v var1, ...] [-NS lang] [-NS lang] [-l len] [-N tên] [-P
f_digits [, d_digits]] [-NS grp1, ...] hồ sơ

ncdump -k hồ sơ

MÔ TẢ

ncdump tiện ích tạo ra một biểu diễn văn bản của một tệp netCDF được chỉ định trên tiêu chuẩn
đầu ra, tùy chọn loại trừ một số hoặc tất cả dữ liệu biến trong đầu ra. Văn bản
biểu diễn ở dạng CDL (Ngôn ngữ biểu mẫu dữ liệu chung mạng) có thể được
đã xem, chỉnh sửa hoặc dùng làm đầu vào cho ncgen, một chương trình đồng hành có thể tạo một tệp nhị phân
tệp netCDF từ tệp CDL. Kể từ đây ncgen và ncdump có thể được sử dụng làm đảo ngược để biến đổi
biểu diễn dữ liệu giữa biểu diễn nhị phân và văn bản. Nhìn thấy ncgen tài liệu hướng dẫn
để có mô tả về các biểu diễn CDL và netCDF.

ncdump cũng có thể được sử dụng để xác định loại tệp netCDF nào được sử dụng (biến thể của
định dạng tệp netCDF) với tùy chọn -k.

Nếu hỗ trợ DAP được bật khi ncdump đã được tạo, tên tệp có thể chỉ định một URL DAP.
Điều này cho phép ncdump để truy cập các nguồn dữ liệu từ máy chủ DAP, bao gồm cả dữ liệu trong
định dạng hơn netCDF. Khi được sử dụng với các URL DAP, ncdump hiển thị bản dịch từ DAP
mô hình dữ liệu sang mô hình dữ liệu netCDF.

ncdump cũng có thể được sử dụng như một trình duyệt đơn giản cho các tệp dữ liệu netCDF, để hiển thị
tên kích thước và độ dài; tên, kiểu và hình dạng biến; tên thuộc tính và
các giá trị; và tùy chọn, các giá trị của dữ liệu cho tất cả các biến hoặc các biến đã chọn trong một
tệp netCDF. Đối với tệp netCDF-4, các nhóm và loại do người dùng xác định cũng được bao gồm trong
đầu ra ncdump.

ncdump sử dụng `_ 'để biểu thị các giá trị dữ liệu bằng thuộc tính` _FillValue' cho
một biến, nhằm đại diện cho dữ liệu chưa được ghi. Nếu một biến có
không có thuộc tính `_FillValue ', giá trị điền mặc định cho loại biến được sử dụng trừ khi
biến có kiểu byte.

ncdump xác định định dạng hiển thị mặc định được sử dụng cho từng loại dữ liệu netCDF, nhưng điều này có thể
đã thay đổi nếu thuộc tính `C_format 'được xác định cho biến netCDF. Trong trường hợp này, ncdump
sẽ sử dụng thuộc tính `C_format 'để định dạng từng giá trị. Ví dụ: nếu dấu phẩy động
dữ liệu cho biến netCDF `Z 'được biết là chỉ chính xác đến ba chữ số có nghĩa,
sẽ thích hợp nếu sử dụng thuộc tính biến

Z: C_format = "% .3g"

LỰA CHỌN

-c Hiển thị các giá trị của phối hợp biến (các biến 1D có cùng tên với
thứ nguyên) cũng như khai báo của tất cả các thứ nguyên, biến, thuộc tính
giá trị, nhóm và loại do người dùng xác định. Giá trị dữ liệu của các biến không tọa độ
không được bao gồm trong đầu ra. Đây thường là tùy chọn phù hợp nhất để sử dụng
để có cái nhìn ngắn gọn về cấu trúc và nội dung của tệp netCDF.

-h Chỉ hiển thị cú đội đầu thông tin trong đầu ra, nghĩa là, chỉ xuất
khai báo cho thứ nguyên, biến, thuộc tính, nhóm và do người dùng xác định
loại tệp đầu vào, nhưng không có giá trị dữ liệu cho bất kỳ biến nào. Đầu ra là
giống với việc sử dụng -c tùy chọn ngoại trừ rằng các giá trị của các biến tọa độ là
không bao gồm. (Nhiều nhất một trong số -c or -h các tùy chọn có thể có.)

-v var1, ...
Đầu ra sẽ bao gồm các giá trị dữ liệu cho các biến được chỉ định, ngoài ra
khai báo của tất cả các thứ nguyên, biến và thuộc tính. Một hoặc nhiều biến
phải được chỉ định theo tên trong danh sách được phân tách bằng dấu phẩy sau tùy chọn này. Các
danh sách phải là một đối số duy nhất cho lệnh, do đó không thể chứa
khoảng trống hoặc các ký tự khoảng trắng khác. Các biến được đặt tên phải là netCDF hợp lệ
các biến trong tệp đầu vào. Một biến trong một nhóm trong tệp netCDF-4 có thể là
được chỉ định bằng tên đường dẫn tuyệt đối, chẳng hạn như `/ GroupA / GroupA2 / var '. Sử dụng một
tên đường dẫn tương đối chẳng hạn như `var 'hoặc` grp / var' chỉ định tất cả các tên biến phù hợp
Trong tập tin. Mặc định, không có tùy chọn này và không có -c or -h
là bao gồm các giá trị dữ liệu cho tất cả các các biến trong đầu ra.

-b [c | f]
Chú thích ngắn gọn dưới dạng chú thích CDL (văn bản bắt đầu bằng các ký tự
`` // '') sẽ được đưa vào phần dữ liệu của đầu ra cho mỗi `hàng 'dữ liệu,
để giúp xác định các giá trị dữ liệu cho các biến đa chiều. Nếu như lang bắt đầu với
`C 'hoặc` c', thì các quy ước ngôn ngữ C sẽ được sử dụng (các chỉ số dựa trên XNUMX, cuối cùng
kích thước thay đổi nhanh nhất). Nếu như lang bắt đầu bằng `F 'hoặc` f', sau đó là ngôn ngữ Fortran
quy ước sẽ được sử dụng (chỉ số dựa trên một, thứ nguyên đầu tiên thay đổi nhanh nhất). Trong
cả hai trường hợp, dữ liệu sẽ được trình bày theo cùng một thứ tự; chỉ các chú thích
sẽ khác. Tùy chọn này có thể hữu ích để duyệt qua khối lượng lớn
dữ liệu đa chiều.

-f [c | f]
Chú thích đầy đủ dưới dạng chú thích CDL theo sau (văn bản bắt đầu bằng
ký tự `` // '') cho mọi giá trị dữ liệu (ngoại trừ các ký tự riêng lẻ trong ký tự
mảng) sẽ được đưa vào phần dữ liệu. Nếu như lang bắt đầu bằng `C 'hoặc` c', sau đó
Các quy ước ngôn ngữ C sẽ được sử dụng. Nếu như lang bắt đầu bằng `F 'hoặc` f', sau đó là Fortran
quy ước ngôn ngữ sẽ được sử dụng. Trong cả hai trường hợp, dữ liệu sẽ được trình bày trong
cùng một thứ tự; chỉ các chú thích sẽ khác nhau. Tùy chọn này có thể hữu ích cho
chuyển dữ liệu vào các bộ lọc khác, vì mỗi giá trị dữ liệu xuất hiện trên một dòng riêng biệt,
được xác định đầy đủ. (Có thể có nhiều nhất một trong các tùy chọn '-b' hoặc '-f'.)

-l chiều dài
Thay đổi độ dài dòng tối đa mặc định (80) được sử dụng trong định dạng danh sách không phải
giá trị dữ liệu ký tự.

-n tên
CDL yêu cầu tên cho tệp netCDF, để sử dụng bởi ncgen -b trong việc tạo ra một mặc định
tên tệp netCDF. Theo mặc định, ncdump xây dựng tên này từ thành phần cuối cùng
của tên tệp của tệp netCDF đầu vào bằng cách loại bỏ bất kỳ phần mở rộng nào mà nó có.
Sử dụng -n tùy chọn để chỉ định một tên khác. Mặc dù tên tệp đầu ra được sử dụng
by ncgen -b có thể được chỉ định, có thể là khôn ngoan khi có ncdump thay đổi tên mặc định
để tránh vô tình ghi đè lên tệp netCDF có giá trị khi sử dụng ncdump,
chỉnh sửa tệp CDL kết quả và sử dụng ncgen -b để tạo một tệp netCDF mới
từ tệp CDL đã chỉnh sửa.

-p float_digits [, double_digits]
Chỉ định độ chính xác mặc định (số chữ số có nghĩa) để sử dụng trong hiển thị
dấu phẩy động hoặc giá trị dữ liệu độ chính xác kép cho các thuộc tính và biến. Nếu như
đã chỉ định, giá trị này ghi đè giá trị của thuộc tính C_format, nếu có, cho một
Biến đổi. Dữ liệu dấu chấm động sẽ được hiển thị với float_digits có ý nghĩa
các chữ số. Nếu như double_digits cũng được chỉ định, các giá trị độ chính xác kép sẽ là
được hiển thị với nhiều chữ số có nghĩa. Trong trường hợp không có -p
thông số kỹ thuật, dữ liệu dấu phẩy động và độ chính xác kép được hiển thị với 7 và
15 chữ số có nghĩa tương ứng. Tệp CDL có thể được làm nhỏ hơn nếu ít hơn
độ chính xác là bắt buộc. Nếu cả hai dấu chấm động và phân vùng kép đều được chỉ định,
hai giá trị phải xuất hiện được phân tách bằng dấu phẩy (không có khoảng trống) như một đối số duy nhất cho
lệnh. (Để thể hiện từng bit chính xác cuối cùng trong tệp CDL cho tất cả
các giá trị dấu phẩy động có thể có sẽ yêu cầu -p 9,17.)

-k Hiển thị loại tệp netCDF tham chiếu tên đường dẫn, một trong những loại `` cổ điển '', `64-bit
offset ',' netCDF-4 'hoặc' netCDF-4 classic model '. Trước phiên bản 3.6, đã có
chỉ một loại tệp netCDF, được chỉ định là `` cổ điển '' (còn được gọi là biến thể định dạng
1). Hỗ trợ tệp lớn đã giới thiệu một biến thể khác của định dạng, được chỉ định là
`64-bit offset '(được gọi là biến thể định dạng 2). NetCDF-4, sử dụng biến thể thứ ba của
định dạng, `netCDF-4 '(biến thể định dạng 3). Một biến thể định dạng khác, được chỉ định
`netCDF-4 classic model '(định dạng biến thể 4), bị hạn chế đối với các tính năng được hỗ trợ bởi
mô hình dữ liệu netCDF-3 nhưng được biểu diễn bằng định dạng HDF5, do đó
chương trình netCDF-3 chưa sửa đổi có thể đọc hoặc ghi tệp chỉ bằng cách liên kết lại với
thư viện netCDF-4. Đầu ra chuỗi bằng cách sử dụng tùy chọn `-k 'có thể được cung cấp dưới dạng
giá trị của tùy chọn `-k 'thành ncgen(1) để chỉ định chính xác loại netCDF
tệp để tạo, khi bạn muốn ghi đè mặc định được suy ra từ CDL.

-s Xuất ra các thuộc tính ảo đặc biệt cung cấp thông tin liên quan đến hiệu suất
về định dạng tệp và các thuộc tính biến cho dữ liệu netCDF-4. Những đặc biệt
các thuộc tính ảo không thực sự là một phần của dữ liệu, chúng chỉ đơn thuần là một
cách hiển thị các thuộc tính khác của dữ liệu trong CDL (và cuối cùng là NcML).
Chúng bao gồm `_ChunkSizes ',` _DeflateLevel', `_Endianness ',` _Fletcher32',
`_Format ',` _NoFill', `_Shuffle 'và` _Storage'. `_ChunkSizes 'là một danh sách các đoạn
kích thước cho từng thứ nguyên của biến. `_DeflateLevel 'là một số nguyên từ 0
và 9 bao gồm nếu nén đã được chỉ định cho biến. `_Endianness '
là `` nhỏ '' hoặc `` lớn '', tùy thuộc vào cách biến được lưu trữ khi lần đầu tiên
bằng văn bản. `_Fletcher32 'là' true 'nếu thuộc tính tổng kiểm tra được đặt cho
Biến đổi. `_Format 'là thuộc tính toàn cục chỉ định biến thể định dạng netCDF,
một trong những kiểu `` cổ điển ', `` bù đắp 64-bit' ', `` netCDF-4' 'hoặc `` netCDF-4 kiểu cổ điển' '.
`_NoFill 'là đúng nếu thuộc tính NoFill liên tục được đặt cho biến khi
nó đã được định nghĩa. `_Shuffle 'là' true 'nếu việc sử dụng bộ lọc xáo trộn được chỉ định
cho biến. `_Storage 'là` `liền kề' 'hoặc` `phân khúc' ', tùy thuộc vào cách
dữ liệu của biến được lưu trữ.

-t Kiểm soát hiển thị dữ liệu thời gian, nếu được lưu trữ trong một biến sử dụng udunits
biểu diễn thời gian tuân thủ chẳng hạn như `ngày kể từ 1970-01-01 'hoặc` giây kể từ khi
2009-03-15 12:01:17 ', một biến được xác định trong thuộc tính "giới hạn" của thời gian như vậy
biến hoặc thuộc tính số của biến thời gian. Nếu tùy chọn này được chỉ định,
giá trị dữ liệu thời gian được hiển thị dưới dạng chuỗi ngày-giờ có thể đọc được của con người thay vì
giá trị số, được diễn giải theo thuộc tính biến `lịch ', nếu
được chỉ định. Đối với các thuộc tính số của biến thời gian, giá trị thời gian mà con người có thể đọc được
được hiển thị sau giá trị thực, trong một chú thích CDL được liên kết. Lịch
các giá trị thuộc tính được diễn giải bằng tùy chọn này bao gồm các giá trị Quy ước CF
`` gregorian 'hoặc `standard',` proleptic_gregorian ', `noleap' hoặc` 365_day ', `all_leap'
hoặc `366_day ',` 360_day' và `julian '.

-i Tương tự như tùy chọn '-t', ngoại trừ dữ liệu thời gian đầu ra dưới dạng chuỗi ngày giờ với ISO-8601
dấu phân tách 'T' tiêu chuẩn, thay vì dấu trống.

-g grp1, ...
Đối với các tệp netCDF-4, đầu ra sẽ chỉ bao gồm các giá trị dữ liệu cho các
các nhóm. Một hoặc nhiều nhóm phải được chỉ định theo tên trong danh sách được phân tách bằng dấu phẩy
theo tùy chọn này. Danh sách phải là một đối số duy nhất cho lệnh. Người được đặt tên
nhóm phải là nhóm netCDF hợp lệ trong tệp đầu vào. Một nhóm trong tệp netCDF-4
có thể được chỉ định bằng tên đường dẫn tuyệt đối hoặc tương đối. Sử dụng một đường dẫn tương đối
tên chỉ định tất cả các tên nhóm phù hợp trong tệp. Mặc định, không có cái này
tùy chọn và trong trường hợp không có -c or -h là bao gồm các giá trị dữ liệu cho
tất cả các các nhóm trong đầu ra.

-w Đối với tên tệp yêu cầu truy cập từ xa bằng URL DAP, hãy truy cập dữ liệu bằng ứng dụng khách-
bộ nhớ đệm bên của toàn bộ các biến.

-x Đầu ra XML (NcML) thay vì CDL. NcML không bao gồm các giá trị dữ liệu. NcML
tùy chọn đầu ra hiện chỉ hoạt động cho dữ liệu mô hình netCDF cổ điển.

VÍ DỤ

Nhìn vào cấu trúc của dữ liệu trong tệp netCDF 'foo.nc':

ncdump -c foo.nc

Tạo phiên bản CDL có chú thích của cấu trúc và dữ liệu trong tệp netCDF 'foo.nc',
sử dụng lập chỉ mục kiểu C cho các chú thích:

ncdump -bc foo.nc> foo.cdl

Chỉ xuất dữ liệu cho các biến 'uwind' và 'vwind' từ tệp netCDF 'foo.nc', và
hiển thị dữ liệu dấu phẩy động với độ chính xác chỉ có ba chữ số có nghĩa:

ncdump -v uwind, vwind -p 3 foo.nc

Tạo danh sách dữ liệu được chú thích đầy đủ (một giá trị dữ liệu trên mỗi dòng) cho biến
`omega ', sử dụng quy ước Fortran cho các chỉ số và thay đổi tên tập dữ liệu netCDF trong
tệp CDL kết quả thành `omega ':

ncdump -v omega -f fortran -n omega foo.nc> Z.cdl

Sử dụng ncdump trực tuyến bằng các dịch vụ onworks.net