h5info

HDF5 파일에 대한 정보

페이지 내 모두 축소

구문

info = h5info(filename)

info = h5info(filename,loc)

info = h5info(filename,loc,'TextEncoding','UTF-8')

설명

예제

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

예제

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

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

예제

모두 축소

전체 HDF5 파일에 대한 정보

라이브 스크립트 열기

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

info = h5info('example.h5')

info = struct with fields:
      Filename: '/mathworks/devel/bat/Bdoc23b/build/matlab/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: '/mathworks/devel/bat/Bdoc23b/build/matlab/toolbox/matlab/demos/example.h5'
          Name: '/g4'
        Groups: []
      Datasets: [4x1 struct]
     Datatypes: []
         Links: []
    Attributes: []

특정 데이터셋에 대한 정보

라이브 스크립트 열기

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

info = h5info('example.h5','/g4/time')

info = struct with fields:
      Filename: '/mathworks/devel/bat/Bdoc23b/build/matlab/toolbox/matlab/demos/example.h5'
          Name: 'time'
      Datatype: [1x1 struct]
     Dataspace: [1x1 struct]
     ChunkSize: 10
     FillValue: 0
       Filters: []
    Attributes: [2x1 struct]

입력 인수

모두 축소

`filename` — 파일 이름
문자형 벡터 | string형 스칼라

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

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

위치

형식

현재 폴더

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

예: 'myFile.h5'

다른 폴더

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

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

예: 'myFolder\myFile.h5'

원격 위치

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

scheme_name://path_to_file/my_file.ext

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

원격 위치	`scheme_name`
Amazon S3™	`s3`
Windows Azure^® Blob Storage	`wasb`, `wasbs`
HDFS™	`hdfs`

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

예: 's3://bucketname/path_to_file/myFile.h5'

`loc` — 파일에서의 위치
문자형 벡터 | string형 스칼라

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

출력 인수

모두 축소

`info` — 파일 정보
구조체

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

파일과 그룹

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

데이터셋

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

명명된 데이터형

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