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

CHƯƠNG TRÌNH:

TÊN

mincdump - Chuyển đổi tệp minc sang dạng ASCII (CDL)

SYNOPSIS

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

MÔ TẢ

băm nhỏ dựa trên công cụ netCDF ncdump, được sửa đổi để hoạt động với cả MINC 1 (netCDF)
và các tệp định dạng MINC 2 (HDF5). Nó được thiết kế để sử dụng chủ yếu với các tập lệnh như
mincdiff và thợ băm nhỏ. Vì nó không được tạo ra tại Viện Thần kinh Montreal
nó không tuân theo các quy ước thông thường cho các chương trình MINC.

băm nhỏ tạo biểu diễn ASCII của một tệp minc được chỉ định trên đầu ra tiêu chuẩn.
Biểu diễn ASCII ở 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. ncgen là một chương trình đồng hành
có thể tạo tệp minc nhị phân từ tệp CDL. Kể từ đây ncgen và băm nhỏ có thể được sử dụng như
đảo ngược để chuyển đổi biểu diễn dữ liệu giữa biểu diễn nhị phân và ASCII.
Xem ncgen để có mô tả về các biểu diễn CDL và netCDF.

băm nhỏ xác định một định dạng 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,
băm nhỏ sẽ sử dụng thuộc tính `C_format 'để định dạng từng giá trị. Ví dụ, nếu
dữ liệu dấu phẩy động 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"

băm nhỏ 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 và kích thước thứ nguyên; tên, kiểu và hình dạng biến; tên và giá trị thuộc tính;
và tùy chọn, các giá trị dữ liệu cho tất cả các biến hoặc các biến đã chọn trong netCDF
tập tin.

băm nhỏ 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 biểu thị dữ liệu chưa được ghi. Nếu một biến
không có thuộc tính `_FillValue ', giá trị điền mặc định cho loại biến được sử dụng nếu
biến không thuộc kiểu byte.

LỰA CHỌN

-c Hiển thị các giá trị của phối hợp biến (biến cũng là thứ nguyên) như
cũng như các khai báo của tất cả các thứ nguyên, biến và giá trị thuộc tính. Dữ liệu
giá trị của các biến không tọa độ không được đưa vào đầu ra. Đây là
tùy chọn phù hợp nhất để sử dụng cho 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, đó là khai báo của
thứ nguyên, biến và thuộc tính nhưng không có giá trị dữ liệu cho bất kỳ biến nào. Các
đầu ra 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 tọa độ
biến không được 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, ..., varn
Đầ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 được chứa khoảng trống hoặc các
ký tự khoảng trắng. Các biến được đặt tên phải là các biến netCDF hợp lệ trong
tập tin đầu vào. 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 lang
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 hữu ích để duyệt qua khối lượng lớn
dữ liệu đa chiều.

-f lang
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 (các chỉ số dựa trên XNUMX, thứ nguyên cuối cùng thay đổi
nhanh nhất). Nếu như lang bắt đầu bằng `F 'hoặc` f', sau đó các quy ước ngôn ngữ Fortran sẽ
được sử dụng (các 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 nhau. Cái này
tùy chọn có thể hữu ích cho việc 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 đủ.

-l len 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 dữ liệu netCDF, để sử dụng bởi ncgen -b trong việc tạo ra một
tên tệp netCDF mặc định. Theo mặc định, băm nhỏ xây dựng tên này từ tên cuối cùng
thành phần của tên đường dẫn 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
nó có. Sử dụng -n tùy chọn để chỉ định một tên khác. Mặc dù tệp đầu ra
tên được sử dụng bởi ncgen -b có thể được chỉ định, có thể là khôn ngoan khi có băm nhỏ 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
băm nhỏ, chỉnh sửa tệp CDL kết quả và sử dụng ncgen -b để tạo ra một cái mới
tệp netCDF 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 'cho bất kỳ
biến có thuộc tính như vậy. Dữ liệu dấu chấm động sẽ được hiển thị với
float_digits chữ số có nghĩa. Nếu như double_digits cũng được chỉ định, đôi-
giá trị độ chính xác sẽ được hiển thị với nhiều chữ số có nghĩa. bên trong
sự vắng mặt của bất kỳ -p thông số kỹ thuật, dữ liệu dấu phẩy động và độ chính xác kép là
hiển thị với 7 và 15 chữ số có nghĩa tương ứng. Tệp CDL có thể được tạo
nhỏ hơn nếu yêu cầu độ chính xác thấp hơn. Nếu cả dấu phẩy động và xác định kép
các ranh giới được chỉ định, hai giá trị phải xuất hiện cách nhau bằng dấu phẩy (không
khoảng trống) như một đối số duy nhất cho lệnh. Nếu bạn thực sự muốn từng chút một
độ chính xác từ tệp netCDF được thể hiện trong tệp CDL cho tất cả những gì có thể
giá trị dấu phẩy động, bạn sẽ phải chỉ định điều này với -p 9,17 (theo
Định lý 15 của bài báo được liệt kê trong TÀI LIỆU THAM KHẢO).

VÍ DỤ

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

mincdump -c foo.mnc

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.mnc',
sử dụng lập chỉ mục kiểu C cho các chú thích:

mincdump -bc foo.mnc> foo.cdl

Chỉ xuất dữ liệu cho các biến 'uwind' và 'vwind' từ tệp netCDF 'foo.mnc', 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:

mincdump -v uwind, vwind -p 3 foo.mnc

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 ':

mincdump -v omega -f fortran -n omega foo.mnc> Z.cdl

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