Metadata-Version: 2.1
Name: hydride
Version: 1.0.0
Summary: Adding hydrogen atoms to molecular models
Home-page: https://hydride.biotite-python.org
Author: The 'Hydride' contributors
License: BSD 3-Clause
Project-URL: Documentation, https://hydride.biotite-python.org
Project-URL: Repository, https://github.com/biotite-dev/hydride
Platform: UNKNOWN
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Python: >=3.7
License-File: LICENSE.rst
Requires-Dist: biotite (>=0.28)
Requires-Dist: numpy (>=1.13)

.. image:: doc/static/assets/hydride_logo.svg
   :width: 400
   :align: center

Hydride - Adding hydrogen atoms to molecular models
===================================================

Many tasks in structural biology ranging from simulations and hydrogen
bond detection to mere visual analysis, require complete molecular
models.
However, most experimentally determined structures do not include
the position of hydrogen atoms, due to their small size and electron
density.

*Hydride* is an easy-to-use program and library written in Python that
adds missing hydrogen atoms to molecular models based on known bond
lengths and angles.
Since it does not require force-field parameters for the specific
molecule(s), it can be used for adding hydrogen atoms to almost any
organic molecule - from small ligands to large protein complexes.

.. image:: doc/images/cover_structure.svg
   :width: 400
   :align: center

|

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

In order to use *Hydride* you need to have Python (at least 3.7) installed.

You can install *Hydride* via

.. code-block:: console

   $ pip install hydride


Usage
-----

In its basic invocation *Hydride* reads an input structure file, adds hydrogen
atoms to the molecular model and writes the resulting model into an output
structure file.

.. code-block:: console

   $ hydride -i input_structure.pdb -o output_structure.pdb


