ncmpigen - 클라우드에서의 온라인

프로그램:

이름

ncmpigen - CDL 파일에서 netCDF 파일, C 프로그램 또는 Fortran 프로그램을 생성합니다.

개요

ncmpigen [-b] [-c] [-f] [-n] [-o netcdf_파일 이름] [-V 파일 형식] 입력 파일

기술

ncmpigen netCDF 파일을 생성하거나 netCDF를 생성하기 위해 C 또는 Fortran 소스 코드를 생성합니다.
파일. 에 대한 입력 ncmpigen 알려진 작은 언어로 된 netCDF 파일에 대한 설명입니다.
아래에 설명된 CDL(네트워크 공통 데이터 형식 언어)로 사용됩니다. 옵션이 지정되지 않은 경우
호출 중 ncmpigen, 단순히 입력 CDL 파일의 구문을 확인하여 오류를 생성합니다.
CDL 구문 위반에 대한 메시지. 다른 옵션을 사용하여 생성할 수 있습니다.
해당 netCDF 파일, netCDF C 인터페이스를 사용하는 C 프로그램 생성
netCDF 파일을 생성하거나 netCDF Fortran을 사용하는 Fortran 프로그램을 생성하려면
동일한 netCDF 파일을 생성하는 인터페이스.

ncmpigen 컴패니언 프로그램과 함께 사용할 수 있습니다. ncmpidump 간단한 작업을 수행하기 위해
netCDF 파일에 대한 작업. 예를 들어, netCDF 파일에서 차원의 이름을 바꾸려면 다음을 사용합니다.
ncmpidump netCDF 파일의 CDL 버전을 얻으려면 CDL 파일을 편집하여 이름을 변경하십시오.
치수 및 용도 ncmpigen 편집된 파일에서 해당 netCDF 파일을 생성하려면
CDL 파일.

옵션

-b (이진) netCDF 파일을 만듭니다. 만약 -o 옵션이 없으면 기본 파일 이름
netCDF 이름(뒤에 지정됨)에서 생성됩니다. netcdf 키워드
.nc' 확장자를 추가하여 입력). 파일이 이미 존재하는 경우
지정한 이름을 덮어씁니다.

-c 생성 C netCDF와 일치하는 netCDF 파일을 생성하는 소스 코드
사양. C 소스 코드는 표준 출력으로 작성됩니다.

-f 생성 포트란 netCDF와 일치하는 netCDF 파일을 생성하는 소스 코드
사양. Fortran 소스 코드는 표준 출력으로 작성됩니다.

-o netcdf_파일
생성된 바이너리 netCDF 파일의 이름입니다. 이 옵션이 지정되면 다음을 의미합니다.
"-b" 옵션입니다. (netCDF 파일을 쓸 수 없기 때문에 이 옵션이 필요합니다.
표준 출력을 찾을 수 없기 때문에 표준 출력에 직접 연결합니다.)

-n 처럼 -b 더 이상 사용되지 않는 `.cdf' 확장자로 netCDF 파일을 생성하는 것을 제외하고 옵션
에 의해 지정된 출력 파일 이름이 없는 경우 `.nc' 확장자 대신
전에, -o 옵션. 이 옵션은 이전 버전과의 호환성을 위해서만 지원됩니다.

-v 파일 형식
출력 netCDF 파일의 파일 형식입니다. file_format의 값은 다음과 같습니다: 1 또는
CDF-1 형식의 클래식입니다. 2 또는 64비트 오프셋은 CDF-2입니다. 5 또는 64비트 변수
CDF-5. 기본값(이 옵션이 지정되지 않은 경우)은 클래식 형식인 CDF-1입니다.

사용 예

CDL 파일의 구문 확인 `foo.cdl':

ncmpigen foo.cdl

CDL 파일에서 `foo.cdl', `라는 이름의 동등한 바이너리 netCDF 파일을 생성합니다.x.nc':

ncmpigen -o x.nc foo.cdl

CDL 파일에서 `foo.cdl', netCDF 함수를 포함하는 C 프로그램 생성
`라는 동등한 바이너리 netCDF 파일을 만드는 데 필요한 호출x.nc':

ncmpigen -c -o x.nc foo.cdl

