{ "info": { "author": "Alexander Pohl", "author_email": "alex@ahpohl.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3 :: Only", "Topic :: Scientific/Engineering :: Visualization" ], "description": "Plotpot\n=======\n\nPlotpot is a Python module that plots half and full cell potentiostatic \ndata automatically imported with `Convpot `__. \nIt keeps a journal with meta information such as mass of active material,\ncapacity etc. for later use.\n\nGetting Started\n---------------\n\nPrerequisites\n~~~~~~~~~~~~~\n\nPlotpot is based on the following software:\n\n- `Convpot `__\n- `NumPy `__\n- `Matplotlib `__\n\nTo get the Python environment running under Windows I recommend to use a\nscientific Python distribution such as\n`Anaconda `__ or `Enthought\nCanopy `__, which include \na precompiled version of NumPy and Matplotlib.\n\nInstalling\n~~~~~~~~~~\n\nTo install Plotpot follow these steps (tested under Windows 7 64 bit as\na normal user):\n\n1. Download and install the `latest\n Convpot `__\n package. During installation choose to add Convpot to the PATH of the\n current user.\n2. Download and install\n `Anaconda `__. Choose the Python\n 3 64 bit version and install \"Just for me\".\n3. Update Anaconda. Open an \"Anaconda Prompt\" and type:\n\n ::\n\n conda update conda\n conda update anaconda\n\n4. Create a new virtual Python environment just for running Plotpot:\n\n ::\n\n conda create -n plotpot-env numpy matplotlib\n activate plotpot-env\n \n5. Create a shortcut for ``plotpot-env`` on the desktop as described in the `wiki `__.\n\n6. Download and install (or upgrade) Plotpot by typing:\n\n ::\n\n pip install plotpot --upgrade\n\nIf all goes well you should be able to type ``plotpot`` and get a\nusage message without errors about missing packages.\n\nUsage\n-----\n\nPlotpot currently knows two sub-commands ``show``, ``merge`` and ``journal``. A detailed \nhelp of the sub-command options are printed with ``plotpot -h``\n\nAn example plot generated with ``plotpot show arbintest.res`` looks like this:\n\n.. image:: https://raw.githubusercontent.com/ahpohl/plotpot/master/resources/arbintest.png\n\nSelect data\n~~~~~~~~~~~\n\nBy default all available data is plotted. The range can be selected by\n\n* cycle number (``--cycles``)\n* time (in hours) (``--time``)\n* data points (``--data``)\n\nFor example to plot data up to cycle 5:\n\n::\n\n plotpot show arbintest.res --cycles 5\n \nTo plot from cycle 2 to 10:\n\n::\n\n plotpot show arbintest.res --cycles 2,10\n\nSelect plots\n~~~~~~~~~~~~\n\nPlots are selected with the ``--plot`` option, *e.g.*\n\n::\n \n plotpot show arbintest.res --cycles 2,10 --plot 8-9,14\n \nIt is possible to give a comma separated list of plots and ranges separated with \"-\". If no plots are\nselected, the voltage versus specific capacity (1) is plotted by default. Plotpot currently supports \nthe following plot types:\n\n1. Specific capacity\n2. Specific capacity (circle plot) \n3. Voltage and current\n4. Temperature\n5. dQ/dV\n6. Specific capacity [mAh/g]\n7. Volumetric capacity [Ah/L]\n8. Specific energy [Wh/kg]\n9. Volumetric energy [Wh/L] \n10. Specific current density [mA/g]\n11. Current density [mA/cm\u00b2]\n12. C-rate \n13. Hysteresis\n14. Coulombic efficiency\n\nSmooth dQ/dV plot\n~~~~~~~~~~~~~~~~~\n\nPlotpot has the option to smooth the dQ/dV plot by convoluting the raw data with a Hanning window of\ncertain width. The smoothing strength is chosen with the level parameter ranging from 1 to 5, which \ntranslates to the widths of the window.\n\n::\n\n plotpot show arbintest.res --cycle 2,2 --plot 5 --smooth 2\n\nExport data\n~~~~~~~~~~~\n\nThe raw data, statistics, voltage profile and battery properties are exported with\n\n::\n\n plotpot show arbintest.res --export\n\nThis generates files in `csv format `__ for \nfurther processing with e.g. `Microcal Origin `__ or similar software. \nData per cycle is packed into a zip archive and png snapshots of the plots genererated on screen are created.\n\nMerge Files\n~~~~~~~~~~~\n\nA 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.\n\nTo process multiple files\n\n::\n \n plotpot merge gamrytest_1.DTA gamrytest_2.DTA\n\nAlternatively, the files to merge can be given in a text file listed one by line. Lines starting with the \"!\" character are ignored.\n\n::\n\n plotpot merge --list gamrytest.txt\n\nThe output file name can be changed with the ``--output`` option.\n\nThe journal\n~~~~~~~~~~~\n\nOn first execution, a journal file ``plotpot-journal.dat`` is created in the directory of the plotpot \nexecutable. The folder location can be changed by setting the ``PLOTPOT_JOURNAL`` environment variable \nto a full path as described in the `wiki `__. \n\nThe journal file keeps a record of mass, capacity, area, volume and mass loading of the electrode. \nIf plotpot is called with the same data file, you have the possibility to use the previously entered \nvalues or enter new ones. The content of the journal is displayed with\n\n::\n \n plotpot journal\n \nA particular entry can be removed from the journal with:\n\n::\n\n plotpot journal --delete \n\nThe individual raw data files of a merged battery can be shown with\n\n::\n\n\tplotpot journal --show \n \nThe journal file can be exported to a csv file:\n\n::\n\t\n\tplotpot journal --export\n\nAuthors\n-------\n\n- **Alexander Pohl** - *Initial work*\n\nSee also the list of `CONTRIBUTORS `__ who participated in this project.\n\nChangelog\n---------\n\nAll notable changes and releases are documented in the `CHANGELOG `__.\n\nLicense\n-------\n\nThis project is licensed under the MIT license - see the `LICENSE `__ file for details\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ahpohl/plotpot", "keywords": "electrochemistry", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "plotpot", "package_url": "https://pypi.org/project/plotpot/", "platform": "", "project_url": "https://pypi.org/project/plotpot/", "project_urls": { "Homepage": "https://github.com/ahpohl/plotpot" }, "release_url": "https://pypi.org/project/plotpot/1.2.2/", "requires_dist": null, "requires_python": "", "summary": "Plot potentiostatic data", "version": "1.2.2" }, "last_serial": 3298404, "releases": { "1.2.2": [ { "comment_text": "", "digests": { "md5": "16d710a5f4282594b9a9cd239cbcb288", "sha256": "c73b23544a3c6c5e1b3ab1c0b80dc7ee1910a7ca24dadea1fa7e0e829f71d0b7" }, "downloads": -1, "filename": "plotpot-1.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "16d710a5f4282594b9a9cd239cbcb288", "packagetype": "bdist_wheel", "python_version": "3.6", "requires_python": null, "size": 6271868, "upload_time": "2017-11-01T20:44:12", "url": "https://files.pythonhosted.org/packages/cf/97/b9f8204b766c25df6bb32dc0122cc8cf81f0dbad109062c9f3145e55290c/plotpot-1.2.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3c2e2fbf42058a600cd9c22bdbb0af89", "sha256": "568650c96f05157b32d456b0985f7992f9e25892a50a1a653b46f7ee0b420eb4" }, "downloads": -1, "filename": "plotpot-1.2.2.tar.gz", "has_sig": false, "md5_digest": "3c2e2fbf42058a600cd9c22bdbb0af89", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4678063, "upload_time": "2017-11-01T20:43:38", "url": "https://files.pythonhosted.org/packages/62/a9/0fbc7430ad3cb01f4202635fa63d3591673fdf4211aec5b7fbfddc5f9d2e/plotpot-1.2.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "16d710a5f4282594b9a9cd239cbcb288", "sha256": "c73b23544a3c6c5e1b3ab1c0b80dc7ee1910a7ca24dadea1fa7e0e829f71d0b7" }, "downloads": -1, "filename": "plotpot-1.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "16d710a5f4282594b9a9cd239cbcb288", "packagetype": "bdist_wheel", "python_version": "3.6", "requires_python": null, "size": 6271868, "upload_time": "2017-11-01T20:44:12", "url": "https://files.pythonhosted.org/packages/cf/97/b9f8204b766c25df6bb32dc0122cc8cf81f0dbad109062c9f3145e55290c/plotpot-1.2.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3c2e2fbf42058a600cd9c22bdbb0af89", "sha256": "568650c96f05157b32d456b0985f7992f9e25892a50a1a653b46f7ee0b420eb4" }, "downloads": -1, "filename": "plotpot-1.2.2.tar.gz", "has_sig": false, "md5_digest": "3c2e2fbf42058a600cd9c22bdbb0af89", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4678063, "upload_time": "2017-11-01T20:43:38", "url": "https://files.pythonhosted.org/packages/62/a9/0fbc7430ad3cb01f4202635fa63d3591673fdf4211aec5b7fbfddc5f9d2e/plotpot-1.2.2.tar.gz" } ] }