uavWindTurbulence

Generate wind turbulence for UAV platform with discretized Von Kármán velocity spectra

Since R2024a

Description

The uavWindTurbulence value object uses the discretized Von Kármán spectral representation to generate turbulence for a UAV platform by passing band-limited white noise through appropriate forming filters. You can choose the mathematical representation of the Von Kármán turbulence from US Military Specification MIL-F-8785C, MIL-HDBK-1797, and MIL-HDBK-1797B. For more information, see Algorithms.

The object discretizes the Von Kármán spectral representation with a rate similar to the UAV scenario UpdateRate property. To simulate wind turbulence in a UAV scenario:

Create the uavWindTurbulence object and set its properties.
Attach the wind model to a UAV platform by using the addWind function.
Obtain the wind velocity from the UAV scenario by using the windVelocity function, and the wind angular rate using the windAngularRate while the UAV scenario is running.

Note

Simulating a UAV scenario that contains a uavWindTurbulence object requires Aerospace Toolbox.

Creation

Syntax

turbulenceWind = uavWindTurbulence

turbulenceWind = uavWindTurbulence(Name=Value)

Description

turbulenceWind = uavWindTurbulence creates a wind turbulence object with default property values.

turbulenceWind = uavWindTurbulence(Name=Value) specifies properties using one or more name-value arguments. For example, uavWindTurbulence(StartTime=10) sets the wind start time to 10 seconds.

example

Properties

expand all

You can modify these value object properties before you add the uavWindTurbulence value object to the UAV platform using addWind function.

`StartTime` — Wind start time
`0` (default) | nonnegative scalar

Wind start time, specified as a nonnegative scalar. This value is relative to the simulation start time of the UAV scenario. Units are in seconds

Example: 2

Data Types: double

`StopTime` — Wind stop time
`Inf` (default) | nonnegative scalar

Wind stop time, specified as a nonnegative scalar. This value is relative to the simulation start time of the UAV scenario. If specified as inf, the wind gust continues until the UAV scenario simulation ends. Units are in seconds

Example: 5

Data Types: double

`Specification` — Military reference
`"MIL-F-8785C"` (default) | `"MIL-HDBK-1797"` | `"MIL-HDBK-1797B"`

Military reference, specified as"MIL-F-8785C", "MIL-HDBK-1797", or "MIL-HDBK-1797B". The military reference affects the application of turbulence scale lengths in the lateral and vertical directions.

`ModelType` — Angular rate signs
"Von Karman (+q +r)" (default) | "Von Karman (+q -r)" | "Von Karman (-q +r)"

Angular rate signs, specified as one of these options:

"Von Karman (+q +r)" — Positive vertical and lateral angular rate spectra.
"Von Karman (+q -r)" — Positive vertical and negative lateral angular rate spectra.
"Von Karman (-q +r)" — Negative vertical and positive lateral angular rate spectra.

Data Types: string

`WindSpeedAt6m` — Wind speed at 6 meters above ground
`15` (default) | nonnegative scalar

Wind speed at a height of 6 meters above ground, specified as a nonnegative scalar in m/s.

Data Types: double

`WindDirectionAt6m` — Wind direction at 6 meters above ground
`0` (default) | nonnegative scalar

Wind direction at a height of 6 meters above ground, specified as a nonnegative in degrees clockwise from north.

Data Types: double

`ProbExceedanceHighAltitudeIntensity` — Probability of exceeding turbulence intensity
`"10^-2 - Light"` (default) | `"2x10^-1"` | `"10^-1"` | `"10^-3 - Moderate"` | `"10^-4"` | `"10^-5 - Severe"` | `"10^-6"`

Probability of the turbulence intensity being exceeded, specified as "2x10^-1", "10^-1", "10^-2 - Light", "10^-3 - Moderate", "10^-4", "10^-5 - Severe", or "10^-6"

Data Types: string

`ScaleLengthAtMediumHighAltitude` — Turbulence scale length
762 (default) | positive scalar

