Skip to main content

MDANSE GUI package - the graphical interface for MDANSE

Project description

MDANSE_GUI

MDANSE_GUI Python Module

This is the module containing the Graphical User Interface (GUI) of the Molecular Dynamics Analysis for Neutron Scattering Experiments (MDANSE) software package.

The GUI depends on the MDANSE package.

Version information

This is the alpha release of MDANSE_GUI 0.1.0. The GUI has been re-written completely using Qt. Please help us develop MDANSE_GUI by reporting any problems you experience when using the code. The preferred way of reporting problems is by adding them to the GitHub issue tracker.

Quick start: installation

We recommend that you install MDANSE in a Python virtual environment. You can create a virtual environment named mdanse_env by typing

python3 -m venv mdanse_env

To activate your virtual environment, type

source mdanse_env/bin/activate

in a bash console, or

mdanse_end/Scripts/activate.bat

if you are using cmd.exe on Windows.

While your virtual environment is active, you can install MDANSE:

pip install MDANSE_GUI

and start the GUI by typing

mdanse_gui

If you experience problems with the installation, you may want to upgrade pip

pip install --upgrade pip

and try again.

Quick start: workflow

The typical workflow of MDANSE:

  1. Convert a trajectory from the file format generated by an MD simulation software into the MDANSE trajectory format,
  2. Load the converted trajectory into MDANSE,
  3. Perform an analysis,
  4. Check the results with the plotter.

Each one of these operations (apart from the plotter) has its own dedicated tab in the GUI. The plotter can be started using a button on the top toolbar.

The most complete user documentation of MDANSE can be found on our Read the Docs page.

Other information including example scripts can be found on the MDANSE website

Citing MDANSE

If you used MDANSE in your research, please cite the following paper:

MDANSE: An Interactive Analysis Environment for Molecular Dynamics Simulations. G. Goret, B. Aoun, E. Pellegrini. J Chem Inf Model. (2017) 57(1):1-5.

License

MDANSE_GUI is licensed under GPL-3.0. See LICENSE for more information.

Acknowledgements

The VTK-based 3D viewer and the matplotlib-based data plotter were both taken and adapted from other software projects authored by Eric Pellegrini. We would like to thank Eric for making his code available.

Joining the project

MDANSE_GUI is currently maintained and developed by software developers from ISIS and ILL, but we are fully open to new collaborators who would like to contribute code, documentation, tutorials or usage examples. If you want to join the project contact:

Dr. Sanghamitra Mukhopadhyay (sanghamitra.mukhopadhyay@stfc.ac.uk)
ISIS Neutron and Muon Source
Rutherford Appleton Laboratory
Didcot, UK

Software Inquiries

For questions or contributions related to the software, please contact:

Dr. Maciej Bartkowiak (maciej.bartkowiak@stfc.ac.uk)
ISIS Neutron and Muon Source
Rutherford Appleton Laboratory
Didcot, UK

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mdanse_gui-0.1.0b1.tar.gz (2.1 MB view details)

Uploaded Source

Built Distribution

MDANSE_GUI-0.1.0b1-py3-none-any.whl (2.2 MB view details)

Uploaded Python 3

File details

Details for the file mdanse_gui-0.1.0b1.tar.gz.

File metadata

  • Download URL: mdanse_gui-0.1.0b1.tar.gz
  • Upload date:
  • Size: 2.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.9

File hashes

Hashes for mdanse_gui-0.1.0b1.tar.gz
Algorithm Hash digest
SHA256 b02e35d72d9ed21065fd450ce92706f7b9fe74eb400a96dcfa4aec3ab2b5bb1c
MD5 fbdbf7d5084a6988d3de59a0c15c290f
BLAKE2b-256 b7d5717ba40a78b05ce7dd40e119f67df2000f31963c25d5f6056ea3bb567b52

See more details on using hashes here.

File details

Details for the file MDANSE_GUI-0.1.0b1-py3-none-any.whl.

File metadata

File hashes

Hashes for MDANSE_GUI-0.1.0b1-py3-none-any.whl
Algorithm Hash digest
SHA256 5328c4c7554ebddb4ad92f1bdbe605720eefd68b5b3e04e0fccc038d1c307f23
MD5 962916a237debb458fce466f5fb71d78
BLAKE2b-256 8170800d587df7e543d2dec66f28f57bcae9145faa2e4a16ff49cb1080369cd7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page