ParameterWizard
===============

Parameter Wizard - Main coordinator for the Quick Select Parameters Wizard.

This module coordinates the wizard workflow, connecting UI, sampling,
analysis, and recommendation components.

Classes
-------

.. py:class:: ParameterWizard

   Coordinates the Quick Select Parameters wizard workflow.
   
   This class manages the interaction between:
   - The embedded wizard UI (EmbeddedWizardPanel)
   - Interactive sampling (WizardSampler)
   - Analysis (WizardAnalyzer)
   - Recommendations (ParameterRecommender)

   **Methods:**

   .. py:method:: __init__()

      Initialize the wizard.

   .. py:method:: start()

      Launch the wizard by embedding it in the options frame.

   .. py:method:: handle_interaction_event()

      Handle mouse interaction events forwarded from the main effect.

   .. py:method:: on_foreground_sampled()

      Called when foreground sampling completes a stroke.

   .. py:method:: on_background_sampled()

      Called when background sampling completes a stroke.

   .. py:method:: on_boundary_traced()

      Called when boundary tracing completes a stroke.

   .. py:method:: generate_recommendation()

      Generate final recommendation from all inputs.

   .. py:method:: apply_recommendation()

      Apply recommended parameters to the effect.

   .. py:method:: clear_samples()

      Clear all collected samples.


Functions
---------

.. py:function:: start()

   Launch the wizard by embedding it in the options frame.

.. py:function:: handle_interaction_event()

   Handle mouse interaction events forwarded from the main effect.
   
   Args:
       callerInteractor: VTK interactor that triggered the event.
       eventId: VTK event ID.
       viewWidget: The view widget where the event occurred.
   
   Returns:
       True if the event was handled (consumed), False otherwise.

.. py:function:: on_foreground_sampled()

   Called when foreground sampling completes a stroke.
   
   Args:
       points: List of (i, j, k) coordinates.
       intensities: Array of intensity values.

.. py:function:: on_background_sampled()

   Called when background sampling completes a stroke.
   
   Args:
       points: List of (i, j, k) coordinates.
       intensities: Array of intensity values.

.. py:function:: on_boundary_traced()

   Called when boundary tracing completes a stroke.
   
   Args:
       points: List of (i, j, k) coordinates along boundary.

.. py:function:: generate_recommendation()

   Generate final recommendation from all inputs.
   
   Returns:
       WizardRecommendation with algorithm and parameter suggestions.

.. py:function:: apply_recommendation()

   Apply recommended parameters to the effect.
   
   Args:
       recommendation: The recommendation to apply.

.. py:function:: clear_samples()

   Clear all collected samples.