Turbulence scale length above 2000 feet, specified as a real scalar. This length is assumed constant.

Data Types: double

`WingSpan` — Wingspan
10 (default) | positive scalar

Wingspan, specified in meters.

Data Types: double

`BandLimitedNoiseSampleTime` — Noise sample time
0.1 (default) | positive scalar

Noise sample time at which the unit variance white noise signal is generated, specified in seconds.

Noise sample time must be an integer multiple of the scene sample time.

In MATLAB^®, the scene sample time is determined by UpdateRate property of uavScenario.
In Simulink^®, the scene sample time is determined by the Sample time property of UAV Scenario Configuration block

Data Types: double

`RandomNoiseSeeds` — Noise seeds
[23341 23342 23343 23344] (default) | vector of the form [u_g v_g w_g p_g]

Random noise seeds, specified as a vector of the form [u_g v_g w_g p_g] which generates the turbulence for each of the three velocity components and the roll rate.

Data Types: double

Examples

collapse all

Generate Turbulence Wind in UAV Scenario

Open Live Script

Create a UAV scenario with default parameters.

scene = uavScenario;

Create a UAV platform. Specify the trajectory to 80 meters north of scenario origin for 80 seconds.

distance = 80;
duration = 80;
platform = uavPlatform("UAV",scene,Trajectory=waypointTrajectory([0 0 -50;distance 0 -50],[0 duration]));

Create a turbulence wind object which starts at 20 seconds. Add the wind object to the UAV platform.

turbulenceWind = uavWindTurbulence(StartTime=20, BandLimitedNoiseSampleTime=1/scene.UpdateRate);
addWind(platform,turbulenceWind);

Set up the scenario.

setup(scene);

% Create arrays of zeros to store longitudinal, horizontal, and vertical wind velocity
uw = zeros(scene.UpdateRate*duration, 1);
vw = zeros(scene.UpdateRate*duration, 1);
ww = zeros(scene.UpdateRate*duration, 1);

% Create arrays of zeros to store x position of the UAV
xpos = zeros(scene.UpdateRate*duration, 1);

% Start a counter index
idx = 1;

Run the scenario. Obtain the vertical wind velocity at each time step.

while scene.CurrentTime <= duration
    % Obtain resultant wind velocity
    vel = windVelocity(platform);
    
    % Obtain UAV position
    [motion,lla]=read(platform);
    
    % Obtain UAV X position
    xpos(idx) = motion(1);

    % Obtain wind velocities
    uw(idx) = vel(1);
    vw(idx) = vel(2);
    ww(idx) = vel(3);

    % Increment counter index
    idx = idx + 1;

    % Advance the scenario time step
    advance(scene);
end

Plot the wind velocities against distance.

tiledlayout(3,1)

nexttile
plot(xpos,uw)
title("Longitudinal Wind Velocity")
xlabel("Distance (m)")
ylabel("Wind Velocity (m/s)")

nexttile
plot(xpos,vw)
title("Lateral Wind Velocity")
xlabel("Distance (m)")
ylabel("Wind Velocity (m/s)")

nexttile
plot(xpos,ww)
title("Vertical Wind Velocity")
xlabel("Distance (m)")
ylabel("Wind Velocity (m/s)")

More About

expand all

Algorithms

According to the military references, turbulence is a stochastic process defined by velocity spectra. For an aircraft flying at a speed V through a frozen turbulence field with a spatial frequency of Ω radians per meter, the circular frequency ω is calculated by multiplying V by Ω. The following table displays the component spectra functions:

	MIL-F-8785C	MIL-HDBK-1797 and MIL-HDBK-1797B
