This is machine translation

Translated by Microsoft
Mouse over text to see original. Click the button below to return to the English verison of the page.

phased.Collector System object

Package: phased

Narrowband signal collector


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.

    Note:   Starting in R2016b, instead of using the step method to perform the operation defined by the System object™, you can call the object with arguments, as if it were a function. For example, y = step(obj,x) and y = obj(x) perform equivalent operations.


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).



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.

Antenna Toolbox™ antenna

Default: phased.ULA with default property values


Signal propagation speed

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

Default: Speed of light


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


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



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


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'


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


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,...
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);


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].


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

Introduced in R2012a

Was this topic helpful?