Main Content

netcdf.open

netCDF 데이터 소스 열기

페이지 내 모두 축소

구문

ncid = netcdf.open(source)
ncid = netcdf.open(source,mode)
[actualChunksize,ncid] = netcdf.open(source,mode,chunksize)

설명

예제

ncid = netcdf.open(source)는 읽기 전용 액세스를 위해 source를 열고 netCDF 식별자를 ncid에 반환합니다. 지정된 source는 netCDF 파일의 이름, OPeNDAP netCDF 데이터 소스의 URL 또는 (바이트 범위 읽기를 위한 #mode=bytes 접미사를 갖는) 원격 netCDF 파일의 HTTP URL입니다.

예제

ncid = netcdf.open(source,mode)는 mode로 지정된 액세스 유형으로 source를 엽니다. 모드 값은 'WRITE', 'SHARE' 또는 'NOWRITE'입니다.

[actualChunksize,ncid] = netcdf.open(source,mode,chunksize)는 지정된 chunksize로 기존 netCDF 데이터 소스를 엽니다. chunksize 파라미터를 사용하면 I/O 성능을 조정할 수 있습니다.

예제

모두 축소

라이브 스크립트 열기

샘플 NetCDF 파일 example.nc를 읽기 전용 액세스로 열고 변수를 읽어 들인 다음 파일을 닫습니다. netcdf.open 함수는 파일 ID를 반환합니다.

ncid = netcdf.open('example.nc')
ncid = 65536

netcdf.getVar 함수를 사용하여 예제 파일에서 변수 avagadros_number와 연관된 데이터를 읽어옵니다. netcdf.getVar에 대한 두 번째 입력값은 변수를 식별하는 변수 ID로, 0부터 시작하는 인덱스입니다. avagadros_number 변수의 인덱스 값은 0입니다.

A_number = netcdf.getVar(ncid,0)
A_number = 6.0221e+23

NetCDF 파일을 닫습니다.

netcdf.close(ncid)
라이브 스크립트 열기

NetCDF 파일을 열고 변수에 값을 할당한 다음 그 값을 표시합니다.

변수 pi를 포함하는 NetCDF 파일 myexample.nc를 만듭니다.

nccreate('myexample.nc','pi')

쓰기를 위해 파일을 열고 변수 pi에 값 3.1416을 씁니다.

ncid = netcdf.open('myexample.nc','WRITE')
ncid = 65536

varInd = 0; % index of the first variable in the file
varValue = 3.1416; 
netcdf.putVar(ncid,varInd,varValue);

파일에서 변수 pi의 값을 읽어 들여 표시합니다. 

netcdf.getVar(ncid,varInd)
ans = 3.1416

파일을 닫습니다.

netcdf.close(ncid);

입력 인수

모두 축소

netCDF 데이터 소스 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. source 인수는 다음 값 중 하나일 수 있습니다.

  • 로컬 netCDF 소스의 경로

  • 원격 OPeNDAP netCDF 데이터 소스의 OPeNDAP URL

  • 원격 netCDF 소스의 HTTP URL로, 바이트 범위 읽기를 활성화하기 위해 URL 끝에 #mode=bytes가 추가됨

    참고

    바이트 범위 읽기는 다른 소스에서 읽는 것보다 속도가 느립니다. 바이트 범위 읽기에 대한 자세한 내용은 netCDF 문서를 참조하십시오.

예: "myNetCDFfile.nc"

예: "http://host_name/netcdf_filename#mode=bytes"

액세스 유형으로, 문자형 벡터나 string형 스칼라 또는 숫자형 값으로 지정됩니다. mode 입력값은 다음 값 중 하나일 수 있습니다.

값 설명
'WRITE'읽기-쓰기 액세스
'SHARE'동기식 파일 업데이트
'NOWRITE'읽기 전용 액세스

mode를 숫자형 값으로 지정할 수도 있습니다. netcdf.getConstant를 사용하여 mode의 숫자형 값을 가져옵니다. 예를 들어, netcdf.getConstant('WRITE')는 mode의 숫자형 값을 반환합니다. 여러 모드의 비트별 OR을 지정하려는 경우 이러한 숫자형 값을 사용하십시오.

데이터형: char | string | double

성능 조정을 위한 청크 크기 파라미터로, 정수로 지정됩니다.

chunksize 파라미터는 netcdf.open 함수가 netCDF 라이브러리에 할당하는 메모리(공간)와 시스템 호출 횟수(시간) 사이를 절충하는 데 사용됩니다. 내부 요구 사항으로 인해, netcdf.open 함수가 사용하는 청크 크기의 실제 값이 지정한 입력값과 다를 수 있습니다. 함수가 사용하는 실제 값을 알아보려면 actualChunksize 인수를 확인하십시오.

예: 1024

예: 8192

데이터형: double

출력 인수

모두 축소

열린 netCDF 파일 또는 OPeNDAP netCDF 데이터 소스의 파일 ID로, 정수로 반환됩니다.

데이터형: double

netcdf.open 함수가 사용하는 실제 청크 크기로, 정수로 반환됩니다.

데이터형: double

제한 사항

  • 바이트 범위 읽기는 다른 소스에서 읽는 것보다 속도가 느립니다.

알고리즘

이 함수는 netCDF 라이브러리 C API의 nc_open 및 nc__open 함수에 대응합니다. 이 함수를 사용하려면 netCDF 프로그래밍 패러다임을 잘 알고 있어야 합니다.

버전 내역

R2011a에 개발됨

모두 확장

참고 항목

|