Implements a PID control loop. More...

#include <frc/controller/PIDController.h>

Inheritance diagram for frc2::PIDController:

Public Member Functions
	PIDController (double Kp, double Ki, double Kd, units::second_t period=20_ms)
	Allocates a PIDController with the given constants for Kp, Ki, and Kd. More...

	~PIDController () override=default

	PIDController (const PIDController &)=default

PIDController &	operator= (const PIDController &)=default

	PIDController (PIDController &&)=default

PIDController &	operator= (PIDController &&)=default

void	SetPID (double Kp, double Ki, double Kd)
	Sets the PID Controller gain parameters. More...

void	SetP (double Kp)
	Sets the proportional coefficient of the PID controller gain. More...

void	SetI (double Ki)
	Sets the integral coefficient of the PID controller gain. More...

void	SetD (double Kd)
	Sets the differential coefficient of the PID controller gain. More...

void	SetIZone (double iZone)
	Sets the IZone range. More...

double	GetP () const
	Gets the proportional coefficient. More...

double	GetI () const
	Gets the integral coefficient. More...

double	GetD () const
	Gets the differential coefficient. More...

double	GetIZone () const
	Get the IZone range. More...

units::second_t	GetPeriod () const
	Gets the period of this controller. More...

double	GetPositionTolerance () const
	Gets the position tolerance of this controller. More...

double	GetVelocityTolerance () const
	Gets the velocity tolerance of this controller. More...

void	SetSetpoint (double setpoint)
	Sets the setpoint for the PIDController. More...

double	GetSetpoint () const
	Returns the current setpoint of the PIDController. More...

bool	AtSetpoint () const
	Returns true if the error is within the tolerance of the setpoint. More...

void	EnableContinuousInput (double minimumInput, double maximumInput)
	Enables continuous input. More...

void	DisableContinuousInput ()
	Disables continuous input. More...

bool	IsContinuousInputEnabled () const
	Returns true if continuous input is enabled. More...

void	SetIntegratorRange (double minimumIntegral, double maximumIntegral)
	Sets the minimum and maximum values for the integrator. More...

void	SetTolerance (double positionTolerance, double velocityTolerance=std::numeric_limits< double >::infinity())
	Sets the error which is considered tolerable for use with AtSetpoint(). More...

double	GetPositionError () const
	Returns the difference between the setpoint and the measurement. More...

double	GetVelocityError () const
	Returns the velocity error. More...

double	Calculate (double measurement)
	Returns the next output of the PID controller. More...

double	Calculate (double measurement, double setpoint)
	Returns the next output of the PID controller. More...

void	Reset ()
	Reset the previous error, the integral term, and disable the controller. More...

void	InitSendable (wpi::SendableBuilder &builder) override
	Initializes this Sendable object. More...

Public Member Functions inherited from wpi::Sendable
virtual	~Sendable ()=default

virtual void	InitSendable (SendableBuilder &builder)=0
	Initializes this Sendable object. More...

Public Member Functions inherited from wpi::SendableHelper< PIDController >
	SendableHelper (const SendableHelper &rhs)=default

	SendableHelper (SendableHelper &&rhs)

SendableHelper &	operator= (const SendableHelper &rhs)=default

SendableHelper &	operator= (SendableHelper &&rhs)

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

	~SendableHelper ()

Detailed Description

Implements a PID control loop.

Constructor & Destructor Documentation

◆ PIDController() [1/3]

frc2::PIDController::PIDController	(	double	Kp,
		double	Ki,
		double	Kd,
		units::second_t	period = `20_ms`
	)

Allocates a PIDController with the given constants for Kp, Ki, and Kd.

Parameters

Kp	The proportional coefficient.
Ki	The integral coefficient.
Kd	The derivative coefficient.
period	The period between controller updates in seconds. The default is 20 milliseconds. Must be non-zero and positive.

◆ ~PIDController()

frc2::PIDController::~PIDController ( )

overridedefault

◆ PIDController() [2/3]

frc2::PIDController::PIDController ( const PIDController & )

default

◆ PIDController() [3/3]

frc2::PIDController::PIDController ( PIDController && )

default

Member Function Documentation

◆ AtSetpoint()

bool frc2::PIDController::AtSetpoint ( ) const

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

This will return false until at least one input value has been computed.

◆ Calculate() [1/2]

double frc2::PIDController::Calculate ( double measurement )

Returns the next output of the PID controller.

Parameters

measurement The current measurement of the process variable.

◆ Calculate() [2/2]

double frc2::PIDController::Calculate	(	double	measurement,
		double	setpoint
	)

Returns the next output of the PID controller.

Parameters

measurement	The current measurement of the process variable.
setpoint	The new setpoint of the controller.

◆ DisableContinuousInput()

void frc2::PIDController::DisableContinuousInput ( )

Disables continuous input.

◆ EnableContinuousInput()

void frc2::PIDController::EnableContinuousInput	(	double	minimumInput,
		double	maximumInput
	)

Enables continuous input.

Rather then using the max and min input range as constraints, it considers them to be the same point and automatically calculates the shortest route to the setpoint.

Parameters

minimumInput	The minimum value expected from the input.
maximumInput	The maximum value expected from the input.

◆ GetD()

double frc2::PIDController::GetD ( ) const

