hdf5read

(권장되지 않음) HDF5 파일 읽어 들이기

페이지 내 모두 축소

hdf5read는 권장되지 않습니다. h5read를 대신 사용하십시오.

구문

data = hdf5read(filename,ds)
attr = hdf5read(filename,attrname)
data = hdf5read(info)
[data,attr] = hdf5read(___,Name,Value)

설명

data = hdf5read(filename,ds)는 HDF5 파일 filename에 포함된 데이터셋 ds로부터 모든 데이터를 읽어 들입니다.

attr = hdf5read(filename,attrname)은 HDF5 파일 filename에 포함된 특성 attrname의 모든 메타데이터를 읽어 들입니다.

data = hdf5read(info)는 구조체 info에 지정된 데이터셋의 모든 데이터를 읽어 들입니다. info 구조체는 hdf5info에 의해 반환된 출력값입니다.

[data,attr] = hdf5read(___,Name,Value)는 위에 열거된 구문의 입력 인수 외에 선택적 이름-값 인수를 지정합니다.

입력 인수

모두 축소

파일 이름으로, 기존 HDF5 파일의 이름을 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.

파일의 위치에 따라 filename은 다음 형식 중 하나가 될 수 있습니다.

위치

형식

현재 폴더

filename에 파일의 이름을 지정합니다.

예: 'myFile.h5'

다른 폴더

파일이 현재 폴더나 MATLAB® 경로의 폴더에 없는 경우, filename에 전체 경로 또는 상대 경로 이름을 지정합니다.

예: 'C:\myFolder\myFile.h5'

예: 'myFolder\myFile.h5'

데이터셋 이름으로, HDF5 파일에 있는 데이터셋의 전체 경로 이름을 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.

특성 이름으로, 그룹 또는 데이터셋에 속하는 특성의 전체 경로 이름을 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.

입력 데이터로, 구조체형 배열로 지정됩니다. info 구조체는 hdf5info 함수에 의해 반환된 출력값입니다.

이름-값 인수

모두 축소

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: 'ReadAttributes',true는 해당 데이터셋에 포함된 모든 관련 특성 정보를 읽어 들입니다.

특성을 읽을지 여부를 나타내는 표시자로, 'ReadAttributes'와 함께 true 또는 false가 쉼표로 구분되어 지정됩니다.

true를 지정하면 hdf5read는 해당 데이터셋에 포함된 모든 관련 특성 정보를 읽어 들입니다. 'ReadAttributes'의 디폴트 값은 false입니다. 이 값은 HDF5 파일에서 데이터를 읽어 들일 때 특성 정보를 생략합니다.

MATLAB 7.1 이하 릴리스와의 호환성으로, 'V71Dimensions'와 함께 true 또는 false가 쉼표로 구분되어 지정됩니다. true를 지정할 경우, hdf5read는 데이터셋의 처음 두 차원을 교환하여 출력 데이터셋의 차원 순서를 hdf5read의 이전 버전(MATLAB 7.1 [R14SP3] 이하)과 일치하도록 만듭니다. 이 동작은 HDF5와 MATLAB이 배열의 차원을 표현하는 방법의 차이를 고려하도록 의도되었습니다.

'V71Dimensions'의 디폴트 값은 false입니다. 이 값은 출력 데이터 차원의 순서를 변경하지 않습니다.

HDF5는 행 우선(Row-major) 순서로 데이터셋의 차원을 설명하는 반면, MATLAB은 데이터를 열 우선(Column-major) 순서로 저장합니다. 하지만 이러한 차원의 치환은 데이터의 의도를 올바르게 반영하지 않을 수 있으며, 메타데이터를 무효화할 수 있습니다. 'V71Dimensions'를 false로 지정할 경우 데이터 차원은 파일에 기록된 데이터 순서를 올바르게 반영합니다. 즉, 출력 변수의 각 차원이 파일의 같은 차원과 일치합니다.

예: 'V71Dimensions',true

출력 인수

모두 축소

출력 데이터로, hdf5read에 의해 다차원 배열로 반환됩니다.

예제

모두 축소

hdf5info를 사용하여 HDF5 파일에 대한 정보를 가져온 다음 hdf5read를 사용하여 데이터셋을 읽어 들입니다. 이때 데이터셋을 지정하기 위해 hdf5info가 반환한 정보 구조체(hinfo)를 사용합니다.

hinfo = hdf5info('example.h5');
dset = hdf5read(hinfo.GroupHierarchy.Groups(2).Datasets(1));

팁

  • hdf5read는 숫자형 데이터셋을 읽을 때 가장 성능이 좋습니다. 문자열, 복합형(Compound) 또는 가변 길이 데이터셋을 읽어 들어야 할 경우 로우 레벨 HDF5 인터페이스 함수 H5D.read를 사용하는 것이 강력히 권장됩니다. 데이터셋의 서브셋을 읽어 들이려면 h5read 함수 또는 MATLAB HDF5 로우 레벨 인터페이스를 사용하십시오.

  • hdf5read는 가능하면 언제나 HDF5 데이터형을 네이티브 MATLAB 데이터형으로 매핑합니다. MATLAB 데이터형을 사용하여 데이터를 표현할 수 없는 경우 hdf5read는 HDF5 데이터형 객체 중 하나를 사용합니다. 예를 들어, HDF5 파일이 열거형 데이터형으로 구성된 데이터셋을 포함할 경우 hdf5read는 MATLAB 작업 공간 내의 데이터를 표현하기 위해 hdf5.h5enum 객체를 사용합니다. hdf5.h5enum 객체는 열거형(이름), 대응하는 값, 열거형 데이터를 저장하는 데이터 멤버를 가지고 있습니다.

버전 내역

R2006a 이전에 개발됨

참고 항목

| |