geoframe

R2026b

Create geographic reference frame

Since R2026b

collapse all in page

    Syntax

    refframe = geoframe
    refframe = geoframe(Name=Value)

    Description

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

    refframe = geoframe creates a reference frame object that describes a geographic coordinate system. The object uses the World Geodetic System of 1984 (WGS84) ellipsoid, no terrain, and the east-north-up (ENU) axes convention.

    refframe = geoframe(Name=Value) creates the reference frame using options specified by one or more name-value arguments.

    Name-Value Arguments

    collapse all

    Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

    Example: geoframe(Terrain="gmted2010") creates a geographic reference frame with height values referenced to GMTED2010.

    Terrain name, represented as one of these values:

    • "none" — No terrain. Heights are referenced to the WGS84 ellipsoid.

    • "gmted2010" — Tiled global terrain derived from the GMTED2010 model by the U.S. Geological Survey (USGS) and National Geospatial-Intelligence Agency (NGA) and hosted by MathWorks®. Internet access is required to use "gmted2010".

    • String scalar or character vector — Name of custom terrain added using the addCustomTerrain function.

    This value sets the Terrain field of the structure array that is stored in the Datum property of the reference frame object.

    Data Types: char | string

    Descriptive name, specified as a string scalar or character vector.

    This argument sets the Name property of the reference frame object.

    Data Types: char | string

    Axes convention, specified as one of these values:

    • "enu" — East-north-up (ENU)

    • "ned" — North-east-down (NED)

    This argument defines the order of the orientation and motion vectors. For more information about axes conventions, see Specify Coordinate Conventions for 3D Scenarios.

    This argument sets the AxesConvention property of the reference frame object.

    Output Arguments

    collapse all

    Geographic reference frame, returned as a ReferenceFrame object.

    For a geographic reference frame:

    • Position values are of the form [lat lon h], where lat is latitude in degrees, lon is longitude in degrees, and h is height in meters.

    • Orientation and motion vectors are interpreted in either an ENU or north-east-down (NED) local coordinate system with the origin at [lat lon h].

    • Height values are referenced to the value specified by Terrain.

    This table describes the property values of the reference frame created by this function.

    PropertyValue
    Name"World Geodetic System 1984 (WGS84) Frame"
    ReferenceBody"Earth"
    Datum

    A structure array with these fields and values:

    • PrimeMeridian — Prime meridian, returned as 0.

    • Spheroid — WGS84 ellipsoid, returned as a referenceEllipsoid object.

    • Terrain — Name of terrain, returned as "none".

    CoordinateSystem"geographic"
    AxesConvention"enu"

    Version History

    Introduced in R2026b

    See Also

    Functions

    Objects

    Topics