This experiment sweeps the potential of the working electrode back and forth between the first voltage-limit and the second voltage-limit at a constant scan rate (dE/dt) for a specified number of cycles. More...

#include <AisCyclicVoltammetryElement.h>

Public Member Functions
	AisCyclicVoltammetryElement (double startVoltage, double firstVoltageLimit, double secondVoltageLimit, double endVoltage, double dEdt, double samplingInterval)
	constructor of the cyclic voltammetry element.

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

AisCyclicVoltammetryElement &	operator= (const AisCyclicVoltammetryElement &)
	overload equal to operator for the AisCyclicVoltammetryElement 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 potential 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 start voltage is set with respect to the open circuit voltage or not.

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

double	getFirstVoltageLimit () const
	get the value set for the first voltage-limit.

void	setFirstVoltageLimit (double v1)
	set the first voltage-limit

bool	isFirstVoltageLimitVsOCP () const
	tells whether the first voltage-limit is set with respect to the open circuit voltage or not.

void	setFirstVoltageLimitVsOCP (bool firstVoltageLimitVsOCP)
	set whether to reference the first voltage-limit against the open-circuit voltage or not.

double	getSecondVoltageLimit () const
	get the value set for the second voltage-limit

void	setSecondVoltageLimit (double v2)
	set the second voltage-limit

bool	isSecondVoltageLimitVsOCP () const
	tells whether the second voltage-limit is set with respect to the open circuit voltage or not.

void	setSecondVoltageLimitVsOCP (bool secondVoltageLimitVsOCP)
	set whether to reference the second voltage-limit against the open-circuit voltage or not.

unsigned int	getNumberOfCycles ()
	get the value set for the number of cycles

void	setNumberOfCycles (unsigned int cycles)
	set the number of cycles to oscillate between the first voltage-limit and the second voltage-limit.

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	getdEdt () const
	get the value set for the constant scan rate dE/dt.

void	setdEdt (double dEdt)
	set the value for the constant scan rate dE/dt.

double	getSamplingInterval () const
	get how frequently we are sampling the data.

void	setSamplingInterval (double sampInterval)
	set how frequently we are sampling the data.

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

◆ AisCyclicVoltammetryElement()

AisCyclicVoltammetryElement::AisCyclicVoltammetryElement	(	double	startVoltage,
		double	firstVoltageLimit,
		double	secondVoltageLimit,
		double	endVoltage,
		double	dEdt,
		double	samplingInterval )

explicit

Parameters

startVoltage	the value of the start voltage in volts
firstVoltageLimit	the value of the first voltage-limit in volts
secondVoltageLimit	the value of the second voltage-limit in volts
endVoltage	the value of the end voltage in volts
dEdt	the constant scan rate dE/dt in V/s.
samplingInterval	the data sampling interval value in seconds.

Member Function Documentation

◆ getAlphaFactor()

double AisCyclicVoltammetryElement::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 AisCyclicVoltammetryElement::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 AisCyclicVoltammetryElement::getCategory ( ) const

override

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

◆ getdEdt()

double AisCyclicVoltammetryElement::getdEdt ( ) const

Returns: the value set for the constant scan rate dE/dt in V/s.

◆ getEndVoltage()

double AisCyclicVoltammetryElement::getEndVoltage ( ) const

This is the value of the voltage at which the experiment will stop. After the last cycle, the experiment will do one last sweep towards this value.

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

◆ getFirstVoltageLimit()

double AisCyclicVoltammetryElement::getFirstVoltageLimit ( ) const

After the starting voltage, the scan will go to the first voltage-limit. This could result in either upward scan first if the first voltage-limit is higher than the start voltage or downward scan first if the first voltage-limit is lower than the start voltage.

Returns: the first voltage-limit value in volts.

◆ getName()

QString AisCyclicVoltammetryElement::getName ( ) const

override

Returns: The name of the element: "Cyclic Voltammetry".

◆ getNumberOfCycles()

unsigned int AisCyclicVoltammetryElement::getNumberOfCycles ( )

Returns: the number of cycles set.

◆ getQuietTime()

double AisCyclicVoltammetryElement::getQuietTime ( ) const

Returns: The quiet time duration in seconds.

◆ getQuietTimeSamplingInterval()

double AisCyclicVoltammetryElement::getQuietTimeSamplingInterval ( ) const

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

◆ getSamplingInterval()

double AisCyclicVoltammetryElement::getSamplingInterval ( ) const

Returns: the data sampling interval value in seconds.

◆ getSecondVoltageLimit()

double AisCyclicVoltammetryElement::getSecondVoltageLimit ( ) const

After starting from the start-voltage and reaching the first voltage-limit, the scan will go to the second voltage limit. The scan will continue to oscillate between the first and second voltage-limits according to the number of cycles.

Returns: the second voltage-limit value in volts.

◆ getStartVoltage()

double AisCyclicVoltammetryElement::getStartVoltage ( ) const

Returns: the value of the start voltage in volts

◆ isAutoRange()

bool AisCyclicVoltammetryElement::isAutoRange ( ) const

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

◆ isEndVoltageVsOCP()

bool AisCyclicVoltammetryElement::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.

Note: if no value was set, the default is false

◆ isFirstVoltageLimitVsOCP()

