utv_sampling
============


.. py:module:: t3toolbox.backend.utv_sampling

.. autoapi-nested-parse::

   Uniform tangent sampling (UT3Tangent probe / apply / entries), uniform-fix 3b-6b.

   The uniform mirror of the ragged ``T3Tangent`` sampling frontend, sharing the polymorphic
   ``{probing.tv_probe, apply.tv_apply, entries.tv_entries}``. The boundary work is the same as the plain layer's
   ``ut3_sampling`` (the precedent), lifted to the frame-variations pair:

   1. **mask-once** the frame (4) and variation (2) supercores -- so the padded rank slots are zero and the
      core algorithm runs mask-free (the padded bonds contract to zero);
   2. **pack** the probe vectors into one supercore-shaped tensor (``apply``/``probe``; ``entries`` slices
      fibers, so its integer ``index`` needs no packing);
   3. call the polymorphic backend (``is_uniform`` is inferred from the masked supercores being bare ndarrays);
   4. **unpack** the ``probe`` output back to ragged-width vectors (``apply``/``entries`` return a scalar --
      nothing to unpack).

   These are the bare Jacobian ``𝒥`` (no gauge projector ``Π``); the transpose ``𝒥ᵀ`` lands in 3b-6c.



Functions
---------

.. toctree::
   :hidden:

   /autoapi/t3toolbox/backend/utv_sampling/utv_probe
   /autoapi/t3toolbox/backend/utv_sampling/utv_apply
   /autoapi/t3toolbox/backend/utv_sampling/utv_entries
   /autoapi/t3toolbox/backend/utv_sampling/utv_precompute_apply_frame_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_precompute_probe_frame_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_precompute_entries_frame_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_apply_jacobian_from_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_probe_jacobian_from_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_entries_jacobian_from_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_apply_transpose_from_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_probe_transpose_from_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_entries_transpose_from_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_precompute_apply_frame_sweep_jets
   /autoapi/t3toolbox/backend/utv_sampling/utv_precompute_probe_frame_sweep_jets
   /autoapi/t3toolbox/backend/utv_sampling/utv_precompute_entries_frame_sweep_jets
   /autoapi/t3toolbox/backend/utv_sampling/utv_apply_jacobian_derivatives_from_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_probe_jacobian_derivatives_from_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_entries_jacobian_derivatives_from_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_apply_transpose_derivatives_from_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_probe_transpose_derivatives_from_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_entries_transpose_derivatives_from_sweep
   /autoapi/t3toolbox/backend/utv_sampling/utv_probe_derivatives
   /autoapi/t3toolbox/backend/utv_sampling/utv_apply_derivatives
   /autoapi/t3toolbox/backend/utv_sampling/utv_entries_derivatives
   /autoapi/t3toolbox/backend/utv_sampling/utv_probe_transpose
   /autoapi/t3toolbox/backend/utv_sampling/utv_apply_transpose
   /autoapi/t3toolbox/backend/utv_sampling/utv_entries_transpose
   /autoapi/t3toolbox/backend/utv_sampling/utv_probe_derivatives_transpose
   /autoapi/t3toolbox/backend/utv_sampling/utv_apply_derivatives_transpose
   /autoapi/t3toolbox/backend/utv_sampling/utv_entries_derivatives_transpose

.. autoapisummary::

   t3toolbox.backend.utv_sampling.utv_probe
   t3toolbox.backend.utv_sampling.utv_apply
   t3toolbox.backend.utv_sampling.utv_entries
   t3toolbox.backend.utv_sampling.utv_precompute_apply_frame_sweep
   t3toolbox.backend.utv_sampling.utv_precompute_probe_frame_sweep
   t3toolbox.backend.utv_sampling.utv_precompute_entries_frame_sweep
   t3toolbox.backend.utv_sampling.utv_apply_jacobian_from_sweep
   t3toolbox.backend.utv_sampling.utv_probe_jacobian_from_sweep
   t3toolbox.backend.utv_sampling.utv_entries_jacobian_from_sweep
   t3toolbox.backend.utv_sampling.utv_apply_transpose_from_sweep
   t3toolbox.backend.utv_sampling.utv_probe_transpose_from_sweep
   t3toolbox.backend.utv_sampling.utv_entries_transpose_from_sweep
   t3toolbox.backend.utv_sampling.utv_precompute_apply_frame_sweep_jets
   t3toolbox.backend.utv_sampling.utv_precompute_probe_frame_sweep_jets
   t3toolbox.backend.utv_sampling.utv_precompute_entries_frame_sweep_jets
   t3toolbox.backend.utv_sampling.utv_apply_jacobian_derivatives_from_sweep
   t3toolbox.backend.utv_sampling.utv_probe_jacobian_derivatives_from_sweep
   t3toolbox.backend.utv_sampling.utv_entries_jacobian_derivatives_from_sweep
   t3toolbox.backend.utv_sampling.utv_apply_transpose_derivatives_from_sweep
   t3toolbox.backend.utv_sampling.utv_probe_transpose_derivatives_from_sweep
   t3toolbox.backend.utv_sampling.utv_entries_transpose_derivatives_from_sweep
   t3toolbox.backend.utv_sampling.utv_probe_derivatives
   t3toolbox.backend.utv_sampling.utv_apply_derivatives
   t3toolbox.backend.utv_sampling.utv_entries_derivatives
   t3toolbox.backend.utv_sampling.utv_probe_transpose
   t3toolbox.backend.utv_sampling.utv_apply_transpose
   t3toolbox.backend.utv_sampling.utv_entries_transpose
   t3toolbox.backend.utv_sampling.utv_probe_derivatives_transpose
   t3toolbox.backend.utv_sampling.utv_apply_derivatives_transpose
   t3toolbox.backend.utv_sampling.utv_entries_derivatives_transpose