Plotpot is a Python module that plots potentiostatic data automatically imported with Convpot. It keeps a journal with meta information such as mass of active material, capacity etc. for later use.
Plotpot is based on the following software:
To get the Python environment running under Windows I recommend to use a scientific Python distribution such as Anaconda or Enthought Canopy, which include a precompiled version of NumPy and Matplotlib.
To install Plotpot follow these steps (tested under Windows 7 64 bit as a normal user):
Download and install the latest Convpot package. During installation choose to add Convpot to the PATH of the current user.
Download and install Anaconda. Choose the Python 3 64 bit version and install "Just for me".
Update Anaconda. Open an "Anaconda Prompt" and type:
conda update conda conda update anaconda
Create a new virtual Python environment just for running Plotpot:
conda create -n plotpot-env numpy matplotlib activate plotpot-env
Download and install Plotpot by typing:
pip install plotpot
If all goes well you should be able to type plotpot and get a
usage message without errors about missing packages.
Plotpot currently knows two sub-commands show and journal. A detailed help of the
sub-command options are printed with plotpot <sub-command> -h
An example plot generated with plotpot show arbintest.res looks like this:
By default all available data is plotted. The range can be selected by
- cycle number (
--cycles) - time (in hours) (
--time) - data points (
--data)
For example to plot data up to cycle 10:
plotpot show arbintest.res --cycles 10
To plot from cycle 3 to 6:
plotpot show arbintest.res --cycles 3,6
Plots are selected with the --plot option, e.g.
plotpot show arbintest.res --plot 1,4-5
It is possible to give a comma separated list of plots and ranges separated with "-". If no plots are selected, the voltage versus specific capacity (1) is plotted by default. Plotpot currently supports the following plot types:
- Voltage vs. specific capacity
- Voltage and current vs. time
- Auxiliary channel, e.g. temperature vs. time
- Specific capacity [mAh/g] per cycle
- Specific energy [Wh/kg] per cycle
- Volumetric energy [Wh/L] per cyclet
- Coulombic efficiency per cycle
- Mean voltages and hysteresis per cycle
- dQ/dV vs. voltage
- C-rate per cycle
- Specific current density [mA/g] per cycle
- Current density [mA/cm²] per cycle
- Specific capacity as charge/dischage circle
Plotpot has the option to smooth the dQ/dV plot by convoluting the raw data with a Hanning window of certain width. The smoothing strength is chosen with the level parameter ranging from 1 to 4, which translates to the widths of the window.
plotpot show arbintest.res --cycle 2,2 --plot 9 --smooth 4
The raw data, statistics and data per cycle are exported with
plotpot show arbintest.res --export
This generates files in csv format for further processing with e.g. Microcal Origin or similar software. Data per cycle is packed into a zip archive and png snapshots of the plots genererated on screen are created.
On first execution, a journal file plotpot-journal.dat is created in the directory of the plotpot executable. The folder location can be changed by setting the PLOTPOT_JOURNAL environment variable to a full path as described in the wiki.
The journal file keeps a record of mass, capacity, area and volume of the electrode. If plotpot is called with the same data file, you have the possibility to use the previously entered values or enter new ones. The content of the journal is displayed with
plotpot journal
A particular entry can be removed from the journal with
plotpot journal --delete <row_ID>
- Alexander Pohl - Initial work
See also the list of CONTRIBUTORS who participated in this project.
All notable changes and releases are documented in the CHANGELOG.
This project is licensed under the MIT license - see the LICENSE file for details