exponenta event banner

maprasterref

Создание объекта растровой ссылки карты

Используйте maprefcells функции или maprefpostings вместо этого, за исключением создания объекта растровой ссылки из матрицы мировых файлов.

Синтаксис

R = maprasterref(W,rasterSize)
R = maprasterref(W,rasterSize,rasterInterpretation)
R = maprasterref(Name,Value)

Описание

R = maprasterref(W,rasterSize) создает объект ссылки для обычного растра ячеек в плоских координатах карты с использованием указанной матрицы файла мира W и размер растра rasterSize.

R = maprasterref(W,rasterSize,rasterInterpretation), где rasterInterpretation является 'postings'указывает, что растр содержит регулярно размещаемые образцы в плоских координатах карты. Значение по умолчанию для rasterInterpretation является 'cells', который задает обычный растр ячеек.

R = maprasterref(Name,Value) принимает список пар имя-значение, которые используются для назначения выбранных свойств при инициализации объекта растровой ссылки карты.

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

свернуть все

Матрица мировых файлов, заданная как числовой массив 2 на 3. Каждый из шести элементов в W соответствует одной из строк в файле мира, который определяет преобразование в растровом ссылочном объекте R.

Типы данных: double

Число строк (m) и столбцов (n) растра или изображения, связанных со ссылочным объектом, указанное как двухэлементный вектор [m n]. Для удобства можно назначить вектору размера, имеющему более двух элементов, RasterSize. Эта гибкость обеспечивает такие назначения, как R.RasterSize = size(RGB), например, где RGB m-by-n-by-3. Однако в таких случаях фактически сохраняются только первые два элемента вектора размера. Более высокие (непространственные) размеры игнорируются

Управляет обработкой растровых кромок. rasterInterpretation вход необязателен и может равняться 'cells' или 'postings'.

Аргументы пары «имя-значение»

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Можно включить любое из следующих свойств, при необходимости переопределяя их значения по умолчанию. Кроме того, при создании объекта растровой ссылки карты можно опустить все свойства. Затем можно настроить результат, сбросив свойства из этого списка по одному. Этот синтаксис имя-значение всегда приводит к объекту с 'rectilinear' TransformationType. Если изображение повернуто относительно мировых координатных осей, требуется объект с TransformationType из 'affine'. В качестве альтернативы можно ввести соответствующую матрицу мировых файлов, как показано в третьем синтаксисе. Это невозможно сделать путем сброса свойств существующего объекта растровой ссылки прямолинейной карты.

'XLimWorld'

Пределы растра в мире x

Двухэлементный вектор строки вида [xMin xMax].

По умолчанию: [0,5 2,5]

'YLimWorld'

Пределы растра в мире y

Двухэлементный вектор строки вида [yMin yMax].

По умолчанию: [0,5 2,5]

'RasterSize'

Двухэлементный вектор [M N] задание количества строк (M) и столбцов (N) растра или изображения, связанных со ссылочным объектом. Для удобства можно назначить вектору размера, имеющему более двух элементов, RasterSize. Эта гибкость обеспечивает такие назначения, как R.RasterSize = size(RGB), например, где RGB является M-by-N-by-3. Однако в таких случаях фактически сохраняются только первые два элемента вектора размера. Более высокие (непространственные) размеры игнорируются.

По умолчанию: [2 2]

'RasterInterpretation'

Управляет обработкой растровых кромок, указанных как 'cells' или 'postings'.

По умолчанию: 'cells'

'ColumnsStartFrom'

Край, на котором начинается индексация столбцов, указанный как 'south' или 'north'.

По умолчанию: 'south'

'RowsStartFrom'

Край, с которого начинается индексация строк, указанный как 'west' или 'east'.

По умолчанию: 'west'

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

свернуть все

Растр карты, указанный как MapCellsReference или MapPostingsReference объект.

Примеры

свернуть все

