template<typename _realT>
class mx::AO::sim::generalIntegrator< _realT >

Implements a general integrator controller.

document the math for the G.I.

document the filter coefficients, etc.

Template Parameters

_realT is the floating point type for all calculations.

Definition at line 38 of file generalIntegrator.hpp.

#include <ao/sim/generalIntegrator.hpp>

Public Types
typedef _realT	realT
	The real data type.

typedef std::complex< realT >	complexT
	The real data type.

typedef wfMeasurement< realT >	commandT
	The wavefront data type.

typedef Eigen::Array< realT, Eigen::Dynamic, Eigen::Dynamic >	imageT
	The image type, used here as a general storage array.

Public Member Functions
	generalIntegrator ()
	Default c'tor.

int	initialize (int nModes)
	Allocate and initialize all state.

int	nModes ()
	Get the number of modes.

int	openLoop (bool ol)
	Set the m_openLoop flag.

bool	openLoop ()
	Get the value of the m_openLoop flag.

int	openLoopDelay (int cr)
	Set the open loop delay.

int	openLoopDelay ()
	Get the value of the m_openLoopDelay.

int	closingRamp (int cr)
	Set the closing ramp.

int	closingRamp ()
	Get the value of the m_closingRamp.

int	closingDelay (int cd)
	Set the closing delay.

int	closingDelay ()
	Get the value of the m_closingDelay.

int	closingGains (const std::vector< realT > &gains)
	Set the simple integrator gains to use during closing.

int	closingGains (realT g)
	Set the simple integrator gain to use for all modes during closing.

int	lowOrders (int lo)
	Set m_lowOrders.

int	lowOrders ()
	Get the value of the m_lowOrders.

int	setASize (int n)
	Set the size of the IIR vector (the a coefficients)

int	setA (int i, const imageT &a)
	Set the IIR coefficients for one mode.

int	setBSize (int n)
	Set the size of the FIR vector (the b coefficients)

int	setB (int i, const imageT &b)
	Set the FIR coefficients for one mode.

realT	gain (int i)
	Get the gain for a single mode.

int	gain (int i, realT g)
	Set the gain for a single mode.

int	gains (realT g)
	Set the gain for all modes to a single value.

int	gains (const std::vector< realT > &gains)
	Set the gains for all modes, using a vector to specify each gain.

int	gains (const std::string &ogainf)
	Set the gains for all modes, using a file to specify each gain.

int	initMeasurements (commandT &filtAmps, commandT &rawAmps)
	Allocate the provided command structures.

Protected Attributes
int	m_nModes { 0 }
	The number of modes being filtered.

bool	m_openLoop { false }
	If true, then commands are not integrated. Default is false.

int	m_openLoopDelay { 0 }
	If > 0, then the loop is open for this time in time steps. Default is 0.

int	m_closingRamp { 0 }

int	m_closingDelay { 0 }

imageT	m_closingGains
	Column-vector of gains used for loop closing as simple integrator.

int	m_lowOrders { 0 }

imageT	m_gains
	Column-vector of gains.

Member Typedef Documentation

◆ commandT

template<typename _realT >

typedef wfMeasurement<realT> mx::AO::sim::generalIntegrator< _realT >::commandT

The wavefront data type.

The command type

Definition at line 52 of file generalIntegrator.hpp.

◆ complexT

template<typename _realT >

typedef std::complex<realT> mx::AO::sim::generalIntegrator< _realT >::complexT

The real data type.

Definition at line 46 of file generalIntegrator.hpp.

◆ imageT

template<typename _realT >

typedef Eigen::Array<realT, Eigen::Dynamic, Eigen::Dynamic> mx::AO::sim::generalIntegrator< _realT >::imageT

The image type, used here as a general storage array.

Definition at line 55 of file generalIntegrator.hpp.

◆ realT

template<typename _realT >

typedef _realT mx::AO::sim::generalIntegrator< _realT >::realT

The real data type.

Definition at line 43 of file generalIntegrator.hpp.

Constructor & Destructor Documentation

◆ generalIntegrator()

template<typename realT >

mx::AO::sim::generalIntegrator< realT >::generalIntegrator ( )

Default c'tor.

Definition at line 262 of file generalIntegrator.hpp.

Member Function Documentation

◆ closingDelay() [1/2]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::closingDelay ( )

Get the value of the m_closingDelay.

Returns: the current value of m_closingDelay.

Definition at line 362 of file generalIntegrator.hpp.

◆ closingDelay() [2/2]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::closingDelay ( int cd )

Set the closing delay.

If m_closingDelay > 0, then the simple integragor is used until this timestep.

Returns: 0 on success, a negative integer on error.

Parameters

[in] cd The new value of m_closingDelay

Definition at line 354 of file generalIntegrator.hpp.

◆ closingGains() [1/2]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::closingGains ( const std::vector< realT > & gains )

Set the simple integrator gains to use during closing.

Returns: 0 on success; < 0 on error

Return values

-1	on vector size mismatch

Parameters

