Skip to main content

A textual user interface (TUI) for MDAnalysis

Project description

MDAnalysis TUI

A textual user interface (TUI) for MDAnalysis trajectory transformations

https://github.com/p-j-smith/mda-tui/assets/29753790/b73c1a7e-ca97-41cd-b7a2-09899ecf1cb3

Latest release Last release tag GitHub commits since latest release (by date) for a branch Documentation Status
Status Tests codecov Linting
Community License: GPL v2 Powered by MDAnalysis

Warning

MDanalysis TUI is alpha software and may change without warning.

Installation

When installing MDAnalysis TUI, we highly recommend using virtual environments. If possible, we strongly recommend that you use Mambaforge as your package manager.

First ensure that you have mamba installed.

Create a virtual environment and activate it:

mamba create --name mda-tui -c conda-forge python=3.10 pip
mamba activate mda-tui

Then install MDAnalysis TUI:

python -m pip install mda-tui

And when you are finished, you can exit the virtual environment with:

mamba deactivate

To use conda instead, replace all mamba commands with conda.

Installation from source

To build MDAnalysis TUI from source, follow the above steps for creating a virtual environment, clone this repository:

git clone https://github.com/p-j-smith/mda-tui.git

Then inside your virtual environment type:

python -m pip install .

If you want to create a development environment, you can install MDAnalysis TUI in editible mode along with the dependencies required for running tests and and building docs with the following command:

python -m pip install -e ".[dev]"

Code of conduct

MDAnalysis TUI is bound by a Code of Conduct.

Copyright

The MDAnalysis TUI source code is hosted at https://github.com/p-j-smith/mda-tui and is available under the GNU General Public License, version 2 (see the file LICENSE).

Copyright (c) 2023, Paul Smith

Acknowledgements

Project based on the MDAnalysis Cookiecutter version 0.1. Please cite MDAnalysis when using MDAnalysis TUI in published work.

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

mda-tui-0.3.0.tar.gz (3.3 MB view hashes)

Uploaded Source

Built Distribution

mda_tui-0.3.0-py3-none-any.whl (28.5 kB view hashes)

Uploaded Python 3

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