Longitudinal
$H_{u} (s)$	$\frac{2 σ_{u}^{2} L_{u}}{π V} \cdot \frac{1}{{[1 + {(1.339 L_{u} \frac{ω}{V})}^{2}]}^{\frac{5}{6}}}$	$\frac{2 σ_{u}^{2} L_{u}}{π V} \cdot \frac{1}{{[1 + {(1.339 L_{u} \frac{ω}{V})}^{2}]}^{\frac{5}{6}}}$
$H_{p} (s)$	$\frac{σ_{w}^{2}}{V L_{w}} \cdot \frac{0.8 {(\frac{π L_{w}}{4 b})}^{\frac{1}{3}}}{1 + {(\frac{4 b ω}{π V})}^{2}}$	$\frac{σ_{w}^{2}}{2 V L_{w}} \cdot \frac{0.8 {(\frac{2 π L_{w}}{4 b})}^{\frac{1}{3}}}{1 + {(\frac{4 b ω}{π V})}^{2}}$
Lateral
$Φ_{v} (ω)$	$\frac{σ_{v}^{2} L_{v}}{π V} \cdot \frac{1 + \frac{8}{3} {(1.339 L_{v} \frac{ω}{V})}^{2}}{{[1 + {(1.339 L_{v} \frac{ω}{V})}^{2}]}^{\frac{11}{6}}}$	$\frac{2 σ_{v}^{2} L_{v}}{π V} \cdot \frac{1 + \frac{8}{3} {(2.678 L_{v} \frac{ω}{V})}^{2}}{{[1 + {(2.678 L_{v} \frac{ω}{V})}^{2}]}^{\frac{11}{6}}}$
$Φ_{r} (ω)$	$\frac{\mp {(\frac{ω}{V})}^{2}}{1 + {(\frac{3 b ω}{π V})}^{2}} \cdot Φ_{v} (ω)$	$\frac{\mp {(\frac{ω}{V})}^{2}}{1 + {(\frac{3 b ω}{π V})}^{2}} \cdot Φ_{v} (ω)$
Vertical
$Φ_{w} (ω)$	$\frac{σ_{w}^{2} L_{w}}{π V} \cdot \frac{1 + \frac{8}{3} {(1.339 L_{w} \frac{ω}{V})}^{2}}{{[1 + {(1.339 L_{w} \frac{ω}{V})}^{2}]}^{\frac{11}{6}}}$	$\frac{2 σ_{w}^{2} L_{w}}{π V} \cdot \frac{1 + \frac{8}{3} {(2.678 L_{w} \frac{ω}{V})}^{2}}{{[1 + {(2.678 L_{w} \frac{ω}{V})}^{2}]}^{\frac{11}{6}}}$
$Φ_{q} (ω)$	$\frac{\pm {(\frac{ω}{V})}^{2}}{1 + {(\frac{4 b ω}{π V})}^{2}} \cdot Φ_{w} (ω)$	$\frac{\pm {(\frac{ω}{V})}^{2}}{1 + {(\frac{4 b ω}{π V})}^{2}} \cdot Φ_{w} (ω)$

The variable b represents the aircraft wingspan. The variables L_u, L_v, L_w represent the turbulence scale lengths. The variables σ_u, σ_v, σ_w represent the turbulence intensities. For more information, see Turbulence Scale Length and Intensities

Keep in mind that the longitudinal turbulence angular rate spectrum, Ф_p(ω), is a rational function. The rational function is derived from curve-fitting a complex algebraic function, not the vertical turbulence velocity spectrum, Ф_w(ω), multiplied by a scale factor.

The spectral density definitions of turbulence angular rates are defined in the references as three variations, which are displayed in the following table:

$p_{g} = \frac{\partial w_{g}}{\partial y}$	$q_{g} = \frac{\partial w_{g}}{\partial x}$	$r_{g} = - \frac{\partial v_{g}}{\partial x}$
$p_{g} = \frac{\partial w_{g}}{\partial y}$	$q_{g} = \frac{\partial w_{g}}{\partial x}$	$r_{g} = \frac{\partial v_{g}}{\partial x}$
$p_{g} = - \frac{\partial w_{g}}{\partial y}$	$q_{g} = - \frac{\partial w_{g}}{\partial x}$	$r_{g} = \frac{\partial v_{g}}{\partial x}$

