# height

Height of surface in tracking scenario

Since R2022a

## Syntax

``h = height(surface,positions)``

## Description

example

````h = height(surface,positions)` returns the heights of the surface at the specified positions.```

## Examples

collapse all

Create a tracking scenario object.

`scene = trackingScenario;`

Specify the terrain as `magic(4)` and define the boundary of the terrain as a square.

`terrain = magic(4)`
```terrain = 4×4 16 2 3 13 5 11 10 8 9 7 6 12 4 14 15 1 ```
`boundary = [0 100; 0 100];`

Create the ground surface and add it to the scenario.

`surface = groundSurface(scene,Terrain=terrain,Boundary=boundary)`
```surface = GroundSurface with properties: Terrain: [4x4 double] ReferenceHeight: 0 Boundary: [2x2 double] ```

Get the heights of the surface at the center and its four corners.

`h0 = height(surface,[50 50]')`
```h0 = 8.5000 ```
`h1 = height(surface,[0 0]')`
```h1 = 16 ```
`h2 = height(surface,[100 0]')`
```h2 = 13 ```
`h3 = height(surface,[0 100]')`
```h3 = 4 ```
`h4 = height(surface,[100 100]')`
```h4 = 1 ```

## Input Arguments

collapse all

Ground surface, specified as a `GroundSurface` object.

Positions of the surface to query, specified as a 2-by-N matrix of real values or a 3-by-N matrix of real values, where N is the number of positions.

If the `IsEarthCentered` property of the tracking scenario is specified as:

• `false` — Each column of a 2-by-N matrix represents the x- and y-coordinates of a position in meters. Each column of a 3-by-N matrix represents the x-, y-, and z-coordinates of a position in meters. Note that the z-coordinate is irrelevant for surface height querying.

• `true` — Each column of the 2-by-N matrix represents the latitude and longitude of a position in degrees, in the geodetic frame. Each column of the 3-by-N matrix represents the latitude in degrees, longitude in degrees, and altitude in degrees of a position, in the geodetic frame. Note that the altitude is irrelevant for surface height querying.

## Output Arguments

collapse all

Heights of queried positions, returned as an N-element vector of real values in meters, where N is the number of queried positions.

## Version History

Introduced in R2022a