slant2range

Convert slant range to propagated range

Since R2022b

Syntax

r = slant2range(sr,anht,tgtht)

r = slant2range(sr,anht,tgtht,Name=Value)

[r,el,k] = slant2range(sr,anht,tgtht,___)

Description

r = slant2range(sr,anht,tgtht) returns the propagated range r between a target and sensor as a function of the true target slant range sr, antenna height anht, and target height tgtht. Propagated range is the actual curved path range caused by atmospheric refraction. Slant range is the geometric range between target and sensor. The range computation assumes a Curved Earth Model where the atmospheric model is the CRPL exponential reference atmosphere with a refractivity of 313 N-units and a refraction exponent (decay constant) of 0.143859/km. The exponential atmosphere models refraction for elevation angles greater than approximately 10 millirad (about 0.573 degrees) and heights above approximately 1 km.

example

r = slant2range(sr,anht,tgtht,Name=Value) specifies additional inputs using name-value pair arguments.

[r,el,k] = slant2range(sr,anht,tgtht,___) also returns the target elevation el and the effective earth radius factor k.

If the outputs are returned as r = NaN, el = NaN, and k = 1, then the propagation path does not exist or cannot be computed with the specified sr, anht, and tgtht arguments.

example

Examples

collapse all

Calculate Propagated Range using Default Parameters

Open Live Script

Calculate the propagated range from a slant range of 100 km, antenna height of 1 km, and target height of 2 km. Use default parameter values.

R = slant2range(100000,1000,2000)

R = 
1.0001e+05

Calculate Propagated Range with Effective Earth Radius

Open Live Script

Compute the range between an antenna and a target. Start with a slant range of 250 km, an antenna height of 1 km, and target height of 5 km. Using the default 'Curved' Method, set an effective earth radius factor of 1.2.

Re = physconst('EarthRadius');
effactor = 1.2;
R = slant2range(250000,1000,5000,'EffectiveEarthRadius',effactor*Re)

R = 
2.5002e+05

Verify Target Height Calculation

Open Live Script

Calculate the propagated range and elevation angle of a target at a slant range of 300 km, an antenna height of 100 m, and target height of 5 km. Use the CRPL method and assume the surface refractivity is equal to 400 N-units. From the calculated propagated range and elevation angle, convert back to target height. Verify that the estimated target height from the range2height function matches the expected 5 km.

sr = 300000;
ha = 100;
ht = 5000;
Ns = 400;
rexp = refractionexp(Ns);

Calculate propagated range and elevation angle.

[R,el] = slant2range(sr,ha,ht,'Method','CRPL', ...
        'SurfaceRefractivity',Ns,'RefractionExponent',rexp)

R = 
3.0009e+05

el = 
0.1286

Convert propagated range and elevation angle back to target height. Verify that calculated value matches 5000 meters.

htest = range2height(R,ha,el,'Method','CRPL', ...,
    'SurfaceRefractivity',Ns,'RefractionExponent',rexp)

htest = 
5.0000e+03

Compare Effective Earth Radius Factors

Open Live Script

Compare the effective Earth radius factors calculated from the CRPL, the average radius of curvature, and 4/3 Earth models. Assume the slant range is 100000 m, the antenna heights range from 1 to 10 km, and the target is on the surface at zero altitude.

sr = 100000;
ha = linspace(1,10,50).*1000;
ht = 200;
[~,kAvgCurv] = effearthradius(sr,ha,ht);
[~,~,kCRPL] = slant2range(sr,ha,ht,'Method','CRPL');

Plot the effective earth radius factor as a function of antenna height.

plot(ha*1e-3,kCRPL)
hold on
plot(ha*1e-3,kAvgCurv)
yline(4/3,'--k')
grid on
legend('CRPL','Average Curvature','4/3 Earth')
ylabel('Effective Earth radius factor k')
xlabel('Antenna height (km)')

Figure contains an axes object. The axes object with xlabel Antenna height (km), ylabel Effective Earth radius factor k contains 3 objects of type line, constantline. These objects represent CRPL, Average Curvature, 4/3 Earth.

Input Arguments

