.. include:: ../../toolkit-substitutions

.. oe:namespace:: OEChem

.. oe:function:: OELoadOpenEyeMonomerSet

   .. attention::

      |PRELIMINARY-API|

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

      .. oe:api::

         bool OELoadOpenEyeMonomerSet(OEMonomerSet& monomers)

   .. oe:language:: python

      .. oe:api:: python

         OELoadOpenEyeMonomerSet(monomers: OEMonomerSet) -> bool

   Loads the built-in ``OpenEye`` monomer set containing more than 260 diverse monomers
   that are common in macro-cyclic peptide projects. This monomer set defines four code-sets:

   * ``OpenEye`` - the primary code-set, the codes assigned to monomers follow naming conventions defined in [Ghiandoni-2026]_
   * ``Standard`` - 20 standard amino-acids with universally accepted one-letter codes, such as ``C`` for cystine
   * ``PDB`` - monomer that also exists in PDB database with a three-letter code, such as ``CYS`` for cystine
   * ``ChEMBL`` - monomer that also exists in the monomer dictionary of  
     `CHEMBL36 <https://chembl.gitbook.io/chembl-interface-documentation/downloads>`_.


   .. figure:: ../images/dNMePhe.*
      :width: 500
      :align:  center

      **Example of monomer that occurs in different code-sets in the OpenEye monomer set**

   .. warning::

      The built-in ``OpenEye`` monomer set is intended primarily for testing, illustrating how OEChem handles
      diverse peptide structures during :term:`HELM` parsing and generation, and providing a template for constructing
      private monomer sets.

      Because this monomer set is **subject to change**, we strongly discourage our customers from relying on it in 
      their production workflows.
      Monomers in this set may be added, removed, or modified  between releases.
      Instead, users should define, validate, and maintain their own custom monomer set so they
      can control which monomers are included and adopt naming conventions that match their organizational 
      standards.

   .. seealso::

      * :oe:cls:`OEChem::OEMonomerSet` class
      * :oe:func:`OEChem::OEReadMonomerSet` function
      * :oe:func:`OEChem::OELoadStandardMonomerSet` function
   
   .. only:: oehtml

      .. admonition:: Download JSON file of built-in OpenEye monomer set

         :download:`monomers-openeye.json <../../../../../sublibs/tklibs/oechem/peptide/data/monomers-openeye.json>`
