Main Content

이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

h5writeatt

HDF5 특성 쓰기

설명

예제

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 = 
'14-Aug-2023 23:27:24'

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은 다음 형식 중 하나가 될 수 있습니다.

위치

형식

현재 폴더

현재 폴더에 쓰려면 filename에 파일의 이름을 지정하십시오.

예: 'myFile.h5'

다른 폴더

현재 폴더가 아닌 다른 폴더에 쓰려면 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 Storagewasb, wasbs

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

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

파일에서의 위치로, 특성을 연결할 기존 그룹 또는 데이터셋의 전체 경로 이름을 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.

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

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

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

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

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

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

제한 사항

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

버전 내역

R2011a에 개발됨

모두 확장