In this experiment, the working electrode holds at a starting potential during the quiet time. Then it applies a train of pulses superimposed on a staircase waveform, with a uniform potential step size. The potential continues to step until the final potential is reached. More...

#include <AisDiffPulseVoltammetryElement.h>

Public Member Functions
	AisDiffPulseVoltammetryElement (double startVoltage, double endVoltage, double voltageStep, double pulseHeight, double pulseWidth, double pulsePeriod, double approxMaxCurrent)
	the differential pulse element constructor.

	AisDiffPulseVoltammetryElement (double startVoltage, double endVoltage, double voltageStep, double pulseHeight, double pulseWidth, double pulsePeriod)
	the differential pulse element constructor.

	AisDiffPulseVoltammetryElement (const AisDiffPulseVoltammetryElement &)
	copy constructor for the AisDiffPulseVoltammetryElement object.

AisDiffPulseVoltammetryElement &	operator= (const AisDiffPulseVoltammetryElement &)
	overload equal to operator for the AisDiffPulseVoltammetryElement object.

QString	getName () const override
	get the name of the element.

QStringList	getCategory () const override
	get a list of applicable categories of the element.

double	getQuietTime () const
	Gets the quiet time duration.

void	setQuietTime (double quietTime)
	Sets the quiet time duration.

double	getQuietTimeSamplingInterval () const
	gets the quiet time sampling interval.

void	setQuietTimeSamplingInterval (double quietTimeSamplingInterval)
	Sets the quiet time sampling interval.

double	getStartVoltage () const
	get the value set for the start voltage.

void	setStartVoltage (double startVoltage)
	set the value for the start voltage.

bool	isStartVoltageVsOCP () const
	tells whether the starting potential is set against the open-circuit voltage or the reference terminal.

void	setStartVoltageVsOCP (bool startVoltageVsOCP)
	set whether to reference the starting potential against the open-circuit voltage or the reference terminal.

double	getEndVoltage () const
	get the value set for the ending potential value.

void	setEndVoltage (double endVoltage)
	set the ending potential value.

bool	isEndVoltageVsOCP () const
	tells whether the end voltage is set with respect to the open circuit voltage or the reference terminal.

void	setEndVoltageVsOCP (bool endVoltageVsOCP)
	set whether to reference the end voltage against the open-circuit voltage or the reference terminal.

double	getVStep () const
	get the value set for the potential step.

void	setVStep (double vStep)
	set the value for the potential step.

double	getPulseHeight () const
	get the value set for the pulse height.

void	setPulseHeight (double pulseHeight)
	set the value for the pulse height.

double	getPulseWidth () const
	get the value set for the pulse width.

void	setPulseWidth (double pulseWidth)
	set the value for the pulse width.

double	getPulsePeriod () const
	get the value set for the pulse period.

void	setPulsePeriod (double pulsePeriod)
	set the value for the pulse period.

bool	isAutoRange () const
	tells whether the current range is set to auto-select or not.

void	setAutoRange ()
	set to auto-select the current range.

double	getApproxMaxCurrent () const
	get the value set for the expected maximum current.

void	setApproxMaxCurrent (double approxMaxCurrent)
	set maximum current expected, for manual current range selection.

double	getAlphaFactor () const
	Get the value set for the alpha factor.

void	setAlphaFactor (double alphaFactor)
	alpha factor controls the percentage of data sampled during a given interval. Data will be averaged over the last n% of the sampling interval.

Constructor & Destructor Documentation

◆ AisDiffPulseVoltammetryElement() [1/2]

AisDiffPulseVoltammetryElement::AisDiffPulseVoltammetryElement	(	double	startVoltage,
		double	endVoltage,
		double	voltageStep,
		double	pulseHeight,
		double	pulseWidth,
		double	pulsePeriod,
		double	approxMaxCurrent )

explicit

Parameters

startVoltage	the value of the starting potential in volts
endVoltage	the value of the ending potential in volts
voltageStep	the value set for the voltage step in volts.
pulseHeight	the value for the pulse height in volts.
pulseWidth	the value for the pulse width in seconds.
pulsePeriod	the value for the pulse period in seconds.
approxMaxCurrent	the value for the approximate maximum current in amperes.

◆ AisDiffPulseVoltammetryElement() [2/2]

AisDiffPulseVoltammetryElement::AisDiffPulseVoltammetryElement	(	double	startVoltage,
		double	endVoltage,
		double	voltageStep,
		double	pulseHeight,
		double	pulseWidth,
		double	pulsePeriod )