사용법

CDL 통사론 요약
다음은 여러 명명된 차원이 있는 netCDF 파일을 설명하는 CDL 구문의 예입니다.
(위도, 경도 및 시간), 변수(Z, t, p, rh, 위도, 경도, 시간), 변수 속성(단위,
long_name, valid_range, _FillValue) 및 일부 데이터. CDL 키워드는 굵게 표시됩니다. (이것
예제는 구문을 설명하기 위한 것입니다. 실제 CDL 파일에는 더 완전한
데이터가 더 완벽하게 자체 설명될 수 있도록 속성 집합).

netcdf foo { // CDL의 netCDF 사양 예시

치수:
위도 = 10, 경도 = 5, 시간 = 무제한 ;

변수:
긴 위도(위도), 경도(경도), 시간(시간);
뜨다 Z(시간, 위도, 경도), t(시간, 위도, 경도);
더블 p(시간, 위도, 경도);
긴 rh(시간, 위도, 경도);

// 변수 속성
lat:long_name = "위도";
위도:단위 = "도북";
lon:long_name = "경도";
lon:units = "degrees_east";
time:units = "1992-1-1 00:00:00 이후 초";
Z:units = "지리전위 미터";
Z: 유효 범위 = 0., 5000.;
p:_FillValue = -9999.;
rh:_FillValue = -1;

데이터:
위도 = 0, 10, 20, 30, 40, 50, 60, 70, 80, 90;
론 = -140, -118, -96, -84, -52;
}

모든 CDL 문은 세미콜론으로 종료됩니다. 공백, 탭 및 줄 바꿈을 사용할 수 있습니다.
가독성을 위해 자유롭게. 주석은 '//' 문자 다음에 올 수 있습니다.

CDL 설명은 세 가지 선택적 부분으로 구성됩니다. 치수, 변수및 데이터,
키워드로 시작 치수:, 변수:및 데이터, 각각. 변수
일부는 다음을 포함할 수 있습니다. 변수 선언 및 속성 할당.

넷CDF 치수 하나 이상의 다차원의 모양을 정의하는 데 사용됩니다.
netCDF 파일에 포함된 변수. netCDF 차원에는 이름과 크기가 있습니다. ~에
netCDF 파일에서 대부분의 한 차원은 무제한 크기는 변수를 의미합니다.
이 차원을 사용하면 어떤 길이로든 늘어날 수 있습니다(예: 파일의 레코드 번호).

A 변수 같은 유형의 값으로 구성된 다차원 배열을 나타냅니다. 변수에는
차원 목록에서 설명하는 이름, 데이터 유형 및 모양. 각 변수는
또한 관련 속성 (아래 참조) 및 데이터 값. 이름, 데이터 유형,
변수의 모양은 선언에 의해 지정됩니다. 변수 CDL 섹션
설명. 변수는 차원과 이름이 같을 수 있습니다. 그러한 관습에 의해
변수는 XNUMX차원이며 이름을 지정하는 차원의 좌표를 포함합니다.
차원에는 해당 변수가 없어도 됩니다.

넷CDF 속성 netCDF 변수 또는 전체 netCDF에 대한 정보를 포함합니다.
데이터 세트. 속성은 단위, 특수 값, 최대값과 같은 속성을 지정하는 데 사용됩니다.
및 최소 유효 값, 스케일링 계수, 오프셋 및 매개변수. 속성 정보
단일 값 또는 값 배열로 표시됩니다. 예를 들어 "단위"는 속성입니다.
"celsius"와 같은 문자 배열로 표현됩니다. 속성에 연결된
변수, 이름, 데이터 유형, 길이 및 값. 다음과 같은 변수와 대조적으로
데이터용 속성은 메타데이터(데이터에 대한 데이터)용입니다.

