Main Content

phased.RangeAngleScope

View range-angle response

expand all in page

Description

Thephased.RangeAngleScope系统对象™创建一个显示ra的空间nge-angle response map. The map is a 2-D representation of response intensity as a function of range and angle of arrival. You can input two types of data – in-phase and quadrature (I/Q) data and response data.

  • I/Q data – The data consists of fast-time I/Q samples of pulses or sweeps from multiple sensors. The scope computes and displays the response map. To use I/Q data, set theIQDataInputproperty totrue. In this mode, you can set the properties shown inProperties Applicable to I/Q Data.

  • Response data – The data consists of the range-angle response itself. The scope displays the range-angle response map. You can obtain range-angle response data from theRangeAngleResponseobject. To use response data, set theIQDataInputproperty tofalse. In this mode, you can set the properties shown inProperties Applicable to Response Data.

To display a range-angle response map using a scope,

  1. Create thephased.RangeAngleScopeobject and set its properties.

  2. Call the object with arguments, as if it were a function.

To learn more about how System objects work, seeWhat Are System Objects?

Creation

Syntax

scope = phased.RangeAngleScope
scope = phased.phased.RangeAngleScope(Name,Value)

Description

scope= phased.RangeAngleScopecreates a range-angle scope System object for displaying the range-angle response.

example

scope= phased.phased.RangeAngleScope(Name,Value)creates a range-anglescopewith each specified property set to the specified value. You can specify additional name-value pair arguments in any order as (Name1,Value1,...,NameN,ValueN). Enclose property names in quotes. For example,

scope = phased.RangeAngleScope('IQInputData',true,'RangeMethod', ... 'FFT','SampleRate',1e6)
creates a scope object that uses FFT-based range processing to process I/Q data with a sample rate of 1 MHz.

Properties

expand all

Unless otherwise indicated, properties arenontunable, which means you cannot change their values after calling the object. Objects lock when you call them, and thereleasefunction unlocks them.

If a property istunable, you can change its value at any time.

For more information on changing property values, seeSystem Design in MATLAB Using System Objects.

Display caption, specified as a character vector. The caption appears in the title bar of the window.

Example:'Aircraft Range-Angle Response'

可调:Yes

Data Types:char

Location and size of the intensity scope window, specified as a 1-by-4 vector having the form[left bottom width height].

  • leftandbottomspecify the location of the bottom-left corner of the window.

  • widthandheightspecify the width and height of the window.

Units are in pixels.

The default value of this property depends on the resolution of your display. By default, the window is positioned in the center of the screen, with a width and height of 800 and 450 pixels, respectively.

Example:[100 100 500 400]

可调:Yes

Data Types:double

Type of input data, specified astrueorfalse. Whentrue,object assumes that the input consists of I/Q sample data and further processing is required in the range and angle domains. Whenfalse,object assumes that the data is response data that has already been processed.

Data Types:logical

Response units, specified as'db','magnitude', or'power'.

Data Types:char

Range-axis label, specified as a character vector.

Example:'Range (km)'

可调:Yes

Dependencies

To enable this property, set theIQDataInputtofalse.

Data Types:char

Angle-axis label, specified as a character vector.

Example:'Angle Span (degrees)'

可调:Yes

Dependencies

To enable this property, set theIQDataInputtofalse.

Data Types:char

Sensor array, specified as a Phased Array System Toolbox array System object. Seephased.ULAfor the default values of a uniform linear array.

Example:phased.URA

Dependencies

To enable this property, set theIQDataInputtotrue.

Range-processing method, specified as'Matched filter'or'FFT'.

'Matched filter' The object applies a matched filter to the incoming signal. This approach is commonly used with pulsed signals, where the matched filter is a time-reversed replica of the transmitted signal.
'FFT' Algorithm performs range processing by applying an FFT to the input signal. This approach is commonly used with FMCW continuous signals and linear FM pulsed signals.

Dependencies

To enable this property, set theIQDataInputproperty totrue.