explicit

Parameters

startVoltage	the value of the starting potential in volts
endVoltage	the value of the ending potential in volts
voltageStep	the value set for the voltage step in volts.
pulseHeight	the value for the pulse height in volts.
pulseWidth	the value for the pulse width in seconds.
pulsePeriod	the value for the pulse period in seconds.

Member Function Documentation

◆ getAlphaFactor()

double AisDiffPulseVoltammetryElement::getAlphaFactor ( ) const

Returns: The value for the alpha factor is represented as a percent between 0 and 100.

Note: If nothing is set, this function will return a default value of 75.

◆ getApproxMaxCurrent()

double AisDiffPulseVoltammetryElement::getApproxMaxCurrent ( ) const

Returns: the value set for the expected maximum current in Amps.

Note: if nothing was manually set, the device will auto-select the current range and the return value will be positive infinity.

◆ getCategory()

QStringList AisDiffPulseVoltammetryElement::getCategory ( ) const

override

Returns: A list of applicable categories: ("Potentiostatic Control", "Basic Voltammetry", "Pulse Voltammetry").

◆ getEndVoltage()

double AisDiffPulseVoltammetryElement::getEndVoltage ( ) const

This is the value of the voltage at which the experiment will stop.

Returns: the value set for the ending voltage in volts.

◆ getName()

QString AisDiffPulseVoltammetryElement::getName ( ) const

override

Returns: The name of the element: "Differential Pulse Potential Voltammetry".

◆ getPulseHeight()

double AisDiffPulseVoltammetryElement::getPulseHeight ( ) const

Returns: the value set for the pulse height in volts.

See also: setPulseHeight

◆ getPulsePeriod()

double AisDiffPulseVoltammetryElement::getPulsePeriod ( ) const

Returns: the value set for the pulse period in seconds.

See also: setPulsePeriod

Examples: pulseData.cpp.

◆ getPulseWidth()

double AisDiffPulseVoltammetryElement::getPulseWidth ( ) const

Returns: the value set for the pulse width in seconds.

See also: setPulseWidth

Examples: pulseData.cpp.

◆ getQuietTime()

double AisDiffPulseVoltammetryElement::getQuietTime ( ) const

Returns: The quiet time duration in seconds.

◆ getQuietTimeSamplingInterval()

double AisDiffPulseVoltammetryElement::getQuietTimeSamplingInterval ( ) const

Returns: samplingInterval The quiet time sampling interval to set in seconds.

◆ getStartVoltage()

double AisDiffPulseVoltammetryElement::getStartVoltage ( ) const

Returns: the value of the start voltage in volts.

◆ getVStep()

double AisDiffPulseVoltammetryElement::getVStep ( ) const

Returns: the value set for the potential step in volts.

See also: setVStep

◆ isAutoRange()

bool AisDiffPulseVoltammetryElement::isAutoRange ( ) const

Returns: true if the current range is set to auto-select and false if a rage has been selected.

Deprecated: This function is deprecated and no longer supports auto range for this element. Specify the current using setApproxMaxCurrent(). The device will determine the appropriate range based on the current value.

◆ isEndVoltageVsOCP()

bool AisDiffPulseVoltammetryElement::isEndVoltageVsOCP ( ) const

Returns: true if the end voltage is set with respect to the open-circuit voltage and false if set against the reference terminal.

See also: setEndVoltageVsOCP

◆ isStartVoltageVsOCP()

bool AisDiffPulseVoltammetryElement::isStartVoltageVsOCP ( ) const

Returns: true if the starting potential is set against the open-circuit voltage and false if it is set against the reference terminal.

See also: setStartVoltageVsOCP

◆ setAlphaFactor()

void AisDiffPulseVoltammetryElement::setAlphaFactor ( double alphaFactor )

This is an optional parameter. If nothing is set, the device will use the default value of 75.

Parameters

alphaFactor the value for the alphaFactor ranges from 0 to 100.

◆ setApproxMaxCurrent()

void AisDiffPulseVoltammetryElement::setApproxMaxCurrent ( double approxMaxCurrent )

This is an optional parameter. If nothing is set, the device will auto-select the current range.

Parameters

approxMaxCurrent the value for the maximum current expected in Amps.

Examples: pulseData.cpp.

◆ setAutoRange()

