h5readatt

HDF5 파일에서 특성 읽기

구문

attval = h5readatt(filename,loc,attr)

설명

attval = h5readatt(filename,loc,attr)은 HDF5 파일 내 지정된 위치에서 지정된 특성의 값을 가져옵니다.

예제

그룹 특성 읽기

HDF5 파일 example.h5의 루트 그룹에서 특성 attr2를 읽어옵니다.

val = h5readatt('example.h5','/','attr2')

val = 2×2 int32 matrix

   0   2
   1   3

데이터셋 특성 읽기

HDF5 파일 example.h5의 데이터셋 lon에서 특성 units를 읽어옵니다.

val = h5readatt('example.h5','/g4/lon','units')

val = 
'degrees_east'

입력 인수

filename — 파일 이름

string형 스칼라 | 문자형 벡터

기존 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 Storage wasb, 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"로 지정하십시오.

loc — 파일에서의 위치

문자형 벡터 | string형 스칼라

파일에서의 위치로, 특성이 속하는 기존 그룹 또는 데이터셋의 전체 경로를 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다. 파일의 루트 그룹에서 특성을 읽어오려면 위치를 '/'로 지정하십시오.

attr — 특성 이름

문자형 벡터 | string형 스칼라

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

제한 사항

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

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

• h5readatt 함수는 파일 무결성 검사에 실패한 특성과 데이터셋에 대해 오류를 발생시킵니다. 그러한 상황에서 특성을 읽어오려면 H5P.set_relax_file_integrity_checks 함수와 로우 레벨 HDF5 인터페이스를 사용하십시오. (R2024b 이후)

버전 내역

R2011a에 개발됨

R2024b: 파일 무결성 검사에 실패한 특성 및 데이터셋은 더 이상 지원되지 않음(R2024b 업데이트)

이제 h5readatt 함수는 파일 무결성 검사에 실패한 특성과 데이터셋에 대해 오류를 발생시킵니다. 이전에는 이 함수가 그러한 특성 또는 데이터셋에 대해 오류를 발생시키지 않았습니다. 그러한 상황에서 특성을 읽어오려면 H5P.set_relax_file_integrity_checks 함수와 로우 레벨 HDF5 인터페이스를 사용하십시오. 다음 표에서는 로우 레벨 HDF5 인터페이스를 사용하도록 코드를 업데이트하는 방법을 보여줍니다.

R2024a 이하	R2024b 이상
myAttrValue = h5readatt("myFilename.h5","myDatasetName","myAttrName");	fapl = H5P.create("H5P_FILE_ACCESS"); H5P.set_relax_file_integrity_checks(fapl,"H5F_RFIC_UNUSUAL_NUM_UNUSED_NUMERIC_BITS") fid = H5F.open("myFilename.h5","H5F_ACC_RDONLY",fapl); dset_id = H5D.open(fid,"myDatasetName"); attrID = H5A.open(dset_id,"myAttrName"); myAttrValue = H5A.read(attrID); H5A.close(attrID) H5D.close(dset_id) H5F.close(fid) H5P.close(fapl)

R2024b: HTTP와 HTTPS를 통해 HDF5 파일에서 특성 읽어오기

인터넷 URL과 함께 h5readatt 함수를 사용하여 주요 온라인 소스에 저장된 HDF5 파일의 특성을 읽어올 수 있습니다.

R2020b: 원격 위치에 있는 HDF5 파일에서 특성 읽어오기

Amazon S3, Windows Azure Blob Storage, HDFS와 같은 원격 위치에 있는 HDF5 파일에서 특성을 읽어올 수 있습니다.

R2020b: 유니코드 이름을 가진 HDF5 파일에서 특성 읽어오기

이름이 유니코드 문자로 인코딩된 HDF5 파일에서 특성을 읽어올 수 있습니다.

R2020a: 비 스칼라 문자열 특성을 MATLAB string형 배열로 읽어오기

h5readatt는 이제 HDF5 문자열 배열 특성을 문자형 벡터로 구성된 셀형 배열이 아니라 MATLAB string형 배열로 반환합니다. 단일 (스칼라) HDF5 문자열 특성은 MATLAB 문자형 벡터로 반환됩니다.

참고 항목

h5writeatt | h5info | h5disp

도움말 항목

• 하이 레벨 HDF5 함수를 사용하여 데이터 가져오기