.. oe:namespace:: OEChem



.. meta::
   :keywords: OEConfBase, ConfBase


.. _OEChem_OEConfBase:

.. oe:class:: OEConfBase

   .. oe:api::

      class OEConfBase : public OEMolBase

   :ref:`OEConfBase <OEChem_OEConfBase>` is the generic conformer base class.
   It is an abstract base class which defines the interface for
   conformer implementations. Coordinates can be stored in
   :ref:`OEHalfFloat <OEPlatform_OEHalfFloat>` (16-bit), ``float`` (32-bit),
   ``double`` (64-bit), or ``long double`` (>= 64-bit). The precision
   is determined by the constructor argument given to
   :ref:`OEMol <OEChem_OEMol>`, taken from the
   :oe:constns:`OEChem::OEMCMolType` namespace. The default is 32-bit
   ``float``.

   The following methods are publicly inherited from :ref:`OEMolBase <OEChem_OEMolBase>`:

   =========================================================== =========================================================== ============================================================
   :oe:meth:`operator=<OEChem::OEMolBase::operator=>`          :oe:meth:`GetDimension<OEChem::OEMolBase::GetDimension>`    :oe:meth:`NumBonds<OEChem::OEMolBase::NumBonds>`            
   :oe:meth:`operator bool<OEChem::OEMolBase::operator bool>`  :oe:meth:`GetEnergy<OEChem::OEMolBase::GetEnergy>`          :oe:meth:`NumGroups<OEChem::OEMolBase::NumGroups>`          
   :oe:meth:`Clear<OEChem::OEMolBase::Clear>`                  :oe:meth:`GetGroup<OEChem::OEMolBase::GetGroup>`            :oe:meth:`OrderAtoms<OEChem::OEMolBase::OrderAtoms>`        
   :oe:meth:`ClearCoords<OEChem::OEMolBase::ClearCoords>`      :oe:meth:`GetGroups<OEChem::OEMolBase::GetGroups>`          :oe:meth:`OrderBonds<OEChem::OEMolBase::OrderBonds>`        
   :oe:meth:`Compress<OEChem::OEMolBase::Compress>`            :oe:meth:`GetMaxAtomIdx<OEChem::OEMolBase::GetMaxAtomIdx>`  :oe:meth:`ResetPerceived<OEChem::OEMolBase::ResetPerceived>`
   :oe:meth:`Count<OEChem::OEMolBase::Count>`                  :oe:meth:`GetMaxBondIdx<OEChem::OEMolBase::GetMaxBondIdx>`  :oe:meth:`SetCoords<OEChem::OEMolBase::SetCoords>`          
   :oe:meth:`CreateCopy<OEChem::OEMolBase::CreateCopy>`        :oe:meth:`GetTitle<OEChem::OEMolBase::GetTitle>`            :oe:meth:`SetDimension<OEChem::OEMolBase::SetDimension>`    
   :oe:meth:`DeleteAtom<OEChem::OEMolBase::DeleteAtom>`        :oe:meth:`HasPerceived<OEChem::OEMolBase::HasPerceived>`    :oe:meth:`SetEnergy<OEChem::OEMolBase::SetEnergy>`          
   :oe:meth:`DeleteBond<OEChem::OEMolBase::DeleteBond>`        :oe:meth:`IsDataType<OEChem::OEMolBase::IsDataType>`        :oe:meth:`SetPerceived<OEChem::OEMolBase::SetPerceived>`    
   :oe:meth:`DeleteGroup<OEChem::OEMolBase::DeleteGroup>`      :oe:meth:`IsDeleted<OEChem::OEMolBase::IsDeleted>`          :oe:meth:`SetRxn<OEChem::OEMolBase::SetRxn>`                
   :oe:meth:`GetAtom<OEChem::OEMolBase::GetAtom>`              :oe:meth:`IsRxn<OEChem::OEMolBase::IsRxn>`                  :oe:meth:`SetTitle<OEChem::OEMolBase::SetTitle>`            
   :oe:meth:`GetAtoms<OEChem::OEMolBase::GetAtoms>`            :oe:meth:`NewAtom<OEChem::OEMolBase::NewAtom>`              :oe:meth:`Sweep<OEChem::OEMolBase::Sweep>`                  
   :oe:meth:`GetBond<OEChem::OEMolBase::GetBond>`              :oe:meth:`NewBond<OEChem::OEMolBase::NewBond>`              :oe:meth:`UnCompress<OEChem::OEMolBase::UnCompress>`        
   :oe:meth:`GetBonds<OEChem::OEMolBase::GetBonds>`            :oe:meth:`NewGroup<OEChem::OEMolBase::NewGroup>`            
   :oe:meth:`GetCoords<OEChem::OEMolBase::GetCoords>`          :oe:meth:`NumAtoms<OEChem::OEMolBase::NumAtoms>`            
   =========================================================== =========================================================== ============================================================

   .. oe:language:: java

      The following methods are publicly inherited from :ref:`OEMolBase <OEChem_OEMolBase>` only in Java:

      ====================================================== ====================================================== =========================================================
      :oe:meth:`GetAtomList<OEChem::OEMolBase::GetAtomList>` :oe:meth:`GetBondList<OEChem::OEMolBase::GetBondList>` :oe:meth:`GetGroupList<OEChem::OEMolBase::GetGroupList>` 
      ====================================================== ====================================================== =========================================================

   The following methods are publicly inherited from :ref:`OEBase <OESystem_OEBase>`:

   ======================================================== ========================================================= =========================================================
   :oe:meth:`operator=<OESystem::OEBase::operator=>`        :oe:meth:`GetData<OESystem::OEBase::GetData>`             :oe:meth:`IsDataType<OESystem::OEBase::IsDataType>`      
   :oe:meth:`operator+=<OESystem::OEBase::operator+=>`      :oe:meth:`GetDataIter<OESystem::OEBase::GetDataIter>`     :oe:meth:`SetBaseData<OESystem::OEBase::SetBaseData>`    
   :oe:meth:`AddBaseData<OESystem::OEBase::AddBaseData>`    :oe:meth:`GetDataType<OESystem::OEBase::GetDataType>`     :oe:meth:`SetBoolData<OESystem::OEBase::SetBoolData>`    
   :oe:meth:`AddData<OESystem::OEBase::AddData>`            :oe:meth:`GetDoubleData<OESystem::OEBase::GetDoubleData>` :oe:meth:`SetData<OESystem::OEBase::SetData>`            
   :oe:meth:`Clear<OESystem::OEBase::Clear>`                :oe:meth:`GetFloatData<OESystem::OEBase::GetFloatData>`   :oe:meth:`SetDoubleData<OESystem::OEBase::SetDoubleData>`
   :oe:meth:`CreateCopy<OESystem::OEBase::CreateCopy>`      :oe:meth:`GetIntData<OESystem::OEBase::GetIntData>`       :oe:meth:`SetFloatData<OESystem::OEBase::SetFloatData>`  
   :oe:meth:`DeleteData<OESystem::OEBase::DeleteData>`      :oe:meth:`GetStringData<OESystem::OEBase::GetStringData>` :oe:meth:`SetIntData<OESystem::OEBase::SetIntData>`      
   :oe:meth:`GetBoolData<OESystem::OEBase::GetBoolData>`    :oe:meth:`HasData<OESystem::OEBase::HasData>`             :oe:meth:`SetStringData<OESystem::OEBase::SetStringData>`
   ======================================================== ========================================================= =========================================================

   .. oe:method:: operator=
      :language: c++

      .. oe:api::

         OEConfBase& operator=(const OEMolBase& rhs)
         OEConfBase& operator=(const OEConfBase& rhs)

      Conformer assignment either from another conformer or
      :ref:`OEMolBase <OEChem_OEMolBase>`.

      Assignment operator.


   .. oe:method:: AddAtom

      .. oe:language:: c++ java csharp

         .. oe:api::

            void AddAtom(OEAtomBase* atom)=0
            void AddAtom(const OEAtomBase* rhs, OEAtomBase* atom)=0

      .. oe:language:: python

         .. oe:api:: python

            AddAtom(atom: OEAtomBase) -> None
            AddAtom(rhs: OEAtomBase, atom: OEAtomBase) -> None

      :oe:meth:`OEChem::OEConfBase::AddAtom` is a helper method
      that the :ref:`OEMCMolBase <OEChem_OEMCMolBase>` can call as an
      adjunct to :oe:meth:`OEChem::OEMolBase::NewAtom` on the
      molecule which contains the conformers.

      .. warning::

         This should not be called by a primary user.

   .. oe:method:: AddBond

      .. oe:language:: c++ java csharp

         .. oe:api::

            void AddBond(OEBondBase* bond)=0

      .. oe:language:: python

         .. oe:api:: python

            AddBond(bond: OEBondBase) -> None

      :oe:meth:`OEChem::OEConfBase::AddBond` is a helper method
      that the :ref:`OEMCMolBase <OEChem_OEMCMolBase>` can call as an
      adjunct to :oe:meth:`OEChem::OEMolBase::NewBond` on the
      molecule which contains the conformers.

      .. warning::

         This should not be called by a primary user.

   .. oe:method:: Delete

      .. oe:language:: c++ java csharp

         .. oe:api::

            void Delete()=0

      .. oe:language:: python

         .. oe:api:: python

            Delete() -> None

      The :oe:meth:`OEChem::OEConfBase::Delete` method is equivalent to call
      :oe:meth:`OEChem::OEMCMolBase::DeleteConf` from the parent molecule.
      It removes the current conformer from the  :ref:`OEMCMolBase <OEChem_OEMCMolBase>`
      object containing it.
      These functions do not invalidate current :ref:`OEIter <OESystem_OEIter>` objects,
      and all calls to :oe:meth:`OEChem::OEMCMolBase::GetConfs` called after
      the call to :oe:meth:`OEChem::OEConfBase::Delete` will not contain the
      deleted conformer.

   .. oe:method:: GetCoordsPtr
      :language: c++

      .. oe:api::

         unsigned int GetCoordsPtr(const void *&ptr) const = 0
         unsigned int GetCoordsPtr(void *&ptr) = 0

      Use with care, this provides direct access to the coordinates
      pointer of this conformer. Returns a constant from the
      :oe:constns:`OEChem::OECoordsType` namespace specifying the type
      of data ``ptr`` will point
      to. :oe:const:`OEChem::OECoordsType::Undefined` is returned if
      the underlying implementation does not allow direct memory
      access. If access is allowed, a pointer to the memory storing
      the coordinates is returned as ``ptr``. That pointer is
      considered owned by this class, and may be invalidated by other
      non-const methods on the :ref:`OEConfBase <OEChem_OEConfBase>` or
      :ref:`OEMCMolBase <OEChem_OEMCMolBase>`.

      .. warning::

         Users should avoid using this method directly. Use
         :ref:`OEConstCoords <OEChem_OEConstCoords>` or
         :ref:`OEMutableCoords <OEChem_OEMutableCoords>` instead.

   .. oe:method:: ClearCoords

      .. oe:language:: c++ java csharp

         .. oe:api::

            void ClearCoords() = 0

      .. oe:language:: python

         .. oe:api:: python

            ClearCoords() -> None

      Clears the coordinates, clears perception flags and sets the coordinate
      dimension to ``0``

      .. seealso::

         * :oe:meth:`OEChem::OEConfBase::GetCoords`
         * :oe:meth:`OEChem::OEConfBase::SetCoords`

   .. oe:method:: GetCoords

      .. oe:language:: python

         .. oe:api:: python

            GetCoords() -> {idx : (x_0, y_0, z_0), ... }

         Returns a Python dictionary of the coordinates of this
         molecule. The dictionary is keyed off the index of the
         :ref:`OEAtomBase <OEChem_OEAtomBase>` as returned by
         :oe:meth:`OEChem::OEAtomBase::GetIdx`. The values will always
         be a 3-element tuple of floating point values. Note, the
         dictionary will not contain entries for deleted atoms, making
         it significantly easier to use than the following
         ``OEFloatArray`` overloads. This also means the keys of the
         dictionary are not always guaranteed to be contiguous
         integers.

         .. note::

            The overload that returns a dictionary is for convenience
            over performance as it is significantly more
            pythonic. However, if the floating point values are not
            needed in Python and just being passed to another OpenEye
            toolkit function, using the following overloads with
            ``OEFloatArray`` objects will be significantly faster.

      .. oe:language:: c++ java csharp

         .. oe:api::

            bool GetCoords(OEPlatform::OEHalfFloat *) const = 0
            bool GetCoords(float *) const = 0
            bool GetCoords(double *) const = 0
            bool GetCoords(long double *) const = 0

      .. oe:language:: python

         .. oe:api:: python

            GetCoords(arg2: OEHalfFloat) -> bool
            GetCoords(arg2: OEFloatArray) -> bool
            GetCoords(arg2: OEDoubleArray) -> bool
            GetCoords(OEDoubleArray: int) -> bool
            GetCoords(atom: OEAtomBase) -> (x: float, y: float, z: float)

      Fills the array passed into the function with a copy of the coordinates of
      the conformer.
      The array passed in should be at least of length
      :oe:meth:`OEChem::OEConfBase::GetMaxAtomIdx<OEChem::OEMolBase::GetMaxAtomIdx>` * ``3``.
      The coordinates of each atom in the conformer will begin at
      ``coords[atom->GetIdx()*3]`` in the array.
      Changes made to the array after this function call will have no effect on
      the conformer.

      .. oe:language:: c++ java csharp

         .. oe:api::

            bool GetCoords(const OEAtomBase *, OEPlatform::OEHalfFloat* coords) const = 0
            bool GetCoords(const OEAtomBase *, float* coords) const = 0
            bool GetCoords(const OEAtomBase *, double* coords) const = 0
            bool GetCoords(const OEAtomBase *, long double* coords) const = 0

      .. oe:language:: python

         .. oe:api:: python

            GetCoords(arg2: OEAtomBase, arg3: OEHalfFloat) -> bool
            GetCoords(arg2: OEAtomBase, arg3: OEFloatArray) -> bool
            GetCoords(arg2: OEAtomBase, arg3: OEDoubleArray) -> bool
            GetCoords(arg2: OEAtomBase, OEDoubleArray: int) -> bool


      Fills the ``coords`` array with the coordinates of the
      :ref:`OEAtomBase <OEChem_OEAtomBase>` object.
      The ``coords`` array should be at least of length ``3``.
      Changes made to the ``coord`` array after this function call will
      have no effect on the conformer.

      .. seealso::

         * :oe:meth:`OEChem::OEConfBase::SetCoords`
         * :oe:meth:`OEChem::OEConfBase::ClearCoords`

   .. oe:method:: GetIdx

      .. oe:language:: c++ java csharp

         .. oe:api::

            unsigned int GetIdx() const = 0

      .. oe:language:: python

         .. oe:api:: python

            GetIdx() -> int

      Returns the index of the conformer.
      This value is assigned by OEChem when a conformer is created.
      The conformer index is unique for the conformation of a given molecule,
      and is stable (not reused) for the lifetime of that :ref:`OEMCMolBase <OEChem_OEMCMolBase>`.
      These values may not be assigned sequentially, and may contain gaps.
      Conformer indices are guaranteed to be less than
      :oe:meth:`OEChem::OEMCMolBase::GetMaxConfIdx`.
      Conformer indices are typically only used for efficiently storing
      data in arrays externally to the :ref:`OEMCMolBase <OEChem_OEMCMolBase>`.
      The arrays can be conveniently indexed via :oe:meth:`OEChem::OEConfBase::GetIdx`.
      For iterating across the conformers of a molecule, use :oe:meth:`OEChem::OEMCMolBase::GetConfs`
      and for keeping track of a particular conformer use the conformer pointer :oe:cls:`OEChem::OEConfBase*<OEChem::OEConfBase>`.

   .. oe:method:: GetMCMol

      .. oe:language:: c++ java csharp

         .. oe:api::

            OEMCMolBase& GetMCMol() = 0
            const OEMCMolBase& GetMCMol() const = 0
      .. oe:language:: python

         .. oe:api:: python

            GetMCMol() -> OEMol


      Returns the associated multi-conformer molecule that is serving as
      the container for the :ref:`OEConfBase <OEChem_OEConfBase>`.

   .. oe:method:: GetTitle

      .. oe:language:: c++ java csharp

         .. oe:api::

            const char* GetTitle() const = 0

      .. oe:language:: python

         .. oe:api:: python

            GetTitle() -> str

      :ref:`OEConfBase <OEChem_OEConfBase>` objects can have their own title.
      However, if they do not, they will report the title of their parent
      :ref:`OEMCMolBase <OEChem_OEMCMolBase>` when the :oe:meth:`OEChem::OEConfBase::GetTitle`
      method is called.

      .. seealso::

         * :oe:meth:`OEChem::OEConfBase::HasTitle`

   .. oe:method:: GetTorsion

      .. oe:language:: c++ java csharp

         .. oe:api::

            double GetTorsion(OETorsion &) const = 0
            double GetTorsion(const OEAtomBase* a, const OEAtomBase* b,
                              const OEAtomBase* c, const OEAtomBase* d) const = 0

      .. oe:language:: python

         .. oe:api:: python

            GetTorsion(arg2: OETorsion) -> float
            GetTorsion(a: OEAtomBase, b: OEAtomBase, c: OEAtomBase,
                       d: OEAtomBase) -> float

      Returns the torsion value in the conformer.
      The torsion can be defined by either an :ref:`OETorsion <OEChem_OETorsion>` object,
      or by four :ref:`OEAtomBase <OEChem_OEAtomBase>` objects.

      .. seealso::

         * :oe:meth:`OEChem::OEConfBase::SetTorsion`

   .. oe:method:: GetTransform

      .. oe:language:: c++ java csharp

         .. oe:api::

            const OETrans& GetTransform() const = 0

      .. oe:language:: python

         .. oe:api:: python

            GetTransform() -> OETrans

      Returns an :ref:`OETrans <OEChem_OETrans>`, which is a container of all the
      transformations which have been applied to the :ref:`OEConfBase <OEChem_OEConfBase>`.
      This function is particularly useful when the internal representation
      of coordinates may not be Cartesian.

   .. oe:method:: HasTitle

      .. oe:language:: c++ java csharp

         .. oe:api::

            bool HasTitle() const = 0

      .. oe:language:: python

         .. oe:api:: python

            HasTitle() -> bool

      Returns whether this conformer has a title set. 

      .. seealso::

         * :oe:meth:`OEChem::OEConfBase::GetTitle`

   .. oe:method:: IsDeleted

      .. oe:language:: c++ java csharp

         .. oe:api::

            bool IsDeleted() const = 0

      .. oe:language:: python

         .. oe:api:: python

            IsDeleted() -> bool

      :oe:meth:`OEChem::OEConfBase::IsDeleted` is a helper function which
      assists other classes in maintaining functionality after
      an :ref:`OEConfBase <OEChem_OEConfBase>` has been deleted.

      .. seealso::

         * :oe:meth:`OEChem::OEMolBase::IsDeleted` methods inherited
           from the :ref:`OEMolBase <OEChem_OEMolBase>` class. That method has
           the purpose of identifying deleted atoms and bonds. 

   .. oe:method:: RemoveAtom
      :language: c++ java csharp

      .. oe:api::

         bool RemoveAtom(OEAtomBase *atom)=0

      :oe:meth:`OEChem::OEConfBase::RemoveAtom` is a helper function which
      the :ref:`OEMCMolBase <OEChem_OEMCMolBase>` can call as an adjunct to
      :oe:meth:`OEChem::OEMolBase::DeleteAtom` on the molecule
      which contains the conformers.

      .. warning::

         This should not be called by a primary user.

   .. oe:method:: RemoveBond
      :language: c++ java csharp

      .. oe:api::

         bool RemoveBond(OEBondBase *bond)=0

      :oe:meth:`OEChem::OEConfBase::RemoveBond` is a helper function which
      the :ref:`OEMCMolBase <OEChem_OEMCMolBase>` can call as an adjunct to
      :oe:meth:`OEChem::OEMolBase::DeleteBond` on the molecule
      which contains the conformers.

      .. warning::

         This should not be called by a primary user.

   .. oe:method:: SetCoords

      .. oe:language:: c++ java csharp

         .. oe:api::

            bool SetCoords(const OEPlatform::OEHalfFloat* coords)=0
            bool SetCoords(const float* coords)=0
            bool SetCoords(const double* coords)=0
            bool SetCoords(const long double* coords)=0

      .. oe:language:: python

         .. oe:api:: python

            SetCoords(arg2: OEHalfFloat) -> bool
            SetCoords(arg2: OEFloatArray) -> bool
            SetCoords(arg2: OEDoubleArray) -> bool
            SetCoords(OEDoubleArray: int) -> bool

      Sets the coordinates of a conformer.  The ``coords`` parameter
      is expected to be an array of size
      :oe:meth:`OEChem::OEConfBase::GetMaxAtomIdx<OEChem::OEMolBase::GetMaxAtomIdx>` *
      ``3``.  This array should contain ``3`` coordinates for each
      atom, and they should be located in the array passed in at
      ``coords[atom->GetIdx() * 3 + i]``, where i ranges from 0 to
      ``3``.  An internal copy of the coordinates is stored in the
      :ref:`OEConfBase <OEChem_OEConfBase>` that is independent of the
      ``coords`` array.

      .. oe:language:: c++ java csharp

         .. oe:api::

            bool SetCoords(const OEAtomBase *,
                           const OEPlatform::OEHalfFloat* coords)=0
            bool SetCoords(const OEAtomBase *, const float* coords)=0
            bool SetCoords(const OEAtomBase *, const double* coords)=0
            bool SetCoords(const OEAtomBase *, const long double* coords)=0

      .. oe:language:: python

         .. oe:api:: python

            SetCoords(arg2: OEAtomBase, arg3: OEHalfFloat) -> bool
            SetCoords(arg2: OEAtomBase, arg3: OEFloatArray) -> bool
            SetCoords(arg2: OEAtomBase, arg3: OEDoubleArray) -> bool
            SetCoords(arg2: OEAtomBase, OEDoubleArray: int) -> bool

      Sets to coordinates of a single atom in the :ref:`OEConfBase <OEChem_OEConfBase>`.
      The array passed in should be of length ``3`` and should contain the
      new coordinates of the atom.
      An internal copy of the coordinates is stored in the :ref:`OEConfBase <OEChem_OEConfBase>`
      which is independent of the ``coords`` array.

      .. seealso::

         * :oe:meth:`OEChem::OEConfBase::GetCoords`
         * :oe:meth:`OEChem::OEConfBase::ClearCoords`

   .. oe:method: SetIdx  IGNORED-METHOD

      .. oe:api::

         void SetIdx(unsigned int)=0

      It is not recommended that a user call the OEConfBase::SetIdx() function.
      This value is assigned by OEChem when a conformer is created.
      The conformer index is unique for the conformers of a
      given molecule, and is stable (not reused) for the lifetime of that
      OEMCMolBase.
      These values may not be assigned sequentially, and may contain gaps.
      Conformer indices are guaranteed to be less than OEMCMolBase::GetMaxConfIdx.
      Conformer indices are typically only used for efficiently storing
      data in arrays (or vectors) externally to the OEMCMolBase.
      They arrays can be conveniently indexed via OEConfBase::GetIdx().
      For iterating across the conformers of a molecule, use OEMCMolBase::GetConfs()
      and for keeping track of a particular conformer use an OEConfBase*.

   .. oe:method: SetMCMol IGNORED-METHOD

      .. oe:api::

         void SetMCMol(OEMCMolBase &)=0

      Sets the associated multi-conformer molecule which is serving as
      the container for the :ref:`OEConfBase <OEChem_OEConfBase>`.

      .. seealso::

         * :oe:meth:`OEChem::OEConfBase::GetMCMol`

   .. oe:method:: SetTorsion

      .. oe:language:: c++ java csharp

         .. oe:api::

            void SetTorsion(OETorsion &)=0
            void SetTorsion(OEAtomBase* a, OEAtomBase* b, OEAtomBase* c,
                            OEAtomBase* d, double radians)=0

      .. oe:language:: python

         .. oe:api:: python

            SetTorsion(arg2: OETorsion) -> None
            SetTorsion(a: OEAtomBase, b: OEAtomBase, c: OEAtomBase,
                       d: OEAtomBase, radians: float) -> None

      Sets torsion value in the conformer.
      The torsion can be defined by either an :ref:`OETorsion <OEChem_OETorsion>` object,
      or by four :ref:`OEAtomBase <OEChem_OEAtomBase>` objects

      .. seealso::

         * :oe:meth:`OEChem::OEConfBase::GetTorsion`

   .. oe:method:: Transform

      .. oe:language:: c++ java csharp

         .. oe:api::

            void Transform(const OETrans &)=0
            void Transform(const OETransBase *)=0

      .. oe:language:: python

         .. oe:api:: python

            Transform(arg2: OETrans) -> None
            Transform(arg2: OETransBase) -> None

      Applies the geometric transformation specified in the
      :ref:`OETransBase <OEChem_OETransBase>` object or the series of geometric
      transformations specified in the :ref:`OETrans <OEChem_OETrans>`
      container to the :ref:`OEConfBase <OEChem_OEConfBase>`.  These functions
      permanently change the coordinates of the
      :ref:`OEConfBase <OEChem_OEConfBase>`.