Создайте ссылочный объект для изображения 1000 на 2000 с квадратными полуметровыми пикселями, связанными с планарной картографической системой координат («мировой» системой). Пределы X в мировой системе составляют 207000 и 208000. Y-пределы составляют 912500 и 913000. Изображение следует за популярным соглашением, в котором мир X увеличивается от столбца к столбцу, а мир Y уменьшается от строки к строке.

R = maprasterref('RasterSize', [1000 2000], ...
          'YWorldLimits', [912500 913000], 'ColumnsStartFrom','north', ...
          'XWorldLimits', [207000 208000])
R = 
  MapCellsReference with properties:

            XWorldLimits: [207000 208000]
            YWorldLimits: [912500 913000]
              RasterSize: [1000 2000]
    RasterInterpretation: 'cells'
        ColumnsStartFrom: 'north'
           RowsStartFrom: 'west'
      CellExtentInWorldX: 1/2
      CellExtentInWorldY: 1/2
    RasterExtentInWorldX: 1000
    RasterExtentInWorldY: 500
        XIntrinsicLimits: [0.5 2000.5]
        YIntrinsicLimits: [0.5 1000.5]
      TransformationType: 'rectilinear'
    CoordinateSystemType: 'planar'
            ProjectedCRS: []


Создайте объект растровой ссылки по умолчанию.

R = maprasterref
R = 
  MapCellsReference with properties:

            XWorldLimits: [0.5 2.5]
            YWorldLimits: [0.5 2.5]
              RasterSize: [2 2]
    RasterInterpretation: 'cells'
        ColumnsStartFrom: 'south'
           RowsStartFrom: 'west'
      CellExtentInWorldX: 1
      CellExtentInWorldY: 1
    RasterExtentInWorldX: 2
    RasterExtentInWorldY: 2
        XIntrinsicLimits: [0.5 2.5]
        YIntrinsicLimits: [0.5 2.5]
      TransformationType: 'rectilinear'
    CoordinateSystemType: 'planar'
            ProjectedCRS: []


Задайте поля в объекте растровой ссылки.

R.XWorldLimits = [207000 208000];
R.YWorldLimits = [912500 913000];
R.ColumnsStartFrom = 'north';
R.RasterSize = [1000 2000]
R = 
  MapCellsReference with properties:

            XWorldLimits: [207000 208000]
            YWorldLimits: [912500 913000]
              RasterSize: [1000 2000]
    RasterInterpretation: 'cells'
        ColumnsStartFrom: 'north'
           RowsStartFrom: 'west'
      CellExtentInWorldX: 1/2
      CellExtentInWorldY: 1/2
    RasterExtentInWorldX: 1000
    RasterExtentInWorldY: 500
        XIntrinsicLimits: [0.5 2000.5]
        YIntrinsicLimits: [0.5 1000.5]
      TransformationType: 'rectilinear'
    CoordinateSystemType: 'planar'
            ProjectedCRS: []


Создание матрицы мировых файлов.

W = [0.5   0.0   207000.25; ...
     0.0  -0.5   912999.75];

Укажите размер изображения.

rasterSize = [1000 2000];

Создайте объект растровой ссылки карты.

R = maprasterref(W, rasterSize)
R = 
  MapCellsReference with properties:

            XWorldLimits: [207000 208000]
            YWorldLimits: [912500 913000]
              RasterSize: [1000 2000]
    RasterInterpretation: 'cells'
        ColumnsStartFrom: 'north'
           RowsStartFrom: 'west'
      CellExtentInWorldX: 1/2
      CellExtentInWorldY: 1/2
    RasterExtentInWorldX: 1000
    RasterExtentInWorldY: 500
        XIntrinsicLimits: [0.5 2000.5]
        YIntrinsicLimits: [0.5 1000.5]
      TransformationType: 'rectilinear'
    CoordinateSystemType: 'planar'
            ProjectedCRS: []