frc::BangBangController Class Reference

Implements a bang-bang controller, which outputs either 0 or 1 depending on whether the measurement is less than the setpoint. More...

#include <frc/controller/BangBangController.h>

Inheritance diagram for frc::BangBangController:

Public Member Functions
constexpr	BangBangController (double tolerance=std::numeric_limits< double >::infinity())
	Creates a new bang-bang controller.
constexpr void	SetSetpoint (double setpoint)
	Sets the setpoint for the bang-bang controller.
constexpr double	GetSetpoint () const
	Returns the current setpoint of the bang-bang controller.
constexpr bool	AtSetpoint () const
	Returns true if the error is within the tolerance of the setpoint.
constexpr void	SetTolerance (double tolerance)
	Sets the error within which AtSetpoint will return true.
constexpr double	GetTolerance () const
	Returns the current tolerance of the controller.
constexpr double	GetMeasurement () const
	Returns the current measurement of the process variable.
constexpr double	GetError () const
	Returns the current error.
constexpr double	Calculate (double measurement, double setpoint)
	Returns the calculated control output.
constexpr double	Calculate (double measurement)
	Returns the calculated control output.
void	InitSendable (wpi::SendableBuilder &builder) override
	Initializes this Sendable object.
Public Member Functions inherited from wpi::Sendable
virtual constexpr	~Sendable ()=default
Public Member Functions inherited from wpi::SendableHelper< BangBangController >
constexpr	SendableHelper (const SendableHelper &rhs)=default
constexpr	SendableHelper (SendableHelper &&rhs)
constexpr SendableHelper &	operator= (const SendableHelper &rhs)=default
constexpr SendableHelper &	operator= (SendableHelper &&rhs)

Additional Inherited Members
Protected Member Functions inherited from wpi::SendableHelper< BangBangController >
constexpr	SendableHelper ()=default
constexpr	~SendableHelper ()

Detailed Description

Implements a bang-bang controller, which outputs either 0 or 1 depending on whether the measurement is less than the setpoint.

This maximally-aggressive control approach works very well for velocity control of high-inertia mechanisms, and poorly on most other things.

Note that this is an asymmetric bang-bang controller - it will not exert any control effort in the reverse direction (e.g. it won't try to slow down an over-speeding shooter wheel). This asymmetry is extremely important. Bang-bang control is extremely simple, but also potentially hazardous. Always ensure that your motor controllers are set to "coast" before attempting to control them with a bang-bang controller.

Constructor & Destructor Documentation

BangBangController()

frc::BangBangController::BangBangController ( double tolerance = std::numeric_limits<double>::infinity() )

inlineexplicitconstexpr

Creates a new bang-bang controller.

Always ensure that your motor controllers are set to "coast" before attempting to control them with a bang-bang controller.

Parameters

tolerance

Tolerance for atSetpoint.

Member Function Documentation

AtSetpoint()

bool frc::BangBangController::AtSetpoint ( ) const

inlineconstexpr

Returns true if the error is within the tolerance of the setpoint.

Returns

Whether the error is within the acceptable bounds.

Calculate() [1/2]

double frc::BangBangController::Calculate ( double measurement )

inlineconstexpr

Returns the calculated control output.

Parameters

measurement

The most recent measurement of the process variable.

Returns

The calculated motor output (0 or 1).

Calculate() [2/2]

double frc::BangBangController::Calculate ( double measurement, double setpoint )

inlineconstexpr

Returns the calculated control output.

Always ensure that your motor controllers are set to "coast" before attempting to control them with a bang-bang controller.

Parameters

measurement	The most recent measurement of the process variable.
setpoint	The setpoint for the process variable.

Returns

The calculated motor output (0 or 1).

GetError()

double frc::BangBangController::GetError ( ) const

inlineconstexpr

Returns the current error.

Returns

The current error.

GetMeasurement()

double frc::BangBangController::GetMeasurement ( ) const

inlineconstexpr

Returns the current measurement of the process variable.

Returns

The current measurement of the process variable.

GetSetpoint()

double frc::BangBangController::GetSetpoint ( ) const

inlineconstexpr

Returns the current setpoint of the bang-bang controller.

Returns

The current setpoint.

GetTolerance()

double frc::BangBangController::GetTolerance ( ) const

inlineconstexpr

Returns the current tolerance of the controller.

Returns

The current tolerance.

InitSendable()

void frc::BangBangController::InitSendable ( wpi::SendableBuilder & builder )

overridevirtual

Initializes this Sendable object.

Parameters

builder

sendable builder

Implements wpi::Sendable.

SetSetpoint()

void frc::BangBangController::SetSetpoint ( double setpoint )

inlineconstexpr

Sets the setpoint for the bang-bang controller.

Parameters

setpoint

The desired setpoint.

SetTolerance()

void frc::BangBangController::SetTolerance ( double tolerance )

inlineconstexpr

Sets the error within which AtSetpoint will return true.

Parameters

tolerance

Position error which is tolerable.

---

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

• frc/controller/BangBangController.h