rmprop

Remove property from geographic or planar vector

collapse all in page

Syntax

vout = rmprop(vin,name)
vout = rmprop(vin,names)

Description

example

vout = rmprop(vin,name) removes the property specified by name from the geographic or planar vector vin.

example

vout = rmprop(vin,names) removes all properties specified by names from vin.

Note

rmprop cannot remove Metadata, and Geometry properties from any geographic or planar vector. Further, it cannot remove Latitude and Longitude properties from geopoint and geoshape objects, nor X and Y properties from mappoint and mapshape objects.

Examples

collapse all

Open Live Script

Create a geoshape vector with dynamic properties.

gs = geoshape(shaperead('worldcities', 'UseGeo', true))
gs = 
 318x1 geoshape vector with properties:

 Collection properties:
     Geometry: 'point'
     Metadata: [1x1 struct]
 Vertex properties:
  (318 features concatenated with 317 delimiters)
     Latitude: [1x635 double]
    Longitude: [1x635 double]
 Feature properties:
         Name: {1x318 cell}

Remove only the Name property from the geoshape vector.

gs2 = rmprop(gs,'Name')
gs2 = 
 318x1 geoshape vector with properties:

 Collection properties:
     Geometry: 'point'
     Metadata: [1x1 struct]
 Vertex properties:
  (318 features concatenated with 317 delimiters)
     Latitude: [1x635 double]
    Longitude: [1x635 double]
Open Live Script

Create a mappoint vector.

mp = mappoint(-33.961,18.484,'Name','Cape Town','Temperature',64)
mp = 
 1x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: -33.9610
              Y: 18.4840
           Name: 'Cape Town'
    Temperature: 64

Attempt to remove multiple properties from the mappoint vector.

s2 = rmfield(mp,{'X','Name','temperature'})
s2 = 
 1x1 mappoint vector with properties:

 Collection properties:
       Geometry: 'point'
       Metadata: [1x1 struct]
 Feature properties:
              X: -33.9610
              Y: 18.4840
    Temperature: 64

The Name property has been removed successfully. Note that the X property still exists because it cannot be removed. Also, the Temperature property still exists because property names are case-sensitive.

Input Arguments

collapse all

Input geographic or planar vector, specified as a geopoint, geoshape, mappoint, or mapshape object.

Name of a single property to remove, specified as a character vector. The character vector is case sensitive.

Name of multiple properties to remove, specified as a cell array of character vectors. The character vectors are case-sensitive.

Output Arguments

collapse all

Output geographic or planar vector, returned as a geopoint, geoshape, mappoint, or mapshape object. The object type of vout matches the object type of vin.

See Also

| |

Introduced in R2012a

Mapping Toolbox Documentation

Support