Metadata-Version: 2.1
Name: ff-rem
Version: 0.1.0
Summary: Implementation of FF-REM for HOOMD-blue.
Home-page: https://bitbucket.org/glotzer/ff-rem
Author: Carl Simon Adorf
Author-email: csadorf@umich.edu
License: MIT license
Keywords: FF-REM
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: Click (>=6.0)

==============================================
Fourier-filtered Relative Entropy Minimization
==============================================


.. image:: https://img.shields.io/pypi/v/ff-rem.svg
        :target: https://pypi.python.org/pypi/ff-rem

.. image:: https://readthedocs.org/projects/ff-rem/badge/?version=latest
        :target: https://ff-rem.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status


Implementation of the Fourier-filtered Entropy Minimization (FF-REM) method for HOOMD-blue.
The method is described in detail in the associated publication:

    Carl S. Adorf, James Antonaglia, Julia Dshemuchadse, Sharon C. Glotzer, 2018. DOI: `10.1063/1.5063802 <https://dx.doi.org/10.1063/1.5063802>`_.

* Free software: MIT license
* Documentation: https://ff-rem.readthedocs.io.

Quickstart
----------

A complete example for the recovery of a Lennard-Jones potential is shown in ``examples/lennard-jones``.


Requirements
------------

* numpy
* HOOMD-blue
* gsd

Testing
-------

To execute unit tests, run:

.. code-block:: bash

    $ python -m unittest discover tests/

within the package root directory.

Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.1.0 (2018-10-17)
------------------

* First release on PyPI.


