append

Добавьте функции к географическому или плоскому вектору

Описание

пример

vout = append(vin,lat,lon) добавляет значения широты и долготы в lat и lon к Latitude и Longitude свойства географического векторного vin. vin любой geopoint или geoshape объект.

пример

vout = append(vin,x,y) добавляет плоский x - и y - координирует в x и y к X и Y свойства плоского векторного vin. vin любой mappoint или mapshape объект.

пример

vout = append(___,field,value) добавляет значения, заданные в value к соответствующему динамическому свойству, field. Если свойство не существует, append добавляет динамическое свойство к объекту с помощью значения field для имени и присвоения поля значение задано в value. Можно задать несколько пар значения поля. Заключите каждое имя поля в одинарные кавычки.

Примеры

свернуть все

Создайте вектор геоточки.

p = geopoint(42,-110)
p = 
 1x1 geopoint vector with properties:

 Collection properties:
     Geometry: 'point'
     Metadata: [1x1 struct]
 Feature properties:
     Latitude: 42
    Longitude: -110

Добавьте вектор с тремя новыми географическими точками.

lat1 = [42.1 44 44.1];
lon1 = [-101 -120 -121];
p = append(p,lat1,lon1)
p = 
 4x1 geopoint vector with properties:

 Collection properties:
     Geometry: 'point'
     Metadata: [1x1 struct]
 Feature properties:
     Latitude: [42 42.1000 44 44.1000]
    Longitude: [-110 -101 -120 -121]

Длина вектора геоточки увеличивается на три, как ожидалось, и 'Latitude' и 'Longitude' покажите список свойств новые координаты.

Создайте mapshape вектор, определяя динамический 'Temperature' свойство. Этот вектор имеет одну функцию с тремя вершинами.

s = mapshape(42:44,30:32,'Temperature', {65:67})
s = 
 1x1 mapshape vector with properties:

 Collection properties:
       Geometry: 'line'
       Metadata: [1x1 struct]
 Vertex properties:
              X: [42 43 44]
              Y: [30 31 32]
    Temperature: [65 66 67]

Добавьте вектор с двумя новыми плоскими точками. Точки хранятся как новая возможность с двумя вершинами.

x1 = [44.5 45];
y1 = [32.5 33];
s = append(s,x1,y1)
s = 
 2x1 mapshape vector with properties:

 Collection properties:
       Geometry: 'line'
       Metadata: [1x1 struct]
 Vertex properties:
  (2 features concatenated with 1 delimiter)
              X: [42 43 44 NaN 44.5000 45]
              Y: [30 31 32 NaN 32.5000 33]
    Temperature: [65 66 67 NaN 0 0]

Функции разделяются NaN. 'Temperature' значение новых точек установлено к 0 по умолчанию, поскольку никакое значение не было задано во время вызова append. mapshape вектор вырос от 1x1 до 2x1 дюйм длиной потому что количество увеличенных функций.

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

mp = mappoint(42,-110,'Temperature',65)
mp = 
 1x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: 42
              Y: -110
    Temperature: 65

Добавьте точку в этот вектор. Точка содержит новое динамическое свойство, Pressure.

mp = append(mp,42.2,-110.5,'Temperature',65.6,'Pressure', 100.0)
mp = 
 2x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: [42 42.2000]
              Y: [-110 -110.5000]
    Temperature: [65 65.6000]
       Pressure: [0 100]

Pressure по умолчанию значение 0 автоматически добавляется к первой точке.

Создайте вектор геоформы, определяя динамический 'Temperature' свойство. 'Temperature' значения вводятся как массив ячеек так, чтобы они принадлежали одной функции. Этот вектор имеет одну функцию с тремя вершинами.

lat1 = [42, 42.2, 43];
lon1 = [-110, -110.3, -110.5];
temp1 = {[65, 65.1, 65.2]};
s = geoshape(lat1,lon1,'Temperature',temp1)
s = 
 1x1 geoshape vector with properties:

 Collection properties:
       Geometry: 'line'
       Metadata: [1x1 struct]
 Vertex properties:
       Latitude: [42 42.2000 43]
      Longitude: [-110 -110.3000 -110.5000]
    Temperature: [65 65.1000 65.2000]

Добавьте три точки в вектор геоформы, включая два новые динамические свойства 'Precipitation' и 'CloudCover'. Значения широты и долготы добавляются как двухэлементный массив ячеек, таким образом, две опции добавляются к вектору геоформы. Обратите внимание на то, что 'Temperature' и 'Precipitation' значения заданы как двухэлементные векторы, в то время как новый 'CloudCover' значения заданы как массив ячеек с одним элементом.

lat2 = {[50 50.2],60};
lon2 = {[-120 -121],-130};
temp2 = [60.2 60.4];
precip = [0.07 0.19];
cloud = {[20,80]};
s2 = append(s,lat2,lon2,'Temperature',temp2,'Precipitation',precip,'CloudCover',cloud)
s2 = 
 3x1 geoshape vector with properties:

 Collection properties:
         Geometry: 'line'
         Metadata: [1x1 struct]
 Vertex properties:
  (3 features concatenated with 2 delimiters)
         Latitude: [42 42.2000 43 NaN 50 50.2000 NaN 60]
        Longitude: [-110 -110.3000 -110.5000 NaN -120 -121 NaN -130]
      Temperature: [65 65.1000 65.2000 NaN 60.2000 0 NaN 60.4000]
       CloudCover: [0 0 0 NaN 20 80 NaN 0]
 Feature properties:
    Precipitation: [0 0.0700 0.1900]

Этот добавленный векторный s2 теперь имеет три функции, разделенные NaN, с некоторыми свойствами Vertex и некоторыми свойствами Feature. Две ячейки массивов ячеек широты и долготы формируют эти две недавно-дополнительных-функции, один с двумя вершинами и другим с одной вершиной. Начиная с 'Temperature' ранее определялся как свойство Vertex в s, новый 'Temperature' значения добавляются как свойства Vertex. 'Temperature' значение одной новой точки не было присвоено, таким образом, это установлено в значение по умолчанию 0.

Однако новый 'Precipitation' и 'CloudCover' свойства определяются как свойство Vertex или Feature, какой бы ни более подходит для формата значения. 'Precipitation' значения введены как двухэлементный вектор, таким образом, они присвоены как свойства Feature, где каждый элемент precip2 принадлежит отдельной функции вектора геоформы. Начиная с 'CloudCover' значения введены как массив ячеек, значения должны принадлежать той же функции, таким образом, они установлены как свойства Vertex, соответствующие первой дополнительной функции. Никакой 'CloudCover' значения были заданы для второй дополнительной функции, таким образом, вершины во второй функции присвоены значение по умолчанию 0. Наконец, 'Precipitation' и 'CloudCover' значения для исходной функции установлены к значению по умолчанию 0.

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

свернуть все

Введите географический или плоский вектор в виде geopoint, geoshape, mappoint, или mapshape объект.

Значения широты в виде числового скаляра или вектора.

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

Значения долготы в виде числового скаляра или вектора.

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

Плоский x - координирует в виде числового скаляра или вектора.

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

Плоский y - координирует в виде числового скаляра или вектора.

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

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

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

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

  • Когда value массив ячеек, append добавляет свойство как свойство Vertex.

  • Когда value числовой массив, append добавляет свойство как свойство Feature.

  • Когда value пусто, append удаляет свойство.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | cell

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

свернуть все

Выведите географический или плоский вектор, возвращенный как geopoint, geoshape, mappoint, или mapshape объект. Тип объекта vout совпадает с типом объекта vin.

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

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