The variations affect only the vertical (q_g) and lateral (r_g) turbulence angular rates.

The turbulence angular rate spectra has varying definitions because it contribute less to the aircraft gust response than the turbulence velocity spectra. The following table summarizes the combinations of vertical and lateral turbulence angular rate spectra.

Vertical	Lateral
Ф_q(ω) Ф_q(ω) −Ф_q(ω)	−Ф_r(ω) Ф_r(ω) Ф_r(ω)

Vertical

Lateral

Ф_q(ω)

−Ф_q(ω)

−Ф_r(ω)

Ф_r(ω)

To generate a signal with the correct characteristics, a unit variance, band-limited white noise signal is passed through forming filters. The forming filters are approximations of the Von Kármán velocity. The following tables displays the filters.

	MIL-F-8785C	MIL-HDBK-1797 and MIL-HDBK-1797B
Longitudinal
$H_{u} (s)$	$\frac{σ_{u} \sqrt{\frac{2}{π} \cdot \frac{L_{u}}{V}} (1 + 0.25 \frac{L_{u}}{V} s)}{1 + 1.357 \frac{L_{u}}{V} s + 0.1987 {(\frac{L_{u}}{V})}^{2} s^{2}}$	$\frac{σ_{u} \sqrt{\frac{2}{π} \cdot \frac{L_{u}}{V}} (1 + 0.25 \frac{L_{u}}{V} s)}{1 + 1.357 \frac{L_{u}}{V} s + 0.1987 {(\frac{L_{u}}{V})}^{2} s^{2}}$
$H_{p} (s)$	$σ_{w} \sqrt{\frac{0.8}{V}} \cdot \frac{{(\frac{π}{4 b})}^{\frac{1}{6}}}{L_{w}^{\frac{1}{3}} (1 + (\frac{4 b}{π V}) s)}$	$σ_{w} \sqrt{\frac{0.8}{V}} \cdot \frac{{(\frac{π}{4 b})}^{\frac{1}{6}}}{{(2 L_{w})}^{\frac{1}{3}} (1 + (\frac{4 b}{π V}) s)}$
Lateral
$H_{v} (s)$	$\frac{σ_{v} \sqrt{\frac{1}{π} \cdot \frac{L_{v}}{V }} (1 + 2.7478 \frac{L_{v}}{V} s + 0.3398 {(\frac{L_{v}}{V})}^{2} s^{2})}{1 + 2.9958 \frac{L_{v}}{V} s + 1.9754 {(\frac{L_{v}}{V})}^{2} s^{2} + 0.1539 {(\frac{L_{v}}{V})}^{3} s^{3}}$	$\frac{σ_{v} \sqrt{\frac{1}{π} \cdot \frac{2 L_{v}}{V}} (1 + 2.7478 \frac{2 L_{v}}{V} s + 0.3398 {(\frac{2 L_{v}}{V})}^{2} s^{2})}{1 + 2.9958 \frac{2 L_{v}}{V} s + 1.9754 {(\frac{2 L_{v}}{V})}^{2} s^{2} + 0.1539 {(\frac{2 L_{v}}{V})}^{3} s^{3}}$
$H_{r} (s)$	$\frac{\mp \frac{s}{V}}{(1 + (\frac{3 b}{π V}) s)} \cdot H_{v} (s)$	$\frac{\mp \frac{s}{V}}{(1 + (\frac{3 b}{π V}) s)} \cdot H_{v} (s)$
Vertical
$H_{w} (s)$	$\frac{σ_{w} \sqrt{\frac{1}{π} \cdot \frac{L_{w}}{V}} (1 + 2.7478 \frac{L_{w}}{V} s + 0.3398 {(\frac{L_{w}}{V})}^{2} s^{2})}{1 + 2.9958 \frac{L_{w}}{V} s + 1.9754 {(\frac{L_{w}}{V})}^{2} s^{2} + 0.1539 {(\frac{L_{w}}{V})}^{3} s^{3}}$	$\frac{σ_{w} \sqrt{\frac{1}{π} \cdot \frac{2 L_{w}}{V}} (1 + 2.7478 \frac{2 L_{w}}{V} s + 0.3398 {(\frac{2 L_{w}}{V})}^{2} s^{2})}{1 + 2.9958 \frac{2 L_{w}}{V} s + 1.9754 {(\frac{2 L_{w}}{V})}^{2} s^{2} + 0.1539 {(\frac{2 L_{w}}{V})}^{3} s^{3}}$
$H_{q} (s)$	$\frac{\pm \frac{s}{V}}{(1 + (\frac{4 b}{π V}) s)} \cdot H_{w} (s)$	$\frac{\pm \frac{s}{V}}{(1 + (\frac{4 b}{π V}) s)} \cdot H_{w} (s)$

