pointtable

R2026b

Create geospatial table from points and height reference

Since R2026b

collapse all in page

    Syntax

    PT = pointtable(lat,lon)
    PT = pointtable(lat,lon,ht)
    PT = pointtable(lat,lon,ht,refsource)
    PT = pointtable(___,HeightReference=heightref)

    Description

    Add-On Required: This feature requires the 3D Scenarios add-on.

    PT = pointtable(lat,lon) creates a geospatial table containing 2D points at the specified latitude and longitude coordinates. This syntax clamps the points to the terrain.

    PT = pointtable(lat,lon,ht) creates a geospatial table containing 3D points at the specified latitude, longitude, and height coordinates. This syntax assumes that the height values are referenced to the terrain.

    PT = pointtable(lat,lon,ht,refsource) specifies the reference source for the height coordinates. This syntax creates a geospatial table with height values referenced to the ellipsoid. This syntax is useful for querying the terrain or surface heights of points in a scene.

    PT = pointtable(___,HeightReference=heightref) specifies the height reference to use in the output geospatial table in addition to any combination of input arguments from previous syntaxes.

    Input Arguments

    collapse all

    Latitude, in degrees, specified as a scalar or vector with elements in the range [–90, 90].

    The length of lat must match the length of lon.

    When ht is a vector, lat must be a scalar or the same size as ht. If lat is a scalar, the function applies the same latitude value to each element of ht.

    Data Types: double

    Longitude, in degrees, specified as a scalar or vector.

    The length of lon must match the length of lat.

    When ht is a vector, lon must be a scalar or the same size as ht. If lon is a scalar, the function applies the same longitude value to each element of ht.

    Data Types: double

    Height, in meters, specified as a scalar or as a vector. By default, the height reference for the points is the terrain. Specify the height reference as the surface or the ellipsoid by using the heightref argument.

    When lat is a vector, ht must be a scalar or the same size as lat. If ht is a scalar, the function applies the same height value to each point.

    Data Types: double

    Reference source for the ht argument, specified as a Scene object. The pointtable function uses the terrain and buildings in the scene to perform a height datum transformation. When you specify this argument, the 3D points in the output geospatial table specify ellipsoidal heights.

    Height reference, specified as one of these values:

    • "terrain" — Height values for 3D points are relative to the ground. 2D points are clamped to the ground.

    • "surface" — Height values are relative to the surface of the scenario, which includes terrain and buildings. 2D points are clamped to the surface.

    • "ellipsoid" — Height values for 3D points are relative to the WGS84 ellipsoid. This option requires 3D points.

    The pointtable function encodes the height reference using the GeographicCRS property of the geopointshape objects that are stored in the geospatial table.

    Output Arguments

    collapse all

    Point table, returned as a geospatial table containing geopointshape objects. Each row of the table represents one point. The table stores geopointshape objects in the Shape variable.

    The coordinate reference system for the points, including the height reference, is stored in the GeographicCRS property of the geopointshape objects.

    Version History

    Introduced in R2026b

    See Also

    Topics