Applications API
================

Application stability is assigned per concrete wrapper and, where explicitly
inventoried, per named profile factory. ``SphericalSLIC`` is Stable as
``panorai-spherical-slic/v1``. ``SphericalDoGFeatures.reviewed_profile()`` is
an immutable promotion candidate, but remains Experimental until its frozen
external, installed-wheel and independent-review gates pass. The generic DoG,
Stereo, Relative Pose, Dense Reconstruction, Mask R-CNN Workflow and Panorama
Stitcher wrappers remain Experimental.

.. panorai-api-components:: application

Use the :doc:`Applications catalog <catalog/applications>` to compare natural
inputs, outputs, execution domains and the Pipeline exposed by every wrapper.
This page documents exact classes and methods.

Stable application
------------------

.. autoclass:: panorai.applications.SphericalSLIC
   :members: run, get_params, with_params, describe, as_pipeline, to_config, save, load

Common Experimental contracts
-----------------------------

.. autoclass:: panorai.applications.Application
   :members: run, get_params, with_params, describe, to_config, save, load

.. autoclass:: panorai.applications.PipelineApplication
   :members: as_pipeline, pipeline

Experimental wrappers
---------------------

.. autoclass:: panorai.applications.SphericalDoGFeatures
   :members: reviewed_profile, run, get_params, with_params, describe, as_pipeline, to_config, save, load

.. autoclass:: panorai.applications.SphericalStereoDepth
   :members: run, describe, as_pipeline

.. autoclass:: panorai.applications.SphericalRelativePose
   :members: reference, from_profile, run, assess_capture, estimate_matches, estimate_correspondences, describe, as_pipeline

.. autoclass:: panorai.applications.SphericalDenseReconstruction
   :members: reviewed_profile, run, describe, as_pipeline, to_config, save, load

.. autoclass:: panorai.applications.RelativePoseProfile
   :members: evidence_backed_v1, resolved_frontend_config, to_dict

.. autoclass:: panorai.applications.RelativePoseCaptureMetadata
   :members: baseline_depth_ratio, to_dict

.. autoclass:: panorai.applications.RelativePoseCapturePolicy
   :members: scanner_assisted_reference, hilti_fisheye_development, assess, to_dict

.. autoclass:: panorai.applications.RelativePoseCaptureAssessment
   :members: eligible, to_dict

.. autoclass:: panorai.applications.RelativePoseCaptureInput

.. autoclass:: panorai.applications.RelativePoseCaptureError

.. autoclass:: panorai.applications.AssessRelativePoseCapture
   :members: execute

.. autoclass:: panorai.applications.SphericalMaskRCNNWorkflow
   :members: run, describe, as_pipeline

.. autoclass:: panorai.applications.PanoramaStitcher
   :members: run, get_params, with_params, describe, as_pipeline, to_config, save, load

``SphericalMaskRCNNPaper`` is the compatibility alias for the original
Experimental name. New code should use ``SphericalMaskRCNNWorkflow`` and
``mask_rcnn.workflow()``.

Start with :doc:`the Applications tutorial
<../guides/api-levels/applications>` and read :doc:`Application wrappers
<../concepts/application-wrappers>` for the contract rationale.