ncreadatt

netCDF 데이터 소스에서 특성 읽기

구문

attvalue = ncreadatt(source,location,attname)

설명

attvalue = ncreadatt(source,location,attname)은 source의 location에서 지정한 그룹이나 변수에서 netCDF 특성 attname을 읽습니다. 반환되는 특성 값은 attname의 netCDF 데이터형과 가장 일치하는 MATLAB^® 데이터형입니다. MATLAB이 가장 일치하는 유형을 결정하는 방법은 NetCDF 데이터형을 MATLAB 데이터형으로 변환 항목을 참조하십시오.

예제

전역 특성 읽기

netCDF 파일 example.nc의 creation_date 전역 특성을 읽습니다.

creationDate = ncreadatt("example.nc","/","creation_date")

creationDate = 
'29-Mar-2010'

변수 특성 읽기

temperature 변수와 연관된 scale_factor 특성을 읽습니다.

scaleFactor = ncreadatt("example.nc","temperature","scale_factor")

scaleFactor = 1.8000

그룹 특성 읽기

/grid2 그룹과 연관된 description 특성을 읽습니다. 형식이 netcdf4인 파일에서만 그룹 특성을 읽을 수 있습니다.

groupDescription = ncreadatt("example.nc","/grid2","description")

groupDescription = 
'This is another group attribute.'

입력 인수

source — netCDF 데이터 소스 이름

string형 스칼라 | 문자형 벡터

netCDF 데이터 소스 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. source 인수는 다음 값 중 하나일 수 있습니다.

• 로컬 netCDF 소스의 경로

• 원격 OPeNDAP netCDF 데이터 소스의 OPeNDAP URL

• 원격 netCDF 소스의 HTTP URL로, 바이트 범위 읽기를 활성화하기 위해 URL 끝에 #mode=bytes가 추가됨

  참고

  바이트 범위 읽기는 다른 소스에서 읽는 것보다 속도가 느립니다. 바이트 범위 읽기에 대한 자세한 내용은 netCDF 문서를 참조하십시오.

예: "myNetCDFfile.nc"

예: "http://host_name/netcdf_filename#mode=bytes"

location — 변수 또는 그룹의 위치

string형 스칼라 | 문자형 벡터

netCDF 데이터 소스에서 변수나 그룹의 위치로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 전역 특성을 읽으려면 location을 "/"(슬래시)로 설정하십시오.

예: "myVar"

예: "/myGrp/mySubGrp/myNestedVar"

예: "myGrp"

예: "/myGrp/mySubGrp"

attname — 특성 이름

string형 스칼라 | 문자형 벡터

읽어 들일 특성 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다.

예: "myAttribute"

세부 정보

NetCDF 데이터형을 MATLAB 데이터형으로 변환

netCDF 관련 MATLAB 함수는 아래 표에 따라 netCDF 데이터형과 가장 일치하는 MATLAB 데이터형을 자동으로 선택합니다.

NetCDF 데이터형	MATLAB 데이터형
NC_DOUBLE	double
NC_FLOAT	single
NC_INT	int32
NC_SHORT	int16
NC_BYTE	int8
NC_CHAR	char
NC_STRING(*)	string
NC_INT64(*)	int64
NC_UINT64(*)	uint64
NC_UINT(*)	uint32
NC_USHORT(*)	uint16
NC_UBYTE(*)	uint8
사용자 정의 NC_VLEN 유형(*)	cell

(*) 이 netCDF 데이터형은 netcdf4 형식의 파일에만 사용할 수 있습니다.

버전 내역

R2011a에 개발됨

R2022a: 원격 데이터셋을 바이트 범위로 읽음

원격 서버가 바이트 범위 액세스를 지원하는 경우 ncreadatt로 HTTP 바이트 범위 기능을 사용하여 원격 데이터셋에 읽기 전용으로 액세스할 수 있습니다.

R2022a: 가변 길이 배열 데이터형(NC_VLEN)을 읽음

NetCDF-4 파일에서 가변 길이 배열 데이터형(NC_VLEN)을 읽을 수 있습니다.

R2021b: NC_STRING 특성 읽기

NetCDF-4 파일에서 NC_STRING 특성을 읽을 수 있습니다.

참고 항목

ncdisp | ncinfo | ncread | ncwriteatt

도움말 항목

• NetCDF 파일과 OPeNDAP 데이터 가져오기