a persistence engine for molecular dynamics data
Project description
=============================================================
MDSynthesis: a persistence engine for molecular dynamics data
=============================================================
|zen| |docs| |build| |cov|
As computing power increases, it is now possible to produce hundreds of
molecular dynamics simulation trajectories that vary widely in length,
system size, composition, starting conditions, and other parameters. Managing
this complexity in ways that allow use of the data to answer scientific
questions has itself become a bottleneck. MDSynthesis is an answer to this
problem.
Built on top of `datreant`_, MDSynthesis gives a Pythonic interface to
molecular dynamics trajectories using `MDAnalysis`_, giving the ability to work
with the data from many simulations scattered throughout the filesystem
with ease. It makes it possible to write analysis code that can work across
many varieties of simulation, but even more importantly, MDSynthesis allows
interactive work with the results from hundreds of simulations at once without
much effort.
Efficiently store intermediate data from individual simulations for easy recall
-------------------------------------------------------------------------------
The MDSynthesis **Sim** object gives an interface to raw simulation data
through `MDAnalysis`_. Data structures generated from raw trajectories (pandas
objects, numpy arrays, or any pure python structure) can then be stored and
easily recalled later. Under the hood, datasets are stored in the efficient
HDF5 format when possible.
.. _MDAnalysis: http://www.mdanalysis.org
Powered by ``datreant`` under the hood
--------------------------------------
MDSynthesis is built on top of the general-purpose `datreant`_ library. The
Sim is a `Treant`_ with special features for working with molecular dynamics
data, but every feature of datreant applies to MDSynthesis.
.. _Treant: http://datreant.readthedocs.org/en/latest/treants.html
Documentation
=============
A brief user guide is available on `Read the Docs
<http://mdsynthesis.readthedocs.org/>`__.
Contributing
============
This project is still under heavy development, and there are certainly rough
edges and bugs. Issues and pull requests welcome!
MDSynthesis follows the development model of `datreant`_; see the
`contributor's guide`_ to learn how to get started with contributing back.
.. _datreant: http://datreant.readthedocs.org/
.. _`contributor's guide`: http://datreant.readthedocs.org/en/latest/contributing.html
.. |docs| image:: https://readthedocs.org/projects/mdsynthesis/badge/?version=develop
:alt: Documentation Status
:scale: 100%
:target: https://readthedocs.org/projects/mdsynthesis
.. |build| image:: https://travis-ci.org/datreant/MDSynthesis.svg?branch=develop
:alt: Build Status
:target: https://travis-ci.org/datreant/MDSynthesis
.. |cov| image:: http://codecov.io/github/datreant/MDSynthesis/coverage.svg?branch=develop
:alt: Code Coverage
:scale: 100%
:target: http://codecov.io/github/datreant/MDSynthesis?branch=develop
.. |zen| image:: https://zenodo.org/badge/13742/datreant/MDSynthesis.svg
:alt: Citation
:target: https://zenodo.org/badge/latestdoi/13742/datreant/MDSynthesis
MDSynthesis: a persistence engine for molecular dynamics data
=============================================================
|zen| |docs| |build| |cov|
As computing power increases, it is now possible to produce hundreds of
molecular dynamics simulation trajectories that vary widely in length,
system size, composition, starting conditions, and other parameters. Managing
this complexity in ways that allow use of the data to answer scientific
questions has itself become a bottleneck. MDSynthesis is an answer to this
problem.
Built on top of `datreant`_, MDSynthesis gives a Pythonic interface to
molecular dynamics trajectories using `MDAnalysis`_, giving the ability to work
with the data from many simulations scattered throughout the filesystem
with ease. It makes it possible to write analysis code that can work across
many varieties of simulation, but even more importantly, MDSynthesis allows
interactive work with the results from hundreds of simulations at once without
much effort.
Efficiently store intermediate data from individual simulations for easy recall
-------------------------------------------------------------------------------
The MDSynthesis **Sim** object gives an interface to raw simulation data
through `MDAnalysis`_. Data structures generated from raw trajectories (pandas
objects, numpy arrays, or any pure python structure) can then be stored and
easily recalled later. Under the hood, datasets are stored in the efficient
HDF5 format when possible.
.. _MDAnalysis: http://www.mdanalysis.org
Powered by ``datreant`` under the hood
--------------------------------------
MDSynthesis is built on top of the general-purpose `datreant`_ library. The
Sim is a `Treant`_ with special features for working with molecular dynamics
data, but every feature of datreant applies to MDSynthesis.
.. _Treant: http://datreant.readthedocs.org/en/latest/treants.html
Documentation
=============
A brief user guide is available on `Read the Docs
<http://mdsynthesis.readthedocs.org/>`__.
Contributing
============
This project is still under heavy development, and there are certainly rough
edges and bugs. Issues and pull requests welcome!
MDSynthesis follows the development model of `datreant`_; see the
`contributor's guide`_ to learn how to get started with contributing back.
.. _datreant: http://datreant.readthedocs.org/
.. _`contributor's guide`: http://datreant.readthedocs.org/en/latest/contributing.html
.. |docs| image:: https://readthedocs.org/projects/mdsynthesis/badge/?version=develop
:alt: Documentation Status
:scale: 100%
:target: https://readthedocs.org/projects/mdsynthesis
.. |build| image:: https://travis-ci.org/datreant/MDSynthesis.svg?branch=develop
:alt: Build Status
:target: https://travis-ci.org/datreant/MDSynthesis
.. |cov| image:: http://codecov.io/github/datreant/MDSynthesis/coverage.svg?branch=develop
:alt: Code Coverage
:scale: 100%
:target: http://codecov.io/github/datreant/MDSynthesis?branch=develop
.. |zen| image:: https://zenodo.org/badge/13742/datreant/MDSynthesis.svg
:alt: Citation
:target: https://zenodo.org/badge/latestdoi/13742/datreant/MDSynthesis
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mdsynthesis-0.6.1.tar.gz
(14.0 kB
view details)
Built Distribution
File details
Details for the file mdsynthesis-0.6.1.tar.gz
.
File metadata
- Download URL: mdsynthesis-0.6.1.tar.gz
- Upload date:
- Size: 14.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 95f48f9e2fd5dbd031b08de87ab682921895b336a855807ef95cdd876315cdc2 |
|
MD5 | 3ae37c5cc3a881df2a87ddc0ea5a1e56 |
|
BLAKE2b-256 | 5135b2d6017654a846b1e282a096e4da6aa3c8272f7bb5c9e3ff77e9098cd5bb |
Provenance
File details
Details for the file mdsynthesis-0.6.1-py2-none-any.whl
.
File metadata
- Download URL: mdsynthesis-0.6.1-py2-none-any.whl
- Upload date:
- Size: 17.8 kB
- Tags: Python 2
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8279e8dd5220d5c2a2f49b95411d91c8e64e0d939fc45199dde2ba9d3bde8a3b |
|
MD5 | 8e2d2e8966e33895f9e36c1fea9edfe2 |
|
BLAKE2b-256 | 1b9877c20eaafde3f35788c01c6bdfa3194f4d4c5f7c7128da1acc5d15fdb049 |