{ "info": { "author": "Angel Ferran Pousa", "author_email": "angel.ferran.pousa@desy.de", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Science/Research", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Scientific/Engineering :: Physics", "Topic :: Scientific/Engineering :: Visualization" ], "description": "# VisualPIC - A Data Visualizer for PIC Codes\n\n![VisualPIC logo](Logo/logo_horiz_transp.png)\n\n## Introduction\n\nVisualPIC is a new software for data visualization and analysis specifically designed to work with Particle-In-Cell (PIC) simulation codes, mainly for its application in plasma wakefield acceleration.\n\nThe original aim of VisualPIC was to provide a flexible and easy-to-use interface for data analysis, allowing the user to visualize the simulation results without having to write any code. This reduces the need of custom made scripts which, even if very efficient for specific cases, can easily tend to become quite cluttered and unpractical when used as the only tool for data visualization.\n\nThe main principles under which this application was developed are:\n\n* Easyness of use (must have a graphical user interface).\n* Cross-platform.\n* Written in Python (and Qt for the interface).\n* Open-source.\n* Compatibility with multiple PIC codes.\n* Open for collaboration.\n* Modular design.\n\nThe main capabilities of the program include 2D and 3D visualization of fields and particle data, particle tracking through the simulation, the creation of snapshots and animations, as well as a dedicated visualizer for making eye-catching 3D renders of the simulation.\n\n![VisualPIC Screnshot](Logo/VisualPIC.PNG)\n\n## Installation\n### Required software\n* Python 3.5 or higher.\n* Qt 5.7 or higher (will be installed with PyQt5).\n* FFmpeg.\n\n### Required Python packages\n* Numpy.\n* SciPy.\n* Matplotlib.\n* PyQt5.\n* H5Py.\n* Pillow.\n* openPMD-viewer.\n\n### Installing the easy way\n* If you dont have it already, install Python 3.5 or higher. Download [here](https://www.python.org/downloads/release/python-352/). Choose the 64-bit version if possible.\n* Open a terminal and simply type `pip install visualpic`.\n* (Optional) If you plan on creating animations with VisualPIC, download FFmpeg ([link](https://ffmpeg.zeranoe.com/builds/)) and add it to your system PATH (As explained [here](http://www.wikihow.com/Install-FFmpeg-on-Windows), for example).\n* After this, you should be able to run VisualPIC by simply typing `visualpic` in the command line from any directory.\n\n### Installing the manual way\n* Install Python 3.5 or higher. Download [here](https://www.python.org/downloads/release/python-352/). Choose the 64-bit version if possible.\n* Install all required dependencies: `pip install numpy, scipy, pyqt5, matplotlib, pillow, h5py, vtk`.\n* (Optional) If you plan on creating animations with VisualPIC, download FFmpeg ([link](https://ffmpeg.zeranoe.com/builds/)) and add it to your system PATH (As explained [here](http://www.wikihow.com/Install-FFmpeg-on-Windows), for example).\n* Clone this repository to your computer with `git clone https://github.com/AngelFP/VisualPIC.git`.\n* Finally, switch to the cloned directory with `cd VisualPIC` and install VisualPIC by typing `python setup.py install`\n* After this, you should be able to run VisualPIC by simply typing `visualpic` in the command line from any directory.\n\n\n## Collaborating\n\n### Adding support for more PIC codes\n\nOne of the main objectives when designing VisualPIC was that it should be able to read data from any code, but without adding more complexity to the main logic.\n\nAs a consequence, all the data reading process has been isolated from the rest of the code in well defined clases that read the data and \"give it\" to the rest of the code in a standarized way, independent from the simulation code that was used to create the data files.\n\nFor more details about this and on how to add compatibility for more simulation codes, see the [documentation](/Documentation/AddSupportForAnotherCode.md).\n\n## Citing VisualPIC\nIf you use VisualPIC to produce plots or figures for any scientific work, please provide a reference to the following publication:\n\nA. Ferran Pousa et al., *VisualPIC: A New Data Visualizer and Post-Processor for Particle-in-Cell Codes*, presented at IPAC\u00e2\u20ac\u212217, Copenhagen, Denmark, May 2017, paper TUPIK007.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/AngelFP/VisualPIC", "keywords": "", "license": "GPLv3", "maintainer": "", "maintainer_email": "", "name": "VisualPIC", "package_url": "https://pypi.org/project/VisualPIC/", "platform": "any", "project_url": "https://pypi.org/project/VisualPIC/", "project_urls": { "Homepage": "https://github.com/AngelFP/VisualPIC" }, "release_url": "https://pypi.org/project/VisualPIC/0.3.3/", "requires_dist": [ "numpy", "scipy", "pyqt5", "pillow", "h5py", "matplotlib", "vtk", "openpmd-viewer" ], "requires_python": "", "summary": "Data visualizer for PIC codes", "version": "0.3.3" }, "last_serial": 3949631, "releases": { "0.3.2": [ { "comment_text": "", "digests": { "md5": "b1a4c13f0707751bf73b29c976fdb4ff", "sha256": "a2c402e4de9742cd4822de6dc354d7bc8ac2bf147f23f994c0a661fa2e5d24ac" }, "downloads": -1, "filename": "VisualPIC-0.3.2-py3-none-any.whl", "has_sig": false, "md5_digest": "b1a4c13f0707751bf73b29c976fdb4ff", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 331742, "upload_time": "2018-06-08T14:35:25", "url": "https://files.pythonhosted.org/packages/8f/00/415da504437ff33f679fad712fdb0bdbea7d6ead18e293db82eb463b8416/VisualPIC-0.3.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "82a5c9142b0c6c806d9e0d418cbae4a3", "sha256": "348ea61c8d5e4eec2144001c86444a70c470e5a213c42aeea720f04c736ab7cd" }, "downloads": -1, "filename": "VisualPIC-0.3.2.tar.gz", "has_sig": false, "md5_digest": "82a5c9142b0c6c806d9e0d418cbae4a3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 193983, "upload_time": "2018-06-08T14:35:26", "url": "https://files.pythonhosted.org/packages/71/71/17de96ba5147f3186075ab4cff76a00843ac371fc130304d2b0612b7b0e9/VisualPIC-0.3.2.tar.gz" } ], "0.3.3": [ { "comment_text": "", "digests": { "md5": "961b9352b5c4ab67c4b94441a716f9a2", "sha256": "27830cf91b16d76ca38b920a68ba5ed10714012027490657a003d7247c4aee64" }, "downloads": -1, "filename": "VisualPIC-0.3.3-py3-none-any.whl", "has_sig": false, "md5_digest": "961b9352b5c4ab67c4b94441a716f9a2", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 331685, "upload_time": "2018-06-11T09:51:00", "url": "https://files.pythonhosted.org/packages/90/df/e7c6ebbc89b47a98860e06bd826e3366fa0252f5c5d03b3ed2436ee5ebc6/VisualPIC-0.3.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "06725cd76b0cb4403586c70e59b306dc", "sha256": "c9b951cb6568bc9cea71cb575416c3b426bc93b35e55e2ecda1f9455c413c89b" }, "downloads": -1, "filename": "VisualPIC-0.3.3.tar.gz", "has_sig": false, "md5_digest": "06725cd76b0cb4403586c70e59b306dc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 193836, "upload_time": "2018-06-11T09:51:01", "url": "https://files.pythonhosted.org/packages/a3/b5/48a80c67455a19547b809f3b6d4670c6708a530b25075a1f9d9ea75525ce/VisualPIC-0.3.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "961b9352b5c4ab67c4b94441a716f9a2", "sha256": "27830cf91b16d76ca38b920a68ba5ed10714012027490657a003d7247c4aee64" }, "downloads": -1, "filename": "VisualPIC-0.3.3-py3-none-any.whl", "has_sig": false, "md5_digest": "961b9352b5c4ab67c4b94441a716f9a2", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 331685, "upload_time": "2018-06-11T09:51:00", "url": "https://files.pythonhosted.org/packages/90/df/e7c6ebbc89b47a98860e06bd826e3366fa0252f5c5d03b3ed2436ee5ebc6/VisualPIC-0.3.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "06725cd76b0cb4403586c70e59b306dc", "sha256": "c9b951cb6568bc9cea71cb575416c3b426bc93b35e55e2ecda1f9455c413c89b" }, "downloads": -1, "filename": "VisualPIC-0.3.3.tar.gz", "has_sig": false, "md5_digest": "06725cd76b0cb4403586c70e59b306dc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 193836, "upload_time": "2018-06-11T09:51:01", "url": "https://files.pythonhosted.org/packages/a3/b5/48a80c67455a19547b809f3b6d4670c6708a530b25075a1f9d9ea75525ce/VisualPIC-0.3.3.tar.gz" } ] }