mappoint

Плоский вектор точки

Описание

mappoint вектор является контейнерным объектом, который содержит плоские координаты точки и атрибуты. Точки связываются, такие, что размер x - и y - координатные массивы всегда равны и совпадают с размером любых динамически добавленных массивов атрибута. Каждая запись координатной пары и сопоставленных атрибутов, если таковые имеются, представляет дискретный элемент в mappoint векторе.

Создание

Синтаксис

p = mappoint()

p = mappoint(x,y)

p = mappoint(x,y,Name,Value)

p = mappoint(structArray)

p = mappoint(x,y,structArray)

Описание

пример

p = mappoint() создает пустой mappoint вектор, p, с этими настройками свойства по умолчанию:

p = 

 0x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: []
           Y: []

пример

p = mappoint(x,y) создает новый mappoint вектор и присваивает свойства X и Y входным параметрам числового массива, x и y.

пример

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

пример

p = mappoint(structArray) создает новый вектор mappoint, присваивая поля массива структур, structArray, как динамические свойства. Значения полей в structArray, которые не являются числовыми значениями, представьте в виде строки скаляр, массив строк, векторы символов, или массивы ячеек числовых значений или векторов символов проигнорированы.

пример

p = mappoint(x,y,structArray) создает новый вектор mappoint, устанавливает свойства X и Y, равные числовым массивам x и y, и устанавливает динамические свойства от значений полей structArray.

Свойства

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

Каждый элемент в mappoint векторе рассматривается функцией. Для больше о типах свойства в mappoint, смотрите Collection Properties и Feature Properties.

Динамические свойства являются новыми опциями, которые добавляются к mappoint вектору и которые применяются к каждой отдельной функции в mappoint векторе. Можно присоединить динамические свойства Feature к объекту mappoint во время конструкции с Name, парой Value или после конструкции с помощью точки (.) обозначение. Это подобно добавлению динамических полей к структуре. Для примера добавляющих свойств Feature динамически, смотрите Построение Вектор Mappoint для Нескольких Функций и Исследуйте Автокалибровку.

`Geometry` — Тип геометрии
`'point'`

Тип геометрии, заданной как 'point'. Для mappoint Geometry всегда является 'point'.

Типы данных: char | string

`Metadata` — Информация для целого набора mappoint векторных элементов
скалярная структура

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

Если Metadata обеспечивается как динамическое свойство Name в конструкторе, и соответствующий Value является скалярной структурой, то Value копируется в свойство Metadata. В противном случае ошибка выпущена.
Если поле Metadata обеспечивается structArray, и и Metadata и structArray являются скалярными структурами, то значение поля Metadata копируется в значение свойства Metadata. Если structArray является скаляром, но поле Metadata не является структурой, то ошибка выпущена. Если structArray не является скаляром, то поле Metadata проигнорировано.

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

`X` — плоский x - координаты
числовая строка или вектор-столбец

Плоский x - координата, заданная как числовая строка или вектор-столбец.

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

`Y` — плоский y - координаты
числовая строка или вектор-столбец

Плоский y - координаты, заданные как числовая строка или вектор-столбец.

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

Функции объекта

`append`	Добавьте функции к географическому или плоскому вектору
`cat`	Конкатенация географического или плоского вектора
`disp`	Отобразите географический или плоский вектор
`fieldnames`	Возвратите имена динамического свойства географического или плоского вектора
`isempty`	Определите, пуст ли географический или плоский вектор
`isfield`	Определите, существует ли динамическое свойство в географическом или плоском векторе
`isprop`	Определите, существует ли свойство в географическом или плоском векторе
`length`	Возвратите число элементов в географическом или плоском векторе
`properties`	Возвратите имена свойства географического или плоского вектора
`rmfield`	Удалите динамическое свойство из географического или плоского вектора
`rmprop`	Удалите свойство из географического или плоского вектора
`size`	Возвратите размер географического или плоского вектора
`struct`	Преобразуйте географический или плоский вектор в скалярную структуру
`vertcat`	Вертикально конкатенируйте географические или плоские векторы

Примеры

свернуть все

Создайте вектор Mappoint по умолчанию

Динамически установите X и значения свойств Y, и динамически добавьте свойство Vertex Z.