CDL에서 속성은 ':'로 구분된 변수와 속성 이름으로 지정됩니다. 그것
할당 가능 글로벌 netCDF에 대한 변수와 연관되지 않은 속성
속성 이름 앞에 `:'를 사용하여 전체를 만듭니다. CDL에서 속성의 데이터 유형은 다음과 같습니다.
할당된 값의 유형에서 파생됩니다. 속성의 길이는
할당된 데이터 값의 수 또는 문자열의 문자 수
할당되었습니다. 문자가 아닌 속성에 여러 값을 구분하여 할당합니다.
쉼표가 있는 값. 속성에 할당된 모든 값은 동일한 유형이어야 합니다.

CDL 차원, 변수 및 속성의 이름은 알파벳으로 시작해야 합니다.
문자 또는 '_', 이후 문자는 영숫자 또는 '_' 또는 '-'일 수 있습니다.

선택적 데이터 CDL 사양의 섹션은 netCDF 변수가 있을 수 있는 곳입니다.
초기화. 초기화 구문은 간단합니다. 변수 이름, 등호,
및 쉼표로 구분된 상수 목록(공백, 탭 및 줄 바꿈으로 구분될 수 있음)
세미콜론으로 끝납니다. 다차원 배열의 경우 마지막 차원이 다릅니다.
가장 빠른. 따라서 행렬에는 열 순서가 아닌 행 순서가 사용됩니다. 값이 적을 경우
변수를 채우는 데 필요한 것보다 많이 제공되면 유형 종속으로 확장됩니다.
고유 변수에 대한 값을 제공하여 재정의할 수 있는 '값 채우기'
'_FillValue'라는 속성입니다. 상수 유형은 다음에 대해 선언된 유형과 일치할 필요가 없습니다.
변수; 예를 들어 정수를 부동 소수점으로 변환하기 위해 강제 변환이 수행됩니다. NS
상수 `_'는 변수에 대한 채우기 값을 지정하는 데 사용할 수 있습니다.

원시적 인 Data 유형
이륜 전차 문자
바이트 8 비트 데이터
짧은 16비트 부호 있는 정수
긴 32비트 부호 있는 정수
INT (동의어 긴)
뜨다 IEEE 단정밀도 부동 소수점(32비트)
현실 (동의어 뜨다)
더블 IEEE 배정밀도 부동 소수점(64비트)

추가된 데이터 유형을 제외하고 바이트 그리고 부족 부호, CDL은 동일하게 지원
기본 데이터 유형은 C와 같습니다. 기본 데이터 유형의 이름은 예약어입니다.
CDL이므로 변수, 차원 및 속성의 이름은 유형 이름이 아니어야 합니다. 에
선언에서 유형 이름은 대문자 또는 소문자로 지정할 수 있습니다.

바이트는 전체 XNUMX비트 데이터를 보유한다는 점에서 문자와 다릅니다.
XNUMX바이트는 문자 데이터와 마찬가지로 특별한 의미가 없습니다. ncmpigen
변환 바이트 선언 이륜 전차 출력 C 코드의 선언과
비표준 BYTE 출력 포트란 코드의 선언.

Shorts는 -32768에서 32767 사이의 값을 보유할 수 있습니다. ncmpigen 변환 짧은 선언
짧은 출력 C 코드 및 비표준 선언 정수*2 선언
포트란 코드를 출력합니다.

Long은 -2147483648에서 2147483647 사이의 값을 가질 수 있습니다. ncmpigen 변환 긴
선언 긴 출력 C 코드의 선언 및 정수 선언
포트란 코드를 출력합니다. INT 및 정수 의 동의어로 받아들여집니다. 긴 CDL에서
선언. 이제 C long에 대한 64비트 표현이 있는 플랫폼이 있으므로
사용하는 것이 더 나을 수 있습니다 INT 혼동을 피하기 위한 동의어.

부동 소수점은 약 -3.4+38에서 3.4+38 사이의 값을 보유할 수 있습니다. 그들의 외부 표현은
32비트 IEEE 정규화된 단정밀도 부동 소수점 숫자로. ncmpigen 변환
뜨다 선언 뜨다 출력 C 코드의 선언 및 레알 선언
포트란 코드를 출력합니다. 현실 의 동의어로 받아들여진다. 뜨다 CDL 선언에서.

Double은 약 -1.7+308에서 1.7+308 사이의 값을 보유할 수 있습니다. 그들의 외부 표현
64비트 IEEE 표준 정규화된 배정밀도 부동 소수점 숫자입니다. ncmpigen
변환 더블 선언 더블 출력 C 코드의 선언 및 더블
정도 출력 포트란 코드의 선언.

