readRelative

(Не рекомендуемый) Рид соседний блок из bigimageDatastore использование относительного положения

readRelative функция bigimageDatastore объект не рекомендуется. Используйте blockedImageDatastore возразите и его объектные функции вместо этого. Для получения дополнительной информации см. Вопросы совместимости.

Описание

пример

data = readRelative(bigds,sourceInfo,blockOffset) возвращает блок из большого datastore изображений bigds это граничит с исходным блоком sourceInfo со смещением blockOffset.

[data,info] = readRelative(bigds,sourceInfo,blockOffset) также возвращает информацию об извлеченных данных, включая метаданные, в info.

Примеры

свернуть все

Создайте bigimage использование модифицированной версии изображения "tumor_091.tif" от набора данных CAMELYON16. Оригинальное изображение является учебным изображением лимфатического узла, содержащего ткань опухоли. Оригинальное изображение имеет восемь уровней разрешения, и самый прекрасный уровень имеет разрешение 53760 61440. Модифицированное изображение имеет только три крупных уровня разрешения. Пространственная ссылка модифицированного изображения была настроена, чтобы осуществить сопоставимое соотношение сторон и указать функции на каждом уровне.

bim = bigimage('tumor_091R.tif');

Создайте bigimageDatastore это управляет блоками большого изображения на самом прекрасном уровне разрешения.

bimds = bigimageDatastore(bim,1);

Считайте первый блок из datastore.

[b,binfo] = read(bimds);
b = b{1};

Считайте соседние блоки налево и право на блок. Левый соседний блок пуст, потому что блок вне границ bim.

bLeft = readRelative(bimds,binfo,[0 -1]);
bRight = readRelative(bimds,binfo,[0 1]);

Отобразите блоки как монтаж. Левый соседний блок кажется черным, потому что это пусто.

montage({bLeft,b,bRight},'Size',[1 3],'BorderSize',5,'BackgroundColor','b')

Figure contains an axes object. The axes object contains an object of type image.

Входные параметры

свернуть все

Большой datastore изображений в виде a bigimageDatastore объект.

Информация об исходном блоке в виде struct, содержащего, по крайней мере, эти поля. Значение info возвращенный read допустимый вход для sourceInfo.

Имя поляОписание
LevelУровень разрешения данных в виде положительные целые числа.
ImageNumberИндекс большого изображения, обеспечивающего данные в виде положительного целого числа.
BlockStartWorld(x, y) мировые координаты верхнего левого угла данных в виде 1 2 числового вектора. Координаты соответствуют положению на контуре блока, не центру верхнего левого пикселя.

Блок возмещен в виде вектора 1 на 2 целых чисел в модулях блоков. Эти два элемента задают вертикальное и горизонтальное смещение от исходного блока. соответственно.

Выходные аргументы

свернуть все

Выходные данные, возвращенные как числовой массив. Если требуемый блок находится вне границ исходного изображения, то readRelative возвращает пустой блок, []

Информация о выходных данных, возвращенных как struct, содержащий эти поля.

Имя поляОписание
LevelУровень разрешения данных в виде 1 ReadSize вектор из положительных целых чисел.
ImageNumberИндекс большого изображения, обеспечивающего данные в виде 1 ReadSize вектор из положительных целых чисел.
BlockStartWorld(x, y) координаты центра верхнего левого пикселя данных, исключая дополнение в виде ReadSize- 2 числовых вектора. Значения находятся в мировых координатах.
BlockEndWorld(x, y) координаты центра нижнего правого пикселя данных, исключая дополнение в виде ReadSize- 2 числовых вектора. Значения находятся в мировых координатах.
DataStartWorld(x, y) координаты центра верхнего левого пикселя данных, включая дополнение в виде ReadSize- 2 числовых вектора. Значения находятся в мировых координатах.
DataEndWorld(x, y) координаты центра нижнего правого пикселя данных, включая дополнение в виде ReadSize- 2 числовых вектора. Значения находятся в мировых координатах.

Советы

  • readRelative игнорирует маски.

  • readRelative уважает PadMethod и BorderSize свойства большого datastore изображений.

  • Если требуемый блок является неполным и bigds.IncompleteBlocks имеет значение 'exclude'то readRelative возвращает пустой блок

Вопросы совместимости

развернуть все

Не рекомендуемый запуск в R2021a

Смотрите также

Введенный в R2019b
Для просмотра документации необходимо авторизоваться на сайте