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. The 'Temperature' значение новых точек по умолчанию устанавливается равным 0, поскольку во время вызова не было задано значение append. Вектор mapshape вырос с 1x1 до 2x1 в длину, потому что количество функций увеличилось.

Создайте вектор madboint с динамическим свойством 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]

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

Создайте вектор геошапы, обозначив динамический 'Temperature' свойство. The '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' значения добавляются как свойства вершины. The 'Temperature' значение одной новой точки не было назначено, поэтому значение по умолчанию устанавливается равным 0.

Однако новая 'Precipitation' и 'CloudCover' свойства обозначаются как свойство Vertex или функция, в зависимости от того, что больше подходит для формата значения. '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