AlgorithmProfile
================

Data structures for algorithm performance profiles.

Contains AlgorithmProfile and related classes for characterizing
algorithm strengths, weaknesses, and optimal parameters.

See ADR-011 for architecture decisions.

Classes
-------

.. py:class:: PerformanceMetrics

   Performance metrics for an algorithm.

   **Methods:**

   .. py:method:: to_dict()

      Convert to dictionary.


.. py:class:: OptimalPreset

   Optimal parameter preset for an algorithm.

   **Methods:**

   .. py:method:: to_dict()

      Convert to dictionary.


.. py:class:: ExampleScreenshot

   Reference to an example screenshot.

   **Methods:**

   .. py:method:: to_dict()

      Convert to dictionary.


.. py:class:: AlgorithmProfile

   Complete profile for a segmentation algorithm.
   
   Contains performance metrics, optimal parameters, strengths,
   weaknesses, and use case recommendations.
   
   Example:
       profile = AlgorithmProfile(
           algorithm="watershed",
           display_name="Watershed",
           performance=PerformanceMetrics(best_dice=1.0, mean_dice=0.95),
           optimal_preset=OptimalPreset(params={"edge_sensitivity": 40}),
           strengths=["Perfect Dice achievable", "Good boundary adherence"],
           weaknesses=["Medium speed"],
           best_for=["General-purpose segmentation"],
           avoid_for=["Speed-critical applications"],
       )

   **Methods:**

   .. py:method:: to_dict()

      Convert to dictionary for JSON serialization.

   .. py:method:: from_dict()

      Create profile from dictionary.

   .. py:method:: get_summary()

      Get one-line summary of algorithm.


.. py:class:: AlgorithmComparison

   Comparison of multiple algorithms.

   **Methods:**

   .. py:method:: to_dict()

      Convert to dictionary.

   .. py:method:: from_dict()

      Create comparison from dictionary.

   .. py:method:: get_best_for_dice()

      Get algorithm with best mean Dice.

   .. py:method:: get_fastest()

      Get fastest algorithm.

   .. py:method:: get_most_efficient()

      Get most click-efficient algorithm.


Functions
---------

.. py:function:: to_dict()

   Convert to dictionary.

.. py:function:: to_dict()

   Convert to dictionary.

.. py:function:: to_dict()

   Convert to dictionary.

.. py:function:: to_dict()

   Convert to dictionary for JSON serialization.

.. py:function:: from_dict()

   Create profile from dictionary.

.. py:function:: get_summary()

   Get one-line summary of algorithm.

.. py:function:: to_dict()

   Convert to dictionary.

.. py:function:: from_dict()

   Create comparison from dictionary.

.. py:function:: get_best_for_dice()

   Get algorithm with best mean Dice.

.. py:function:: get_fastest()

   Get fastest algorithm.

.. py:function:: get_most_efficient()

   Get most click-efficient algorithm.

.. py:function:: get_display_name()

   Get human-readable name for algorithm.
   
   Args:
       algorithm: Internal algorithm name.
   
   Returns:
       Display name.