# sardispgrazang

Display grazing angle for SAR data collection

## Syntax

``dgrazang = sardispgrazang(pos)``
``dgrazang = sardispgrazang(pos,slope)``
``dgrazang = sardispgrazang(pos,slope,axes)``

## Description

example

````dgrazang = sardispgrazang(pos)` returns the display grazing angle, `dgrazang`, of an image defined at the aperture reference point.```

example

````dgrazang = sardispgrazang(pos,slope)` specifies the slope angle for the image display plane.```

example

````dgrazang = sardispgrazang(pos,slope,axes)` specifies the antenna phase center traveling axis.```

## Examples

collapse all

Compute the grazing angle of a SAR image projected on the image display plane of an antenna phase center located at `[1000,2000,5000]` meters with respect to a scene centered at `[10,10,10]` meters. Assume the slope angle for the image display plane is ${30}^{\circ }$.

```pos1 = [1000;2000;5000]; pos2 = [10;10;10]; rngvec = pos1-pos2; slope = 30;```

Compute the image grazing angle.

`dgrazang = sardispgrazang(rngvec,slope)`
```dgrazang = 27.3352 ```

## Input Arguments

collapse all

Measured line of sight vector from the scene center to the antenna phase center, specified as a 3-by-N matrix in meters. Each column of `pos` represents a measured line-of-sight position. The geometric location of the antenna phase center at the center of the processing aperture is the aperture reference point. The antenna phase center serves as the reference point for the phase history of the received signal.

Example: `[1000;2000;5000]`

Data Types: `double`

Slope angle, specified as a scalar between 0 and 90°. The slope angle is the angle between the image display plane and the scene center plane.

Data Types: `double`

Antenna phase center traveling axis, specified as `'x'`, `'y'`, or `'z'`.

• `'x'` — The antenna phase center travels in the x-direction and the surface plane is the xy-plane.

• `'y'` — The antenna phase center travels in the y-direction and the surface plane is the yz-plane.

• `'z'` — The antenna phase center travels in the z-direction and the surface plane is the zx-plane.

Data Types: `double`

## Output Arguments

collapse all

Display grazing angle, returned as a 1-by-N row vector in degrees. The display grazing angle is the angle between the vertical projections of the slant range vector onto the image display plane and the scene center plane. The image display plane is the plane onto which the image formation processor projects the scatterers in a 3-D scene.

## Version History

Introduced in R2021a