Gets the differential coefficient.

Returns: differential coefficient

◆ GetI()

double frc2::PIDController::GetI ( ) const

Gets the integral coefficient.

Returns: integral coefficient

◆ GetIZone()

double frc2::PIDController::GetIZone ( ) const

Get the IZone range.

Returns: Maximum magnitude of error to allow integral control.

◆ GetP()

double frc2::PIDController::GetP ( ) const

Gets the proportional coefficient.

Returns: proportional coefficient

◆ GetPeriod()

units::second_t frc2::PIDController::GetPeriod ( ) const

Gets the period of this controller.

Returns: The period of the controller.

◆ GetPositionError()

double frc2::PIDController::GetPositionError ( ) const

Returns the difference between the setpoint and the measurement.

◆ GetPositionTolerance()

double frc2::PIDController::GetPositionTolerance ( ) const

Gets the position tolerance of this controller.

Returns: The position tolerance of the controller.

◆ GetSetpoint()

double frc2::PIDController::GetSetpoint ( ) const

Returns the current setpoint of the PIDController.

Returns: The current setpoint.

◆ GetVelocityError()

double frc2::PIDController::GetVelocityError ( ) const

Returns the velocity error.

◆ GetVelocityTolerance()

double frc2::PIDController::GetVelocityTolerance ( ) const

Gets the velocity tolerance of this controller.

Returns: The velocity tolerance of the controller.

◆ InitSendable()

void frc2::PIDController::InitSendable ( wpi::SendableBuilder & builder )

overridevirtual

Initializes this Sendable object.

Parameters

builder sendable builder

Implements wpi::Sendable.

◆ IsContinuousInputEnabled()

bool frc2::PIDController::IsContinuousInputEnabled ( ) const

Returns true if continuous input is enabled.

◆ operator=() [1/2]

PIDController & frc2::PIDController::operator= ( const PIDController & )

default

◆ operator=() [2/2]

PIDController & frc2::PIDController::operator= ( PIDController && )

default

◆ Reset()

void frc2::PIDController::Reset ( )

Reset the previous error, the integral term, and disable the controller.

◆ SetD()

void frc2::PIDController::SetD ( double Kd )

Sets the differential coefficient of the PID controller gain.

Parameters

Kd	differential coefficient

◆ SetI()

void frc2::PIDController::SetI ( double Ki )

Sets the integral coefficient of the PID controller gain.

Parameters

Ki	integral coefficient

◆ SetIntegratorRange()

void frc2::PIDController::SetIntegratorRange	(	double	minimumIntegral,
		double	maximumIntegral
	)

Sets the minimum and maximum values for the integrator.

When the cap is reached, the integrator value is added to the controller output rather than the integrator value times the integral gain.

Parameters

minimumIntegral	The minimum value of the integrator.
maximumIntegral	The maximum value of the integrator.

◆ SetIZone()

void frc2::PIDController::SetIZone ( double iZone )

Sets the IZone range.

When the absolute value of the position error is greater than IZone, the total accumulated error will reset to zero, disabling integral gain until the absolute value of the position error is less than IZone. This is used to prevent integral windup. Must be non-negative. Passing a value of zero will effectively disable integral gain. Passing a value of infinity disables IZone functionality.

Parameters

iZone Maximum magnitude of error to allow integral control.

◆ SetP()

void frc2::PIDController::SetP ( double Kp )

Sets the proportional coefficient of the PID controller gain.

Parameters

Kp	proportional coefficient

◆ SetPID()

void frc2::PIDController::SetPID	(	double	Kp,
		double	Ki,
		double	Kd
	)

Sets the PID Controller gain parameters.

Sets the proportional, integral, and differential coefficients.

Parameters

Kp	Proportional coefficient
Ki	Integral coefficient
Kd	Differential coefficient

◆ SetSetpoint()

void frc2::PIDController::SetSetpoint ( double setpoint )

Sets the setpoint for the PIDController.

Parameters

setpoint The desired setpoint.

◆ SetTolerance()

void frc2::PIDController::SetTolerance	(	double	positionTolerance,
		double	velocityTolerance = `std::numeric_limits< double >::infinity()`
	)

Sets the error which is considered tolerable for use with AtSetpoint().

Parameters

positionTolerance	Position error which is tolerable.
velocityTolerance	Velocity error which is tolerable.

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

frc/controller/PIDController.h

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ PIDController() [1/3]

◆ ~PIDController()

◆ PIDController() [2/3]

◆ PIDController() [3/3]

Member Function Documentation

◆ AtSetpoint()

◆ Calculate() [1/2]

◆ Calculate() [2/2]

◆ DisableContinuousInput()

◆ EnableContinuousInput()

◆ GetD()

◆ GetI()

◆ GetIZone()

◆ GetP()

◆ GetPeriod()

◆ GetPositionError()

◆ GetPositionTolerance()

◆ GetSetpoint()

◆ GetVelocityError()

◆ GetVelocityTolerance()

◆ InitSendable()

◆ IsContinuousInputEnabled()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ Reset()

◆ SetD()

◆ SetI()

◆ SetIntegratorRange()

◆ SetIZone()

◆ SetP()

◆ SetPID()

◆ SetSetpoint()

◆ SetTolerance()