System object: phased.CustomAntennaElement
Output response of antenna element
RESP = step(H,FREQ,ANG)
RESP = step(H,FREQ,ANG) returns the antenna's voltage response RESP at operating frequencies specified in FREQ and directions specified in ANG. The form of RESP depends upon whether the antenna element supports polarization as determined by the SpecifyPolarizationPattern property. If SpecifyPolarizationPattern is set to false, RESP is an M-by-L matrix containing the antenna response at the M angles specified in ANG and at theL frequencies specified in FREQ. If SpecifyPolarizationPattern is set to true, RESP is a MATLAB® struct containing two fields, RESP.H and RESP.V, representing the antenna's response in horizontal and vertical polarization, respectively. Each field is an M-by-L matrix containing the antenna response at the M angles specified in ANG and at theL frequencies specified in FREQ.
Note: H specifies the System object™ on which to run this step method.
The object performs an initialization the first time the step method is executed. This initialization locks nontunable properties and input specifications, such as dimensions, complexity, and data type of the input data. If you change a nontunable property or an input specification, the System object issues an error. To change nontunable properties or inputs, you must first call the release method to unlock the object.
Antenna element object.
Operating frequencies of antenna in hertz. FREQ is a row vector of length L.
Directions in degrees. ANG can be either a 2-by-M matrix or a row vector of length M.
If ANG is a 2-by-M matrix, each column of the matrix specifies the direction in the form [azimuth; elevation]. The azimuth angle must be between –180 and 180 degrees, inclusive. The elevation angle must be between –90 and 90 degrees, inclusive.
If ANG is a row vector of length M, each element specifies a direction's azimuth angle. In this case, the corresponding elevation angle is assumed to be 0.
Voltage response of antenna element. The output depends on whether the antenna element supports polarization or not.
Construct a user defined antenna with an omnidirectional response in azimuth and a cosine pattern in elevation. The antenna operates at 1 GHz. Find the response of the antenna at the boresight.
ha = phased.CustomAntennaElement; ha.AzimuthAngles = -180:180; ha.ElevationAngles = -90:90; ha.RadiationPattern = mag2db(repmat(cosd(ha.ElevationAngles)',... 1,numel(ha.AzimuthAngles))); resp = step(ha,1e9,[0; 0]);
resp = 1
The total response of a custom antenna element is a combination of its frequency response and spatial response. phased.CustomAntennaElement calculates both responses using nearest neighbor interpolation, and then multiplies the responses to form the total response.