Range units, specified as:

  • 'm'– meters

  • 'km'– kilometers

  • 'mi'– miles

  • 'nmi'– nautical miles

Example:'mi'

Dependencies

To enable this property, set theIQDataInputproperty totrue.

Data Types:char

Signal propagation speed, specified as a positive scalar. The default value of this property is the speed of light. Seephysconst. Units are in meters/second.

Example:3e8

Dependencies

To enable this property, set theIQDataInputproperty totrue.

Data Types:double

工作频率, specified as a positive scalar. Units are in Hz.

Dependencies

To enable this property, set theIQDataInputproperty totrue.

Data Types:double

Sample rate, specified as a positive scalar. Units are in Hz.

Example:10e3

Dependencies

To enable this property, set theIQDataInputproperty totrue.

Data Types:double

Slope of the linear FM sweep, specified as a scalar. Units are in Hz/sec.

Dependencies

To enable this property, set theIQDataInputproperty totrueand theRangeMethodproperty to'FFT'.

Data Types:double

Set this property totrueto dechirp the input signal before performing range processing.falseindicates that the input signal is already dechirped and no dechirp operation is necessary.

Dependencies

To enable this property, set theIQDataInputproperty totrueand theRangeMethodproperty to'FFT'.

Data Types:logical

FFT length used for range processing, specified as a positive integer.

Example:128

Dependencies

To enable this property, set theIQDataInputproperty totrueand theRangeMethodproperty to'FFT'.

Data Types:double

Set this property totrueto set the reference range to the center of the range span. Set this property tofalseto set the reference range to the beginning of the range span.

Dependencies

To enable this property, set theIQDataInputproperty totrueand theRangeMethodproperty to'FFT'.

Data Types:logical

Reference range of the range span, specified as a nonnegative scalar.

  • If you set theRangeMethodproperty to'Matched filter',reference range marks the start of the range span.

  • If you set theRangeMethodproperty to'FFT',position of the reference range depends on theReferenceRangeCenteredproperty.

    • If you set theReferenceRangeCenteredproperty totrue,reference range marks the center of the range span.

    • If you set theReferenceRangeCenteredproperty tofalse,reference range marks the start of the range span.

    Units are in meters.

Example:1000.0

可调:Yes

Dependencies

To enable this property, set theIQDataInputproperty totrue.

Data Types:double

Elevation angle at which to calculate the response, specified as a scalar. The elevation angle must lie in the interval from –90° to 90°, inclusive. Units are in degrees.

Example:45.0

Dependencies

To enable this property, set theIQDataInputproperty totrue.

Data Types:double

Azimuth angle span at which to calculate response, specified as a real-valued 1-by-2 row vector. The object calculates the range-angle response within the angle range,[min_angle max_angle]. Angles must lie in the interval from –90° to 90°, inclusive. Units are in degrees.

Example:[-45 45]

Dependencies

To enable this property, set theIQDataInputproperty totrue.

Data Types:double

Number of samples in the azimuth angle span at which to calculate the range-angle response, specified as a positive integer greater than two.

Example:256

Dependencies

To enable this property, set theIQDataInputproperty totrue.

Data Types:double

Usage

Syntax

scope(X,Range,Ang)
scope(X)
scope(X,XREF)
scope(X,COEFF)

Description

scope(X,Range,Ang)displays a range-angle response map,X, at the ranges,Range, and angles,Ang. This syntax applies when you set theIQDataInputtofalse.

scope(X)computes and displays the range-angle response map for the dechirped signalX. This syntax applies when you set theIQDataInputproperty totrue,RangeMethodproperty to'FFT', and theDechirpInputproperty tofalse. This syntax is most commonly used with FMCW signals.

scope(X,XREF)also specifies a reference signal to use for dechirping the input signal,X. This syntax applies when you set theIQDataInputproperty totrue,RangeMethodproperty to'FFT', and theDechirpInputproperty totrue. This syntax is most commonly used with FMCW signals.XREFis generally the transmitted signal.

example

