Metadata-Version: 2.4
Name: biointerface
Version: 0.5.1
Summary: BioInterface is a Biopython based package that extracts Protein-DNA interfaces in a PDB structures.
Author-email: Alessandro Pandolfi <alessandro.pandolfi@protonmail.com>
Maintainer-email: Alessandro Pandolfi <alessandro.pandolfi@protonmail.com>
License: MIT license
Project-URL: bugs, https://gitlab.com/MorfeoRenai/biointerface/-/issues
Project-URL: changelog, https://gitlab.com/MorfeoRenai/biointerface/-/blob/main/HISTORY.rst
Project-URL: homepage, https://gitlab.com/MorfeoRenai/biointerface
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: pandas
Requires-Dist: biopython
Requires-Dist: pdbnucleicacids>=0.2.2
Provides-Extra: dev
Requires-Dist: ipykernel; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: tox; extra == "dev"
Requires-Dist: coverage; extra == "dev"
Requires-Dist: sphinx; extra == "dev"
Requires-Dist: watchdog; extra == "dev"
Requires-Dist: bump-my-version; extra == "dev"
Requires-Dist: wheel; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

============
BioInterface
============


.. image:: https://img.shields.io/pypi/v/biointerface.svg
        :target: https://pypi.python.org/pypi/biointerface

.. image:: https://readthedocs.org/projects/biointerface/badge/?version=latest
        :target: https://biointerface.readthedocs.io/en/latest/?version=latest
        :alt: Documentation Status

.. image:: https://gitlab.com/MorfeoRenai/biointerface/badges/main/coverage.svg
        :target: https://gitlab.com/MorfeoRenai/biointerface/-/commits/main
        :alt: Coverage Status


BioInterface is a `Biopython <https://biopython.org/>`_ based package that extracts Protein-DNA
interfaces in a PDB structures.

* Free software: MIT license
* Documentation: https://biointerface.readthedocs.io.


Get Started
-----------

This is a little tutorial on how to use the BioInterface package.

The official release is found in the Python Package Index (PyPI)

.. code-block:: console

    $ pip install biointerface

You can extract a single Protein-DNA interface from a single protein chain.

.. code-block:: python

    from Bio.PDB.MMCIFParser import MMCIFParser
    from biointerface import Interface, build_interfaces

    # parse and build structure with Biopython
    parser = MMCIFParser()
    structure = parser.get_structure(
        structure_id="1A02", filename="1a02-assembly1.cif"
    )

    # extract interface from a specific protein chain
    face = Interface(
        structure=structure,
        protein_chain_id="F",
        search_radius=5.0
    )
    face

.. code-block:: console

    <Interface chains=F:BA contacts=258 search_radius=5.0>

Check the official documentation for more information.


Feaures
-------

* Extract one specific Protein-DNA interface in a PDB structure, given a protein chain id;

* Extract all Protein-DNA interfaces in a PDB structure;

* Get all interacting residues in a interface;

* Get all interacting atoms in a interface;

* Interface data as ``pandas`` DataFrame;

* Get all continous protein-bound double-strand nucleic acids;

* Get nucleic acid binding domain;


TODO
--------

* Don't use chain ids: it ignores the case where a chain has both protein and nucleic


Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
