imref3d

3차원 영상을 세계 좌표에 참조

설명

imref3d 객체는 3차원 영상의 열, 행, 평면의 내재적 좌표가 세계 좌표계상의 공간적 위치에서 어떻게 위치하는지 그 관계를 저장합니다.

영상은 좌표계의 평면 세계 x, y, z 좌표에서 규칙적으로 샘플링됩니다. 내재적 x, y, z 값이 각각 세계 x, y, z 값에 정렬됩니다. 각 차원마다 해상도는 다를 수 있습니다.

생성

다음과 같은 방법으로 imref3d 객체를 만들 수 있습니다.

• affineOutputView — 3차원 아핀 기하 변환에 의해 워핑이 적용된 영상의 공간 범위를 저장합니다.

• 여기에서 다루는 imref3d 함수를 사용합니다.

구문

R = imref3d

R = imref3d(imageSize)

R = imref3d(imageSize,pixExtentWorldX,pixExtentWorldY,pixExtentWorldZ)

R = imref3d(imageSize,xWorldLim,yWorldLim,zWorldLim)

설명

R = imref3d는 디폴트 속성 설정을 사용하여 imref3d 객체를 만듭니다.

R = imref3d(imageSize)는 각 공간 차원의 영상 크기를 지정합니다.

R = imref3d(imageSize,pixExtentWorldX,pixExtentWorldY,pixExtentWorldZ)는 세계 좌표계상의 x 차원, y 차원, z 차원의 단일 픽셀에 대한 공간 범위도 지정합니다.

R = imref3d(imageSize,xWorldLim,yWorldLim,zWorldLim)은 세계 좌표계상의 x 차원, y 차원, z 차원의 영상 제한값도 지정합니다.

입력 인수

imageSize — 각 공간 차원의 요소 개수

요소를 2개 가진 양의 행 벡터

각 공간 차원의 요소 개수로, 요소를 2개 가진 양의 행 벡터로 지정됩니다. imageSize의 형식은 size 함수에서 반환된 형식과 동일합니다.

이 인수는 ImageSize 속성을 설정합니다.

데이터형: double

pixExtentWorldX — x 차원의 단일 픽셀 크기

양수

세계 좌표계상에서 측정된 x 차원의 단일 픽셀 크기로, 양수로 지정됩니다.

이 인수는 PixelExtentInWorldX 속성을 설정합니다.

데이터형: double

pixExtentWorldY — y 차원의 단일 픽셀 크기

양수

세계 좌표계상에서 측정된 y 차원의 단일 픽셀 크기로, 양수로 지정됩니다.

이 인수는 PixelExtentInWorldY 속성을 설정합니다.

데이터형: double

pixExtentWorldZ — z 차원의 단일 픽셀 크기

양수

세계 좌표계상에서 측정된 z 차원의 단일 픽셀 크기로, 양수로 지정됩니다.

이 인수는 PixelExtentInWorldZ 속성을 설정합니다.

데이터형: double

xWorldLim — 세계 x 차원의 영상 제한값

요소를 2개 가진 숫자형 행 벡터

세계 x 차원의 영상 제한값으로, 요소를 2개 가진 숫자형 행 벡터 [xMin xMax]로 지정됩니다.

이 인수는 XWorldLimits 속성을 설정합니다.

데이터형: double

yWorldLim — 세계 y 차원의 영상 제한값

요소를 2개 가진 숫자형 행 벡터

세계 y 차원의 영상 제한값으로, 요소를 2개 가진 숫자형 행 벡터 [yMin yMax]로 지정됩니다.

이 인수는 YWorldLimits 속성을 설정합니다.

데이터형: double

zWorldLim — 세계 z 차원의 영상 제한값

요소를 2개 가진 숫자형 행 벡터

세계 z 차원의 영상 제한값으로, 요소를 2개 가진 숫자형 행 벡터 [zMin zMax]로 지정됩니다.

이 인수는 ZWorldLimits 속성을 설정합니다.

데이터형: double

출력 인수

R — 3차원 공간 참조

imref3d 객체

3차원 공간 참조로, imref3d 객체로 반환됩니다.

속성

ImageExtentInWorldX — 세계 좌표계상의 x 차원의 영상 범위

숫자형 스칼라

세계 좌표계상의 x 차원의 영상 범위로, 숫자형 스칼라로 지정됩니다. imref3d 객체는 이 값을 PixelExtentInX * ImageSize(2)로 계산합니다.

데이터형: double

ImageExtentInWorldY — 세계 좌표계상의 y 차원의 영상 범위

숫자형 스칼라

세계 좌표계상의 y 차원의 영상 범위로, 숫자형 스칼라로 지정됩니다. imref3d 객체는 이 값을 PixelExtentInY * ImageSize(1)로 계산합니다.

데이터형: double

ImageExtentInWorldZ — 세계 좌표계상의 z 차원의 영상 범위

숫자형 스칼라

세계 좌표계상의 z 차원의 영상 범위로, 숫자형 스칼라로 지정됩니다. imref3d 객체는 이 값을 PixelExtentInZ * ImageSize(3)으로 계산합니다.

데이터형: double

ImageSize — 각 공간 차원의 요소 개수

요소를 3개 가진 양의 행 벡터

각 공간 차원의 요소 개수로, 요소를 3개 가진 양의 행 벡터로 지정됩니다. ImageSize의 형식은 size 함수에서 반환된 형식과 동일합니다.

데이터형: double

PixelExtentInWorldX — 세계 좌표계상에서 측정된 x 차원의 단일 픽셀 크기

양수