void AisDiffPulseVoltammetryElement::setAutoRange ( )

This option is set by default. There is no need to call this function to auto-select if the range was not manually set.

Deprecated: This function is deprecated. Use setApproxMaxCurrent() to specify the current range instead.

◆ setEndVoltage()

void AisDiffPulseVoltammetryElement::setEndVoltage ( double endVoltage )

This is the value of the voltage at which the experiment will stop.

Parameters

endVoltage the value to set for the ending voltage in volts.

◆ setEndVoltageVsOCP()

void AisDiffPulseVoltammetryElement::setEndVoltageVsOCP ( bool endVoltageVsOCP )

The reference terminal is for you to connect to any reference point you like. Connect it to the working electrode to reference ground.

Parameters

endVoltageVsOCP true to set the end voltage to be referenced against the open-circuit voltage and false if set against the reference terminal.

Note: by default, this is set to false.

Examples: pulseData.cpp.

◆ setPulseHeight()

void AisDiffPulseVoltammetryElement::setPulseHeight ( double pulseHeight )

For the first pulse, the pulse height is added to the starting potential. For the next pulse, the pulse height is added to the potential voltage and the potential step. In general, the pulse height is added to the potential step and the starting voltage of the last pulse.

Parameters

pulseHeight the value to set for the pulse height in volts.

◆ setPulsePeriod()

void AisDiffPulseVoltammetryElement::setPulsePeriod ( double pulsePeriod )

The pulse period is the time spent between the starts of two consecutive pulses.

Parameters

pulsePeriod the value to set for the pulse period in seconds.

◆ setPulseWidth()

void AisDiffPulseVoltammetryElement::setPulseWidth ( double pulseWidth )

The pulse width is the value in seconds for the time spent at the same voltage set for the pulse height.

Parameters

pulseWidth the value to set for the pulse width in seconds.

See also: setPulseHeight

◆ setQuietTime()

void AisDiffPulseVoltammetryElement::setQuietTime ( double quietTime )

Parameters

quietTime The quiet time duration to set in seconds.

◆ setQuietTimeSamplingInterval()

void AisDiffPulseVoltammetryElement::setQuietTimeSamplingInterval ( double quietTimeSamplingInterval )

Parameters

quietTimeSamplingInterval The quiet time sampling interval to set in seconds.

◆ setStartVoltage()

void AisDiffPulseVoltammetryElement::setStartVoltage ( double startVoltage )

Parameters

startVoltage the value of the start voltage in volts

◆ setStartVoltageVsOCP()

void AisDiffPulseVoltammetryElement::setStartVoltageVsOCP ( bool startVoltageVsOCP )

The reference terminal is for you to connect to any reference point you like. Connect it to the working electrode to reference ground.

Parameters

startVoltageVsOCP true to if the starting potential is set to reference the open-circuit voltage and false if set against the reference terminal.

Note: by default, this is set to false.

Examples: pulseData.cpp.

◆ setVStep()

void AisDiffPulseVoltammetryElement::setVStep ( double vStep )

The potential step is the difference between the starting potential of two consecutive pulses.

Parameters

vStep the value to set for the potential step in volts.

Note: Regardless of vStep's sign, the device will determine the step direction based on the start and end voltage.

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

AisDiffPulseVoltammetryElement.h

Public Member Functions

Constructor & Destructor Documentation

◆ AisDiffPulseVoltammetryElement() [1/2]

◆ AisDiffPulseVoltammetryElement() [2/2]

Member Function Documentation

◆ getAlphaFactor()

◆ getApproxMaxCurrent()

◆ getCategory()

◆ getEndVoltage()

◆ getName()

◆ getPulseHeight()

◆ getPulsePeriod()

◆ getPulseWidth()

◆ getQuietTime()

◆ getQuietTimeSamplingInterval()

◆ getStartVoltage()

◆ getVStep()

◆ isAutoRange()

◆ isEndVoltageVsOCP()

◆ isStartVoltageVsOCP()

◆ setAlphaFactor()

◆ setApproxMaxCurrent()

◆ setAutoRange()

◆ setEndVoltage()

◆ setEndVoltageVsOCP()

◆ setPulseHeight()

◆ setPulsePeriod()

◆ setPulseWidth()

◆ setQuietTime()

◆ setQuietTimeSamplingInterval()

◆ setStartVoltage()

◆ setStartVoltageVsOCP()

◆ setVStep()