blockedImage
설명
blockedImage 객체는 이산 블록으로부터 만들어진 영상입니다. 블록 형식 영상을 사용하여 다음과 같은 작업을 수행할 수 있습니다.
다중 해상도(다중 수준 또는 피라미드형으로도 알려짐) 영상을 처리합니다.
너무 커서 메모리에 들어가지 않는 영상, 볼륨 또는 다차원 영상을 처리합니다.
볼륨 또는 다차원 영상을 3차원 또는 고차원 블록으로 처리합니다.
비표준 영상 형식의 영상에 대해 블록 처리를 수행합니다.
생성
구문
설명
읽기 전용 블록 형식 영상 만들기
[bim1,bim2,...] = blockedImage(는 여러 소스로부터 sources)blockedImage 객체로 구성된 배열을 만듭니다. 소스는 블록 형식 영상 데이터가 포함된 파일 또는 폴더의 모음일 수 있습니다. 블록 형식 영상의 개수는 소스의 개수와 같습니다.
[___] = blockedImage(___,는 이름-값 인수를 사용하여 하나 이상의 쓰기 가능한 속성을 설정합니다.Name=Value)
예를 들어, bim = blockedImage(source,BlockSize=[64 128])는 블록 크기를 64×128 픽셀로 지정합니다.
쓰기 가능한 블록 형식 영상 만들기
bim = blockedImage(는 또한 이름-값 인수를 사용하여 하나 이상의 쓰기 가능한 속성을 설정합니다.dest,imageSize,blockSize,initVal,Mode="w",Name=Value)
예를 들어, bim = blockedImage(dest,imageSize,blockSize,initVal,Mode="w",Adapter=images.blocked.JPEGBlocks)는 blockedImage 객체가 각 블록을 폴더 내의 JPEG 파일로 쓰도록 지정합니다.
입력 인수
이름-값 인수
속성
객체 함수
apply | Process blocks of blocked image |
concatenateLevels | Concatenate levels from multiple blocked images |
crop | 블록 형식 영상의 잘린 버전 만들기 |
blocksub2sub | Convert block subscripts to pixel subscripts |
gather | Collect blocks into current workspace |
getBlock | Read specific block of blocked image |
getRegion | Read arbitrary region of blocked image |
setBlock | Put data in specific block of blocked image |
makeMultiLevel2D | 2-D multilevel blocked image |
makeMultiLevel3D | 3-D multilevel blocked image |
sub2blocksub | Convert pixel subscripts to block subscripts |
sub2world | Convert pixel subscripts to world coordinates |
world2sub | Convert world coordinates to pixel subscripts |
write | Write blocked image data to new destination |
예제
CAMELYON16 데이터 세트의 영상 tumor_091.tif를 변형한 버전을 사용하여 블록 형식 영상을 생성합니다. 이 영상은 종양 조직을 포함한 림프절을 보여줍니다. 원본 영상은 8개의 해상도 수준을 가지며, 가장 높은 수준은 53760×61440의 해상도를 가집니다. 수정된 영상은 세 개의 해상도 수준만을 가집니다. 수정된 영상의 공간 참조는 일관된 종횡비를 유지하고 각 수준에서 특징을 정합하도록 조정되었습니다.
bim = blockedImage("tumor_091R.tif");
블록 형식 영상을 표시합니다.
imageshow(bim);
데이터를 작업 공간으로 읽어 들입니다. 이 예제에서는 툴박스에 포함된 샘플 볼륨을 읽어올 것입니다.
dmri = tiffreadVolume('mri.tif');
볼륨으로부터 블록 형식 영상을 만듭니다.
bim = blockedImage(dmri);
블록 형식 영상에 대한 세부 정보를 명령줄에 표시합니다.
disp(bim)
blockedImage with properties:
Read only properties
Source: [128×128×27 uint8]
Adapter: [1×1 images.blocked.InMemory]
Size: [128 128 27]
SizeInBlocks: [1 1 1]
ClassUnderlying: "uint8"
Settable properties
BlockSize: [128 128 27]
샘플 영상의 툴박스 폴더에 있는 영상들의 파일 세트를 생성합니다.
fs = matlab.io.datastore.FileSet( ... fullfile(matlabroot,'toolbox','images','imdata'), ... "FileExtensions",{'.jpg','.png'});
파일 세트의 영상들로부터 블록 형식 영상으로 구성된 배열을 생성합니다.
bims = blockedImage(fs);
블록 형식 영상으로 구성된 배열의 세부 정보를 표시합니다.
disp(bims)
1×67 blockedImage array with properties:
Read only properties
Source: 'Various'
Adapter: [1×1 images.blocked.GenericImage]
ClassUnderlying: 'Various'
Settable properties
No properties.
데이터를 쓸 수 있는 블록 형식 영상을 생성합니다. destination 파라미터에서 블록 형식 영상의 형식을 지정합니다. 메모리에 쓰려면 빈 행렬을 지정하십시오. 영상의 크기와 영상을 분할하는 블록의 크기도 지정해야 합니다. 초기값 파라미터는 destination에 지정한 형식에 따라 달라집니다. 쓰기 가능한 블록 형식 영상을 만들려면 'Mode' 파라미터에 쓰기 모드를 나타내는 값 'w'를 지정하십시오.
destination = []; imgsize = [5 7]; blocksize = [2 2]; initval = uint8(0); bim = blockedImage(destination,imgsize,blocksize,initval, "Mode", 'w');
setBlock 객체 함수를 사용하여 블록 형식 영상의 지정된 블록에 데이터를 씁니다. blocksubs 파라미터는 데이터를 쓰려는 블록의 좌표를 지정합니다. blockdata 파라미터는 지정된 블록에 쓸 데이터를 지정합니다. blockdata의 크기는 블록 크기와 일치해야 합니다.
blocksubs = [1 1];
blockdata = ones(2,2,"uint8");
setBlock(bim, blocksubs, blockdata)
쓰기를 위해 영상을 닫으십시오.
'Mode' 파라미터를 읽기 모드를 나타내는 'r'로 설정하여 블록 형식 영상을 읽기 모드로 전환하십시오.
bim.Mode = 'r'
bim =
blockedImage with properties:
Read only properties
Source: " {5×7 uint8}↵"
Adapter: [1×1 images.blocked.InMemory]
Size: [5 7]
SizeInBlocks: [3 4]
ClassUnderlying: "uint8"
Settable properties
BlockSize: [2 2]
gather 함수를 사용하여 모든 개별 블록을 수집함으로써 전체 영상을 만듭니다.
fullImage = gather(bim);
블록 형식 영상의 세부 정보를 명령줄에 표시합니다.
disp(fullImage)
1 1 0 0 0 0 0 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
여러분의 응용 사례에서 세계 단위로 좌표나 거리를 측정해야 하는 경우, blockedImage 객체의 WorldStart 및 WorldEnd 속성을 지정하여 사용자 지정 세계 좌표를 정의할 수 있습니다.
CAMELYON16 데이터 세트의 영상 tumor_091.tif를 변형한 버전을 사용하여 블록 형식 영상을 생성합니다. 이 영상은 종양 조직을 포함한 림프절을 보여줍니다. 원본 영상은 8개의 해상도 수준을 가지며, 가장 높은 수준은 53760×61440의 해상도를 가집니다. 수정된 영상은 세 개의 해상도 수준만을 가집니다. 수정된 영상의 공간 참조는 일관된 종횡비를 유지하고 각 수준에서 특징을 정합하도록 조정되었습니다.
bim = blockedImage("tumor_091R.tif");
가장 높은 해상도 수준에서 픽셀 크기를 밀리미터 단위로 지정하십시오. 이 영상의 경우, 픽셀 크기는 약 0.22 마이크로미터로, 이는 100배 현미경 대물렌즈의 일반적인 크기입니다. 이 정보는 Camelyon 17 Grand Challenge 웹사이트의 원시 데이터에서 확인할 수 있습니다.
pixelSpacing = 0.000226316;
첫 번째 픽셀의 왼쪽 위 가장자리의 위치를 지정하되, 세 가지 해상도 수준에서 모두 (0, 0)이라고 가정합니다.
worldStart = zeros(bim.NumLevels, bim.NumDimensions);
가장 높은 해상도 수준의 마지막 픽셀의 우측 하단 가장자리 위치를 계산하십시오. 위치는 픽셀 수와 밀리미터 단위의 픽셀 크기를 곱한 값입니다.
worldEnd = bim.Size(1,:)*pixelSpacing;
repmat를 사용하여 worldEnd 값을 확장하여 세 가지 해상도 수준에 모두 동일한 위치를 지정하십시오.
worldEnd = repmat(worldEnd,[bim.NumLevels,1]);
WorldStart 및 WorldEnd 속성값을 업데이트하십시오.
bim.WorldStart = worldStart; bim.WorldEnd = worldEnd;
업데이트된 블록 형식 영상을 표시합니다. 올바른 단위 레이블을 사용하기 위해 영상 표시의 부모를 Viewer 객체로 설정하고, SpatialUnits 속성값을 "mm"로 지정하십시오. SpatialUnits 속성은 주석 레이블 텍스트에만 영향을 미친다는 점에 유의하십시오. blockedImage 객체의 세계 좌표는 표시된 영상의 공간 좌표 값을 결정합니다.
viewer = viewer2d(ScaleBar="on",ScaleBarStyle="measure",SpatialUnits="mm"); imageshow(bim,Parent=viewer);
팁
blockproc함수는 단일 해상도 메모리 내 영상의 2차원 블록을 처리하기 위한blockedImage의 대체 함수입니다.
