Main Content

cdflib.createVar

새 변수 생성

구문

varnum = cdflib.createVar(cdfId, varname, datatype, numElements, dims, recVariance, dimVariance)

설명

varnum = cdflib.createVar(cdfId, varname, datatype, numElements, dims, recVariance, dimVariance)는 지정된 특성을 가진 새 변수를 CDF(Common Data Format) 파일에 만듭니다.

입력 인수

cdfId

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

varname

변수에 할당할 이름을 지정하는 문자형 벡터나 string형 스칼라입니다.

datatype

변수의 데이터형으로, 유효한 CDF 데이터형을 포함하는 다음 문자형 벡터나 string형 스칼라 중 하나 또는 그에 상응하는 숫자로 지정됩니다.

CDF 데이터형설명
'CDF_BYTE1바이트. 부호가 있는 정수
'CDF_CHAR'

1바이트. MATLAB® char 클래스 또는 string 클래스에 매핑되는 부호가 있는 문자 데이터형

'CDF_INT1'1바이트. 부호가 있는 정수
'CDF_UCHAR'

1바이트. MATLAB uint8 클래스에 매핑되는 부호가 없는 문자 데이터형

'CDF_UINT1'1바이트. 부호가 없는 정수
'CDF_INT2'2바이트. 부호가 있는 정수
'CDF_UINT2'2바이트. 부호가 없는 정수
'CDF_INT4'4바이트. 부호가 있는 정수
'CDF_UINT4'4바이트. 부호가 없는 정수
'CDF_FLOAT'4바이트. 부동소수점
'CDF_REAL4'4바이트. 부동소수점
'CDF_REAL8'8바이트. 부동소수점
'CDF_DOUBLE'8바이트. 부동소수점
'CDF_EPOCH'8바이트. 부동소수점
'CDF_EPOCH16'8바이트 2개. 부동소수점

numElements

데이터당 요소 개수입니다. 'CDF_CHAR''CDF_UCHAR'를 제외한 모든 데이터형에 대한 값은 1이어야 합니다.

dims

차원 범위의 벡터입니다. 차원 범위가 없는 경우 비어 있습니다.

recVariance

레코드 가변성을 지정합니다. true 또는 false로 설정됩니다.

dimVariance

논리형 벡터입니다. 차원이 없는 경우 비어 있습니다.

출력 인수

varNum

변수에 대한 숫자형 식별자입니다. 변수 번호는 0부터 시작합니다.

예제

CDF 파일을 만든 다음 해당 CDF에서 'Time'이라는 변수를 만듭니다. 해당 변수는 차원이 없고 레코드에 따라 다릅니다. 이 예제를 실행하려면 폴더 쓰기가 가능해야 합니다.

cdfId = cdflib.create("your_file.cdf");

% Initially the file contains no variables
info = cdflib.inquire(cdfId)
info = 

  struct with fields:

     encoding: 'IBMPC_ENCODING'
     majority: 'ROW_MAJOR'
       maxRec: -1
      numVars: 0
    numvAttrs: 0
    numgAttrs: 0
% Create a variable in the file
varNum = cdflib.createVar(cdfId,"Time","cdf_int1",1,[],true,[]);

% Retrieve info about the file again to verify variable was created
% Note value of numVars field is now 1
info = cdflib.inquire(cdfId)
info = 

  struct with fields:

     encoding: 'IBMPC_ENCODING'
     majority: 'ROW_MAJOR'
       maxRec: -1
      numVars: 1
    numvAttrs: 0
    numgAttrs: 0
% Clean up
cdflib.delete(cdfId)
clear cdfId

참고 문헌

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

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