добавление

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

Синтаксис

vout = append(vin,lat,lon)
vout = append(vin,x,y)
vout = append(___,field,value)

Описание

пример

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