Voltage source with optional DC, AC and noise components
Simscape / Electrical / Sources
The Voltage Source block implements a voltage source with DC, AC, and noise components. The voltage across the + and – terminals is given by:
vDC is the steady-state DC voltage component.
vAC is the amplitude of the AC voltage component.
f is the frequency of the AC component.
ϕ is the phase offset of the AC component.
vN is the noise voltage.
You can configure your source as DC-only, AC-only, or a combination of both. By default, both AC and DC components are set to 0. Define the AC/DC voltage by specifying nonzero parameter values after placing the block in your model.
The noise component is also optional. If you set the Noise mode
Enabled, then the added noise voltage is given
Pv is the single-sided noise power spectral density for a 1 ohm load, in V^2/Hz.
N is a Gaussian random number with zero mean and standard deviation of one.
h is the sampling interval.
By default, the Noise mode parameter is set to
Disabled, and the voltage source generates no thermal
The block generates Gaussian noise by using the PS Random Number source in the Simscape™ Foundation library. You can control the random number seed by setting the Repeatability parameter:
Not repeatable— Every time you simulate your model, the block resets the random seed using the MATLAB® random number generator:
seed = randi(2^32-1);
Repeatable— The block automatically generates a seed value and stores it inside the block, to always start the simulation with the same random number. This auto-generated seed value is set when you add a Voltage Source block from the block library to the model. When you make a new copy of the Voltage Source block from an existing one in a model, a new seed value is generated. The block sets the value using the MATLAB random number generator command shown above.
Specify seed— If you select this option, the additional Seed parameter lets you directly specify the random number seed value.
Assumptions and Limitations
Simulating with noise enabled slows down simulation. Choose the sample time (h) so that noise is generated only at frequencies of interest, and not higher.
+ — Positive port
Electrical conserving port associated with the voltage source positive terminal
- — Negative port
Electrical conserving port associated with the voltage source negative terminal
DC & AC Components
DC voltage — DC output voltage
DC component of the output voltage. Specify a nonzero value to add a DC component to the voltage source.
AC voltage peak amplitude — AC voltage amplitude
Amplitude of the AC component of the output voltage. Specify a nonzero value to add an AC component to the voltage source.
AC voltage phase shift — AC voltage phase offset
Phase offset of the AC component of the output voltage.
AC voltage frequency — AC voltage frequency
Frequency of the AC component of the output voltage, in Hz.
Noise mode — Noise option
Disabled (default) |
Select the noise option:
Disabled— No noise is produced by the voltage source.
Enabled— The voltage source generates thermal noise, and the associated parameters become visible on the Noise tab.
Power spectral density — Power spectral density
The single-sided spectrum noise power. Strictly-speaking, this is a density function for the square of the voltage, commonly thought of as a power into a 1 ohm load, and therefore the units are V^2/Hz. To avoid this unit ambiguity, some datasheets quote noise voltage as a noise density with units of V/√Hz. In this case, you should enter the square of the noise density quoted in the datasheet as the parameter value.
Repeatability — Noise control option
Not repeatable (default) |
Select the noise control option:
Not repeatable— The random sequence used for noise generation is not repeatable.
Repeatable— The random sequence used for noise generation is repeatable, with a system-generated seed.
Specify seed— The random sequence used for noise generation is repeatable, and you control the seed by using the Seed parameter.
Auto-generated seed used for repeatable option — Auto-generated random number seed
Random number seed stored inside the block to make the random sequence repeatable.
The parameter value is automatically generated using the MATLAB random number generator command. You can modify this parameter value,
but it gets overwritten by a new random value if you copy the block to another block
in the model. Therefore, if you want to control the seed of the random sequence, use
Specify seed option for the
Repeatability parameter and specify the desired seed value
using the Seed parameter.
This parameter is visible only when you select
Repeatable for the Repeatability parameter.
Seed — Random number seed
Random number seed used by the noise random number generator.
This parameter is visible only when you select
seed for the Repeatability parameter.
Sample time — Sample time
Defines the rate at which the noise source is sampled. Choose it to reflect the frequencies of interest in your model. Making the sample time too small will unnecessarily slow down your simulation.