bool AisCyclicVoltammetryElement::isFirstVoltageLimitVsOCP ( ) const

Returns: true if the first voltage-limit is set with respect to the open-circuit voltage and false if not.

Note: if no value was set, the default is false.

◆ isSecondVoltageLimitVsOCP()

bool AisCyclicVoltammetryElement::isSecondVoltageLimitVsOCP ( ) const

Returns: true if the second voltage-limit is set with respect to the open-circuit voltage and false if not.

Note: if no value was set, the default is false.

◆ isStartVoltageVsOCP()

bool AisCyclicVoltammetryElement::isStartVoltageVsOCP ( ) const

Returns: true if the start voltage is set with respect to the open-circuit voltage and false if not.

◆ setAlphaFactor()

void AisCyclicVoltammetryElement::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 AisCyclicVoltammetryElement::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.

◆ setAutoRange()

void AisCyclicVoltammetryElement::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.

◆ setdEdt()

void AisCyclicVoltammetryElement::setdEdt ( double dEdt )

Parameters

dEdt	the value set for the constant scan rate dE/dt in V/s.

◆ setEndVoltage()

void AisCyclicVoltammetryElement::setEndVoltage ( double endVoltage )

This is the value of the voltage at which the experiment will stop. After the last cycle, the experiment will do one last sweep towards this value.

Parameters

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

◆ setEndVoltageVsOCP()

void AisCyclicVoltammetryElement::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.

◆ setFirstVoltageLimit()

void AisCyclicVoltammetryElement::setFirstVoltageLimit ( double v1 )

After the starting voltage, the scan will go to the first voltage-limit. This could result in either upward scan first if the first voltage-limit is higher than the start voltage or downward scan first if the first voltage-limit is lower than the start voltage.

Parameters

v1	first voltage-limit value in volts

◆ setFirstVoltageLimitVsOCP()

void AisCyclicVoltammetryElement::setFirstVoltageLimitVsOCP ( bool firstVoltageLimitVsOCP )

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

Parameters

firstVoltageLimitVsOCP true to set the upper voltage to be referenced against the open-circuit voltage and false otherwise.

◆ setNumberOfCycles()

void AisCyclicVoltammetryElement::setNumberOfCycles ( unsigned int cycles )

Parameters

cycles the number of cycles to set

◆ setQuietTime()

void AisCyclicVoltammetryElement::setQuietTime ( double quietTime )

Parameters

quietTime The quiet time duration to set in seconds.

◆ setQuietTimeSamplingInterval()

void AisCyclicVoltammetryElement::setQuietTimeSamplingInterval ( double quietTimeSamplingInterval )

Parameters

quietTimeSamplingInterval The quiet time sampling interval to set in seconds.

◆ setSamplingInterval()

void AisCyclicVoltammetryElement::setSamplingInterval ( double sampInterval )

Parameters

sampInterval the data sampling interval value in seconds.

◆ setSecondVoltageLimit()

void AisCyclicVoltammetryElement::setSecondVoltageLimit ( double v2 )

After starting from the start-voltage and reaching the first voltage-limit, the scan will go to the second voltage limit. The scan will continue to oscillate between the first and second voltage-limits according to the number of cycles.

Parameters

v2	the second voltage-limit value in volts

◆ setSecondVoltageLimitVsOCP()

void AisCyclicVoltammetryElement::setSecondVoltageLimitVsOCP ( bool secondVoltageLimitVsOCP )

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

Parameters

secondVoltageLimitVsOCP true to set the second voltage-limit to be referenced against the open-circuit voltage and false otherwise.

◆ setStartVoltage()

void AisCyclicVoltammetryElement::setStartVoltage ( double startVoltage )

Parameters

startVoltage the value of the start voltage in volts

◆ setStartVoltageVsOCP()

void AisCyclicVoltammetryElement::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 start voltage is set to reference the open-circuit voltage and false if set against the reference terminal.

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

AisCyclicVoltammetryElement.h

Public Member Functions

Constructor & Destructor Documentation

◆ AisCyclicVoltammetryElement()

Member Function Documentation

◆ getAlphaFactor()

◆ getApproxMaxCurrent()

◆ getCategory()

◆ getdEdt()

◆ getEndVoltage()

◆ getFirstVoltageLimit()

◆ getName()

◆ getNumberOfCycles()

◆ getQuietTime()

◆ getQuietTimeSamplingInterval()

◆ getSamplingInterval()

◆ getSecondVoltageLimit()

◆ getStartVoltage()

◆ isAutoRange()

◆ isEndVoltageVsOCP()

◆ isFirstVoltageLimitVsOCP()

◆ isSecondVoltageLimitVsOCP()

◆ isStartVoltageVsOCP()

◆ setAlphaFactor()

◆ setApproxMaxCurrent()

◆ setAutoRange()

◆ setdEdt()

◆ setEndVoltage()

◆ setEndVoltageVsOCP()

◆ setFirstVoltageLimit()

◆ setFirstVoltageLimitVsOCP()

◆ setNumberOfCycles()

◆ setQuietTime()

◆ setQuietTimeSamplingInterval()

◆ setSamplingInterval()

◆ setSecondVoltageLimit()

◆ setSecondVoltageLimitVsOCP()

◆ setStartVoltage()

◆ setStartVoltageVsOCP()