h5writeatt

HDF5 파일에 특성 쓰기

페이지 내 모두 축소

구문

h5writeatt(filename,loc,attr,val)
h5writeatt(filename,loc,attr,val,'TextEncoding',encoding)

설명

h5writeatt(filename,loc,attr,val)은 HDF5 파일 내 지정된 위치에 이름이 attr인 특성과 값 val을 씁니다.

예제

h5writeatt(filename,loc,attr,val,'TextEncoding',encoding)은 지정된 인코딩을 사용하여 HDF5 파일 내 지정된 위치에 attr을 씁니다. 'UTF-8'은 'TextEncoding'의 디폴트 설정이며, 'system'은 시스템 인코딩을 사용하여 문자를 표현합니다. 일반적으로 'system'을 인코딩으로 지정하는 것은 필요하지 않습니다.

예제

모두 축소

라이브 스크립트 열기

examplefile.h5의 루트 그룹에 값이 현재 시간인 특성을 씁니다.

date = datestr(now);
h5writeatt('examplefile.h5','/','creation_date', date);

HDF5 파일의 루트 그룹에서 특성을 읽어옵니다.

val1 = h5readatt('examplefile.h5','/','creation_date')
val1 = 
'24-Jan-2026 19:49:23'
라이브 스크립트 열기

double형 배열을 만들어서 데이터셋 /g4/world에 씁니다.

attData = [0 1 2 3];
h5writeatt('examplefile.h5','/g4/world','val2',attData);

데이터셋 메타데이터를 표시합니다. 특성 val2는 데이터셋에 속하는 특성 중 하나로 표시됩니다.

h5disp('examplefile.h5','/g4/world');
HDF5 examplefile.h5 
Dataset 'world' 
    Size:  36x19
    MaxSize:  36x19
    Datatype:   H5T_IEEE_F64LE (double)
    ChunkSize:  []
    Filters:  none
    FillValue:  0.000000
    Attributes:
        'val2':  0.000000 1.000000 2.000000 3.000000

입력 인수

모두 축소

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

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

위치

형식

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

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

예: "myFile.h5"

다른 폴더

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

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

예: "myFolder\myFile.h5"

원격 위치

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

scheme_name://path_to_file/filename

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

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

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

예: "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형 스칼라로 지정됩니다.

특성의 이름으로, 그룹 또는 데이터셋에 속하는 특성의 이름을 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다. 속성이 존재하지 않는 경우 h5writeatt는 지정된 이름을 가진 특성을 생성합니다.

지정된 특성이 이미 존재하지만 val과 일치하는 데이터형 또는 데이터스페이스가 없을 경우 h5writeatt는 이 특성을 삭제한 후 다시 생성합니다. string형 특성은 단일 0차원 데이터 점인 스칼라 데이터스페이스로 생성됩니다.

쓸 특성 값으로, 문자형 벡터, string형 스칼라 또는 숫자형 값으로 지정됩니다.

텍스트 인코딩으로, 'TextEncoding'과 함께 다음 값 중 하나가 쉼표로 구분되어 지정됩니다.

  • 'UTF-8' — UTF-8 인코딩을 사용하여 문자를 표현합니다.

  • 'system' — 시스템 인코딩을 사용하여 문자를 바이트로 표현합니다(권장되지 않음).

제한 사항

  • h5writeatt는 HDFS™에 원격으로 저장된 파일에 대한 쓰기를 지원하지 않습니다.

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

버전 내역

R2011a에 개발됨

모두 확장

참고 항목

| |

도움말 항목