Convert spherical distance from radians to statute miles

## Syntax

``sm = rad2sm(rad)``
``sm = rad2sm(rad,radius)``
``sm = rad2sm(rad,sphere)``

## Description

````sm = rad2sm(rad)` converts distances from radians to statute miles, as measured along a great circle on a sphere with a radius of 3958.748 sm, the mean radius of the Earth.```
````sm = rad2sm(rad,radius)` converts distances from radians to statute miles, as measured along a great circle on a sphere having the specified radius.```

example

````sm = rad2sm(rad,sphere)` converts distances from radians to statute miles, as measured along a great circle on a sphere approximating an object in the Solar System.```

## Examples

collapse all

How long is a trip around the equator in statute miles?

`sm = rad2sm(2*pi)`
```sm = 2.4874e+04 ```

How about on Jupiter?

`sm = rad2sm(2*pi,'jupiter')`
```sm = 2.7283e+05 ```

## Input Arguments

collapse all

Distance in radians, specified as a numeric array.

Data Types: `single` | `double`

Radius of sphere in units of statute miles, specified as a numeric scalar.

Sphere approximating an object in the Solar System, specified as one of the following values: `'sun'`, `'moon'`, `'mercury'`, `'venus'`, `'earth'`, `'mars'`, `'jupiter'`, `'saturn'`, `'uranus'`, `'neptune'`, or `'pluto'`. The value of `sphere` is case-insensitive.

## Output Arguments

collapse all

Distance in statute miles, returned as a numeric array.

Data Types: `single` | `double`

## Version History

Introduced in R2007a