Subsystems and advanced surfaces

Not every public component is naturally an Application, Stage, operation or estimator. This page routes the remaining audited surfaces by computer-vision responsibility. Follow the linked reference for signatures, the linked guide for a workflow, and the complete public inventory for every exported symbol and exact stability contract.

Registered subsystem and compatibility surfaces

Surface	Stability	Canonical import	Contract	Public components or entries
public-catalog	Stable	panorai.catalog	panorai-catalog/v1	CatalogSurface, DocumentationContext, DocumentationLink, DocumentationSite, PublicCatalog, public_catalog
object-workflow	Stable	panorai	panorai-object-workflow/v1	EquirectangularImage, GnomonicFace, GnomonicFaceSet, SphericalTranspose
spatial-semantic-graph	Experimental	panorai.graph	panorai-spatial-semantic-graph/v1	GRAPH_INTERFACE, GRAPH_STABILITY, CallablePanorAiProvider, DepthProvider, DisabledProvider, EvidenceMode, EvidenceProvider, EvidenceSource, ExternalProvider, GraphArchiveError, GraphBuilderConfig, GraphEvent, GraphQueryFilters, GraphQueryResult, MultiViewPoseProvider, ObjectHypothesisNode, OracleProvider, PairFeatureEvidence, PairwiseLocalizationConfig, PairwiseLocalizationInput, PairwiseLocalizationResult, PoseProvider, PromotionPolicy, RegionAssociationConfig, RegionAssociationInput, RegionAssociationResult, RegionCorrespondenceCandidate, RegionCorrespondenceEdge, RelativePoseEdge, SemanticProvider, SemanticRegionNode, SpatialSemanticGraph, SpatialSemanticGraphBuilder, SpatialSemanticGraphQuery, SpatialSemanticPosterior, SphericalViewNode, TextImageEncoder, assign_region_correspondences, associate_regions, load_graph_archive, localize_region_pair, neighbors, propose_region_correspondences, query_embedding, query_spatial, query_text, replay_graph_archive, save_graph_archive, panorai.graph.association.RegionAssociationConfig, panorai.graph.association.RegionAssociationInput, panorai.graph.association.RegionAssociationResult, panorai.graph.association.assign_region_correspondences, panorai.graph.association.associate_regions, panorai.graph.association.propose_region_correspondences, panorai.graph.builder.GraphBuilderConfig, panorai.graph.builder.SpatialSemanticGraphBuilder, panorai.graph.localization.PairwiseLocalizationConfig, panorai.graph.localization.PairwiseLocalizationInput, panorai.graph.localization.PairwiseLocalizationResult, panorai.graph.localization.localize_region_pair, panorai.graph.observations.deterministic_id, panorai.graph.observations.feature_evidence_from_panorai, panorai.graph.observations.pose_edge_from_panorai, panorai.graph.observations.semantic_region_from_observation, panorai.graph.providers.CallablePanorAiProvider, panorai.graph.providers.DepthProvider, panorai.graph.providers.DisabledProvider, panorai.graph.providers.EvidenceProvider, panorai.graph.providers.ExternalProvider, panorai.graph.providers.MultiViewPoseProvider, panorai.graph.providers.OracleProvider, panorai.graph.providers.PoseProvider, panorai.graph.providers.SemanticProvider, panorai.graph.query.GraphQueryFilters, panorai.graph.query.GraphQueryResult, panorai.graph.query.SpatialSemanticGraphQuery, panorai.graph.query.TextImageEncoder, panorai.graph.query.neighbors, panorai.graph.query.query_embedding, panorai.graph.query.query_spatial, panorai.graph.query.query_text, panorai.graph.serialization.GraphArchiveError, panorai.graph.serialization.load_graph_archive, panorai.graph.serialization.replay_graph_archive, panorai.graph.serialization.save_graph_archive
spherical-ops-algorithms-gateway	Experimental	panorai.ops.spherical	panorai-spherical-algorithms/v1-experimental	algorithms
spherical-mask-rcnn-taxonomy	Experimental	panorai.experimental.deep_learning.mask_rcnn	panorai-spherical-mask-rcnn/v1-experimental	Backbone, BoxHead, MaskHead, MaskRCNNArchitecture, ProposalGenerator, RegionProposalNetwork, RoIAlign, RoIHeads, SphericalMaskRCNN, SphericalMaskRCNNPaper, SphericalMaskRCNNWorkflow, UnboundMaskRCNNError, paper, workflow
spherical-surface-open3d-adapter	Experimental	panorai.pcd	panorai-surface-open3d-adapter/v1-experimental	surface_mesh_to_open3d

