WizardDataStructures
====================

Data structures for the Parameter Wizard.

This module contains dataclasses used to collect and represent
samples, analysis results, and recommendations during the
Quick Select Parameters wizard workflow.

Classes
-------

.. py:class:: WizardSamples

   Collected samples from wizard interaction.
   
   Stores foreground, background, and boundary samples collected
   during the wizard's interactive sampling phases.

   **Methods:**

   .. py:method:: has_foreground()

      Check if foreground samples have been collected.

   .. py:method:: has_background()

      Check if background samples have been collected.

   .. py:method:: has_boundary()

      Check if boundary samples have been collected.

   .. py:method:: foreground_count()

      Return the number of foreground samples.

   .. py:method:: background_count()

      Return the number of background samples.

   .. py:method:: clear_foreground()

      Clear all foreground samples.

   .. py:method:: clear_background()

      Clear all background samples.

   .. py:method:: clear_boundary()

      Clear all boundary samples.

   .. py:method:: clear_all()

      Clear all samples.


.. py:class:: IntensityAnalysisResult

   Results from intensity distribution analysis.
   
   Contains statistics about foreground and background intensity
   distributions and measures of their separation.

   **Methods:**

   .. py:method:: threshold_range()

      Return the threshold range width.

   .. py:method:: is_well_separated()

      Check if foreground and background are well-separated.


.. py:class:: ShapeAnalysisResult

   Results from shape and boundary analysis.
   
   Contains metrics about the structure's size, shape, and
   boundary characteristics.

   **Methods:**

   .. py:method:: is_small_structure()

      Check if structure is small.

   .. py:method:: is_large_structure()

      Check if structure is large.

   .. py:method:: has_smooth_boundary()

      Check if structure has a smooth boundary.


.. py:class:: WizardRecommendation

   Final wizard recommendation with explanations.
   
   Contains the recommended algorithm and parameters along with
   reasoning for each choice.

   **Methods:**

   .. py:method:: is_high_confidence()

      Check if recommendation has high confidence.

   .. py:method:: has_warnings()

      Check if recommendation has any warnings.

   .. py:method:: has_threshold_suggestion()

      Check if threshold values are suggested.


Functions
---------

.. py:function:: has_foreground()

   Check if foreground samples have been collected.

.. py:function:: has_background()

   Check if background samples have been collected.

.. py:function:: has_boundary()

   Check if boundary samples have been collected.

.. py:function:: foreground_count()

   Return the number of foreground samples.

.. py:function:: background_count()

   Return the number of background samples.

.. py:function:: clear_foreground()

   Clear all foreground samples.

.. py:function:: clear_background()

   Clear all background samples.

.. py:function:: clear_boundary()

   Clear all boundary samples.

.. py:function:: clear_all()

   Clear all samples.

.. py:function:: threshold_range()

   Return the threshold range width.

.. py:function:: is_well_separated()

   Check if foreground and background are well-separated.
   
   Args:
       threshold: Separation score threshold for "well-separated" (default 0.7).
   
   Returns:
       True if separation_score >= threshold.

.. py:function:: is_small_structure()

   Check if structure is small.
   
   Args:
       threshold_mm: Diameter threshold in mm (default 10.0).
   
   Returns:
       True if diameter < threshold.

.. py:function:: is_large_structure()

   Check if structure is large.
   
   Args:
       threshold_mm: Diameter threshold in mm (default 50.0).
   
   Returns:
       True if diameter > threshold.

.. py:function:: has_smooth_boundary()

   Check if structure has a smooth boundary.
   
   Args:
       threshold: Roughness threshold (default 0.3).
   
   Returns:
       True if boundary_roughness <= threshold.

.. py:function:: is_high_confidence()

   Check if recommendation has high confidence.
   
   Args:
       threshold: Confidence threshold (default 0.75).
   
   Returns:
       True if confidence >= threshold.

.. py:function:: has_warnings()

   Check if recommendation has any warnings.

.. py:function:: has_threshold_suggestion()

   Check if threshold values are suggested.