collapse all

`sr` — True slant range
scalar | real-valued length-M row vector

True slant range, specified as a scalar or length-M real-valued row vector. If sr is a vector, it must have the same size as the other vector input arguments, anht and tgtht. Units are in meters.

Example: 5000.0

Data Types: double

`anht` — Sensor height
nonnegative real-valued scalar | nonnegative real-valued vector

Sensor height in meters, specified as a nonnegative real-valued scalar or vector. If anht is a vector, it must have the same size as the other vector input arguments of slant2range. Heights are referenced to the ground.

Data Types: double

`tgtht` — Target height
nonnegative real-valued scalar | nonnegative real-valued vector

Target height in meters, specified as a nonnegative real-valued scalar or vector. If tgtht is a vector, it must have the same size as the other vector input arguments of slant2range. Heights are referenced to the ground.

Data Types: double

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.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: Method="CRPL",SurfaceRefractivity=300,RefractionExponent=0.15

`Method` — Earth model
`"Curved"` (default) | `"CRPL"`

Earth model used for computation, specified as "Curved" or "CPRL".

"Curved" — Assumes a Curved Earth Model with a 4/3 effective Earth radius a commonly used approximation for modeling refraction effects in the troposphere. To specify another value for the effective Earth radius, use the EffectiveEarthRadius name-value pair argument.
"CRPL" — Assumes a curved Earth model with the atmosphere defined by the CRPL Exponential Reference Atmosphere Model with a refractivity of 313 N-units and a refraction exponent of 0.143859 km^–1. To specify other values for the refractivity and the refraction exponent, use the SurfaceRefractivity and RefractionExponent name-value arguments. This method requires that el be positive. For more information, see CRPL Model Geometry.

Data Types: char | string

`EffectiveEarthRadius` — Effective Earth radius
4/3 of Earth's radius (default) | positive scalar

Effective Earth radius, specified as a positive scalar. If this argument is not specified, slant2range calculates the effective Earth radius using a refractivity gradient of –39 × 10^–9 N-units/meter, which results in approximately 4/3 of the real Earth radius. Units are in meters.

Dependencies

To enable this argument, set the Method name-value pair argument to "Curved".

Data Types: double

`SurfaceRefractivity` — Surface refractivity
`313` (default) | nonnegative scalar

Surface refractivity in N-units, specified as a nonnegative scalar. The surface refractivity is a parameter of the CRPL Exponential Reference Atmosphere Model used by slant2range. This quantity is dimensionless.

Dependencies

To enable this argument, set the Method name-value pair argument to "CRPL".

Data Types: double

`RefractionExponent` — Refraction exponent
`0.143859` (default) | nonnegative scalar

Refraction exponent, specified as a nonnegative scalar. The refraction exponent is a parameter of the CRPL Exponential Reference Atmosphere Model used by slant2range. This quantity is dimensionless.

Dependencies

To enable this argument, set the Method name-value pair argument to "CRPL".

Data Types: double

`MaxNumIterations` — Maximum number of iterations for the CRPL method
`10` (default) | nonnegative integer

Maximum number of iterations for the CRPL method, specified as a nonnegative integer. This input acts as a safeguard to preempt long iterative calculations.

If MaxNumIterations is set to 0, slant2range performs a faster but less accurate non-iterative CRPL calculation. The non-iterative calculation has a maximum height error of 0.056388 m (0.185 ft) at a target height of 30,480 m (100,000 ft) and an elevation angle of 0. The height error for the non-iterative method decreases with decreasing target height and increasing elevation angle. This quantity is dimensionless.

Dependencies

To enable this argument, set the Method name-value pair argument to "CRPL".

Data Types: double

`Tolerance` — Numerical tolerance for the CRPL method
`1e-6` (default) | positive scalar

Numerical tolerance for the CRPL method, specified as a positive scalar. The iterative process terminates when the numerical tolerance is achieved.

Dependencies

To enable this argument, set the Method name-value pair argument to "CRPL" and set the MaxNumIterations name-value pair argument to be greater than 0. This quantity is dimensionless.

Data Types: double

Output Arguments