In UAV scenario, these filters are discretized with the sampling rate similar to the UAV scenario update rate. To minimize the discretization error, you must choose a scenario update rate in accordance with the UAV velocity and altitude.

Turbulence Scale Length and Intensities

Low-Altitude Model (Altitude <1000 feet)

According to the military references, the turbulence scale lengths at low altitudes, where h is the altitude in feet, are represented in the following table:

MIL-F-8785C	MIL-HDBK-1797 and MIL-HDBK-1797B
$\begin{array}{l} L_{w} = h \\ L_{u} = L_{v} = \frac{h}{{(0.177 + 0.000823 h)}^{1.2}} \end{array}$	$\begin{array}{l} 2 L_{w} = h \\ L_{u} = 2 L_{v} = \frac{h}{{(0.177 + 0.000823 h)}^{1.2}} \end{array}$

The turbulence intensities are given below, where W₂₀ is the wind speed at 20 feet (6 m). Typically for light turbulence, the wind speed at 20 feet is 15 knots; for moderate turbulence, the wind speed is 30 knots; and for severe turbulence, the wind speed is 45 knots.

$\begin{array}{l} σ_{w} = 0.1 W_{20} \\ \frac{σ_{u}}{σ_{w}} = \frac{σ_{v}}{σ_{w}} = \frac{1}{{(0.177 + 0.000823 h)}^{0.4}} \end{array}$

The turbulence axes orientation in this region is defined as follows:

Longitudinal turbulence velocity, u_g, aligned along the horizontal relative mean wind vector.
Vertical turbulence velocity, w_g, aligned with vertical relative mean wind vector.

Medium/High Altitudes (Altitude > 2000 feet)

For medium to high altitudes the turbulence scale lengths and intensities are based on the assumption that the turbulence is isotropic. In the military references, the scale lengths are represented by the following equations:

MIL-F-8785C	MIL-HDBK-1797 and MIL-HDBK-1797B
L _u = L _v = L _w = 2500 ft	L _u = 2 L _v = 2 L _w = 2500 ft

The turbulence intensities are determined from a lookup table that provides the turbulence intensity as a function of altitude and the probability of the turbulence intensity being exceeded. The relationship of the turbulence intensities is represented in the following equation: σ_u=σ_v=σ_w.

Between Low and Medium/High Altitudes (1000 feet < Altitude < 2000 feet)

At altitudes between 1000 feet and 2000 feet, the turbulence velocities and turbulence angular rates are determined by linearly interpolating between the value from the low altitude model at 1000 feet transformed from mean horizontal wind coordinates to body coordinates and the value from the high altitude model at 2000 feet in body coordinates.

Version History

Introduced in R2024a

uavWindTurbulence

Description

Creation

Syntax

Description

Properties

`StartTime` — Wind start time
`0` (default) | nonnegative scalar

`StopTime` — Wind stop time
`Inf` (default) | nonnegative scalar

`Specification` — Military reference
`"MIL-F-8785C"` (default) | `"MIL-HDBK-1797"` | `"MIL-HDBK-1797B"`

`ModelType` — Angular rate signs
"Von Karman (+q +r)" (default) | "Von Karman (+q -r)" | "Von Karman (-q +r)"