Surface	Stability	Canonical import	Contract	Public components or entries
legacy-composition	Compatibility	panorai	panorai-3x-compatibility/v1	EquirectangularImage, GnomonicFace, GnomonicFaceSet, ConfigManager, PanoraiFactory, panorai.projections.GnomonicProjection, panorai.projections.ProjectionRegistry, panorai.projections.base.BaseProjectionStrategy, panorai.projections.base.BaseGridGeneration, panorai.projections.base.BaseInterpolation, panorai.projections.base.BaseCoordinateTransformer, panorai.projections.base.ProjectionError, panorai.projections.base.ConfigurationError, panorai.projections.base.RegistrationError, panorai.projections.base.ProcessingError, panorai.projections.base.GridGenerationError, panorai.projections.base.TransformationError, panorai.projections.base.InterpolationError, panorai.samplers.SamplerRegistry, panorai.samplers.Sampler, panorai.samplers.CubeSampler, panorai.samplers.IcosahedronSampler, panorai.samplers.FibonacciSampler, panorai.samplers.BlueNoiseSampler, panorai.samplers.SpiralSampler, panorai.utils.ResizerConfig, panorai.utils.ImageResizer, panorai.utils.PreprocessEquirectangularImage, panorai.utils.setup_logging
root-convenience-exports	Compatibility	panorai.features	panorai-root-convenience/v1	SphericalFeaturePipeline, __version__
core-geometry-preview	Compatibility	panorai.core.geometry	geometry-v1	CUBE_FACE_BASES, CUBE_FACE_ORDER, ArrayLike, CubemapProjector, CubemapSpec, ERPPointProjection, GnomonicFaceGeometry, GnomonicPointProjection, GnomonicProjector, GnomonicRayProjection, GnomonicSpec, Interpolation, InvalidPolicy, NumpyArray, ProjectionResult, ShapeHW, TensorLike, camera_rays_to_world_points, cubemap_to_equirectangular, equirectangular_to_cubemap, equirectangular_to_gnomonic, erp_pixels_to_rays, gnomonic_face_geometry, gnomonic_intrinsics, gnomonic_pixel_map, gnomonic_pixels_to_rays, gnomonic_rotation, gnomonic_to_equirectangular, rays_to_gnomonic_pixels, rays_to_erp_pixels, relative_camera_pose, tangent_offsets_to_rays, world_points_to_camera_rays
spherical-instance-pipeline-root-convenience	Experimental	panorai.pipeline	panorai-spherical-instance-pipeline/v1-experimental	CAMGuidedSphericalInstances, CAMRegionProposals, SAMMaskRefinement, SphericalCAM, SphericalInstanceFusion

Foundations and processing

Foundational subsystems

Canonical namespace	Stability	Responsibility	Continue with
panorai.data	Stable	ERP/view containers, raster fields and point/region/view observations.	Spherical observations
panorai.blenders	Stable core; Experimental research variants	Mask-authoritative fusion for reconstructed ERP fields and diagnostics.	Samplers and blenders
panorai.image_processing	Stable SLIC; other legacy functions Experimental	Historical function API reused by configured spherical Ops.	Core operations
panorai.core.torch	Stable	Lower-level Torch implementations used by panorai.ops.spherical.nn.	Spherical Ops
panorai.core / panorai.core.numpy	Experimental	Low-level execution specs and NumPy module grammar.	API stability
panorai.workflow	Experimental	Model-oriented typed input/output trees and backend adapters.	Data modalities

Features and visual evidence

Feature subsystems

Canonical namespace	Stability	Responsibility	Continue with
panorai.features core	Stable	Projected-view OpenCV extraction/matching with spherical geometry, deduplication and provenance.	Features API
panorai.features DoG/tangent extensions	Experimental	Direct spherical DoG, scale selection, tangent patches and descriptors.	Features and matching guide
panorai.experimental.deep_learning	Experimental	External model acquisition, spherical model ports, CAM and metric-depth adapters.	Deep model workflows
panorai.experimental.deep_learning.segmentation	Experimental	Semantic evidence, spherical prompts, SAM proposals and panoptic resolution.	Semantic regions guide

Pose, depth and mapping

Geometric inference subsystems

Canonical namespace	Stability	Responsibility	Continue with
panorai.estimators	Experimental	Spherical Essential/R/t estimation, robust sampling, diagnostics and policies.	Estimator catalog
panorai.stereo	Experimental	Direct-spherical dense plane sweep and radial-range result.	Stereo API
panorai.reconstruction	Experimental	Sparse global mapping plus registered MVS, TSDF and surface contracts.	Reconstruction API
panorai.pcd.surface_mesh_to_open3d	Experimental; optional Open3D	Lazy adapter from the canonical SurfaceMesh without redefining frames or validity.	Dense surface tutorial
panorai.slam	Experimental	Incremental and visual spherical SLAM, fisheye rays and local BA reports.	SLAM API

Semantic and spatial reasoning

Semantic/spatial subsystems

Canonical namespace	Stability	Responsibility	Continue with
panorai.pipeline semantic-instance stages	Experimental	CAM proposals, SAM refinement and spherical instance fusion.	Stages catalog
panorai.experimental.deep_learning.mask_rcnn	Experimental	Mask R-CNN taxonomy, executable workflow factory and unbound trainable topology.	Applications catalog
panorai.object_localization	Experimental	Spherical regions, cross-view transfer, associations and object hypotheses.	Object localization API
panorai.graph	Experimental	Spatial-semantic evidence graph, providers, association, localization and queries.	Graph API

Compatibility namespaces

panorai, panorai.core.geometry and selected root feature exports retain 3.x Compatibility paths. New code should use the canonical imports named in the role catalogs and public inventory. Compatibility preserves migration; it does not define a second geometry or a second implementation.