CDL 상수
속성이나 변수에 할당된 상수는 기본 netCDF 유형 중 하나일 수 있습니다.
상수 구문은 유형 접미사가 다음과 같아야 한다는 점을 제외하고는 C 구문과 유사합니다.
long 및 double과 구별하기 위해 short 및 float에 추가됩니다.

A 바이트 상수는 단일 문자 또는 여러 문자 이스케이프 시퀀스로 표시됩니다.
작은 따옴표로 묶습니다. 예를 들어,
'a' // ASCII 'a'
'\0' // XNUMX바이트
'\n' // ASCII 개행 문자
'\33' // ASCII 이스케이프 문자(33 XNUMX진수)
'\x2b' // ASCII 더하기(2b XNUMX진수)
'\377' // 377 255진수 = XNUMX 십진수, 비 ASCII

문자 상수는 큰따옴표로 묶습니다. 문자 배열을 나타낼 수 있습니다.
큰따옴표로 묶인 문자열로. 일반적인 C 문자열 이스케이프 규칙이 준수됩니다.
예를 들어
"a" // ASCII `a'
"Two\nlines\n" // 두 개의 개행 문자가 포함된 10자 문자열
"a bell:\007" // ASCII 벨을 포함하는 문자열
netCDF 문자 배열 "a"는 요소가 하나인 변수에 맞습니다.
종료 NULL 문자가 가정됩니다. 그러나 문자 배열의 XNUMX바이트는
에 의해 중요한 문자의 끝으로 해석됩니다. ncmpidump 프로그램, 다음
C 컨벤션. 따라서 문자열에 NULL 바이트를 삽입하면 안 됩니다.
끝에 있지 않는 한: 바이트 XNUMX을 포함하는 바이트 배열 대신 데이터 유형
바이트. NetCDF와 CDL에는 문자열 유형이 없고 고정 길이 문자 배열만 있습니다.
다차원적일 수 있습니다.

짧은 정수 상수는 16비트 부호 있는 수량을 나타내기 위한 것입니다. 양식
의 짧은 상수는 `s' 또는 `S'가 추가된 정수 상수입니다. 만약 짧은
상수는 '0'으로 시작하고, '0x'로 시작하는 경우를 제외하고는 XNUMX진수로 해석됩니다.
XNUMX진수 상수로 해석됩니다. 예를 들어:
-2s // 짧은 -2
0123s // XNUMX진수
0x7ffs //XNUMX진수

긴 정수 상수는 32비트 부호 있는 수량을 나타내기 위한 것입니다. 양식
의 긴 상수는 일반 정수 상수이지만 추가하는 것이 허용됩니다.
선택적 `l' 또는 `L'. 만약 긴 상수는 '0'으로 시작하며 XNUMX진수로 해석되며,
'0x'로 시작하는 경우를 제외하고는 XNUMX진 상수로 해석됩니다. 예
유효한 긴 상수에는 다음이 포함됩니다.
-2
1234567890L
0123 // XNUMX진수
0x7ff // XNUMX진수

유형의 부동 소수점 상수 뜨다 부동 소수점을 나타내는 데 적합합니다.
약 XNUMX개의 유효 자릿수 정밀도를 가진 데이터. 의 형태 뜨다 상수는
'f' 또는 'F'가 추가된 C 부동 소수점 상수와 동일합니다. 예를 들어
다음은 모두 허용됩니다. 뜨다 상수 :
-2.0 층
3.14159265358979f // 정밀도가 낮아 잘립니다.
1.f

유형의 부동 소수점 상수 더블 부동 소수점을 나타내는 데 적합합니다.
약 XNUMX개의 유효 자릿수 정밀도를 가진 데이터. 의 형태 더블 상수는
C 부동 소수점 상수와 동일합니다. 선택적 'd' 또는 'D'가 추가될 수 있습니다. 을위한
예 다음은 모두 허용됩니다. 더블 상수 :
-2.0
3.141592653589793
1.0-20
1.d

날짜

$날짜: 2014-04-16 13:38:34 -0500 (16년 2014월 XNUMX일 수요일) $

onworks.net 서비스를 사용하여 온라인으로 ncmpigen을 사용하세요.