.. include:: ../substitutions

.. oe:namespace:: OEGraphSim

.. meta::
   :keywords: OEMakePathFP

.. oe:function:: OEMakePathFP

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

      .. oe:api::

         bool OEMakePathFP(OEFingerPrint& fp, const OEChem::OEMolBase& mol)

   .. oe:language:: python

      .. oe:api:: python

         OEMakePathFP(fp: OEFingerPrint, mol: Union[OEGraphMol,OEMol,OEQMol]) -> bool

   Generates the :ref:`OEFingerPrint <OEGraphSim_OEFingerPrint>` object as a
   :ref:`section_fingerprint_path` fingerprint using default
   parameters.

   *fp*
      |makefp|

   *mol*
      |makefpmol|

   The following code snippet shows how to print out the string representation of
   a :oe:const:`OEGraphSim::OEFPType::Path` fingerprint.
   This string encodes information about default parameters used to generate
   a :oe:const:`OEGraphSim::OEFPType::Path` fingerprint.

   .. oe:source:: PathFPDefaultParams.cpp
      :language: c++
      :noindent:
      :frag:     SNIPPET-PATH-DEFAULT-PARAMS

   .. oe:source:: PathFPDefaultParams.py
      :language: python
      :noindent:
      :frag:     SNIPPET-PATH-DEFAULT-PARAMS

   ..  oe:language:: python

        :ref:`Full listing. <listing-PathFPDefaultParams.py>`


   .. oe:source:: PathFPDefaultParams.java
      :language: java
      :noindent:
      :frag:     SNIPPET-PATH-DEFAULT-PARAMS

   .. oe:source:: PathFPDefaultParams.cs
      :language: csharp
      :noindent:
      :frag:     SNIPPET-PATH-DEFAULT-PARAMS

   The output of the above code snippet is:

   .. code-block:: console

      Path,ver=2.0.0,size=4096,bonds=0-5,atype=AtmNum|Arom|Chiral|FCharge|HvyDeg|Hyb|EqHalo,btype=Order|Chiral

   .. seealso::

      * :oe:meth:`OEGraphSim::OEFPTypeBase::GetFPTypeString` method


   .. ############################################################################

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

      .. oe:api::

         bool OEMakePathFP(OEFingerPrint& fp, const OEChem::OEMolBase& mol,
                           unsigned int numbits, unsigned int minbonds,
                           unsigned int maxbonds, unsigned int atype,
                           unsigned int btype)

   .. oe:language:: python

      .. oe:api:: python

         OEMakePathFP(fp: OEFingerPrint, mol: Union[OEGraphMol,OEMol,OEQMol],
                      numbits: int, minbonds: int, maxbonds: int, atype: int,
                      btype: int) -> bool

   Generates the :ref:`OEFingerPrint <OEGraphSim_OEFingerPrint>` object as a
   :ref:`section_fingerprint_path` fingerprint using the given
   parameters.

   *fp*
      |makefp|

   *mol*
      |makefpmol|

   *numbits*
      |makefpnumbits|

   *minbonds*, *maxbonds*
      The smallest and largest paths (in bonds) that are enumerated
      during the fingerprint generation.
      All enumerated paths are hashed into the
      :ref:`OEFingerPrint <OEGraphSim_OEFingerPrint>` object.

   *atype*
      |makefpatomtype|

   *btype*
      |makefpbondtype|

   .. note::

      For an empty molecule, both :oe:func:`OEGraphSim::OEMakePathFP`
      function will return ``false`` and the type of the fingerprint
      will be set to ``0``
      (:oe:meth:`OEGraphSim::OEFingerPrint::GetFPTypeBase`).

   .. seealso::

      * :ref:`chapter_user_defined` chapter
      * :oe:constns:`OEGraphSim::OEFPAtomType` namespace
      * :oe:constns:`OEGraphSim::OEFPBondType` namespace


