Main Content

cdfwrite

(권장되지 않음) CDF(Common Data Format) 파일에 데이터 쓰기

cdfwrite는 권장되지 않습니다. cdflib 로우 레벨 함수를 대신 사용하십시오.

구문

cdfwrite(filename,variablelist)
cdfwrite(...,'PadValues',padvals)
cdfwrite(...,'GlobalAttributes',gattrib)
cdfwrite(...,'VariableAttributes',vattrib)
cdfwrite(...,'WriteMode',mode)
cdfwrite(...,'Format',format)

설명

cdfwrite(filename,variablelist)filename에 지정된 파일 이름으로 CDF(Common Data Format) 파일을 씁니다. filename을 문자형 벡터나 string형 스칼라로 지정합니다. variablelist 인수는 순서가 지정된 쌍으로 구성된 셀형 배열입니다. 각 쌍은 문자형 벡터나 string형 스칼라로 지정되는 CDF 변수 이름과 대응하는 CDF 변수 값으로 구성됩니다. 변수에 대한 여러 개의 레코드를 쓰려면 해당 값을 셀형 배열에 할당합니다. 여기서 셀형 배열의 각 요소는 레코드를 나타냅니다.

참고

cdfwrite은 임시 파일을 만들기 때문에 해당 파일에 대한 대상 디렉터리와 현재 작업 디렉터리는 모두 쓰기가 가능해야 합니다.

cdfwrite(...,'PadValues',padvals)는 지정된 변수 이름에 대한 채우기 값(Pad Value)을 씁니다. padvals는 순서가 지정된 쌍으로 구성된 셀형 배열입니다. 각 쌍은 문자형 벡터나 string형 스칼라로 지정되는 변수 이름과 대응하는 채우기 값으로 구성됩니다. 채우기 값(Pad Value)은 경계를 벗어난 레코드에 액세스할 때 변수와 연결된 디폴트 값입니다. padvals에 표시되는 변수 이름은 variablelist에 표시되어야 합니다.

cdfwrite(...,'GlobalAttributes',gattrib)는 CDF 파일에 대한 전역 메타데이터로 구조체 gattrib를 작성합니다. 구조체의 각 필드는 전역 특성의 이름입니다. 각 필드의 값은 특성 값을 포함합니다. 하나의 특성에 대해 여러 값을 쓰려면 해당 값을 셀형 배열에 할당합니다. 여기서 셀형 배열의 각 요소는 레코드를 나타냅니다.

참고

MATLAB® 애플리케이션에 유효하지 않은 전역 특성 이름을 지정하려면 특성 구조체에 'CDFAttributeRename'이라는 필드를 만듭니다. 이 필드의 값은 순서가 지정된 쌍으로 구성된 셀형 배열인 값이어야 합니다. 순서가 지정된 쌍은 GlobalAttributes 구조체에 나와 있는 원래 특성의 이름과 CDF 파일에 쓸 특성의 대응하는 이름으로 구성됩니다.

cdfwrite(...,'VariableAttributes',vattrib)는 CDF에 대한 변수 메타데이터로 구조체 vattrib를 작성합니다. 구조체의 각 필드는 변수 특성의 이름입니다. 각 필드의 값은 M×2 셀형 배열이어야 합니다. 여기서 M은 특성을 갖는 변수 개수입니다. 셀형 배열의 첫 번째 요소는 변수의 이름이어야 하며 두 번째 요소는 해당 변수의 특성 값이어야 합니다.

참고

MATLAB에 부적절한 변수 특성 이름을 지정하려면 특성 구조체에 'CDFAttributeRename'이라는 필드를 만듭니다. 이 필드의 값은 순서가 지정된 쌍으로 구성된 셀형 배열인 값이어야 합니다. 순서가 지정된 쌍은 VariableAttributes 구조체에 나와 있는 원래 특성의 이름과 CDF 파일에 쓸 특성의 대응하는 이름으로 구성됩니다. 이름을 바꿀 CDF 변수의 변수 특성을 지정하는 경우 VariableAttributes 구조체의 변수 이름이 이름을 바꾼 변수와 동일해야 합니다.

cdfwrite(...,'WriteMode',mode)는 CDF 파일이 이미 있는 경우 지정된 변수가 해당 파일에 추가되어야 하는지 여부를 나타냅니다. 여기서 mode'overwrite'이거나 'append'입니다. 기본적으로 cdfwrite는 기존 변수와 특성을 덮어씁니다.

cdfwrite(...,'Format',format)은 데이터가 다중 파일 CDF로 쓰였는지 여부를 나타냅니다. 여기서 format'multifile'이거나 'singlefile'입니다. 다중 파일 CDF에서 각 변수는 *.vN 이름을 가지며 개별적으로 저장됩니다. 여기서 N은 CDF에 쓰는 변수의 개수입니다. 기본적으로 cdfwrite는 단일 파일 CDF를 씁니다. 'WriteMode''Append'로 설정되면 'Format' 옵션이 무시되고 기존 CDF의 형식이 사용됩니다.

예제

[0:360]을 갖는 변수 'Longitude'를 포함하는 파일 'example.cdf'를 씁니다.

cdfwrite('example', {'Longitude', 0:360});

변수 'Longitude''Latitude'를 갖는 파일 'example.cdf'를 씁니다. 여기서 변수 'Latitude'는 범위를 벗어나 액세스되는 모든 레코드에 대해 채우기 값(Pad Value)으로 10을 갖습니다.

cdfwrite('example', {'Longitude', 0:360, 'Latitude', 10:20}, ...
         'PadValues', {'Latitude', 10});

값이 [0:360]인 변수 'Longitude'를 포함하고 'validmin'의 변수 특성 값이 10인 파일 'example.cdf'를 씁니다.

varAttribStruct.validmin = {'Longitude' [10]};
cdfwrite('example', {'Longitude' 0:360}, 'VariableAttributes', ...
         varAttribStruct);

제한 사항

  • CDF 파일은 ASCII 이외의 형식으로 인코딩된 입력값을 지원하지 않습니다. 변수 이름, 특성 이름, 변수 값, 특성 값은 7비트 ASCII로 인코딩되어야 합니다. ASCII 이외의 형식으로 인코딩된 입력값을 사용하려 하면 오류가 발생하거나 데이터의 문자가 손상됩니다.

버전 내역

R2006a 이전에 개발됨

참고 항목

|