Package: plotpot
Plotpot is a Python module that plots half and full cell potentiostatic
data automatically imported withConvpot.
It keeps a journal with meta information such as mass of active material,
capacity etc. for later use.Getting StartedPrerequisitesPlotpot is based on the following software:ConvpotNumPyMatplotlibTo get the Python environment running under Windows I recommend to use a
scientific Python distribution such asAnacondaorEnthought
Canopy, which include
a precompiled version of NumPy and Matplotlib.InstallingTo install Plotpot follow these steps (tested under Windows 7 64 bit as
a normal user):Download and install thelatest
Convpotpackage. During installation choose to add Convpot to the PATH of the
current user.Download and installAnaconda. 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 anacondaCreate a new virtual Python environment just for running Plotpot:conda create -n plotpot-env numpy matplotlib
activate plotpot-envCreate a shortcut forplotpot-envon the desktop as described in thewiki.Download and install (or upgrade) Plotpot by typing:pip install plotpot --upgradeIf all goes well you should be able to typeplotpotand get a
usage message without errors about missing packages.UsagePlotpot currently knows two sub-commandsshow,mergeandjournal. A detailed
help of the sub-command options are printed withplotpot<sub-command>-hAn example plot generated withplotpot show arbintest.reslooks like this:Select dataBy default all available data is plotted. The range can be selected bycycle number (--cycles)time (in hours) (--time)data points (--data)For example to plot data up to cycle 5:plotpot show arbintest.res --cycles 5To plot from cycle 2 to 10:plotpot show arbintest.res --cycles 2,10Select plotsPlots are selected with the--plotoption,e.g.plotpot show arbintest.res --cycles 2,10 --plot 8-9,14It 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:Specific capacitySpecific capacity (circle plot)Voltage and currentTemperaturedQ/dVSpecific capacity [mAh/g]Volumetric capacity [Ah/L]Specific energy [Wh/kg]Volumetric energy [Wh/L]Specific current density [mA/g]Current density [mA/cm²]C-rateHysteresisCoulombic efficiencySmooth dQ/dV plotPlotpot 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 5, which
translates to the widths of the window.plotpot show arbintest.res --cycle 2,2 --plot 5 --smooth 2Export dataThe raw data, statistics, voltage profile and battery properties are exported withplotpot show arbintest.res --exportThis generates files incsv formatfor
further processing with e.g.Microcal Originor similar software.
Data per cycle is packed into a zip archive and png snapshots of the plots genererated on screen are created.Merge FilesA battery which consists of many individual data files (which is common for the Gamry instruments) can be merged together to a single data file with the “merge” sub-command.To process multiple filesplotpot merge gamrytest_1.DTA gamrytest_2.DTAAlternatively, the files to merge can be given in a text file listed one by line. Lines starting with the “!” character are ignored.plotpot merge --list gamrytest.txtThe output file name can be changed with the--outputoption.The journalOn first execution, a journal fileplotpot-journal.datis created in the directory of the plotpot
executable. The folder location can be changed by setting thePLOTPOT_JOURNALenvironment variable
to a full path as described in thewiki.The journal file keeps a record of mass, capacity, area, volume and mass loading 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 withplotpot journalA particular entry can be removed from the journal with:plotpot journal --delete <row_ID>The individual raw data files of a merged battery can be shown withplotpot journal --show <row_ID>The journal file can be exported to a csv file:plotpot journal --exportAuthorsAlexander Pohl-Initial workSee also the list ofCONTRIBUTORSwho participated in this project.ChangelogAll notable changes and releases are documented in theCHANGELOG.LicenseThis project is licensed under the MIT license - see theLICENSEfile for details