collapse all

`r` — Target range
scalar | real-valued length-M row vector

Target range, returned as a scalar or real-valued length-M row vector. If r is a vector, it has the same size as the vector input arguments of slant2range. Units are in meters.

Data Types: double

`el` — Elevation angle
scalar | real-valued length-M row vector

Elevation angle, returned as a scalar or real-valued length-M row vector. Units are in degrees.

Data Types: double

`k` — Effective earth radius factor
scalar | real-valued length-M row vector

Effective earth radius factor, returned as a scalar or real-valued length-M row vector. This quantity is dimensionless.

Data Types: double

More About

collapse all

Curved Earth Model

The fact that the index of refraction of air depends on height can be treated approximately by using an effective Earth's radius larger than the actual value.

Given the effective Earth's radius R₀, the antenna height h_a, and the initial elevation angle θ₀, the model relates the target height h_T and the slant range R_T by

${(R_{0} + h_{T})}^{2} = {(R_{0} + h_{a})}^{2} + R_{T}^{2} + 2 R_{T} (R_{0} + h_{a}) \sin θ_{0},$

so knowing one of those magnitudes enables you to compute the other. In particular,

$h_{T} = \sqrt{{(R_{0} + h_{a})}^{2} + R_{T}^{2} + 2 R_{T} (R_{0} + h_{a}) \sin θ_{0}} - R_{0} .$

The actual range R is equal to the slant range. The true elevation angle θ_T is equal to the initial elevation angle.

To compute the ground range G, use

$G = R_{0} ϕ = R_{0} \arcsin \frac{R_{T} \cos θ_{0}}{R_{0} + h_{T}} .$

A standard propagation model uses an effective Earth's radius that is 4/3 times the actual value. This model has two major limitations:

The model implies a value for the index of refraction near the Earth's surface that is valid only for certain areas and at certain times of the year. To mitigate this limitation, use an effective Earth's radius based on the near-surface refractivity value.
The model implies a value for the gradient of the index of refraction that is unrealistically low at heights of around 8 km. To partially mitigate this limitation, use an effective Earth's radius based on the platform altitudes.

For more information, see effearthradius.

CRPL Exponential Reference Atmosphere Model

Atmospheric refraction evidences itself as a deviation in an electromagnetic ray from a straight line due to variation in air density as a function of height. The Central Radio Propagation Laboratory (CRPL) exponential reference atmosphere model treats refraction effects by assuming that the index of refraction n(h) and the refractivity N decay exponentially with height. The model defines

$N = (n (h) - 1) \times 10^{6} = N_{s} e^{- R_{exp} h},$

where N_s is the atmospheric refractivity value (in units of 10^–6) at the surface of the earth, R_exp is the decay constant, and h is the height above the surface in kilometers. Thus

$n (h) = 1 + (N_{s} \times 10^{- 6}) e^{- R_{exp} h} .$

The default value of N_s is 313 N-units and can be modified using the SurfaceRefractivity name-value argument in functions that accept it. The default value of R_exp is 0.143859 km^–1 and can be modified using the RefractionExponent name-value argument in functions that accept it.

CRPL Model Geometry

When the refractivity of air is incorporated into the curved Earth model, the ray paths do not follow a straight line but curve downward. (This statement assumes standard atmospheric propagation and nonnegative elevation angles.) The true elevation angle $\theta_T$ is different from the initial $\theta_0$ . The actual range $R$ , which is the distance along the curved path $R'$ , is different from the slant range $R_T$ .

Given the Earth's radius $R_0$ , the antenna height $h_a$ , the initial elevation angle $\theta_0$ , and the height-dependent index of refraction $n(h)$ with value $n_0$ at $h=0$ , the modified model relates the target height $h_T$ and the actual range $R$ by

$R=\int_0^{h_T-h_a}{n(h)\,dh}\,
 \left({{1-\left(\frac{\textstyle n_0\cos\theta_0}{\textstyle
 n(h)\left(1+\frac{\textstyle h}{\textstyle
 R_0+h_a}\right)}\right)^2}}\right)^{-1/2}.
$

