Documentation Center

  • Trial Software
  • Product Updates

phased.Collector System object

Package: phased

Narrowband signal collector

Description

The Collector object implements a narrowband signal collector.

To compute the collected signal at the sensor(s):

  1. Define and set up your signal collector. See Construction.

  2. Call step to collect the signal according to the properties of phased.Collector. The behavior of step is specific to each object in the toolbox.

Construction

H = phased.Collector creates a narrowband signal collector System object™, H. The object collects incident narrowband signals from given directions using a sensor array or a single element.

H = phased.Collector(Name,Value) creates a collector object, H, with each specified property Name set to the specified Value. You can specify additional name-value pair arguments in any order as (Name1,Value1,...,NameN,ValueN).

Properties

Sensor

Sensor element or sensor array

Sensor element or sensor array specified as a System object in the Phased Array System Toolbox™. A sensor array can contain subarrays.

Default: phased.ULA with default property values

PropagationSpeed

Signal propagation speed

Specify the propagation speed of the signal, in meters per second, as a positive scalar.

Default: Speed of light

OperatingFrequency

System operating frequency

Specify the operating frequency of the system in hertz as a positive scalar. The default value corresponds to 300 MHz.

Default: 3e8

WeightsInputPort

Enable weights input

To specify weights, set this property to true and use the corresponding input argument when you invoke step. If you do not want to specify weights, set this property to false.

Default: false

EnablePolarization

EnablePolarization

Set this property to true to simulate the collection of polarized waves. Set this property to false to ignore polarization. This property applies when the sensor specified in the Sensor property is capable of simulating polarization.

Default: false

Wavefront

Type of incoming wavefront

Specify the type of incoming wavefront as one of 'Plane', or 'Unspecified':

  • If you set the Wavefront property to 'Plane', the input signals are multiple plane waves impinging on the entire array. Each plane wave is received by all collecting elements. If the Sensor property is an array that contains subarrays, the Wavefront property must be 'Plane'.

  • If you set the Wavefront property to 'Unspecified', the input signals are individual waves impinging on individual sensors.

Default: 'Plane'

Methods

cloneCreate collector object with same property values
getNumInputsNumber of expected inputs to step method
getNumOutputsNumber of outputs from step method
isLockedLocked status for input attributes and nontunable properties
releaseAllow property value and input characteristics changes
stepCollect signals

Examples

Collect signal with a single antenna.

ha = phased.IsotropicAntennaElement;
hc = phased.Collector('Sensor',ha,'OperatingFrequency',1e9);
x = [1;1];
incidentAngle = [10 30]';
y = step(hc,x,incidentAngle);
 

Collect a far field signal with a 5-element array.

ha = phased.ULA('NumElements',5);
hc = phased.Collector('Sensor',ha,'OperatingFrequency',1e9);
x = [1;1];
incidentAngle = [10 30]';
y = step(hc,x,incidentAngle);
 

Collect signals with a 3-element array. Each antenna collects a separate input signal from a separate direction.

ha = phased.ULA('NumElements',3);
hc = phased.Collector('Sensor',ha,'OperatingFrequency',1e9,...
    'Wavefront','Unspecified');
x = rand(10,3);   % Each column is a separate signal for one element
incidentAngle = [10 0; 20 5; 45 2]'; % 3 angles for 3 signals
y = step(hc,x,incidentAngle);

Algorithms

If the Wavefront property value is 'Plane', phased.Collector collects each plane wave signal using the phase approximation of the time delays across collecting elements in the far field.

If the Wavefront property value is 'Unspecified', phased.Collector collects each channel independently.

For further details, see [1].

References

[1] Van Trees, H. Optimum Array Processing. New York: Wiley-Interscience, 2002.

See Also

Was this topic helpful?