[in] gains vector of gains.

Definition at line 368 of file generalIntegrator.hpp.

◆ closingGains() [2/2]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::closingGains ( realT g )

Set the simple integrator gain to use for all modes during closing.

Returns: 0 on success; < 0 on error

Definition at line 386 of file generalIntegrator.hpp.

◆ closingRamp() [1/2]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::closingRamp ( )

Get the value of the m_closingRamp.

Returns: the current value of m_closingRamp.

Definition at line 348 of file generalIntegrator.hpp.

◆ closingRamp() [2/2]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::closingRamp ( int cr )

Set the closing ramp.

If m_closingRamp > 0, then the gains are ramped linearly up to m_closingGains over this timer interval in timesteps. Requires m_closingDelay > 0.

Returns: 0 on success, a negative integer on error.

Parameters

[in] cr The new value of m_closingRamp

Definition at line 340 of file generalIntegrator.hpp.

◆ gain() [1/2]

template<class realT >

realT mx::AO::sim::generalIntegrator< realT >::gain ( int i )

Get the gain for a single mode.

Returns: the gain value if mode exists.

Return values

0	if the mode doesn't exist.

Parameters

i	The mode number

Definition at line 471 of file generalIntegrator.hpp.

◆ gain() [2/2]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::gain	(	int	i,
		realT	g
	)

Set the gain for a single mode.

Returns: 0 on success, negative number on error.

Return values

0	if the mode doesn't exist.

Parameters

i	The mode number
g	The new gain value

Definition at line 483 of file generalIntegrator.hpp.

◆ gains() [1/3]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::gains ( const std::string & ogainf )

Set the gains for all modes, using a file to specify each gain.

The file format is a simple ASCII single column, with 1 gain per line. Must be exactly as long as m_nModes.

Returns: 0 on success, negative number on error.

Return values

-1	if file open fails

Parameters

[in] ogainf the name of the file, full path

Definition at line 526 of file generalIntegrator.hpp.

◆ gains() [2/3]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::gains ( const std::vector< realT > & gains )

Set the gains for all modes, using a vector to specify each gain.

The vector must be exactly as long as m_nModes.

Returns: 0 on success, negative number on error.

Return values

-1	on vector size mismatch

Parameters

[in] gains vector of gains.

Definition at line 508 of file generalIntegrator.hpp.

◆ gains() [3/3]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::gains ( realT g )

Set the gain for all modes to a single value.

Returns: 0 on success, negative number on error.

Parameters

g	The new gain value

Definition at line 497 of file generalIntegrator.hpp.

◆ initialize()

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::initialize ( int nModes )

Allocate and initialize all state.

Returns: 0 on success, a negative integer otherwise.

Parameters

[in] nModes the number of modes to be filtered

Definition at line 267 of file generalIntegrator.hpp.

◆ initMeasurements()

template<class realT >

int mx::AO::sim::generalIntegrator< realT >::initMeasurements	(	commandT &	filtAmps,
		commandT &	rawAmps
	)

Allocate the provided command structures.

Used by the calling system to allocate the commands being passed between components.

Returns: 0 on success, negative number on error.

Parameters

filtAmps	The structure to contain the filtered commands
rawAmps	The structure to contain the raw commands

Definition at line 550 of file generalIntegrator.hpp.

◆ lowOrders() [1/2]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::lowOrders ( )

Get the value of the m_lowOrders.

Returns: the current value of m_lowOrders.

Definition at line 405 of file generalIntegrator.hpp.

◆ lowOrders() [2/2]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::lowOrders ( int lo )

Set m_lowOrders.

If m_lowOrders > 0, then this sets the maximum mode number which is filtered. All remaining modes are set to 0.

Returns: 0 on success, a negative integer on error.

Parameters

[in] lo The new value of m_lowOrders

Definition at line 397 of file generalIntegrator.hpp.

◆ nModes()

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::nModes ( )

Get the number of modes.

nModes is only set by calling initialize.

Returns: the current value of m_nModes

Definition at line 307 of file generalIntegrator.hpp.

◆ openLoop() [1/2]

template<typename realT >

bool mx::AO::sim::generalIntegrator< realT >::openLoop ( )

Get the value of the m_openLoop flag.

Returns: the current value of m_openLoop.

Definition at line 320 of file generalIntegrator.hpp.

◆ openLoop() [2/2]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::openLoop ( bool ol )

Set the m_openLoop flag.

If m_openLoop is true, then commands are not filtered.

Returns: 0 on success, a negative integer on error.

Parameters

[in] ol the new value of m_openLoop

Definition at line 313 of file generalIntegrator.hpp.

◆ openLoopDelay() [1/2]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::openLoopDelay ( )

Get the value of the m_openLoopDelay.

Returns: the current value of m_openLoopDelay.

Definition at line 334 of file generalIntegrator.hpp.

◆ openLoopDelay() [2/2]

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::openLoopDelay ( int cr )

Set the open loop delay.

If m_openLoopDelay > 0, then the loop is open for this period in time-steps Requires m_closingDelay > 0.