When Method is specified as "CRPL", the integral is solved using $n(h)$ from CRPL Exponential Reference Atmosphere Model.

To compute the ground range $G$ , use

$G=\int_0^{h_T-h_a}\frac{dh}{1+\frac{\textstyle h}{\textstyle
R_0+h_a}}\, \left({{\left(\frac{\textstyle n(h)\left(1+\frac{\textstyle
h}{\textstyle
 R_0+h_a}\right)}{\textstyle
 n_0\cos\theta_0}\right)^2}}-1\right)^{-1/2}.
$

N-units

N-units are a convenient way to express the index of refraction. Because the index of refraction is very close to unity, N-units express just the deviation from unity. The refractivity N in N-units is related to the index of refraction n by

$N = (n - 1) \times 10^{6} .$

For example, an index of refraction of 1.000313 becomes 313 in N-units. N-units are dimensionless.

References

[1] Barton, David K. Radar Equations for Modern Radar. Norwood, MA: Artech House, 2013.

[2] Bean, B.R., and G.D. Thayer. "Central Radio Propagation Laboratory Exponential Reference Atmosphere." Journal of Research of the National Bureau of Standards, Section D: Radio Propagation 63D, no. 3 (November 1959): 315. https://doi.org/10.6028/jres.063D.031.

[3] Blake, Lamont V. "Ray Height Computation for a Continuous Nonlinear Atmospheric Refractive-Index Profile." Radio Science 3, no. 1 (January 1968): 85–92. https://doi.org/10.1002/rds19683185.

slant2range

Syntax

Description

Examples

Calculate Propagated Range using Default Parameters

Calculate Propagated Range with Effective Earth Radius

Verify Target Height Calculation

Compare Effective Earth Radius Factors

Input Arguments

sr — True slant range scalar | real-valued length-M row vector

anht — Sensor height nonnegative real-valued scalar | nonnegative real-valued vector

tgtht — Target height nonnegative real-valued scalar | nonnegative real-valued vector

Name-Value Arguments

Method — Earth model "Curved" (default) | "CRPL"

EffectiveEarthRadius — Effective Earth radius 4/3 of Earth's radius (default) | positive scalar

Dependencies

SurfaceRefractivity — Surface refractivity 313 (default) | nonnegative scalar

Dependencies

RefractionExponent — Refraction exponent 0.143859 (default) | nonnegative scalar

Dependencies

MaxNumIterations — Maximum number of iterations for the CRPL method 10 (default) | nonnegative integer

Dependencies

Tolerance — Numerical tolerance for the CRPL method 1e-6 (default) | positive scalar

Dependencies

Output Arguments

r — Target range scalar | real-valued length-M row vector

el — Elevation angle scalar | real-valued length-M row vector

k — Effective earth radius factor scalar | real-valued length-M row vector

More About

Curved Earth Model

CRPL Exponential Reference Atmosphere Model

CRPL Model Geometry

N-units

References

Extended Capabilities

C/C++ Code Generation Generate C and C++ code using MATLAB® Coder™.

Version History

See Also

Apps

Functions

Topics

`sr` — True slant range
scalar | real-valued length-M row vector

`anht` — Sensor height
nonnegative real-valued scalar | nonnegative real-valued vector

`tgtht` — Target height
nonnegative real-valued scalar | nonnegative real-valued vector

`Method` — Earth model
`"Curved"` (default) | `"CRPL"`

`EffectiveEarthRadius` — Effective Earth radius
4/3 of Earth's radius (default) | positive scalar

`SurfaceRefractivity` — Surface refractivity
`313` (default) | nonnegative scalar

`RefractionExponent` — Refraction exponent
`0.143859` (default) | nonnegative scalar

`MaxNumIterations` — Maximum number of iterations for the CRPL method
`10` (default) | nonnegative integer

`Tolerance` — Numerical tolerance for the CRPL method
`1e-6` (default) | positive scalar

`r` — Target range
scalar | real-valued length-M row vector

`el` — Elevation angle
scalar | real-valued length-M row vector

`k` — Effective earth radius factor
scalar | real-valued length-M row vector

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.