File: README.rst

package info (click to toggle)
python-cirpy 1.0.2-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 184 kB
  • sloc: python: 429; makefile: 165
file content (66 lines) | stat: -rw-r--r-- 2,128 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
CIRpy
=====

.. image:: http://img.shields.io/pypi/v/CIRpy.svg?style=flat
    :target: https://pypi.python.org/pypi/CIRpy

.. image:: http://img.shields.io/pypi/l/CIRpy.svg?style=flat
    :target: https://github.com/mcs07/CIRpy/blob/master/LICENSE

.. image:: http://img.shields.io/travis/mcs07/CIRpy/master.svg?style=flat
    :target: https://travis-ci.org/mcs07/CIRpy

.. image:: http://img.shields.io/coveralls/mcs07/CIRpy/master.svg?style=flat
    :target: https://coveralls.io/r/mcs07/CIRpy?branch=master

Introduction
------------

**CIRpy** is a Python interface for the `Chemical Identifier Resolver (CIR)`_ by the CADD Group at the NCI/NIH.

CIR is a web service that will resolve any chemical identifier to another chemical representation. For example, you can
pass it a chemical name and and request the corresponding SMILES string::

    >>> import cirpy
    >>> cirpy.resolve('Aspirin', 'smiles')
    'C1=CC=CC(=C1C(O)=O)OC(C)=O'

CIRpy makes interacting with CIR through Python easy. There's no need to construct url requests and parse XML responses
— CIRpy does all this for you.

Installation
------------

Install CIRpy using::

    pip install cirpy

Alternatively, try one of the other `installation options`_.

Documentation
-------------

Full documentation is available at http://cirpy.readthedocs.org.

Contribute
----------

- Feature ideas and bug reports are welcome on the `Issue Tracker`_.
- Fork the `source code`_ on GitHub, make changes and file a pull request.

Acknowledgements
----------------

All of CIRpy's functionality relies on the fantastic `CIR web service`_ created by the CADD Group at the NCI/NIH.

License
-------

CIRpy is licensed under the `MIT license`_.

.. _`Chemical Identifier Resolver (CIR)`: http://cactus.nci.nih.gov/chemical/structure
.. _`installation options`: http://cirpy.readthedocs.org/en/latest/guide/install.html
.. _`CIR web service`: http://cactus.nci.nih.gov/chemical/structure
.. _`source code`: https://github.com/mcs07/CIRpy
.. _`Issue Tracker`: https://github.com/mcs07/CIRpy/issues
.. _`MIT license`: https://github.com/mcs07/CIRpy/blob/master/LICENSE