Internals

Documented internals: the module docstring, the defaults mechanism and the contract generics. They are not part of the supported API.

LocalOptimizationDoneRight.LocalOptimizationDoneRight — Module
LocalOptimizationDoneRight

The local optimizers of the ACCV 2026 paper "Robust Local Optimization Done Right", on VisualGeometryToolkitCore's local-optimization contract and VisualGeometryToolkitEstimation's problems:

  • the joint-(θ,z) half-quadratic loss lifts (HQ and its research variants WelschHQNewton, WelschHQEcm, BarronHQ, GmHqEps) and graduated non-convexity (Gnc), one code path over VisualGeometryToolkitCore's chart-rows contract (the lift core and its continuation schedules live here);
  • the Student-t + uniform IRLS (StudentTUniform), its score-matched block-coordinate ascent (StuTuBCD), the mixture lifts (StuTuHQTabulated, StuTuRegemm) and the Barron-adaptive IRLS (BarronAdaptive);
  • PoseLib's truncated refiners (PoseLibLm, PoseLibLZ, PoseLibLmAdaptLossWidth) as external refiners (their solver calls load with PoseLib, a package extension);
  • the cross-validated operating points (tuning_constant) and the strategies' TOML registry (LODR_STRATEGY_TAGS), merged with the core's to load: optimization_strategy_from_toml(d; class, tags = merge(VisualGeometryToolkitEstimation.OPTIMIZATION_STRATEGY_TAGS, LODR_STRATEGY_TAGS)).

Compose one with any scorer: find_essential(cam1, cam2, pairs; local_optimization_strategy = HQ{WelschShape}(efficiency_constant = WELSCH_HQ_EFFICIENCY_CONSTANT_ESSENTIAL)).

source
LocalOptimizationDoneRight._config_default — Function
_config_default(table, key)

The default key of [table] (a dotted path, "optimization_strategy.poselib_adapt") in configs/default.toml. Throws a KeyError naming a missing table or key.

source
LocalOptimizationDoneRight.CONTRACT_GENERICS — Constant
CONTRACT_GENERICS

The generic functions of LocalOptimizationDoneRight another module may add methods to (VisualGeometryToolkitCore's contract_generic_violations): the PoseLib truncated refiners' pose body, implemented by the PoseLib extension.

source