Range-Time Intensity Scope

Range-time intensity scope

Since R2022a

Libraries:
Phased Array System Toolbox / Sinks

Description

The Range-Tine Intensity Scope block creates a scrolling display of range response intensities as a function of time. The input consists of range responses for a pulse or FMCW signal. Each frame of data creates a new line on the scope. The scope serves only as a display of the range response. Using the response as input corresponds to setting the IQDataInput property of the phased.RTIScope System object™ to false.

Examples

Simulate and Visualize Range and Doppler Intensity Data in an End-to-End Radar System

Model an end-to-end radar system and use the scopes to visualize range-intensity and Doppler-intensity data in Simulink.

Open Script

Ports

Input

expand all

X — Input data
real-valued length-M vector

Input data, specified as a real-valued length-M vector of range responses. Each vector corresponds to a line of data. The block accepts single precision data type input, but converts the data to double precision for display.

Data Types: double | single

Parameters

expand all

Data and Axes

Range Offset (m) — Range offset
`0.0` (default) | positive scalar

Range offset, specified as a positive scalar. This parameter defines the range value of the first column of the display. Units are in meters.

Programmatic Use

Block Parameter:RangeOffset

Type:double

Values:scalar

Default:0

Data Types: double

Time Span (s) — Time span of display
`0.1` (default) | positive scalar

Time span of the intensity display, specified as a positive scalar. Units are in seconds.

Programmatic Use

Block Parameter:TimeSpan

Type:double

Values:scalar

Default:1

Data Types: double

Range Resolution (m) — Range difference between samples
`1` (default) | positive scalar

Range distance between samples, specified as a positive scalar. This parameter defines the distance between columns of the scope. Units are in meters.

Programmatic Use

Block Parameter:RangeResolution

Type:double

Values:positive scalar

Default:25

Data Types: double

Time Resolution (s) — Time difference between rows
`0.001` (default) | positive scalar

Time interval between samples, specified as a positive scalar. This parameter defines the time interval between the rows of the scope. Units are in seconds.

Programmatic Use

Block Parameter:TimeResolution

Type:double

Values:positive scalar

Default:0.00033356

Data Types: double

Show Grid — Show Cartesian grid overlay
on (default) | off

Show Cartesian grid overlay. To show the grid, select the check box.

Programmatic Use

Block Parameter:ShowGrid

Type:logical

Values:1 | 0

Default:1

Show Ticks — Show tick value labels
on (default) | off

Show value labels on tick marks. The display the labels on, select the check box.

Programmatic Use

Block Parameter:ShowTicks

Type:logical

Values:1 | 0

Default:1

Labels

Range Label — Range axis label
`'Range (m)'` (default) | string

Range-axis label, specified as a string.

Tunable: Yes

Programmatic Use

Block Parameter:RangeLabel

Type:string

Values:string

Default:

'Range
                (m)'

Data Types: char

Time Label — Time axis label
`Time History (s)'` (default) | string

Time-axis label, specified as a string.

Tunable: Yes

Programmatic Use

Block Parameter:TimeLabel

Type:string

Values:string

Default:

'Time History
                (s)'

Data Types: string

Title — Window title
`'Range vs. Time'` (default) | string

Window title, specified as a string.

Tunable: Yes

Programmatic Use

Block Parameter:Title

Type:string

Values:string

Default:

Range vs.
                Time'

Data Types: char

Colorbar Label — Color bar
`'mag'` (default) | string

Color bar label, specified as a string.

Tunable: Yes

Programmatic Use

Block Parameter:ColorBarLabel

Type:string

Values:string

Default:'mag'

Data Types: string

Block Characteristics

Data Types	`double` \| `single`
Direct Feedthrough	`no`
Multidimensional Signals	`no`
Variable-Size Signals	`no`
Zero-Crossing Detection	`no`

Algorithms

expand all

This section shows how to run the scope, configure the settings to show labels for the various features and use the cursor to examine data.

Run the Scope

After selecting and opening the block, the scope displays a single tab PLOT. Opening this tab shows all the controls available for the block. The Settings menu displays all the settable parameters for the scope. The Step Back, Run, Step Forward, and Stop buttons control the simulation. The Data Cursors button lets you examine data values on the display.

Scope Parameter Settings

Selecting the Settings menu from PLOT panel scope opens the parameter window with the DATA AND AXES and LABELS panels.

DATA AND AXES

Range Offset (m) - Use this field to set the offset of the x-axis.
Range Resolution (m) - Use this field to set the granularity of the x-axis.
Time Span (s) - Use this field to set the duration of the y-axis.
Time Resolution (s) - Use this field to set the granularity of the y-axis.

Labels

Range Label – Use this field to set the x-axis label.
Time Label – Use this field to set the y-axis label.
Title – Use this field to set the display title.
Colorbar Label – Use this field to set the color bar label.

Using Cursors

Select the Cursors Button to display the screen cursors. Each cursor consists of intersecting horizontal and vertical lines that define a point on the display. Positioning two cursors on the display shows the difference between the intensities at the two cursor points.

Extended Capabilities

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

This block can be used for simulation visibility in systems that generate code but

Version History

Introduced in R2022a

Range-Time Intensity Scope

Description

Examples

Simulate and Visualize Range and Doppler Intensity Data in an End-to-End Radar System

Ports

Input

X — Input data real-valued length-M vector

Parameters

Range Offset (m) — Range offset 0.0 (default) | positive scalar

Programmatic Use

Time Span (s) — Time span of display 0.1 (default) | positive scalar

Programmatic Use

Range Resolution (m) — Range difference between samples 1 (default) | positive scalar

Programmatic Use

Time Resolution (s) — Time difference between rows 0.001 (default) | positive scalar

Programmatic Use

Show Grid — Show Cartesian grid overlay on (default) | off

Programmatic Use

Show Ticks — Show tick value labels on (default) | off

Programmatic Use

Range Label — Range axis label 'Range (m)' (default) | string

Programmatic Use

Time Label — Time axis label Time History (s)' (default) | string

Programmatic Use

Title — Window title 'Range vs. Time' (default) | string

Programmatic Use

Colorbar Label — Color bar 'mag' (default) | string

Programmatic Use

Block Characteristics

Algorithms

Run the Scope

Scope Parameter Settings

Using Cursors

Extended Capabilities

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

Version History

See Also

X — Input data
real-valued length-M vector

Range Offset (m) — Range offset
`0.0` (default) | positive scalar

Time Span (s) — Time span of display
`0.1` (default) | positive scalar

Range Resolution (m) — Range difference between samples
`1` (default) | positive scalar

Time Resolution (s) — Time difference between rows
`0.001` (default) | positive scalar

Show Grid — Show Cartesian grid overlay
on (default) | off

Show Ticks — Show tick value labels
on (default) | off

Range Label — Range axis label
`'Range (m)'` (default) | string

Time Label — Time axis label
`Time History (s)'` (default) | string

Title — Window title
`'Range vs. Time'` (default) | string

Colorbar Label — Color bar
`'mag'` (default) | string

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