| Name | ihm JSON |
| Version |
1.8
JSON |
| download |
| home_page | https://github.com/ihmwg/python-ihm |
| Summary | Package for handling IHM mmCIF and BinaryCIF files |
| upload_time | 2024-11-27 06:35:05 |
| maintainer | None |
| docs_url | None |
| author | Ben Webb |
| requires_python | None |
| license | None |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://doi.org/10.5281/zenodo.2603378)
[](https://python-ihm.readthedocs.org/)
[](https://anaconda.org/conda-forge/ihm)
[](https://badge.fury.io/py/ihm)
[](https://github.com/ihmwg/python-ihm/actions?query=workflow%3Abuild)
[](https://ci.appveyor.com/project/benmwebb/python-ihm)
[](https://codecov.io/gh/ihmwg/python-ihm)
This is a Python package to assist in handling [mmCIF](https://mmcif.wwpdb.org/)
and [BinaryCIF](https://github.com/dsehnal/BinaryCIF) files compliant with the
[integrative/hybrid modeling (IHM)](https://mmcif.wwpdb.org/dictionaries/mmcif_ihm_ext.dic/Index/)
extension. It works with Python 2.7 or Python 3.
To handle non-integrative theoretical models (for example, homology models),
see the [python-modelcif](https://github.com/ihmwg/python-modelcif) package
which supports files compliant with the
[ModelCIF](https://mmcif.wwpdb.org/dictionaries/mmcif_ma.dic/Index/)
extension.
Please [see the documentation](https://python-ihm.readthedocs.org/)
or some
[worked examples](https://github.com/ihmwg/python-ihm/tree/main/examples)
for more details.
# Installation with conda, Homebrew or pip
If you are using [Anaconda Python](https://www.anaconda.com/), install with
```
conda install -c conda-forge ihm
```
On a Mac with [Homebrew](https://brew.sh/), install with
```
brew tap salilab/salilab; brew install ihm
```
On a Fedora or RedHat Enterprise Linux box, install with
```
dnf copr enable salilab/salilab; dnf install python3-ihm
```
On an Ubuntu LTS box, install from
[our PPA](https://launchpad.net/~salilab/+archive/ubuntu/ppa) with
```
apt install software-properties-common; add-apt-repository ppa:salilab/ppa;
apt install python3-ihm
```
Alternatively, install with pip:
```
pip install ihm
```
(Note that pip builds a C extension module for faster parsing of mmCIF files.
This requires that your system has a C compiler. If you don't want to build
the C extension module, install with
`pip install ihm --install-option="--without-ext"`.)
# Installation from source code
To build and install from a clone of the GitHub repository, run
```
python setup.py build
python setup.py install
```
Note that a C extension module is built for faster parsing of mmCIF files.
This requires that your system has a C compiler
and [SWIG](http://www.swig.org/). If either of these components are missing, you
can choose to build without the extension by adding `--without-ext` to both
`setup.py` command lines above.
If you want to read or write [BinaryCIF](https://github.com/dsehnal/BinaryCIF)
files, you will also need the
Python [msgpack](https://github.com/msgpack/msgpack-python) package.
# Testing
There are a number of testcases in the `test` directory. Each one can be run
like a normal Python script to test the library. They can also be all run at
once using [nose](https://nose.readthedocs.io/en/latest/)
or [pytest](https://docs.pytest.org/en/latest/). They will also test
the C extension module if it is first built with
`python setup.py build_ext --inplace`.
Raw data
{
"_id": null,
"home_page": "https://github.com/ihmwg/python-ihm",
"name": "ihm",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Ben Webb",
"author_email": "ben@salilab.org",
"download_url": "https://files.pythonhosted.org/packages/83/c8/247dfc71302459b8edac5f354945878c503b90b2ac000f0fd124577de44e/ihm-1.8.tar.gz",
"platform": null,
"description": "[](https://doi.org/10.5281/zenodo.2603378)\n[](https://python-ihm.readthedocs.org/)\n[](https://anaconda.org/conda-forge/ihm)\n[](https://badge.fury.io/py/ihm)\n[](https://github.com/ihmwg/python-ihm/actions?query=workflow%3Abuild)\n[](https://ci.appveyor.com/project/benmwebb/python-ihm)\n[](https://codecov.io/gh/ihmwg/python-ihm)\n\nThis is a Python package to assist in handling [mmCIF](https://mmcif.wwpdb.org/)\nand [BinaryCIF](https://github.com/dsehnal/BinaryCIF) files compliant with the\n[integrative/hybrid modeling (IHM)](https://mmcif.wwpdb.org/dictionaries/mmcif_ihm_ext.dic/Index/)\nextension. It works with Python 2.7 or Python 3.\n\nTo handle non-integrative theoretical models (for example, homology models),\nsee the [python-modelcif](https://github.com/ihmwg/python-modelcif) package\nwhich supports files compliant with the\n[ModelCIF](https://mmcif.wwpdb.org/dictionaries/mmcif_ma.dic/Index/)\nextension.\n\nPlease [see the documentation](https://python-ihm.readthedocs.org/)\nor some\n[worked examples](https://github.com/ihmwg/python-ihm/tree/main/examples)\nfor more details.\n\n# Installation with conda, Homebrew or pip\n\nIf you are using [Anaconda Python](https://www.anaconda.com/), install with\n\n```\nconda install -c conda-forge ihm\n```\n\nOn a Mac with [Homebrew](https://brew.sh/), install with\n\n```\nbrew tap salilab/salilab; brew install ihm\n```\n\nOn a Fedora or RedHat Enterprise Linux box, install with\n\n```\ndnf copr enable salilab/salilab; dnf install python3-ihm\n```\n\nOn an Ubuntu LTS box, install from\n[our PPA](https://launchpad.net/~salilab/+archive/ubuntu/ppa) with\n\n```\napt install software-properties-common; add-apt-repository ppa:salilab/ppa;\napt install python3-ihm\n```\n\nAlternatively, install with pip:\n\n```\npip install ihm\n```\n\n(Note that pip builds a C extension module for faster parsing of mmCIF files.\nThis requires that your system has a C compiler. If you don't want to build\nthe C extension module, install with\n`pip install ihm --install-option=\"--without-ext\"`.)\n\n# Installation from source code\n\nTo build and install from a clone of the GitHub repository, run\n\n```\npython setup.py build\npython setup.py install\n```\n\nNote that a C extension module is built for faster parsing of mmCIF files.\nThis requires that your system has a C compiler\nand [SWIG](http://www.swig.org/). If either of these components are missing, you\ncan choose to build without the extension by adding `--without-ext` to both\n`setup.py` command lines above.\n\nIf you want to read or write [BinaryCIF](https://github.com/dsehnal/BinaryCIF)\nfiles, you will also need the\nPython [msgpack](https://github.com/msgpack/msgpack-python) package.\n\n# Testing\n\nThere are a number of testcases in the `test` directory. Each one can be run\nlike a normal Python script to test the library. They can also be all run at\nonce using [nose](https://nose.readthedocs.io/en/latest/)\nor [pytest](https://docs.pytest.org/en/latest/). They will also test\nthe C extension module if it is first built with\n`python setup.py build_ext --inplace`.\n",
"bugtrack_url": null,
"license": null,
"summary": "Package for handling IHM mmCIF and BinaryCIF files",
"version": "1.8",
"project_urls": {
"Homepage": "https://github.com/ihmwg/python-ihm"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "83c8247dfc71302459b8edac5f354945878c503b90b2ac000f0fd124577de44e",
"md5": "576d3c1abccfe7c6d99c89ff7d403570",
"sha256": "6c19813642487a5af3603beb51a1854559e55ccaa8fddd10986c3026a11b948f"
},
"downloads": -1,
"filename": "ihm-1.8.tar.gz",
"has_sig": false,
"md5_digest": "576d3c1abccfe7c6d99c89ff7d403570",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 350685,
"upload_time": "2024-11-27T06:35:05",
"upload_time_iso_8601": "2024-11-27T06:35:05.715640Z",
"url": "https://files.pythonhosted.org/packages/83/c8/247dfc71302459b8edac5f354945878c503b90b2ac000f0fd124577de44e/ihm-1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-27 06:35:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ihmwg",
"github_project": "python-ihm",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"appveyor": true,
"lcname": "ihm"
}