Returns: 0 on success, a negative integer on error.

Parameters

[in] cr The new value of m_openLoopDelay

Definition at line 326 of file generalIntegrator.hpp.

◆ setA()

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::setA	(	int	i,
		const imageT &	a
	)

Set the IIR coefficients for one mode.

Returns: 0 on success, negative number on error.

Parameters

[in]	i	the mode number
[in]	a	the IIR coefficients for this mode

Definition at line 433 of file generalIntegrator.hpp.

◆ setASize()

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::setASize ( int n )

Set the size of the IIR vector (the a coefficients)

This allocates m_a to be m_nModes X n in size.

Returns: 0 on success, negative number on error.

Parameters

[in] n the number of IIR coefficients

Definition at line 411 of file generalIntegrator.hpp.

◆ setB()

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::setB	(	int	i,
		const imageT &	b
	)

Set the FIR coefficients for one mode.

Returns: 0 on success, negative number on error.

Parameters

[in]	i	the mode number
[in]	b	the IIR coefficients for this mode

Definition at line 463 of file generalIntegrator.hpp.

◆ setBSize()

template<typename realT >

int mx::AO::sim::generalIntegrator< realT >::setBSize ( int n )

Set the size of the FIR vector (the b coefficients)

This allocates m_b to be m_nModes X n in size.

Returns: 0 on success, negative number on error.

Parameters

[in] n the number of FIR coefficients

Definition at line 441 of file generalIntegrator.hpp.

Member Data Documentation

◆ m_closingDelay

template<typename _realT >

int mx::AO::sim::generalIntegrator< _realT >::m_closingDelay { 0 }

protected

If > 0, then the simple integrator,with m_closingGains is used up to this timestep. This is relative m_openLoopDelay. Default = 0.

Definition at line 70 of file generalIntegrator.hpp.

◆ m_closingGains

template<typename _realT >

imageT mx::AO::sim::generalIntegrator< _realT >::m_closingGains

protected

Column-vector of gains used for loop closing as simple integrator.

Definition at line 73 of file generalIntegrator.hpp.

◆ m_closingRamp

template<typename _realT >

int mx::AO::sim::generalIntegrator< _realT >::m_closingRamp { 0 }

protected

If > 0, then gains are famped linearly up to m_closingGains over this interval in time steps. Default is 0. This is relative m_openLoopDelay.

Definition at line 67 of file generalIntegrator.hpp.

◆ m_gains

template<typename _realT >

imageT mx::AO::sim::generalIntegrator< _realT >::m_gains

protected

Column-vector of gains.

Definition at line 84 of file generalIntegrator.hpp.

◆ m_lowOrders

template<typename _realT >

int mx::AO::sim::generalIntegrator< _realT >::m_lowOrders { 0 }

protected

If > 0, then this sets the maximum mode number which is filtered. All remaining modes are set to 0. Default = 0.

Definition at line 75 of file generalIntegrator.hpp.

◆ m_nModes

template<typename _realT >

int mx::AO::sim::generalIntegrator< _realT >::m_nModes { 0 }

protected

The number of modes being filtered.

Definition at line 61 of file generalIntegrator.hpp.

◆ m_openLoop

template<typename _realT >

bool mx::AO::sim::generalIntegrator< _realT >::m_openLoop { false }

protected

If true, then commands are not integrated. Default is false.

Definition at line 63 of file generalIntegrator.hpp.

◆ m_openLoopDelay

template<typename _realT >

int mx::AO::sim::generalIntegrator< _realT >::m_openLoopDelay { 0 }

protected

If > 0, then the loop is open for this time in time steps. Default is 0.

Definition at line 65 of file generalIntegrator.hpp.

The documentation for this class was generated from the following file:

ao/sim/generalIntegrator.hpp

Public Types

Public Member Functions

Protected Attributes

Member Typedef Documentation

◆ commandT

◆ complexT

◆ imageT

◆ realT

Constructor & Destructor Documentation

◆ generalIntegrator()

Member Function Documentation

◆ closingDelay() [1/2]

◆ closingDelay() [2/2]

◆ closingGains() [1/2]

◆ closingGains() [2/2]

◆ closingRamp() [1/2]

◆ closingRamp() [2/2]

◆ gain() [1/2]

◆ gain() [2/2]

◆ gains() [1/3]

◆ gains() [2/3]

◆ gains() [3/3]

◆ initialize()

◆ initMeasurements()

◆ lowOrders() [1/2]

◆ lowOrders() [2/2]

◆ nModes()

◆ openLoop() [1/2]

◆ openLoop() [2/2]

◆ openLoopDelay() [1/2]

◆ openLoopDelay() [2/2]

◆ setA()

◆ setASize()

◆ setB()

◆ setBSize()

Member Data Documentation

◆ m_closingDelay

◆ m_closingGains

◆ m_closingRamp

◆ m_gains

◆ m_lowOrders

◆ m_nModes

◆ m_openLoop

◆ m_openLoopDelay