h5disp

HDF5 파일의 내용 표시

페이지 내 모두 축소

구문

h5disp(filename)
h5disp(filename,loc)
h5disp(filename,loc,mode)
h5disp(___,'TextEncoding','UTF-8')

설명

h5disp(filename)은 지정된 HDF5 파일의 구조를 설명하는 메타데이터를 표시합니다.

예제

h5disp(filename,loc)는 파일 내 지정된 위치에 대한 메타데이터를 표시합니다.

예제

h5disp(filename,loc,mode)는 mode가 'min'인 경우 그룹과 데이터셋 이름만 표시합니다. mode의 디폴트 값은 'simple'입니다. 디폴트 값을 사용하면 데이터셋 메타데이터와 특성 값이 표시됩니다.

예제

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

예제

모두 축소

라이브 스크립트 열기

5×5의 청크 크기를 갖는 50×50 데이터셋을 만듭니다. 

h5create('exampleFile2.h5','/exampleDataset',[50,50],'ChunkSize',[5 5])

HDF5 파일의 메타데이터를 표시합니다. 이 예제에서 HDF5 파일은 루트 그룹 내에 하나의 데이터셋을 포함합니다. 데이터셋에 속하는 특성은 데이터셋 이름 아래에 표시됩니다.

h5disp('exampleFile2.h5')
HDF5 exampleFile2.h5 
Group '/' 
    Dataset 'exampleDataset' 
        Size:  50x50
        MaxSize:  50x50
        Datatype:   H5T_IEEE_F64LE (double)
        ChunkSize:  5x5
        Filters:  none
        FillValue:  0.000000
라이브 스크립트 열기

파일 example.h5에 있는 데이터셋 /g4/world의 특성을 표시합니다. HDF5 파일에 있는 데이터셋의 전체 경로를 지정할 경우, h5disp는 데이터셋의 특성만 표시합니다.

h5disp('example.h5','/g4/world')
HDF5 example.h5 
Dataset 'world' 
    Size:  36x19
    MaxSize:  36x19
    Datatype:   H5T_IEEE_F64LE (double)
    ChunkSize:  []
    Filters:  none
    FillValue:  0.000000
라이브 스크립트 열기

디스플레이 모드 'min'을 지정하여 그룹 이름과 데이터셋 이름만 표시합니다. 

h5disp('example.h5','/g4/world','min')
HDF5 example.h5 
Dataset 'world'

입력 인수

모두 축소

기존 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.h5와 family1.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가 그룹인 경우 h5disp는 해당 그룹의 모든 객체를 표시합니다.

디스플레이 모드로, 다음 값 중 하나로 지정됩니다.

  • 'simple' — 특성이 정수, 부동소수점 또는 string형 스칼라인 경우 데이터셋 이름과 특성 값을 표시합니다.

  • 'min' — 그룹 이름과 데이터셋 이름만 표시합니다.

제한 사항

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

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

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

버전 내역

R2011a에 개발됨

모두 확장

참고 항목

| | |

도움말 항목