p = mappoint();
p.X = 1:3;
p.Y = 1:3;
p.Z = [10 10 10]

p = 

 3x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [1 2 3]
           Y: [1 2 3]
           Z: [10 10 10]

Создайте вектор Mappoint из значений X и Y

Задайте координаты y и x. Используйте их, чтобы создать mappoint.

x = [40 50 60];
y = [10, 11, 12];
p = mappoint(x, y)

p = 

 3x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [40 50 60]
           Y: [10 11 12]

Создайте вектор Mappoint от X, Y, и температурные значения

x = 41:43;
y = 1:3;
temperature = 61:63;
p = mappoint(x, y, 'Temperature', temperature)

p = 

 3x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: [41 42 43]
              Y: [1 2 3]
    Temperature: [61 62 63]

Создайте вектор Mappoint из массива структур

Создайте массив структур и затем создайте mappoint вектор, задав массив, как введено.

structArray = shaperead('boston_placenames')
p = mappoint(structArray)

structArray = 

13x1 struct array with fields:
    Geometry
    X
    Y
    NAME
    FEATURE
    COORD


p = 

 13x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [1x13 double]
           Y: [1x13 double]
        NAME: {1x13 cell}
     FEATURE: {1x13 cell}
       COORD: {1x13 cell

Создайте вектор Mappoint из числовых массивов X и Y и массива структур

[structArray, A] = shaperead('boston_placenames');
x = [structArray.X];
y = [structArray.Y];
p = mappoint(x, y, A)

p = 

 13x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [1x13 double]
           Y: [1x13 double]
        NAME: {1x13 cell}
     FEATURE: {1x13 cell}
       COORD: {1x13 cell}

Создайте вектор Mappoint для одной функции

Этот пример показывает, как добавить одну опцию к пустому mappoint вектору после конструкции.

x = 1;
y = 1;
p = mappoint(x, y)

p = 

 1x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: 1
           Y: 1

Добавьте динамическое свойство Feature со значением вектора символов.

p.FeatureName = 'My Feature'

p = 

 1x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: 1
              Y: 1
    FeatureName: 'My Feature'

Создайте вектор Mappoint для нескольких функций и исследуйте автокалибровку

Этот пример показывает, как mappoint векторы автоизменяют размер всех длин свойств, чтобы гарантировать, что они равны в размере, когда новое динамическое свойство добавляется, или существующее свойство добавлено или сокращено.

Создайте mappoint вектор.

x = [1 2];
y = [10 10];
p = mappoint(x,y)

p = 

 2x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [1 2]
           Y: [10 10]

Добавьте динамическое свойство Feature.

p.FeatureName = {'Feature 1','Feature 2'}

p = 

 2x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: [1 2]
              Y: [10 10]
    FeatureName: {'Feature 1' 'Feature 2'}

Добавьте числовое динамическое свойство Feature.

p.ID = [1 2]

p = 

 2x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: [1 2]
              Y: [10 10]
    FeatureName: {'Feature 1' 'Feature 2'}
             ID: [1 2]

Добавьте третью опцию. Все свойства автоизмерены так, чтобы все длины вектора соответствовали.

p(3).X = 3
p(3).Y = 10

p = 

 3x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: [1 2 3]
              Y: [10 10 10]
    FeatureName: {'Feature 1' 'Feature 2' ''}
             ID: [1 2 0]

Установите значения для динамического свойства функции ID с большим количеством значений, чем содержавшийся в X или Y. Все свойства расширены, чтобы соответствовать в размере.

p.ID = 1:4

p = 

 4x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: [1 2 3 0]
              Y: [10 10 10 0]
    FeatureName: {'Feature 1' 'Feature 2' '' ''}
             ID: [1 2 3 4]

Установите значения для ID динамическое свойство Feature с меньшим количеством значений, чем содержавшийся в X или Y. Значения свойств ID расширяются, чтобы совпадать с длиной X и Y.

p.ID = 1:2

p = 

 4x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: [1 2 3 0]
              Y: [10 10 10 0]
    FeatureName: {'Feature 1' 'Feature 2' '' ''}
             ID: [1 2 0 0]

Установите значения или координатного свойства (X или Y) с меньшим количеством значений. Все свойства уменьшаются в размере, чтобы совпадать с новой длиной.

p.X = 1:2

p = 

 2x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: [1 2]
              Y: [10 10]
    FeatureName: {'Feature 1' 'Feature 2'}
             ID: [1 2]

Удалите свойство FeatureName путем устанавливания его значения к [].

p.FeatureName = []

p = 

 2x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [1 2]
           Y: [10 10]
          ID: [1 2]

Удалите все динамические свойства и установите объект опустеть путем установки координатного значения свойства на [].

p.X = []

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: []
           Y: []

Создайте Mappoint определение двух функций

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

point = mappoint([42 44],[10, 11],'Temperature',[63 65],'TemperatureUnits','Fahrenheit')

point = 

 2x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: [42 44]
              Y: [10 11]
    Temperature: [63 65]
TemperatureUnits: 'Fahrenheit'

Создайте вектор Mappoint из MAT-файла

Этот пример показывает, как создать mappoint вектор с помощью данных из MAT-файла, содержащего океанские глубины.

Загрузите данные из MAT-файла подводной горы и создайте mappoint вектор, чтобы содержать координаты.

seamount = load('seamount');
p = mappoint(seamount.x, seamount.y, 'Z', seamount.z);

Создайте список уровней, чтобы использовать для интервала значения z и создать список значений цвета для каждого уровня.

levels = [unique(floor(seamount.z/1000)) * 1000; 0];
colors = {'red','green','blue','cyan','black'};

Добавьте MinLevel и свойство функции MaxLevel указать на самый низкий и самый высокий сгруппированный уровень. Добавьте динамическое свойство функции указать на z - координата. Добавьте динамическое свойство Feature указать на сгруппированное значение уровня и значение цвета для данного уровня. Включайте информацию о метаданных из MAT-файла.

for k = 1:length(levels) - 1
   index = levels(k) <= p.Z & p.Z < levels(k+1);
   p(index).MinLevel = levels(k);
   p(index).MaxLevel = levels(k+1) - 1;
   p(index).Color = colors{k};
end

Добавьте информацию о метаданных. Metadata является скалярной структурой, содержащей информацию для целого набора свойств. Можно добавить любой тип данных к структуре.

p.Metadata.Caption = seamount.caption;
p.Metadata

ans = 

    Caption: [1x229 char]

Отобразите данные о точке как 2D график.

figure
minLevels = unique(p.MinLevel);
for k=1:length(minLevels)
  index = p.MinLevel == minLevels(k);
  mapshow(p(index).X, p(index).Y, ...
   'MarkerEdgeColor', p(find(index,1)).Color, ...
   'Marker', 'o', ...
   'DisplayType', 'point')
end
legend(num2str(minLevels'))

Отобразите данные о точке как 3-D график рассеивания.

figure
scatter3(p.X, p.Y, p.Z)

Присвойте динамические функции вектору Mappoint из массива структур

Этот пример показывает, как создать mappoint вектор из массива структур, и как добавить опции и метаданные к mappoint вектору.

structArray = shaperead('boston_placenames');
p = mappoint();
p.X = [structArray.X];
p.Y = [structArray.Y];
p.Name = {structArray.NAME}

p = 

 13x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [1x13 double]
           Y: [1x13 double]
        Name: {1x13 cell}

Создайте mappoint вектор из массива структур с помощью синтаксиса конструктора.

filename = 'boston_placenames.shp';
structArray = shaperead(filename);
p = mappoint(structArray)

p = 

 13x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [1x13 double]
           Y: [1x13 double]
        NAME: {1x13 cell}
     FEATURE: {1x13 cell}
       COORD: {1x13 cell}

Добавьте поле Filename в структуру Metadata. Отобразите первые пять точек и структуру Metadata.

p.Metadata.Filename = filename;
p(1:5)
p.Metadata

ans = 

 5x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [2.3403e+05 2.3357e+05 2.3574e+05 2.3627e+05 2.3574e+05]
           Y: [900038 9.0019e+05 9.0113e+05 9.0097e+05 9.0036e+05]
        NAME: {1x5 cell}
     FEATURE: {'PPL-SUBDVSN' ' MARSH' ' HILL' ' PPL' ' PENINSULA'}
       COORD: {1x5 cell}

ans = 

    Filename: 'boston_placenames.shp'

Добавьте точку путем индексации

Этот пример показывает, как добавить опцию к mappoint вектору, использующему линейную индексацию.

Добавьте Падерборн, Германия к вектору мировых городов.

p = mappoint(shaperead('worldcities.shp'));
x = 51.715254;
y = 8.75213;
p = append(p, x, y, 'Name', 'Paderborn');
p(end)

ans = 

 1x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: 51.7153
           Y: 8.7521
        Name: 'Paderborn'

Можно также добавить точку в конец mappoint вектора, использующего линейную индексацию. Добавьте Арлингтон, Вирджиния в конец вектора.

p(end+1).X = 38.880043;
p(end).Y = -77.196676;
p(end).Name = 'Arlington';
p(end-1:end)

ans = 

 2x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [51.7153 38.8800]
           Y: [8.7521 -77.1967]
        Name: {'Paderborn' 'Arlington'}

% Plot the points
figure
mapshow(p.X, p.Y, 'DisplayType', 'point')

Сортировка динамических свойств

Этот пример показывает, как функции могут быть отсортированы при помощи поведения индексации mappoint класса.

Создайте mappoint вектор и отсортируйте динамические свойства.

p = mappoint(shaperead('tsunamis'));
p = p(:, sort(fieldnames(p)))

p = 

 162x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: [1x162 double]
              Y: [1x162 double]
          Cause: {1x162 cell}
     Cause_Code: [1x162 double]
        Country: {1x162 cell}
            Day: [1x162 double]
    Desc_Deaths: [1x162 double]
         Eq_Mag: [1x162 double]
           Hour: [1x162 double]
       Iida_Mag: [1x162 double]
      Intensity: [1x162 double]
       Location: {1x162 cell}
     Max_Height: [1x162 double]
         Minute: [1x162 double]
          Month: [1x162 double]
     Num_Deaths: [1x162 double]
         Second: [1x162 double]
       Val_Code: [1x162 double]
       Validity: {1x162 cell}
           Year: [1x162 double]

Измените mappoint вектор, чтобы содержать только динамические свойства, 'Year', 'Month', 'Day', 'Hour', 'Minute'.

p = p(:, {'Year', 'Month', 'Day', 'Hour', 'Minute'})

p = 

 162x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [1x162 double]
           Y: [1x162 double]
        Year: [1x162 double]
       Month: [1x162 double]
         Day: [1x162 double]
        Hour: [1x162 double]
      Minute: [1x162 double]

Отобразите первые пять элементов.

p(1:5)

ans = 

 5x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [128.3000 -156 157.9500 143.8500 -155]
           Y: [-3.8000 19.5000 -9.0200 42.1500 19.1000]
        Year: [1950 1951 1951 1952 1952]
       Month: [10 8 12 3 3]
         Day: [8 21 22 4 17]
        Hour: [3 10 NaN 1 3]
      Minute: [23 57 NaN 22 58]

Входные параметры строки и столбца

Этот пример демонстрирует, что входные параметры x и y могут быть или строкой или вектор-столбцами.

Если вы обычно храните x - и y - координатные значения в n-by-2 или 2 m массивом, можно присвоить объект mappoint этим числовым значениям. Если значения хранятся в n-by-2 массив, то значения свойств X присвоены первому столбцу, и значения свойств Y присвоены второму столбцу.

x = 1:10;
y = 21:30;
pts = [x' y'];
p = mappoint;
p(1:length(pts)) = pts

p = 

 10x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [1 2 3 4 5 6 7 8 9 10]
           Y: [21 22 23 24 25 26 27 28 29 30]

Если значения хранятся в 2 m массивом, то значения свойств X присвоены первой строке, и значения свойств Y присвоены второй строке.

pts = [x; y];
p(1:length(pts)) = pts

p = 

 10x1 mappoint vector with properties:

 Collection properties:
    Geometry: 'point'
    Metadata: [1x1 struct]
 Feature properties:
           X: [1 2 3 4 5 6 7 8 9 10]
           Y: [21 22 23 24 25 26 27 28 29 30]

Заметьте, что в обоих случаях, X и Y хранятся как векторы - строки.

Больше о

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

Свойства набора

Свойства набора содержат только одно значение на экземпляр класса. Напротив, типу свойства Feature сопоставили значения атрибута с каждой функцией. Geometry и Metadata являются только двумя свойствами Collection.

Покажите свойства

Свойства функции содержат одно значение (скалярный номер, представьте в виде строки скаляр или вектор символов) для каждой функции в mappoint векторе. Они подходят для свойств, таких как имя, владелец, порядковый номер или возраст, которые описывают данную функцию (элемент mappoint вектора) в целом. X и свойства координаты Y являются свойствами функции, когда существует одно значение для каждого элемента в mappoint векторе.

Покажите свойства, может быть добавлен динамически с помощью записи через точку. Это подобно добавлению динамических полей к структуре.

Советы

Если X, Y или динамическое свойство установлены с большим количеством значений, чем функции в mappoint векторе, то все другие свойства расширяются в размере с помощью 0 для числовых значений и пустого символьного вектора ('') для значений ячеек.
Если динамическое свойство установлено с меньшим количеством значений, чем количество функций, то это динамическое свойство расширяется, чтобы совпадать с размером других свойств путем вставки 0, если значение является числовым или пустой символьный вектор (''), если значение является массивом ячеек.
Если свойство X или Y mappoint вектора установлено с меньшим количеством значений, чем содержавшийся в объекте, то все другое уменьшение свойств в размере.
Если или X или Y установлены в [], то оба координатных свойства установлены в [], и все динамические свойства удалены.
Если динамическое свойство установлено в [], то оно удалено из объекта.
mappoint вектор может быть индексирован как любой вектор MATLAB^®. Можно получить доступ к любому элементу вектора, чтобы получить определенную функцию. Следующие примеры демонстрируют это поведение:
Добавьте точку путем индексации
Сортировка динамических свойств

Документация

mappoint

Описание

Создание

Синтаксис

Описание

Свойства

`Geometry` — Тип геометрии
`'point'`

`Metadata` — Информация для целого набора mappoint векторных элементов
скалярная структура

`X` — плоский x - координаты
числовая строка или вектор-столбец

`Y` — плоский y - координаты
числовая строка или вектор-столбец

Функции объекта

Примеры

Создайте вектор Mappoint по умолчанию

Создайте вектор Mappoint из значений X и Y

Создайте вектор Mappoint от X, Y, и температурные значения

Создайте вектор Mappoint из массива структур

Создайте вектор Mappoint из числовых массивов X и Y и массива структур

Создайте вектор Mappoint для одной функции

Создайте вектор Mappoint для нескольких функций и исследуйте автокалибровку

Создайте Mappoint определение двух функций

Создайте вектор Mappoint из MAT-файла

Присвойте динамические функции вектору Mappoint из массива структур

Добавьте точку путем индексации

Сортировка динамических свойств

Входные параметры строки и столбца

Больше о

Свойства набора

Покажите свойства

Советы

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

Функции

Объекты

Представленный в R2012a

Документация Mapping Toolbox

Поддержка

Документация

mappoint

Описание

Создание

Синтаксис

Описание

Свойства

Geometry — Тип геометрии 'point'

Metadata — Информация для целого набора mappoint векторных элементов скалярная структура

X — плоский x - координаты числовая строка или вектор-столбец

Y — плоский y - координаты числовая строка или вектор-столбец

Функции объекта

Примеры

Создайте вектор Mappoint по умолчанию

Создайте вектор Mappoint из значений X и Y

Создайте вектор Mappoint от X, Y, и температурные значения

Создайте вектор Mappoint из массива структур

Создайте вектор Mappoint из числовых массивов X и Y и массива структур

Создайте вектор Mappoint для одной функции

Создайте вектор Mappoint для нескольких функций и исследуйте автокалибровку

Создайте Mappoint определение двух функций

Создайте вектор Mappoint из MAT-файла

Присвойте динамические функции вектору Mappoint из массива структур

Добавьте точку путем индексации

Сортировка динамических свойств

Входные параметры строки и столбца

Больше о

Свойства набора

Покажите свойства

Советы

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

Функции

Объекты

Представленный в R2012a

Документация Mapping Toolbox

Поддержка

`Geometry` — Тип геометрии
`'point'`

`Metadata` — Информация для целого набора mappoint векторных элементов
скалярная структура

`X` — плоский x - координаты
числовая строка или вектор-столбец

`Y` — плоский y - координаты
числовая строка или вектор-столбец