Main Content

niftiread

NIfTI 영상 읽어 들이기

페이지 내 모두 축소

구문

V = niftiread(filename)
V = niftiread(headerfile,imgfile)
V = niftiread(info)

설명

예제

V = niftiread(filename)은 현재 폴더 또는 경로에서 filename으로 지정된 NIfTI 영상 파일을 읽어 들이고, 볼륨 데이터를 V로 반환합니다. niftiread 함수는 NIfTI1 및 NIfTI2 파일 형식을 모두 지원합니다.

V = niftiread(headerfile,imgfile)은 NIfTI 헤더 파일(.hdr)과 영상 파일(.img) 쌍을 읽어 들입니다.

예제

V = niftiread(info)는 메타데이터 구조체 info에서 설명한 NIfTI 파일을 읽어 들입니다. info 구조체를 생성하려면 niftiinfo 함수를 사용하십시오.

예제

모두 축소

라이브 스크립트 열기

NIfTI 파일에서 볼륨 데이터를 불러옵니다. 이 파일은 영상과 메타데이터를 동일한 한 파일에 포함하는 혼합 NIfTI 파일 형식을 사용합니다. 이러한 NIfTI 파일 형식의 파일 확장자는 .nii입니다.

V = niftiread('brain.nii');

작업 공간에 변수를 표시합니다.

whos V
  Name        Size                  Bytes  Class    Attributes

  V         256x256x21            1376256  uint8
라이브 스크립트 열기

NIfTI 파일에서 메타데이터를 읽어 들입니다. 

info = niftiinfo('brain.nii');

niftiinfo에 의해 반환된 메타데이터 구조체를 사용하여 볼륨 영상을 읽어 들입니다.

V = niftiread(info);

작업 공간에 변수를 표시합니다.

whos V
  Name        Size                  Bytes  Class    Attributes

  V         256x256x21            1376256  uint8

입력 인수

모두 축소

NIfTI 파일 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 파일은 NIfTI1 또는 NIfTI2 파일 형식일 수 있습니다.

  • 파일 확장자를 지정하지 않으면 niftiread는 확장자가 .nii인 파일을 찾습니다.

  • 확장자가 .nii인 파일을 찾을 수 없으면 niftiread는 확장자가 .nii.gz인 gzip 파일을 찾습니다.

  • 확장자가 .nii.gz인 파일을 찾을 수 없으면 niftiread는 확장자가 .hdr, .hdr.gz, .img 또는 .img.gz인 파일을 찾습니다.

  • 이러한 확장자를 가진 파일도 찾을 수 없으면 niftiread는 오류를 반환합니다.

데이터형: char | string

메타데이터를 포함하는 파일의 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. NIfTI 헤더 파일(.hdr)에는 NIfTI 볼륨과 연관된 메타데이터가 저장됩니다. 대응하는 imgfile을 지정하지 않으면 niftiread는 동일한 폴더에서 동일한 이름과 .img 확장자를 가진 파일을 찾습니다.

데이터형: char | string

볼륨을 포함하는 파일의 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. NIfTI 영상 파일(.img)에는 볼륨 데이터가 저장됩니다. 대응하는 헤더 파일을 지정하지 않으면 niftiread는 동일한 폴더에서 동일한 이름과 .hdr 확장자를 가진 파일을 찾습니다.

데이터형: char | string

NIfTI 파일 메타데이터로, niftiinfo에 의해 반환된 구조체로 지정됩니다.

데이터형: struct

출력 인수

모두 축소

볼륨 데이터로, 숫자형 배열로 반환됩니다.

세부 정보

모두 축소

NifTI 파일 형식

NIfTI(Neuroimaging Informatics Technology Initiative)는 기능적 신경영상 소프트웨어 툴의 상호 운용성을 고취시키는 NIH 후원 실무 그룹입니다. NIfTI는 단일 또는 이중 파일 저장 형식을 사용합니다.

  • 이중 파일 형식은 데이터를 한 쌍의 파일, 즉 메타데이터가 포함된 헤더 파일(.hdr) 한 개와 영상 데이터가 포함된 데이터 파일(.img) 한 개에 저장합니다.

  • 단일 파일 형식은 데이터를 단일 파일(.nii)에 저장하며 헤더 정보 다음에 영상 데이터가 들어 있습니다.

참고 문헌

[1] Cox, R. W., J. Ashburner, H. Breman, K. Fissell, C. Haselgrove, C. J. Holmes, J. L. Lancaster, D. E. Rex, S. M. Smith, J. B. Woodward, and S. C. Strother. "A (sort of) new image data format standard: NiFTI-1." 10th Annual Meeting of Organisation of Human Brain Mapping, Budapest, Hungary, June 2004.

버전 내역

R2017b에 개발됨

참고 항목

|