.. _chapter_oemolrecord:

********************************************************************************
OEMolRecord
********************************************************************************

.. seealso::

   * :ref:`chapter_oerecord` chapter


:ref:`OEMolRecord <OEDataFlow_OEMolRecord>` is a specialized
:ref:`OERecord <OEDataFlow_OERecord>` with some extra methods
for handling molecules. The presence of convenience methods for handling
molecules is the only difference between an
:ref:`OEMolRecord <OEDataFlow_OEMolRecord>` and an
:ref:`OERecord <OEDataFlow_OERecord>`. The
underlying representation is identical, and either class can be copy-constructed
from the other with no loss of information.

The following example shows how an OEMolRecord can be used, and illustrates
that OEMolRecords are just OERecords with some additional methods.

.. oe:source:: OERecord.py
  :language: python
  :noindent:
  :frag:     SNIPPET-MOL-RECORD

.. oe:source:: OERecord.cpp
   :language: c++
   :noindent:
   :frag:     SNIPPET-MOL-RECORD

Conformer data on records
=======================================================================

:ref:`OEMolRecord <OEDataFlow_OEMolRecord>` also has methods for managing data
for conformers. Each conformer of a molecule can get its own record to store
conformer-specific data onto.

.. oe:source:: OERecord.py
  :language: python
  :noindent:
  :frag:     SNIPPET-CONF-RECORDS

.. oe:source:: OERecord.cpp
   :language: c++
   :noindent:
   :frag:     SNIPPET-CONF-RECORDS


