networkTrafficFTP

FTP application traffic pattern generator

Description

The networkTrafficFTP object specifies the configuration parameters to generate a file transfer protocol (FTP) application traffic pattern based on the 3GPP TR 36.814 specification and the IEEE^® 802.11ax™ Evaluation Methodology.

You can use the FTP application traffic pattern in 5G and WLAN (requires WLAN Toolbox™) system-level simulations to accurately model the real-world data traffic.

Creation

Syntax

cfgFTP = networkTrafficFTP

cfgFTP = networkTrafficFTP(Name,Value)

Description

cfgFTP = networkTrafficFTP creates a default FTP application traffic pattern object.

cfgFTP = networkTrafficFTP(Name,Value) sets properties using one or more name-value pair arguments. Enclose each property name in quotes. For example, 'GeneratePacket',true generates an FTP packet.

Properties

FixedFileSize — Custom size of file to be transmitted

[ ] (default) | positive scalar

Custom size of the file to be transmitted, specified as a positive scalar. This property must be expressed in megabytes. If you do not specify this property, the object uses the truncated Lognormal distribution to calculate the file size.

Data Types: double

LogNormalMu — Truncated Lognormal distribution mu value

14.45 (default) | positive scalar

Truncated Lognormal distribution mu value, specified as a positive scalar. The object uses this property to calculate the file size.

Dependencies

To enable this property, set the FixedFileSize property to [ ].

Data Types: double

LogNormalSigma — Truncated Lognormal distribution sigma value

0.35 (default) | positive scalar

Truncated Lognormal distribution sigma value, specified as a positive scalar. The object uses this value to calculate the file size.

Dependencies

To enable this property, set the FixedFileSize property to [ ].

Data Types: double

UpperLimit — Truncated Lognormal distribution upper limit

5 (default) | positive scalar

Truncated Lognormal distribution upper limit, specified as a positive scalar. The object uses this value to calculate the file size. The generated file size value must be less than or equal to the UpperLimit value. If the generated file size value is greater than UpperLimit, the object discards the file size and creates a new one.

Dependencies

To enable this property, set the FixedFileSize property to [ ].

Data Types: double

ReadingTime — Time interval between two successive file transfers

[ ] (default) | positive scalar

Time interval between two consecutive file transfers, specified as a positive scalar. This property must be expressed in milliseconds. To specify a customized value for the reading time, specify this property. If you do not specify this property, the object uses the exponential distribution to calculate the reading time.

Data Types: double

ExponentialMean — Exponential distribution mean value

180000 (default) | nonnegative scalar

Exponential distribution mean value, specified as a nonnegative scalar. This property must be expressed in milliseconds. The object uses this property to calculate the reading time.

Dependencies

To enable this property, set the ReadingTime property to [ ].

Data Types: double

PoissonMean — Poisson distribution mean value

[ ] (default) | nonnegative scalar

Poisson distribution mean value, specified as a nonnegative scalar. This property must be expressed in milliseconds. The object uses this property to calculate the packet interarrival time.

Data Types: double

PacketInterArrivalTime — Time interval between two successively generated packets

0 (default) | nonnegative scalar

Time interval between two successively generated packets, specified as a nonnegative scalar. This property must be expressed in milliseconds.

Dependencies

To enable this property, set the PoissonMean property to [ ].

Data Types: double

GeneratePacket — Flag to indicate whether to generate FTP packet

false or 0 (default) | true or 1

Flag to indicate whether the object generates an FTP packet, specified as a logical 1 (true) or 0 (false).

Data Types: logical

ApplicationData — Application data to be added in FTP packet

1500-by-1 vector of 1s (default) | column vector of integers in the range [0, 255]

Application data to be added in the FTP packet, specified as a column vector of integers in the range [0, 255]. If the size of the application data is greater than the packet size, the object truncates the application data. If the size of the application data is less than the packet size, the object appends zeros.

Dependencies

To enable this property, set the GeneratePacket property to true or 1.

Data Types: double

Object Functions

Specific to This Object

generate

Generate next FTP, On-Off, VoIP, or video conference application traffic packet

Examples

Generate FTP Application Traffic Pattern

Create a default FTP application traffic pattern object.

cfgFTP = networkTrafficFTP;

Generate an FTP application traffic pattern.

[dt,packetSize] = generate(cfgFTP);

Generate FTP Application Traffic Pattern Using Reading Time

Create an FTP application traffic pattern object, specifying the reading time.

cfgFTP = networkTrafficFTP('ReadingTime',5);

Generate an FTP application traffic pattern.

[dt,packetSize] = generate(cfgFTP);

Generate FTP Application Traffic Pattern and Data Packet

Create an FTP application traffic pattern object to generate an FTP data packet.

cfgFTP = networkTrafficFTP('GeneratePacket',true);

Generate an FTP application traffic pattern and data packet.

[dt,packetSize,packet] = generate(cfgFTP); 

Generate FTP Application Traffic Pattern to Visualize Packet Sizes and Intervals

Create a default FTP application traffic pattern object.

cfgFTP = networkTrafficFTP;

Generate an FTP application traffic pattern with 20,000 FTP packets.

for packetCount = 1:20000
    [dt(packetCount),packetSize(packetCount)] = generate(cfgFTP);
end

Visualize the FTP packet sizes.

stem(packetSize); 
title('Packet Size Versus Packet Number');
xlabel('Packet Number');
ylabel('Packet Size in Bytes');

Visualize the FTP packet intervals.

figure;
stem(dt); 
title('dt Versus Packet Number');
xlabel('Packet Number');
ylabel('dt in Milliseconds');

References

[1] 3GPP TR 36.814. "Evolved Universal Terrestrial Radio Access (E-UTRA). Further advancements for E-UTRA physical layer aspects". Release 15. 3rd Generation Partnership Project; Technical Specification Group Radio Access Network. https://www.3gpp.org.

[2] IEEE 802.11-14/0571r12. "11ax Evaluation Methodology." IEEE P802.11. Wireless LANs. https://www.ieee.org.

Extended Capabilities

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

Version History

Introduced in R2020b