Main Content

cdflib.getVarData

변수 레코드의 단일 값

구문

datum = cdflib.getVarData(cdfId,varNum,recNum,indices)
datum = cdflib.getVarData(cdfId,varNum,recNum)

설명

datum = cdflib.getVarData(cdfId,varNum,recNum,indices)는 CDF(Common Data Format) 파일의 변수에서 단일 값을 반환합니다.

datum = cdflib.getVarData(cdfId,varNum,recNum)은 CDF(Common Data Format) 파일의 차원이 없는 변수에서 단일 값을 반환합니다.

입력 인수

cdfId

CDF 파일 ID로, cdflib.create 또는 cdflib.open 호출에서 반환됩니다.

varNum

데이터를 포함하는 변수를 식별하는 숫자형 값입니다. 변수 번호는 0부터 시작합니다.

recNum

변수에서 데이터의 위치를 식별하는 숫자형 값입니다. CDF 용어로 이를 Record Number(레코드 번호)라고 합니다. 레코드 번호는 0부터 시작합니다.

indices

레코드 내에 있는 차원 인덱스로 구성된 배열입니다. 차원 인덱스는 0부터 시작합니다. 변수에 차원이 없는 경우 이 파라미터를 생략할 수 있습니다.

출력 인수

datum

지정된 레코드의 값입니다.

예제

예제 CDF 파일을 열고 변수에 대한 데이터를 가져옵니다.

cdfId = cdflib.open("example.cdf");

% Determine how many variables are in the file
info = cdflib.inquire(cdfId);
numVars = info.numVars
numVars =

     6
% Determine if the first variable has dimensions
varnum = 0;
varinfo = cdflib.inquireVar(cdfId,varnum);
vardims = varinfo.dims
vardims =

     []
% Get first data record from variable, without specifying dimensions
recnum = 0;
datum = cdflib.getVarData(cdfId,varnum,recnum)
datum =

   6.3146e+13
% Get dimensions of another variable in file
varnum = 3;
varinfo = cdflib.inquireVar(cdfId,varnum);
vardims = varinfo.dims
vardims =

     4     2     2
% Retrieve the first datum in the record (indices are zero-based)
datum = cdflib.getVarData(cdfId,varnum,recnum,[0 0 0])
datum =

    30
% Clean up
cdflib.close(cdfId)
clear cdfId

참고 문헌

이 함수는 CDF 라이브러리 C API 루틴 CDFgetzVarData에 대응합니다.

이 함수를 사용하려면 CDF C 인터페이스를 잘 알고 있어야 합니다. CDF 웹사이트에서 CDF 문서에 액세스할 수 있습니다.

버전 내역

모두 확장