Metadata-Version: 2.1
Name: plonk
Version: 0.2.1
Summary: Smoothed particle hydrodynamics analysis and visualization with Python.
Home-page: https://github.com/dmentipl/plonk
Author: Daniel Mentiplay
Author-email: d.mentiplay@gmail.com
License: MIT
Description: Plonk
        =====
        
        Smoothed particle hydrodynamics analysis and visualization with Python.
        
        + Docs: https://plonk.readthedocs.io/
        + Repo: https://www.github.com/dmentipl/plonk
        
        [![Build Status](https://travis-ci.org/dmentipl/plonk.svg?branch=master)](https://travis-ci.org/dmentipl/plonk)
        [![Coverage Status](https://coveralls.io/repos/github/dmentipl/plonk/badge.svg?branch=master)](https://coveralls.io/github/dmentipl/plonk?branch=master)
        [![Documentation Status](https://readthedocs.org/projects/plonk/badge/?version=latest)](https://plonk.readthedocs.io/en/latest/?badge=latest)
        [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/dmentipl/plonk/blob/master/LICENSE)
        
        [![PyPI](https://img.shields.io/pypi/v/plonk)](https://pypi.org/project/plonk/)
        [![Anaconda Version](https://img.shields.io/conda/v/dmentipl/plonk.svg)](https://anaconda.org/dmentipl/plonk)
        [![Anaconda Platform](https://img.shields.io/conda/pn/dmentipl/plonk.svg)](https://anaconda.org/dmentipl/plonk)
        
        [![JOSS](https://joss.theoj.org/papers/e785dbbbc29d77211041264315d7d3c6/status.svg)](https://joss.theoj.org/papers/e785dbbbc29d77211041264315d7d3c6)
        [![ASCL](https://img.shields.io/badge/ascl-1907.009-blue.svg?colorB=262255)](http://ascl.net/1907.009)
        
        Usage
        -----
        
        Plonk supports the following SPH file formats:
        
        + [Phantom](https://phantomsph.bitbucket.io/) output in [HDF5](https://en.wikipedia.org/wiki/Hierarchical_Data_Format) format.
        
        *Note: you can convert Phantom non-HDF5 snapshots to HDF5. See the [Phantom docs](https://phantomsph.readthedocs.io).*
        
        ### Accessing data
        
        To read in a simulation with snapshot files like `disc_00000.h5`, and global quantity time series files like `disc01.ev`, in the current directory, and see what snapshots there are:
        
        ```python
        >>> import plonk
        
        >>> simulation = plonk.load_sim(prefix='disc')
        >>> simulation.snaps
        [<plonk.Snap: "disc_00000.h5">,
         ...
         <plonk.Snap: "disc_01000.h5">]
        ```
        
        The Snap objects contain the particle arrays, lazily loaded from the HDF5 file, as well as simulation metadata properties stored as a dictionary.
        
        ### Visualization
        
        To render the density on a snapshot:
        
        ```python
        >>> snap = plonk.load_snap('disc_00000.h5')
        >>> plonk.visualize.render(snap=snap, quantity='density')
        ```
        
        For a more complicated example, here is the deviation from Keplerian velocity around a planet embedded in a protoplanetary disc.
        
        ![Planet embedded in protoplanetary disc](https://raw.githubusercontent.com/dmentipl/plonk/master/image.png)
        
        *Deviation from Keplerian velocity around a planet: at the disc midplane (left), and 10 (middle) and 20 au (right) above the disc midplane. Data from a Phantom simulation.*
        
        ### More
        
        For further usage, see `examples` folder and documentation. The code is internally documented with docstrings. Try, for example, `help(plonk.Snap)` or `help(plonk.load_snap)`.
        
        Install
        -------
        
        ### Conda
        
        You can install Plonk via the package manager Conda
        
        ```bash
        conda install plonk --channel dmentipl
        ```
        
        This will install the required dependencies. For details on Conda, see <https://docs.conda.io/>.
        
        ### pip
        
        You can also install Plonk via pip.
        
        ```bash
        pip install plonk
        ```
        
        This should install the required dependencies. For details on pip, see <https://pip.pypa.io/>.
        
        Getting help
        ------------
        
        If you need help, try the following, in order:
        
        1. Check the documentation.
        2. Ask questions on Stack Overflow using the [plonk](https://stackoverflow.com/questions/tagged/plonk) tag.
        3. File an issue, as a [bug report](https://github.com/dmentipl/plonk/issues/new?assignees=&labels=&template=bug_report.md&title=) or [feature request](https://github.com/dmentipl/plonk/issues/new?assignees=&labels=&template=feature_request.md&title=), using the issue tracker.
        
        If you don't get an immediate response, please be patient. Plonk is maintained by one person, [@dmentipl](https://github.com/dmentipl).
        
        Contributing
        ------------
        
        Thank you for considering contributing to Plonk. *Contributions are welcome.*
        
        See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to contribute.
        
        Citation
        --------
        
        If you use Plonk in a scientific publication, please cite
        
        > [Plonk: Smoothed particle hydrodynamics data analysis and visualization](https://ui.adsabs.harvard.edu/abs/2019ascl.soft07009M/abstract)
        
        You should also consider citing any other scientific software packages that you use.
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Visualization
Description-Content-Type: text/markdown
