comm.AGC
Adaptively adjust gain for constant signal level output
Description
The comm.AGC
System object™ creates an automatic gain controller (AGC) that adaptively adjusts its
gain to achieve a constant signal level at the output. For more information, see Logarithmic-Loop AGC.
This object is designed for streaming applications. For more information, see Tips.
To adaptively adjust gain for a constant signal level at the output:
Create the
comm.AGC
object and set its properties.Call the object with arguments, as if it were a function.
To learn more about how System objects work, see What Are System Objects?
Creation
Description
creates an AGC
System object that adaptively adjusts its gain to achieve a constant signal
level at the output.agc
= comm.AGC
set properties using one or more name-value pairs. Enclose each name in quotes.
For example, 'agc
= comm.AGC(Name
,Value
)AdaptationStepSize
',0.05 sets the step size
for gain updates to 0.05.
Properties
Unless otherwise indicated, properties are nontunable, which means you cannot change their
values after calling the object. Objects lock when you call them, and the
release
function unlocks them.
If a property is tunable, you can change its value at any time.
For more information on changing property values, see System Design in MATLAB Using System Objects.
AdaptationStepSize
— Step size for gain updates
0.01
(default) | positive scalar
Step size for gain updates, specified as a positive scalar. Increasing the step size enables the AGC to respond more quickly to changes in the input signal level but increases variation in the output signal level after reaching steady-state operation. For more information, see AGC Performance Criteria, and the Vary AGC Step Size, and Plot Effect of Step Size on AGC Performance examples.
Tunable: Yes
Data Types: double
DesiredOutputPower
— Target output power level
1
W (default) | positive scalar
Target output power level, specified as a positive scalar. The power is measured in Watts referenced to 1 ohm. For more information, see the Adaptively Adjust Received Signal Amplitude Using AGC example.
Data Types: double
AveragingLength
— Length of averaging window
100
samples (default) | positive integer
Length of the averaging window in samples, specified as a positive integer. For more information on how the averaging length influences the variance of the AGC output signal in steady-state operation and the execution speed, see Tips and the Vary AGC Averaging Length example.
Data Types: double
MaxPowerGain
— Maximum power gain
60
dB (default) | positive scalar
Maximum power gain in decibels, specified as a positive scalar. Large gain adjustments can cause clipping when a small input signal power suddenly increases. Use this property to avoid large gain adjustments by limiting the gain that the AGC applies to the input signal. For more information, see the Vary AGC Maximum Gain and Demonstrate Effect of Maximum AGC Gain on Packet Data examples.
Data Types: double
Usage
Description
adaptively adjusts the gain to the input signal to achieve a reference signal
level at the output. The AGC System object uses a square law detector to determine the output signal level.
For more information, see AGC Detector.Y
= agc(X
)
[
returns Y
,powerlevel
] = agc(X
)powerlevel
, the power level estimate of the input
signal. You can use powerlevel
as an energy detector
output.
Input Arguments
X
— Input signal
column vector
Input signal, specified as a column vector.
This object accepts variable-size inputs. After the object is locked, you can change the size of each input channel, but you cannot change the number of channels. For more information, see Variable-Size Signal Support with System Objects.
Data Types: single
| double
Complex Number Support: Yes
Output Arguments
Y
— Output signal
column vector
Output signal, returned as a column vector. The output signal is the
same data type as the input signal, X
.
powerlevel
— Power level estimate of input signal
NS-element column
vector
Power level estimate of the input signal, returned as an
NS-element column vector.
For this, the Legacy Mode
must be false.
NS is the length of the
input signal, X
. You can use
powerlevel
as an energy detector output.
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 named obj
, use
this syntax:
release(obj)
Examples
Vary AGC Averaging Length
Apply different AGC averaging lengths to QAM-modulated signals. Compare the variance and plot of the signals after AGC is applied.
Create three AGC System objects with their average window lengths set to 10, 100, and 1000 samples, respectively.
agc1 = comm.AGC('AveragingLength',10); agc2 = comm.AGC('AveragingLength',100); agc3 = comm.AGC('AveragingLength',1000);
Generate 16-QAM modulated and raised cosine pulse shaped packetized data.
M = 16; d = randi([0 M-1],1000,1); s = qammod(d,M); x = 0.1*s; pulseShaper = comm.RaisedCosineTransmitFilter; y = awgn(pulseShaper(x),inf);
Apply AGC to the data capturing separate outputs for each AGC object.
r1 = agc1(y); r2 = agc2(y); r3 = agc3(y);
Plot and compare the signals. As the averaging length increases, the variance at the output of AGC decreases.
figure(1) subplot(4,1,1) plot(abs(y)) title('AGC Input') subplot(4,1,2) plot(abs(r1)) axis([0 8000 0 10]) title('AGC Output (Averaging Length is 10 Samples)') text(4000,5,sprintf('Variance is %f',var(r1(3000:end)))) subplot(4,1,3) plot(abs(r2)) axis([0 8000 0 10]) title('AGC Output (Averaging Length is 100 Samples)') text(4000,5,sprintf('Variance is %f',var(r2(3000:end)))) subplot(4,1,4) plot(abs(r3)) axis([0 8000 0 10]) title('AGC Output (Averaging Length is 1000 Samples)') text(4000,5,sprintf('Variance is %f',var(r3(3000:end))))
Vary AGC Maximum Gain
Apply different AGC maximum gain levels to QPSK-modulated signals. Compare the plot of the signals after AGC is applied.
Create three AGC System objects with their maximum gain values set to 10, 20, and 30 dB, respectively.
agc1 = comm.AGC('MaxPowerGain',10); agc2 = comm.AGC('MaxPowerGain',20); agc3 = comm.AGC('MaxPowerGain',30);
Generate QPSK-modulated data. Pass the data through raised cosine pulse shaped filtering and an AWGN channel.
M = 4; pktLen = 10000; d = randi([0 M-1],pktLen,1); s = pskmod(d,M,pi/4); x = repmat([zeros(pktLen,1); 0.3*s],3,1); pulseShaper = comm.RaisedCosineTransmitFilter; y = awgn(pulseShaper(x),50);
Apply AGC to the data capturing separate outputs for each AGC object.
r1 = agc1(y); r2 = agc2(y); r3 = agc3(y);
Plot the input signal and the AGC-adjusted signal with various maximum gain levels. Compare the results for the conditions in this example.
A maximum gain setting of 10 dB is too small, and the AGC output does not reach the desired output signal level risking data loss due to decreased signal dynamic range.
A maximum gain setting of 20 dB is optimal, and the AGC output reaches the desired level without signal loss due to saturation.
A maximum gain setting of 30 dB is too large, and the AGC output overshoots the desired signal level risking signal saturation and data loss at the start of received packets.
Between packets the input signal contains only noise.
As shown in the plots, the packet transmissions have extended periods when no data is received. The extended periods with no data received results in AGC increasing to the maximum gain setting. If a packet arrives when the AGC gain is too high, the output power overshoots the desired signal level until the AGC can respond to the change in the input power level and reduce its gain.
limits = [0 3]; figure(1) subplot(4,1,1) plot(abs(y)) ylim(limits) title('AGC Input') subplot(4,1,2) plot(abs(r1)) ylim(limits) title('AGC Output (Maximum Power Gain is 10 dB)') subplot(4,1,3) plot(abs(r2)) ylim(limits) title('AGC Output (Maximum Power Gain is 20 dB)') subplot(4,1,4) plot(abs(r3)) ylim(limits) title('AGC Output (Maximum Power Gain is 30 dB)')
Show Power Level Estimate Output from AGC
Plot a signal and the power level estimate. Compare the results. The power level estimate can serve as a power detector, indicating exactly when the received packet has arrived.
Create an AGC System object with its maximum gain value set to 20 dB.
agc20 = comm.AGC('MaxPowerGain',20);
Generate QPSK-modulated data. Pass the data through raised cosine pulse shaped filtering and an AWGN channel.
modOrd = 4; % Modulation order pktLen = 10000; % Packet length d = randi([0 modOrd-1],pktLen,1); s = pskmod(d,modOrd,pi/4); x = repmat([zeros(pktLen,1); 0.3*s],3,1); pulseShaper = comm.RaisedCosineTransmitFilter; y = awgn(pulseShaper(x),50);
Apply AGC to the data capturing separate outputs for each AGC object.
[r2,p2] = agc20(y);
Plot the input signal and the received signal power level estimate. Compare the results. Reception of packetized data with extended periods when no data is received results in the detected power level estimate decreasing to nearly zero. While an input signal is detected, the output power level estimate, p2
, serves as a power detector, indicating exactly when the received packet has arrived.
limits = [0 3]; figure(1) subplot(4,1,1) plot(abs(y)) ylim(limits) title('AGC Input') subplot(4,1,2) plot(abs(p2)) title('Power Level')
Vary AGC Step Size
Apply different AGC step sizes to QPSK-modulated signals. Compare the signals after applying AGC.
Create three AGC System objects with their step sizes set to 1e-1, 1e-3, and 1e-4, respectively.
agc1 = comm.AGC('AdaptationStepSize',1e-1); agc2 = comm.AGC('AdaptationStepSize',1e-3); agc3 = comm.AGC('AdaptationStepSize',1e-4);
Generate QPSK-modulated data with raised cosine pulse shaping.
d = randi([0 3],500,1); s = pskmod(d,4,pi/4); x = 0.1*s; pulseShaper = comm.RaisedCosineTransmitFilter; y = pulseShaper(x);
Apply AGC to the data capturing separate outputs for each AGC object.
r1 = agc1(y); r2 = agc2(y); r3 = agc3(y);
Plot the input and output signal after the various AGC step sizes.
With the step size set to 1e-1, the AGC output signal overshoot is evident. The output signal converges very quickly.
With the step size set to 1e-3, the AGC output signal overshoot disappears. The output signal gradually converges.
With the step size set to 1e-4, the AGC output signal takes 2 to 3 times longer to converge than a step size of 1e-3.
figure subplot(4,1,1) plot(abs(y)) title('AGC Input') subplot(4,1,2) plot(abs(r1)) title('AGC Output (Adaption Step Size is 1e-1)') subplot(4,1,3) plot(abs(r2)) title('AGC Output (Adaption Step Size is 1e-3)') subplot(4,1,4) plot(abs(r3)) title('AGC Output (Adaption Step Size is 1e-4)')
Adaptively Adjust Received Signal Amplitude Using AGC
Modulate and amplify a QPSK signal. Set the received signal amplitude to approximately 1 volt by using an AGC. Plot the output.
Create a QPSK-modulated signal by using the QPSK System object.
data = randi([0 3],1000,1); qpsk = comm.QPSKModulator; modData = qpsk(data);
Attenuate the modulated signal.
txSig = 0.1*modData;
Create an AGC System object and pass the transmitted signal through it. The AGC adjusts the received signal power to approximately 1 W.
agc = comm.AGC; rxSig = agc(txSig);
Plot the signal constellations of the transmit and received signals after the AGC reaches steady-state.
h = scatterplot(txSig(200:end),1,0,'*'); hold on scatterplot(rxSig(200:end),1,0,'or',h); legend('Input of AGC','Output of AGC')
Measure and compare the power of the transmitted and received signals after the AGC reaches a steady state. The power of the transmitted signal is 100 times smaller than the power of the received signal.
txPower = var(txSig(200:end)); rxPower = var(rxSig(200:end)); [txPower rxPower]
ans = 1×2
0.0100 0.9970
Plot Effect of Step Size on AGC Performance
Create two AGC System objects™ to adjust the level of the received signal using two different step sizes with identical update periods.
Generate an 8-PSK signal such that its power is 10 W.
data = randi([0 7],200,1);
modData = sqrt(10)*pskmod(data,8,pi/8,'gray');
Create a pair of raised cosine matched filters with their Gain
property set so that they have unity output power.
txfilter = comm.RaisedCosineTransmitFilter('Gain',sqrt(8)); rxfilter = comm.RaisedCosineReceiveFilter('Gain',sqrt(1/8));
Filter the modulated signal through the raised cosine transmit filter.
txSig = txfilter(modData);
Create two AGC System objects to adjust the received signal level. Set a step size of 0.01 and 0.1, respectively.
agc1 = comm.AGC('AdaptationStepSize',0.01); agc2 = comm.AGC('AdaptationStepSize',0.1);
Apply AGC to the modulated signal capturing separate outputs for each AGC object.
agcOut1 = agc1(txSig); agcOut2 = agc2(txSig);
Filter the AGC output signals by using the raised cosine receive filter.
rxSig1 = rxfilter(agcOut1); rxSig2 = rxfilter(agcOut2);
Plot the power of the filtered AGC responses while accounting for the 10 symbol delay through the transmit-receive filter pair.
plot([abs(rxSig1(11:110)).^2 abs(rxSig2(11:110)).^2]) grid on xlabel('Symbols') ylabel('Power (W)') legend('Step size 0.01','Step size 0.1')
The signal with the larger step size converges faster to the AGC target power level of 1 W.
Plot the power of the steady-state filtered AGC signals by including only the last 100 symbols. The larger AGC step size results in less accurate gain correction. Larger AGC step size values result in faster convergence at the expense of less accurate gain control.
plot((101:200),[abs(rxSig1(101:200)).^2 abs(rxSig2(101:200)).^2]) grid on xlabel('Symbols') ylabel('Power (W)') legend('Step size 0.01','Step size 0.1')
Demonstrate Effect of Maximum AGC Gain on Packet Data
Pass attenuated QPSK packet data to two AGCs with different maximum gains. Plot the results.
Create two, 200-symbol QPSK data packets. Transmit the packets over a 1200-symbol frame.
modData1 = pskmod(randi([0 3],200,1),4,pi/4); modData2 = pskmod(randi([0 3],200,1),4,pi/4); txSig = [modData1; zeros(400,1); modData2; zeros(400,1)];
Attenuate the transmitted burst signal by 20 dB and plot its power.
rxSig = 0.1*txSig; rxSigPwr = abs(rxSig).^2; plot(rxSigPwr) grid xlabel('Symbols') ylabel('Power (W)') title('Signal Power Before Applying AGC')
Create two AGCs with maximum power gains of 30 dB and 24 dB, respectively.
agc1 = comm.AGC('MaxPowerGain',30,'AdaptationStepSize',0.02); agc2 = comm.AGC('MaxPowerGain',24,'AdaptationStepSize',0.02);
Apply AGC to the attenuated signal capturing separate outputs for each AGC object. Calculate the output power for each case.
rxAGC1 = agc1(rxSig); rxAGC2 = agc2(rxSig); pwrAGC1 = abs(rxAGC1).^2; pwrAGC2 = abs(rxAGC2).^2;
Plot the output powers. Initially, for the second packet, the agc1
output signal power is too high because the AGC applied its maximum gain during the period when no data was transmitted. The corresponding agc2
output signal power (2.5 W) overshoots the target power level of 1 W by significantly less than the agc1
output signal power (10 W). The convergence time for agc2
is shorter than the convergence time for agc1
, because the signal input to agc2
applies a smaller maximum gain than agc1
.
plot([pwrAGC1 pwrAGC2]) legend('AGC1','AGC2') grid xlabel('Symbols') ylabel('Power (W)') title('Signal Power After Applying AGC')
More About
Logarithmic-Loop AGC
The AGC implementation uses a logarithmic feedback loop. As this figure of the logarithmic-loop AGC algorithm shows, the output signal is the product of the input signal and the exponential of the loop gain. The error signal is the difference between the reference level and the product of the logarithm of the detector output and the exponential of the loop gain. After multiplying by the step size, the AGC passes the error signal to an integrator.
The logarithmic-loop AGC performs well for a variety of signal types, including amplitude modulation. The AGC Detector is applied to the input signal, which improves convergence times, but increases signal power variation at the detector input. Large signal variation at the detector input is acceptable for floating-point systems.
Mathematically, the algorithm is summarized as
where:
x is the input signal.
y is the output signal.
g is the loop gain.
Detector(•) is the detector function.
z is the detector output.
A is the reference value.
err is the error signal.
K is the step size.
AGC Detector
The AGC detector output, z, computes a square law detector given by
where N is the update period. The square law detector produces an output proportional to the square of the input signal y.
AGC Performance Criteria
Increasing the step size decreases the attack time and decay times, but it also increases gain pumping.
Attack time — The duration taken for the AGC to respond to an increase in the input amplitude
Decay time — The duration taken for the AGC to respond to a decrease in the input amplitude
Gain pumping — The variation in the gain value during steady-state operation
Tips
This System object is designed for streaming applications.
If the signal amplitude does not change within the frame, you can simulate an ideal AGC by calculating the average gain desired for a frame of samples. Then, apply the gain to each sample in the frame.
If you use the AGC with higher order QAM signals, you might need to reduce the variation in the gain during steady-state operation. Inspect the constellation diagram at the output of the AGC during steady-state operation. You can increase the averaging length to avoid frequent gain adjustments. An increase in averaging length reduces execution speed.
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.
Usage notes and limitations:
See System Objects in MATLAB Code Generation (MATLAB Coder).
Version History
Introduced in R2013a
See Also
Objects
Blocks
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)
Asia Pacific
- Australia (English)
- India (English)
- New Zealand (English)
- 中国
- 日本Japanese (日本語)
- 한국Korean (한국어)