`WindSpeedAt6m` — Wind speed at 6 meters above ground
`15` (default) | nonnegative scalar

`WindDirectionAt6m` — Wind direction at 6 meters above ground
`0` (default) | nonnegative scalar

`ProbExceedanceHighAltitudeIntensity` — Probability of exceeding turbulence intensity
`"10^-2 - Light"` (default) | `"2x10^-1"` | `"10^-1"` | `"10^-3 - Moderate"` | `"10^-4"` | `"10^-5 - Severe"` | `"10^-6"`

`ScaleLengthAtMediumHighAltitude` — Turbulence scale length
762 (default) | positive scalar

`WingSpan` — Wingspan
10 (default) | positive scalar

`BandLimitedNoiseSampleTime` — Noise sample time
0.1 (default) | positive scalar

`RandomNoiseSeeds` — Noise seeds
[23341 23342 23343 23344] (default) | vector of the form [u_g v_g w_g p_g]

Examples

Generate Turbulence Wind in UAV Scenario

More About

Algorithms

Turbulence Scale Length and Intensities

Version History

See Also

Functions

Objects

uavWindTurbulence

Description

Creation

Syntax

Description

Properties

StartTime — Wind start time 0 (default) | nonnegative scalar

StopTime — Wind stop time Inf (default) | nonnegative scalar

Specification — Military reference "MIL-F-8785C" (default) | "MIL-HDBK-1797" | "MIL-HDBK-1797B"

ModelType — Angular rate signs "Von Karman (+q +r)" (default) | "Von Karman (+q -r)" | "Von Karman (-q +r)"

WindSpeedAt6m — Wind speed at 6 meters above ground 15 (default) | nonnegative scalar

WindDirectionAt6m — Wind direction at 6 meters above ground 0 (default) | nonnegative scalar

ProbExceedanceHighAltitudeIntensity — Probability of exceeding turbulence intensity "10^-2 - Light" (default) | "2x10^-1" | "10^-1" | "10^-3 - Moderate" | "10^-4" | "10^-5 - Severe" | "10^-6"

ScaleLengthAtMediumHighAltitude — Turbulence scale length 762 (default) | positive scalar

WingSpan — Wingspan 10 (default) | positive scalar

BandLimitedNoiseSampleTime — Noise sample time 0.1 (default) | positive scalar

RandomNoiseSeeds — Noise seeds [23341 23342 23343 23344] (default) | vector of the form [ug vg wg pg]

Examples

Generate Turbulence Wind in UAV Scenario

More About

Algorithms

Turbulence Scale Length and Intensities

Version History

See Also

Functions

Objects

`StartTime` — Wind start time
`0` (default) | nonnegative scalar

`StopTime` — Wind stop time
`Inf` (default) | nonnegative scalar

`Specification` — Military reference
`"MIL-F-8785C"` (default) | `"MIL-HDBK-1797"` | `"MIL-HDBK-1797B"`

`ModelType` — Angular rate signs
"Von Karman (+q +r)" (default) | "Von Karman (+q -r)" | "Von Karman (-q +r)"

`WindSpeedAt6m` — Wind speed at 6 meters above ground
`15` (default) | nonnegative scalar

`WindDirectionAt6m` — Wind direction at 6 meters above ground
`0` (default) | nonnegative scalar

`ProbExceedanceHighAltitudeIntensity` — Probability of exceeding turbulence intensity
`"10^-2 - Light"` (default) | `"2x10^-1"` | `"10^-1"` | `"10^-3 - Moderate"` | `"10^-4"` | `"10^-5 - Severe"` | `"10^-6"`

`ScaleLengthAtMediumHighAltitude` — Turbulence scale length
762 (default) | positive scalar

`WingSpan` — Wingspan
10 (default) | positive scalar

`BandLimitedNoiseSampleTime` — Noise sample time
0.1 (default) | positive scalar

`RandomNoiseSeeds` — Noise seeds
[23341 23342 23343 23344] (default) | vector of the form [u_g v_g w_g p_g]