imdclient


Nameimdclient JSON
Version 0.2.2 PyPI version JSON
download
home_pageNone
SummaryReceiver for IMD v2 and v3 data from simulation engines like Gromacs, LAMMPS, and NAMD
upload_time2025-07-21 01:57:37
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseNone
keywords molecular simulations
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            IMDClient
==============================
[//]: # (Badges)

| **Latest release** | [![Last release tag][badge_release]][url_latest_release] ![GitHub commits since latest release (by date) for a branch][badge_commits_since]  [![Documentation Status][badge_docs]][url_docs]|
| :----------------- | :------- |
| **Status**         | [![GH Actions Status][badge_actions]][url_actions] [![codecov][badge_codecov]][url_codecov] |
| **Community**      | [![License: MIT][badge_license]][url_license]

[badge_actions]: https://github.com/becksteinlab/imdclient/actions/workflows/gh-ci.yaml/badge.svg
[badge_codecov]: https://codecov.io/gh/becksteinlab/imdclient/branch/main/graph/badge.svg
[badge_commits_since]: https://img.shields.io/github/commits-since/becksteinlab/imdclient/latest
[badge_docs]: https://readthedocs.org/projects/imdclient/badge/?version=latest
[badge_license]: https://img.shields.io/badge/License-MIT-blue.svg
[badge_release]: https://img.shields.io/github/release-pre/becksteinlab/imdclient.svg
[url_actions]: https://github.com/becksteinlab/imdclient/actions?query=branch%3Amain+workflow%3Agh-ci
[url_codecov]: https://codecov.io/gh/becksteinlab/imdclient/branch/main
[url_docs]: https://imdclient.readthedocs.io/en/latest/?badge=latest
[url_latest_release]: https://github.com/becksteinlab/imdclient/releases
[url_license]: https://opensource.org/license/mit

Receiver for [IMDv3 protocol](https://imdclient.readthedocs.io/en/latest/protocol_v3.html) from simulation engines like Gromacs, LAMMPS, and NAMD.

IMDClient is bound by a [Code of Conduct](https://github.com/becksteinlab/imdclient/blob/main/CODE_OF_CONDUCT.md).

### Installation

IMDClient requires Python 3.10 or higher.

#### Install via mamba (recommended)
To install the latest release of IMDClient from conda-forge:

```
mamba install -c conda-forge imdclient
```

#### Install via pip
To install the latest release of IMDClient from PyPI:

```
pip install imdclient
```

---

### Building from Source
To build IMDClient from source, we highly recommend using virtual environments.
If possible, we recommend that you use [mamba](https://mamba.readthedocs.io/en/latest/) as your package manager through [miniforge](https://github.com/conda-forge/miniforge). (You can substitute `conda` for `mamba` in the commands below if you prefer.)

Below we provide instructions both for `mamba` and for `pip`.

#### Source build with mamba
1. Ensure you have [mamba](https://mamba.readthedocs.io/en/latest/installation/mamba-installation.html) installed.

2. Create and activate a new environment:

```
mamba create --name imdclient
mamba activate imdclient
```

3. (Recommended) Install all dependencies using the provided environment YAML files for a clean and reproducible environment:

```
mamba env update --name imdclient --file devtools/conda-envs/test_env.yaml
mamba env update --name imdclient --file docs/requirements.yaml
```

4. Build and install IMDClient in editable mode:

```
pip install -e .
```

5. (Optional) Update dependencies:

```
mamba update --all
```

6. Deactivate the environment when finished:

```
mamba deactivate
```

#### Source build with pip

1. (Optional) Create and activate a virtual environment:

```
python -m venv venv
source venv/bin/activate
```

2. Install IMDClient from source:

```
pip install .
```

3. (Optional) For development (tests and docs):

```
pip install ".[test,doc]"
```

### Copyright

The IMDClient source code is hosted at https://github.com/becksteinlab/imdclient
and is available under the MIT license (see the file [LICENSE](https://github.com/becksteinlab/imdclient/blob/main/LICENSE)).

Copyright (c) 2024-2025, imdclient [AUTHORS](https://github.com/Becksteinlab/imdclient/blob/main/AUTHORS.md)


#### Acknowledgements
 
Project based on the 
[MDAnalysis Cookiecutter](https://github.com/MDAnalysis/cookiecutter-mda) version 0.1.

**If you use IMDClient in your research, please cite [IMDClient](https://github.com/Becksteinlab/imdclient) in your publications.**

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "imdclient",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "Lawson <ljwoods2@asu.edu>, Amruthesh Thirumalaiswamy <athiru12@asu.edu>",
    "keywords": "molecular simulations",
    "author": null,
    "author_email": "Lawson <ljwoods2@asu.edu>",
    "download_url": "https://files.pythonhosted.org/packages/fc/86/9980f43bd2b8a71b22ea4adc49fa28f59aa5dc5c07d8cf63484a85f06320/imdclient-0.2.2.tar.gz",
    "platform": null,
    "description": "IMDClient\n==============================\n[//]: # (Badges)\n\n| **Latest release** | [![Last release tag][badge_release]][url_latest_release] ![GitHub commits since latest release (by date) for a branch][badge_commits_since]  [![Documentation Status][badge_docs]][url_docs]|\n| :----------------- | :------- |\n| **Status**         | [![GH Actions Status][badge_actions]][url_actions] [![codecov][badge_codecov]][url_codecov] |\n| **Community**      | [![License: MIT][badge_license]][url_license]\n\n[badge_actions]: https://github.com/becksteinlab/imdclient/actions/workflows/gh-ci.yaml/badge.svg\n[badge_codecov]: https://codecov.io/gh/becksteinlab/imdclient/branch/main/graph/badge.svg\n[badge_commits_since]: https://img.shields.io/github/commits-since/becksteinlab/imdclient/latest\n[badge_docs]: https://readthedocs.org/projects/imdclient/badge/?version=latest\n[badge_license]: https://img.shields.io/badge/License-MIT-blue.svg\n[badge_release]: https://img.shields.io/github/release-pre/becksteinlab/imdclient.svg\n[url_actions]: https://github.com/becksteinlab/imdclient/actions?query=branch%3Amain+workflow%3Agh-ci\n[url_codecov]: https://codecov.io/gh/becksteinlab/imdclient/branch/main\n[url_docs]: https://imdclient.readthedocs.io/en/latest/?badge=latest\n[url_latest_release]: https://github.com/becksteinlab/imdclient/releases\n[url_license]: https://opensource.org/license/mit\n\nReceiver for [IMDv3 protocol](https://imdclient.readthedocs.io/en/latest/protocol_v3.html) from simulation engines like Gromacs, LAMMPS, and NAMD.\n\nIMDClient is bound by a [Code of Conduct](https://github.com/becksteinlab/imdclient/blob/main/CODE_OF_CONDUCT.md).\n\n### Installation\n\nIMDClient requires Python 3.10 or higher.\n\n#### Install via mamba (recommended)\nTo install the latest release of IMDClient from conda-forge:\n\n```\nmamba install -c conda-forge imdclient\n```\n\n#### Install via pip\nTo install the latest release of IMDClient from PyPI:\n\n```\npip install imdclient\n```\n\n---\n\n### Building from Source\nTo build IMDClient from source, we highly recommend using virtual environments.\nIf possible, we recommend that you use [mamba](https://mamba.readthedocs.io/en/latest/) as your package manager through [miniforge](https://github.com/conda-forge/miniforge). (You can substitute `conda` for `mamba` in the commands below if you prefer.)\n\nBelow we provide instructions both for `mamba` and for `pip`.\n\n#### Source build with mamba\n1. Ensure you have [mamba](https://mamba.readthedocs.io/en/latest/installation/mamba-installation.html) installed.\n\n2. Create and activate a new environment:\n\n```\nmamba create --name imdclient\nmamba activate imdclient\n```\n\n3. (Recommended) Install all dependencies using the provided environment YAML files for a clean and reproducible environment:\n\n```\nmamba env update --name imdclient --file devtools/conda-envs/test_env.yaml\nmamba env update --name imdclient --file docs/requirements.yaml\n```\n\n4. Build and install IMDClient in editable mode:\n\n```\npip install -e .\n```\n\n5. (Optional) Update dependencies:\n\n```\nmamba update --all\n```\n\n6. Deactivate the environment when finished:\n\n```\nmamba deactivate\n```\n\n#### Source build with pip\n\n1. (Optional) Create and activate a virtual environment:\n\n```\npython -m venv venv\nsource venv/bin/activate\n```\n\n2. Install IMDClient from source:\n\n```\npip install .\n```\n\n3. (Optional) For development (tests and docs):\n\n```\npip install \".[test,doc]\"\n```\n\n### Copyright\n\nThe IMDClient source code is hosted at https://github.com/becksteinlab/imdclient\nand is available under the MIT license (see the file [LICENSE](https://github.com/becksteinlab/imdclient/blob/main/LICENSE)).\n\nCopyright (c) 2024-2025, imdclient [AUTHORS](https://github.com/Becksteinlab/imdclient/blob/main/AUTHORS.md)\n\n\n#### Acknowledgements\n \nProject based on the \n[MDAnalysis Cookiecutter](https://github.com/MDAnalysis/cookiecutter-mda) version 0.1.\n\n**If you use IMDClient in your research, please cite [IMDClient](https://github.com/Becksteinlab/imdclient) in your publications.**\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Receiver for IMD v2 and v3 data from simulation engines like Gromacs, LAMMPS, and NAMD",
    "version": "0.2.2",
    "project_urls": {
        "documentation": "https://imdclient.readthedocs.io",
        "source": "https://github.com/becksteinlab/imdclient"
    },
    "split_keywords": [
        "molecular",
        "simulations"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "265d4713dd1c4d508e7d6854ae8e7a74679e2846c2a69be6575b9ab99eba56a8",
                "md5": "002a52e359328aad9b0d73c0bad67bd9",
                "sha256": "4c423154d52634873e21666b458fa8d4d1749c2960986759826a6b243eb1d8cf"
            },
            "downloads": -1,
            "filename": "imdclient-0.2.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "002a52e359328aad9b0d73c0bad67bd9",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 593249,
            "upload_time": "2025-07-21T01:57:34",
            "upload_time_iso_8601": "2025-07-21T01:57:34.944223Z",
            "url": "https://files.pythonhosted.org/packages/26/5d/4713dd1c4d508e7d6854ae8e7a74679e2846c2a69be6575b9ab99eba56a8/imdclient-0.2.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "fc869980f43bd2b8a71b22ea4adc49fa28f59aa5dc5c07d8cf63484a85f06320",
                "md5": "36e05d72bfc0ddce3e5b547e05ce2899",
                "sha256": "86f25e50c396b95c2d34704c73ce7e96a567975f618672edcc071ae922975eed"
            },
            "downloads": -1,
            "filename": "imdclient-0.2.2.tar.gz",
            "has_sig": false,
            "md5_digest": "36e05d72bfc0ddce3e5b547e05ce2899",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 587214,
            "upload_time": "2025-07-21T01:57:37",
            "upload_time_iso_8601": "2025-07-21T01:57:37.092728Z",
            "url": "https://files.pythonhosted.org/packages/fc/86/9980f43bd2b8a71b22ea4adc49fa28f59aa5dc5c07d8cf63484a85f06320/imdclient-0.2.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-21 01:57:37",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "becksteinlab",
    "github_project": "imdclient",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "imdclient"
}
        
Elapsed time: 0.44587s