rnaglib


Namernaglib JSON
Version 2.0.12 PyPI version JSON
download
home_page
SummaryRNAglib: Tools for learning on the structure of RNA using 2.5D geometric representations
upload_time2024-01-31 06:22:14
maintainer
docs_urlNone
author
requires_python>=3.7
licenseMIT License
keywords rna 3d graph neural network
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
<p align="center">
<img src="https://raw.githubusercontent.com/cgoliver/rnaglib/master/images/rgl.png#gh-light-mode-only" width="30%">
</p>


# RNA Geometric Library (`rnaglib`)
[![Documentation Status](https://readthedocs.org/projects/rnaglib/badge/?version=latest)](https://rnaglib.readthedocs.io/en/latest/?badge=latest)

`RNAglib` is a Python package for studying RNA 2.5D and 3D structures. Functionality includes automated data loading, analysis,
visualization, ML model building and benchmarking.

We host RNAs annotated with molecule, base pair, and nucleotide level attributes. These include, but are not limited to:

* Secondary structure
* 3D coordinates
* Protein binding 
* Small molecule binding 
* Chemical modifications 
* Leontis-westhof base pair geometry classification

![Example graph](https://raw.githubusercontent.com/cgoliver/rnaglib/master/images/rgl_fig.png)

## Cite

```
@article{mallet2022rnaglib,
  title={RNAglib: a python package for RNA 2.5 D graphs},
  author={Mallet, Vincent and Oliver, Carlos and Broadbent, Jonathan and Hamilton, William L and Waldisp{\"u}hl, J{\'e}r{\^o}me},
  journal={Bioinformatics},
  volume={38},
  number={5},
  pages={1458--1459},
  year={2022},
  publisher={Oxford University Press}
}
```

## Data

Data can be downloaded directrly from [Zenodo](https://sandbox.zenodo.org/record/1168342) or through the provided command 
line utility `$ rnaglib_download`.

| Version | Date | Total RNAs | Total Non-Redundant | Non-redundant version | `rnaglib` commit  |
----------|------|------------|---------------------|-----------------------|-------------------|
1.0.0    | 15-02-23 | 5759   | 1176                | 3.269                 |  5446ae2c         |
0.0.0     | 20-07-21 | 3739   | 899                 | 3.186                 |  eb25dabd         |


## Installation

The package can be cloned and the source code used directly. We also deploy it as a pip package and recommend using this
install in conda environments.

If one wants to use GPU support, one should install [Pytorch](https://pytorch.org/get-started/locally/)
and [DGL](https://www.dgl.ai/pages/start.html) with the appropriate options. Otherwise you can just skip this step and
the pip installs of Pytorch and DGL will be used.

Then, one just needs to run :

```
pip install rnaglib
```

Then one can start using the packages functionalities by importing them in one's python script.

### Optional Dependencies

To build 2.5D graphs from scratch locally, for the moment you need to install a fork of `fr3d-python` manually.

```
pip install git+https://github.com/cgoliver/fr3d-python.git
```


## Associated Repositories:

[VeRNAl](https://github.com/cgoliver/vernal)

[RNAMigos](https://github.com/cgoliver/RNAmigos)


## Resources

* [Documentation](https://rnaglib.readthedocs.io/en/latest/?badge=latest)
* [Homepage](https://rnaglib.cs.mcgill.ca/)
* [Twitter](https://twitter.com/rnaglib)
* Contact: `rnaglib@cs.mcgill.ca`

## References

1. Leontis, N. B., & Zirbel, C. L. (2012). Nonredundant 3D Structure Datasets for RNA Knowledge Extraction and
   Benchmarking. In RNA 3D Structure Analysis and Prediction N. Leontis & E. Westhof (Eds.), (Vol. 27, pp. 281–298).
   Springer Berlin Heidelberg. doi:10.1007/978-3-642-25740-7\_13


            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "rnaglib",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "",
    "keywords": "RNA,3D,graph neural network",
    "author": "",
    "author_email": "Vincent Mallet <vincentx15@gmail.com>, Carlos Oliver <oliver@biochem.mpg.de>, Jonathan Broadbent <jonathan.broadbent@mail.utoronto.ca>, \"William L. Hamilton\" <wlh@cs.mcgill.ca>, J\u00e9rome Waldispuhl <jeromew@cs.mcgill.ca>",
    "download_url": "https://files.pythonhosted.org/packages/e0/a1/3bc3a3e3156fd19dee2af9ae5abc4d4b367e85bc79b3cd64b1ef48b41a51/rnaglib-2.0.12.tar.gz",
    "platform": null,
    "description": "\n<p align=\"center\">\n<img src=\"https://raw.githubusercontent.com/cgoliver/rnaglib/master/images/rgl.png#gh-light-mode-only\" width=\"30%\">\n</p>\n\n\n# RNA Geometric Library (`rnaglib`)\n[![Documentation Status](https://readthedocs.org/projects/rnaglib/badge/?version=latest)](https://rnaglib.readthedocs.io/en/latest/?badge=latest)\n\n`RNAglib` is a Python package for studying RNA 2.5D and 3D structures. Functionality includes automated data loading, analysis,\nvisualization, ML model building and benchmarking.\n\nWe host RNAs annotated with molecule, base pair, and nucleotide level attributes. These include, but are not limited to:\n\n* Secondary structure\n* 3D coordinates\n* Protein binding \n* Small molecule binding \n* Chemical modifications \n* Leontis-westhof base pair geometry classification\n\n![Example graph](https://raw.githubusercontent.com/cgoliver/rnaglib/master/images/rgl_fig.png)\n\n## Cite\n\n```\n@article{mallet2022rnaglib,\n  title={RNAglib: a python package for RNA 2.5 D graphs},\n  author={Mallet, Vincent and Oliver, Carlos and Broadbent, Jonathan and Hamilton, William L and Waldisp{\\\"u}hl, J{\\'e}r{\\^o}me},\n  journal={Bioinformatics},\n  volume={38},\n  number={5},\n  pages={1458--1459},\n  year={2022},\n  publisher={Oxford University Press}\n}\n```\n\n## Data\n\nData can be downloaded directrly from [Zenodo](https://sandbox.zenodo.org/record/1168342) or through the provided command \nline utility `$ rnaglib_download`.\n\n| Version | Date | Total RNAs | Total Non-Redundant | Non-redundant version | `rnaglib` commit  |\n----------|------|------------|---------------------|-----------------------|-------------------|\n1.0.0    | 15-02-23 | 5759   | 1176                | 3.269                 |  5446ae2c         |\n0.0.0     | 20-07-21 | 3739   | 899                 | 3.186                 |  eb25dabd         |\n\n\n## Installation\n\nThe package can be cloned and the source code used directly. We also deploy it as a pip package and recommend using this\ninstall in conda environments.\n\nIf one wants to use GPU support, one should install [Pytorch](https://pytorch.org/get-started/locally/)\nand [DGL](https://www.dgl.ai/pages/start.html) with the appropriate options. Otherwise you can just skip this step and\nthe pip installs of Pytorch and DGL will be used.\n\nThen, one just needs to run :\n\n```\npip install rnaglib\n```\n\nThen one can start using the packages functionalities by importing them in one's python script.\n\n### Optional Dependencies\n\nTo build 2.5D graphs from scratch locally, for the moment you need to install a fork of `fr3d-python` manually.\n\n```\npip install git+https://github.com/cgoliver/fr3d-python.git\n```\n\n\n## Associated Repositories:\n\n[VeRNAl](https://github.com/cgoliver/vernal)\n\n[RNAMigos](https://github.com/cgoliver/RNAmigos)\n\n\n## Resources\n\n* [Documentation](https://rnaglib.readthedocs.io/en/latest/?badge=latest)\n* [Homepage](https://rnaglib.cs.mcgill.ca/)\n* [Twitter](https://twitter.com/rnaglib)\n* Contact: `rnaglib@cs.mcgill.ca`\n\n## References\n\n1. Leontis, N. B., & Zirbel, C. L. (2012). Nonredundant 3D Structure Datasets for RNA Knowledge Extraction and\n   Benchmarking. In RNA 3D Structure Analysis and Prediction N. Leontis & E. Westhof (Eds.), (Vol. 27, pp. 281\u2013298).\n   Springer Berlin Heidelberg. doi:10.1007/978-3-642-25740-7\\_13\n\n",
    "bugtrack_url": null,
    "license": "MIT License",
    "summary": "RNAglib: Tools for learning on the structure of RNA using 2.5D geometric representations",
    "version": "2.0.12",
    "project_urls": {
        "Documentation": "https://rnaglib.readthedocs.io/en/latest/index.html",
        "GitHub": "https://github.com/cgoliver/rnaglib"
    },
    "split_keywords": [
        "rna",
        "3d",
        "graph neural network"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e95436b9cd225374e2ebf394ea93dd7afb7952c210ff5f071a848af6891941e1",
                "md5": "f7ac829d245698411e40b24a638418f7",
                "sha256": "f3bc61564d45b4f82a7ae808a9fc3cb0f1e7e07286a5079d16241ed7d658c39b"
            },
            "downloads": -1,
            "filename": "rnaglib-2.0.12-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "f7ac829d245698411e40b24a638418f7",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 138570,
            "upload_time": "2024-01-31T06:22:12",
            "upload_time_iso_8601": "2024-01-31T06:22:12.701068Z",
            "url": "https://files.pythonhosted.org/packages/e9/54/36b9cd225374e2ebf394ea93dd7afb7952c210ff5f071a848af6891941e1/rnaglib-2.0.12-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e0a13bc3a3e3156fd19dee2af9ae5abc4d4b367e85bc79b3cd64b1ef48b41a51",
                "md5": "556df928e56121e1fc654147b8754cea",
                "sha256": "cfffeb6743891c4193369c811eef34b38fb166db8c19deaf3c1a3b775a3bea19"
            },
            "downloads": -1,
            "filename": "rnaglib-2.0.12.tar.gz",
            "has_sig": false,
            "md5_digest": "556df928e56121e1fc654147b8754cea",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 123245,
            "upload_time": "2024-01-31T06:22:14",
            "upload_time_iso_8601": "2024-01-31T06:22:14.959069Z",
            "url": "https://files.pythonhosted.org/packages/e0/a1/3bc3a3e3156fd19dee2af9ae5abc4d4b367e85bc79b3cd64b1ef48b41a51/rnaglib-2.0.12.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-31 06:22:14",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "cgoliver",
    "github_project": "rnaglib",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "rnaglib"
}
        
Elapsed time: 0.17626s