solprop.translate#

The translation layer: physics objects turned into the kernel problem a backend runs.

assemble() is the entry point. It builds the cumulative linear operator, the masks, the modal or spatial transform and the compiled responses, and returns a Translation (problem, request): the validated PropagationProblem that crosses into a backend (docs/dev/kernel-contract.md) and the RunRequest of a fresh run of it. The modules, by role:

  • Contract and assembly: problem, routes, run_request, assembly, validation, walls (a capillary’s coupled flows), admission and stage (the per-stage terms and scalars a backend evaluates).

  • Representations along z: chebyshev, expansion and linop.

  • Grids and boundaries: masks, transverse and collar_check.

  • Transforms and the plane measure: modal, radial, free, planar, spatial, flux and coupling (a coupling port’s entrance).

  • The general modal route: general, coupled, modal_tables and modal_path.

  • Responses: responses, raman, ionisation, plasma_integration, plasma_source, envelope_plasma, tdse and tdse_source.

Modules

admission

What the general modal route and the coupled flow execute, checked once.

assembly

Assembly: the physics objects of a run turned into a validated kernel problem.

chebyshev

Adaptive piecewise Chebyshev representation of functions of z.

collar_check

The design check of a requested collar: what it sends back (SEP 40, 4.4).

coupled

The metric and the coupled-flow representation of a general modal guide.

coupling

Sample a translated problem's entrance into a coupling port (SEP 31).

envelope_plasma

Compile validated cycle integrals and the envelope plasma spectral assembly.

expansion

A z-dependent quantity as a Chebyshev expansion in the scalar paths it depends on.

flux

Build the axial-admittance plan of one spatial plane (SEP 34).

free

Translate constant Cartesian free-space propagation into the separable spatial seam.

general

The general modal route: the seam leaves of one guide, and their certificates.

ionisation

Ionisation rates as converged, clipped, log-spaced spline tables.

linop

The cumulative linear operator in a form a kernel can evaluate.

masks

Grid data, masks, absorber rates and the noise field, in the kernel's layout.

modal

The transform between modal amplitudes and the field at quadrature nodes.

modal_path

Expand what a run reads of a moving guide's sampled path, along z.

modal_tables

Flatten a general guide's sampled tables into the record a run's seam carries.

planar

Translate the hybrid planar grid into the separable "slab" spatial seam.

plasma_integration

The plasma column's running-integral rule, designed once per grid (SEP 18).

plasma_source

Certify and identify the held field-plasma source (SEP 27).

problem

The kernel contract: the one object that crosses into a backend.

radial

Translate radial (Hankel) free-space propagation into the spatial seam.

raman

Sampling the Raman response kernel onto the doubled grid a backend convolves on.

responses

Response definitions compiled into one fused time-domain pass.

routes

The closed union of route descriptions a propagation problem carries (SEP 47 6.2).

run_request

The immutable run request a backend prepares beside its problem (SEP 47 section 6.3).

spatial

Freeze spatial geometry and separable coefficients for the kernel contract.

stage

The seam's per-stage evaluation form: fixed terms, host scalars and their sum.

tdse

Define the provider-free host contract for the helium TDSE response.

tdse_source

Admit the scalar helium TDSE route and translate its macroscopic source.

transverse

Resolve a free-space run's transverse boundary at translation (SEP 40 section 5.2).

validation

What translation refuses, and what it warns about, before a problem is returned.

walls

The coupled flows of a capillary's mode set: the coherent wall and the taper.