주요 콘텐츠

h5info

HDF5 파일에 대한 정보

설명

info = h5info(filename)은 HDF5 파일에 포함된 그룹, 데이터셋 및 명명된 데이터형에 대한 정보를 포함하여 전체 HDF5 파일에 대한 정보를 반환합니다.

예제

info = h5info(filename,loc)는 HDF5 파일 내 지정된 위치에 대한 정보를 반환합니다.

예제

info = h5info(filename,loc,"TextEncoding","UTF-8")은 객체 이름과 특성 이름이 UTF-8로 인코딩된 텍스트로 처리되도록 강제합니다. 이 사용법은 HDF5 파일이 UTF-8 인코딩의 사용을 정확하게 지정할 경우 필요하지 않습니다.

예제

모두 축소

전체 파일 example.h5에 대한 정보를 반환합니다.

info = h5info("example.h5")
info = struct with fields:
      Filename: 'matlabroot/toolbox/matlab/demos/example.h5'
          Name: '/'
        Groups: [4x1 struct]
      Datasets: []
     Datatypes: []
         Links: []
    Attributes: [2x1 struct]

그룹 g4에 대한 정보를 반환합니다.

info = h5info("example.h5","/g4")
info = struct with fields:
      Filename: 'matlabroot/toolbox/matlab/demos/example.h5'
          Name: '/g4'
        Groups: []
      Datasets: [4x1 struct]
     Datatypes: []
         Links: []
    Attributes: []

Information About Specific Dataset

그룹 g4의 데이터셋 time에 대한 정보를 반환합니다.

info = h5info("example.h5","/g4/time")
info = struct with fields:
      Filename: matlabroot/toolbox/matlab/demos/example.h5'
          Name: 'time'
      Datatype: [1x1 struct]
     Dataspace: [1x1 struct]
     ChunkSize: 10
     FillValue: 0
       Filters: []
    Attributes: [2x1 struct]

입력 인수

모두 축소

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

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

위치

형식

현재 폴더 또는 MATLAB® 경로의 폴더

파일이 현재 폴더 또는 MATLAB 경로의 폴더에 있는 경우, filename에 파일 이름을 지정하십시오.

예: "myFile.h5"

다른 폴더

파일이 현재 폴더나 MATLAB 경로의 폴더에 모두 없는 경우, filename에 전체 경로 또는 상대 경로를 지정하십시오.

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

예: "myFolder\myFile.h5"

URL(Uniform resource locator) (R2024b 이후)

파일의 위치가 인터넷 URL인 경우, filename은 프로토콜 유형(예: http://)을 포함해야 합니다. 자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오.

예: "http://my_hostname/my_path/my_file.h5"

원격 위치

파일이 원격 위치에 저장된 경우, filename은 다음 형식과 같이 URL(Uniform Resource Locator)로 지정된 파일의 전체 경로를 포함해야 합니다.

scheme_name://path_to_file/filename

원격 위치에 따라 scheme_name은 다음 표에 있는 값 중 하나가 될 수 있습니다.

원격 위치scheme_name
Amazon S3™s3
Windows Azure® Blob Storagewasb, wasbs
HDFS™hdfs

자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오.

예: "s3://myBucket/myFolder/myFile.h5"

  • 파일이 Family 드라이버를 사용하는 여러 개의 물리적 파일로 구성된 경우, 형식 지정자를 사용하여 filename을 지정하십시오. 그러한 물리적 파일이 현재 폴더에 없는 경우 전체 경로나 상대 경로를 사용하여 파일을 지정합니다. 예를 들어, 현재 폴더에서 두 파일 family0.h5family1.h5에 Family 드라이버를 사용하려면 filename"family%d.h5"로 지정하십시오.

  • 파일이 Multi 드라이버 또는 Split 드라이버를 사용하는 여러 개의 물리적 파일로 구성된 경우, filename을 물리적 파일 이름의 선행 접두사로 지정하십시오. 그러한 물리적 파일이 현재 폴더에 없는 경우 전체 경로나 상대 경로를 사용하여 파일을 지정합니다. 예를 들어, 현재 폴더에서 6개 파일 multi-b.h5, multi-g.h5, multi-l.h5, multi-o.h5, multi-r.h5, multi-s.h5에 Multi 드라이버를 사용하려면 filename"multi"로 지정하십시오.

파일에서의 위치로, 파일에 있는 그룹, 데이터셋 또는 명명된 데이터형의 파일 경로를 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다. 전체 파일에 대한 정보를 반환하려면 위치를 '/'로 지정하십시오.

출력 인수

모두 축소

파일 정보로, 구조체로 반환됩니다. 구조체는 loc 인수가 파일 또는 그룹, 데이터셋, 명명된 데이터형 중 어느 것을 가리키는지에 따라 서로 다른 필드를 갖습니다. 다음 표에는 각 위치 유형에 대해 구조체가 갖는 필드가 나와 있습니다.

파일과 그룹

필드설명
Name그룹 또는 데이터셋의 이름을 지정하는 문자형 벡터입니다. HDF5 파일 이름만 지정할 경우 함수는 루트 그룹에 대한 정보를 반환합니다.
Groups하위 그룹을 설명하는 구조체로 구성된 배열입니다.
Datasets데이터셋을 설명하는 구조체로 구성된 배열입니다.
Datatypes명명된 데이터형을 설명하는 구조체로 구성된 배열입니다.
Links소프트, 외부, 사용자 정의 및 특정 하드 링크를 설명하는 구조체로 구성된 배열입니다.
Attributes 그룹 특성을 설명하는 구조체로 구성된 배열입니다.

데이터셋

필드설명
Name데이터셋의 이름을 지정하는 문자형 벡터입니다.
Datatype데이터형을 설명하는 구조체입니다.
Dataspace데이터셋의 크기를 설명하는 구조체입니다.
ChunkSize데이터셋 청크 크기의 차원(정의된 경우)입니다.
FillValue누락된 데이터에 대한 채우기 값(정의된 경우)입니다.
Filter압축과 같은 정의된 필터를 설명하는 구조체로 구성된 배열입니다.
Attributes데이터셋 특성을 설명하는 구조체로 구성된 배열입니다.

명명된 데이터형

필드설명
Name데이터형 객체의 이름을 지정하는 문자형 벡터입니다.
Class 명명된 데이터형의 HDF5 클래스입니다.
Type데이터형을 추가적으로 설명하는 문자형 벡터 또는 구조체입니다.
Size명명된 데이터형의 크기(단위: 바이트)입니다.

제한 사항

  • MATLAB은 인증을 요하는 인터넷 URL을 지원하지 않습니다.

  • MATLAB Online™은 Microsoft® OneDrive™ 파일 및 폴더와 연결된 인터넷 URL을 지원합니다. 반면 설치된 MATLAB에서는 로컬 OneDrive 파일만 지원합니다.

  • h5info 함수 출력값에는 파일 무결성 검사에 실패한 데이터셋과 특성에 대한 정보가 생략됩니다. (R2024b 이후)

버전 내역

R2011a에 개발됨

모두 확장