Returns the total spectral average power injected into the simulation by the source. See the Units and normalization - Spectral averaging section for more information.
This script function calculates the following quantities, depending on whether the normalization state is cwnorm or nonorm:
$$ \text {sourcepower}_{-}{\text {avg}_{nonorm}}=\int_{0}^{+\infty} \text {sourcepower}_{nonorm}(\omega) d\omega $$
$$ \text {sourcepower}_{-}{\text {avg}_{cwnorm}}(f)=\frac{\int_{0}^{+\infty}|s(\omega)|^2 \text {sourcepower}_{cwnorm}(\omega) d\omega}{\int_{0}^{+\infty}|s(\omega)|^2d\omega} $$
where sourcepower is the quantity returned by the sourcepower script function, s(w) is returned by sourcenorm, and ω=2πf. Typically, this function should be used in the cwnorm state. Also see the sourcenorm2_pavg script function.
|
Syntax |
Description |
|---|---|
|
out = sourcepower_avg; |
Returns the spectrally averaged source power as defined above. |
|
out = sourcepower_avg(option); |
The additional argument, option, can have a value of 1 or 2. If it is 2, the data is unfolded where possible according to the symmetry or anti-symmetric boundaries if it comes from a monitor that intersect such a boundary at x min, y min or z min. The default value of option is 2. |
|
out = sourcepower_avg(option, "sourcename"); |
This option allows you to obtain the spectrum of one source, rather than the sum of all sources. This option is only needed for simulations with multiple sources. |
Example
Please refer to sourcepower and Spectral averaging - Usage
See Also
sourcenorm2_avg, sourcepower, sourcepower_pavg, transmission_avg, sourceintensity_avg, cwnorm, nonorm, Units and Normalization, Spectral averaging