class ec4py.CV_Data()
– CV data analysis and display.

Basic use:

Import class:

   from ec4py import CV_Data

Load data set:

   data = CV_Data("PATH TO DATA")

Initialization

class ec4py.cv_data.CV_Data(Path=None, args, kwargs)

   data = CV_Data() # empty object
   data = CV_Data("PATH TO DATA FILE") # import the data from a file.
   data = CV_Data("PATH TO DATA FILE", IRCORR="R") # import the data from a file and apply iR-correction.

Operators

CV_Data and a scalar

The arithmetic operators * (multiplication) and / (division) are supported between CV_Data and a float or an int. The result is always a new CV_Data

   new_CV = CV_Data()*5  # the resulting CV has current of positive and negative sweep multiplied by 5
   new_CV = CV_Data()/5  # the current of positive and negative sweep are divided by 5

CV_Data and CV_Data

Arithemtics operators between CV_Data and another CV_Data are the following:

  • (addition) and - (subtraction)
     cv1 = CV_Data()
     cv2 = CV_Data()
     new_CV1 = cv1+cv2
     new_CV2 = cv1-cv2
    

Methods and properties

CV_Data inherit from EC_Setup and all properties and function are obtainable.

CV_Data.plot()

Creates a standard plot of a CV data, i.e. current vs potental.

   cv1 = CV_Data()
   cv1.plot() 

CV_Data.get_i_at_E(E:float, direction:str = “all”,*args, **kwargs)

A Quantity_Value_Unit representation of the curent at a specific voltage. Arguments can be used to normalize the current and shift the potential.

   cv1 = CV_Data()
   cv1.get_i_at_E(0.1) # gets the current at 0.1V.

CV_Data.get_E_at_i(i:float,tolerance:float=0, dir:str = “all”, *args, **kwargs)

A Quantity_Value_Unit representation of the voltage at a specific current. Arguments can be used to normalize the current and shift the potential.

CV_Data.get_E_of_max_i(self, E1:float,E2:float,*args,kwargs)**

A Quantity_Value_Unit representation of the voltage where the current reaches a maximum between two voltage limits. Arguments can be used to shift the potential.

   cv1 = CV_Data()
   cv1.get_E_of_max_i(0.1,0.5) # returns the voltage where the current reaches the max.

CV_Data.get_E_of_min_i(self, E1:float,E2:float,*args,kwargs)**

A Quantity_Value_Unit representation of the voltage where the current reaches a minimum between two voltage limits. Arguments can be used to shift the potential.

   cv1 = CV_Data()
   cv1.get_E_of_min_i(0.1,0.5) # returns the voltage where the current reaches the max.

CV_Data.get_sweep(sweep:str)

A LSV representation of the selected sweep: POS, NEG, AVG & DIF. See also Arguments

   cv1 = CV_Data()
   lsv = cv1.get_sweep(AVG) # returns the average of positive and negative sweeps.

CV_Data.set_active_RE(new_reference_electrode=None)

Shifts the voltage to be relative another reference electrode.See Arguments. None related to the experimental reference electrode.

   cv1 = CV_Data()
   cv1.set_active_RE(RHE)

CV_Data.norm(norm_to)

Normalise the current to certain factors. See Arguments

   cv1 = CV_Data()
   cv1.norm(AREA) # the current is now normalized to area

CV_Data.conv(ec_data: EC_Data, *args, ** kwargs)

Convert a EC_Data to CV_Data.

CV_Data.integrate(self, start_E:float, end_E:float, *args, **kwargs)

A Quantity_Value_Unit representation of the integrated current between two voltage limits. Arguments can be used to normailze the current and shift the potential.

   cv1 = CV_Data()
   cv1.integrate(0.1,1.1) # integrate the current between 0.1 and 1.1 V.