scope(X,COEFF)also specifies matched filter coefficients,COEFF. This syntax applies when you set theIQDataInputproperty totrueand theRangeMethodproperty to'Matched Filter'. This syntax is most commonly used with pulsed signals.

Input Arguments

expand all

Input data, specified as a complex-valuedK-by-Lmatrix. The interpretation of the data depends on the value of theIQDataInputproperty.

  • WhenIQDataInputistrue,input consists of received fast-time data samples for each PRI pulse or FMCW sweep and for each array or subarray element.Kdenotes the number of fast-time (range) samples.Lis the number of elements. IfSensorArraycontains subarrays,Lis the number of subarrays. The scope computes and displays the range-angle response.

    • WhenRangeMethodis set to'FFT'andDechirpInputisfalse,Xhas previously been dechirped.

    • WhenRangeMethodis set to'FFT'andDechirpInputistrue,Xhas not been previously dechirped. Use the syntax that includesXREFas input data.

    • WhenRangeMethodis set to'MatchedFilter',Xhas not been match filtered. Use the syntax that includesCOEFFas input data.

  • WhenIQDataInputisfalse,input already consists of response data in the range-angle domain, such as the data produced, for example, byRangeAngleResponse. Each row of the response map corresponds to an element of theRangevector.Kis the number of range samples. Each column of the response map corresponds to an element of theAngvector.Lis the number of angles. The scope serves only as a display of the range-angle response.

Range grid values of range-angle response map, specified as a real-valuedK-by-1 column vector.Rangedenotes the range values at which the response has been computed. Elements ofRangecorrespond to the rows ofX.

Dependencies

To enable this argument, set theIQInputDataproperty tofalse.

Data Types:double

Angle grid values of response map, specified as a real-valuedK-by-1 column vector.Angdenotes the angle values at which the response has been computed. Elements ofAngcorrespond to the columns ofX.

Dependencies

To enable this argument, set theIQInputDataproperty tofalse.

Data Types:double

Reference signal used to dechirpX.XREFmust be a column vector with the same number of rows asX.

Dependencies

To enable this argument, set theIQDataInputproperty totrue,RangeMethodproperty to'FFT'and theDechirpInputproperty tofalse

Data Types:double
Complex Number Support:Yes

Matched filter coefficients, specified as a complex-valued column vector.

Dependencies

To enable this argument, set theIQDataInputproperty totrueand theRangeMethodproperty to'Matched Filter'.

Data Types:double
Complex Number Support:Yes

Object Functions

To use an object function, specify the System object as the first input argument. For example, to release system resources of a System object namedobj, use this syntax:

release(obj)

expand all

show Turn on visibility of scopes
hide Turn off visibility of scope
isVisible Visibility of scopes
step RunSystem objectalgorithm
release Release resources and allow changes toSystem objectproperty values and input characteristics
reset Reset internal states ofSystem object

Examples

collapse all

Open Live Script

计算和可视化射程角响应from a pulsed radar transmitting a rectangular waveform using a matched filter. One target is approximately 2000 m away and is stationary relative to the radar. The second target is approximately 3500 m away and is also stationary relative to the radar. The third is approximately 2000 m away and is moving away from the radar at approximately 100 m/s. The signals arrive at an 8-element uniform linear array.

Load the data to obtain signals and parameters.

load('RangeAngleResponseExampleData','rectdata'); fs = rectdata.fs; c = rectdata.propspeed; fc = rectdata.fc; rxdata = rectdata.rxdata; mfcoeffs = rectdata.mfcoeffs; noisepower = rectdata.noisepower; array = rectdata.antennaarray;

Create a range-angle scope for processing.

scope = phased.RangeAngleScope(...'IQDataInput',true,'RangeMethod','Matched filter',...'Name','Range-Angle Scope','ResponseUnits','magnitude',...'Position',[560 375 560 420],'RangeUnits','m',...'SensorArray',array,'OperatingFrequency',fc,...'SampleRate',fs,'PropagationSpeed',c);

Call the scope to display the response map.

scope(rxdata,mfcoeffs)

More About

expand all

已经rsion History

Introduced in R2019a

See Also

|||||