세계 좌표계상에서 측정된 x 차원의 단일 픽셀 크기로, 양수로 지정됩니다.

데이터형: double

PixelExtentInWorldY — 세계 좌표계상에서 측정된 y 차원의 단일 픽셀 크기

양수

세계 좌표계상에서 측정된 y 차원의 단일 픽셀 크기로, 양수로 지정됩니다.

데이터형: double

PixelExtentInWorldZ — 세계 좌표계상에서 측정된 z 차원의 단일 픽셀 크기

양수

세계 좌표계상에서 측정된 z 차원의 단일 픽셀 크기로, 양수로 지정됩니다.

데이터형: double

XWorldLimits — 세계 x 차원의 영상 제한값

요소를 2개 가진 숫자형 행 벡터

세계 x의 영상 제한값으로, 요소를 2개 가진 행 벡터 [xMin xMax]로 지정됩니다.

데이터형: double

YWorldLimits — 세계 y 차원의 영상 제한값

요소를 2개 가진 숫자형 행 벡터

세계 y의 영상 제한값으로, 요소를 2개 가진 행 벡터 [yMin yMax]로 지정됩니다.

데이터형: double

ZWorldLimits — 세계 z 차원의 영상 제한값

요소를 2개 가진 숫자형 행 벡터

세계 z의 영상 제한값으로, 요소를 2개 가진 행 벡터 [zMin zMax]로 지정됩니다.

데이터형: double

XIntrinsicLimits — x 차원의 영상 제한값(내재적 단위 기준)

요소를 2개 가진 행 벡터

내재적(intrinsic) 단위를 기준으로 한 x 차원의 영상 제한값으로, 요소를 2개 가진 행 벡터 [xMin xMax]로 지정됩니다. m×n×p 영상의 경우 이는 [0.5, n+0.5]와 동일합니다.

데이터형: double

YIntrinsicLimits — y 차원의 영상 제한값(내재적 단위 기준)

요소를 2개 가진 행 벡터

내재적(intrinsic) 단위를 기준으로 한 y 차원의 영상 제한값으로, 요소를 2개 가진 행 벡터 [yMin yMax]로 지정됩니다. m×n×p 영상의 경우 이는 [0.5, m+0.5]와 동일합니다.

데이터형: double

ZIntrinsicLimits — z 차원의 영상 제한값(내재적 단위 기준)

요소를 2개 가진 행 벡터

내재적(intrinsic) 단위를 기준으로 한 z 차원의 영상 제한값으로, 요소를 2개 가진 행 벡터 [zMin zMax]로 지정됩니다. m×n×p 영상의 경우 이는 [0.5, p+0.5]와 동일합니다.

데이터형: double

객체 함수

contains	Determine if image contains points in world coordinate system
intrinsicToWorld	Convert from intrinsic to world coordinates
sizesMatch	Determine if object and image are size-compatible
worldToIntrinsic	Convert from world to intrinsic coordinates
worldToSubscript	Convert world coordinates to row and column subscripts

예제

영상 크기와 각 차원의 해상도를 파악하여 imref3d 객체 만들기

영상을 읽어 들입니다.

m = analyze75info("brainMRI.hdr");
A = analyze75read(m);

이 영상과 연결된 imref3d 객체를 픽셀 크기를 지정하여 만듭니다. 파일의 PixelDimensions 메타데이터 필드가 각 차원의 해상도를 밀리미터/픽셀 단위로 지정합니다.

RA = imref3d(size(A),m.PixelDimensions(2),m.PixelDimensions(1),m.PixelDimensions(3));

RA = 

  imref3d with properties:

           XWorldLimits: [0.5000 128.5000]
           YWorldLimits: [0.5000 128.5000]
           ZWorldLimits: [0.5000 27.5000]
              ImageSize: [128 128 27]
    PixelExtentInWorldX: 1
    PixelExtentInWorldY: 1
    PixelExtentInWorldZ: 1
    ImageExtentInWorldX: 128
    ImageExtentInWorldY: 128
    ImageExtentInWorldZ: 27
       XIntrinsicLimits: [0.5000 128.5000]
       YIntrinsicLimits: [0.5000 128.5000]
       ZIntrinsicLimits: [0.5000 27.5000]

각 차원의 영상 범위(단위: 밀리미터)를 확인합니다.

RA.ImageExtentInWorldX
RA.ImageExtentInWorldY
RA.ImageExtentInWorldZ

ans =

   128

ans =

   128

ans =

    27

세부 정보

내재적 좌표계

픽셀 중심점의 내재적 좌표값 (x,y,z)는 해당 픽셀의 열, 행 및 평면 첨자 값과 동일합니다. 예를 들어, 행 5, 열 3, 평면 4에 있는 픽셀의 중심점은 내재적 좌표가 x = 3.0, y = 5.0, z = 4.0입니다.

내재적 좌표에서의 좌표 지정 (3.0,5.0,4.0)은 픽셀 첨자 (5,3,4)와 순서가 반대라는 점에 유의해야 합니다. 내재적 좌표는 연속 평면 위에 정의되지만 첨자 위치는 정수 값을 사용하는 이산 위치입니다.

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• imref3d 함수는 C 및 C++ 코드 생성을 지원합니다(MATLAB^® Coder™가 필요함). 자세한 내용은 Code Generation for Image Processing 항목을 참조하십시오.

• 코드 생성 시 단일 객체만 지정할 수 있으며, 객체로 구성된 배열은 지원되지 않습니다.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

버전 내역

R2013a에 개발됨

참고 항목

imref2d | imregister

도움말 항목

• 영상 좌표계
• Define World Coordinate System of Image