.. include:: ../../common/cookbook/cookbook-hyperlinks

.. include:: ../substitutions

.. oe:namespace:: OEGrapheme

.. meta::
   :keywords: OEDrawROCSScores

.. oe:function:: OEDrawROCSScores

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

      .. oe:api::

         void OEDrawROCSScores(OEDepict::OEImageBase& image,
                               const std::vector<double>& scores)

   .. oe:language:: python

      .. oe:api:: python

         OEDrawROCSScores(image: OEImageBase, scores: OEDoubleVector) -> None

   Renders the scores into a radial graph.

   *image*
     The image on which the radial graph of the scores is drawn.

   *scores*
     The vector of scores. The scores will expected in the following order
     - shape overlap score
     - color overlap score
     - 2D similarity score (optional)

   .. note::

      All scores are expected to be in the range of :math:`[0.0, 1.0]`.
      This :math:`[0.0, 1.0]` range is transformed to :math:`[0.0^{\circ} - 360.0^{\circ}]`
      angles when representing the scores in the diagram.

   .. oe:source:: DrawROCSScores.py
      :language: python
      :noindent:
      :frag:     SNIPPET-DRAW-ROCS-SCORES

   .. oe:source:: DrawROCSScores.cpp
      :language: c++
      :noindent:
      :frag:     SNIPPET-DRAW-ROCS-SCORES

   .. oe:source:: DrawROCSScores.java
      :language: java
      :noindent:
      :frag:     SNIPPET-DRAW-ROCS-SCORES

   .. oe:source:: DrawROCSScores.cs
      :language: csharp
      :noindent:
      :frag:     SNIPPET-DRAW-ROCS-SCORES

   .. _figure_draw_rocs_scores:

   .. figure:: ../images/DrawROCSScores.*
      :align:  center

      **Example of using the OEDrawROCSScores function**

   .. admonition:: Code Example

      * :ref:`section_examples_summary_shapeoverlap2pdf` example
      * `Visualizing Shape and Color Overlap`_ **OpenEye Python Cookbook** recipe

