cbadc.datasets.chain_of_integrators.ChainOfIntegrators

class cbadc.datasets.chain_of_integrators.ChainOfIntegrators(N: int = 5, beta: float = 6250.0, rho: float = 0.0, kappa: float = 1.0)

Bases: object

Control-bounded Chain-of-integrators ADC example.

This class instantiates the chain-of-integrators control-bounded ADC which was frequently used in

Furthermore, many pre-computed control-signals can be conveniently be accessed through the cbadc.datasets.chain_of_integrators.ChainOfIntegrators.sin() and cbadc.datasets.chain_of_integrators.ChainOfIntegrators.ramp() methods.

Parameters
  • N (int) – number of analog states, (for the chain-of-integrator this also determines M=N), defaults to N=5.

  • beta (float) – the integration slope or amplification, defaults to beta=6250.

  • rho (float) – the local feedback term, defaults to rho=0.

  • kappa (float) – the control gain, defaults to kappa=1

Methods

__init__([N, beta, rho, kappa])

ramp(amplitude, frequency[, phase, offset])

Provide control signals and simulation settings for a ramp input signal.

sin(amplitude, frequency[, phase, offset])

Provide control signals and simulation settings for a sinusoidal input signal.

ramp(amplitude: float, frequency: float, phase: float = 0.0, offset: float = 0.0)

Provide control signals and simulation settings for a ramp input signal.

Specifically for an input signal

\(u(t) = \mathrm{amplitude} \cdot \mathrm{ramp}(t / \mathrm{frequency} + \mathrm{phase}) + \mathrm{offset}\)

where \(\mathrm{ramp}(\cdot)\) is an unit-scale ramp function.

Parameters
  • amplitude (float) –

  • frequency (float) – specified in [Hz].

  • phase (float) – defaults to phase=0.

  • offset (float) – defaults to offset=0.

Returns

  • control_signal (Generator[np.ndarray, None, None]) – a control signal sequence, possibly retrived over http.

  • simulator (cbadc.simulator.StateSpaceSimulator) – an instantated simulator.

  • size (int) – the maximum length of the simulation (1G control signal samples)

sin(amplitude: float, frequency: float, phase: float = 0.0, offset: float = 0.0)

Provide control signals and simulation settings for a sinusoidal input signal.

Specifically for an input signal

\(u(t) = \mathrm{amplitude} \cdot \sin(2 \pi \mathrm{frequency} t + \mathrm{phase}) + \mathrm{offset}\)

the resulting simulator and possibly pre-computed control-signals are retrived.

Parameters
  • amplitude (float) –

  • frequency (float) – specified in [Hz].

  • phase (float) – defaults to phase=0.

  • offset (float) – defaults to offset=0.

Returns

  • control_signal (Generator[np.ndarray, None, None]) – a control signal sequence, possibly retrived over http.

  • simulator (cbadc.simulator.StateSpaceSimulator) – an instantated simulator.

  • size (int) – the maximum length of the simulation (1G control signal samples)