From 43723ab4f58f7720f7c8bbc463560b9f023bb953 Mon Sep 17 00:00:00 2001 From: John Travers Date: Sun, 15 Nov 2026 22:44:29 +0000 Subject: [PATCH 01/20] docs: start implementing SEP 51 [skip ci] Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- docs/dev/seps/index.md | 2 +- docs/dev/seps/sep-0051-save-planes.md | 5 +++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/dev/seps/index.md b/docs/dev/seps/index.md index f025ed224..5bfad9af9 100644 --- a/docs/dev/seps/index.md +++ b/docs/dev/seps/index.md @@ -33,7 +33,7 @@ Proposals that are active, in draft, accepted, in progress or deferred. | [11](sep-0011-finite-density-gas-index.md) | Finite-density gas index and mixture optics | Draft | Change | | [17](sep-0017-gas-two-photon-ionisation.md) | Broadband two-photon continuum response beside strong-field ionisation | Accepted | Feature | | [32](sep-0032-raman-maxwell-bloch.md) | Raman Maxwell–Bloch dynamics | Draft | Feature | -| [51](sep-0051-save-planes.md) | One rule for the saved planes and the end of a run | Accepted | Change | +| [51](sep-0051-save-planes.md) | One rule for the saved planes and the end of a run | In progress | Change | | [52](sep-0052-backend-shape.md) | One backend shape and a small native seam | In progress | Change | SEP 13, the standalone numerical prerequisite for SEP 12, SEP 14, which carried it to diff --git a/docs/dev/seps/sep-0051-save-planes.md b/docs/dev/seps/sep-0051-save-planes.md index ff5ec8889..8a4e7bda3 100644 --- a/docs/dev/seps/sep-0051-save-planes.md +++ b/docs/dev/seps/sep-0051-save-planes.md @@ -6,7 +6,7 @@ | **Title** | One rule for the saved planes and the end of a run | | **Author** | John Travers | | **Drafting agent** | Opus 5.5 (2026-11-15) | -| **Status** | Accepted | +| **Status** | In progress | | **Review status** | Reviewed | | **Reviewers** | John Travers (human); GPT-6 (AI) | | **Type** | Change | @@ -15,7 +15,7 @@ | **Requires** | — | | **Supersedes** | — | | **Superseded-by** | — | -| **Implementation** | — | +| **Implementation** | Opus 5.5 (AI), for John Travers, on `feature/sep-0051-save-planes` | | **Manual pages** | — | ## Part I — Proposal @@ -533,6 +533,7 @@ None beyond solprop's own documentation and issues, cited where used. - 2026-11-15: John Travers reviewed the proposal and recorded decisions D1–D8. The drafting agent revised Part I to match and responded to R1–R10. - 2026-11-15: Accepted by John Travers in PR #847. Part I is frozen. +- 2026-11-15: Implementation started on `feature/sep-0051-save-planes`. ### AI review — 2026-11-15 From bbad74f3360cbcb903c144d82c1aa33830ae9060 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 00:16:06 +0000 Subject: [PATCH 02/20] Resolve save planes over the run's interval at adoption (SEP 51) One helper places a count, normalizes listed endpoints within LANDING_ULPS and refuses positions outside [initial_z, length]; the Simulation settings setter adopts every settings object through it, so a run always records its entrance and ends at grid.length. SimulationSettings gains n_save, its save_planes becomes optional, and bare numbers, both selectors and bad counts are refused by name. A replay schedule must cover the interval. Tests that ran a short window of a longer grid now shorten the grid and keep the collar the old length gave (tests/builders.py grid_at, held_collar). Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- src/solprop/driver/routes/general.py | 8 +- src/solprop/driver/routes/hollow.py | 4 +- src/solprop/driver/settings.py | 249 ++++++++++++++++++++++----- src/solprop/driver/simulation.py | 33 +++- tests/builders.py | 29 ++++ tests/driver/test_prop_gnlse.py | 6 +- tests/driver/test_simulation.py | 7 +- 7 files changed, 273 insertions(+), 63 deletions(-) diff --git a/src/solprop/driver/routes/general.py b/src/solprop/driver/routes/general.py index fe0b03e8b..a451b63d7 100644 --- a/src/solprop/driver/routes/general.py +++ b/src/solprop/driver/routes/general.py @@ -29,7 +29,6 @@ from solprop.driver.settings import ( NoiseSetting, _boundary, - _save_planes, keyword_settings, ) from solprop.exceptions import DriverError, TranslationError @@ -182,7 +181,6 @@ def _from_general(cls: type["Simulation"], request: _GeneralRequest) -> "Simulat "provider.mode_collection.modes" ) raise DriverError(msg) - planes = _save_planes(request.length, request.save_planes, request.n_save) refuse_beside( request.launch, channel=request.channel, @@ -208,7 +206,8 @@ def _from_general(cls: type["Simulation"], request: _GeneralRequest) -> "Simulat route = general_modal_route( provider, working, - z_max=float(np.max(planes)), + # The run ends at its length (SEP 51), so the tables cover the grid's. + z_max=float(working.length), omega_reference=float(working.omega0), kerr_form=request.kerr_form, selection=MaterialSelection() @@ -266,7 +265,8 @@ def _from_general(cls: type["Simulation"], request: _GeneralRequest) -> "Simulat atol=request.atol, dz_max=request.dz_max, dz_init=request.dz_init, - save_planes=planes, + save_planes=request.save_planes, + n_save=request.n_save, schedule=request.schedule, integrator=request.integrator, interpolate_planes=request.interpolate_planes, diff --git a/src/solprop/driver/routes/hollow.py b/src/solprop/driver/routes/hollow.py index f4acd9aa7..cfaebc099 100644 --- a/src/solprop/driver/routes/hollow.py +++ b/src/solprop/driver/routes/hollow.py @@ -47,7 +47,6 @@ from solprop.driver.settings import ( NoiseSetting, _boundary, - _save_planes, keyword_settings, ) from solprop.driver.tdse_run import _entry_overrides, _tdse_entry, _tdse_stats @@ -697,7 +696,8 @@ def _from_hollow( # noqa: PLR0915 - the route's whole build, keyword by keyword atol=request.atol, dz_max=request.dz_max, dz_init=request.dz_init, - save_planes=_save_planes(request.length, request.save_planes, n_save), + save_planes=request.save_planes, + n_save=n_save, schedule=request.schedule, integrator=request.integrator, interpolate_planes=request.interpolate_planes, diff --git a/src/solprop/driver/settings.py b/src/solprop/driver/settings.py index 41bb6cf3b..a69490df3 100644 --- a/src/solprop/driver/settings.py +++ b/src/solprop/driver/settings.py @@ -10,6 +10,8 @@ """ import dataclasses +import math +import numbers import warnings from collections.abc import Callable, Sequence from dataclasses import dataclass @@ -45,7 +47,7 @@ from solprop.stepper.low_storage import LowStorageRungeKutta from solprop.stepper.multistep import Multistep from solprop.stepper.runge_kutta import RungeKutta -from solprop.stepper.schedule import FixedSchedule +from solprop.stepper.schedule import LANDING_ULPS, FixedSchedule, replay_tolerance from solprop.translate.masks import AbsorberScheme from solprop.translate.problem import PropagatorMode @@ -68,7 +70,11 @@ """ DEFAULT_N_SAVE = 201 -"""Planes a GNLSE run stores, counting the one at ``z = 0``.""" +"""Observations a run records when given neither ``n_save`` nor ``save_planes``. + +Evenly spaced over the run's interval ``[initial_z, length]``, both ends included +(SEP 51). The TDSE capillary's route default is two instead. +""" _RECIPE_EXECUTION = ("fields", "field_planes", "resume_history") """The settings a recipe's ``[execution]`` table holds: a change of any other one drops @@ -150,11 +156,22 @@ class SimulationSettings(Displayed): grid. An explicit controller always wins, and settings that already belong to a route keep its default. The other fields are keyword-only. - save_planes : numpy.ndarray - Positions to save at, m, increasing and positive, shape ``(n_z,)``. The plane at - ``z = 0`` is saved as well and is not listed here. A sequence is adopted as a - read-only float64 array, so that two runs specified the same way record the same - planes whichever type they passed and therefore hash alike. + save_planes : numpy.ndarray or None + Positions to record the run at, m, finite and strictly increasing, inside the + run's interval ``[initial_z, length]``, where ``length`` is the grid's + (SEP 51). The entrance and the end are recorded anyway and are added when + absent; either may be listed and is kept once, a position within + :data:`~solprop.stepper.schedule.LANDING_ULPS` ulps of an endpoint being that + endpoint. An empty list records the two endpoints alone. A sequence is adopted + as a read-only float64 array, so that two runs specified the same way record + the same planes whichever type they passed and therefore hash alike. Give this + or `n_save`, not both; given neither, the run records + :data:`DEFAULT_N_SAVE`. A simulation holds its settings *resolved*: the + positions after its entrance, the last exactly its length, and `n_save` + ``None``. + n_save : int or None + How many evenly spaced observations to record over ``[initial_z, length]``, + both ends included: an integer of at least 2. Give this or `save_planes`. dz_max : float Cap on the controller's proposal, m. dz_init : float @@ -325,9 +342,11 @@ class SimulationSettings(Displayed): Raises ------ DriverError - If the save planes are empty, not increasing, or not positive. The same check - runs again in :func:`solprop.translate.assembly.assemble`; here it fires before - a run has built anything. Also if the field retention is not valid, asks for + If `save_planes` is a bare number, holds a position that is not finite or + does not increase strictly, or is given beside `n_save`, or if `n_save` is not + an integer of at least 2; each message names the fix. Positions outside the + run's interval are refused when a simulation adopts the settings, where the + interval is known. Also if the field retention is not valid, asks for ``fields='planes'`` beside `step_planes`. Examples @@ -345,7 +364,10 @@ class SimulationSettings(Displayed): controller: PIController | None = None _: dataclasses.KW_ONLY - save_planes: Float[np.ndarray, " n_z"] | Sequence[float] + # A bare number is admitted by the annotation so that it is refused by name, with + # the fix, rather than by the run-time type check. + save_planes: Float[np.ndarray, " n_z"] | Sequence[float] | float | None = None + n_save: int | float | None = None dz_max: float dz_init: float dz_min: float | None = None @@ -401,6 +423,9 @@ class SimulationSettings(Displayed): def _planes_text(self) -> str: """Return the save planes summarised, for printing.""" + if self.save_planes is None: + count = DEFAULT_N_SAVE if self.n_save is None else self.n_save + return f"{count} planes" + ("" if self.n_save else " (default)") planes = np.asarray(self.save_planes, dtype=float) return summarise(planes, "m").replace("values", "planes") @@ -475,27 +500,17 @@ def _describe(self) -> tuple[str, list[tuple[str, object]]]: ] def __post_init__(self) -> None: - """Adopt a read-only plane array and check it. + """Adopt a read-only plane array and check the selectors. Raises ------ DriverError - If the planes are empty, not increasing, or not positive, or if + If the plane selectors are malformed (:func:`_selectors`), or if `resume_history` is not a boolean or ``None``. """ - planes = frozen_copy(np.reshape(self.save_planes, -1), np.float64) - if ( - planes.size == 0 - or not np.all(np.isfinite(planes)) - or not np.all(np.diff(planes) > 0.0) - or planes[0] <= 0.0 - ): - msg = ( - f"save_planes must be positive and increasing, got {planes}; the plane " - "at z = 0 is saved anyway and is not one of them" - ) - raise DriverError(msg, parameter="save_planes") + planes, count = _selectors(self.save_planes, self.n_save) object.__setattr__(self, "save_planes", planes) + object.__setattr__(self, "n_save", count) refusal = field_retention_refusal(self.fields, self.field_planes) if refusal is not None: raise DriverError(refusal, parameter=("fields", "field_planes")) @@ -912,32 +927,176 @@ def _same_setting(old: object, new: object) -> bool: return False -def _save_planes( - length: float, - save_planes: Sequence[float] | np.ndarray | None, +_BOTH_SELECTORS = ( + "give one of n_save and save_planes, not both; to carry a count to settings that " + "hold positions, pass dataclasses.replace(settings, n_save=N, save_planes=None)" +) + + +def _selectors( + save_planes: object, n_save: object +) -> tuple[Float[np.ndarray, " n_z"] | None, int | None]: + """Return the plane selectors as settings hold them, refusing a malformed one. + + The checks that need no interval (SEP 51 section 5.5): a bare number, a position + that is not finite or does not increase strictly, both selectors, and a count that + is not an integer of at least 2. Positions are a read-only float64 array, m. + """ + if save_planes is not None and n_save is not None: + raise DriverError( + _BOTH_SELECTORS, + parameter=("save_planes", "n_save"), + rule="save-planes-or-n-save", + ) + count = None + if n_save is not None: + if isinstance(n_save, bool) or not isinstance(n_save, numbers.Integral): + msg = f"n_save is an integer of at least 2, got {n_save!r}" + raise DriverError(msg, parameter="n_save") + count = int(n_save) + if count < 2: + msg = ( + f"n_save is an integer of at least 2, got {count}: it counts the " + "entrance and the end, which a run always records" + ) + raise DriverError(msg, parameter="n_save") + if save_planes is None: + return None, count + if isinstance(save_planes, bool): + msg = f"save_planes takes positions in m, got {save_planes!r}" + raise DriverError(msg, parameter="save_planes") + if isinstance(save_planes, numbers.Integral): + msg = ( + f"save_planes={save_planes!r} reads as one position in m, not a count; for " + f"evenly spaced planes pass n_save={save_planes!r}" + ) + raise DriverError(msg, parameter="save_planes", rule="save-planes-count") + if isinstance(save_planes, numbers.Real) or np.ndim(save_planes) == 0: + msg = ( + f"save_planes={save_planes!r} is a single position; pass " + f"[{save_planes!r}], or n_save for evenly spaced planes" + ) + raise DriverError(msg, parameter="save_planes") + planes = frozen_copy(np.reshape(save_planes, -1), np.float64) + for index, position in enumerate(planes): + if not math.isfinite(position): + msg = f"save plane {position!r} is not finite" + raise DriverError(msg, parameter="save_planes") + if index and position <= planes[index - 1]: + relation = "repeats" if position == planes[index - 1] else "follows" + msg = ( + f"save plane {position!r} m {relation} {planes[index - 1]!r} m; the " + "positions must increase strictly" + ) + raise DriverError(msg, parameter="save_planes") + return planes, count + + +def _at(position: float, endpoint: float) -> bool: + """Return whether a position is an endpoint, within the marches' landing slack. + + :data:`~solprop.stepper.schedule.LANDING_ULPS` ulps of the endpoint itself, the + slack a march lands on a target with (SEP 51 section 5.4). + """ + return bool(abs(position - endpoint) <= LANDING_ULPS * math.ulp(endpoint)) + + +def _observation_planes( + save_planes: Float[np.ndarray, " _"] | None, n_save: int | None, + *, + entrance: float, + length: float, + default: int = DEFAULT_N_SAVE, ) -> Float[np.ndarray, " n_z"]: - """Return the save planes a keyword interface asks for. - - - ``length``: fibre length, m. - - ``save_planes``: positions given by the caller, m. - - Returns: the planes after ``z = 0``, m, shape ``(n_z,)``. + """Return the positions a run records after its entrance, the last exactly `length`. + + The one placement rule of SEP 51, for selectors :func:`_selectors` admitted: a + count places that many observations evenly over ``[entrance, length]``, both + included; positions within :data:`~solprop.stepper.schedule.LANDING_ULPS` ulps of + an endpoint become it, each endpoint is kept once, the end is added when absent and + a position outside the interval is refused; neither selector takes `default`. + Resolving the result again against the same interval returns it unchanged. + Positions in m; `entrance` before `length`. """ - if save_planes is not None: - if n_save is not None: - msg = "give save_planes or n_save, not both" - raise DriverError( - msg, parameter=("save_planes", "n_save"), rule="save-planes-or-n-save" + if save_planes is None: + count = default if n_save is None else n_save + # linspace's last value is exactly `length`. + return frozen_copy(np.linspace(entrance, length, count)[1:], np.float64) + planes = np.array(save_planes, dtype=np.float64) + for index, position in enumerate(planes): + if _at(position, length): + planes[index] = length + elif _at(position, entrance): + planes[index] = entrance + elif position < entrance: + msg = ( + f"save plane {position:g} m lies before the entrance, initial_z = " + f"{entrance:g} m; the run records [{entrance:g} m, {length:g} m]" + ) + raise DriverError(msg, parameter="save_planes", rule="save-planes-outside") + elif position > length: + msg = ( + f"save plane {position:g} m lies beyond the end of the run, " + f"grid.length = {length:g} m; the run records [{entrance:g} m, " + f"{length:g} m]: raise length (or grid.length), or drop the plane" ) - return np.ascontiguousarray(save_planes, dtype=np.float64).reshape(-1) - count = DEFAULT_N_SAVE if n_save is None else n_save - if count < 2: + raise DriverError(msg, parameter="save_planes", rule="save-planes-outside") + # Normalization can only merge an endpoint with a listed neighbour. + interior = np.unique(planes[(planes > entrance) & (planes < length)]) + return frozen_copy(np.append(interior, length), np.float64) + + +def _replay_refusal( + schedule: FixedSchedule, entrance: float, length: float +) -> str | None: + """Return why a replayed schedule does not cover a run's interval, or ``None``. + + Its start agrees with the entrance under the endpoint rule, and its end with the + length within :func:`~solprop.stepper.schedule.replay_tolerance`, which allows the + rounding its step sum accumulates (SEP 51 section 5.7). + """ + if not _at(schedule.z_start, entrance): + return ( + f"the replayed schedule starts at {schedule.z_start:g} m, but the run's " + f"entrance is {entrance:g} m" + ) + if abs(schedule.z_end - length) > replay_tolerance(schedule, length): + return ( + f"the replayed schedule ends at {schedule.z_end!r} m, but the run ends at " + f"its length, {length!r} m; replay a schedule over the run's interval, " + "such as FixedSchedule.uniform(z_start, length, ...)" + ) + return None + + +def _adopted( + settings: SimulationSettings, *, entrance: float, length: float +) -> SimulationSettings: + """Return settings resolved for a run over ``[entrance, length]``, m (SEP 51 5.6). + + Validated against the run whatever they hold, a count, a list or resolved + positions; the result holds the positions after the entrance ending exactly at + `length`, and ``n_save=None``. Settings already resolved for the run are returned + as they are. An interior launch's schedule is left to its own refusal. + """ + if not (math.isfinite(entrance) and 0.0 <= entrance < length): msg = ( - f"n_save counts the plane at z = 0, so it must be at least 2, got {count}; " - "a run always stores the entrance" + f"initial_z must be finite, nonnegative and before the end of the run, " + f"grid.length = {length:g} m; got {entrance!r}" ) - raise DriverError(msg, parameter="n_save") - return np.linspace(0.0, length, count)[1:] + raise DriverError(msg, parameter="initial_z") + planes = _observation_planes( + settings.save_planes, settings.n_save, entrance=entrance, length=length + ) + if settings.schedule is not None and entrance == 0.0: + refusal = _replay_refusal(settings.schedule, entrance, length) + if refusal is not None: + raise DriverError(refusal, parameter="schedule", rule="replay-interval") + current = settings.save_planes + if current is not None and np.array_equal(current, planes): + return settings + return dataclasses.replace(settings, save_planes=planes, n_save=None) def _scheme(settings: SimulationSettings) -> AbsorberScheme: diff --git a/src/solprop/driver/simulation.py b/src/solprop/driver/simulation.py index 921456270..1467c46b8 100644 --- a/src/solprop/driver/simulation.py +++ b/src/solprop/driver/simulation.py @@ -129,10 +129,10 @@ _RECIPE_EXECUTION, NoiseSetting, SimulationSettings, + _adopted, _boundary, _quiet_collar, _same_setting, - _save_planes, _scheme, _spatial_default, _spatial_settings, @@ -445,6 +445,7 @@ def __init__( # every run repeated (``_transverse_edge``). self._edge_k_min: dict[float, float] = {} self.settings = settings + settings = self.settings if settings.controller is None: msg = ( "settings.controller is None: Simulation.from_free and " @@ -548,13 +549,24 @@ def settings(self, settings: SimulationSettings) -> None: settings : SimulationSettings The replacement. + The replacement is adopted as the constructor adopts its settings (SEP 51): + validated against this run's interval ``[initial_z, grid.length]`` and + resolved into the positions after the entrance, ending exactly at the length, + before anything is compared, so a count and the positions it resolves to are + the same setting. + Raises ------ DriverError - If the simulation has already been translated and the replacement changes - a setting other than ``backend``, ``resume_history``, ``fields``, - ``field_planes``, ``tdse_execution`` or ``boundary_check``, naming them. + If the planes do not fit this run's interval, a replayed schedule does not + cover it, or the simulation has already been translated and the + replacement changes a setting other than ``backend``, ``resume_history``, + ``fields``, ``field_planes``, ``tdse_execution`` or ``boundary_check``, + naming them. """ + settings = _adopted( + settings, entrance=float(self.initial_z), length=float(self.grid.length) + ) if self._problem is not None: changed = [ one.name @@ -890,8 +902,10 @@ def with_input( the seed a resume's file or a scan point supplies. initial_z : float or None, optional Absolute launch position in metres. None retains this simulation's - launch. An explicit position keeps only existing save planes beyond - it, preserving all absolute profiles, propagation tables and the frame. + launch. An explicit position keeps the already resolved observations + beyond it, which always include the end, and records the new entrance + there (SEP 51): it requests no new count. All absolute profiles, + propagation tables and the frame are kept. configuration : collections.abc.Mapping or None, optional Caller keys merged into the derived run's configuration record, and so into its configuration hash: the delay of a scan, the label of an input. @@ -1017,7 +1031,9 @@ def with_input( ) request = self._run_request() updated._request = request.with_stepper( - dataclasses.replace(request.stepper, save_planes=settings.save_planes) + dataclasses.replace( + request.stepper, save_planes=updated.settings.save_planes + ) ) route = updated._problem.route if isinstance(route, SpatialRoute): @@ -2562,7 +2578,8 @@ def from_gnlse( atol=atol, dz_max=dz_max, dz_init=dz_init, - save_planes=_save_planes(length, save_planes, n_save), + save_planes=save_planes, + n_save=n_save, schedule=schedule, integrator=integrator, interpolate_planes=interpolate_planes, diff --git a/tests/builders.py b/tests/builders.py index 2d7e54a9d..6576e43b9 100644 --- a/tests/builders.py +++ b/tests/builders.py @@ -9,6 +9,7 @@ pinned, when it was migrated, by the configuration hash of what the old copies built. """ +import dataclasses import subprocess import sys import textwrap @@ -20,8 +21,10 @@ from legacy_geometry import LEGACY_GRID, bare_absorber from march_bounds import FIXED_ORDER from solprop.backends.numpy_ref import NumpyRefBackend +from solprop.boundaries import DEFAULT_BOUNDARY_N, Absorber, absorber from solprop.driver import Simulation from solprop.driver.scan import ScanPoint +from solprop.exceptions import GridError from solprop.grid import EnvelopeGrid, TimeGrid from solprop.stats import StatsSpec from solprop.stepper import FixedSchedule @@ -31,6 +34,8 @@ __all__ = [ "HASH_PROBE", "fixed_fibre_point", + "grid_at", + "held_collar", "launch_derivative", "load_reference", "numpy_ref_launch_derivative", @@ -82,6 +87,30 @@ def load_reference( return workspace.committed() +def grid_at[G: TimeGrid](grid: G, length: float) -> G: + """Return `grid` with another length, m, and every sample as it was. + + A run ends at its grid's length (SEP 51), so a test that ran a short window of a + longer grid shortens the grid instead. The length also sets the default absorber's + reference length; :func:`held_collar` keeps the rates the old length gave. + """ + return dataclasses.replace(grid, length=length) + + +def held_collar(grid: TimeGrid, length: float) -> Absorber: + """Return the default collar on `grid`, at the rates a grid of `length` gave. + + :func:`solprop.driver.settings.default_collar` with its reference length pinned to + ``length / DEFAULT_BOUNDARY_N``, m, so that shortening a test's grid to the window + it runs (:func:`grid_at`) leaves its absorber unchanged. + """ + reference = length / DEFAULT_BOUNDARY_N + try: + return absorber(grid, boundary_length=reference) + except GridError: + return absorber(grid, boundary_length=reference, temporal=False) + + def launch_derivative(backend: NumpyRefBackend, problem: PropagationProblem) -> Any: """Return an open ``numpy_ref`` backend's stage derivative ``N(E, z=0)`` at launch. diff --git a/tests/driver/test_prop_gnlse.py b/tests/driver/test_prop_gnlse.py index 740401da9..96b93e3a1 100644 --- a/tests/driver/test_prop_gnlse.py +++ b/tests/driver/test_prop_gnlse.py @@ -16,6 +16,7 @@ import pytest from bounds import departure +from builders import grid_at, held_collar from legacy_geometry import LEGACY_GRID, bare_absorber from march_bounds import FIXED_ORDER, assert_matched, simulation_bound from selected_backend import selected_backend @@ -245,7 +246,10 @@ def test_the_sixth_order_soliton_runs_the_same_through_the_interface( stop, [0.0, 0.0, soliton.beta2], wavelength=soliton.wavelength, - grid=wide_grid, + # The run ends at its grid's length (SEP 51): the grid is the tenth it runs, + # with the collar the metre-long grid gave, so the problem is unchanged. + grid=grid_at(wide_grid, stop), + absorber=held_collar(grid_at(wide_grid, stop), wide_grid.length), width=soliton.tau0, peak_power=soliton.peak_power(6), shape="sech", diff --git a/tests/driver/test_simulation.py b/tests/driver/test_simulation.py index 1ffc24582..9b987ddef 100644 --- a/tests/driver/test_simulation.py +++ b/tests/driver/test_simulation.py @@ -16,6 +16,7 @@ import numpy as np import pytest +from builders import grid_at from solprop._identity import canonical_json from solprop.constants import C from solprop.driver import Simulation, SimulationSettings @@ -160,7 +161,7 @@ def test_the_modes_and_the_profiles_reach_the_backend(narrow_grid, soliton): wavelength=wavelength, width=soliton.tau0, peak_power=soliton.peak_power(1) ) simulation = Simulation( - narrow_grid, + grid_at(narrow_grid, 0.005), fibre.mode, [fibre.kerr], pulse, @@ -199,7 +200,7 @@ def test_a_built_spectrum_is_accepted_as_the_input(narrow_grid, soliton): peak_power=soliton.peak_power(1), ).build(narrow_grid) simulation = Simulation( - narrow_grid, + grid_at(narrow_grid, 0.005), fibre.mode, [fibre.kerr], spectrum, @@ -230,7 +231,7 @@ def test_an_input_that_is_neither_a_pulse_nor_a_spectrum_is_refused( not_a_pulse: Any = SimpleNamespace(build="a pulse, honest") with pytest.raises(DriverError, match="build\\(grid\\) method"): Simulation( - narrow_grid, + grid_at(narrow_grid, 0.005), fibre.mode, [fibre.kerr], not_a_pulse, From 8e3d0e1c856f3cb29f40de795b23a2a9883aeb6e Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 00:20:55 +0000 Subject: [PATCH 03/20] State a keyword route's length once: length, grid or both (SEP 51) length becomes optional on prop_/from_gnlse, capillary and waveguide; given a grid it must agree with grid.length within LANDING_ULPS, which is then the run's length, and neither is refused. length stays positional-or-keyword for now (an interim choice, pending with the maintainer); the capillary's gas therefore takes a default and is refused when omitted. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- src/solprop/driver/interface.py | 8 ++--- src/solprop/driver/settings.py | 21 +++++++++++++ src/solprop/driver/simulation.py | 53 +++++++++++++++++++++++--------- 3 files changed, 63 insertions(+), 19 deletions(-) diff --git a/src/solprop/driver/interface.py b/src/solprop/driver/interface.py index 7a58dfd52..8dd5b2d6a 100644 --- a/src/solprop/driver/interface.py +++ b/src/solprop/driver/interface.py @@ -275,7 +275,7 @@ def prop_planar( # numpydoc ignore=PR01 @_propagates(Simulation.from_gnlse) def prop_gnlse( # numpydoc ignore=PR01 gamma: float | None, - length: float, + length: float | None = None, betas: Sequence[float] | np.ndarray | None = None, *, wavelength: float, @@ -389,8 +389,8 @@ def prop_gnlse( # numpydoc ignore=PR01 @_propagates(Simulation.from_capillary) def prop_capillary( # numpydoc ignore=PR01 radius: float | ZProfile, - length: float, - gas: Gas | str | Mapping[str, float] | Mixture, + length: float | None = None, + gas: Gas | str | Mapping[str, float] | Mixture | None = None, pressure: Pressure | None = None, *, pressure_floor: float | None = None, @@ -531,7 +531,7 @@ def prop_capillary( # numpydoc ignore=PR01 @_propagates(Simulation.from_waveguide) def prop_waveguide( # numpydoc ignore=PR01 modes: Sequence[Mode], - length: float, + length: float | None = None, gas: Gas | str | Mapping[str, float] | Mixture | None = None, pressure: Pressure | None = None, *, diff --git a/src/solprop/driver/settings.py b/src/solprop/driver/settings.py index a69490df3..e241f6fdf 100644 --- a/src/solprop/driver/settings.py +++ b/src/solprop/driver/settings.py @@ -1047,6 +1047,27 @@ def _observation_planes( return frozen_copy(np.append(interior, length), np.float64) +def _run_length(length: float | None, grid: TimeGrid | None) -> float: + """Return a keyword route's one length, m, from `length`, `grid` or both (SEP 51). + + Given both, they must agree within :data:`~solprop.stepper.schedule.LANDING_ULPS` + ulps of ``grid.length``, which is then the canonical value; a supplied grid is never + rebuilt, and a conflict is never settled silently. + """ + if grid is None: + if length is None: + msg = "a length or a grid is required: pass length=, or grid=" + raise DriverError(msg, parameter=("length", "grid"), rule="length-or-grid") + return length + if length is not None and not _at(length, float(grid.length)): + msg = ( + f"length = {length!r} m and grid.length = {grid.length!r} m disagree: the " + "run ends at its one length, so give one of them, or make them agree" + ) + raise DriverError(msg, parameter=("length", "grid"), rule="length-grid") + return float(grid.length) + + def _replay_refusal( schedule: FixedSchedule, entrance: float, length: float ) -> str | None: diff --git a/src/solprop/driver/simulation.py b/src/solprop/driver/simulation.py index 1467c46b8..88ae815af 100644 --- a/src/solprop/driver/simulation.py +++ b/src/solprop/driver/simulation.py @@ -132,6 +132,7 @@ _adopted, _boundary, _quiet_collar, + _run_length, _same_setting, _scheme, _spatial_default, @@ -2283,7 +2284,7 @@ def from_planar( def from_gnlse( cls, gamma: float | None, - length: float, + length: float | None = None, betas: Sequence[float] | np.ndarray | None = None, *, wavelength: float, @@ -2338,8 +2339,12 @@ def from_gnlse( ---------- gamma : float or None Nonlinear coefficient in 1/(W m), positive for a self-focusing medium. - length : float - Fibre length, m, positive. + length : float or None, optional + Fibre length, which is the run's length and its end, m, positive + (SEP 51): the grid is built with it, and the default steps + derive from it. Optional beside `grid`, whose ``grid.length`` it must + then agree with to within :data:`~solprop.stepper.schedule.LANDING_ULPS` + ulps; one of the two is required. betas : array_like, optional Taylor coefficients of ``beta`` about `wavelength`, ``beta_0, beta_1, ...``, in s^n/m. ``beta_0`` and ``beta_1`` only fix the frame and change no @@ -2357,7 +2362,8 @@ def from_gnlse( An envelope grid to propagate on instead of building one from `length`, `wavelength`, `wavelength_limits` and `trange`. This is the way to choose the sample spacing, the oversampling factor or the transform size. A field - grid is refused: the GNLSE mapping is the envelope Kerr response. + grid is refused: the GNLSE mapping is the envelope Kerr response. Its + length is the run's (`length`). beta : tuple or callable, optional The propagation constant as data instead of a series: a pair of arrays ``(omega, beta)`` in rad/s and 1/m with strictly increasing frequencies, or @@ -2536,6 +2542,7 @@ def from_gnlse( >>> simulation.settings.save_planes.tolist() [0.005, 0.01] """ + length = _run_length(length, grid) materials = MaterialSelection() if materials is None else materials _refuse_dispersive_policy(materials, "a GNLSE run's fitted gamma") working = _gnlse_grid( @@ -2617,8 +2624,8 @@ def from_gnlse( def from_capillary( cls, radius: float | ZProfile, - length: float, - gas: Gas | str | Mapping[str, float] | Mixture, + length: float | None = None, + gas: Gas | str | Mapping[str, float] | Mixture | None = None, pressure: Pressure | None = None, *, pressure_floor: float | None = None, @@ -2702,11 +2709,16 @@ def from_capillary( ---------- radius : float or solprop.profiles.ZProfile Core radius, m, constant or along z. - length : float - Capillary length, m. + length : float or None, optional + Capillary length, which is the run's length and its end, m, positive + (SEP 51): the grid is built with it, and the default steps and profiles + derive from it. Optional beside `grid`, whose ``grid.length`` it must + then agree with to within :data:`~solprop.stepper.schedule.LANDING_ULPS` + ulps; one of the two is required. gas : Gas, str, Mapping or Mixture - Built-in gas, mole fractions keyed by species name, or ordered populations - carrying their own density paths. A mapping uses total pressure. + Required. Built-in gas, mole fractions keyed by species name, or + ordered populations carrying their own density paths. A mapping uses + total pressure. pressure : float, sequence, ZProfile or None, optional None uses one bar for a gas or fractions. Omit pressure beside a Mixture; every explicit pressure is refused because it already carries its paths. @@ -2746,7 +2758,8 @@ def from_capillary( Requested width of the time window, s. Required unless `grid` is given. grid : solprop.grid.TimeGrid or None, optional A grid of one's own, instead of the three keywords above; the only way to - reach ``dt``, ``ffac`` or the transform size. + reach ``dt``, ``ffac`` or the transform size. Its length is the run's + (`length`). envelope : bool, optional Propagate an envelope. Plasma is off by default; explicit ``plasma=True`` selects cycle averaging of instantaneous rates. Plasma forbids THG. @@ -3028,6 +3041,10 @@ def from_capillary( >>> sorted(simulation.profiles) ['core_radius', 'density', 'pressure'] """ + length = _run_length(length, grid) + if gas is None: + msg = "a capillary run needs its fill: pass gas=" + raise DriverError(msg, parameter="gas") return _from_hollow( cls, keyword_request( @@ -3042,7 +3059,7 @@ def from_capillary( def from_waveguide( cls, modes: Sequence[Mode], - length: float, + length: float | None = None, gas: Gas | str | Mapping[str, float] | Mixture | None = None, pressure: Pressure | None = None, *, @@ -3143,8 +3160,12 @@ def from_waveguide( `provider` it must be empty or exactly the guide's own ordered channels: a guide supplies its channels itself, and the provider has already validated their order against its fields. - length : float - Waveguide length, m. + length : float or None, optional + Waveguide length, which is the run's length and its end, m, positive + (SEP 51): the grid is built with it, and the default steps and profiles + derive from it. Optional beside `grid`, whose ``grid.length`` it must + then agree with to within :data:`~solprop.stepper.schedule.LANDING_ULPS` + ulps; one of the two is required. gas : Gas, str, Mapping, Mixture or None Built-in gas, mole fractions keyed by species name, or ordered populations carrying their own density paths. A mapping uses total pressure. Required @@ -3249,7 +3270,8 @@ def from_waveguide( Requested width of the time window, s. Required unless `grid` is given. grid : solprop.grid.TimeGrid or None, optional A grid of one's own, instead of the three keywords above; the only way to - reach ``dt``, ``ffac`` or the transform size. + reach ``dt``, ``ffac`` or the transform size. Its length is the run's + (`length`). envelope : bool, optional Propagate an envelope. Plasma is off by default; explicit ``plasma=True`` selects cycle averaging of instantaneous rates. Plasma forbids THG. @@ -3473,6 +3495,7 @@ def from_waveguide( provider, a general-guide keyword is given without one, or any supplied setting is invalid. """ + length = _run_length(length, grid) if provider is not None: # The gas-filled keywords are carried to be refused by name if set. scope = locals() From 9e3c33c0c7008c2d224a26387c614912ab64e734 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 01:36:48 +0000 Subject: [PATCH 04/20] Give recipes SEP 51's planes: n_save in settings, refusals as RecipeError The object routes' settings metadata drops the integer form of save_planes and gains n_save; a bare integer save_planes is refused with 'write n_save = N' on every route, and the driver's refusals of the planes, the length and replay reach a recipe as a RecipeError naming the keyword. The resolved recipe writes the run's canonical positions where the route reads them, nested [build.settings] included, and drops n_save (#533). Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- src/solprop/recipe/core.py | 23 ++++-- src/solprop/recipe/metadata.py | 18 ++-- src/solprop/recipe/provenance.py | 16 +++- src/solprop/recipe/registry.py | 85 +++++++++++++++++++ tests/recipe/test_save_planes.py | 138 +++++++++++++++++++++++++++++++ 5 files changed, 265 insertions(+), 15 deletions(-) create mode 100644 tests/recipe/test_save_planes.py diff --git a/src/solprop/recipe/core.py b/src/solprop/recipe/core.py index 13139a3f2..393bce48d 100644 --- a/src/solprop/recipe/core.py +++ b/src/solprop/recipe/core.py @@ -23,7 +23,7 @@ import numpy as np -from solprop.exceptions import SolpropError, SolpropWarning +from solprop.exceptions import DriverError, SolpropError, SolpropWarning from solprop.output.records import RecipeRecord from solprop.recipe.document import ( FORMAT, @@ -52,6 +52,7 @@ BuildContext, coerce, decode_keyword, + plane_parameter, retired, ) @@ -694,11 +695,21 @@ def build(self) -> "Simulation": if self._document.get("pins"): return self.resolve().build() builder = surface(self.route) - simulation = builder(**self.keywords()) - if not self._grid_first() and any( - _needs_grid(value) for value in self._document["build"].values() - ): - simulation = builder(**self.keywords(grid=simulation._base_grid)) + try: + simulation = builder(**self.keywords()) + if not self._grid_first() and any( + _needs_grid(value) for value in self._document["build"].values() + ): + simulation = builder(**self.keywords(grid=simulation._base_grid)) + except DriverError as error: + # SEP 51's refusals of the planes, the length and replay are the recipe's. + planes = plane_parameter(error) + if planes is None: + raise + prefix = "settings." if self.route in OBJECT_ROUTES else "" + if planes in ("length", "grid"): + prefix = "" + raise RecipeError(str(error), path=f"{prefix}{planes}") from error execution = self._execution() if execution: simulation.settings = dataclasses.replace(simulation.settings, **execution) diff --git a/src/solprop/recipe/metadata.py b/src/solprop/recipe/metadata.py index 9421a0c9b..c28df8d4e 100644 --- a/src/solprop/recipe/metadata.py +++ b/src/solprop/recipe/metadata.py @@ -447,7 +447,7 @@ def _pressure(values: Mapping[str, object]) -> Resolution: _CHECK: Final = Form("object", types=("BoundaryCheck",)) _MATERIALS: Final = Form("object", types=("MaterialSelection",)) _SCHEMES: Final = Form("choice", choices=("nonlinear", "split_step")) -_SAVE_PLANES: Final = Form("array", unit="m", minimum=0.0, exclusive=True) +_SAVE_PLANES: Final = Form("array", unit="m", minimum=0.0) _PHASES: Final = Form("array", elements="phases") _SHAPES: Final = Form("choice", choices=("gauss", "sech")) _BACKENDS: Final = Form("string") @@ -473,7 +473,7 @@ def _shared(route: str) -> tuple[Parameter, ...]: (_POSITIVE_LENGTH,), "geometry", "basic", - "Propagation length.", + "Propagation length, the run's end; optional beside a grid.", "guide/setup/running.md#one-call", display="m", ), @@ -670,7 +670,7 @@ def _shared(route: str) -> tuple[Parameter, ...]: (_SAVE_PLANES,), "output", "basic", - "Positions to save the field at, after the entrance.", + "Positions to record the run at; the entrance and the end are added.", _OUTPUT_PAGE, display="mm", resolvable=True, @@ -680,7 +680,7 @@ def _shared(route: str) -> tuple[Parameter, ...]: (Form("integer", minimum=2),), "output", "basic", - "Number of evenly spaced planes to save, counting the entrance.", + "Evenly spaced observations over the run, both ends included.", _OUTPUT_PAGE, ), Parameter( @@ -2861,11 +2861,17 @@ def _plasma(*extra: Row) -> tuple[Parameter, ...]: ), _keyword( "save_planes", - (Form("array", unit="m", minimum=0.0, exclusive=True), _integer(1)), + Form("array", unit="m", minimum=0.0), "basic", - "Positions to save at, or how many equally spaced planes.", + "Positions to record the run at; the entrance and the end are added.", display="m", ), + _keyword( + "n_save", + _integer(2), + "basic", + "Evenly spaced observations over the run, both ends included.", + ), _keyword("dz_max", _LENGTH, "advanced", "Largest step.", display="mm"), _keyword("dz_init", _LENGTH, "advanced", "First step.", display="mm"), _keyword( diff --git a/src/solprop/recipe/provenance.py b/src/solprop/recipe/provenance.py index b89d015bf..c3b31228f 100644 --- a/src/solprop/recipe/provenance.py +++ b/src/solprop/recipe/provenance.py @@ -30,7 +30,7 @@ encode_integer, read_data_file, ) -from solprop.recipe.metadata import REQUIRED, parameters +from solprop.recipe.metadata import OBJECT_ROUTES, REQUIRED, parameters if TYPE_CHECKING: from solprop.driver.simulation import Simulation @@ -150,8 +150,18 @@ def resolved_document( entry = table.get(name) if entry is not None and entry.resolvable and name not in build: build[name] = value - # save_planes is resolvable on every route, so the planes n_save stood for are now - # written out. + # The run's resolved positions, ending at its length, replace whatever selector + # was authored or defaulted (SEP 51 section 5.9), at the level the route reads + # them: a later change of a default count cannot change the rebuilt run. + planes = np.asarray(simulation.settings.save_planes, dtype=float).tolist() + nested = build.get("settings") + if recipe.route in OBJECT_ROUTES and isinstance(nested, Mapping): + settings_table = dict(nested) + settings_table.pop("n_save", None) + settings_table["save_planes"] = planes + build["settings"] = settings_table + else: + build["save_planes"] = planes build.pop("n_save", None) noise = simulation.noise if noise is not None and noise.seed is not None and "seed" not in build: diff --git a/src/solprop/recipe/registry.py b/src/solprop/recipe/registry.py index b0c40ddda..fa32febea 100644 --- a/src/solprop/recipe/registry.py +++ b/src/solprop/recipe/registry.py @@ -32,6 +32,7 @@ from solprop.boundaries import SpatialAbsorber, absorber from solprop.driver.settings import SimulationSettings +from solprop.exceptions import DriverError from solprop.grid import ( EnvelopeGrid, FieldGrid, @@ -87,6 +88,7 @@ from solprop.stepper.schedule import FixedSchedule __all__ = [ + "PLANE_PARAMETERS", "REGISTRY", "RETIRED_KEYWORDS", "BuildContext", @@ -97,6 +99,8 @@ "coerce", "decode", "decode_keyword", + "plane_parameter", + "refuse_plane_count", "retired", "unit_of", ] @@ -732,15 +736,95 @@ def build_object( "route's gas, pressure and temperature, so a mode table names no fill" ) raise RecipeError(msg, path=path) + if factory.target is SimulationSettings: + refuse_plane_count(key, item, f"{path}.{key}") decoded = decode(item, factory.units.get(key), context, f"{path}.{key}") arguments[key] = coerce(factory.target, key, decoded) if factory.solves and context.stand_in: # A solve on a band that is not the run's would refuse what the run accepts. return None + return _constructed(factory, positional, arguments, path) + + +def _constructed( + factory: Factory, + positional: Sequence[object], + arguments: Mapping[str, object], + path: str, +) -> object: + """Call a factory's target, its refusals of the planes reported as the recipe's.""" try: return factory.target(*positional, **arguments) except TypeError as error: raise RecipeError(f"{factory.name}: {error}", path=path) from error + except DriverError as error: + planes = plane_parameter(error) + if planes is None: + raise + raise RecipeError(str(error), path=f"{path}.{planes}") from error + + +PLANE_PARAMETERS: Final = ("save_planes", "n_save", "length", "grid", "schedule") +"""The keywords whose refusals SEP 51 states, which a recipe reports as its own.""" + + +def plane_parameter(error: DriverError) -> str | None: + """Return the keyword a refusal of the planes, the length or replay names. + + Parameters + ---------- + error : solprop.exceptions.DriverError + A refusal raised while a recipe's run is built. + + Returns + ------- + str or None + The first keyword it names of :data:`PLANE_PARAMETERS`, or ``None`` for + another refusal, which keeps its own type. + + Examples + -------- + >>> from solprop.exceptions import DriverError + >>> from solprop.recipe.registry import plane_parameter + >>> plane_parameter(DriverError("...", parameter=("save_planes", "n_save"))) + 'save_planes' + """ + named = error.parameter + paths = (named,) if isinstance(named, str) else tuple(named or ()) + return next((one for one in paths if one in PLANE_PARAMETERS), None) + + +def refuse_plane_count(key: str, value: object, path: str) -> None: + """Refuse a bare integer given as ``save_planes``, naming ``n_save`` (SEP 51). + + A recipe once read ``save_planes = 80`` as one plane at 80 m (#533); positions and + a count have one name each, so the integer is refused with the fix. + + Parameters + ---------- + key : str + The keyword. + value : object + Its value as TOML read it. + path : str + The value's parameter path, for the error. + + Raises + ------ + RecipeError + If `key` is ``save_planes`` and `value` an integer. + + Examples + -------- + >>> from solprop.recipe.registry import refuse_plane_count + >>> refuse_plane_count("save_planes", [0.1, 0.2], "settings.save_planes") + """ + if key == "save_planes" and isinstance(value, int) and not isinstance(value, bool): + msg = ( + f"save_planes = {value} reads as one position in m, not a count; for " + f"evenly spaced planes write n_save = {value}" + ) + raise RecipeError(msg, path=path) @functools.cache @@ -903,6 +987,7 @@ def decode_keyword(entry: Parameter, value: object, context: BuildContext) -> ob "hold; use the Python export (Recipe.to_python)" ) raise RecipeError(msg, path=entry.name) + refuse_plane_count(entry.name, value, entry.name) unit = unit_of(entry, value) if unit is None and _numeric_rows(entry, value): msg = f"{entry.name} takes one row of numbers, not a list of rows" diff --git a/tests/recipe/test_save_planes.py b/tests/recipe/test_save_planes.py new file mode 100644 index 000000000..e7a716b8c --- /dev/null +++ b/tests/recipe/test_save_planes.py @@ -0,0 +1,138 @@ +# SPDX-FileCopyrightText: 2026 John C. Travers and contributors +# +# SPDX-License-Identifier: GPL-3.0-or-later + +"""A recipe's saved planes and length under SEP 51's one rule. + +The refusals a recipe meets are the driver's, reported as a +:class:`~solprop.recipe.RecipeError` against the keyword; a count in an object route's +``[build.settings]`` is ``n_save``; and the resolved recipe writes the run's canonical +positions at the level the route reads them, so a later change of a default count +cannot change the rebuilt run. +""" + +import warnings + +import numpy as np +import pytest + +from recipe.test_free_space import RADIAL +from recipe.test_recipe import GNLSE +from solprop.driver import settings as settings_module +from solprop.recipe import Recipe, RecipeError, provenance + +pytestmark = pytest.mark.filterwarnings("ignore::solprop.exceptions.BoundaryWarning") + +LISTED = 'save_planes = ["0.5 mm", "1 mm"]' +"""The radial recipe's own positions, which each case here replaces.""" + + +def _hash(simulation) -> str: + with warnings.catch_warnings(): + warnings.simplefilter("ignore") + return simulation.metadata().configuration_hash() + + +def radial(selector: str) -> Recipe: + """Return the radial recipe with its settings' planes written as `selector`.""" + return Recipe.loads(RADIAL.replace(LISTED, selector)) + + +# ------------------------------------------------------------------- refusals + + +@pytest.mark.parametrize( + ("selector", "match", "path"), + [ + ("save_planes = 80", "write n_save = 80", "settings.save_planes"), + ('save_planes = "0.25 mm"', r"pass \[0\.00025\], or n_save", "settings.save_planes"), + ("n_save = 1", "n_save is an integer of at least 2", "settings.n_save"), + ( + 'save_planes = ["1 mm"]\nn_save = 3', + "give one of n_save and save_planes", + "settings.save_planes", + ), + ('save_planes = ["2 mm"]', r"raise length \(or grid\.length\)", "settings.save_planes"), + ], + ids=["count", "lone", "small", "both", "beyond"], +) +def test_an_object_route_recipe_refuses_what_the_driver_refuses(selector, match, path): + recipe = radial(selector) + with pytest.raises(RecipeError, match=match) as refused: + recipe.build() + assert refused.value.parameter == path + errors = [issue for issue in recipe.check() if issue.severity == "error"] + assert [issue.parameter for issue in errors] == [path] + + +def test_a_keyword_route_recipe_refuses_an_integer_save_planes(): + with pytest.raises(RecipeError, match="write n_save = 80") as refused: + Recipe.loads(GNLSE.replace("n_save = 3", "save_planes = 80")).build() + assert refused.value.parameter == "save_planes" + + +def test_a_keyword_route_recipe_refuses_a_length_its_grid_disagrees_with(): + text = GNLSE.replace( + 'wavelength_limits = ["500 nm", "2 um"]\ntrange = "4 ps"\n', + 'grid = { type = "EnvelopeGrid.from_limits", length = "2 cm", ' + 'reference_wavelength = "835 nm", wavelength_limits = ["500 nm", "2 um"], ' + 'trange = "4 ps" }\n', + ) + with pytest.raises(RecipeError, match=r"length = 0\.01 m and grid\.length = 0\.02"): + Recipe.loads(text).build() + + +# ------------------------------------------------------------------ the selectors + + +def test_an_object_route_recipe_takes_a_count_over_its_grid_length(): + simulation = radial("n_save = 81").build() + planes = simulation.settings.save_planes + assert planes.tolist() == np.linspace(0.0, 1e-3, 81)[1:].tolist() + assert planes[-1] == simulation.grid.length + + +def test_an_object_route_recipe_without_a_selector_takes_the_default_count(): + simulation = radial("").build() + assert simulation.settings.save_planes.size + 1 == settings_module.DEFAULT_N_SAVE + + +def test_the_count_and_its_positions_build_the_same_run(): + counted = radial("n_save = 3").build() + listed = radial(LISTED).build() + assert _hash(counted) == _hash(listed) + + +# ------------------------------------------------------------- the resolved recipe + + +@pytest.mark.parametrize( + "selector", ["n_save = 5", LISTED, 'save_planes = ["0.5 mm"]', ""] +) +def test_the_resolved_recipe_writes_the_canonical_positions_in_the_settings(selector): + recipe = radial(selector) + simulation = recipe.build() + document = provenance.resolved_document(recipe, simulation) + table = document["build"]["settings"] + assert "n_save" not in table + assert table["save_planes"] == simulation.settings.save_planes.tolist() + assert "save_planes" not in document["build"] + assert _hash(Recipe.from_dict(document).build()) == _hash(simulation) + + +def test_a_resolved_recipe_does_not_depend_on_the_default_count(monkeypatch): + recipe = radial("") + simulation = recipe.build() + document = provenance.resolved_document(recipe, simulation) + monkeypatch.setattr(settings_module, "DEFAULT_N_SAVE", 11) + assert radial("").build().settings.save_planes.size == 10 + assert _hash(Recipe.from_dict(document).build()) == _hash(simulation) + + +def test_a_keyword_route_s_resolved_recipe_drops_its_count(): + recipe = Recipe.loads(GNLSE) + simulation = recipe.build() + document = provenance.resolved_document(recipe, simulation) + assert "n_save" not in document["build"] + assert document["build"]["save_planes"] == [0.005, 0.01] + assert _hash(Recipe.from_dict(document).build()) == _hash(simulation) From 1d7f1e8226be380230caa6e40b0db45366e8f411 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 01:36:48 +0000 Subject: [PATCH 05/20] Fit tests and benchmark windows to runs that end at their length Short windows of longer grids keep their physics: the grid is cut at the run's end and the collar, and where a default step depended on the length the step, are those the longer length gave. Construction- and refusal-only cases shorten freely; a schedule past the run's end is now a refusal test. The benchmark harness's shortened runs (ab --length) rebuild the case on its grid cut at the stop, and a coupled case that is translated at construction runs whole. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- benchmarks/builders.py | 89 +++++++++++++++++-- benchmarks/guides.py | 6 ++ benchmarks/sessions.py | 9 +- tests/backends/adams_source_cases.py | 7 +- tests/backends/dispersive_rows.py | 4 +- tests/backends/general_rows.py | 7 +- tests/backends/test_far_field_statistics.py | 10 ++- tests/backends/test_native_far_field.py | 8 +- tests/backends/test_planar_hybrid.py | 6 +- tests/coupled_flow_cases.py | 5 +- tests/coupling/test_vector_coupling.py | 7 +- tests/coupling/test_workflows.py | 13 ++- tests/driver/test_backend_default.py | 3 + tests/driver/test_coherent_capillary.py | 5 +- tests/driver/test_general_modal.py | 43 +++++---- tests/driver/test_material_manifest.py | 13 ++- tests/driver/test_modal_launch.py | 16 +++- tests/driver/test_route_keywords.py | 10 ++- tests/output/test_modal_resume.py | 19 ++-- tests/output/test_record_arrays.py | 2 +- tests/processing/test_modal_metrics.py | 21 +++-- tests/record_routes.py | 9 +- tests/sessions/test_native_session_history.py | 11 ++- tests/test_benchmark_cases.py | 9 +- tests/test_benchmark_guides.py | 3 +- tests/translate/test_routes.py | 5 +- 26 files changed, 262 insertions(+), 78 deletions(-) diff --git a/benchmarks/builders.py b/benchmarks/builders.py index c4631b474..b7732ffb3 100644 --- a/benchmarks/builders.py +++ b/benchmarks/builders.py @@ -28,6 +28,7 @@ "soliton", "spatial", "spatial_grids", + "window", ] if TYPE_CHECKING: @@ -550,6 +551,66 @@ def _fibre_or_capillary( raise SuiteError(f"unknown builder {builder}") +def window(simulation: Simulation, stop: float, **settings: Any) -> Simulation: + """Return a case run to `stop`, m, with `settings` replaced. + + A run ends at its grid's length (SEP 51), so a shortened run (``ab --length``) is + the case rebuilt on its grid cut at `stop`, with everything the whole length set + carried over unchanged: the absorber's rates, the default steps and the profiles + already in the case's settings and simulation. At the case's own length the + settings are replaced on the case itself. + + Parameters + ---------- + simulation : solprop.driver.Simulation + The whole case, untranslated. + stop : float + Where the run ends, m, at most the case's length. + **settings : Any + Fields of :class:`~solprop.driver.SimulationSettings` to replace. + + Returns + ------- + solprop.driver.Simulation + The case, untranslated. + + Raises + ------ + SuiteError + When a shortened case was already translated, as a coupled launch is. + """ + from solprop.driver import Simulation # noqa: PLC0415 + + if stop >= simulation.grid.length: + simulation.settings = dataclasses.replace(simulation.settings, **settings) + return simulation + if simulation._problem is not None: + msg = "this case is translated at construction and runs only its whole length" + raise SuiteError(msg) + whole = simulation._base_grid + return Simulation( + dataclasses.replace(whole, length=stop), + simulation.modes, + simulation.responses, + simulation.initial, + settings=dataclasses.replace( + simulation.settings, **({"save_planes": []} | settings) + ), + noise=simulation.noise, + noise_resolution=simulation.noise_resolution, + profiles=simulation.profiles, + configuration=simulation.configuration, + spatial_grid=simulation.spatial_grid, + medium=simulation.medium, + frame=simulation.frame, + general=simulation.general, + guide=simulation.guide, + wall=simulation.wall, + taper_coupling=simulation.taper_coupling, + materials=simulation.materials, + ) + + def build(configuration: Record) -> Simulation: """Build a case for the configured backend, stepper and observations. @@ -580,7 +641,6 @@ def build(configuration: Record) -> Simulation: options = variant(configuration) if case.builder in ("kerr", "spatial"): settings = SimulationSettings( - save_planes=itinerary, dz_max=case.length, dz_init=case.length * 1e-4, auto_init=True, @@ -590,18 +650,29 @@ def build(configuration: Record) -> Simulation: field_planes=observed["field_planes"], node_budget=_node_budget(), ) + replay: dict[str, Any] = {} if case.step is not None: settings = dataclasses.replace( settings, integrator=LowStorageRungeKutta(scheme="rk4ip"), schedule=FixedSchedule( - np.diff(np.linspace(0.0, stop, max(1, round(stop / case.step)) + 1)) + np.diff( + np.linspace( + 0.0, case.length, max(1, round(case.length / case.step)) + 1 + ) + ) ), propagator_mode="tabulate", ) - if case.builder == "kerr": - return kerr(case.name, settings, options["fft_size"]) - return spatial(case.name, settings, options) + replay["schedule"] = FixedSchedule( + np.diff(np.linspace(0.0, stop, max(1, round(stop / case.step)) + 1)) + ) + whole = ( + kerr(case.name, settings, options["fft_size"]) + if case.builder == "kerr" + else spatial(case.name, settings, options) + ) + return window(whole, stop, save_planes=itinerary, **replay) if case.builder == "exercise": from benchmarks.exercises import exercise # noqa: PLC0415 @@ -615,7 +686,10 @@ def build(configuration: Record) -> Simulation: simulation = advanced(case.name, case.length, options) if case.name == "grin_nonlinear": # Translated at construction (its launch is coupled): only the backend - # and the field retention may still change. + # and the field retention may still change, so it runs whole. + if stop < case.length: + msg = "grin_nonlinear couples its launch at construction; run it whole" + raise SuiteError(msg) simulation.settings = dataclasses.replace( simulation.settings, backend=configuration["backend"], @@ -628,5 +702,4 @@ def build(configuration: Record) -> Simulation: if chosen is not None: observed["integrator"] = chosen observed["node_budget"] = _node_budget() # None: the translation's default - simulation.settings = dataclasses.replace(simulation.settings, **observed) - return simulation + return window(simulation, stop, **observed) diff --git a/benchmarks/guides.py b/benchmarks/guides.py index 6acd57bad..9756070cb 100644 --- a/benchmarks/guides.py +++ b/benchmarks/guides.py @@ -11,6 +11,7 @@ from __future__ import annotations +import dataclasses from collections.abc import Mapping from dataclasses import dataclass from types import MappingProxyType @@ -26,6 +27,7 @@ from solprop.constants import C from solprop.coupling import CouplingModel from solprop.driver import Simulation +from solprop.driver.settings import default_collar from solprop.grid import FieldGrid from solprop.modes import ( CoherentWall, @@ -308,11 +310,15 @@ def grin( q = float(grid.omega[centre]) / C * radius * 1.45 beta = np.sqrt(q * q - 2 * q * np.sqrt(2 * contrast) * np.array([1, 3])) / radius length = float(2 * np.pi / (beta[0] - beta[1])) + # A run ends at its grid's length (SEP 51): the millimetre grid the guide was + # sampled for is cut at the beat length, and keeps the collar the millimetre gave. + whole, grid = grid, dataclasses.replace(grid, length=length) simulation = Simulation.from_waveguide( (), length, provider=guide, grid=grid, + absorber=default_collar(whole), wavelength=wavelength, fwhm=40e-15, energy=1e-15, diff --git a/benchmarks/sessions.py b/benchmarks/sessions.py index 0e4692474..13b0d45cd 100644 --- a/benchmarks/sessions.py +++ b/benchmarks/sessions.py @@ -34,7 +34,7 @@ import numpy as np -from benchmarks.builders import SOLITON_PEAK, SOLITON_WIDTH, soliton +from benchmarks.builders import SOLITON_PEAK, SOLITON_WIDTH, soliton, window from benchmarks.records import Record, SuiteError from benchmarks.registry import CASES from solprop.driver import Simulation @@ -100,13 +100,16 @@ def fibre( extra["integrator"] = Multistep() if name.endswith("adams") else RungeKutta() if case.snapshots is not None: extra["step_planes"] = 1 + replay: dict[str, Any] = {} if case.step is not None: - extra["schedule"] = FixedSchedule.uniform( + replay["schedule"] = FixedSchedule.uniform( 0.0, stop, case.step, save_planes=itinerary ) # The in-stage collar is stable only up to 0.42 mm steps on this window. extra["absorber_scheme"] = "split_step" - return soliton(case.length, options, save_planes=itinerary, **extra) + # The case over its length, then run to `stop` on its grid cut there (SEP 51). + whole = soliton(case.length, options, **extra) + return window(whole, stop, save_planes=itinerary, **replay) class _Steps(NullReporter): diff --git a/tests/backends/adams_source_cases.py b/tests/backends/adams_source_cases.py index 564386b13..8e2b6c737 100644 --- a/tests/backends/adams_source_cases.py +++ b/tests/backends/adams_source_cases.py @@ -16,6 +16,7 @@ import numpy as np from backends.matched import fixed_order +from builders import grid_at, held_collar from parity_ladder import Built from solprop.driver.simulation import Simulation from solprop.grid import EnvelopeGrid, FieldGrid @@ -47,11 +48,14 @@ def source_case(route, length, **settings): temporal collar. """ limits = (0.01, 800e-9, (200e-9, 2e-6), 100e-15) - grid = ( + window = ( EnvelopeGrid.from_limits(*limits, thg=False) if route.get("envelope") else FieldGrid.from_limits(*limits) ) + # A run ends at its grid's length (SEP 51): the grid is cut at the run's length, + # with the collar the centimetre window gave. + grid = grid_at(window, length) simulation = Simulation.from_capillary( 150e-6, length, @@ -61,6 +65,7 @@ def source_case(route, length, **settings): fwhm=10e-15, energy=5e-5, grid=grid, + absorber=held_collar(grid, window.length), n_save=2, noise=None, integrator=Multistep(formulation="interaction"), diff --git a/tests/backends/dispersive_rows.py b/tests/backends/dispersive_rows.py index a607460a7..fe2967f6d 100644 --- a/tests/backends/dispersive_rows.py +++ b/tests/backends/dispersive_rows.py @@ -306,9 +306,9 @@ def multimode_capillary_rows(evaluator: str) -> Iterator[Row]: capillary, evaluator, stepped=True, - n_save=None, integrator=RungeKutta(), - save_planes=[LENGTH / STEPS], + # The rung takes the schedule's first step alone; the run records + # the whole replayed schedule, which ends at its length (SEP 51). **grid, ), rungs={"one_step": one_step_of(capillary_evaluation)}, diff --git a/tests/backends/general_rows.py b/tests/backends/general_rows.py index 331f8018a..0c58e3ad3 100644 --- a/tests/backends/general_rows.py +++ b/tests/backends/general_rows.py @@ -82,6 +82,7 @@ from backends.flow_rows import driver_case from backends.session_rows import without_collar, without_modal_flow +from builders import grid_at, held_collar from general_parity import ( LENGTH, STEPS, @@ -207,7 +208,11 @@ def entry_simulation(noise: str | None = "input", **keywords: Any) -> Simulation ``numba_cpu``'s retired entry-point test, on its input: a 20 fs, 20 pJ Gaussian with an input shot-noise draw (seed 5) by default; `keywords` go to the constructor. """ - grid, guide, _, _ = _scaled("pair") + window, guide, _, _ = _scaled("pair") + # A run ends at its grid's length (SEP 51): the grid is cut at the entry point's + # run, with the collar the millimetre gave. + grid = grid_at(window, ENTRY_LENGTH) + keywords = {"absorber": held_collar(grid, window.length), **keywords} return Simulation.from_waveguide( (), ENTRY_LENGTH, diff --git a/tests/backends/test_far_field_statistics.py b/tests/backends/test_far_field_statistics.py index 91eb4bcc8..ebab17e59 100644 --- a/tests/backends/test_far_field_statistics.py +++ b/tests/backends/test_far_field_statistics.py @@ -20,6 +20,7 @@ from backends.planar_cases import planar_case from bounds import EPS, assert_within, gamma +from builders import grid_at from legacy_geometry import bare_absorber from sessions.runs import launch_statistics from solprop.backends import registry, select @@ -102,8 +103,11 @@ def free_simulation(grid, space, launch, *, medium=None, spec=None, **settings): "stats": far_spec() if spec is None else spec, } options.update(settings) + # A run ends at its grid's length (SEP 51): the run's grid is the fixture's cut at + # the last plane, while every collar is the fixture grid's own, so the rates the + # millimetre gave are kept. return Simulation.from_free( - grid, + grid_at(grid, float(np.max(options["save_planes"]))), space, SpatialMedium() if medium is None else medium, [], @@ -214,7 +218,7 @@ def test_the_bands_follow_the_shapes_and_the_budget(monkeypatch): def test_a_radial_problem_takes_no_partials(grid): radial = Simulation.from_free( - grid, + grid_at(grid, 1e-4), RadialGrid(3e-4, 8), SpatialMedium(), [], @@ -668,7 +672,7 @@ def test_the_operator_refuses_a_share_above_the_total(grid, lossy_launch): def test_radial_and_planar_geometry_are_refused_before_any_step(grid): spec = StatsSpec(names=("energy", "beam_spectrum")) radial = Simulation.from_free( - grid, + grid_at(grid, 1e-4), RadialGrid(3e-4, 16), SpatialMedium(), [], diff --git a/tests/backends/test_native_far_field.py b/tests/backends/test_native_far_field.py index de1586453..689dba8ed 100644 --- a/tests/backends/test_native_far_field.py +++ b/tests/backends/test_native_far_field.py @@ -40,6 +40,7 @@ from backends.forced_threads import assert_threaded from backends.matched import native_thread_fields from bounds import assert_within, gamma +from builders import grid_at from sessions.executors import IDENTITY from sessions.runs import launched, load_native from solprop.backends import select @@ -85,8 +86,10 @@ def problem_of( boundary=None, ): """The kernel problem of one state and its statistics, for Kokkos.""" + # A run ends at its grid's length (SEP 51): the run's grid is cut at its plane, + # and the collar is the given grid's own, so its rates are kept. simulation = Simulation.from_free( - grid, + grid_at(grid, 1e-4), space, SpatialMedium(1 + 1e-6j) if medium is None else medium, [], @@ -762,7 +765,8 @@ def test_a_native_run_forms_the_statistics_at_planes_and_between_them(): def simulation_on(backend): return Simulation.from_free( - grid, + # Cut at the last plane (SEP 51); the collar keeps the full grid's rates. + grid_at(grid, 2e-4), space, SpatialMedium(1 + 1e-6j), [], diff --git a/tests/backends/test_planar_hybrid.py b/tests/backends/test_planar_hybrid.py index 2c7f68477..13fe75ba6 100644 --- a/tests/backends/test_planar_hybrid.py +++ b/tests/backends/test_planar_hybrid.py @@ -27,7 +27,7 @@ from backends.planar_hybrid_cases import ENVELOPE, FAMILIES, HALF_GAP, LENGTH, ORDERS from backends.rate_bounds import rate_error_bound from bounds import fft_bound, gamma, step_evaluations -from builders import load_reference +from builders import grid_at, load_reference from legacy_geometry import bare_absorber from sessions.runs import bare, final_field from sessions.runs import run as session_run @@ -342,6 +342,8 @@ def test_a_linear_beam_diffracts_in_y_and_decays_as_each_slab_mode(): backend="numpy_ref", absorber=bare_absorber(grid), ) + # A run ends at its grid's length (SEP 51); the bare collar has no length. + grid = grid_at(grid, length) hybrid = Simulation.from_planar(grid, space, [], field0, settings=settings) problem, run_request = hybrid.translate(), hybrid._run_request() backend = NumpyRefBackend(problem, run_request, grid=grid) @@ -487,6 +489,8 @@ def test_the_planar_launch_carries_the_coupled_share_of_the_incident_energy(): stats=spec, absorber=bare_absorber(grid), ) + # A run ends at its grid's length (SEP 51); the bare collar has no length. + grid = grid_at(grid, 1e-3) simulation = Simulation.from_planar(grid, space, [], pulse, settings=settings) problem = simulation.translate() run_request = simulation._run_request() diff --git a/tests/coupled_flow_cases.py b/tests/coupled_flow_cases.py index 34bce9fe6..38a21f62c 100644 --- a/tests/coupled_flow_cases.py +++ b/tests/coupled_flow_cases.py @@ -30,6 +30,7 @@ import numpy as np import pytest +from builders import grid_at from flow_parity import formation_bound, radial_family from legacy_geometry import LEGACY_GRID from modal_provider_cases import ( @@ -520,7 +521,9 @@ def wide_simulation(modes: int, backend: str = "numpy_ref") -> Simulation: cladding=1.45, modes=modes, wavelength=800e-9, - grid=GRID, + # A run ends at its grid's length (SEP 51): the shared grid cut at the wide + # run's; the collar is pinned already. + grid=grid_at(GRID, length), absorber=WEAK_COLLAR, fwhm=30e-15, energy=ENERGY, diff --git a/tests/coupling/test_vector_coupling.py b/tests/coupling/test_vector_coupling.py index a8af42755..8e4f269c2 100644 --- a/tests/coupling/test_vector_coupling.py +++ b/tests/coupling/test_vector_coupling.py @@ -20,6 +20,7 @@ import numpy as np import pytest +from builders import held_collar from modal_provider_cases import GENERAL_Z_END, general_grid, general_guide from solprop.constants import C from solprop.coupling import ( @@ -75,8 +76,8 @@ def strand(grid, descriptors=PARITIES[:1], blocks=(), n_r=24, circular=None): @pytest.fixture(scope="module") def grid(): - """The general modal tests' field grid.""" - return general_grid() + """The general modal tests' field grid, at the tenth of a millimetre they run.""" + return general_grid(GENERAL_Z_END / 10) def simulation(guide, grid): @@ -94,6 +95,8 @@ def simulation(guide, grid): dz_max=GENERAL_Z_END / 20, dz_init=GENERAL_Z_END / 20, n_save=2, + # The collar of the millimetre grid these tests were written on (SEP 51). + absorber=held_collar(grid, GENERAL_Z_END), noise=None, ) diff --git a/tests/coupling/test_workflows.py b/tests/coupling/test_workflows.py index 1818df478..3c9203e1e 100644 --- a/tests/coupling/test_workflows.py +++ b/tests/coupling/test_workflows.py @@ -29,6 +29,7 @@ from scipy.integrate import quad from scipy.special import j0, jn_zeros, k0 +from builders import grid_at, held_collar from legacy_geometry import LEGACY_GRID from solprop import fourier from solprop.backends.registry import available @@ -245,13 +246,17 @@ def test_a_kerr_prepared_radial_beam_into_a_capillary(): dz_init=gap / 10, backend="numpy_ref", ) + # The receiver ends at its grid's length (SEP 51): the gap's grid cut at the + # capillary's 2 mm, with the collar the gap's grid gave. + receiver_grid = grid_at(grid, 2e-3) receiver = Simulation.from_capillary( 75e-6, 2e-3, "Ar", PRESSURE, wavelength=800e-9, - grid=grid, + grid=receiver_grid, + absorber=held_collar(receiver_grid, gap), modes=4, plasma=False, thg=False, @@ -349,13 +354,17 @@ def test_a_field_grid_kerr_plasma_thg_entrance_is_transferred_with_its_harmonic( start.spectral_energy(), start.omega, *harmonic ) assert 5e-8 < generated < 1.2e-7 + # The receiver ends at its grid's length (SEP 51): the gap's grid cut at the + # capillary's millimetre, with the collar the gap's grid gave. + receiver_grid = grid_at(grid, 1e-3) receiver = Simulation.from_capillary( 75e-6, 1e-3, "Ar", 1.0, wavelength=800e-9, - grid=grid, + grid=receiver_grid, + absorber=held_collar(receiver_grid, gap), modes=4, plasma=False, noise=None, diff --git a/tests/driver/test_backend_default.py b/tests/driver/test_backend_default.py index 3d41ee77c..65cd4c174 100644 --- a/tests/driver/test_backend_default.py +++ b/tests/driver/test_backend_default.py @@ -15,6 +15,7 @@ import numpy as np import pytest +from builders import grid_at from legacy_geometry import LEGACY_GRID from solprop.backends.registry import select from solprop.driver import ( @@ -95,6 +96,8 @@ def run(simulation, *args, **kwargs): return output monkeypatch.setattr(Simulation, "run", run) + # Nothing runs: the grid is the millimetre the calls ask for (SEP 51). + narrow_grid = grid_at(narrow_grid, 0.001) keywords: _BackendChoice = {"backend": "numpy_ref"} if explicit else {} with warnings.catch_warnings(): warnings.simplefilter("ignore", MaterialRangeWarning) diff --git a/tests/driver/test_coherent_capillary.py b/tests/driver/test_coherent_capillary.py index 67903ad7a..e3c67281c 100644 --- a/tests/driver/test_coherent_capillary.py +++ b/tests/driver/test_coherent_capillary.py @@ -770,10 +770,11 @@ def test_a_wall_declared_on_another_route_is_refused_by_name(): spatial.wall = CoherentWall() with pytest.raises(TranslationError, match="a spatial geometry"): spatial.translate() - grid = general_grid() + # Refused before any step: the grid is the tenth it would run (SEP 51). + grid = general_grid(GENERAL_Z_END / 10) general = Simulation.from_waveguide( (), - GENERAL_Z_END, + GENERAL_Z_END / 10, provider=general_guide(grid=grid), grid=grid, wavelength=835e-9, diff --git a/tests/driver/test_general_modal.py b/tests/driver/test_general_modal.py index 4dd83c7eb..d48f26e14 100644 --- a/tests/driver/test_general_modal.py +++ b/tests/driver/test_general_modal.py @@ -33,7 +33,7 @@ from numpy.testing import assert_allclose from bounds import departure -from builders import load_reference +from builders import grid_at, held_collar, load_reference from legacy_geometry import LEGACY_GRID from march_bounds import ( FIXED_ORDER, @@ -103,12 +103,17 @@ pytestmark = pytest.mark.filterwarnings("ignore::solprop.exceptions.BoundaryWarning") PULSE = {"wavelength": 835e-9, "fwhm": 20e-15, "energy": 1e-12, "shape": "gauss"} +SHORT_Z = GENERAL_Z_END / 10 +"""Length the construction tests run, m: a tenth of the cap.""" + RUN = { # A tenth of a millimetre in two steps: these tests are about construction, # the launch, the refusals and the identity of a repeated draw, and none of # them needs a long propagation. The two end-to-end systems below take the - # whole millimetre. - "save_planes": [GENERAL_Z_END / 10], + # whole millimetre. A run ends at its grid's length (SEP 51), so the grid is the + # tenth, with the collar the millimetre gave. + "save_planes": [SHORT_Z], + "absorber": held_collar(general_grid(SHORT_Z), GENERAL_Z_END), "backend": "numpy_ref", "dz_max": GENERAL_Z_END / 20, "dz_init": GENERAL_Z_END / 20, @@ -123,8 +128,8 @@ def kept(field: np.ndarray | None) -> np.ndarray: @pytest.fixture(scope="module") def grid(): - """The field grid the construction tests use.""" - return general_grid() + """The field grid the construction tests use: the tenth of a millimetre they run.""" + return general_grid(SHORT_Z) @pytest.fixture(scope="module") @@ -147,7 +152,7 @@ def build(guide, grid, **overrides): """Return a general modal simulation on this guide and grid.""" return Simulation.from_waveguide( (), - GENERAL_Z_END, + SHORT_Z, provider=guide, grid=grid, **({"integrator": Multistep(), **({"noise": None, **PULSE | RUN | overrides})}), @@ -175,7 +180,7 @@ def test_a_provider_builds_a_simulation_that_translates_to_the_general_route( assert ( Simulation.from_waveguide( list(guide.mode_collection.modes), - GENERAL_Z_END, + SHORT_Z, provider=guide, grid=grid, **({"integrator": Multistep(), **({"noise": None, **PULSE | RUN})}), @@ -319,7 +324,7 @@ def test_modes_of_ones_own_are_refused_beside_a_guide(guide, grid): with pytest.raises(DriverError, match="supplies its own 1 ordered channel"): Simulation.from_waveguide( list(other.mode_collection.modes), - GENERAL_Z_END, + SHORT_Z, provider=guide, grid=grid, **({"integrator": Multistep(), **({"noise": None, **PULSE | RUN})}), @@ -327,7 +332,7 @@ def test_modes_of_ones_own_are_refused_beside_a_guide(guide, grid): def test_an_envelope_grid_is_refused_at_the_entry_point(guide): - envelope = EnvelopeGrid.from_limits(GENERAL_Z_END, 835e-9, (815e-9, 860e-9), 60e-15) + envelope = EnvelopeGrid.from_limits(SHORT_Z, 835e-9, (815e-9, 860e-9), 60e-15) with pytest.raises(DriverError, match="propagates on a field grid"): build(guide, envelope) @@ -365,7 +370,7 @@ def test_the_route_constructors_refusals_reach_the_caller_as_driver_errors(grid) with pytest.raises(DriverError, match="declares no sampling") as caught: Simulation.from_waveguide( (), - GENERAL_Z_END, + SHORT_Z, provider=unsampled, grid=grid, **({"integrator": Multistep(), **({"noise": None, **PULSE | RUN})}), @@ -581,7 +586,7 @@ def launched(guide, grid, incident, **overrides): """Return a general modal simulation coupling an incident beam.""" return Simulation.from_waveguide( (), - GENERAL_Z_END, + None, provider=guide, grid=grid, wavelength=PULSE["wavelength"], @@ -751,7 +756,7 @@ def test_the_incident_launch_refuses_what_it_does_not_carry( with pytest.raises(DriverError, match="incident= belongs to the general modal"): Simulation.from_waveguide( (MarcatiliMode(125e-6, "He", 1.0),), - GENERAL_Z_END, + SHORT_Z, gas="He", pressure=1.0, grid=grid, @@ -831,7 +836,7 @@ def test_a_poorly_captured_beam_launches_only_what_the_guide_takes( "MemoryOutput", prop_waveguide( (), - GENERAL_Z_END, + SHORT_Z, provider=incident_guide, grid=grid, wavelength=PULSE["wavelength"], @@ -877,7 +882,8 @@ def test_the_incident_launch_is_the_same_on_every_cpu_receiver( step = 5e-7 simulation = launched( incident_guide, - grid, + # Ten steps on a grid of their length (SEP 51), the collar still the run's. + grid_at(grid, 10 * step), beam, backend=backend, save_planes=[10 * step], @@ -904,7 +910,7 @@ def test_a_multichannel_input_is_refused_by_the_launch(pair_guide, grid): both = np.repeat(simulation._field0[:1], 2, axis=0) carried = Simulation.from_waveguide( (), - GENERAL_Z_END, + SHORT_Z, provider=pair_guide, grid=grid, **({"integrator": Multistep(), **({"noise": None, **PULSE | RUN})}), @@ -1201,7 +1207,7 @@ def test_an_hdf5_file_carries_the_labels_and_the_identities(guide, grid, tmp_pat # ------------------------------------------------------------ a fixed schedule -FIXED_Z = GENERAL_Z_END / 10 +FIXED_Z = SHORT_Z """Length a fixed-schedule general modal test propagates, m: a tenth of the cap.""" @@ -1218,11 +1224,12 @@ def fixed_run(guide, grid, **overrides): # march (SEP 25 4.4). "integrator": FIXED_ORDER, "save_planes": [FIXED_Z], + "absorber": RUN["absorber"], "backend": "numpy_ref", } simulation = Simulation.from_waveguide( (), - GENERAL_Z_END, + SHORT_Z, provider=guide, grid=grid, **({"integrator": Multistep(), **({"noise": None, **settings | overrides})}), @@ -1910,7 +1917,7 @@ def test_the_collar_and_not_the_route_sets_the_step_on_every_route(): for collar in (True, False): simulation = Simulation.from_capillary( 50e-6, - GENERAL_Z_END, + SHORT_Z, "Ar", 1.0, grid=grid, diff --git a/tests/driver/test_material_manifest.py b/tests/driver/test_material_manifest.py index b0b309a63..35dac827e 100644 --- a/tests/driver/test_material_manifest.py +++ b/tests/driver/test_material_manifest.py @@ -18,6 +18,7 @@ import pytest from optmat.gas.models.registry import default_model +from builders import grid_at, held_collar from former_raman import FORMER_SILICA_TENSOR from modal_provider_cases import ( GENERAL_CHI3, @@ -697,12 +698,18 @@ def test_a_derived_run_keeps_its_own_log_from_its_parents(): def general(guide, grid, materials: MaterialSelection | None = SELECTION) -> Any: - """A general modal run of `guide`, a tenth of a millimetre in two steps.""" + """A general modal run of `guide`, a tenth of a millimetre in two steps. + + A run ends at its grid's length (SEP 51): the grid is cut at that tenth, with the + collar the full grid gave. + """ + short = grid_at(grid, GENERAL_Z_END / 10) return Simulation.from_waveguide( (), - GENERAL_Z_END, + GENERAL_Z_END / 10, provider=guide, - grid=grid, + grid=short, + absorber=held_collar(short, grid.length), wavelength=835e-9, fwhm=20e-15, energy=1e-12, diff --git a/tests/driver/test_modal_launch.py b/tests/driver/test_modal_launch.py index df4643440..75bcd6d78 100644 --- a/tests/driver/test_modal_launch.py +++ b/tests/driver/test_modal_launch.py @@ -17,12 +17,14 @@ import pytest from numpy.testing import assert_allclose +from builders import grid_at, held_collar from modal_provider_cases import GENERAL_Z_END, general_grid, general_guide from solprop import fourier from solprop.backends import available from solprop.coupling import CouplingModel from solprop.driver import Simulation from solprop.driver._launch import _resolve_launch, launch_pulse +from solprop.driver.defaults import default_step from solprop.exceptions import DriverError, OutputError from solprop.modes import MarcatiliMode from solprop.modes.collection import ModeCollection @@ -103,14 +105,20 @@ def circular_guide(grid): def general(guide, grid, **overrides): - """Return a general modal simulation on a guide.""" + """Return a general modal simulation on a guide. + + A run ends at its grid's length (SEP 51): the grid is cut at the tenth of a + millimetre it runs, with the collar and the largest step the millimetre gave. + """ + short = grid_at(grid, GENERAL_Z_END / 10) return Simulation.from_waveguide( (), - GENERAL_Z_END, + GENERAL_Z_END / 10, provider=guide, - grid=grid, + grid=short, + absorber=held_collar(short, grid.length), + dz_max=default_step("dz_max", grid.length), noise=None, - save_planes=[GENERAL_Z_END / 10], backend="numpy_ref", **PULSE | overrides, ) diff --git a/tests/driver/test_route_keywords.py b/tests/driver/test_route_keywords.py index af9d5f2f5..c7dbf99fe 100644 --- a/tests/driver/test_route_keywords.py +++ b/tests/driver/test_route_keywords.py @@ -20,6 +20,7 @@ import pytest from numpy.testing import assert_array_equal +from builders import grid_at, held_collar from modal_provider_cases import GENERAL_Z_END, general_grid, general_guide from solprop.driver import ( Simulation, @@ -75,13 +76,16 @@ def guide(grid): def general(guide, grid, **overrides): + # A run ends at its grid's length (SEP 51): the grid is cut at the tenth it runs, + # with the collar the millimetre gave. + short = grid_at(grid, GENERAL_Z_END / 10) return Simulation.from_waveguide( (), - GENERAL_Z_END, + GENERAL_Z_END / 10, provider=guide, - grid=grid, + grid=short, + absorber=held_collar(short, grid.length), noise=None, - save_planes=[GENERAL_Z_END / 10], backend="numpy_ref", dz_max=GENERAL_Z_END / 40, **PULSE | overrides, diff --git a/tests/output/test_modal_resume.py b/tests/output/test_modal_resume.py index c4be1416a..c85f4c670 100644 --- a/tests/output/test_modal_resume.py +++ b/tests/output/test_modal_resume.py @@ -20,6 +20,7 @@ import numpy as np import pytest +from builders import held_collar from driver.test_resume import read_file, run_until from march_bounds import FIXED_ORDER, assert_stored_matched, simulation_bound from modal_provider_cases import ( @@ -71,10 +72,16 @@ """Every row `RunMetadata._describe` adds for a general modal identity.""" PULSE = {"wavelength": 835e-9, "fwhm": 20e-15, "energy": 1e-12, "shape": "gauss"} +SHORT_Z = GENERAL_Z_END / 10 +"""Length these runs propagate, m: a tenth of the cap.""" + RUN = { # Two steps over a tenth of a millimetre. A resume is an identity statement - # and needs no more; the route's arithmetic is qualified elsewhere. - "save_planes": [GENERAL_Z_END / 20, GENERAL_Z_END / 10], + # and needs no more; the route's arithmetic is qualified elsewhere. A run ends at + # its grid's length (SEP 51), so the grid is that tenth, with the collar the + # millimetre gave. + "save_planes": [GENERAL_Z_END / 20, SHORT_Z], + "absorber": held_collar(general_grid(SHORT_Z), GENERAL_Z_END), "backend": "numpy_ref", "dz_max": GENERAL_Z_END / 40, "dz_init": GENERAL_Z_END / 40, @@ -101,8 +108,8 @@ def at(record, *keys) -> Any: @pytest.fixture(scope="module") def grid(): - """The field grid these runs are on.""" - return general_grid() + """The field grid these runs are on: the tenth of a millimetre they run.""" + return general_grid(SHORT_Z) @pytest.fixture(scope="module") @@ -115,7 +122,7 @@ def build(guide, grid, **overrides): """Return a general modal simulation on this guide and grid.""" return Simulation.from_waveguide( (), - GENERAL_Z_END, + SHORT_Z, provider=guide, grid=grid, **({"noise": None, **PULSE | RUN | overrides}), @@ -449,7 +456,7 @@ def scheduled(guide, grid): planes = [length / 2, length] simulation = Simulation.from_waveguide( (), - GENERAL_Z_END, + SHORT_Z, provider=guide, grid=grid, **( diff --git a/tests/output/test_record_arrays.py b/tests/output/test_record_arrays.py index 7fab3299b..905e15446 100644 --- a/tests/output/test_record_arrays.py +++ b/tests/output/test_record_arrays.py @@ -409,7 +409,7 @@ def test_a_plane_exports_from_a_file_through_the_stored_flux_plan(tmp_path): def test_a_noise_realisation_travels_beside_the_record(tmp_path): - grid = EnvelopeGrid.from_limits(1e-5, 800e-9, (700e-9, 900e-9), 100e-15, thg=False) + grid = EnvelopeGrid.from_limits(0.01, 800e-9, (700e-9, 900e-9), 100e-15, thg=False) simulation = Simulation.from_gnlse( 0.11, 0.01, diff --git a/tests/processing/test_modal_metrics.py b/tests/processing/test_modal_metrics.py index cf8cd3ab3..b0e4f3044 100644 --- a/tests/processing/test_modal_metrics.py +++ b/tests/processing/test_modal_metrics.py @@ -29,6 +29,7 @@ import pytest from numpy.testing import assert_allclose +from builders import held_collar from legacy_geometry import LEGACY_GRID from modal_provider_cases import GENERAL_Z_END, general_grid, general_guide from sessions.runs import run as run_session @@ -68,11 +69,17 @@ pytestmark = pytest.mark.filterwarnings("ignore::solprop.exceptions.BoundaryWarning") PULSE = {"wavelength": 835e-9, "fwhm": 20e-15, "energy": 1e-12, "shape": "gauss"} +SHORT_Z = GENERAL_Z_END / 10 +"""Length these runs propagate, m: a tenth of the cap.""" + RUN = { # Two steps over a tenth of a millimetre: a reconstruction is made on one # saved plane and needs no propagation at all, and the route's arithmetic is # qualified end to end in tests/driver/test_general_modal.py. - "save_planes": [GENERAL_Z_END / 10], + # A run ends at its grid's length (SEP 51), so the grid is that tenth, with the + # collar the millimetre gave. + "save_planes": [SHORT_Z], + "absorber": held_collar(general_grid(SHORT_Z), GENERAL_Z_END), "backend": "numpy_ref", "dz_max": GENERAL_Z_END / 20, "dz_init": GENERAL_Z_END / 20, @@ -90,8 +97,8 @@ @pytest.fixture(scope="module") def grid(): - """The field grid these runs are on.""" - return general_grid() + """The field grid these runs are on: the tenth of a millimetre they run.""" + return general_grid(SHORT_Z) @pytest.fixture(scope="module") @@ -113,8 +120,8 @@ def pair_guide(grid): def route_for(guide, grid): """Return the route a run of these tests builds, rebuilt from the guide. - `_from_general` passes the **last save plane** as `z_max`, so a - caller rebuilding the reference for a reconstruction passes the same: the + `_from_general` passes the run's length, its **last save plane**, as `z_max`, + so a caller rebuilding the reference for a reconstruction passes the same: the tables' `z_span` is part of their identity and a different one is refused by name, which is the point of the check. """ @@ -136,7 +143,7 @@ def tables(guide, grid): def run(guide, grid): """One general modal run, in memory, with its two saved planes.""" simulation = Simulation.from_waveguide( - (), GENERAL_Z_END, provider=guide, grid=grid, **({"noise": None, **PULSE | RUN}) + (), SHORT_Z, provider=guide, grid=grid, **({"noise": None, **PULSE | RUN}) ) return cast("MemoryOutput", simulation.run(progress="none")) @@ -362,7 +369,7 @@ def test_a_coordinate_intensity_is_not_the_physical_one(pair_guide, grid): route = route_for(pair_guide, grid) simulation = Simulation.from_waveguide( (), - GENERAL_Z_END, + SHORT_Z, provider=pair_guide, grid=grid, **({"noise": None, **PULSE | RUN}), diff --git a/tests/record_routes.py b/tests/record_routes.py index 3b28e16ca..70bbde2cd 100644 --- a/tests/record_routes.py +++ b/tests/record_routes.py @@ -13,6 +13,7 @@ import warnings from collections.abc import Callable +from builders import grid_at, held_collar from modal_provider_cases import general_grid, general_guide from solprop.boundaries import absorber from solprop.driver import Simulation, SimulationSettings @@ -118,12 +119,16 @@ def cartesian() -> Simulation: def general() -> Simulation: """Return a general modal run on a provider's guide.""" - grid = general_grid() + window = general_grid() + # A run ends at its grid's length (SEP 51): the millimetre grid cut at the run's + # tenth, with the collar the millimetre gave. + grid = grid_at(window, 1e-4) return Simulation.from_waveguide( (), 1e-4, - provider=general_guide(grid=grid), + provider=general_guide(grid=window), grid=grid, + absorber=held_collar(grid, window.length), fwhm=30e-15, energy=1e-9, wavelength=800e-9, diff --git a/tests/sessions/test_native_session_history.py b/tests/sessions/test_native_session_history.py index b945fec00..8db33a048 100644 --- a/tests/sessions/test_native_session_history.py +++ b/tests/sessions/test_native_session_history.py @@ -26,6 +26,7 @@ import numpy as np import pytest +from builders import grid_at, held_collar from sessions.executors import ( IDENTITY, PLANES, @@ -553,10 +554,16 @@ def _noisy(noise: Any, *, check: bool, march: str = "adams") -> Any: from solprop.pulses import SechPulse # noqa: PLC0415 - beside its one use from solprop.stepper import LowStorageRungeKutta # noqa: PLC0415 - grid = window() - method: dict[str, Any] = {"integrator": Multistep()} + # A run ends at its grid's length (SEP 51): the metre window cut at the run's + # length, with the collar the metre gave. + grid = grid_at(window(), LENGTH) + method: dict[str, Any] = { + "integrator": Multistep(), + "absorber": held_collar(grid, window().length), + } if march == "low-storage": method = { + "absorber": method["absorber"], "integrator": LowStorageRungeKutta(), "schedule": FixedSchedule.uniform( 0.0, LENGTH, LENGTH / 80, save_planes=list(PLANES) diff --git a/tests/test_benchmark_cases.py b/tests/test_benchmark_cases.py index e06f036ab..62e125dc7 100644 --- a/tests/test_benchmark_cases.py +++ b/tests/test_benchmark_cases.py @@ -71,7 +71,14 @@ def test_runs_save_evenly_to_their_stop_and_a_fraction_stops_early(): ) short = build(configuration("argon_blueshift", fraction=0.25)) assert short.settings.save_planes[-1] == pytest.approx(case.length / 4) - assert short.grid.length == case.length + # A run ends at its grid's length (SEP 51): the shortened case is the whole one on + # its grid cut at the stop, its collar and steps those of the whole length. + assert short.grid.length == short.settings.save_planes[-1] + assert full.settings.absorber is not None and short.settings.absorber is not None + assert short.settings.absorber.reference_length == ( + full.settings.absorber.reference_length + ) + assert short.settings.dz_max == full.settings.dz_max def test_fixed_step_cases_run_their_schedule_and_refuse_overrides(): diff --git a/tests/test_benchmark_guides.py b/tests/test_benchmark_guides.py index 6b7265f2c..71747ee41 100644 --- a/tests/test_benchmark_guides.py +++ b/tests/test_benchmark_guides.py @@ -47,7 +47,8 @@ def test_wall_cases_keep_full_profiles(name): def test_linear_grin_launch_is_configurable_before_translation(stepper): case = CASES["grin_linear"] simulation = build(configuration("grin_linear", stepper)) - assert simulation.grid.length == 1e-3 + # The millimetre grid cut at the beat length the run ends at (SEP 51). + assert simulation.grid.length == case.length waveguide = simulation.configuration["waveguide"] assert isinstance(waveguide, dict) assert waveguide["length"] == case.length diff --git a/tests/translate/test_routes.py b/tests/translate/test_routes.py index bc4f223eb..071f7951b 100644 --- a/tests/translate/test_routes.py +++ b/tests/translate/test_routes.py @@ -96,10 +96,11 @@ def spatial(kind): def general(): """A general modal guide: the general route.""" - grid = general_grid() + # Translated, not run: the grid is the tenth it would run (SEP 51). + grid = general_grid(GENERAL_Z_END / 10) return Simulation.from_waveguide( (), - GENERAL_Z_END, + GENERAL_Z_END / 10, provider=general_guide(grid=grid), grid=grid, noise=None, From 7e2d25f9625f8c4c8f75e4a2d0c98a10bbb03c98 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 02:14:19 +0000 Subject: [PATCH 06/20] Test SEP 51's rule and type the now-optional save planes tests/driver/test_save_planes.py covers the refusal table, placement and endpoint rounding, count/positions parity, interior launches, with_input, adoption and reuse, the length/grid table and replay. A recipe with neither length nor grid is refused before the route is called. Refusal messages print plain floats, a NumPy integer is a count, and readers of settings.save_planes, which may now be None before adoption, convert it. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- benchmarks/sessions.py | 2 +- src/solprop/driver/_scan_run.py | 4 +- src/solprop/driver/interface.py | 2 +- src/solprop/driver/settings.py | 32 +- src/solprop/recipe/core.py | 6 + tests/calibration/test_refine.py | 2 +- tests/driver/test_estimate.py | 4 +- tests/driver/test_interface_defaults.py | 2 +- tests/driver/test_runner.py | 12 +- tests/driver/test_save_planes.py | 357 +++++++++++++++++++ tests/driver/test_scan_worker_validation.py | 2 +- tests/driver/test_sep12_sep14_integration.py | 2 +- tests/driver/test_taper_coupling.py | 6 +- tests/driver/test_tdse_entry.py | 13 +- tests/output/test_callback.py | 8 +- tests/recipe/test_pins.py | 2 +- tests/recipe/test_provenance.py | 2 +- tests/recipe/test_save_planes.py | 26 +- tests/test_benchmark_cases.py | 7 +- 19 files changed, 441 insertions(+), 50 deletions(-) create mode 100644 tests/driver/test_save_planes.py diff --git a/benchmarks/sessions.py b/benchmarks/sessions.py index 13b0d45cd..f6025f7d6 100644 --- a/benchmarks/sessions.py +++ b/benchmarks/sessions.py @@ -241,7 +241,7 @@ def repetition( record = { "accepted": sum(run.accepted for run in watch.runs), "rejected": sum(run.rejected for run in watch.runs), - "z": float(simulation.settings.save_planes[-1]), + "z": float(np.asarray(simulation.settings.save_planes)[-1]), "runs": len(SCALES), "finite": None if None in finite else all(finite), } diff --git a/src/solprop/driver/_scan_run.py b/src/solprop/driver/_scan_run.py index 108a57db2..384843812 100644 --- a/src/solprop/driver/_scan_run.py +++ b/src/solprop/driver/_scan_run.py @@ -161,7 +161,7 @@ def __init__( """Initialize the declared scan component.""" super().__init__(block=1) self.options = options - self.count = len(simulation.settings.save_planes) + 1 + self.count = len(np.asarray(simulation.settings.save_planes)) + 1 problem = simulation.translate() self._field_shape = tuple(problem.shape) self.selected = ( @@ -598,7 +598,7 @@ def _output_bytes( - ``statistics``: one plane of statistics with resolved species and mode axes. - Returns: retained array bytes; adaptive periodic rows use the memory headroom. """ - count = len(simulation.settings.save_planes) + 1 + count = len(np.asarray(simulation.settings.save_planes)) + 1 selected = ( count if self.options.fields == "all" diff --git a/src/solprop/driver/interface.py b/src/solprop/driver/interface.py index 8dd5b2d6a..54035f410 100644 --- a/src/solprop/driver/interface.py +++ b/src/solprop/driver/interface.py @@ -184,7 +184,7 @@ def _propagate(build: Callable[..., Simulation], scope: Mapping[str, object]) -> "%s: %d modes, %d save planes, %r backend", build.__name__, len(simulation.modes), - len(simulation.settings.save_planes), + len(np.asarray(simulation.settings.save_planes)), simulation.settings.backend, ) # Each control is the type Simulation.run declares: prop_* declares it the same. diff --git a/src/solprop/driver/settings.py b/src/solprop/driver/settings.py index e241f6fdf..3d4f8f2ff 100644 --- a/src/solprop/driver/settings.py +++ b/src/solprop/driver/settings.py @@ -19,6 +19,7 @@ import numpy as np from jaxtyping import Float +from numpy.typing import ArrayLike from solprop._display import Displayed, engineering, line, summarise from solprop._ownership import frozen_copy @@ -367,7 +368,7 @@ class SimulationSettings(Displayed): # A bare number is admitted by the annotation so that it is refused by name, with # the fix, rather than by the run-time type check. save_planes: Float[np.ndarray, " n_z"] | Sequence[float] | float | None = None - n_save: int | float | None = None + n_save: int | SupportsIndex | float | None = None dz_max: float dz_init: float dz_min: float | None = None @@ -971,22 +972,24 @@ def _selectors( f"evenly spaced planes pass n_save={save_planes!r}" ) raise DriverError(msg, parameter="save_planes", rule="save-planes-count") - if isinstance(save_planes, numbers.Real) or np.ndim(save_planes) == 0: + given = cast("ArrayLike", save_planes) + if isinstance(save_planes, numbers.Real) or np.ndim(given) == 0: msg = ( f"save_planes={save_planes!r} is a single position; pass " f"[{save_planes!r}], or n_save for evenly spaced planes" ) raise DriverError(msg, parameter="save_planes") - planes = frozen_copy(np.reshape(save_planes, -1), np.float64) - for index, position in enumerate(planes): + planes = frozen_copy(np.reshape(given, -1), np.float64) + for index, position in enumerate(planes.tolist()): if not math.isfinite(position): msg = f"save plane {position!r} is not finite" raise DriverError(msg, parameter="save_planes") - if index and position <= planes[index - 1]: - relation = "repeats" if position == planes[index - 1] else "follows" + previous = float(planes[index - 1]) + if index and position <= previous: + relation = "repeats" if position == previous else "follows" msg = ( - f"save plane {position!r} m {relation} {planes[index - 1]!r} m; the " - "positions must increase strictly" + f"save plane {position!r} m {relation} {previous!r} m; the positions " + "must increase strictly" ) raise DriverError(msg, parameter="save_planes") return planes, count @@ -1007,7 +1010,7 @@ def _observation_planes( *, entrance: float, length: float, - default: int = DEFAULT_N_SAVE, + default: int | None = None, ) -> Float[np.ndarray, " n_z"]: """Return the positions a run records after its entrance, the last exactly `length`. @@ -1015,12 +1018,13 @@ def _observation_planes( count places that many observations evenly over ``[entrance, length]``, both included; positions within :data:`~solprop.stepper.schedule.LANDING_ULPS` ulps of an endpoint become it, each endpoint is kept once, the end is added when absent and - a position outside the interval is refused; neither selector takes `default`. + a position outside the interval is refused; neither selector takes `default`, + :data:`DEFAULT_N_SAVE` unless given. Resolving the result again against the same interval returns it unchanged. Positions in m; `entrance` before `length`. """ if save_planes is None: - count = default if n_save is None else n_save + count = n_save or (DEFAULT_N_SAVE if default is None else default) # linspace's last value is exactly `length`. return frozen_copy(np.linspace(entrance, length, count)[1:], np.float64) planes = np.array(save_planes, dtype=np.float64) @@ -1107,8 +1111,12 @@ def _adopted( f"grid.length = {length:g} m; got {entrance!r}" ) raise DriverError(msg, parameter="initial_z") + # __post_init__ holds the selectors as _selectors returns them. planes = _observation_planes( - settings.save_planes, settings.n_save, entrance=entrance, length=length + cast("np.ndarray | None", settings.save_planes), + cast("int | None", settings.n_save), + entrance=entrance, + length=length, ) if settings.schedule is not None and entrance == 0.0: refusal = _replay_refusal(settings.schedule, entrance, length) diff --git a/src/solprop/recipe/core.py b/src/solprop/recipe/core.py index 393bce48d..1410a9263 100644 --- a/src/solprop/recipe/core.py +++ b/src/solprop/recipe/core.py @@ -668,6 +668,12 @@ def _require_keywords(self) -> None: that solve its pins have dropped ``[pins]``, so a pinned keyword looks missing on them. """ + given = set(self._document["build"]) | set(self._document.get("pins", {})) + table = self._table() + if "length" in table and "grid" in table and not given & {"length", "grid"}: + # A keyword route's length is stated once, as length or as a grid's + # (SEP 51): either will do, so neither is required alone. + raise RecipeError("a length or a grid is required", path="length") missing = self._missing() if len(missing) == 1: raise RecipeError("a required keyword is missing", path=missing[0]) diff --git a/tests/calibration/test_refine.py b/tests/calibration/test_refine.py index b0348886c..b69c98aac 100644 --- a/tests/calibration/test_refine.py +++ b/tests/calibration/test_refine.py @@ -264,7 +264,7 @@ def test_a_low_storage_simulation_times_its_own_march(profiled: Path) -> None: from solprop.stepper import FixedSchedule, LowStorageRungeKutta # noqa: PLC0415 simulation = problems.build("gnlse") - planes = list(simulation.settings.save_planes) + planes = list(np.asarray(simulation.settings.save_planes)) length = float(max(planes)) simulation.settings = dataclasses.replace( simulation.settings, diff --git a/tests/driver/test_estimate.py b/tests/driver/test_estimate.py index fcc3e3e50..15f16016f 100644 --- a/tests/driver/test_estimate.py +++ b/tests/driver/test_estimate.py @@ -107,7 +107,7 @@ def test_the_output_size_counts_only_the_retained_fields(): def test_a_low_storage_run_takes_four_calls_a_step(): simulation = _built("soliton", "numpy_ref") - planes = list(simulation.settings.save_planes) + planes = list(np.asarray(simulation.settings.save_planes)) schedule = FixedSchedule.uniform( 0.0, planes[-1], planes[-1] / 200, save_planes=planes ) @@ -167,7 +167,7 @@ def counted(): def test_an_adams_run_takes_one_call_and_a_schedule_counts_its_total(): assert _built("rdw", "numpy_ref").estimate().calls_per_step == 1 simulation = _built("rdw", "numpy_ref") - planes = list(simulation.settings.save_planes) + planes = list(np.asarray(simulation.settings.save_planes)) # Steps short enough for the Adams method's collar (h alpha / 2 below 0.0877). end = planes[-1] schedule = FixedSchedule.uniform(0.0, end, end / 2000, save_planes=planes) diff --git a/tests/driver/test_interface_defaults.py b/tests/driver/test_interface_defaults.py index 365379fef..45c06814b 100644 --- a/tests/driver/test_interface_defaults.py +++ b/tests/driver/test_interface_defaults.py @@ -696,4 +696,4 @@ def test_the_settings_leave_the_caller_s_planes_writeable(): assert not held.flags.writeable # Not a view either: a later write by the caller leaves the settings alone. planes[0] = 0.25 - assert settings.save_planes[0] == 0.5 + assert np.asarray(settings.save_planes)[0] == 0.5 diff --git a/tests/driver/test_runner.py b/tests/driver/test_runner.py index cf99c6b8a..4ff9936a5 100644 --- a/tests/driver/test_runner.py +++ b/tests/driver/test_runner.py @@ -101,7 +101,7 @@ def capillary(backend: str, *, dense: bool = False) -> Simulation: schedule=None if dense else FixedSchedule.uniform( - 0.0, LENGTH, LENGTH / STEPS, save_planes=settings.save_planes + 0.0, LENGTH, LENGTH / STEPS, save_planes=np.asarray(settings.save_planes) ), interpolate_planes=dense, ) @@ -278,7 +278,7 @@ def test_a_load_restores_what_a_failed_run_left_as_a_fresh_backend_holds(dense): finally: fresh.close() after = stored(runner.run(inputs(simulation)[1], progress="none")) - assert after.n_saved == len(simulation.settings.save_planes) + 1 + assert after.n_saved == len(np.asarray(simulation.settings.save_planes)) + 1 @pytest.mark.medium @@ -309,7 +309,11 @@ def serving(*args, **keywords): runner.run(inputs(simulation)[0], progress=_Stop()) after = stored(runner.run(field, progress="none")) assert served == ["NativeSession"] * 3 - assert after.n_saved == fresh.n_saved == len(simulation.settings.save_planes) + 1 + assert ( + after.n_saved + == fresh.n_saved + == len(np.asarray(simulation.settings.save_planes)) + 1 + ) assert np.array_equal(after["field"], fresh["field"]) for name in fresh.stat_names: assert np.array_equal( @@ -696,7 +700,7 @@ def test_a_runner_runs_an_input_without_noise_when_it_has_none(): simulation = capillary("numpy_ref") with simulation.runner() as runner: output = stored(runner.run(inputs(simulation)[0], noise=None, progress="none")) - assert output.n_saved == len(simulation.settings.save_planes) + 1 + assert output.n_saved == len(np.asarray(simulation.settings.save_planes)) + 1 @pytest.mark.medium diff --git a/tests/driver/test_save_planes.py b/tests/driver/test_save_planes.py new file mode 100644 index 000000000..da7c4e36e --- /dev/null +++ b/tests/driver/test_save_planes.py @@ -0,0 +1,357 @@ +# SPDX-FileCopyrightText: 2026 John C. Travers and contributors +# +# SPDX-License-Identifier: GPL-3.0-or-later + +"""One rule for the saved planes and the end of a run (SEP 51). + +Every run records its entrance and ends at its length; ``n_save`` counts evenly spaced +observations over ``[initial_z, length]`` and ``save_planes`` lists positions inside it. +The placement, the endpoint rounding and every refusal are one helper's, reached by +every adoption: the constructor, the keyword builders, the settings setter and +``with_input``. Resolved planes are compared exactly: they are one ``linspace`` or one +normalized copy, a structural contract. +""" + +import dataclasses +import math + +import numpy as np +import pytest + +from builders import grid_at +from solprop.driver import Simulation, SimulationSettings +from solprop.driver.settings import DEFAULT_N_SAVE, _observation_planes +from solprop.exceptions import DriverError +from solprop.grid import EnvelopeGrid +from solprop.stepper import FixedSchedule, LowStorageRungeKutta, Multistep +from solprop.stepper.schedule import LANDING_ULPS + +LENGTH = 1e-5 +"""The tiny fibre's length, m: ten micrometres.""" + +STEPS = {"dz_max": 1e-6, "dz_init": 1e-6} + + +def grid(length: float = LENGTH) -> EnvelopeGrid: + """Return the tiny fibre's grid.""" + return EnvelopeGrid.from_limits(length, 800e-9, (500e-9, 1.6e-6), 200e-15) + + +def fibre(length: float | None = LENGTH, **keywords) -> Simulation: + """Return a GNLSE fibre that builds in milliseconds; nothing here runs it.""" + arguments = { + "wavelength": 800e-9, + "wavelength_limits": (500e-9, 1.6e-6), + "trange": 200e-15, + "fwhm": 20e-15, + "peak_power": 1.0, + "backend": "numpy_ref", + "noise": None, + **STEPS, + } | keywords + return Simulation.from_gnlse(0.0, length, [0.0, 0.0, -1e-26], **arguments) + + +def settings(**keywords) -> SimulationSettings: + """Return object-route settings with the tiny fibre's steps.""" + return SimulationSettings(backend="numpy_ref", **STEPS, **keywords) + + +def adopted(simulation: Simulation, chosen: SimulationSettings, **keywords): + """Return a direct Simulation of `simulation`'s physics adopting `chosen`.""" + return Simulation( + keywords.pop("grid", simulation.grid), + simulation.modes, + simulation.responses, + simulation._field0, + settings=dataclasses.replace(chosen, controller=simulation.settings.controller), + **keywords, + ) + + +# ------------------------------------------------------------------- the refusals + + +@pytest.mark.parametrize( + ("given", "match"), + [ + ({"save_planes": 80}, r"pass n_save=80"), + ({"save_planes": 0.25}, r"pass \[0\.25\], or n_save"), + ({"save_planes": True}, r"takes positions in m, got True"), + ({"save_planes": [0.1], "n_save": 3}, r"give one of n_save and save_planes"), + ({"n_save": 1}, r"n_save is an integer of at least 2, got 1"), + ({"n_save": 2.5}, r"n_save is an integer of at least 2, got 2\.5"), + ({"n_save": True}, r"n_save is an integer of at least 2, got True"), + ({"save_planes": [0.1, math.nan]}, r"save plane nan is not finite"), + ({"save_planes": [0.2, 0.1]}, r"save plane 0\.1 m follows 0\.2 m"), + ({"save_planes": [0.1, 0.1]}, r"save plane 0\.1 m repeats 0\.1 m"), + ], +) +def test_a_malformed_selector_is_refused_by_name_with_its_fix(given, match): + with pytest.raises(DriverError, match=match) as refused: + settings(**given) + assert refused.value.parameter in ( + "save_planes", + "n_save", + ("save_planes", "n_save"), + ) + + +def test_both_selectors_name_how_to_carry_a_count(): + with pytest.raises(DriverError, match=r"dataclasses\.replace\(settings, n_save=N"): + settings(save_planes=[], n_save=2) + + +def test_a_numpy_count_is_a_count(): + assert settings(n_save=np.int64(5)).n_save == 5 + + +# ------------------------------------------------------------- placement and ends + + +def test_a_count_places_that_many_observations_over_the_whole_run(): + simulation = fibre(n_save=5) + planes = np.asarray(simulation.settings.save_planes) + # The entrance is observation 0, so four positions follow it, the last the end. + assert planes.tolist() == np.linspace(0.0, LENGTH, 5)[1:].tolist() + assert planes[-1] == LENGTH == simulation.grid.length + assert simulation.settings.n_save is None + + +def test_neither_selector_takes_the_default_count(): + planes = np.asarray(fibre().settings.save_planes) + assert planes.size + 1 == DEFAULT_N_SAVE + assert planes[-1] == LENGTH + + +def test_positions_short_of_the_length_gain_the_end(): + assert np.asarray( + fibre(save_planes=[LENGTH / 2]).settings.save_planes + ).tolist() == [ + LENGTH / 2, + LENGTH, + ] + + +def test_an_empty_list_records_the_two_endpoints_alone(): + assert np.asarray(fibre(save_planes=[]).settings.save_planes).tolist() == [LENGTH] + + +def test_listed_endpoints_are_kept_once(): + planes = np.asarray( + fibre(save_planes=[0.0, LENGTH / 2, LENGTH]).settings.save_planes + ) + assert planes.tolist() == [LENGTH / 2, LENGTH] + + +@pytest.mark.parametrize( + "end", + [np.nextafter(0.3, 0.0), 0.3, 0.1 + 0.2, 0.3 + LANDING_ULPS * math.ulp(0.3)], + ids=["below", "equal", "sum", "bound"], +) +def test_a_position_within_the_landing_slack_of_the_end_is_the_end(end): + planes = _observation_planes(np.array([0.1, end]), None, entrance=0.0, length=0.3) + assert planes.tolist() == [0.1, 0.3] + + +def test_a_position_just_beyond_the_slack_is_refused_and_one_below_it_kept(): + ulp = math.ulp(0.3) + beyond = 0.3 + (LANDING_ULPS + 1) * ulp + with pytest.raises(DriverError, match="beyond the end of the run"): + _observation_planes(np.array([beyond]), None, entrance=0.0, length=0.3) + below = 0.3 - (LANDING_ULPS + 1) * ulp + planes = _observation_planes(np.array([below]), None, entrance=0.0, length=0.3) + assert planes.tolist() == [below, 0.3] + + +def test_a_position_beyond_the_end_names_the_interval_and_the_fix(): + with pytest.raises( + DriverError, match=r"raise length \(or grid\.length\)" + ) as refused: + fibre(save_planes=[2 * LENGTH]) + assert "[0 m, 1e-05 m]" in str(refused.value) + assert refused.value.parameter == "save_planes" + + +def test_resolving_resolved_planes_adds_nothing(): + first = _observation_planes(np.array([0.1]), None, entrance=0.0, length=0.3) + again = _observation_planes(first, None, entrance=0.0, length=0.3) + assert again.tolist() == first.tolist() == [0.1, 0.3] + simulation = fibre(n_save=4) + resolved = simulation.settings + simulation.settings = resolved + assert simulation.settings is resolved + + +def test_a_count_and_the_positions_it_resolves_to_are_one_run(): + counted = fibre(n_save=4) + listed = fibre(save_planes=counted.settings.save_planes) + assert ( + np.asarray(listed.settings.save_planes).tolist() + == np.asarray(counted.settings.save_planes).tolist() + ) + assert ( + listed.metadata().configuration_hash() + == counted.metadata().configuration_hash() + ) + + +def test_an_object_route_runs_to_its_grid_length(): + simulation = fibre() + direct = adopted(simulation, settings(n_save=3)) + assert np.asarray(direct.settings.save_planes).tolist() == [LENGTH / 2, LENGTH] + + +# ------------------------------------------------------------- interior launches + + +def test_a_count_at_an_interior_launch_spans_the_launched_interval(): + simulation = fibre() + launched = adopted(simulation, settings(n_save=4), initial_z=4e-6) + # Three steps of 2 um from the launch at 4 um: not the zero-based lattice. + np.testing.assert_array_equal( + launched.settings.save_planes, np.linspace(4e-6, LENGTH, 4)[1:] + ) + assert np.asarray(launched.settings.save_planes)[-1] == LENGTH + + +def test_an_interior_launch_on_the_zero_based_lattice_still_spans_its_interval(): + simulation = fibre() + launched = adopted(simulation, settings(n_save=3), initial_z=5e-6) + # 5 um is on the lattice of a zero-based count of three; the count is not. + np.testing.assert_array_equal( + launched.settings.save_planes, np.linspace(5e-6, LENGTH, 3)[1:] + ) + + +def test_a_position_before_an_interior_launch_is_refused(): + simulation = fibre() + with pytest.raises(DriverError, match="before the entrance, initial_z"): + adopted(simulation, settings(save_planes=[2e-6]), initial_z=4e-6) + + +def test_with_input_keeps_the_resolved_observations_beyond_the_launch(): + simulation = fibre(n_save=5) + derived = simulation.with_input(simulation._field0, initial_z=3e-6) + # No new count: the parent's resolved positions beyond 3 um, the end among them. + np.testing.assert_array_equal( + derived.settings.save_planes, np.linspace(0.0, LENGTH, 5)[2:] + ) + assert derived.initial_z == 3e-6 + + +# --------------------------------------------------------- adoption and replacement + + +def test_replaced_settings_are_resolved_against_the_run(): + simulation = fibre(n_save=2) + simulation.settings = dataclasses.replace( + simulation.settings, save_planes=None, n_save=3 + ) + assert np.asarray(simulation.settings.save_planes).tolist() == [LENGTH / 2, LENGTH] + + +def test_after_translation_a_count_equal_to_the_planes_is_no_change(): + simulation = fibre(n_save=3) + simulation.translate() + simulation.settings = dataclasses.replace( + simulation.settings, save_planes=None, n_save=3 + ) + with pytest.raises(DriverError, match="a new save_planes would be ignored"): + simulation.settings = dataclasses.replace( + simulation.settings, save_planes=None, n_save=4 + ) + + +def test_resolved_settings_reused_at_another_length_are_validated_afresh(): + simulation = fibre(save_planes=[LENGTH / 2]) + resolved = simulation.settings + longer = adopted(simulation, resolved, grid=grid_at(simulation.grid, 2 * LENGTH)) + assert np.asarray(longer.settings.save_planes).tolist() == [ + LENGTH / 2, + LENGTH, + 2 * LENGTH, + ] + with pytest.raises(DriverError, match="beyond the end of the run"): + adopted(simulation, resolved, grid=grid_at(simulation.grid, LENGTH / 4)) + + +# ------------------------------------------------------------- the length, once + + +def test_a_grid_alone_gives_the_length(): + simulation = fibre(None, grid=grid(), wavelength_limits=None, trange=None) + assert np.asarray(simulation.settings.save_planes)[-1] == LENGTH + + +def test_a_length_within_the_slack_of_the_grid_s_is_the_grid_s(): + near = np.nextafter(LENGTH, 0.0) + simulation = fibre(near, grid=grid(), wavelength_limits=None, trange=None) + assert np.asarray(simulation.settings.save_planes)[-1] == LENGTH + + +def test_a_length_and_a_grid_that_disagree_are_refused_naming_both(): + with pytest.raises(DriverError, match=r"length = 2e-05 m and grid\.length = 1e-05"): + fibre(2 * LENGTH, grid=grid(), wavelength_limits=None, trange=None) + + +@pytest.mark.parametrize("route", ["gnlse", "capillary", "waveguide"]) +def test_a_keyword_route_without_a_length_or_a_grid_is_refused(route): + with pytest.raises(DriverError, match="a length or a grid is required"): + if route == "gnlse": + fibre(None) + elif route == "capillary": + Simulation.from_capillary(125e-6, gas="He", wavelength=800e-9) + else: + Simulation.from_waveguide([], gas="He", wavelength=800e-9) + + +def test_a_capillary_without_its_gas_is_refused(): + with pytest.raises(DriverError, match="needs its fill"): + Simulation.from_capillary(125e-6, 0.1, wavelength=800e-9) + + +# ---------------------------------------------------------------- replay schedules + + +@pytest.mark.parametrize( + "steps", + [np.full(160, LENGTH / 160), np.full(1000, LENGTH / 1000)], + ids=["drifts-below", "drifts-above"], +) +def test_a_replayed_schedule_whose_sum_drifts_within_its_tolerance_is_accepted(steps): + schedule = FixedSchedule(steps) + assert schedule.z_end != LENGTH + simulation = fibre(schedule=schedule, integrator=LowStorageRungeKutta(), n_save=2) + assert simulation.settings.schedule is schedule + + +def test_a_uniform_schedule_over_the_run_is_accepted(): + schedule = FixedSchedule.uniform(0.0, LENGTH, LENGTH / 7) + assert ( + fibre(schedule=schedule, integrator=Multistep()).settings.schedule is schedule + ) + + +@pytest.mark.parametrize( + ("schedule", "match"), + [ + (FixedSchedule.uniform(0.0, LENGTH / 2, LENGTH / 10), "ends at"), + (FixedSchedule.uniform(0.0, 2 * LENGTH, LENGTH / 10), "ends at"), + (FixedSchedule(np.full(10, LENGTH / 10), 1e-7), "starts at"), + ], + ids=["shorter", "longer", "late-start"], +) +def test_a_schedule_that_does_not_cover_the_run_is_refused_at_adoption(schedule, match): + with pytest.raises(DriverError, match=f"the replayed schedule {match}") as refused: + fibre(schedule=schedule, integrator=Multistep()) + assert refused.value.parameter == "schedule" + + +def test_an_interior_launch_still_refuses_a_schedule(): + simulation = fibre() + replay = settings(schedule=FixedSchedule.uniform(4e-6, LENGTH, 1e-6)) + with pytest.raises( + DriverError, match="refuses the modified noise model and a fixed" + ): + adopted(simulation, replay, initial_z=4e-6) diff --git a/tests/driver/test_scan_worker_validation.py b/tests/driver/test_scan_worker_validation.py index aadf6ae00..ef04bf8ea 100644 --- a/tests/driver/test_scan_worker_validation.py +++ b/tests/driver/test_scan_worker_validation.py @@ -247,7 +247,7 @@ def test_admission_counts_every_mode_of_a_retained_and_reduced_field(): simulation = capillary(modes=3, length=2e-3) shape = simulation.translate().shape assert shape[0] == 3 - count = len(simulation.settings.save_planes) + 1 + count = len(np.asarray(simulation.settings.save_planes)) + 1 plane = math.prod(shape) * 16 retained = _Work(build, _Options((), "all", (), "none"), "worker") assert retained._output_bytes(simulation, {}) == count * plane + count * 8 diff --git a/tests/driver/test_sep12_sep14_integration.py b/tests/driver/test_sep12_sep14_integration.py index 176639e74..a30f83622 100644 --- a/tests/driver/test_sep12_sep14_integration.py +++ b/tests/driver/test_sep12_sep14_integration.py @@ -372,7 +372,7 @@ def plane(self, z, summary): assert checkpoint is not None and checkpoint.landed # The equal-approach rule may shorten this natural step. Its actual saved # accepted endpoint, rather than the requested step length, defines landing. - assert 0.0 < checkpoint.plane.z < simulation.settings.save_planes[0] + assert 0.0 < checkpoint.plane.z < np.asarray(simulation.settings.save_planes)[0] assert checkpoint.plane.z == ( output["step_history/z"][-1] + output["step_history/h"][-1] ) diff --git a/tests/driver/test_taper_coupling.py b/tests/driver/test_taper_coupling.py index 7afdb6437..a14a7b1fa 100644 --- a/tests/driver/test_taper_coupling.py +++ b/tests/driver/test_taper_coupling.py @@ -199,7 +199,7 @@ def test_the_opt_out_is_the_adiabatic_route_without_a_warning(): list(simulation.responses), simulation._field0, controller=cast("PIController", simulation.settings.controller), - save_planes=simulation.settings.save_planes, + save_planes=np.asarray(simulation.settings.save_planes), dz_max=simulation.settings.dz_max, dz_init=simulation.settings.dz_init, schedule=simulation.settings.schedule, @@ -236,7 +236,7 @@ def test_a_wall_and_the_opt_out_are_refused_together(): list(simulation.responses), simulation._field0, controller=cast("PIController", simulation.settings.controller), - save_planes=simulation.settings.save_planes, + save_planes=np.asarray(simulation.settings.save_planes), dz_max=simulation.settings.dz_max, dz_init=simulation.settings.dz_init, wall=CoherentWall(), @@ -569,7 +569,7 @@ def test_a_second_field_component_beside_the_coupling_is_refused(): list(simulation.responses), field, controller=cast("PIController", simulation.settings.controller), - save_planes=simulation.settings.save_planes, + save_planes=np.asarray(simulation.settings.save_planes), dz_max=simulation.settings.dz_max, dz_init=simulation.settings.dz_init, quadrature=simulation.settings.quadrature, diff --git a/tests/driver/test_tdse_entry.py b/tests/driver/test_tdse_entry.py index 9bade7922..bad95dfcf 100644 --- a/tests/driver/test_tdse_entry.py +++ b/tests/driver/test_tdse_entry.py @@ -204,16 +204,19 @@ def test_statistics_default_excludes_what_a_tdse_response_cannot_supply(): def test_tdse_output_defaults_and_their_explicit_overrides(): final_only = _capillary(tdse=_sae()) assert final_only.settings.step_planes == 1 - assert tuple(final_only.settings.save_planes) == (_LENGTH,) + assert tuple(np.asarray(final_only.settings.save_planes)) == (_LENGTH,) entry = plain(final_only.configuration["tdse_entry"]) assert entry["requested_planes"] == "final_only" assert entry["step_planes"] == {"requested": None, "resolved": 1} no_steps = _capillary(tdse=_sae(), step_planes=0) assert no_steps.settings.step_planes == 0 planes = _capillary(tdse=_sae(), n_save=5) - assert len(planes.settings.save_planes) == 4 and planes.settings.step_planes == 1 + assert ( + len(np.asarray(planes.settings.save_planes)) == 4 + and planes.settings.step_planes == 1 + ) explicit = _capillary(tdse=_sae(), save_planes=[_LENGTH / 2, _LENGTH]) - assert tuple(explicit.settings.save_planes) == (_LENGTH / 2, _LENGTH) + assert tuple(np.asarray(explicit.settings.save_planes)) == (_LENGTH / 2, _LENGTH) assert plain(explicit.configuration["tdse_entry"])["requested_planes"] == ( "explicit" ) @@ -253,7 +256,7 @@ def test_without_tdse_a_representative_call_is_unchanged(): record = { "configuration": serialise(simulation.configuration), "responses": serialise(list(simulation.responses)), - "save_planes": [float(x) for x in simulation.settings.save_planes], + "save_planes": [float(x) for x in np.asarray(simulation.settings.save_planes)], "step_planes": simulation.settings.step_planes, "backend": simulation.settings.backend, "stats": list(stats.names), @@ -270,7 +273,7 @@ def test_without_tdse_a_representative_call_is_unchanged(): / "test_without_tdse_a_representative_call_is_unchanged.npz", ) assert simulation.settings.step_planes == 0 - assert len(simulation.settings.save_planes) == 200 + assert len(np.asarray(simulation.settings.save_planes)) == 200 def test_prop_capillary_forwards_the_tdse_keywords(monkeypatch): diff --git a/tests/output/test_callback.py b/tests/output/test_callback.py index 794c9b9c8..459fd7e77 100644 --- a/tests/output/test_callback.py +++ b/tests/output/test_callback.py @@ -223,7 +223,7 @@ def receive(plane: SavedPlane) -> None: handler = CallbackOutput(receive) assert simulation.run(handler, progress="none") is handler - planes = simulation.settings.save_planes + planes = np.asarray(simulation.settings.save_planes) assert handler.n_saved == len(kept) == len(planes) + 1 assert kept == [index < 2 for index in range(len(kept))] # The positions are the save planes, landed on within a relative rounding. @@ -250,7 +250,7 @@ def test_the_fields_setting_says_what_every_plane_carries(backend, fields, carri @pytest.mark.parametrize("backend", available()) def test_the_planes_of_natural_steps_reach_the_callable(backend): simulation = cartesian(backend, replay=False) - end = simulation.settings.save_planes[-1:] + end = np.asarray(simulation.settings.save_planes)[-1:] simulation.settings = dataclasses.replace( simulation.settings, step_planes=2, save_planes=end ) @@ -378,7 +378,7 @@ def test_saving_a_plane_allocates_no_volume(backend): volume = simulation._field0.nbytes handler = _Measured(nothing) simulation.run(handler, progress="none") - assert handler.n_saved == len(simulation.settings.save_planes) + 1 + assert handler.n_saved == len(np.asarray(simulation.settings.save_planes)) + 1 assert max(handler.peaks) < volume / 10 assert max(handler.left) < volume / 10 @@ -648,7 +648,7 @@ def refuse_the_second(plane: SavedPlane) -> None: assert not runner.closed assert runner.run( simulation._field0, output=CallbackOutput(nothing), progress="none" - ).n_saved == handler.n_saved + len(simulation.settings.save_planes) + ).n_saved == handler.n_saved + len(np.asarray(simulation.settings.save_planes)) @pytest.mark.parametrize("backend", available()) diff --git a/tests/recipe/test_pins.py b/tests/recipe/test_pins.py index c8852de38..4c35c08fa 100644 --- a/tests/recipe/test_pins.py +++ b/tests/recipe/test_pins.py @@ -186,7 +186,7 @@ def test_a_pinned_required_keyword_builds_where_a_missing_one_is_refused(): without = pinned({"radius": pin}, drop=("radius", "length")) for call in (without.build, without.resolve, lambda: without.pin_roots("radius")): with pytest.raises( - RecipeError, match=r"^length: a required keyword is missing$" + RecipeError, match=r"^length: a length or a grid is required$" ) as caught: call() assert caught.value.parameter == "length" diff --git a/tests/recipe/test_provenance.py b/tests/recipe/test_provenance.py index ba1e2ef74..29c78b547 100644 --- a/tests/recipe/test_provenance.py +++ b/tests/recipe/test_provenance.py @@ -164,7 +164,7 @@ def test_the_keywords_left_to_the_build_would_move_the_record(): # An explicit first step turns the start-up rule off (SEP 41 section 5.2). recipe = Recipe.example("soliton") simulation = recipe.build() - length = simulation.settings.save_planes[-1] + length = np.asarray(simulation.settings.save_planes)[-1] with_step = recipe.to_dict() with_step["build"]["dz_init"] = float(length * 1e-4) assert _hash(Recipe.from_dict(with_step).build()) != _hash(simulation) diff --git a/tests/recipe/test_save_planes.py b/tests/recipe/test_save_planes.py index e7a716b8c..73a63f522 100644 --- a/tests/recipe/test_save_planes.py +++ b/tests/recipe/test_save_planes.py @@ -12,6 +12,7 @@ """ import warnings +from typing import cast import numpy as np import pytest @@ -45,14 +46,22 @@ def radial(selector: str) -> Recipe: ("selector", "match", "path"), [ ("save_planes = 80", "write n_save = 80", "settings.save_planes"), - ('save_planes = "0.25 mm"', r"pass \[0\.00025\], or n_save", "settings.save_planes"), + ( + 'save_planes = "0.25 mm"', + r"pass \[0\.00025\], or n_save", + "settings.save_planes", + ), ("n_save = 1", "n_save is an integer of at least 2", "settings.n_save"), ( 'save_planes = ["1 mm"]\nn_save = 3', "give one of n_save and save_planes", "settings.save_planes", ), - ('save_planes = ["2 mm"]', r"raise length \(or grid\.length\)", "settings.save_planes"), + ( + 'save_planes = ["2 mm"]', + r"raise length \(or grid\.length\)", + "settings.save_planes", + ), ], ids=["count", "lone", "small", "both", "beyond"], ) @@ -87,14 +96,17 @@ def test_a_keyword_route_recipe_refuses_a_length_its_grid_disagrees_with(): def test_an_object_route_recipe_takes_a_count_over_its_grid_length(): simulation = radial("n_save = 81").build() - planes = simulation.settings.save_planes + planes = np.asarray(simulation.settings.save_planes) assert planes.tolist() == np.linspace(0.0, 1e-3, 81)[1:].tolist() assert planes[-1] == simulation.grid.length def test_an_object_route_recipe_without_a_selector_takes_the_default_count(): simulation = radial("").build() - assert simulation.settings.save_planes.size + 1 == settings_module.DEFAULT_N_SAVE + assert ( + np.asarray(simulation.settings.save_planes).size + 1 + == settings_module.DEFAULT_N_SAVE + ) def test_the_count_and_its_positions_build_the_same_run(): @@ -113,9 +125,9 @@ def test_the_resolved_recipe_writes_the_canonical_positions_in_the_settings(sele recipe = radial(selector) simulation = recipe.build() document = provenance.resolved_document(recipe, simulation) - table = document["build"]["settings"] + table = cast("dict[str, object]", document["build"]["settings"]) assert "n_save" not in table - assert table["save_planes"] == simulation.settings.save_planes.tolist() + assert table["save_planes"] == np.asarray(simulation.settings.save_planes).tolist() assert "save_planes" not in document["build"] assert _hash(Recipe.from_dict(document).build()) == _hash(simulation) @@ -125,7 +137,7 @@ def test_a_resolved_recipe_does_not_depend_on_the_default_count(monkeypatch): simulation = recipe.build() document = provenance.resolved_document(recipe, simulation) monkeypatch.setattr(settings_module, "DEFAULT_N_SAVE", 11) - assert radial("").build().settings.save_planes.size == 10 + assert np.asarray(radial("").build().settings.save_planes).size == 10 assert _hash(Recipe.from_dict(document).build()) == _hash(simulation) diff --git a/tests/test_benchmark_cases.py b/tests/test_benchmark_cases.py index 62e125dc7..d0386b479 100644 --- a/tests/test_benchmark_cases.py +++ b/tests/test_benchmark_cases.py @@ -67,13 +67,14 @@ def test_runs_save_evenly_to_their_stop_and_a_fraction_stops_early(): case = CASES["argon_blueshift"] full = build(configuration("argon_blueshift")) np.testing.assert_allclose( - full.settings.save_planes, np.linspace(0, case.length, case.planes + 1)[1:] + np.asarray(full.settings.save_planes), + np.linspace(0, case.length, case.planes + 1)[1:], ) short = build(configuration("argon_blueshift", fraction=0.25)) - assert short.settings.save_planes[-1] == pytest.approx(case.length / 4) + assert np.asarray(short.settings.save_planes)[-1] == pytest.approx(case.length / 4) # A run ends at its grid's length (SEP 51): the shortened case is the whole one on # its grid cut at the stop, its collar and steps those of the whole length. - assert short.grid.length == short.settings.save_planes[-1] + assert short.grid.length == np.asarray(short.settings.save_planes)[-1] assert full.settings.absorber is not None and short.settings.absorber is not None assert short.settings.absorber.reference_length == ( full.settings.absorber.reference_length From 8dae78d992e14e3d320d3db83ca6c477b16e1aa8 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 02:14:19 +0000 Subject: [PATCH 07/20] Document SEP 51 phase 1 and report it in Part II The manual's running and recipe pages describe the length stated once, the interval, the two selectors and endpoint rounding; the beam page takes n_save; the docstrings follow. Changelog fragments carry the migration and the fix for #533. The phase report records the survey, the tests pinned or moved, and the interim keyword-only deviation. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- changelog.d/533-save-planes-count.fixed.md | 3 + changelog.d/sep-0051-save-planes.changed.md | 21 +++ docs/dev/seps/sep-0051-save-planes.md | 179 +++++++++++++++++++- docs/guide/free-space/beams.md | 2 +- docs/guide/setup/recipes.md | 15 ++ docs/guide/setup/running.md | 57 ++++++- src/solprop/driver/simulation.py | 58 ++++--- 7 files changed, 310 insertions(+), 25 deletions(-) create mode 100644 changelog.d/533-save-planes-count.fixed.md create mode 100644 changelog.d/sep-0051-save-planes.changed.md diff --git a/changelog.d/533-save-planes-count.fixed.md b/changelog.d/533-save-planes-count.fixed.md new file mode 100644 index 000000000..e76dfa02b --- /dev/null +++ b/changelog.d/533-save-planes-count.fixed.md @@ -0,0 +1,3 @@ +A recipe's `save_planes = 80` in an object route's `[build.settings]` is no longer read +as one plane at 80 m, with the run marching until something unrelated stopped it: it is +refused with "write `n_save = 80`", and every run now ends at its grid's length (#533). diff --git a/changelog.d/sep-0051-save-planes.changed.md b/changelog.d/sep-0051-save-planes.changed.md new file mode 100644 index 000000000..f8606c86b --- /dev/null +++ b/changelog.d/sep-0051-save-planes.changed.md @@ -0,0 +1,21 @@ +Every route now follows one rule for the saved planes and the end of a run +([SEP 51](docs/dev/seps/sep-0051-save-planes.md)). A run marches from `initial_z` to its +length, `length` or `grid.length`, and always records both ends. `n_save=N` gives `N` +evenly spaced observations over that interval, both ends included, and +`save_planes=[...]` lists positions inside it. `SimulationSettings` gains `n_save`, its +`save_planes` becomes optional (given neither, a run records 201), and a recipe's +object-route `[build.settings]` takes `n_save` too. Migration: +`save_planes=80` is refused with "pass `n_save=80`" in Python and "write `n_save = 80`" +in a recipe; `save_planes=0.25` must be `[0.25]`; `n_save` and `save_planes` together, +`n_save` below 2, and positions before the entrance or beyond the end are refused; a +position within eight ulps of an endpoint is that endpoint. Positions short of the length +no longer end the run: it continues to the length and records it, so indices counted +from the end (`field_planes=[-1, …]`) may name other planes, and a short window of a +longer setup is now a shorter grid, with `boundary_length` pinned to keep the absorber. +`length` is optional on the keyword routes; given beside `grid=`, the two must agree, and +a call with neither is refused (`prop_capillary` and `from_capillary` therefore refuse a +missing `gas` themselves). `n_save` beside an interior launch counts over +`[initial_z, length]`. A replayed `FixedSchedule` must start at the entrance and end at +the length, within the rounding its step sum accumulates, or it is refused before the +run. The resolved recipe writes the run's positions in `[build.settings]` on an object +route and drops `n_save`. diff --git a/docs/dev/seps/sep-0051-save-planes.md b/docs/dev/seps/sep-0051-save-planes.md index 8a4e7bda3..dbc3fd34e 100644 --- a/docs/dev/seps/sep-0051-save-planes.md +++ b/docs/dev/seps/sep-0051-save-planes.md @@ -16,7 +16,7 @@ | **Supersedes** | — | | **Superseded-by** | — | | **Implementation** | Opus 5.5 (AI), for John Travers, on `feature/sep-0051-save-planes` | -| **Manual pages** | — | +| **Manual pages** | `guide/setup/running.md`, `guide/setup/recipes.md`, `guide/free-space/beams.md` | ## Part I — Proposal @@ -523,6 +523,181 @@ None beyond solprop's own documentation and issues, cited where used. ## Part II — Implementation record +### Phase 1 — Driver and recipes + +**Scope.** 2026-11-16; Opus 5.5 (AI) for John Travers; branch +`feature/sep-0051-save-planes`, commits from `ebff016c` (the helper and adoption) to the +commit that appends this report. The front end (§5.10, phase 2) is untouched. + +**Survey (§11), before any call site was edited.** An instrumented `Simulation.settings` +setter and the two grid helpers recorded, for every run the default test lane builds, +what the new rule would do. The lane was cancelled from outside at 91 % (twice; the +numbers are of the second run); the slow lane and `native/tests` were not run. + +| What the rule changes | Count | +|---|---| +| The run's end moves later (last plane before `grid.length`) | 371 adoptions, 189 tests, 52 call sites in 25 files | +| A plane beyond the end, refused | 1 (`tests/output/test_record_arrays.py`, a `length` of 1 cm on a 10 µm grid) | +| A plane before an interior launch, refused | 1 (already a refusal test) | +| A replay schedule not covering the run, refused | 92 adoptions, 32 tests, 16 sites in 10 files | +| A replay start that is not the entrance | 0 | +| A plane normalized onto the end | 0 | +| A keyword call with both `length` and `grid` | 2199 calls at 224 sites; 43 calls at 13 sites disagree | + +A static scan of the tree (Python files and the Python blocks of Markdown pages) found 509 +keyword-route calls that pass `length` positionally, in 227 hand-written files (150 test +files, 43 gallery scripts, 12 guide pages, 12 native tests, 5 benchmarks, the README, two +package files and one design page), and 185 call sites passing `length` beside `grid=`. +That count is what decided the first deviation below. + +**Delivered.** + +- `src/solprop/driver/settings.py`: `SimulationSettings.n_save`, an optional + `save_planes`, and four private helpers: `_selectors` (the refusals that need no + interval), `_observation_planes` (placement, endpoint normalization within + `LANDING_ULPS` ulps of each endpoint, the interval refusals; it replaces + `_save_planes`), `_run_length` (the length/grid table of §5.1) and `_adopted` (the + entrance check, the replay check of §5.7 with `replay_tolerance`, and resolution). +- `src/solprop/driver/simulation.py`: the `settings` setter adopts every settings object + through `_adopted` before any comparison, so the constructor, the keyword builders, + `with_input`, `with_mixture` and anything else that builds a `Simulation` share one + rule; `length` is optional on `from_gnlse`, `from_capillary` and `from_waveguide` and + resolved by `_run_length` before anything uses it; the keyword routes pass `n_save` and + `save_planes` through unresolved. `src/solprop/driver/interface.py`: the same + signatures on `prop_*`. `src/solprop/driver/routes/general.py`: the general modal + route's tables span `grid.length`, the run's end. +- `src/solprop/recipe/`: the settings metadata drops the integer form of `save_planes` + and gains `n_save`; `refuse_plane_count` refuses `save_planes = N` with "write + `n_save = N`" on every route; `plane_parameter` turns the driver's refusals of the + planes, the length and replay into a `RecipeError` naming the keyword, in + `build_object` and `Recipe.build`; a keyword-route recipe with neither `length` nor + `grid` is refused before the route is called; `resolved_document` writes the resolved + positions in `[build.settings]` on an object route (and at the top level otherwise) + and drops `n_save`. +- `benchmarks/builders.py`: `window`, which runs a case to a shorter stop (`ab + --length`) by rebuilding it on its grid cut at the stop, carrying the whole case's + collar, steps and profiles; `benchmarks/sessions.py` and the linear GRIN case use it or + cut their own grid. +- Tests: `tests/driver/test_save_planes.py` (the refusal table, placement and endpoints, + the rounding cases, count/positions parity of planes and hash, interior launches on and + off a zero-based lattice, `with_input`, setter replacement and reuse at other lengths, + the length/grid table on all three keyword routes, replay drift and refusals) and + `tests/recipe/test_save_planes.py` (refusals as `RecipeError` with their paths on + object and keyword routes, `n_save` in settings, the resolved recipe for a count, a + list, a short list and no selector, and its independence of the default count). + `tests/builders.py` gains `grid_at` and `held_collar`. +- Pages: `docs/guide/setup/running.md` (a section on the length and the saved planes), + `docs/guide/setup/recipes.md` (the settings' selectors and the resolved recipe), + `docs/guide/free-space/beams.md` (the `linspace` idiom becomes `n_save`); docstrings of + `SimulationSettings`, `Simulation`, its setter, `with_input`, `from_free`, + `from_planar` and the keyword routes. Changelog: `changelog.d/sep-0051-save-planes.changed.md` + (the migration) and `changelog.d/533-save-planes-count.fixed.md`. + +**Existing tests changed (Q7's closing paragraph).** No tolerance was changed. + +- *A short window of a longer grid, physics kept* (the grid cut at the run's end with + `grid_at`, the collar the longer grid gave with `held_collar` or by building it on the + longer grid, and a length-derived default step pinned where one applied): the + sixth-order soliton of `tests/driver/test_prop_gnlse.py`; the general modal fixtures of + `test_general_modal.py`, `test_modal_metrics.py`, `test_modal_resume.py`, + `test_material_manifest.py`, `test_modal_launch.py` (also `dz_max`) and + `test_route_keywords.py`; the far-field cases of `test_far_field_statistics.py` and + `test_native_far_field.py`; two planar-hybrid runs; `tests/record_routes.py`. +- *A `length` that disagreed with `grid`* (the run's own end kept, the grid built there, + the collar pinned): `tests/backends/adams_source_cases.py` (the Adams source ladder), + the general entry point of `tests/backends/general_rows.py`, the native noisy-run + reference of `test_native_session_history.py`, the two capillary receivers of + `tests/coupling/test_workflows.py`, the wide case of `tests/coupled_flow_cases.py` + (its collar was already pinned), `test_vector_coupling.py` and the linear GRIN + benchmark. +- *Construction or refusal only, shortened freely*: three cases of + `test_simulation.py`, `test_backend_default.py`, `test_record_arrays.py`, one refusal + of `test_coherent_capillary.py`, `tests/translate/test_routes.py` and two far-field + geometry refusals. +- *Replay*: the dispersive capillary's one-step row now records its whole replayed + schedule (the rung takes the first step alone, so the step is unchanged); + `tests/sessions/test_group.py`'s schedule past the last plane, which existed to test + the ignored tail, is now a refusal test. +- *Messages and harness*: `tests/recipe/test_pins.py` (the refusal of a recipe with + neither length nor grid), `tests/test_benchmark_cases.py` and + `tests/test_benchmark_guides.py` (a shortened case's grid is cut at its stop, with the + whole case's collar and steps). + +**Deviations from the proposal.** + +1. *`length` is optional but stays positional-or-keyword* (§5.1, Q7 item 6). Making it + keyword-only would edit about 509 calls in 227 files and regenerate 43 galleries. This + is an interim decision of the coordinator, pending with the maintainer; the signature + change is one commit, so the keyword-only form can follow as one mechanical commit. + Because Python allows no required parameter after an optional one, + `from_capillary`'s and `prop_capillary`'s `gas` now defaults to `None` and is refused + when omitted. A hazard for the keyword-only form: with `length` keyword-only, the next + positional parameter (`betas` on the GNLSE routes, `gas` on the capillary and + waveguide routes) takes the freed slot, so `from_capillary(r, 0.2, "Ar")` would bind + `0.2` to `gas` instead of failing with Python's own error; a guaranteed failure would + need those parameters keyword-only as well. +2. *A recipe with neither `length` nor `grid`* is refused by the recipe before the route + is called, as "a length or a grid is required" against `length`, rather than by the + route; otherwise a recipe with pins reported it against the pinned keyword. +3. *A recipe's integer `save_planes`* says "write `n_save = 80`", the recipe's spelling, + where Python says "pass `n_save=80`". +4. *Endpoint slack* is `LANDING_ULPS` ulps of the endpoint itself (§5.4, D5), so at an + entrance of zero it is exact; the replay check is skipped for an interior launch, + which the existing rule refuses with its own message. + +**Decisions.** + +- Resolution returns the same settings object when they are already resolved for the + run, so a repeated adoption is free and a translated run's settings compare by identity. +- The default count is read when the planes are resolved, not when the helper is + defined, so the resolved-recipe test can change it. +- The benchmark harness rebuilds a shortened case rather than running the whole one, and + refuses to shorten `grin_nonlinear`, which is translated at construction. + +**Verification.** `numpy_ref` and the native CPU build on the Xeon, eight logical CPUs, +one thread per worker. Passing: the 29 modules the survey flagged and every module +edited, the two new modules, `tests/recipe`, the resume and scan modules of +`tests/driver`, `tests/test_guide_snippets.py`, and the doctests of the edited source +modules, `tests/backends/test_parity_catalogue.py` (737 tests with `test_coherent_capillary.py`), and the 15 modules touched only to satisfy the type checker. Repository-wide `ruff check`, `ruff format --check` and `basedpyright` (0 errors) pass; numpydoc, codespell, `reuse` and `tests/test_seps.py` pass on the touched files. Not run locally: the full default lane, the slow lane, the +coverage lane, `native/tests`, the front-end gate and the galleries; CI is the gate. + +**Sources checked.** None needed: no constant, coefficient or citation was transcribed. + +**Limitations.** + +- The survey covers 91 % of the default lane. +- Other setup depends on `grid.length` besides the default absorber, and is not pinned + when a test's grid is cut: `LossPolicy.limit(grid.length)` clamps a mode's attenuation + (`src/solprop/linear.py`), the boundary monitor's quiet-window spacing is + `grid.length / CHECKS`, and the walk-off warning integrates over `grid.length`. None of + the changed tests moved; §3 does not list them. +- `test_modal_launch.py`'s general runs keep the default first step, which is a fraction + of the length and refined by the start-up rule; their checks are of the launch. +- No new test resumes a file to its declared end: resume already reads the last + requested plane of the request, which now ends at the length, and the existing resume + modules pass. Replay from `FixedSchedule.from_history` and the TDSE capillary's + resolved recipe are not tested here. + +**Open questions.** + +- Q8: keyword-only `length` (deviation 1), with the slide of `betas`/`gas` into its + slot. Owner: the maintainer. +- Q9: `driver/scaffold.py`'s fixed-step tool has its own `n_save`, which does not count + the entrance; it is a separate tool and left unchanged. Owner: the maintainer. +- Q10: whether the loss clamp and the monitor spacing should follow a pinned reference + length, as the absorber's does. Owner: an issue. + +**Cost** (`git diff --numstat` against `094a7fb8`): package code and +docstrings +473 −113 lines (`src/`), benchmarks +94 −12, tests +758 −121 (of which +507 in the two new modules and 29 in `tests/builders.py`), manual pages +72 −2. The +proposal estimated about 250 code lines, 100 docstring lines and 450 test lines, and 10–30 +edited tests; about 45 existing test and benchmark files were edited, about a third of +them only to wrap a now-optional `save_planes` for the type checker. + +**Handoff.** Phase 2 (§5.10) needs the object sheets to stop expanding a count into a +list over `grid.length`: the settings metadata now offers `n_save` beside `save_planes` +(an array only), and the resolved planes always end at the length. + ## Part III — History - 2026-11-15: Drafted, after the investigation of #533 found that no route ties the @@ -534,6 +709,8 @@ None beyond solprop's own documentation and issues, cited where used. drafting agent revised Part I to match and responded to R1–R10. - 2026-11-15: Accepted by John Travers in PR #847. Part I is frozen. - 2026-11-15: Implementation started on `feature/sep-0051-save-planes`. +- 2026-11-16: Phase 1 (driver and recipes) reported in Part II, with an interim + deviation on keyword-only `length` pending with the maintainer. ### AI review — 2026-11-15 diff --git a/docs/guide/free-space/beams.md b/docs/guide/free-space/beams.md index 23c96171e..a09652122 100644 --- a/docs/guide/free-space/beams.md +++ b/docs/guide/free-space/beams.md @@ -105,7 +105,7 @@ beam = SpatialPulse( ) settings = SimulationSettings( controller=PIController(rtol=1e-6, atol=1e-12), - save_planes=np.linspace(0, length, planes + 1)[1:], + n_save=planes + 1, # the entrance and `planes` more, to the end dz_init=1e-4, dz_max=length / planes, stats=StatsSpec(names=("energy", "beam_radius", "peak_intensity")), diff --git a/docs/guide/setup/recipes.md b/docs/guide/setup/recipes.md index 81882516b..447b50a5b 100644 --- a/docs/guide/setup/recipes.md +++ b/docs/guide/setup/recipes.md @@ -180,6 +180,16 @@ dz_max = "2 mm" stats = { type = "StatsSpec", names = ["energy"] } ``` +The settings' planes follow the rule of every route +([the length and the saved planes](running.md#the-length-and-the-saved-planes)): the run +ends at the grid's `length` and records its entrance and end, `n_save = 81` gives 81 +evenly spaced observations over the run, and `save_planes` lists positions inside it, so +the table above could say `save_planes = []`. A bare integer, `save_planes = 80`, is +refused by `Recipe.check()` and `build()` with "write `n_save = 80`", as are both +selectors together, a position beyond the end and, on a keyword route, a `length` its +`grid` disagrees with: each is a {py:class}`~solprop.recipe.RecipeError` naming the +keyword. + A recipe holds the `from_*` form, so the temporal absorber and its scheme are keywords of the `settings` table, `absorber = { type = "absorber" }` built on the `grid`, and not of `[build]`, although `prop_free` and `prop_planar` take them as @@ -330,6 +340,11 @@ goes to each point's run. A simulation built by `recipe.build()` carries its recipe, and its first run records it in the output beside the run, as the recipe was written and as it resolved: the recipe that rebuilds the run, seed included ([the file's layout](../results/output.md#the-recipe-a-run-was-built-from)). +The resolved recipe writes the run's planes as positions, ending at its length, where the +route reads them (at the top level of a keyword route, in `[build.settings]` on an +object route), and drops `n_save`; a route default, the TDSE capillary's two +observations and natural steps included, is written out too, so a later change of a +default cannot change the run it rebuilds. A change the recipe would not describe drops it with a warning, and the run then records none: `with_input`, `with_mixture`, or a new value of a setting other than `fields`, `field_planes` and `resume_history`. diff --git a/docs/guide/setup/running.md b/docs/guide/setup/running.md index ff4ce7365..087728f75 100644 --- a/docs/guide/setup/running.md +++ b/docs/guide/setup/running.md @@ -132,6 +132,61 @@ field's content in the collar. for two-colour and multi-colour inputs, on every keyword entry point of this page ([several pulses at once](pulses.md#several-pulses-at-once)). +### The length and the saved planes + +Every run marches from its entrance, `initial_z` (zero unless an interior launch sets +it), to its length, and always records both. The length is stated once. On a keyword +route it is `length`, or the length of a `grid=` passed instead; given both, they must +agree to within the marches' landing slack of eight ulps +({py:data}`~solprop.stepper.schedule.LANDING_ULPS`), and the grid's is then used, while +a disagreement is refused naming both values, as is a call with neither. On +{py:class}`~solprop.driver.simulation.Simulation` and the free-space and planar +constructors the length is `grid.length`. Everything that depends on the length uses +that one value: the run's end, the default steps and profiles, and the default +absorber's strength ([boundaries](../numerics/boundaries.md)). + +What is recorded in between is chosen by one of two selectors, on every route and in +{py:class}`~solprop.driver.settings.SimulationSettings` alike: + +- `n_save=N`, an integer of at least 2: `N` evenly spaced observations over + `[initial_z, length]`, both ends included; +- `save_planes=[...]`, positions in metres, finite and strictly increasing, inside that + interval. The entrance and the end are added when absent, and either may be listed; + `save_planes=[]` records the two endpoints alone. + +Given neither, a run records 201 (the TDSE capillary, its entrance and end with every +natural step). Giving both is refused, as are a bare number (`save_planes=80` says +"pass `n_save=80`"), a count below two and a position outside the interval: + +```{code-block} python +from solprop.driver import SimulationSettings + +SimulationSettings(n_save=81, dz_max=1e-3, dz_init=1e-6) # 81 over [0, grid.length] +SimulationSettings(save_planes=[0.05], dz_max=1e-3, dz_init=1e-6) # 0, 0.05 m, the end +SimulationSettings(save_planes=[], dz_max=1e-3, dz_init=1e-6) # the entrance and end +``` + +A position within eight ulps of an endpoint is that endpoint: `0.1 + 0.2` and the float +just below `0.3` both end a run of length `0.3`, and each endpoint is recorded once. +Settings are resolved when a simulation adopts them — at construction, on assigning +{py:attr}`~solprop.driver.simulation.Simulation.settings`, and in +{py:meth}`~solprop.driver.simulation.Simulation.with_input` — into the positions after +the entrance, the last exactly the length, so a count and the positions it stands for +are one run with one configuration hash. Resolved settings reused on a run of another +length are checked again: a position beyond the new end is refused and a shorter list +gains the new end. To carry a count instead, pass +`dataclasses.replace(settings, n_save=N, save_planes=None)`. An interior launch counts +over its own interval, and `with_input(..., initial_z=z)` keeps the observations +already resolved beyond `z`. A replayed `schedule=` must cover the run: its start at the +entrance, its end at the length to within the rounding its step sum accumulates +({py:func}`~solprop.stepper.schedule.replay_tolerance`). + +Every observation obeys `fields` and `field_planes`, so `fields="none"` still records +statistics at both ends without storing a field +([output](../results/output.md#statistics-only-planes-which-planes-keep-their-field)). +A short window of a long setup is therefore a shorter grid: shorten it and pin what the +longer length set, such as the absorber's `boundary_length`. + ### A table or mode as the GNLSE fibre Give exactly one of `betas`, `beta` and `fibre`, and one of `gamma` and `n2`. @@ -397,7 +452,7 @@ simulation = Simulation( pulse, settings=SimulationSettings( controller=PIController(rtol=1e-9, atol=1e-18), - save_planes=[0.25, 0.5, 0.75, 1.0], + n_save=5, # the entrance, 0.25, 0.5, 0.75 and grid.length dz_max=0.1, dz_init=1e-4, ), diff --git a/src/solprop/driver/simulation.py b/src/solprop/driver/simulation.py index 88ae815af..1055acd61 100644 --- a/src/solprop/driver/simulation.py +++ b/src/solprop/driver/simulation.py @@ -298,8 +298,9 @@ class Simulation(Displayed): settings : SimulationSettings How to step it, what to record and which backend to use. initial_z : float, optional - Absolute position of an array input, m, default zero. Every requested save - plane must follow it. An interior launch keeps the original profiles and + Absolute position of an array input, m, default zero, before + ``grid.length``: the run records ``[initial_z, grid.length]`` (SEP 51), a count + spread over that interval. An interior launch keeps the original profiles and propagation frame; it requires a modal array input, no noise and no fixed step schedule. noise : solprop.noise.NoiseRealisation or None, optional @@ -545,17 +546,17 @@ def settings(self) -> SimulationSettings: # numpydoc ignore=RT01 def settings(self, settings: SimulationSettings) -> None: """Replace settings; after translation, execution resources alone. - Parameters - ---------- - settings : SimulationSettings - The replacement. - The replacement is adopted as the constructor adopts its settings (SEP 51): validated against this run's interval ``[initial_z, grid.length]`` and resolved into the positions after the entrance, ending exactly at the length, before anything is compared, so a count and the positions it resolves to are the same setting. + Parameters + ---------- + settings : SimulationSettings + The replacement. + Raises ------ DriverError @@ -723,7 +724,7 @@ def translate(self) -> PropagationProblem: initial_z=self.initial_z, # Simulation.__init__ refuses a missing controller. controller=cast("PIController", settings.controller), - save_planes=settings.save_planes, + save_planes=np.asarray(settings.save_planes), dz_max=settings.dz_max, dz_init=settings.dz_init, dz_min=settings.dz_min, @@ -828,7 +829,8 @@ def input_port(self, z: float | None = None) -> InputPort: ) raise DriverError(msg) if z is not None and not ( - math.isfinite(z) and 0.0 <= z < float(np.max(self.settings.save_planes)) + math.isfinite(z) + and 0.0 <= z < float(np.max(np.asarray(self.settings.save_planes))) ): msg = f"an interior entrance lies inside the run, got z = {z!r} m" raise DriverError(msg) @@ -2063,7 +2065,9 @@ def from_free( columns, on a radial grid; a Cartesian DFT spectrum in V/m, ``n_x*n_y`` columns, otherwise. settings : SimulationSettings - Step tolerances, positive save positions in m, statistics and backend. + Step tolerances, the saved planes (``n_save`` or positions in m over + ``[0, grid.length]``; the run ends at ``grid.length``), statistics and + backend. Absolute tolerance has the input spectrum's units. frame : solprop.linear.Frame or None, optional Moving frame. None uses the declared responses' THG choice. @@ -2190,7 +2194,9 @@ def from_planar( amplitudes in sqrt(W/m), shape ``(n_p*n_y, 1, n_omega)``, the mode index fastest. Any other pulse is refused by name. settings : SimulationSettings - Step tolerances, positive save positions in m, statistics and backend. + Step tolerances, the saved planes (``n_save`` or positions in m over + ``[0, grid.length]``; the run ends at ``grid.length``), statistics and + backend. Absolute tolerance has the input spectrum's units, sqrt(W/m). frame : solprop.linear.Frame or None, optional Moving frame. None uses the declared responses' THG choice, following @@ -2461,7 +2467,8 @@ def from_gnlse( A fixed schedule to replay instead of stepping adaptively, which makes a run bit-identical on re-running (``docs/dev/stepper.md`` section 8). Its edges must contain every save plane, which - :meth:`solprop.stepper.schedule.FixedSchedule.uniform` guarantees. + :meth:`solprop.stepper.schedule.FixedSchedule.uniform` guarantees, and it + must cover the run, from the entrance to the length (SEP 51). integrator : Multistep, RungeKutta or LowStorageRungeKutta, optional The method that steps the run (``docs/guide/numerics/choosing-a-stepper.md``). ``None``, the default, @@ -2478,12 +2485,13 @@ def from_gnlse( Also save the end of every `step_planes`-th accepted step, the march's own positions, beside the requested planes (SEP 14); ``None``, the default, and ``0`` save the requested planes only. - save_planes : array_like, optional - Positions along the fibre to save at, m, increasing and positive; the plane - at ``z = 0`` is saved as well. Give this or `n_save`. - n_save : int, optional - Number of planes to store, counting the one at ``z = 0``, spread evenly over - the fibre. Default 201. + save_planes : sequence of float or None, optional + Positions to record the run at, m, finite, strictly increasing and inside + ``[0, length]``; the entrance and the end are added when absent, and an + empty list records them alone (SEP 51). Give this or `n_save`. + n_save : int or None, optional + How many evenly spaced observations to record over the run, both ends + included: an integer of at least 2. Default 201. stats : solprop.stats.StatsSpec, optional Which statistics to record at every plane; ``None`` records :func:`solprop.stats.default_spec` of a mode-averaged run. A ``periodic`` @@ -2969,9 +2977,12 @@ def from_capillary( ``1`` with a `tdse` response, which saves every accepted step without imposing a landing (SEP 20 section 5.8). save_planes : sequence of float or None, optional - Positions to save at, m. Give this or `n_save`. + Positions to record the run at, m, finite, strictly increasing and inside + ``[0, length]``; the entrance and the end are added when absent, and an + empty list records them alone (SEP 51). Give this or `n_save`. n_save : int or None, optional - How many planes to save, counting ``z = 0``. + How many evenly spaced observations to record over the run, both ends + included: an integer of at least 2. stats : solprop.stats.StatsSpec or None, optional Which statistics to record; ``None`` takes :func:`solprop.stats.default_spec` with the profiles, for a multimode run @@ -3445,9 +3456,12 @@ def from_waveguide( march's own positions, beside the requested planes (SEP 14); ``None``, the default, and ``0`` save the requested planes only. save_planes : sequence of float or None, optional - Positions to save at, m. Give this or `n_save`. + Positions to record the run at, m, finite, strictly increasing and inside + ``[0, length]``; the entrance and the end are added when absent, and an + empty list records them alone (SEP 51). Give this or `n_save`. n_save : int or None, optional - How many planes to save, counting ``z = 0``. + How many evenly spaced observations to record over the run, both ends + included: an integer of at least 2. stats : solprop.stats.StatsSpec or None, optional Which statistics to record; ``None`` takes :func:`solprop.stats.default_spec` with the profiles, for a multimode run From 44e7a925665977b48498c98010d5c4a096da9b14 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 02:16:37 +0000 Subject: [PATCH 08/20] docs: word SEP 51's interim deviation without a role name [skip ci] Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- docs/dev/seps/sep-0051-save-planes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/dev/seps/sep-0051-save-planes.md b/docs/dev/seps/sep-0051-save-planes.md index dbc3fd34e..c61be312d 100644 --- a/docs/dev/seps/sep-0051-save-planes.md +++ b/docs/dev/seps/sep-0051-save-planes.md @@ -627,7 +627,7 @@ That count is what decided the first deviation below. 1. *`length` is optional but stays positional-or-keyword* (§5.1, Q7 item 6). Making it keyword-only would edit about 509 calls in 227 files and regenerate 43 galleries. This - is an interim decision of the coordinator, pending with the maintainer; the signature + is an interim choice, pending with the maintainer; the signature change is one commit, so the keyword-only form can follow as one mechanical commit. Because Python allows no required parameter after an optional one, `from_capillary`'s and `prop_capillary`'s `gas` now defaults to `None` and is refused From a7431a61c5bb05b5ca36083ca082d66b3bca892a Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 02:45:08 +0000 Subject: [PATCH 09/20] Fit three more tests to SEP 51: refusal messages, a listed entrance, staged radial runs The staged radial relaunch runs each stage on the window cut at its length, with the collar the whole window gave, so the stages and the whole run share one absorber and the 1e-10 agreement holds unchanged. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- tests/driver/test_coupling_relaunch.py | 8 +++++++- tests/driver/test_parameter_paths.py | 2 +- tests/driver/test_run.py | 7 +++---- 3 files changed, 11 insertions(+), 6 deletions(-) diff --git a/tests/driver/test_coupling_relaunch.py b/tests/driver/test_coupling_relaunch.py index 9d0ed361e..6c6c7e9ce 100644 --- a/tests/driver/test_coupling_relaunch.py +++ b/tests/driver/test_coupling_relaunch.py @@ -16,6 +16,7 @@ import numpy as np import pytest +from builders import grid_at, held_collar from solprop.backends.registry import available from solprop.coupling import CouplingModel, couple from solprop.driver import Simulation, SimulationSettings @@ -127,7 +128,11 @@ def test_an_interior_relaunch_continues_its_own_run(reference): def radial(pressure=1.0, length=2e-3, backend="numpy_ref"): - grid = FieldGrid.from_limits(2e-3, 800e-9, (600e-9, 1.2e-6), 400e-15) + window = FieldGrid.from_limits(2e-3, 800e-9, (600e-9, 1.2e-6), 400e-15) + # A run ends at its grid's length (SEP 51): a stage runs on the window cut at its + # length, with the collar the whole two millimetres gave, so every stage and the + # whole run share one absorber. + grid = grid_at(window, length) settings = SimulationSettings( controller=PIController(rtol=1e-10, atol=1e-16), save_planes=np.linspace(0.0, length, 3)[1:], @@ -145,6 +150,7 @@ def radial(pressure=1.0, length=2e-3, backend="numpy_ref"): [], pulse, settings=settings, + absorber=held_collar(grid, window.length), noise=None, ) diff --git a/tests/driver/test_parameter_paths.py b/tests/driver/test_parameter_paths.py index 9e112ed73..9ac2bbe49 100644 --- a/tests/driver/test_parameter_paths.py +++ b/tests/driver/test_parameter_paths.py @@ -184,7 +184,7 @@ def _parameters(records: pytest.WarningsRecorder) -> list[ParameterPath | None]: lambda: _gnlse(save_planes=[0.01, 0.005], n_save=None), DriverError, "save_planes", - "positive and increasing", + "must increase strictly", id="gnlse-planes-order", ), pytest.param( diff --git a/tests/driver/test_run.py b/tests/driver/test_run.py index 42c940e9a..6f4f54d29 100644 --- a/tests/driver/test_run.py +++ b/tests/driver/test_run.py @@ -548,11 +548,10 @@ def test_the_loop_runs_without_a_simulation(narrow_grid, soliton): @pytest.mark.parametrize( ("save_planes", "message"), - [([1.0, 0.5], "positive and increasing"), ([0.0, 0.5], "saved anyway")], + [([1.0, 0.5], "must increase strictly"), ([0.5, 0.5], "repeats")], ) -def test_the_settings_refuse_save_planes_out_of_order_or_at_the_entrance( - save_planes, message -): +def test_the_settings_refuse_save_planes_out_of_order_or_repeated(save_planes, message): + # The entrance may be listed (SEP 51 D8): it is kept once, at adoption. with pytest.raises(DriverError, match=message): SimulationSettings( controller=PIController(rtol=1e-8, atol=1e-18), From 97d5b319113eb47dca30e1abb765c32adcc72064 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 02:52:16 +0000 Subject: [PATCH 10/20] Test resume to the declared end, replay drift and resolved defaults (SEP 51) An interrupted file, one holding a terminal checkpoint and a completed one resume to the grid's length, directly and through recipe.resume_file. from_history and uniform schedules whose step sums end below or above the length within replay_tolerance are accepted, and histories that stop short, run past or start late are refused before they run. A run rebuilt from its file's resolved recipe keeps its hash when DEFAULT_N_SAVE changes, and the TDSE capillary's two observations and natural steps are written out in its resolved document. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- docs/dev/seps/sep-0051-save-planes.md | 12 +- tests/driver/test_save_planes.py | 180 ++++++++++++++++++++++++-- tests/recipe/test_save_planes.py | 76 ++++++++++- 3 files changed, 255 insertions(+), 13 deletions(-) diff --git a/docs/dev/seps/sep-0051-save-planes.md b/docs/dev/seps/sep-0051-save-planes.md index c61be312d..f70329603 100644 --- a/docs/dev/seps/sep-0051-save-planes.md +++ b/docs/dev/seps/sep-0051-save-planes.md @@ -673,10 +673,14 @@ coverage lane, `native/tests`, the front-end gate and the galleries; CI is the g the changed tests moved; §3 does not list them. - `test_modal_launch.py`'s general runs keep the default first step, which is a fraction of the length and refined by the start-up rule; their checks are of the launch. -- No new test resumes a file to its declared end: resume already reads the last - requested plane of the request, which now ends at the length, and the existing resume - modules pass. Replay from `FixedSchedule.from_history` and the TDSE capillary's - resolved recipe are not tested here. +- A recipe cannot hold a TDSE response (`tdse` has no recipe form), so the TDSE + capillary's resolved recipe is checked at construction, through `resolved_document`, + not round-tripped through `Recipe.from_output`. Added after review: + `tests/driver/test_save_planes.py` resumes an interrupted file, one holding a terminal + checkpoint and a completed one to the length, directly and through + `recipe.resume_file`, and replays `from_history` and `uniform` schedules drifting + below and above the length; `tests/recipe/test_save_planes.py` rebuilds a run from its + file's resolved recipe with `DEFAULT_N_SAVE` changed, keeping its hash. **Open questions.** diff --git a/tests/driver/test_save_planes.py b/tests/driver/test_save_planes.py index da7c4e36e..bf7321b8d 100644 --- a/tests/driver/test_save_planes.py +++ b/tests/driver/test_save_planes.py @@ -19,18 +19,26 @@ import pytest from builders import grid_at +from solprop.backends.numpy_ref import NumpyRefBackend from solprop.driver import Simulation, SimulationSettings from solprop.driver.settings import DEFAULT_N_SAVE, _observation_planes from solprop.exceptions import DriverError from solprop.grid import EnvelopeGrid -from solprop.stepper import FixedSchedule, LowStorageRungeKutta, Multistep -from solprop.stepper.schedule import LANDING_ULPS +from solprop.log import NullReporter +from solprop.output.hdf5 import resume +from solprop.recipe import Recipe, resume_file +from solprop.stats import StatsSpec +from solprop.stepper import FixedSchedule, LowStorageRungeKutta, Multistep, RungeKutta +from solprop.stepper.schedule import LANDING_ULPS, replay_tolerance LENGTH = 1e-5 """The tiny fibre's length, m: ten micrometres.""" STEPS = {"dz_max": 1e-6, "dz_init": 1e-6} +ULP = math.ulp(LENGTH) +"""One representable increment at the run's end, m.""" + def grid(length: float = LENGTH) -> EnvelopeGrid: """Return the tiny fibre's grid.""" @@ -314,16 +322,69 @@ def test_a_capillary_without_its_gas_is_refused(): # ---------------------------------------------------------------- replay schedules +def history(steps: np.ndarray, z_start: float = 0.0) -> FixedSchedule: + """Return the schedule a run that accepted `steps` from `z_start` records.""" + starts = z_start + np.concatenate(([0.0], np.cumsum(steps)[:-1])) + return FixedSchedule.from_history(starts, steps) + + +def drift(schedule: FixedSchedule) -> float: + """Return how far a schedule's step sum ends from the run's length, in ulps.""" + return (schedule.z_end - LENGTH) / math.ulp(LENGTH) + + @pytest.mark.parametrize( - "steps", - [np.full(160, LENGTH / 160), np.full(1000, LENGTH / 1000)], - ids=["drifts-below", "drifts-above"], + ("schedule", "below"), + [ + # 160 and 300 equal steps of a 10 um run end 13 ulps short and 21 ulps past + # it: beyond the landing slack, within replay_tolerance's step count. + (history(np.full(160, LENGTH / 160)), True), + (history(np.full(300, LENGTH / 300)), False), + (FixedSchedule.uniform(0.0, LENGTH - 3 * math.ulp(LENGTH), LENGTH / 100), True), + ( + FixedSchedule.uniform(0.0, LENGTH + 3 * math.ulp(LENGTH), LENGTH / 100), + False, + ), + ], + ids=["history-below", "history-above", "uniform-below", "uniform-above"], ) -def test_a_replayed_schedule_whose_sum_drifts_within_its_tolerance_is_accepted(steps): - schedule = FixedSchedule(steps) - assert schedule.z_end != LENGTH +def test_a_replayed_schedule_whose_sum_drifts_within_its_tolerance_is_accepted( + schedule, below +): + assert (drift(schedule) < 0) == below and drift(schedule) != 0 + assert abs(schedule.z_end - LENGTH) <= replay_tolerance(schedule, LENGTH) simulation = fibre(schedule=schedule, integrator=LowStorageRungeKutta(), n_save=2) assert simulation.settings.schedule is schedule + assert np.asarray(simulation.settings.save_planes)[-1] == LENGTH + + +def test_an_adaptive_run_s_own_history_replays_over_the_same_run(): + # No collar, whose in-stage stability would cap the replayed steps. + run = fibre(n_save=2, integrator=RungeKutta(), absorber=False).run(progress="none") + schedule = FixedSchedule.from_history( + np.asarray(run["step_history/z"]), + np.asarray(run["step_history/h"]), + np.asarray(run["step_history/accepted"]), + ) + replayed = fibre( + n_save=2, integrator=RungeKutta(), absorber=False, schedule=schedule + ) + assert replayed.run(progress="none")["z"][-1] == LENGTH + + +@pytest.mark.parametrize( + "schedule", + [ + history(np.full(10, LENGTH / 20)), + history(np.full(30, LENGTH / 20)), + history(np.full(10, LENGTH / 10), z_start=LENGTH / 10), + ], + ids=["shorter", "longer", "late-start"], +) +def test_a_history_that_does_not_cover_the_run_is_refused_before_it_runs(schedule): + with pytest.raises(DriverError, match="the replayed schedule") as refused: + fibre(schedule=schedule, integrator=LowStorageRungeKutta(), n_save=2) + assert refused.value.rule == "replay-interval" def test_a_uniform_schedule_over_the_run_is_accepted(): @@ -355,3 +416,106 @@ def test_an_interior_launch_still_refuses_a_schedule(): DriverError, match="refuses the modified noise model and a fixed" ): adopted(simulation, replay, initial_z=4e-6) + + +# ------------------------------------------------------- resume to the declared end + + +class CrashError(RuntimeError): + """What an interrupted run raises, standing in for a machine going away.""" + + +class Interrupt(NullReporter): + """Stop a run once it has saved `after` planes.""" + + def __init__(self, after: int) -> None: + self.after, self.seen = after, 0 + + def plane(self, z: float, summary: object) -> None: + del z, summary + self.seen += 1 + if self.seen >= self.after: + raise CrashError(f"stopped after plane {self.seen}") + + +def resumable(**keywords) -> Simulation: + """Return the tiny fibre with five observations, one statistic at each.""" + return fibre( + n_save=5, + integrator=RungeKutta(), + stats=StatsSpec(names=("energy",)), + **keywords, + ) + + +def ends_complete(path) -> None: + """Assert a file holds its whole run, ending at the grid's length.""" + state = resume(path) + assert state.plane.z == LENGTH + assert state.n_saved == 5 + assert state.checkpoint is None + assert state.outcome is not None and state.outcome.status == "complete" + + +def test_an_interrupted_file_resumes_to_the_declared_end(tmp_path): + path = tmp_path / "run.h5" + with pytest.raises(CrashError): + resumable().run(path, progress=Interrupt(2)) + assert resume(path).plane.z < LENGTH + resumable().run(path, resume=True, progress="none") + ends_complete(path) + + +def test_a_file_holding_a_terminal_checkpoint_resumes_to_the_declared_end( + tmp_path, monkeypatch +): + path = tmp_path / "run.h5" + original = NumpyRefBackend.stats + calls: list[int] = [] + + def fail_at_the_end(self, spec): + calls.append(1) + if len(calls) == 5: + raise CrashError("the last plane's statistics failed") + return original(self, spec) + + with monkeypatch.context() as patch: + patch.setattr(NumpyRefBackend, "stats", fail_at_the_end) + with pytest.raises(CrashError): + resumable().run(path, progress="none") + stopped = resume(path) + # The march reached the end; its last plane was never saved. + assert stopped.checkpoint is not None and stopped.n_saved < 5 + resumable().run(path, resume=True, progress="none") + ends_complete(path) + + +def test_a_completed_file_resumes_to_its_end_and_saves_nothing_more(tmp_path): + path = tmp_path / "run.h5" + resumable().run(path, progress="none") + resumable().run(path, resume=True, progress="none") + ends_complete(path) + + +def test_a_recipe_s_file_resumes_to_the_declared_end_from_the_file_alone(tmp_path): + recipe = Recipe.from_keywords( + "gnlse", + gamma=0.0, + length=LENGTH, + betas=[0.0, 0.0, -1e-26], + wavelength=800e-9, + wavelength_limits=[500e-9, 1.6e-6], + trange=200e-15, + fwhm=20e-15, + peak_power=1.0, + n_save=5, + backend="numpy_ref", + noise=None, + dz_max=1e-6, + dz_init=1e-6, + ) + path = tmp_path / "run.h5" + with pytest.raises(CrashError): + recipe.build().run(path, progress=Interrupt(2)) + resume_file(path, progress="none") + ends_complete(path) diff --git a/tests/recipe/test_save_planes.py b/tests/recipe/test_save_planes.py index 73a63f522..c76479d87 100644 --- a/tests/recipe/test_save_planes.py +++ b/tests/recipe/test_save_planes.py @@ -12,14 +12,19 @@ """ import warnings -from typing import cast +from typing import Any, cast import numpy as np import pytest +from driver.test_tdse_entry import _LENGTH as TDSE_LENGTH +from driver.test_tdse_entry import _sae as tdse_response from recipe.test_free_space import RADIAL from recipe.test_recipe import GNLSE +from solprop.driver import Simulation from solprop.driver import settings as settings_module +from solprop.exceptions import MaterialRangeWarning +from solprop.output.hdf5 import open_file from solprop.recipe import Recipe, RecipeError, provenance pytestmark = pytest.mark.filterwarnings("ignore::solprop.exceptions.BoundaryWarning") @@ -148,3 +153,72 @@ def test_a_keyword_route_s_resolved_recipe_drops_its_count(): assert "n_save" not in document["build"] assert document["build"]["save_planes"] == [0.005, 0.01] assert _hash(Recipe.from_dict(document).build()) == _hash(simulation) + + +# ------------------------------------------------- defaults written out resolved + + +def tiny_fibre() -> Recipe: + """Return a ten-micrometre GNLSE recipe with no plane selector.""" + return Recipe.from_keywords( + "gnlse", + gamma=0.0, + length=1e-5, + betas=[0.0, 0.0, -1e-26], + wavelength=800e-9, + wavelength_limits=[500e-9, 1.6e-6], + trange=200e-15, + fwhm=20e-15, + peak_power=1.0, + backend="numpy_ref", + noise=None, + dz_max=1e-6, + dz_init=1e-6, + ) + + +def test_a_rebuilt_run_keeps_its_hash_when_the_default_count_changes( + tmp_path, monkeypatch +): + path = tmp_path / "run.h5" + tiny_fibre().build().run(path, progress="none") + with open_file(path) as stored: + assert stored.metadata is not None + recorded = stored.metadata.configuration_hash() + monkeypatch.setattr(settings_module, "DEFAULT_N_SAVE", 11) + assert np.asarray(tiny_fibre().build().settings.save_planes).size == 10 + rebuilt = Recipe.from_output(path, resolved=True).build() + assert _hash(rebuilt) == recorded + + +def test_the_tdse_capillary_s_defaults_are_written_out_resolved(): + """A recipe cannot hold a TDSE response (``tdse`` has no recipe form), so the + resolved document is checked at construction: the route's two observations and + every natural step are written as values, not left to the defaults.""" + keywords: dict[str, Any] = { + "radius": 256e-6, + "length": TDSE_LENGTH, + "gas": "He", + "pressure": 0.1, + "wavelength": 800e-9, + "wavelength_limits": [400e-9, 1.6e-6], + "trange": 60e-15, + "fwhm": 6e-15, + "energy": 1e-12, + "modes": 1, + "n_r": 4, + "noise": None, + "dz_init": 2.0**-20, + "dz_max": 2.0**-20, + } + recipe = Recipe.from_keywords("capillary", **keywords) + # Python takes the window's limits as a pair, the recipe as a list. + python: dict[str, Any] = keywords | {"wavelength_limits": (400e-9, 1.6e-6)} + with warnings.catch_warnings(): + warnings.simplefilter("ignore", MaterialRangeWarning) + simulation = Simulation.from_capillary(**python, tdse=tdse_response()) + document = provenance.resolved_document(recipe, simulation) + build = document["build"] + assert build["save_planes"] == [TDSE_LENGTH] + assert build["step_planes"] == 1 + assert "n_save" not in build From c30700defaaa1311026ff32ab0ff5326ecf3d6f6 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 02:34:02 +0000 Subject: [PATCH 11/20] Give the sheets SEP 51's two forms of saved planes Every sheet's Saved planes row offers Evenly spaced (n_save) and Explicit positions (save_planes). An entry in one form unsets the other in the same undoable edit, a setup opens on the form it holds, and an issue on the positions shows at the row. The object sheets' expansion of a count into a list, and its rewriting when the length changes, are gone. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- gui/src/solprop_gui/classes/catalog.py | 22 ++--- gui/src/solprop_gui/classes/problem.py | 93 ++++++++------------ gui/src/solprop_gui/ui/fields.py | 45 ++++++++-- gui/src/solprop_gui/ui/sheet.py | 61 ++++++++++--- gui/tests/test_classes.py | 116 ++++++++++++++++++++++--- gui/tests/test_ui_workflow.py | 110 +++++++++++++++++++++-- 6 files changed, 339 insertions(+), 108 deletions(-) diff --git a/gui/src/solprop_gui/classes/catalog.py b/gui/src/solprop_gui/classes/catalog.py index 2e510d9c2..4586d6754 100644 --- a/gui/src/solprop_gui/classes/catalog.py +++ b/gui/src/solprop_gui/classes/catalog.py @@ -66,7 +66,7 @@ ( Field("wavelength_limits", "Wavelengths"), Field("trange", "Time window"), - Field("n_save", "Saved planes"), + Field("n_save", "Saved planes", positions="save_planes"), ), folded=True, ) @@ -187,7 +187,7 @@ ), ), Field("medium.pressure", "Pressure"), - Field("grid.length", "Propagate", moves_planes="settings.save_planes"), + Field("grid.length", "Propagate"), ), ), Section( @@ -233,7 +233,7 @@ Field("grid.wavelength_limits", "Wavelengths"), Field("grid.trange", "Time window"), Field( - "settings.save_planes", "Saved planes", planes_over="grid.length" + "settings.n_save", "Saved planes", positions="settings.save_planes" ), ), folded=True, @@ -300,7 +300,7 @@ ( Field("grid.wavelength_limits", "Wavelengths"), Field("grid.trange", "Time window"), - Field("n_save", "Saved planes"), + Field("n_save", "Saved planes", positions="save_planes"), ), folded=True, ), @@ -359,7 +359,7 @@ ( Field("wavelength_limits", "Wavelengths"), Field("trange", "Time window"), - Field("n_save", "Saved planes"), + Field("n_save", "Saved planes", positions="save_planes"), ), folded=True, ), @@ -411,7 +411,7 @@ ( Field("grid.wavelength_limits", "Wavelengths"), Field("grid.trange", "Time window"), - Field("n_save", "Saved planes"), + Field("n_save", "Saved planes", positions="save_planes"), ), folded=True, ), @@ -447,7 +447,7 @@ also=("responses[*].chi3.gas",), ), Field("medium.pressure", "Pressure"), - Field("grid.length", "Propagate", moves_planes="settings.save_planes"), + Field("grid.length", "Propagate"), ), ), Section( @@ -501,7 +501,7 @@ Field("grid.wavelength_limits", "Wavelengths"), Field("grid.trange", "Time window"), Field( - "settings.save_planes", "Saved planes", planes_over="grid.length" + "settings.n_save", "Saved planes", positions="settings.save_planes" ), ), folded=True, @@ -545,7 +545,7 @@ also=("responses[*].chi3.gas",), ), Field("medium.pressure", "Pressure"), - Field("grid.length", "Propagate", moves_planes="settings.save_planes"), + Field("grid.length", "Propagate"), ), ), Section( @@ -581,7 +581,7 @@ Field("grid.wavelength_limits", "Wavelengths"), Field("grid.trange", "Time window"), Field( - "settings.save_planes", "Saved planes", planes_over="grid.length" + "settings.n_save", "Saved planes", positions="settings.save_planes" ), ), folded=True, @@ -635,7 +635,7 @@ Field("grid.wavelength_limits", "Wavelengths"), Field("grid.trange", "Time window"), Field( - "settings.save_planes", "Saved planes", planes_over="grid.length" + "settings.n_save", "Saved planes", positions="settings.save_planes" ), ), folded=True, diff --git a/gui/src/solprop_gui/classes/problem.py b/gui/src/solprop_gui/classes/problem.py index da2f76b38..0baa03648 100644 --- a/gui/src/solprop_gui/classes/problem.py +++ b/gui/src/solprop_gui/classes/problem.py @@ -25,7 +25,6 @@ "Target", "derived_text", "derived_value", - "even_planes", "field_changes", "field_meta", "field_value", @@ -58,10 +57,9 @@ class Field: negated : bool Whether the row shows the value with its sign changed, as a distance to a focus is the launch's distance from it. - planes_over : str or None - Makes this a count of evenly spaced saved planes, over the length at this path. - moves_planes : str or None - The saved planes at this path, which this length respaces. + positions : str or None + Makes this the saved planes' row (SEP 51): it holds either the count of evenly + spaced planes at its path or the explicit positions at this path, never both. member : str or None Makes this a switch: whether a list at the path holds an entry of this type. goes_with : tuple of str @@ -76,8 +74,7 @@ class Field: choices: str | None = None also: tuple[str, ...] = () negated: bool = False - planes_over: str | None = None - moves_planes: str | None = None + positions: str | None = None member: str | None = None goes_with: tuple[str, ...] = () blank: str | None = None @@ -460,10 +457,18 @@ def sheet_paths(problem: ProblemClass) -> Iterator[str]: ... ) >>> list(sheet_paths(problem)) ['radius', 'length'] + >>> planes = (Field("n_save", positions="save_planes"),) + >>> problem = ProblemClass( + ... "c", "C", "", "gnlse", "soliton", (Section("S", planes),), (), "" + ... ) + >>> list(sheet_paths(problem)) + ['n_save', 'save_planes'] """ for section in problem.sections: for row in section.fields: yield row.path + if row.positions is not None: + yield row.positions def field_meta( @@ -641,35 +646,6 @@ def negated_value(value: object) -> object: return f"{flipped} {unit}".strip() -def even_planes(count: int, length: object) -> list[object]: - """Return evenly spaced saved planes along a length, ending at it. - - Parameters - ---------- - count : int - How many, the entrance not counted. - length : object - The length, a quantity string or a number. - - Returns - ------- - list - The positions, in the length's own unit. - - Examples - -------- - >>> even_planes(2, "25 cm") - ['12.5 cm', '25 cm'] - >>> even_planes(2, 1.0) - [0.5, 1.0] - """ - if isinstance(length, int | float): - return [float(length) * index / count for index in range(1, count + 1)] - number, unit = split(str(length)) - total = float(number) - return [f"{total * index / count:.8g} {unit}" for index in range(1, count + 1)] - - def field_value(row: Field, build: Mapping[str, object]) -> object: """Return what a sheet's row shows of a recipe. @@ -683,13 +659,16 @@ def field_value(row: Field, build: Mapping[str, object]) -> object: Returns ------- object - The value as the row shows it; a switch's is whether its entry is there. + The value as the row shows it; a switch's is whether its entry is there, and + the saved planes' row shows the positions the recipe lists or else its count. Examples -------- >>> build = {"planes": ["1 m", "2 m"], "launch": "-5 cm", "list": [{"type": "A"}]} - >>> field_value(Field("planes", planes_over="length"), build) - 2 + >>> field_value(Field("count", positions="planes"), build) + ['1 m', '2 m'] + >>> field_value(Field("count", positions="planes"), {"count": 81}) + 81 >>> field_value(Field("launch", negated=True), build) '5 cm' >>> field_value(Field("list", member="A"), build) @@ -704,8 +683,9 @@ def field_value(row: Field, build: Mapping[str, object]) -> object: isinstance(entry, Mapping) and entry.get("type") == row.member for entry in entries ) - if row.planes_over is not None: - return len(held) if isinstance(held, Sequence) else MISSING + if row.positions is not None: + listed = _held(build, row.positions) + return held if listed is MISSING else listed return negated_value(held) if row.negated else held @@ -775,8 +755,9 @@ def field_changes( ) -> list[tuple[str, object]]: """Return what a sheet's row changes in a recipe. - The object routes write some values several times, and a run's length as its last - saved plane (#533), so one row can move several paths. + The object routes write some values several times, so one row can move several + paths. The saved planes' row writes a list as the positions and anything else as + the count, and unsets the other in the same change, so a recipe never holds both. Parameters ---------- @@ -802,28 +783,24 @@ def field_changes( >>> build = {"gas": "Ar", "list": [{"gas": "Ar"}], "planes": ["1 m", "2 m"]} >>> field_changes(problem, Field("gas", also=("list[*].gas",)), "He", build) [('gas', 'He'), ('list[0].gas', 'He')] - >>> field_changes(problem, Field("length", moves_planes="planes"), "4 m", build) - [('length', '4 m'), ('planes', ['2 m', '4 m'])] - >>> build["length"] = "6 m" - >>> field_changes(problem, Field("planes", planes_over="length"), 3, build) - [('planes', ['2 m', '4 m', '6 m'])] + >>> planes = Field("count", positions="planes") + >>> field_changes(problem, planes, 81, build) + [('count', 81), ('planes', MISSING)] + >>> field_changes(problem, planes, ["5 cm"], build) + [('planes', ['5 cm']), ('count', MISSING)] >>> field_changes(problem, Field("x", negated=True), "5 cm", build) [('x', '-5 cm')] """ if row.member is not None: return _switched(problem, row, bool(value), build, example or {}) - if row.planes_over is not None: - length = _held(build, row.planes_over) - return [(row.path, even_planes(int(value), length))] # pyright: ignore[reportArgumentType] + if row.positions is not None: + if isinstance(value, list): + return [(row.positions, value), (row.path, MISSING)] + return [(row.path, value), (row.positions, MISSING)] written = negated_value(value) if row.negated else value changes: list[tuple[str, object]] = [(row.path, written)] for pattern in row.also: changes += [(path, written) for path in linked_paths(build, pattern)] - if row.moves_planes is not None and value is not MISSING: - held = _held(build, row.moves_planes) - count = len(held) if isinstance(held, Sequence) else 0 - if count: - changes.append((row.moves_planes, even_planes(count, value))) return changes @@ -859,10 +836,12 @@ def other_keywords( """ # A switch shows one entry of a list: the rest of the list is reachable only there. shown = { - row.path + path for section in problem.sections for row in section.fields if row.member is None + for path in (row.path, row.positions) + if path is not None } entries: Sequence[Mapping[str, object]] = description["parameters"] # pyright: ignore[reportAssignmentType] return [entry for entry in entries if entry.get("name") not in shown] diff --git a/gui/src/solprop_gui/ui/fields.py b/gui/src/solprop_gui/ui/fields.py index 9ce02059f..0b46b67f9 100644 --- a/gui/src/solprop_gui/ui/fields.py +++ b/gui/src/solprop_gui/ui/fields.py @@ -16,11 +16,13 @@ - anything else (a mapping, an array) is a line of inline TOML. Where a keyword takes several forms (a constant pressure or a gradient), a small -picker chooses the form. The launch is a table of modes; a keyword solprop can pin to -a design target offers "pinned" too, whose entry goes in the recipe's ``[pins]`` -table in place of the value. Leaving a field empty, or picking the default, unsets the -keyword so that solprop's default applies and follows solprop's improvements; the -reset button does the same for any form. +picker chooses the form. A sheet's row may name its forms instead (``mode_titles``), +as the saved planes' "Evenly spaced" and "Explicit positions" are: each editor then +shows only a value of its own kind. The launch is a table of modes; a keyword solprop +can pin to a design target offers "pinned" too, whose entry goes in the recipe's +``[pins]`` table in place of the value. Leaving a field empty, or picking the default, +unsets the keyword so that solprop's default applies and follows solprop's +improvements; the reset button does the same for any form. """ from collections.abc import Mapping, Sequence @@ -217,6 +219,8 @@ def __init__( # noqa: PLR0912, PLR0915 - one widget per form self.issue.hide() self.choice_titles: Mapping[str, str] = meta.get("choice_titles") or {} # pyright: ignore[reportAttributeAccessIssue] + self.mode_titles: Mapping[str, str] = meta.get("mode_titles") or {} # pyright: ignore[reportAttributeAccessIssue] + self._text_shown = "" self.modes = modes_of(self.forms, self.catalog, self.name) self.stack = QStackedWidget() self.editors: dict[str, QWidget] = {} @@ -310,7 +314,7 @@ def make_row(child: Mapping[str, object]) -> QWidget: self.mode = QComboBox() self.mode.setObjectName(f"mode-{self.name}") for mode in self.modes: - self.mode.addItem(_MODE_TITLES[mode], mode) + self.mode.addItem(self.mode_titles.get(mode, _MODE_TITLES[mode]), mode) self._update_picker() self.mode.setToolTip("The form of the value.") self.mode.currentIndexChanged.connect(self._mode_changed) @@ -474,6 +478,9 @@ def _fits(self, mode: str, value: object) -> bool: # noqa: PLR0911 - one per ed return any(c == value and type(c) is type(value) for c in self.choices) if mode == "pin": return False + if mode == "text" and self.mode_titles: + # Named forms are separate values: text holds what no other editor does. + return not any(self._fits(m, value) for m in self.modes if m != "text") if mode == "table": return launch_rows(value) is not None if mode == "object": @@ -541,9 +548,14 @@ def _show_mode(self, mode: str) -> None: def _update_picker(self) -> None: """Show the form picker where there is a real choice of form. - On a sheet, free text does not count as one, unless it is what holds the value. + On a sheet, free text does not count as one, unless it is what holds the value + or one of the row's named forms. """ - offered = [m for m in self.modes if m != "text" or not self.on_sheet] + offered = [ + m + for m in self.modes + if m != "text" or not self.on_sheet or self.mode_titles + ] shown = self.modes[self.mode.currentIndex()] if self.mode.count() else "" self.mode.setVisible(len(offered) > 1 or shown == "text") @@ -617,6 +629,8 @@ def _text_finished(self) -> None: if self._updating: return text = self.text.text().strip() + if self.mode_titles and text == self._text_shown: + return # left as shown, so nothing replaces the value another form holds if not text: value: object = MISSING else: @@ -713,11 +727,24 @@ def _show(self, value: object, mode: str) -> None: elif mode == "pin": pass # the pin shows its own entry (set_pin) else: - self.text.setText("" if unset else inline(value)) + blank = unset or not self._fits("text", value) + self._text_shown = "" if blank else inline(value) + self.text.setText(self._text_shown) self.text.setPlaceholderText(self._placeholder()) finally: self._updating = False + @property + def current_mode(self) -> str: + """Return the form whose editor shows, as :func:`modes_of` names it. + + Returns + ------- + str + The form. + """ + return self.modes[self.mode.currentIndex()] + @property def value(self) -> object: """Return the value the row holds. diff --git a/gui/src/solprop_gui/ui/sheet.py b/gui/src/solprop_gui/ui/sheet.py index cc0f795a6..4889a8c28 100644 --- a/gui/src/solprop_gui/ui/sheet.py +++ b/gui/src/solprop_gui/ui/sheet.py @@ -65,6 +65,9 @@ _NARROW = 1000 """Below this width, in pixels, the plot moves below the form.""" +_PLANE_MODES = {"number": "Evenly spaced", "text": "Explicit positions"} +"""The saved planes' two forms (SEP 51): a count of ``n_save``, or ``save_planes``.""" + class TargetEditor(QFrame): """The strip that asks what a derived number should be, and what moves to give it. @@ -507,7 +510,8 @@ def build( if meta is None: continue self._fields[row.path] = row - widget = self._row(self._entry(row, meta), catalog, on_sheet=True) + entry = self._entry(row, meta, description, build) + widget = self._row(entry, catalog, on_sheet=True) if row.blank is not None: for box in widget.findChildren(QLineEdit): if not box.placeholderText(): @@ -668,9 +672,20 @@ def _row_edited(self, path: str, table: str, value: object) -> None: if row is None or table != "build": self.edited.emit(path, table, value) return + widget = self.rows.get((path, table)) + explicit = widget is not None and widget.current_mode == "text" + if row.positions is not None and explicit and value is not MISSING: + # Typed as explicit positions, one value is a list of one (SEP 51). + value = value if isinstance(value, list) else [value] self._move(row, value) - def _entry(self, row: Field, meta: Mapping[str, object]) -> dict[str, object]: + def _entry( + self, + row: Field, + meta: Mapping[str, object], + description: Mapping[str, object], + build: Mapping[str, object], + ) -> dict[str, object]: """Return the metadata of a sheet's row: its path, its label, what it offers. Parameters @@ -679,6 +694,10 @@ def _entry(self, row: Field, meta: Mapping[str, object]) -> dict[str, object]: The sheet's row. meta : Mapping Its keyword's metadata. + description : Mapping + The kernel's description of the route. + build : Mapping + The open recipe's ``[build]`` table. Returns ------- @@ -691,10 +710,13 @@ def _entry(self, row: Field, meta: Mapping[str, object]) -> dict[str, object]: "name": row.path, "label": row.label or label(name), } - if row.planes_over is not None: - entry["forms"] = [{"kind": "integer", "minimum": 1}] - entry["default_value"] = None - entry["default"] = None + positions = None + if row.positions is not None: + positions = field_meta(row.positions, description, build) + if positions is not None: + # The saved planes' explicit positions are a second form beside the count. + entry["forms"] = [*_forms(meta), *_forms(positions)] + entry["mode_titles"] = _PLANE_MODES listed = self._lists.get(row.choices or "") if listed: forms: Sequence[Mapping[str, object]] = meta.get("forms", ()) # pyright: ignore[reportAssignmentType] @@ -1138,8 +1160,7 @@ def show_issues(self, issues: Sequence[Mapping[str, object]]) -> None: """ self._issues = list(issues) for issue in issues: - where = issue.get("parameter") - named = where if isinstance(where, list | tuple) else [where] + named = self._issue_paths(issue) # An issue on an Advanced keyword needs its row made to stand beside it. if ( any(path and (path, "build") not in self.rows for path in named) @@ -1149,9 +1170,7 @@ def show_issues(self, issues: Sequence[Mapping[str, object]]) -> None: for row in self.rows.values(): row.set_issue(None) for issue in issues: - where = issue.get("parameter") - paths = where if isinstance(where, list | tuple) else [where] - for path in paths: + for path in self._issue_paths(issue): keyword = issue_keyword(path)[0] if path else None for (name, _), row in self.rows.items(): if name in (path, keyword): @@ -1174,6 +1193,26 @@ def show_issues(self, issues: Sequence[Mapping[str, object]]) -> None: self.ready.setProperty("warn", bool(warnings) and not errors) repolish(self.ready) + def _issue_paths(self, issue: Mapping[str, object]) -> list[object]: + """Return the paths an issue names, as the sheet's rows are named. + + The saved planes' positions are shown in the row of their count. + + Parameters + ---------- + issue : Mapping + The issue. + + Returns + ------- + list + Its paths; ``None`` where it names none. + """ + where = issue.get("parameter") + paths = where if isinstance(where, list | tuple) else [where] + aliases = {f.positions: f.path for f in self._fields.values() if f.positions} + return [aliases.get(str(path), path) for path in paths] + def _show_ready(self) -> None: """Write the Ready line: solprop's verdict, and the run's size where known.""" parts = [self._verdict] diff --git a/gui/tests/test_classes.py b/gui/tests/test_classes.py index c724a2fa5..58f732866 100644 --- a/gui/tests/test_classes.py +++ b/gui/tests/test_classes.py @@ -9,8 +9,10 @@ from pathlib import Path from typing import Any +import numpy as np import pytest from solprop.recipe import Recipe +from solprop.recipe.paths import set_path from solprop.service.handlers import HANDLERS, describe, describe_output from solprop.stats import CATALOGUE @@ -30,7 +32,6 @@ Target, derived_text, derived_value, - even_planes, field_changes, field_meta, field_value, @@ -202,9 +203,8 @@ def test_every_link_of_a_class_is_in_its_example() -> None: for row in section.fields: for pattern in row.also: assert linked_paths(build, pattern), (problem.key, pattern) - for path in (row.planes_over, row.moves_planes, *row.goes_with): - if path is not None: - assert linked_paths(build, path), (problem.key, path) + for path in row.goes_with: + assert linked_paths(build, path), (problem.key, path) def test_a_switch_takes_an_entry_out_and_brings_it_back_with_today_s_gas() -> None: @@ -248,18 +248,106 @@ def test_the_filament_s_linked_rows_write_a_recipe_solprop_builds() -> None: "responses[1].gas", "responses[1].rate.source", } + assert negated_value(True) is True + + +def _planes_row(problem: ProblemClass) -> Field: + return next( + row + for section in problem.sections + for row in section.fields + if row.positions is not None + ) + + +def _applied( + build: dict[str, Any], changes: list[tuple[str, object]] +) -> dict[str, Any]: + for path, value in changes: + if value is MISSING: + head, _, name = path.rpartition(".") + (build[head] if head else build).pop(name, None) + else: + build = set_path(build, path, value) + return build + + +@pytest.mark.parametrize("problem", CLASSES, ids=lambda p: p.key) +def test_every_class_offers_both_forms_of_the_saved_planes( + problem: ProblemClass, +) -> None: + # SEP 51: the count and the explicit positions, at the route's level. + row = _planes_row(problem) + nested = "settings." if row.path.startswith("settings.") else "" + assert (row.path, row.positions) == (f"{nested}n_save", f"{nested}save_planes") + + +def test_a_loaded_list_is_shown_as_the_list_and_never_as_its_count() -> None: + row = _planes_row(FILAMENT) + example: Any = Recipe.example("filament").to_dict()["build"] + uniform = example["settings"]["save_planes"] + assert len(uniform) > 2 + assert field_value(row, example) == uniform + uneven = {"settings": {"save_planes": ["1 cm", "4 cm", "4.5 cm"]}} + assert field_value(row, uneven) == ["1 cm", "4 cm", "4.5 cm"] + assert field_value(row, {"settings": {"save_planes": []}}) == [] + assert field_value(row, {"settings": {"n_save": 81}}) == 81 + assert field_value(row, {}) is MISSING + + +def test_each_form_of_the_saved_planes_replaces_the_other() -> None: + row = _planes_row(FILAMENT) + build: dict[str, Any] = Recipe.example("filament").to_dict()["build"] + count = field_changes(FILAMENT, row, 81, build) + assert count == [("settings.n_save", 81), ("settings.save_planes", MISSING)] + build = _applied(build, count) + assert build["settings"]["n_save"] == 81 + assert "save_planes" not in build["settings"] + listed = field_changes(FILAMENT, row, ["5 cm", "8 cm"], build) + assert listed == [ + ("settings.save_planes", ["5 cm", "8 cm"]), + ("settings.n_save", MISSING), + ] + build = _applied(build, listed) + assert "n_save" not in build["settings"] + # Unset, neither is held, and the route's default count applies. + cleared = field_changes(FILAMENT, row, MISSING, build) + assert dict(cleared) == { + "settings.n_save": MISSING, + "settings.save_planes": MISSING, + } + + +def test_a_length_moves_the_length_alone() -> None: + # A count follows the length by itself; explicit positions stay as entered. + length = FILAMENT.sections[0].fields[2] + assert length.path == "grid.length" + build = Recipe.example("filament").to_dict()["build"] + assert field_changes(FILAMENT, length, "20 cm", build) == [("grid.length", "20 cm")] + + +def test_solprop_takes_a_count_and_refuses_a_position_beyond_a_shortened_length() -> ( + None +): + row = _planes_row(FILAMENT) length = FILAMENT.sections[0].fields[2] - moved: dict[str, Any] = dict(field_changes(FILAMENT, length, "20 cm", build)) - assert moved["settings.save_planes"][-1] == "20 cm" - assert len(moved["settings.save_planes"]) == 80 - assert field_changes(FILAMENT, length, MISSING, build) == [("grid.length", MISSING)] - assert field_changes(FILAMENT, length, "20 cm", {"grid": {"length": "25 cm"}}) == [ - ("grid.length", "20 cm") + document: Any = Recipe.example("filament").to_dict() + build = document["build"] + build = _applied(build, field_changes(FILAMENT, row, 11, build)) + build = _applied(build, field_changes(FILAMENT, length, "10 cm", build)) + simulation = Recipe.from_dict({**document, "build": build}).build() + planes = np.asarray(simulation.settings.save_planes) + # Eleven observations over [0, 10 cm], so ten planes after the entrance. + assert planes.shape == (10,) + # The end is the length: one rounding of "10 cm" to metres at most. + assert planes[-1] == pytest.approx(0.1, rel=1e-15) + build = _applied(build, field_changes(FILAMENT, row, ["5 cm", "12 cm"], build)) + errors = [ + issue + for issue in Recipe.from_dict({**document, "build": build}).check() + if issue.severity == "error" ] - planes = Field("settings.save_planes", planes_over="grid.length") - assert field_value(planes, {}) is MISSING - assert negated_value(True) is True - assert even_planes(2, 4.0) == [2.0, 4.0] + assert [issue.parameter for issue in errors] == ["settings.save_planes"] def test_other_geometry_s_form_comes_from_the_metadata() -> None: diff --git a/gui/tests/test_ui_workflow.py b/gui/tests/test_ui_workflow.py index d2c2e8463..e499b9be3 100644 --- a/gui/tests/test_ui_workflow.py +++ b/gui/tests/test_ui_workflow.py @@ -740,12 +740,21 @@ def test_the_filament_s_sheet_links_its_rows( # noqa: PLR0915 - one story assert model.get("settings.ionisation_field_range") is MISSING plasma.click() assert len(model.get("responses")) == 2 # pyright: ignore[reportArgumentType] - planes = sheet.rows["settings.save_planes", "build"].number.number - planes.setText("10") - planes.textEdited.emit("10") - held = model.get("settings.save_planes") - assert isinstance(held, list) - assert len(held) == 10 + # The example lists its planes, so they open as explicit positions, unchanged. + planes = sheet.rows["settings.n_save", "build"] + listed = model.get("settings.save_planes") + assert isinstance(listed, list) + assert planes.current_mode == "text" + assert planes.mode.currentText() == "Explicit positions" + assert planes.value == listed + planes.mode.setCurrentIndex(planes.modes.index("number")) + planes.number.number.setText("10") + planes.number.number.textEdited.emit("10") + assert model.get("settings.n_save") == 10 + assert model.get("settings.save_planes") is MISSING + window.document.undo.undo() + assert model.get("settings.save_planes") == listed + assert model.get("settings.n_save") is MISSING sheet.apply_lens(50e-6, 0.1) assert str(model.get("initial.waist")).endswith("um") assert str(model.get("initial.propz")).startswith("-") @@ -764,6 +773,95 @@ def test_the_filament_s_sheet_links_its_rows( # noqa: PLR0915 - one story window.document.undo.undo() +def _planes_held(model: RecipeModel) -> tuple[object, object]: + """Return the count and the positions a keyword route's recipe holds.""" + return model.get("n_save"), model.get("save_planes") + + +def test_the_saved_planes_are_a_count_or_positions_never_both( # noqa: PLR0915 - one story + window: WorkflowWindow, qtbot: QtBot, tmp_path: Path +) -> None: + open_tiny(window, qtbot) + sheet = window.sheet + model = window.document.model + assert model is not None + row = sheet.rows["n_save", "build"] + assert ("save_planes", "build") not in sheet.rows + assert row.current_mode == "number" + assert not row.mode.isHidden() + assert [row.mode.itemText(i) for i in range(row.mode.count())] == [ + "Evenly spaced", + "Explicit positions", + ] + assert row.number.number.text() == "6" + # A length change leaves the count to spread itself. + sheet.rows["length", "build"].edited.emit("length", "build", "4 cm") + assert _planes_held(model) == (6, MISSING) + window.document.undo.undo() + # Switching shows the other editor, empty: a count is never shown as positions. + row.mode.setCurrentIndex(row.modes.index("text")) + assert row.text.text() == "" + row.text.editingFinished.emit() + assert _planes_held(model) == (6, MISSING) + # The first entry in the new form replaces the count, in one undoable edit. + done = window.document.undo.index() + row.text.setText('["1 cm", "4 cm"]') + row.text.editingFinished.emit() + assert _planes_held(model) == (MISSING, ["1 cm", "4 cm"]) + assert window.document.undo.index() == done + 1 + window.document.undo.undo() + assert _planes_held(model) == (6, MISSING) + assert row.current_mode == "number" + window.document.undo.redo() + assert _planes_held(model) == (MISSING, ["1 cm", "4 cm"]) + assert row.current_mode == "text" + # One position typed is a list of one. + row.text.setText('"2 cm"') + row.text.editingFinished.emit() + assert _planes_held(model) == (MISSING, ["2 cm"]) + row.text.setText('["1 cm", "4 cm"]') + row.text.editingFinished.emit() + # Explicit positions stay as entered; one beyond a shorter length is refused there. + sheet.rows["length", "build"].edited.emit("length", "build", "3 cm") + assert _planes_held(model) == (MISSING, ["1 cm", "4 cm"]) + qtbot.waitUntil(lambda: not row.issue.isHidden(), timeout=WAIT_MS) + assert "length" in row.issue.text() + assert sheet.ready.text().startswith("Not ready") + sheet.rows["length", "build"].edited.emit("length", "build", "5 cm") + qtbot.waitUntil(row.issue.isHidden, timeout=WAIT_MS) + # Saved and opened again, the setup opens on the form it holds. + path = tmp_path / "planes.toml" + assert window.document.save_as(path) + assert "n_save" not in path.read_text(encoding="utf-8") + window.document.set_model(RecipeModel(TINY), base=None) + qtbot.waitUntil(lambda: sheet.rows["n_save", "build"].value == 6, timeout=WAIT_MS) + window.open_setup(str(path)) + qtbot.waitUntil( + lambda: sheet.rows["n_save", "build"].current_mode == "text", timeout=WAIT_MS + ) + reopened = window.document.model + assert reopened is not None + assert _planes_held(reopened) == (MISSING, ["1 cm", "4 cm"]) + assert sheet.rows["n_save", "build"].text.text() == '["1 cm", "4 cm"]' + # Back to a count: one edit takes the positions away. + row = sheet.rows["n_save", "build"] + row.mode.setCurrentIndex(row.modes.index("number")) + assert row.number.number.text() == "" + row.number.number.setText("9") + row.number.number.textEdited.emit("9") + assert _planes_held(reopened) == (9, MISSING) + + +def test_an_uneven_list_opens_as_itself(window: WorkflowWindow, qtbot: QtBot) -> None: + text = TINY.replace("n_save = 6", 'save_planes = ["1 cm", "1.5 cm", "4 cm"]') + window.document.set_model(RecipeModel(text), base=None) + qtbot.waitUntil(lambda: bool(window.sheet.rows), timeout=WAIT_MS) + row = window.sheet.rows["n_save", "build"] + qtbot.waitUntil(lambda: row.current_mode == "text", timeout=WAIT_MS) + assert row.value == ["1 cm", "1.5 cm", "4 cm"] + assert row.number.number.text() == "" + + def test_every_page_of_a_filament_shows_it( # noqa: PLR0915 - one story window: WorkflowWindow, qtbot: QtBot, filament_run: Path, tmp_path: Path ) -> None: From c16904cc9b723b1885c7994b4ffca1309e77d715 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 02:34:02 +0000 Subject: [PATCH 12/20] Document the sheets' two forms of saved planes Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- changelog.d/sep-0051-save-planes.changed.md | 5 +++++ docs/dev/gui/design.md | 4 ++-- docs/guide/front-end/first-run.md | 15 +++++++++++++++ 3 files changed, 22 insertions(+), 2 deletions(-) diff --git a/changelog.d/sep-0051-save-planes.changed.md b/changelog.d/sep-0051-save-planes.changed.md index f8606c86b..24b8e0964 100644 --- a/changelog.d/sep-0051-save-planes.changed.md +++ b/changelog.d/sep-0051-save-planes.changed.md @@ -19,3 +19,8 @@ missing `gas` themselves). `n_save` beside an interior launch counts over the length, within the rounding its step sum accumulates, or it is refused before the run. The resolved recipe writes the run's positions in `[build.settings]` on an object route and drops `n_save`. +In the front end, every sheet's *Saved planes* row offers *Evenly spaced* (`n_save`) and +*Explicit positions* (`save_planes`), and typing into one form removes the other in the +same undoable edit. A setup opens on the form it holds; the object sheets no longer turn +a count into a list of positions, nor rewrite the positions when the length changes. An +object-sheet count of 80 planes, which left out the entrance, is `n_save = 81`. diff --git a/docs/dev/gui/design.md b/docs/dev/gui/design.md index 508fd2984..204d76dd8 100644 --- a/docs/dev/gui/design.md +++ b/docs/dev/gui/design.md @@ -698,7 +698,7 @@ and the output size, and Run starts from it. it says it is unknown. Timing warm-up steps with `Simulation.estimate()` takes seconds, so it runs on request (21.1). - **Numerics** (Advanced on the sheet): backend (from `backends.registry.available()`), tolerance - (`rtol`, with the route's default shown), integrator, save planes (`n_save` or a spacing), statistics (`StatsSpec`, with the route's default set and the class's required + (`rtol`, with the route's default shown), integrator, save planes (`n_save` or explicit positions, SEP 51), statistics (`StatsSpec`, with the route's default set and the class's required statistics ticked), threads (`SOLPROP_THREADS`), boundary check and absorber, snapshots. - **Output**: run title and workspace folder (defaults filled in). - **Resume** replaces Run for an existing run of the same recipe that solprop reports resumable @@ -1359,7 +1359,7 @@ table, scan editor, compressor chain) and the pyqtgraph views. |---|---| | W1 Frame (built locally) | The `classes` layer. The controller moved out of `MainWindow`. Home, the three stages, the sheet frame, the rail and the z scrubber. Built as: `classes/` holds the four classes as data, a test holding every row to its class's example; `ui/document.py` (`SetupDocument`) owns the recipe, undo, checks and files for both windows; `solprop-gui --workflow` opens the new window beside the step window, which Other geometry still opens. Setup edits and checks a real recipe with solprop's numbers; Run and Analyse host the existing views under the new frame, with their sliders replaced by the scrubber. Left to W2: the live sheet (preview plot, typed targets, fast numbers), plain-language rows, and the pages not built, which say so on the rail. | | W2 Capillary (built locally) | End to end: the live sheet with typed targets, the Run stage and every page of 11.3. Checked by walking S1 and S4 by hand. Built as: `service/sheet.py` gives the numbers (about 120 ms, `tools.capillary_params` on the resolved recipe), the curve and dispersive wave (about 170 ms) and the output's size; a number with a target is a button that writes `[pins]`, and the row it moves shows what it solved. Run and Analyse are one widget (`ui/analyse.py`), the Overview under a progress strip or beside the rail, and the pages are `ui/analysis_pages.py` over a shared `ui/analysis.py`, drawing only while on screen. Not built: a rough time on the Ready line, the step-size sparkline on the strip, and a choice among several roots of a target. A ZDW target takes about 290 ms to solve, over the sheet's 150 ms (P8). | -| W3 Radial filament (built locally) | Its sheet and pages, with the spatial readers and beam numbers of 21.2. Checked by walking S6. Built as: rows that move several paths, because the object routes write a gas or wavelength several times and a run's length as its last saved plane (`Field.also`, `moves_planes`, `planes_over`, #533); switches for Kerr and plasma, whose entries come back from the class's example; a lens as an option on the beam. The live numbers come from `tools.beam_params`. The Overview grows from each plane's fluence and the beam's spectrum, and reads the on-axis spectrum from the file when the run ends. Not built: a far field or spectrogram while a run goes. | +| W3 Radial filament (built locally) | Its sheet and pages, with the spatial readers and beam numbers of 21.2. Checked by walking S6. Built as: rows that move several paths, because the object routes write a gas or wavelength several times (`Field.also`); a saved-planes row of two forms, a count (`n_save`) or explicit positions (`save_planes`), one replacing the other in one edit (`Field.positions`, SEP 51); switches for Kerr and plasma, whose entries come back from the class's example; a lens as an option on the beam. The live numbers come from `tools.beam_params`. The Overview grows from each plane's fluence and the beam's spectrum, and reads the on-axis spectrum from the file when the run ends. Not built: a far field or spectrogram while a run goes. | | W4 Fibres (built locally) | Solid-core and antiresonant, as classes. Checked by running both through every page. Built as: the solid-core sheet reads its mode and `tools`, with no targets, since pins cover the capillary only; the antiresonant sheet uses `tools.soliton_params` on its own mode, and only the soliton order is a target, because a fibre has many zeros and resonances. Its zero is read from the curve inside the run's window, where the tool's nearest in frequency can lie far beyond it. Its loss curve and cross-section sit below the dispersion curve. A sheet edit costs about 280 ms on the antiresonant route against the 150 ms of the capillary. Not built: Noise and coherence, which stays disabled as no run is a seeded ensemble until scans exist. | | W5 Design a waveguide (built locally) | The workflow of 7.4, reusing the explorer's quantities and sweeps. Checked by walking S2 by script. Built as: a stage of the workflow window, opened from Home, that never touches the open setup. A design is always a class's example with the design's values set, so what it shows is what that recipe builds, and *Simulate this* opens it as a new sheet. It covers capillary and antiresonant fibre, with pages Curves (β₂, D, β₃, n_eff − 1, group index), ZDW map (pressure against radius per zero, capillary only), Phase matching and Loss. It has a sweep of pressure, radius or gas, where a click takes a curve's value or a map point's radius and pressure. It solves the pressure for a ZDW, and the energy too for an order. A curve costs about 90 ms, a sweep of four about 250 ms, and a map about 2 s. Not built: a sweep of the mode order, the solid-core fibre, a figure export (CSV only), and Copy as Python. | | W6 Other geometry (built locally) | Every other route on the generic form. The step window is deleted. Checked by running each example of those routes (hollow rectangular, graded-index, Cartesian and line beams, both planar) from Home through every page. Built as: Home's Other geometry tile lists those examples. A recipe on a route with no class gets a class made from solprop's metadata: its sections are the metadata groups, holding the keywords the recipe sets, with the rest under Advanced. Its numbers are the summary's energy and peak power, and its rail is Overview, At this plane, Along z and Run health. A planar run has no Overview, since its planes are slab amplitudes no map reads yet. A beam's plane is summed across the beam. A general modal guide's energy is its physical energy. `solprop-gui` opens the workflow window, and `--workflow` is accepted and ignored. A service run re-attaches in the new window. Removed with the step window: `ui/main_window`, `ui/start`, `ui/design_tool`, `ui/scan_editor`, `views/explorer`, `views/zdw_chart` and their tests. Not built: scans, which wait for their own mode (12.7); a cross-section on the generic form; per-width labels (J/m) for line and planar beams; a fluence map page for Cartesian and line beams (#455 gives the reader). | diff --git a/docs/guide/front-end/first-run.md b/docs/guide/front-end/first-run.md index 7a67ba7fc..41d8a6d66 100644 --- a/docs/guide/front-end/first-run.md +++ b/docs/guide/front-end/first-run.md @@ -24,6 +24,21 @@ gradient *from* 1.2 bar *to* 0 bar along the capillary, the example's own profil does when it is left empty. **Advanced** holds every other keyword of the route, with a *Find any setting* box. +**Saved planes**, in the simulation window, takes one of two forms +([the length and the saved planes](../setup/running.md#the-length-and-the-saved-planes)): + +- *Evenly spaced* is a count of observations, `n_save`, spread from the run's entrance + to its end with both ends counted. Changing the length spreads them again. +- *Explicit positions* is a list, `save_planes`, written as a recipe writes it: + `["5 cm", "10 cm"]`. The entrance and the end are recorded as well, one position is a + list of one, and `[]` keeps only the two ends. The positions stay as typed when the + length changes, and a position beyond the end is shown as an error at the row. + +Typing into the other form replaces the first in one edit, which **Undo** takes back, +so a setup never holds both. A setup opens on the form it holds, and a list is always +shown as the list, never as its count. Left empty, the row takes solprop's default +count. + As you type, the right side follows: - **What this gives** is computed by solprop from the setup as it stands From 28daf46c46b13ed89848f5a409b4113e7241e233 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 02:56:29 +0000 Subject: [PATCH 13/20] Point the recipes page at RecipeError where the API documents it Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- docs/guide/setup/recipes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guide/setup/recipes.md b/docs/guide/setup/recipes.md index 447b50a5b..ec54618f0 100644 --- a/docs/guide/setup/recipes.md +++ b/docs/guide/setup/recipes.md @@ -187,7 +187,7 @@ evenly spaced observations over the run, and `save_planes` lists positions insid the table above could say `save_planes = []`. A bare integer, `save_planes = 80`, is refused by `Recipe.check()` and `build()` with "write `n_save = 80`", as are both selectors together, a position beyond the end and, on a keyword route, a `length` its -`grid` disagrees with: each is a {py:class}`~solprop.recipe.RecipeError` naming the +`grid` disagrees with: each is a {py:class}`~solprop.recipe.errors.RecipeError` naming the keyword. A recipe holds the `from_*` form, so the temporal absorber and its scheme are keywords From becfc92f53e07b8fe677e0675f1583d4014281c5 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 02:56:29 +0000 Subject: [PATCH 14/20] Report SEP 51's phase 2 in Part II Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- docs/dev/seps/sep-0051-save-planes.md | 72 +++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) diff --git a/docs/dev/seps/sep-0051-save-planes.md b/docs/dev/seps/sep-0051-save-planes.md index f70329603..80e95bbbb 100644 --- a/docs/dev/seps/sep-0051-save-planes.md +++ b/docs/dev/seps/sep-0051-save-planes.md @@ -702,6 +702,77 @@ them only to wrap a now-optional `save_planes` for the type checker. list over `grid.length`: the settings metadata now offers `n_save` beside `save_planes` (an array only), and the resolved planes always end at the length. +### Phase 2 — Front end + +**Scope.** 2026-11-16; Opus 5.5 (AI) for John Travers; branch +`feature/sep-0051-gui`, on phase 1, commits from `3646b0e5` (the sheets) to the commit +that appends this report. + +**Delivered.** + +- `gui/src/solprop_gui/classes/problem.py`: `Field.positions` replaces `planes_over` and + `moves_planes`. A saved-planes row reads the positions a recipe lists, or else its + count, and never turns a list into its count; its change writes a list as the + positions and anything else as the count, and unsets the other selector in the same + change. `even_planes` and the length row's rewriting of the list are removed. + `sheet_paths` and `other_keywords` count the positions as the row's, so the keyword + routes' `save_planes` leaves Advanced. +- `gui/src/solprop_gui/classes/catalog.py`: every class's "Saved planes" row is + `n_save` with `positions="save_planes"`, at the top level on the keyword routes and in + `settings` on the object routes; the object sheets' length rows no longer move planes. +- `gui/src/solprop_gui/ui/fields.py`: a row may name its forms (`mode_titles`); its + picker then shows them on a sheet, its text editor shows only what no other editor + holds, and leaving the text as shown writes nothing, so switching forms never replaces + a value by itself. `ParameterRow.current_mode` is new. +- `gui/src/solprop_gui/ui/sheet.py`: the row offers "Evenly spaced" (the count's integer + form) and "Explicit positions" (the positions' array form, as inline TOML). One value + typed as positions is a list of one. An issue on the positions shows at the row. +- Tests: `gui/tests/test_classes.py` (both forms on every class, at the route's level; a + uniform and a non-uniform loaded list shown as lists; each form replacing the other, + and clearing both; a length change moving the length alone; a count on the filament + built by solprop, ending at the shortened length, and a position beyond it refused at + `settings.save_planes`). `gui/tests/test_ui_workflow.py` (the keyword sheet: it opens + on its count; a length change keeps the count; switching forms writes nothing until an + entry; the entry replaces the count in one undoable edit, undone and redone; a lone + position; a position beyond a shortened length shown at the row and the Ready line; + save and reopen on the positions; back to a count; a non-uniform list opening as + itself; and the filament's object sheet opening its listed planes as explicit + positions, replaced by a count and restored by one undo). Every step checks that the + recipe never holds both selectors. +- Pages: `docs/guide/front-end/first-run.md` (the row's two forms), + `docs/dev/gui/design.md` (W3's rows and the numerics line), and a front-end sentence + in `changelog.d/sep-0051-save-planes.changed.md`. + +**Deviations from the proposal.** None in behaviour. One reading of §5.10: switching +the picker shows the other form's editor, empty, and the first entry there is the one +undoable edit that writes it and removes the other selector. A switch alone writes +nothing, because a count has no positions to show and a list has no count (D7), so +neither can be written for the user. + +**Verification.** On the Xeon, through Slurm, one thread per worker: `ruff format`, +`ruff check`, codespell on the touched files, `poe gui-types` (0 errors) and +`poe gui-docstrings` pass; `tests/test_classes.py` and the doctests of +`solprop_gui.classes` and `ui/fields.py` (91 passed); the whole front-end suite without +coverage, 440 passed: 433 in one run, and the seven that start a run passed when rerun +with the Slurm job's environment unset (inside a Slurm job, a run's worker records +itself as a Slurm job, which the window then cannot follow; they fail the same way on +phase 1's commit). `tests/test_seps.py`, `poe changelog-check` and the Sphinx build +(`-W -n`) pass; the build first failed on a cross-reference phase 1 added to +`guide/setup/recipes.md` (`solprop.recipe.RecipeError`, documented as +`solprop.recipe.errors.RecipeError`), corrected in its own commit. Not run locally: `gui-test` with coverage (the 100 % bar on +`classes`), which CI runs. + +**Sources checked.** None needed. + +**Limitations.** The positions are typed as inline TOML (`["5 cm", "10 cm"]`), as +Advanced edits them; a friendlier list editor is not part of this phase. Advanced's +`settings` editor on the object routes still shows `n_save` and `save_planes` side by +side, so a recipe edited there can hold both, which solprop's check refuses at the row. + +**Cost** (`git diff --numstat` against `ccadb278`): front-end code +133 −88 +(`classes` +47 −68), tests +206 −20, pages +17 −2 and the changelog +5. The proposal +estimated about 60 lines removed plus the new field and its tests. + ## Part III — History - 2026-11-15: Drafted, after the investigation of #533 found that no route ties the @@ -715,6 +786,7 @@ list over `grid.length`: the settings metadata now offers `n_save` beside `save_ - 2026-11-15: Implementation started on `feature/sep-0051-save-planes`. - 2026-11-16: Phase 1 (driver and recipes) reported in Part II, with an interim deviation on keyword-only `length` pending with the maintainer. +- 2026-11-16: Phase 2 (front end) reported in Part II, on `feature/sep-0051-gui`. ### AI review — 2026-11-15 From 97748121cf8e8b4c48a9092b3cdc20f546dc3ad5 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 03:02:21 +0000 Subject: [PATCH 15/20] docs: SEP 51 is Final Both phases are reported in Part II. The SEP is archived, its index row and toctree entry move to the archive, its roadmap entry is removed, the manual pages it produced link to it, and its open questions are issues #855-#857. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- changelog.d/sep-0051-save-planes.changed.md | 2 +- docs/dev/roadmap.md | 7 ------- docs/dev/seps/archive/index.md | 1 + docs/dev/seps/{ => archive}/sep-0051-save-planes.md | 10 ++++++---- docs/dev/seps/index.md | 3 +-- docs/guide/free-space/beams.md | 2 ++ docs/guide/front-end/first-run.md | 3 +++ docs/guide/setup/recipes.md | 2 ++ docs/guide/setup/running.md | 3 +++ 9 files changed, 19 insertions(+), 14 deletions(-) rename docs/dev/seps/{ => archive}/sep-0051-save-planes.md (99%) diff --git a/changelog.d/sep-0051-save-planes.changed.md b/changelog.d/sep-0051-save-planes.changed.md index 24b8e0964..497af28b8 100644 --- a/changelog.d/sep-0051-save-planes.changed.md +++ b/changelog.d/sep-0051-save-planes.changed.md @@ -1,5 +1,5 @@ Every route now follows one rule for the saved planes and the end of a run -([SEP 51](docs/dev/seps/sep-0051-save-planes.md)). A run marches from `initial_z` to its +([SEP 51](docs/dev/seps/archive/sep-0051-save-planes.md)). A run marches from `initial_z` to its length, `length` or `grid.length`, and always records both ends. `n_save=N` gives `N` evenly spaced observations over that interval, both ends included, and `save_planes=[...]` lists positions inside it. `SimulationSettings` gains `n_save`, its diff --git a/docs/dev/roadmap.md b/docs/dev/roadmap.md index dcb9eb4a1..4b9ccc5d0 100644 --- a/docs/dev/roadmap.md +++ b/docs/dev/roadmap.md @@ -35,13 +35,6 @@ being implemented. routes, bound response and other geometries remain follow-up work; the first route is a single-mode capillary with node quadrature. -- [SEP 51 — One rule for the saved planes and the end of a run](seps/sep-0051-save-planes.md): - the length stated once, as `length` or `grid.length`, is the limit and the end of every - run; every run records its entrance and end, and every route, recipe and front-end - sheet takes the same `n_save` (evenly spaced over the launched interval) or - `save_planes` (positions), with no bare numbers. Continuing a finished run stays in - [#141](https://github.com/LupoLab/solprop/issues/141). - - [SEP 52 — One backend shape and a small native seam](seps/sep-0052-backend-shape.md): `numpy_ref` and `native` built from the same workspace, engines, marches and session, reading shared run records; `HostDriver` removed; the `Batch` executor, every group path diff --git a/docs/dev/seps/archive/index.md b/docs/dev/seps/archive/index.md index 7dd2e80a5..21f7a125a 100644 --- a/docs/dev/seps/archive/index.md +++ b/docs/dev/seps/archive/index.md @@ -46,4 +46,5 @@ sep-0046-machine-calibration sep-0047-run-ownership sep-0048-julia-backend sep-0049-tdse-on-native +sep-0051-save-planes ``` diff --git a/docs/dev/seps/sep-0051-save-planes.md b/docs/dev/seps/archive/sep-0051-save-planes.md similarity index 99% rename from docs/dev/seps/sep-0051-save-planes.md rename to docs/dev/seps/archive/sep-0051-save-planes.md index 80e95bbbb..3e56f622a 100644 --- a/docs/dev/seps/sep-0051-save-planes.md +++ b/docs/dev/seps/archive/sep-0051-save-planes.md @@ -6,7 +6,7 @@ | **Title** | One rule for the saved planes and the end of a run | | **Author** | John Travers | | **Drafting agent** | Opus 5.5 (2026-11-15) | -| **Status** | In progress | +| **Status** | Final | | **Review status** | Reviewed | | **Reviewers** | John Travers (human); GPT-6 (AI) | | **Type** | Change | @@ -15,7 +15,7 @@ | **Requires** | — | | **Supersedes** | — | | **Superseded-by** | — | -| **Implementation** | Opus 5.5 (AI), for John Travers, on `feature/sep-0051-save-planes` | +| **Implementation** | Opus 5.5 (AI), for John Travers. Phases 1 and 2 on `feature/sep-0051-save-planes`, [PR #851](https://github.com/LupoLab/solprop/pull/851) | | **Manual pages** | `guide/setup/running.md`, `guide/setup/recipes.md`, `guide/free-space/beams.md` | ## Part I — Proposal @@ -526,7 +526,7 @@ None beyond solprop's own documentation and issues, cited where used. ### Phase 1 — Driver and recipes **Scope.** 2026-11-16; Opus 5.5 (AI) for John Travers; branch -`feature/sep-0051-save-planes`, commits from `ebff016c` (the helper and adoption) to the +`feature/sep-0051-save-planes`, commits from `e8de3270` (the helper and adoption) to the commit that appends this report. The front end (§5.10, phase 2) is untouched. **Survey (§11), before any call site was edited.** An instrumented `Simulation.settings` @@ -706,7 +706,8 @@ list over `grid.length`: the settings metadata now offers `n_save` beside `save_ **Scope.** 2026-11-16; Opus 5.5 (AI) for John Travers; branch `feature/sep-0051-gui`, on phase 1, commits from `3646b0e5` (the sheets) to the commit -that appends this report. +that appends this report; carried onto `feature/sep-0051-save-planes` as `d3702160` to +`e410e79f`. **Delivered.** @@ -787,6 +788,7 @@ estimated about 60 lines removed plus the new field and its tests. - 2026-11-16: Phase 1 (driver and recipes) reported in Part II, with an interim deviation on keyword-only `length` pending with the maintainer. - 2026-11-16: Phase 2 (front end) reported in Part II, on `feature/sep-0051-gui`. +- 2026-11-16: Final. Both phases are reported in Part II and merge in PR #851. Open questions moved to issues: keyword-only `length` ([#857](https://github.com/LupoLab/solprop/issues/857)), the fixed-step scaffold's `n_save` ([#856](https://github.com/LupoLab/solprop/issues/856)) and further length-dependent defaults ([#855](https://github.com/LupoLab/solprop/issues/855)). ### AI review — 2026-11-15 diff --git a/docs/dev/seps/index.md b/docs/dev/seps/index.md index 5bfad9af9..473f2a0be 100644 --- a/docs/dev/seps/index.md +++ b/docs/dev/seps/index.md @@ -33,7 +33,6 @@ Proposals that are active, in draft, accepted, in progress or deferred. | [11](sep-0011-finite-density-gas-index.md) | Finite-density gas index and mixture optics | Draft | Change | | [17](sep-0017-gas-two-photon-ionisation.md) | Broadband two-photon continuum response beside strong-field ionisation | Accepted | Feature | | [32](sep-0032-raman-maxwell-bloch.md) | Raman Maxwell–Bloch dynamics | Draft | Feature | -| [51](sep-0051-save-planes.md) | One rule for the saved planes and the end of a run | In progress | Change | | [52](sep-0052-backend-shape.md) | One backend shape and a small native seam | In progress | Change | SEP 13, the standalone numerical prerequisite for SEP 12, SEP 14, which carried it to @@ -87,6 +86,7 @@ Proposals that are final, rejected, withdrawn or superseded; the | [47](archive/sep-0047-run-ownership.md) | Backend-owned execution sessions | Final | Change | | [48](archive/sep-0048-julia-backend.md) | A Julia backend: one engine for CPUs and GPUs, in both precisions | Withdrawn | Feature | | [49](archive/sep-0049-tdse-on-native.md) | The TDSE response on native | Final | Change | +| [51](archive/sep-0051-save-planes.md) | One rule for the saved planes and the end of a run | Final | Change | ```{toctree} :hidden: @@ -103,7 +103,6 @@ sep-0010-low-rank-raman sep-0011-finite-density-gas-index sep-0017-gas-two-photon-ionisation sep-0032-raman-maxwell-bloch -sep-0051-save-planes sep-0052-backend-shape template archive/index diff --git a/docs/guide/free-space/beams.md b/docs/guide/free-space/beams.md index a09652122..c9291a414 100644 --- a/docs/guide/free-space/beams.md +++ b/docs/guide/free-space/beams.md @@ -373,3 +373,5 @@ through lenses, apertures and free space or coupled into a capillary or fibre A beam's displacement and tilt were proposed and carried out by [SEP 41](../../dev/seps/archive/sep-0041-recipes-and-front-ends.md). +The saved planes follow +[SEP 51](../../dev/seps/archive/sep-0051-save-planes.md). diff --git a/docs/guide/front-end/first-run.md b/docs/guide/front-end/first-run.md index 41d8a6d66..9f0ac70b0 100644 --- a/docs/guide/front-end/first-run.md +++ b/docs/guide/front-end/first-run.md @@ -113,3 +113,6 @@ setup. **⋯ → Save** keeps the setup as a recipe file of your own, and **⋯ → Show as Python** shows the script that builds the same simulation. Each results page's **Export** menu has *Copy as Python* too: the code that draws that page from the results file, with {py:mod}`solprop.processing` and {py:mod}`solprop.plotting`. + +The two forms of the saved planes were proposed and implemented by +[SEP 51](../../dev/seps/archive/sep-0051-save-planes.md). diff --git a/docs/guide/setup/recipes.md b/docs/guide/setup/recipes.md index ec54618f0..a980a7550 100644 --- a/docs/guide/setup/recipes.md +++ b/docs/guide/setup/recipes.md @@ -448,3 +448,5 @@ its reason, in the test that holds the examples to the gallery, so the list stay This page documents the functionality proposed and implemented by [SEP 41](../../dev/seps/archive/sep-0041-recipes-and-front-ends.md). +The saved planes follow +[SEP 51](../../dev/seps/archive/sep-0051-save-planes.md). diff --git a/docs/guide/setup/running.md b/docs/guide/setup/running.md index 087728f75..7be7aebc5 100644 --- a/docs/guide/setup/running.md +++ b/docs/guide/setup/running.md @@ -692,3 +692,6 @@ handler with no state written, and a run with an optmat ionisation rate, which r peak rates back from its output, neither reports its peak field nor warns past the rate's range ({py:class}`~solprop.exceptions.MaterialRangeWarning`). Read `peak_ionisation_rate` in the callable where that matters. + +The length and the saved planes were proposed and implemented by +[SEP 51](../../dev/seps/archive/sep-0051-save-planes.md). From 9ea741590c165f54c96ad06d44b9e5325561a36e Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 05:03:45 +0000 Subject: [PATCH 16/20] List SEP 51's refusal rules and fit the remaining runs to their length The capability catalogue lists save-planes-count, save-planes-outside, length-or-grid, length-grid and replay-interval on the keyword routes. The moving-guide cases, the GRIN self-imaging run, the facet-envelope port, the envelope-plasma host run and the native general modal window cut their grids at the run's end, keeping the collar the longer grid gave where one is used; the collar-step comparison states the millimetre it always ran. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- native/tests/test_general_modal.py | 6 ++-- src/solprop/capabilities.py | 31 +++++++++++++++++++++ tests/backends/test_envelope_plasma_host.py | 5 ++-- tests/coupling/test_envelopes.py | 4 ++- tests/driver/test_general_modal.py | 3 +- tests/driver/test_grin_system.py | 7 ++++- tests/moving_guide_cases.py | 16 +++++++++-- 7 files changed, 62 insertions(+), 10 deletions(-) diff --git a/native/tests/test_general_modal.py b/native/tests/test_general_modal.py index 65831772c..ca0797f60 100644 --- a/native/tests/test_general_modal.py +++ b/native/tests/test_general_modal.py @@ -188,11 +188,13 @@ def _case( ) -> Case: with warnings.catch_warnings(): warnings.simplefilter("ignore", GeneralModalBasisWarning) + # The run ends at its grid's length (SEP 51): the millimetre grid cut at the + # ten-step window, whose collar is removed below. simulation = Simulation.from_waveguide( (), - FIBRE, + Z_END, provider=guide, - grid=grid, + grid=dataclasses.replace(grid, length=Z_END), backend="numpy_ref", kerr_form=kerr_form, save_planes=[Z_END], diff --git a/src/solprop/capabilities.py b/src/solprop/capabilities.py index b0b379c96..b07e8fa9a 100644 --- a/src/solprop/capabilities.py +++ b/src/solprop/capabilities.py @@ -330,6 +330,7 @@ class Rule: _CAPILLARY: Final = ("capillary",) _WAVEGUIDE: Final = ("waveguide",) _MODAL: Final = ("capillary", "waveguide") +_KEYWORD: Final = ("gnlse", "capillary", "waveguide") _RULES: Final = ( # The grid, the input pulse and the saved planes, on both routes. @@ -391,6 +392,36 @@ class Rule: "The saved planes are given as positions or as a count, not both.", _BOTH, ), + Rule( + "save-planes-count", + ("save_planes",), + "save_planes takes positions in m; a count of evenly spaced planes is n_save.", + _KEYWORD, + ), + Rule( + "save-planes-outside", + ("save_planes",), + "Every saved plane lies inside the run, from its entrance to its length.", + _KEYWORD, + ), + Rule( + "length-or-grid", + ("length", "grid"), + "A run's length is given as length or as its grid's; one of them is needed.", + _KEYWORD, + ), + Rule( + "length-grid", + ("length", "grid"), + "A length given beside a grid agrees with the grid's length.", + _KEYWORD, + ), + Rule( + "replay-interval", + ("schedule",), + "A replayed schedule covers the run, from its entrance to its length.", + _KEYWORD, + ), Rule( "fields-planes-step-planes", ("fields", "step_planes"), diff --git a/tests/backends/test_envelope_plasma_host.py b/tests/backends/test_envelope_plasma_host.py index b8354c69f..de28530d0 100644 --- a/tests/backends/test_envelope_plasma_host.py +++ b/tests/backends/test_envelope_plasma_host.py @@ -18,7 +18,7 @@ from backends.envelope_host_cases import argon_host_case from backends.mixture_rows import host from bounds import scan_bound -from builders import load_reference +from builders import grid_at, load_reference from sessions.runs import run as session_run from solprop.backends.node_chunk import plan_node_chunk from solprop.backends.numpy_ref import NumpyRefBackend @@ -214,7 +214,8 @@ def test_direct_simulation_records_carrier_approximation_and_runs(host_case): assert assembly is not None mode = MarcatiliMode(125e-6, "Ar", 1.0, loss=False) simulation = Simulation( - grid, + # The run ends at its grid's length (SEP 51); no collar reads the length. + grid_at(grid, 8e-6), mode, [EnvelopePlasmaResponse("Ar", assembly.channels[0].rate, preionisation=0.1)], original.initial.field0, diff --git a/tests/coupling/test_envelopes.py b/tests/coupling/test_envelopes.py index 5a6444d23..5dcecae48 100644 --- a/tests/coupling/test_envelopes.py +++ b/tests/coupling/test_envelopes.py @@ -37,6 +37,7 @@ import pytest from scipy.special import jn_zeros, jv +from builders import grid_at from facet_mode_matching import ( Y_VACUUM, Beam, @@ -1165,11 +1166,12 @@ def facet_port(contrast, v_centre): nodes=provider.node_rule(0.99 * active[0], n_r=48, n_theta=48), degenerate_blocks=((0, 1),), ) + # Built for its port only: the grid is the tenth it would run (SEP 51). simulation = Simulation.from_waveguide( (), 1e-4, provider=guide, - grid=grid, + grid=grid_at(grid, 1e-4), wavelength=wavelength, energy=1e-12, fwhm=20e-15, diff --git a/tests/driver/test_general_modal.py b/tests/driver/test_general_modal.py index d48f26e14..95a7fecdc 100644 --- a/tests/driver/test_general_modal.py +++ b/tests/driver/test_general_modal.py @@ -1915,9 +1915,10 @@ def test_the_collar_and_not_the_route_sets_the_step_on_every_route(): # optmat's argon index covers this grid's active band, to 1774 nm (the former # registry's stopped at 1 um and warned; SEP 3), so the runs are quiet. for collar in (True, False): + # The run always went to its last plane, the millimetre (SEP 51 states it). simulation = Simulation.from_capillary( 50e-6, - SHORT_Z, + GENERAL_Z_END, "Ar", 1.0, grid=grid, diff --git a/tests/driver/test_grin_system.py b/tests/driver/test_grin_system.py index fb003b997..ad3001bd9 100644 --- a/tests/driver/test_grin_system.py +++ b/tests/driver/test_grin_system.py @@ -22,6 +22,7 @@ import numpy as np import pytest +from builders import grid_at, held_collar from modal_provider_cases import ( GENERAL_CHI3, grin_grid, @@ -177,11 +178,15 @@ def test_grin_self_imaging(grid, linear_guide, imaging, record_property): record_property("grin_phase_budget_rad", turn) record_property("grin_interpolation_budget_rad", interpolation) length, centre = imaging["length"], imaging["index"] + # A run ends at its grid's length (SEP 51): the millimetre grid cut at the + # imaging length, with the collar the millimetre gave. + window = grid_at(grid, length) simulation = Simulation.from_waveguide( (), length, provider=linear_guide, - grid=grid, + grid=window, + absorber=held_collar(window, grid.length), wavelength=1.03e-6, fwhm=40e-15, energy=1e-15, diff --git a/tests/moving_guide_cases.py b/tests/moving_guide_cases.py index 084669639..b03655786 100644 --- a/tests/moving_guide_cases.py +++ b/tests/moving_guide_cases.py @@ -25,6 +25,7 @@ import numpy as np +from builders import grid_at, held_collar from coupled_flow_cases import Case, parity_bound from modal_provider_cases import GENERAL_CHI3, grin_grid, grin_provider, make_provider from solprop.driver import Simulation @@ -89,16 +90,22 @@ def kinked_radius(): def moving_simulation(guide, grid, *, steps=STEPS, length=LENGTH, **overrides): - """Return a general modal simulation of a guide on a fixed schedule.""" + """Return a general modal simulation of a guide on a fixed schedule. + + A run ends at its grid's length (SEP 51): the grid is cut at `length`, with the + collar the whole grid gave. + """ + window = grid_at(grid, length) simulation = Simulation.from_waveguide( (), length, provider=guide, - grid=grid, + grid=window, **( { "noise": None, **{ + "absorber": held_collar(window, grid.length), "save_planes": [length], "dz_max": length / steps, "dz_init": length / steps, @@ -159,7 +166,8 @@ def ten_step_simulation(guide, grid, length=LENGTH, **pulse) -> Simulation: (), length, provider=guide, - grid=grid, + # A run ends at its grid's length (SEP 51); no collar is kept. + grid=grid_at(grid, length), save_planes=[length], dz_max=length / STEPS, dz_init=length / STEPS, @@ -375,6 +383,8 @@ def bound_step_problem(descriptors, *, blocks=(), basis_block=None): if basis_block is None else circular_pair(provider_channels(provider), basis_block), ) + # A run ends at its grid's length (SEP 51); its collar is removed below. + grid = grid_at(grid, BOUND_STEP_LENGTH) simulation = Simulation.from_waveguide( (), BOUND_STEP_LENGTH, From e4e35f8e5e22d078739bb90ce82171ba11d3419b Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 05:08:27 +0000 Subject: [PATCH 17/20] Run three tutorials on grids of the length they propagate The general modal and graded-index tutorials and the radial-to-capillary coupling ran a short window of a longer grid. Each now builds its run's grid for the length it propagates, sampled as before, and the two that use a collar keep the longer grid's rate through boundary_length. The regenerated output prints the same numbers; one diagnostic at the 1e-36 level, in the gap run this change does not touch, differs by rounding. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- ..._plot_08_radial_capillary_coupling_001.png | Bin 42027 -> 45772 bytes ..._plot_08_radial_capillary_coupling_002.png | Bin 40303 -> 45125 bytes ..._plot_08_radial_capillary_coupling_003.png | Bin 61135 -> 67725 bytes ..._plot_08_radial_capillary_coupling_004.png | Bin 21718 -> 25123 bytes ..._plot_08_radial_capillary_coupling_005.png | Bin 53637 -> 59851 bytes ...lot_08_radial_capillary_coupling_thumb.png | Bin 17310 -> 20000 bytes ..._08_radial_capillary_coupling.codeobj.json | 48 +++++++++ .../plot_08_radial_capillary_coupling.ipynb | 6 +- .../plot_08_radial_capillary_coupling.py | 10 +- .../plot_08_radial_capillary_coupling.py.md5 | 2 +- .../plot_08_radial_capillary_coupling.rst | 66 +++++++------ .../plot_08_radial_capillary_coupling.zip | Bin 48215 -> 49193 bytes .../sphx_glr_plot_05_general_modal_001.png | Bin 29493 -> 32341 bytes .../sphx_glr_plot_05_general_modal_thumb.png | Bin 22326 -> 26042 bytes .../plot_05_general_modal.codeobj.json | 91 ++++++++++++++++++ .../waveguides/plot_05_general_modal.ipynb | 6 +- .../waveguides/plot_05_general_modal.py | 30 ++++-- .../waveguides/plot_05_general_modal.py.md5 | 2 +- .../waveguides/plot_05_general_modal.rst | 52 ++++++---- .../waveguides/plot_05_general_modal.zip | Bin 19084 -> 20406 bytes .../plot_06_graded_index.codeobj.json | 6 +- .../waveguides/plot_06_graded_index.ipynb | 4 +- .../waveguides/plot_06_graded_index.py | 6 +- .../waveguides/plot_06_graded_index.py.md5 | 2 +- .../waveguides/plot_06_graded_index.rst | 34 ++++--- .../waveguides/plot_06_graded_index.zip | Bin 21388 -> 21730 bytes .../plot_08_radial_capillary_coupling.py | 10 +- .../waveguides/plot_05_general_modal.py | 30 ++++-- .../waveguides/plot_06_graded_index.py | 6 +- 29 files changed, 305 insertions(+), 106 deletions(-) diff --git a/docs/auto_tutorials/free_space/images/sphx_glr_plot_08_radial_capillary_coupling_001.png b/docs/auto_tutorials/free_space/images/sphx_glr_plot_08_radial_capillary_coupling_001.png index 58b56c36c392b761588eceb5c09b87b4f8937a0d..5dc9bf263d2a4044075a3c0b12ecc81e861f4add 100644 GIT binary patch literal 45772 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 diff --git a/docs/auto_tutorials/free_space/images/sphx_glr_plot_08_radial_capillary_coupling_002.png b/docs/auto_tutorials/free_space/images/sphx_glr_plot_08_radial_capillary_coupling_002.png index 633ea6e7c46f494e4ff4629f5f60f5c7043af148..3fc99b87e805901f9c8cb534b70cab24ee3a48fe 100644 GIT binary patch literal 45125 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 A?f?J) diff --git a/docs/auto_tutorials/free_space/images/sphx_glr_plot_08_radial_capillary_coupling_003.png b/docs/auto_tutorials/free_space/images/sphx_glr_plot_08_radial_capillary_coupling_003.png index e4e0137268e3ac423dea436e57873859027c32f9..ef0d877643dc1f7b8a539b225b08b0cbe5a0e635 100644 GIT binary patch literal 67725 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 z zIMkF-w#__I6jsCWAv^`aI)MgJoQ52Ytf|Gro+r5z$S}5f8n#v1!18uC&qoa^-cKoA z;n}I4^X{Y7olF!estHo&XnYmd7T-Gt?V+O3Xtt)9Pae$Y2&pL&?Y-dIa=6%KcZMaW z;$;$>BjGX8t}!@Jb>W1EM+Kc;2+iy*7x^|yXR&4IrsXwLLUZ=+tqeis-MQdX#uVEq0$?{H19T`)%|(1Df{k`rQm_WbnFS zqS9$mndOBc7cAEj1lAKGGwVf8G|jo?EneNnRw^Sr^XAdw=#!rH;ra}7wOtJA7D4#o z@S_bAf*oAOIh2PFz+5OKOf2(0yFKr<8Hn>(bT>W_=Y7uE`gU&afsosUB_s13Cp(@H z^akp<1$ZmVkkyJrgU6TWGXCC;jm<{UPvjRA=1Y^>PEj>nBB+*GV*H6Kxrx~~^uY$h z2-U85$TyfF(7}@3&7W3Yy?jZ=dXinS4XP@M>p<$|i(zEZu?q*=TmFiX`LJzlxudv?!9-qd0{%ztz^RKAmp<NAyj)?KdfOU`Zeh$f9IMbwr; zJ|LBfNR%HSMk!A5Y-k6?jXl%vJ9I zzh3c|pE~+dJ_Bw}qLaqE#pWinT=ol24o|-vidReE7YMqWSlW6AEhm=W>MLyC!yi7h zrJg6(E1oY?>cSVwQ+sBwT0D#>;Jlq@_rJW^JeUn8M0!R0O}2*xaNcB4)?@$vUT9!w=piY}bFB50V))}n3D+8# z?x!s~s%75Zx<%oPwmD^5R>~0r<8|k@3###SMgA|<`E^T+qo%t3Ek zGCy2Py0jKWXX$*k!SVMKd1P4u2Xe=WHfhw(p=}yjaMfAZ;|wOb+VJ>YQ5a(57@= z9sxG`n%_K}Ye`?j^AhuEMLs>|( zbigDj8q`i0A&@b1AT^BWPS1qsL1h*YQbvI|~a~!40r>Qu=1_6FDx@oQ}f4`PaU(&q`#)@ypqdRjKRI`6bA>)NiHmGGJK!;=f`J}Jd==eNqt_v7hl#(EW)7Zz&N+C5F9rhCgor#=H4VR<3(N5K)B_WwKNV`ibD~p6xhys#a z>?zRzMjD1{YGGo!>hjk2sK!>#RlJC5Mr`3UtV1#u@)v^KuW)5?QQsGF4C0y61)qY% zlh}dy{igc)v#OzW*CEy1f3nOM>)1hqyud^kRCs<#B^EnYP9k&}xcnaIfZ-uLc9OsPcwz{TTI>-TjkPFVQ8Wwh?o_06Fl&i6DjBbn{guxdSAF|` zvWq8}K2~wXUIW%ZLTBIrn8O%3husQn(~t$^%oq&1Qb#0Ke9<#W6dmdqN<8YSv?zIy ziWRX}Ss|PLAHv={p3A=fAEu$Hhz3!q$Vdnw5@nRV$);pwCXrB4Mn(~t5!ri>j3^1& zME0JM%rbw^rKLcSU+;0d!Ce$OUvxK`H0DeN_jon5qNLu#CSYgZ`etIfdby)^+je&uV z63KO)`ZlraF|u0M_Hw+U|A^8{wudlv0yyHkDpgrX^Ri>ZFCyoj^v$ON@3XJT1sCTf_pKV(_SGRUC(bOCMBuWD6Fw}|&xxLofTyv;5z?XdzZ!%U=GI#O z)(u%%Mj@dH;3jW8Jw46V$`M9|ZKXPz9kUfoB6`|v#D{O&imq6_8>f8gb+bL?67RWQ z&Em|5$`l*?JG|DOB%so1V?f*ltj%_aATkI9SbbzZ1+D6scei`Ld>M)@7Fh0osbS}} z3tz#RLoHqVR+6W|^QxCeZyOj?p#1fHq}}YGeL3ypKlxnC>#vfUE&0NH4E^P-UAEt4 z+0}kPyp0R#IT$FIHpMgVMKN1hRV5ymDCTzG@p41oJO#-$BlnwuXgZ$+746ZgyEbWJ zugOPLujGCZ9YHbh7IUuFqMY=mc-RsWx(Z++yqjOB?D)PDdl7L45Y|*kOUAq}5_C?p z6&6-j!=`9a{O^gApkQv42TzFlh$2)*$RL#glC-ep6&EB0qOd z?Ja*aRyARE)RV~q+7~#*ky=l-Fe26v`>YXaB6LK_bde?$7yLQ@vFWL2UX@Y%W;&08 zY63;Y0gI4y2FsW0S4^JZoesU?1RnjRpf1dy8}V6PV=qBBN0{%xt{KrF186wDfKi9x z*>c!gXjmALU+k)VrKcnxucC*o!AU0Oh}K7k`YvnCSkvy%lIE5YdT>)_AvH(gRg$e( zOgd&SHiLLKm6ezJ_5K0(xQ$mc$orGpIR*yOCvXitmRn%b{0usrw#yA&bOnWlA!v=< zJWL9OZ2d{~sXDKZ-k@dLYMOn+8qd%2liD}}r=y|=U_xTWJnXUA6`j(H=vVaqf~Z7> z0adFBTzg+!!t>2XT=a9Bf$;#v15bB4&AAPg9DoVN_ZMb*xF_*`XQ7%Rk@qAw`*yzEFdVO zDP5JsIPY!$8>U%xzGI5xauNJbqoPg{zP32}V2ev5q?u<{h4;mA@cB_QyAp3B&iZ)(Gj4RT+w@^Xh$SkRI5y}vk=!CE%k5Yha1`zyQ0 z9_S~FsbNY5+-dR5Z$KzSKPZD8I0V#Za_3Cuu*AAno9th1H5GmeR=ap;LpA&8#CGs2 z`|OmI>6)M&x|BrgpZGm-Pau}r97x6lOVS#qw=_a#F@}$PJUl!^KN5d!8!>}N*kkzi z(4prd22vp4SYl7wIAoD`CH-;O&qC_z$rl&n1s+tk$n2F+!(s8@8~j$_r&|C zl$hWU1vHyLyS%)(98ek~ddrgY@R(*#k6nta(VaWTa`j3a6wA{t;SNBk91t0q=BnbO zL`g2+lhvzXR{QNo=j|EF5BB`z0TQtc?H8z@tas`VZ%{y9Uf!k)F_(tt1d*{Q!k4BU zOnKz+one_nYm3`J_y)+FMQ*-~RiNeKA=%nVHd`Ul1)YcE_fC3oSQEz)u-kdLvQ< zMYXN1P5-$EAO$}uoJ2mvuT1d#kYRFV>|Z@#`sK2$SdxjKDL2o+?pENvrL3-IDZj@U#St zyF*tJjc=l)+@&KsoI0~)Q>23_3l7)TwUJ95Bd9^;TN@l;CK87n2{BeBd=^=h068s*g8ChBW^HnOi%A{i(B zieF|1IEZ-Pk07v7)#^omt$n|*!k{_c}d&|h2fIW?!t?UmyBgM8?mOh&Qcz{`%zIUP% z<^rgQUck|HTd_R)YwK%%XOC?9>IqUR3jD?!%1n2;;3+j%qX3VrK|Gd<&-KSVsV33?P?7 z4c2pt0YfMeDJk#GfAD*h!7m{=ha|A7fbnCee&}ErojQ;3&Z@Xv7U6AAoYpp3C0jF} zzjzTC!+%?j#*|B``U4C666pyG1~7_>HaFYq>RtjdNT$1GM9e-BwSoh>5 zIe4CbtEnk^U-^V^<0Skt5#R70Y8JvI77>(OV2V0NZLO7W-TvP&P{nz9Dt@{~|AvzjBP&RQwsE^oI6MI%?mzGdT_SSdwTGR75X(Rs0RsyTNQ~i2LjgA~ zg{E?=IjEMHnVZOU@^W(t=)e%#V7jX=bb!f-vKTNLd2oGd4Q`-OfVKWuWl7`!eAhlfkU-wST5;mv-NBO@v^6aH*gUrCYqjQXGy^~u+B z!-eVky^i6Wn&CCsAsvDJF@h2O&m3c@T@H8fVd@U_m}tM?ua|Vu;39aF!dvV2(Menf zW(!^4Wh}i>Kqou(v4f(o{Ltcpx@jD5=PtY0%<|PKHV`-o7n7-F53^ZJBD`{b_+Hrk zdXm3hj*U-C`yTt>gj4%vp1NOAh}ac;u_ckAiMb>B(WC9Cz!Esx)HOA0B~Lnk!Dlw@ z&Syte*m|^}m=c>?P;kVK-YH(qv?EB#b6bX@K}I&C{Ib-8>e6?p8tCZhF=7s$6d=Fp zLiV_2?~?})XYSnSPzc&?=0Ghz=zH+0{-d7>BZ7Gq%R5;%yPA%ztr8wL1b+#u(}zOm z^VyD(7pC1lPK9}MClBnBkNNzU21{yS=4X-D?6ic!lf##+7@wI&J`QFyd(WVI8wKoV zkN^nk6#+J4Z{z7aK}B^Pvnj&#m9WAgbwJ`e%$;3*w@zpm*~;I&%LGd|ygCM^jvG5n zt_vBHYdX?=-~A*&sO;dzbN>S&^CrK8OYT1m>3Z$;X!)AFn>Rvvo;@p8p2kGTCQ+}2LVIFr zN+i#`?#7Zquj?zjb2iSGkN@pI|%6*^9do%jH{l2>fD+D5Q{eS1CB!o{v z%kqDtt1FuQ23|}THYWN>zG&q$e5+I&HKFyV^G|=3tEX2d!gGai62=5VGNs*iJn|u7 zz^JUCAOi3fOR>E9Mez9O=pZo0CN;$~tbjHps;zBphX`Lv#eP&`^DWXGlTpBaZnTU@ zXm4KC`_&uyCAQf8X68p9PE)^1=LcI>Ti^E%SxA$IEmFM-+;O0<SnBQz zRkJ;l>b54*a<3%&;Io(~sYlvBXcyag-3(;+d8yVM z+o-B0X@Vj3%gD$-{hnHg*-Om#N_-YGAsKSE^TCc=UIrW*<^%RrL zdavg_D#UC7x>aw~K&opdt?|BH4Bkxf+9?#T9#W8a#%1l9?eQ?I+JAKPP*Dxq zUddxW!GR}2BQZNm%S}V6(jjBnp9mvv3V_jSDeVQ3!p@rIY3Yzpziet!0BuLjIHP&w zPNYZA9Zs%s&ls&d?l0FR-trg^3KuIfCCpstAoC3}6(ARlWRyuy?_w9z`6e76u72G7 zD1-Tr4v`Lf(J#!K#plNJlTkPw1wR!nBB;Q7L~h-p0nCCEDlDe6Q~7V8R8dSt#`UXt zpG{SSA|m;Xl2f>C1_va9Vky6>DJjKl>E3Ujc#mr5o`o-;^9&4H8PA+?3u05B>IM@? z8eNE)%3NMPXtLiir1}Z9aAc`Opt555mycBEF4mEJ7%=DVsE~il`BVEux;g*Hn|z0E zCe}{G&V$5*jXJ$;c8rP5cJ~=&>Ifyf`&WZLm9g$>$jv)py!cM9UZ-$*x7`^nl@h zqb#i_#>8V##On9*^BY6)4|V}qn`M88_LU*1lJ+DBpRS|OzY^(g;C&MQvn1~v$7qCv zgiKInZT)L>J$BVa2+~s`LI_f_a9;Bt$JVM3@ukGveeEjWaCUO4j;Jux-2ACX*e*VH ztmq+|Z#}hiEY~E%QolZ;St107c?5t810$p7kdwxFP<&N;XMZSR{v|crSnkwC5wy=c z&mG^Vq-~eCv$oMvQGiylgRnIwWP$k>YY$b=VsN|pdu!7lj;hJWLQTA7E~qayF8@lh zJ?k526y8lbSJSgcT_%CTH|qZnD*1L?7<$ty|5ZXg%ix5dv$#w&smT5yB>2v&Z8OQL z7a0?d3_YAKTU{Bl3%g)&=obUq2#@h$Wm`jzAf>5p=?>Ok9s@REvtbl0&oM72ZlRJb8jCx zxe-oMR&l1Vn3w>iu8|osa{h;@+6kiCdLK`?)%4%>+ILIar`KQ0v*gb`DdM*gL@5ke zWuVc6Ne5bM4^&z-=Sd%5L6~AH$sM%Ba1K(p_*`m0I2z86)IbxYq8TTt^8OT6%WV?o z#a~jDan4V$HP6ynd^epm`&{I+Z79--g1SIaz52sSj+w`gRA61UaKi)84|N>Z4~FN3 z@k7eRKIYlx55LPyr_#v>w#Mq5l6<(cMe+WTnV;+-cC=}LI1XTuPQKjKxneAg8Hbb8 zKWgb?jal2fy_)VQJ~_M@X{jz4AyHFR;ny1+IjNZa@`E!QSSmZj#l$EmDc{>4i($CY z8M`+1Bdl{98}&|9OV&AohdshR9w?KGsAJYIh~F+sGX7A+lrlssiC#0uDEDC~GG}1F zd~DkKnzoiB4g19h&#O{3>+B+qH~;MS+Mv~$@lG9fO`-EmWW!fNzefe4$16@Syv7N{ z5tbpW66eCgetk|M@yz+{Enzuj#@?u|?q4@mvcJO88yVpOj~1Cx)o?oiDOa0m5_A3- z<5Dx3t4;DO&c%!5^4}>56N_5A?Sk^mZ0_#8tdi{|1W*V>Yyp1)LqkndukTe%d$zEa zsXAYycyIU1SI;u|Dtp@8e;p|x(YKkk3T5keug7x)WK6W(7qkm8fZ1+>`VSA7@OUuu zI2T5-qSBkJB{e4!bjGwt(~gErM1PP=YJnpO^1gV8Y<6S%2eUjh?BNx$#hPb*z1ld7 zL=Ur#{KXPZrha^QYieM6$EU$BbSCZc9n248R0so5*Ug2KNQ(9bUk*M2u%x3Aa_5X6 zDRtdu{VDa#=Iq710g0lAg^@y4dp`!)-4IR$&(d!Z!$QJ-4vZJuYWjx*)6;bX7aP@% zZ?R9DN#CKsLwnc-Nkv2&o!ZFbUz;EAdV1f%Af08rr!UXU)_y2?9Os6(Xjgwtx549}|oWih{%wBoNCH$xI@kl$Li zxoUo!UdnSi+qb><#@*GL+-F@AN2lt7^XQM66??3oVar^ajIqB_`3)BJ{CJ3j8zKVp za0y|VojPoD&CFlIcMklf!H4nw$0)t5@y<_fL9wZ-KlZ>uLInjO0T8#LM#9ES{Zr({@$NGCJt>9Pr+ze%RuOuRMwi zu(d!Up!L3A%;NKRsJ=APQarA(p29w(>picu zgr25YN;|>sef+q@!Knq3=sy7hzOPcENEvmB4rYGuaJY{m5R>&eW?Rc#S87E(m-f(Gg2--%d%LfD9W zcnrwq!9O8vdSHj7pZfMty~ZuILoPe3Nlcn&go9#Dd$#r7`&Spwcg0)ol@s&caN$7k z-jBVGVTOPq1e5bWxGcgk3b6)-Gx^;_px*XfwPs91V>*{VNauh3`H-IW!Y)?^)-UxkQ{4<{6O5Iu0n_9($f~JreSlrjWjS20mXenr z2i7=rb?e_j6iH6L@rwir56#j7I1(zMReG@E$taokuDFdv0Y2)t3Q@~{SxGK9ELQil zO)xryMe6oGvX+?kr5UBJN+sShv3Kv@A?DH#L#e*U3$jF7+a~a+Y^X4fzhlC@ORg*5 zq7Ly^gr^(fg;md&v61vpb~%*K>ICLb#my&Wc_<_g+&lA1%$xJvhYV^LzW7(K?CE$- zUwTO(YU~<%-fPF))b<(MiD&Pj+5ai2O}kf_#^7}Nq1oXb6Y--IZU1vn800>TKrjxn z^D>myAbPNxP_D;J9H-4KgxDeefS`Q?6jyU{%V;;7>?G93^1_pLhuXBKvjJGVZJ4AgHtHmc2tV+?!#9TbOrc`e4KO!W40O> z66^YHBH-&8r$#H12>S`&=V^h(6+B#c*Iu%Fkm@^KmKrs2=Yqgu0Yh)1SEM>|LJp_> zl0U&?pP3VLzTy4i+5SvBlJeO%Z%hT=Dw2qJCY+UVfA4qrxgN(I(Udyg%Ax#gj-ii4 zd6mJiBV6pb48QCq=4Pn6NjpoO_yp~L5#u6AMi7%Chkcs37Z|q_Wgt#XR3tUbgZ*jR7{E-%4+s$Eu*my~7_ECtxXwav+zyrq?8%87+nQ?! zJCw36%PF{W@{VhpT^QBeDJadY$*+-gJlw>(lH;6=-`Tsd7B+%RYH|v1;-pLd-Lx59 zy^~AHgzG2t&pUSQB4~905GCLe1Hq-?L{k_$uLi<@0A~CT`>41{GymRA{9-K8TS05+ zWx=Zu0oY3lxxh2gHDs7N;%SEp+-HI$tEeJMAu(4;hqJv*sz9VBg%ulYA?7rNz zSCEp}W46aXW8GX^yG5LAXGj^=_ zpmT$zZnQ1W&|QeK+|h^<=M&HmX)GUzX@xOIAYAj{#gliv#1xhO81zGg7-vR-_JZ?9 zfGA0XTzfmmp5;uiTErOBuFPcda5EGn`rLo(eQM4&vMJ{xdqNpa-frxw%wQT2rqx7* zA}A6)O?DBW41o|Ortr#uD;yt$X!?hTiGmHhJDRgfJhbG?%f-*6z)%^_@3tI9=vm>I z&B$2EAoC4@>(+gwx!zLJC8V{h9~PHJMkg&N(sh?U)zsW9Ps?9>3{xi9+P@|scqF9HWBU3B$#H>i z-l&Y)Knd*^8ymX`s-k*ql;|qidB+%N_$iMhEVjHuHKyL)LYLf(CI0rW=OQtZ!2Y$ zWVUf7JtR*yyDR$C@_3C*ROjUXBZd;zq%YV zphkb0Ti3QRlRL8-UE9oK!LadFDL$krd2v6@xIfr^iHN1R2w!wkA~h7R69#|VC{CWt z=w}Mc~)OdmPR7yQFO}@r1 zvL$c*qs7ICYP4Kb_>LLaK?P+9`X>&}e=pS8&0FKiN$_lc6u_VZ>fEJnpRC3p)_`&K zoZQ?m5KRv-O!dD`Q!F&IEp*>5+G`{*SUfT_Q%xz|%QJjG+!Z4P1A=S=2)Y@z`NWu; z7^^$4)a2$fWyHAL{C3K@HMCCI_L|V0n+A$`)=_MG%ZqcjjR!}w2P!fxrHV4jAR{>| zFE5RUV-vADLBd`oT__cZ_&GwXNW_aZPXpms1i&|AUnF34?9g&XrL5EI^HsqOZmdT) z5A!uv)JE_}Igw-v(I#oF%JDoJZ;UcVYlph;1;{kbC^{cMe(V5Cy5=8q{e^Ju$+hb5 z(?6VxF;f7hv3T24tirjC4-i~G-xUPuo*_g@c@RnpLLxlK-*l)VAKJ)=lh47fp{Mz;)a8Rg0i4(cFV`P{~8X4P&2bG9VM4; zu`5rzx``KipH>Jm`p|Jl%%fLSAq_MZ5u*lY4HEBX%OSC?@?C? zcg5nb)dYKk2(tU^anKmFZ6bq)F#JxvW^YvafoTm6DFnFx2lU`M`1#pj5$Q^vL))H;Msdf3mQ#acf-qi_h@^_IJ2BkOoSanzF!Q1R^;ip`Q2` zu;yz2%Oy^J*eId-vN<=&a_I?Gz7VGL`>*)S&#!Xk+Fhv$A3xMq{D z;de_|bm0CIhcEWns_yQ!F;@pggv+`-kBW~73?9tgGm~V`U;ivHkXx(A<9>J5jaqx> zT?JRHHzM7qK!PfQ+SGSd6Q_&z)#I`MxA|Z_yl%O?ShuJDKzwn5u6p__WHu|;i?_?j z^5m}A+IV>gTWvONv(jah^PIJI){?KbXKsEW!ya;p^tUP z{}z8hq4k@SY&oO)oDI8_?qym*2n!D7y#ZK@LqYhKZ5((#DjzFlAK=vv5puN6>yC05 z@;csE-P02R4r-4A-L)(K{yDlca_l63V;|VexK#6SF305PrkqKIuu|iRiku+ot5y>r za~g17Ue&}aYsz^|o`)-egX7%es_^dCq~e&!3be(Aets@;kh9(r>TH+iV>j;C<}cGe z#I*FGf>DM9yj-vjrr3TTJRzj9RSM2XMPh(CQJP~2Qa<@tY@;cddWb$Y<>{+q7ya@B zo@U%HSU&l6&{@>3>5HvPz09@~e>Fh=W#36grlhOe0Q2F`+>Ju9RtT244N#UKm_i?Q z+s>q(?vc6ejrKySE-N3vN^EJG1;*tM4xaY5w=wA5ntS}n53t!Z!Rte;Ym%ZK&Fg0O z(fDigqP;6`-%`C`Q~UP%S;o+1R+zCCSv!taG<}3hDlp}JiOf~An{D(0pJOU6m#rS} zVtaezYmnuccWQzWcPoB21dvzAH!;|=T2{MCu!MPkm9iY6Jp)=M@!SacIAJ19dE|%$ zXt$WvSAqZ!9i$?-_Ge-s^>bO5Bsuh~dXS|`cRI3VgQYY3WquMHbL~g>pvW9tuQ|?N z&cubYVM*SG8M=|58m{-RTUCl-kYb*qp~=rA@HXHg`w`NDXL;PzcSP0?>@Jb*B?*5@ zrn;!=xmW7eo>`Cb?WdTmw;jmOXO(PwyjZ%XXn5G_UeM!)j1)%$h32^)$VDRfZJq&p zH8eMuhOIu4mIFC8I37v#?@Yw}eraF#yySPS>RJBhP5Bw?u($^2-=h&#ILB|D>AU{l9F3e(w?K&zHT2l%!2AwEMa7X-j&Aw>kHT0e^)uwi!i0S-=>+9uM!OWZeVM6p&dyT)cFd-l!|1*Q0^ zmhU_C#%mvZbuR?>sad{Gz>Yz><5;qm<-3r>(e24p8r-M%P&E%Qj~emQ|K0oK4C%qa zv-h2*b^Ix*ZmMZp|Ij^c8T&oR>N_R^|3FrS+wr!o71yn5w5}MCDGHu%_N4174!BU| z#H=dwhki8~>(-q9g*+3zamgE=0~~8IV6Tuzf*M1ZUn6kZ8cByl6^G-F-)Z?gyh9!% z$IHxvd8+bxsluDIaN$9!_g3j4epJ5A|o*y zHg;HQS0^-45P)JDO#2l0|Gi7)+dnZhI+-%0ahDi>c%=@mw3 zE=wORCFin+{C^1L!vtuLh8|ihS#%42+;7#Z_ng?x6u&wKrJLyNMS96L8IQULG6&SD zU3hcce_XfguRgDSF7Yn3f-#~jwRM%ZJ3L6}7U?}wUZ&Ji^6EuO2+1c8xl1~-CTy+W zn6dss&I)xKpojI}u3N*P0>XiosNIPvBg`6!WZ3otiagt#)EnME_(wCJ$u#nG1%)q3 z@2s=m06_#|&!1gk`e`SEJ&h3wb#Ti^|B8n>Bsg7`ZHc{}~xP15_quUP6CZk0y zjGj{eJu1#B@U^V5+#2qG{nl1u)book$UButDggpZliS_ZHBXcfc-^2P^c7b$Al+<^ z+D6f8w#{!=m{syD35IPqrZ+E>%nTn52z@L^XoaAeLdFS>_uE87CE8)4(hj zn38hYA!W`zPY z8`?d!L!fDB1)KcW%uE)7GQrU?^I-EC95L%vkGh~geK&KmM_i}!L)=*z zF>+HL+RG}`F0zFYoLQOevMbweu_yS2Cec5kAo0$RsJt3gEfZ_xUvFV|^6!%_hCQEZ zEBDVd$ur;L^0_3?El}Xh#cuW5HT~dlyn6wuHf^hN9(%*1Z@5HrDge>;Bc5Ki*h> zPu{09`z{rD+TOuZvK;6Bjh=u%yVy4!Lw_~(U9?Dk3KN_6m;++gKPA1qlfRt4No4Ic zS$KoaJHKH=^QW=CMSCl}z9z@`dAXPxG#z%~@-0sDU z(EBT>O0)<>s0lxP9v|U+slcZ0Sm?`M3dh32>@B~O)>`+kTFl$ucNnC;EVQ1~W#DC= znVlVj;TC~_gkIMQZWVmMK(eP`^R0CT2@awT!`tTaKRr(}-@5E`VCToq@&$rV*&OZ4O=<@Z8iVNfMWY2dSos_GWNa!0jKY6*jC<~lsaObKz z(fx9(zj%_*Nk@`G*gBQioOe%l29{P7$Mg(J3J-PuxT@-R!}IR>8F$O7Lsa*7(<_?Z z?-`|JQYsf~lSnME6!i%iVcWY}Kto1L1!dLSh7{^stxUh=p0i55+$XTP#C)w*E+DPb z@Y1q69bE*DW^Ku>T~S7XIhMld{bNV@KUziBQtn~!Vc1-xq&wR0&s`L8(OmZLa1OKy zJx|`<-uf)uU8Z4DYnnI6A~(AsJ@d-l$Mr2N#OD^+I*osBXOm?SJsveQvHB099QVZM%FS8^eUZ5X zr;qaV@n6Y1wCm_WqN3L~GLrpv-_^FKpMMLx1SjoB_YGGx=QlgT^W&;( zDuVBSb_u$3^Nf*|vHaT6*iMV?llNr>W*(M&D*H*r!tz~RkcUBxoY}i__NwqX{hy@{ zujOLmcaHgs4-QQx*qaP7b#`7J;1=+vx;tZiHY(Hgoqk7&dUNpG6#6ieAt(vOG0}sE zr?MdRl8Vm-Q$gzUtmnj7CEg-1%g~r*+S2p*`1C#B(m0y9(Y;xdj$4-2i=6S9+7HO`5L|`-JHc#I)FqRAJ5_ejHM;hK&EZy?4+ANQj95w^ zr{YI*kEgFa5=wp-Yqm;zuku4;q9+KhxtcReg8iR_^90fpBZp$PEuY_fBfT|qqjBVU zhza#FKY7*I^D8?%R#XIq40gbDrf2n+_VUs@*~@Y}OsMAcY>%#8b$zlg;UJ1{&TQzh zT3T9s%H%El*etb0buS5ymwC_pnzgI{DN+<;pgyqGJQ$?P&tF7*^=UTqbs6Gn1 z+<0v$=g{n;d48gL*6Q7<>6rZ;M=B>8ES|3OWZFNCCRMdhx)G9Vmy^`^O^iy}Xi)uc zfnQCLg~F>_jf%V$B|m0VaE1Z9qCu&X`g%kT5@2YsM`!( zv9+7NSX(EBs;kEx12FQXOS0R0D%Ev z=n8^g*~YRKLAOQMwtL^cl%@ZkXlP4-;gH|#*@eGM5e*r!7LztY99GhwpXXS-`_Sq+ zK5_4Mf>}h2Ws#%9;BxInIl9hkgL)^Mi>%L47P)@@T3*vR@r|aSo9iHrNL|Br>pydf zg4#CQ36>KCE240e0r!DWyAjE6V8oM2N>*$BRt_Kbo@QfbVY>8)`>kJkHKXG`i(0uu z){a^MUjyIFDo+ZHQ1UR5&vH{K?%LL6$273?fbM5DUAS!P?v}63SMKi=OFLz0M8fjU zIrAXBjCIFTjazlc1sE(fOb5$bPbG)?ZKnX3^z99u&3#t2TCbZmqKec!wDsl3yU9J; z&J?%XUiMdKsf?G5W%iD-r%>O!d$&HyNg``&H6PU+k+cplLU9^PqbFsQ@T!=&0qgez z2M+M9=kVV3R+F~BOB>2EULz|gZ&1s^Lz9r%=oM#FV|tILYPC#L{JM{k(|niDhvBA# z5wg_K%g!ddXu^$KneLxy7@@uQlJC!8j4TDC979N+$;(J5X*#VP16`*{_DQn^omNx7 zURnl*B0N_PVz}7&_fPTFG64aB!jB)h5lsLRyqD$-?w@Yj`*%633c6|%y7pv81BbrJ z3P>wHqGLLG+qzc3%WBfm&D=KBu#&R-oyqAF?>8(~4DMRKHypVp>#bJzC(@j`=ZgQ_ zuX+u$P5KS>n2^`{WAgDj=C!@u29qZ|BaPX#OSJ|Ee)XMqwF+C{jn5Ao6%Z_=J91_J zfwH+u%0wob-aoxdca8>UkNp$QT`*%BmpG=QXeuz1kQOVGl6kw9q$DzRt2gAx_Ws2k z%KIF6kEDk6{SKw=2qELGJj>4ROIQ~Zvo4o9_5u|xv1F#Twz0yF?D4k+nR)rChIPEQ z@*Ur$Rm)}XgA{E`m6624vD1Qu)`BK%{!p*F12!Rdsn z#pz8)uU7>-FC3eFo1yVKBkO(Bm*CS>$Gz)+F>~jLn;SkgH1snxd=bMX&c(HhDyL3Q z_Q7?1UiF?2+6{%~=^>7Z6M=K;cZNBB-xq)BqL==?OIbDi&&W~g_8J>2HPGeZtw`1( zziZbnAi4yTG04j|>=z!NnsKANa&i%q`g^q~$~MEOt`fhP=;q*w^y*PYliauv6KO6M zj;}H252nm(->bc!#duOMjzZG+TF|gHkM$m>hAwf16P;0NrL%E44@Fe3h;xIu$nY!J zz`Bkzn_EdBdqe(Br>jY5>G6m4jL&Kt54~|dlHE~B^VxZU+I*fTpE{&d@y=a&uTXkT zs(rakV_Ul69IpOeG~P)9D%w%x&p1misTW_+bCylFyOQ2*{wIib>cK4@&ci9g?*6Hl zZrQSwyZ^eT^DH~ghm(?z0QB__3d(&Lu@z#e<}?`UJEHBzFuebZSPe7P8B>Klfsp%< zXzP%hYl8)av5en;JHR&NW-4p1|4y(I5GXD(?B)1gU6DPzrNGDh*0o2P|CQ;KgkKP! zxLieuQ~qaO{%21v=}g>VT^JBIIuaagM>j{ZzlmJAzBr`v-x)209{JT&DR+)Weoi`1 z&u2k)B<$inUhz()9bGa_+l;2Z>gm~fA8*sYT57Iyl`X&hZWJ_uUFNne&+a(e7)=hG{i+XK@d%5P(OZ<2R5@~ZgMq%*Y+zq`@c&3iAE ztl6cje9x2o;(6YwxV!76!n4`tFT8Ej*(M@;a|YTT^{#Y;_}yQ&-8jS{$(G7K(skZa zPLN}lPUTqvkEie7ZCN&%M7L^m{yp()OYsnsL<@i)rnfoSu;Tpv3ThIrw6U)l|GgC? z|Lf40)>hW&$ejN}m0Y&8;<&x6#hAbP0&U0N58_FdC#krpmG||YTZkVsk@;TneH)du zpiEjMXMxS9%7#7WTIW)KMOxb~RQ{|b8`l(L7u$KR;0XUx#$#oCFzwnKai{nKD|@7= z$BmQ&T)na@>2ja{WFBS25Gb0xoxMMSeW%6G(btOjr|shEpA?k2PK#`@Y_&ITsao{2 zm362T)fditOFcdOz<#~U>_*3^Sw>Cz8Dep#b(s(4wN17DI=&GeEy|Te!rlAe*6q7{ z;*XeoKhKqC^QH2~PH92odvrQkHr7>rHRQ(9Y(-2j!{fQQDg-mx`<_~mem?#S2h@Bv zcTHnM^r>@hLnSg&^A}m_8lTM{dNZ$t|1fhj>v+^jH*0U|#95s1`QVP3(IZ+H~&G7z9x@9YS zB*rg9OXE_v`ThScQ|v1J_@+72k4B?!dj%>TFt}CI)I9d7kE-iHEBtq_o_tZCIzAEh zj!gA*KSn4B3?t0AoV9>cV8s3bS+1-3K0f;c0s_oRmAmr^zh_60OT-k>+FCQpBb^iENdVu%ilw=5wcY_@l@{i}1H~;NMjl$IoB9qgW_aE?QR1jn-frCuk$^8vTcB1PZht41s$;vv`rk_(V>J_9c3`s?Bh`fBZ* z@EGO@qWxxj2u9^_Vo0#E5j|Mdo(?K28=EJm+2iA-V&SoTJL{HNuzB4+hNVnZ|SF+&b%km2^hDsiJr%t|h_xhiU^ZnEk zCq3C;eiZ^aLIReS-3V}-SOSD^7^3$GQXy9M#xhpTz}T1?SZ25VK}|mwMNF{R4((tpvR?FGCC}XR|N8C7 zUI!U}^D~%%3Zu)=Y{UKTgoOVIS@@7+Buzvmfe$sgRsviY*g{Opu^NfKzthJkr~ zsjv5i{}bV}0K&O4$5p*p>xp^0h`C*#+SZGE*(5@8-%v7DddkS~tSU0K%hffTY_e|_ z%g2wlskv#X6*8nG`iBQ9*K@>CTx(ORdLTY!-4UT3_?+TF5`*qr<)|Roc z$=Y;88QbKZQTP0owKb#3VUq_(+XlvkoEgY1Y)DV2jmoZ+>{i_&5SCd`_+-0rz(jv- z*_2$`?2DF%gW5b1J$rTOr}=K2Q64TnzbEkctMKrBPokotYG3bW2unui1EE~|fmp>? z=Ghc6!aVWQ^N8%&vv1$$h6cI*A1Ho+eS%s80pv(=HEda1U9G@qa&y}b+e+1Cs8ue* zfXOm$`L2!5W?>`wgYvbP#e1%Mu9Q7lF>CoV+&#q~up0RKwW3vr(an$^5->wSq0cNR zkc@3kq;HU|tEs7IZ1l%$KfZJ^Txw+fM`XN%;FFwwV_5+_Mu=9>wy-gpmp!F~e zF*My|tYIJMl4P0QAU~;GM4TMbLE6}FUOBR|z*IBCS197Dz zJ>KzBE(O!U5&gwy#`9eOeq#cBT}o;%$cS`T9#KC*gM@D?g2M>mvP2lrp+Y$a0Sh+m zjJ{2ak(FpOTis-)@i^kY622BSGn1R9@%*=gFo*>a2m@r+YzIss6)0eFt_5{D zElxZIMN+gIzO0_UzEyQ~`%a#WTHTwah&3_@JP+0ja2m@1H(klag`j%{bqON#%2ak0 zro4pF0+cRknt90?Na0CFuks)N6||m7XvE{n0CZs=Y=Zh4>ceTaFB0qsWCSu#oMdo0 z0OBQu%qtjDWh*&BF~Z5q%WG2i{rlNVmyYP^=|NyT#U^HO2e%V}%sI6dkWK{6+JJ~t zQ(GH@JRjTzl_EXaRUR_HIVst_h$#UJY8wGbf=WQ1FL?R#p%W)`P0R5sZT<|2gZBoF zT4eKZn!I-m#nGeH_|y;#rYwhr0}?`_1=x-0c2*D1IMW8=TX3d6#d*uFnVXn91MdMc z3#c1Gi_B}W0fu-}PL7G0dAG6g_+{UsbQW*eENsJv$+hgIb#hu`U27ldOOTuOr*1ya zu3MskC@EFKZ`DmwLgIyJIb2vZva++4z*jS}u8ts%@{|ab6G>f2ZD4%d$w}B6o6ijDTu`+|eG}nsrJnoNJKXJT9ZBaR}{8no= zgFvEvf?&FM7Zo|iIT1z)ZZ6nz(kuSCEH+C9fw~nGbA;~<@&sGTAAWv z-FU)WlDHN)g)8E{egnRt+wJxb^0yUn_a;k_fpd%W4JwO?HD6j@sXvR0JQFLZevZ?z z@$sp{=-m@gbPBFr0<#(~4I(pZ6o7DR zKL_$m*kGy^S7Bq;lE4KSl{=n(I>rHPux0a3OG|@qp@Q4=IPlC=*doxZmk|IsSv3L2 z0u3{t+x!K)*Yw{ft4*-7-;0TfF~h}N3Pj$+c%o8U4OoZ-6V_<%;V5jF3I~Pr7~$__ z1_N#H*w|s-HAqoK@meWDy&a8t2@E$_K*g(tR8r$0gI)!kW&nwk1fiIs$m0X;?P-ue=Fc3uP( zkoau`j9%5+x)A0JNI5AaG?WGUK1FJAMG*PoaC2C=jT=(^Da5b*1$GLyfhO(aZ5v2=PkfhSS(!DWwJ{`WR6ESn)~0OH;?W7$h(JPpsd#_6>`7Mn(p_K|bJC zuEPpwZ!~J-=@+X!Oh~6!1D+p?wwTR3#>szRb~YUm-m?8f1{LumZR>{#zbJ3)F}85N zChiTCEZ!2air}wm7-x0Ffj!FxXBlOP{_&yT;8PKCC#&TQxDdFlEqJhk z=?yLXFg5p1&w!WONJY#4%PkpbfFQrvfCrH4@MBZ_tt zi%AAwj*4hGCB>fE*@4uc(_*7`%AR#kvYJ8)xrXq&Bj2dg^Mj0 z@h!h{8kICPllzarAPCl1u%TVehsP%v%%Eioa zQ9K=0-P_5@D`)JIKVGO4NFiKyiI5l~{|65Qrh`cp%To;x5r-4B=SXwmz5X)7FM5vf zc<3gKLT=vlswn>m+)Ag|u6gTf%FU>+zd)QW=gq>G-*KAzyd`H|}V0POvu2`7c5;KDL+(~(7#%Arwor{)k5oDMMPq4BKZLn9e(LJ-Oo~-X;ik&cZ}?_t4-5PL#47|^%^;i|cuY`l2zNjuCcXkDGS4cUv3Q&v!5zX9yoQbxOBlSbV@N0yL6TRXAP0~sp@r|< z*iy-1@dW?-TZPsPIGj+akfN25HZ`5(bsY;^ETVxq#AzZ56<3%3a~ubP5ndk>PLX+WLAUB%_p|!6Q2(Xl`p^R@;#Qqa0$80A3JV z+7Z=1Tifi${|n-3h!9BC`53&1iixLaA%=M`Y<16(l9EEYLP{*&Lx(0nV8kAbe3C8G z{BjP$z2?V{V0ZT&@EFACfZ#+RjQ0=RAGUKo{%h^*ibjXv?h@i4H1Fv1%mc=aF!+Iu z@>7VU3F|rfhdobmTDjbjz5dtvwfjvfE`&^MocohE3Ik6(<)y~$+qUh0apS4w9yVf| z4amYS#O*6_CRW<#Q)_GMz&hEE9oE9+)N42 z57rE>`8C}uuC80GjiJb7fi{Z!-(AN?k7#|Y(`J81mzFxm>aAuMt)bCCT|@*9bD3l$ z#vx=05-88ID~MTzOWO~e150pvL$O(fn#rZN48J31@X7E1!-fY#Ufr zpD-(kc8#4vjv>w?S%kw7dVUn%pTB$=33II@sx`O~5COV4baum8MnwJd9e54EHDQv9 zNxjvC2Swa;<8^pyWaj4HyEwkn&g(s%4<}|p&fSDcxxeg6ba?*o)YPMTVnerN{TeR( z%;XJ50Oar91_x)uZgYd<+=TaTRQQCJ&AA&9LNuKEB60hRn+P*j6oLg6|8&Y83&1bz z3)=9iZ?sVe_`#i_<&wCv2fA1W}97i0g`}h6*e&6qTo!51qXK5WugHuFQsNVsO z6>%=vjF?vrx|!pNH6hc#)7=)^*=Z9j_Uv%+rQ-A9$RlvGOfK~CLyy#I!uEYb+-_oI zQ#EL+ojFfN77I1g%f*2KP|Rv%9qx-Do9*&_Q$FjJc#whofL5B(D@%dZp36FDE-Smx z%*536ebam#@+~<@HE;e%m50ZPcW?zHUdv9M_SpC|h?IWy>aQ;lafErU?&lkbM+CMu znW}*3cnfX`2`M(qZ)=~KlXKj}~SxXDl*5cXQ{0V4y^l5SqCX9gBnHKz@WH+i)%Ynr&h5M22LY<}w={ zf`YdkeCH??39BF3%`a>3zI`X4Ck#PUXHPA@XW{{mEYS8XGTE4(F5&MkwH;!}`Dc%^ zGZsHD*Y0KugXiJ~b8@kZmsb>TS=R_&!(6@ykrV|fzp$n0&{@B0*eZf4gV9S(az3{v z`7J)1GP!O8b`AkFy=*|j>Lld_X_v=X_yL?v_SjGa!vMc;?p+3e(q!9)YQ zB&MV&+V>hAIrrHU&z?W5v2P|Lii$Hon3zmAHZ`3=+DSZfi}sR5RLIU35gYp#7p5Fk(*i0A#E>ZC}yIr z=RYrY7ms>ea=Vd;a{< zPoX)_1Z^Kad^nhIn(lnw|J+*w7Y%iStmVQpLB0FmmNqpyB2x$wY}pt09(uKoJSeqF z9OA;MDvabn`nGfDh<3Wer%(-Dkxl$V?MXOdq5Z{WQ$#C_;m2KL#t)tAno8f258OXjXP~hdhadFEU zKl_Od5())YtsLRo(EUrl(+Ne8`(M3ECre-2A}_<2nQ= zb(~Mm$qOAq%yxr=^5qjlol=5`srzW2>k#XO-U!}UNT@_ha5V5DsjNJUK_pf=dR`F_h*=tsh{GxID*OQwpt>h7qT}I9=6$$#4JDGz$Ekm?;Xtyg7 zNdo8b(dpwUj(eX(Mx%bmi{7bAmmDfsr_-K!W*?JJo|O7j6u>?`k84?Vo5_$cOc?r~ zs{2%BFgH^o7WpXGkXz4s2R7C@x+y1c*90RHqjK(fCJ&iR>c+aA&y3H~whCPHo_*mY z2dBfVwOkc+U*XYe=;G+$2k~2ZA#pMcoz0#a`#L%qMJ>C{^nZPJlU08?u{$of^?@0B z$i;A*(K7fB@saT+N4GwOK!JDE8>ji{nWW2B^>UYvBh@w*ymvezX`rnH#-R7#OlMtr z2(!U(>mY`zXNBzNp~}WVEeinneu)?@OQ?a^jQ+9u(V6Fsph}5&ToLe(jat^VY)QHv zwX^*EMzXv1J&bk_M{~V1%usaqKw9;L)p#WNu36KZ zorq<`cdjFW<_PBRom-pQ*i8h7JQL8xNx3RR=893(dQ$E}o4T4G@9qET7q$@zdm3v# z`Zd~G#-9b&_O4?{i=SXVP!Wqi$epro#9>{e(aCkFbEa+6vWh&GloX7SbTb~AHuUrE zv4`L@%>MDi-I9{#4D{R1n`ZzF;dcDqd7z@3E2jD3lAFxQ;*dF2q3D9ipwK3*wjQWl zhdgkHj#(S98GF*!9Xky4^nRhvC;cp{H@&OrmmppxcQeB44;J_d^(B8%Rn0BIC9idiJ+<$<`*?E z00BbIF5D?0by{}P0lHh@iXoUsS^>8s{OL>Z$S2}O0Gsm(ud?^5dMaE(II^h%yVoM5^`dr$i?#=D@Pd1KoJyTfr>p6jw znraf;MDJ;7X<1uS8VVH)C4}2>3vSJAH(xUyO}=n1&kd2BIiG*N-KcfxDq|6Ki2OAk zX81yi;`lutZI64-4oUSxw=VfRXaZi`PZbYL9?nzT9$vdk5K3prv11TT9$)yLWss0n zZtfg{5=jep+nq$YRW*sLZsQIkxw@J%Zw0pkr%h#@6y?}IGjxXxcBgzlX zl60scRxNPN;wXaI`iaJIDKs3|1D)7;IJsMvamo?AyouGnabu--llFu;9MO_#!)0&b z9hGVfV;e8#4LMvQ7y`iPTx-UR+eS}guUQN^SNkoHluwPSGMB{l<*QbCa$o2&XuJkW zNMoEC^yMp88km`d6c$bwA_w4gFH`wF%LuzRCG=PtTTioxYB_{wRVOB-;0dwxZ1r%p zU!>O#`33kd8W3a9s~0`twPae)hALdg!;j|n2)-*~UT|{u#pVI39!LYme182E+sjMM z#(sgVEIWpE7aT`*?0(A=kV~|t6^!kGL4zDLJno*HW5eG;%SsW_@+Tq3fr?Z32X)94 zw0UtOA|og9M|vj`s2NOoZM*&f3GYVuJLR$w&R8;E~Rni{v;x4+w{rFjY9+j%Uc;q6qag8>^>kfsLTT8@gW%~7$SthWH$ zY;A5Rg4s-9kCzQ|0=4Q3sCd#5HyI|NqN(PK0?sLfGe_}!xqZ{MB) zPvKUZ@8(zD+2eKD#rg^=Zz(A>KlpKOXx6vZ8*dBcHCcFf;_ee*Yzc>)EO1%af5UCB z4!V1LCx~@pu9_z;j(OIBysF#6Uc8z?_b^1<^ctwe9ONfZ9%;uZV#u^9C~GwB-+!WX zF}`?I{5*dAMiZRbA&Yft=w|Ciu*KLY6niswojrS20tKqp@1+wzP}t9!cK{c|4JOD% zlt1$b38#IztRmx4VoV`aRylVh^YK$@a!6AHuU5t@U)5{^l@^kvh{N$TyWsUrvv7C0 zQTB<-WQK-1Gi>?p0VA#K9|PM|^N*~3U)fS%*Pr=&KUNlRrwO7?I)u>$rae0j9Ow@C z@T4t)6T?0vI6PmWMsE6q8*>*A|M5pc_wC8aX7v49W#tV#RoR)p!c1mvwZD_z#sw`< z@ujH-eyVbKf8`t(-gc3C z2Ux6_*~O}8FVS9r?^~tgmXf`WcykYHvw}VxF0&IMjRo{pOu*~bg7=QbBS`x2K8Gvdw7f4#o=CZP~g*EQp^Fl#^(Dto2oICde z4WIhv@mo6del9Lw^_4O8jaV#XUB4b16zPjjCLnKlsQUyLFqyRw#m2 z5fz?D*y6Cf-I>8{^%llp*M)9xj7ZUWxlN#vMAOYtM1Qw$pFURWgXm)Gu&oSWk!bI} z=yZj;nc1vn=?0fU7}u^}7g)^#y`y^Tdh6kp<{^7+S1(&8hUyMEtMwb;y1R`|rCnG$ zuD^l7YNa9bh^{L=3v#y}%DmYZevyK-h!0Y$m9$Nl04hm0eiZ5JFy?zyoe zL=gumfd;xdLC38d>~DOGjsIy*OSndvyB1eSIbxWBu61S{!CQlx8>`Pe+om2&*4Xpi zwprnbR#-zF{d6D$pFnOy|k z6%xgUI{AevA=F|{Ar=T@9Zx^Q=|D`hVJ|gr6?YNt+G2V0p^NVhg_sbJA#kmr;6)ZA zM~u*T&Elk%bf}M498yN}0e@A*pkkjm=F(S@_Gx#VIR2Fn*Lu5S_mNdx+}Y7lwMIE} zP7fZVVFSr8R^1q-x`Wpv;c(^P0n-HpMEBFz4=+)R`C5v1sehikV{GPZFRyF(R^>op zjP>`=ylB)BK4(7uX6A1?vGJ*6x)s=URh57LDlGtZl?fRs6q2&DWrjS7-=y7~pE>T|so4-oe+fD3` z>=V{?&KtGDGJ!fzU?JfnFVGudQ;T{t^slP!#&cT$j^@DBiO(VZB$3*}&)lWbPabGE z8YgWDa8kKG{tLROFR==G<2K{Bmd`FUiFSN#=&433YKJ>!9jyWnM&n0Ln}_ne*@d{& zN4XTxbkyq!#~QWrJ2nFVYA8TU3=aZa`a0_1YfAbYt*%S6Yne{y$y@szL$-b(Y`HPG zRe%6}*~9%_{JF)bXUy;h`)roV{E=^ffGIq3NUpd_6}CwXVSfD+*!~$hhy8LcXXVL0 zB|+kcKrQ~52acJxD8-euj`Y%ySjHA^i4J>%6@8eqye&9(cIC8j2T*Q^w+>|XK?8p% z!TpTbt1V~?$k#Foc!=`@oNu!K>n48HJ6JjQg$r|e@lJ9sP~*{x3or4duVh23p^mGm zUBWer^;&%e4m!gqHT!TJ!NwMzoO#8o)~JO^d+Lc8=V|#jT0AB z?82>=)9j@)beDsH^`{l2`tFS}rW!~}nU$0&jiQG!f%~y7oxHByxG`+fEBm4i{P^=!6A1-wL&(0A)-{Yy^v$-3Q-R~W zZNE|46}_wqOxOQ6y%Oz|;cE=+H07a?Ob5CBl;nw?c{))IdiKae|A&Z)c0Rjm(4srB ze`aJH=Cw9u3_-2^qh680zyFDFH6>HOjB@?oxtjkU-IxeVgBV-gD0T z=jVkNj)Qyl+H0+QJ$F1ttEtGMqrOFb^X3h@yquKAn>X-EZ{ENdAtM5RlSda52YeH7 zlh$+7bh32wgt%C|QHHpEvUhT`w=pI6uyAp;adPBjVP|JyXCk+DbNl2fz{=|I-#@|P z}^8Nd`@5#lW7GoMJsE6&pzm#~-H$MOOtJgoE(f;q3{+;;$&+B%Rt}qBV;{Se? z5;A4}&&5DJmmvta|NUkJB-7}dN%#MHe+rF2>3{xl1jMH+1m%C<467d7|Go0-RrV16 z-<$dW`{8<*%U#y8hK3{o4@bOp9XHFqkym`O@x)!nOKlJbhq%3|GAbdVoIvIO88IjH z^%2?ft#smf->yZTJ>9JIjE`f=%gbBa*bt>}Ow?{4ejk_l@PUX{B_}E-2DMth5j8>d zneU6=xje~}-TxZh9y%Ir=qm7DX9xn?>6EJI+L++Up)T9d&`{U?)j{9&=1>YY8JTGQ z27Q`>{bCb(S+0lvO^2%J6W)&{k9U=om8*w`LYZrv|8sY)sPjGMSO#vB(w{zk;@h(m zc|4Vbk_ZyKGV=JpPAUDWT#{++wgS$wVPXtxk^@O2qTO9LZF-|t98vIztar2d!cb?shfrqFl1j$#9g&CXQUM~ji&-4fMC?Qiq^uZeUs{%0CT z*t$c8*iH{>e|3+Jq94qD?FoE&qWdW~JwqYrc})DxM8nuPVSU|na(!xIB4~DYb`AW$ zZ^7`J2?t1xCMrA}0TmV1=kV8lWfc|)iSX)1uIIA1DMdP~F-xVEJOo1c>!+&pYQ1Mm?9t}Z)@0y;DK@R zYG`VPSJ+uuS$Wb7rRf@>7#kZaDh|{kpf^pFop_-0+TcN9I z&B4*pKH-~xJywwr@OPu6R2X=@oZUC2e zMsDt?RW|S`VgJ2h*k4*WjQiZ2tFdN?9BTz!DSbQcTG2 zKL0*0^6u-`uU>as8R`ZGP~fQ;B2!`tUnY8?BM_=pHE)k6-U4`G7XLr6LEHJdS?%oJ z>)YO&UhU7!clfuR_E9AWhX`F5`Rvh5;y403d468+aJ~*MmVmjt!~X$`n3zcl4?qyt zFoYDCd@V+GEiGyVJPVG$r%yWI2zEhh!~~7H$Hzx6T2;l{>=Cw+Po~g03miq2{{Fak z*!cJ}%;{KK&gX+v39FsKaG5*~+4CK15$`_Dez02m_43?PRok&}a#pSpPB41lqOFbp zZ)xeyC<_8kX=eFu!tq9qsi5I4fPQNs_x*6Nu($9R+`yY~U8yy{FP#dgWt68A_V{s> z#)NMSC{op8Hb^}G1*727Ui$vjHS(6GmgE5SWbV8FB}c%GSy*aurDI}Z>J1m9q+CxG zotmBw1J)=~Nl8gmLc+l74!+7xDd724Xq=dmG8Gh%4gqhQPtVMti0k<0LS6?44Pfs( zaFLZos;;i~IV|EKE^Kda_a*brpKxI$^*v<&2dr{okOjkD(n%Uo1bf;+eRx6Id=9V| zfz5*xp-uhipWnr(*ZC0LSud{Y<%6rap8JAL8A{oS^G1L4;Vl9h!Ro`wFR}?cmGD;d z$X=XRj3>fqUUFL9iK!g|^?>L~-3&{0h+4;Ii|gw(s)dDw5dDO3K2C?k()t-%g8Q{< zek0Ol{&V@w%(s){+IsVJe^A?e`A5-th$bWI%kPeSBSnp@a>j6$1ptTT&X7 zty)T?KHlEw_syH`$;rtf?Y=krZa;x#f8U=EpVC2I5c*T;UbDSIw!W?odvbD8_)_RA5jifx|2iGnrR19P<;8KtZEbB^+vTQl6KZN|^g8_b1Mc_eC=$JV zeR}|G%?r4%=!hHxc0?jrOHsuM2N(BjLK1TgxNXs{$&cuLsMstlEW+1QW>>BYKTBEX z?>@8BS(iqStTyL(c&X9jNj!3w7l= zbm!kf0|1U@p9unP~EGf(74Eh{jb_0G~vm%`%r_{icPh}IqQwbuO3?#V9lbh zUzNdBDU%$WeiMyRy(`No2(KtpghpQ=v&eJ%?HgOJPSb?M&G6XRn1CQl4;!?DU9M|$ zzRoOD(352hxU@Q@S3S|+)m4)<#pJB4zhl*vh7}bv2f%^>#SkI}m)vi)o-^NY~ zH#IeVYiN*ibgbdq;o;%&%O?6iv(+EOPTy7B((*woJuwoNsJ`QB_T$ocuJ?8pum=ej zQ|-Uo&9P8qV%4@^zb#eGW6=k2Rjx{Z9J#?*+w`Ch=5F z&CJ@!A|oTI7#L7QpKqxY6cx|Tf3t2RE3#lSBf@#3_v}I&Rbksi-jKt|7`_<^fIk&@ z=KT#kCn&Kze@Xe%vBJpVzu5h+Dubkff)a$waC*+#Bt5&Z*Fe$Lua#6GS7Op2;b1Op zS*N0+;y0Vw@%M@0^hC1#rAoeVC}#k4T;15vfNUH$F`-sui~HfbCHk`ejp5_PxTwDf zkCci>&D}l6r`sI%vJgk-j=!nU@;F|zR-u*wSM>DbZ!L#tdQu~6xI?GhGP0-c03K?# z^?y4c@7YZ@s|ub;kXv-kgLPbl>CILBanzYU7raj_vLX-y(z*do)e|!SOvO@5zxPr`p;Q6MF-TR&>DJGxPS+;d=1!*8bnLs zH(m*_EKdZ;pW(^{f=Ny;?nr3~SPY`Ht8~upEWk1o)3Y#TN35nHLL|%tD&L-06q*NE zJNtM=VxD$tWTJ=hS&mA|7tav#*dr!`BjtfpmsUBucPANu{MU+i65m$@X5n4%YE~!z z3zBs|Wc;V9KG`FNHT{mO2uRI+NK;jK=E>{se5E9S5VKKls)h-z(XyMN}| z*VpH@TM!wBa=G3Ydp63ua_JRtvfQ32;9jY>%bnVg_T|g+2KWBWLbG!bA0m;GW(7F_ zI~(I9LwvH0AM8J}+!54wZWwQ}Wa0&^g@FqHz0*N5sE27f30cGFMhVk_0Hq@Zf664Bw64jd@X~EOH0>*N(s9* zIzGN1IOCa{-o1NQ=dz^$B@;E0%73`OzxJwyLP2L2&(F`_e*Bp0B7%S|*%~|<)f?4+fwHMQDF!-;B-#6|rJ@ ztjD#K^JICmp8n?U{4yRybn|959?|<)o+;YbC(dYDaO;i}VpY=i8%H|zoBmO_RUS=+-HG)q@|FhviaiEsqVlQ*-hzF_xPo6}3r(Ad6KQoX%Weot3(5>e_? z%ggaAfiENw2t?qWXb)THMqV#$&PtQQ^rS$JhwOOFFBX*qw9Z8j#ZQ434{8oiq9*(3 zLHKC7|3NIEfCW|yLbRy-0ec4Qc|c*M*%-_}s-R(z$qR4irQqE^Oit>6@;)3&a`HF$ z`1lfX1#-@|1qB4TS)5ie!*BH$78WKZCn+kWWfDl41CBF{1G>lpA1N3$cJD?;l%%Aj zF1=WtoSX<0!ToRYUj`y)U!Z84TitEFmWLMp9V#pt6z0cqgNAo#A&b8!IxcYa#ySFf z2VOyf4Z7A1)X<=`eg*RODoU!g^JimOiQ&t(;51LTHc^<;E8&9*r*h^9M&Zk=<<{Om z^;UMNtxK}GrOQB-4^(y^y>c!i3IkDW2MQEYt@8W{*xA_&XCf+9vp@U#kbXkL=m8^s z{xi(}%aK3-jrm3`LiORj{}KO2NS)hgiC5)@f5YK3YI@m{RpOjQ1UurCuD-QI2!Kqf zuaq+a)jNY;@XbnHknZ7-u_8Ww6)CLkMNkY^C+EWIm}oR=t9>lHdAUL{@Jsf$vQzo! z_7~q{>vGwT1%HZo*$v@2!)Tx;4U;svvc<2J16 zG21J5sL>yN6w&kk7Vkd{ZwjD`AWpntjo`x2pntGYzx3MjQ1ae?<>WnWnd2lhbi-Z_ zeDP<0FY`>B8ih+pIA`W@*s}AbC!RzQsCS{Kr=KWF)$G}T8hoJRkTIt;`Af2P_QLh614;xs6Jr1?rU_U2Hy;UO!^yE9M~hJUe`&lJt> z`3V#fjz);;T=Z*zI^xo?v4C$iSJ1P&d;PZL03Axr^H%lLb(l454z z*K@A_Ib@aI0%fBm{ic1|Y?77r3#XBDP$=(&8tUc|EaE54apHlV9!aJr;p_8roLJg+ zsu1o`$V@b!zqmxq_62q2coGrGCCFHodL^H4>wOAAcRMZ13; z@M``jX#M1hi@TomlNVgH*|N*mgh;SaOWd#ipL)WK>6LbbhF40WUMnn8a5ld1E12Xr z<@A!3G!X-LMW?YNcHMj}DzJPKSy zOT8=fc-j;CILEoIWMqLW!+nIm$9G*sfU#?Z3u|!N;)f$cLFgW-(;4?)qz#ZuGAY!& z-t1b#916oEz?3ptqtaRl4g5lsp-W9mgB<^B`PSHo|5XN!fC)=pESs|b`RPIWd_0`c zC`yr~1^%S{W|<-30RX$SQu%zphy2XcKd8_VGb3wl(8CC$u=us(I% zZNIZ$>1h9GU2v42Pj2Achrc8$J7AUB^^KOS1{!)(vX#nN~f*EF9n*+Rfcz5Jbge9vkHfUM+48 ztZtQzS(?b;2#(IK(*=I;#!rU8qsF;!){})Id32Zrm5c>jcRP8a6{`gij2f>}hWgbR zpv%PgMF^L%2yG2I$Y`{e3+5TJxld&wDzN!A~Rg4=o{D=od2<2pvv z`zsydqmkN-?NP78^`WI_tnG!M?Kui8h)cs?bE>YRNUE81afin#SqM;Jr}irXk-JUY z)b#Z3xjEeispKdF0|O=_*RwvtSlc#svwrZ^-)%jJWqw10JNexz#x!9Wm3=oXJObjm zyg3L*WeAelmHgdM9|<#`L>3)|TIB4H$1LqL37bII_;{^xT`{kRhez|{xuz^cvzTLP zKBew!DYm1Y9$2T=Xz66!CWZ#SaanB(tpwYq-gbtO$>^t^l+X*nz4YU9AwE-omQm(# zhBPaM%`x&J|EihGq`l4BU4G6x3e_j8a&S@uDoGe12@vyr64N?Yw~$v?PiiLE-rUTu zsZnVV_|xdJ{L|YDVEDICPTDwylI}Vv$o}?@#NPLaa{3ou1j@^o*eT2<%)D{jZwG18 z^FP<^rg^ybeak^pa5ca}?3(zCv3ZizBw5Ti41+6zNzYH&xCL!V4a9`1T1G;|oM7?mAxOaQPdtL&Xb4zAas0Qmpk=3P(QCY`KnC zXYF?^&5u9ekeZ5oUQ*^a1;{W`YWwGh%6hsb3RVK)&946g5CweL)=u#DhA`vvUAdCy z?0=t|s58s8;G7O1nIhJXjs(0b(=w7JE7Kg3>nPrzp>MfuJ9nUds?+!k*%JU$drC@7 z4EpHUf)E}a-rWCmw%oQzxO)kzkY7zRmIWN9QHJa{$R*C&0jFBZX0ke&V6`Lz8# z`*$1v8<7%)2!jLU>ATSo*=~v3xG(6Uitn^6k7c_`Yq8W$dH<=$P1&Wx*=11KIlOU! zW$jF*Nw{H)v&u~B?N0pNWKEmobF9iOsZd)qche7uf=v6%0s3488-LD-EIZW#1+lsO z)k;=EIvIlgX~YoLj3OC?+!A(yh+>3ls;hguLXqm6H)QG(KiK*Ew?~QS#L{WOE(?;j z{CekISXrq+eOz8}6BQdPxHqn`h`|h>HIiI#0H|Wns+v}X!znz)DA#deU4!2hVePD4 zn{@-EJ%A{?Qq&#BXb6@`Z&c3-^O;ls)FevEDxy}}8&2WhCR%8LptgMyA(Z~)4hXV{ z3J!)Oe^!j4L=L_aH5#ksb05CN^TSc35Kv6-Nv(+7oT8YjyFZh;T-QiE9iL!*XeWZu zi|IW-%)cCyO07K65$kb5E`z$fGu0Ay0O^O(vA$v@my$shVJU1%xqVwg^q~_D)9qKp z{f2zjwBM*0B{xwiQp;lGY`mlzY^diP;aFj)UkFidff{`n`+I35O=+ZP5iS! zf8W+wSm@>PqER5dH7Dn%5|{M;^t6_`cp>w2jARI!_UB8axVT-`noNaxdGkpFaA`p! z9QKt)Y_at81XO>+FE)~48U*Z&Aj(YGH$gvY2g}I zw>x|ZXq%42(U_84`>nvP0~}K0Z5XruQ8d|ucve4wC5Yhgj^c^(C%$AdGczxtm2hHZ7%fZ@hFJ1(8_S+$gE&o6 zbH$cfYy`cKLr~UuRrJ4`bc4Rv4%L|rv=X{M#5T#)U+jzzygaSE6aX^RgMji8-zI-y zgnkfxLFC}bNH0*5&u#DlQVutuj7Wu}i9ge2)7HA#SCSV*DOUzTzz+O5#-S+nZgmc1 z%uoL41n<%K84akDzEN56zTkj!#b!QfmZ{*=)@tGN`dsdkqUjE^mrAHZNEtQ>& zhASbOnVA9j4i%x|h_nqE%;d*I_@|GgCrGB+N)%&K|6)g=geb1B|2E)u4GG(`YOl7= zv=22&<@MZ;A;5DDtK_3U*Ii1MOej;z3i-w8~STQR2G+}wLo)FL_;js%z$!zgRK!nZ2c9f!JMy(%Q<&OLN_arS>bPw#f# zLhTk4LQlR#p0+)Qq)_Q*aab~Dg78}zUH}0goZrN$oGVwMwSpQkMx}=@??d%{30hi-V$u-VZ#tR@X$~F`v(wo$n$}1?uu)QlrO^#*l00RY9 z36`S0y*;A;2p|t7nSOU#5#i$EGU*OOSz4yG-Sw$_7WVS;iV7pfv6VA$_VgtDLY-|! zuD%I4Em*Y$DUC|iNg%_(>8a^x$Ab`ncdF1UDf#US8XMyY8VJ3H5%ZWTSKMX=N0+&D^iuIP3f z>cqlIzae&fe88QS2@7XMn2^HrYuI<(SlW?OQx^^1QKl4K zlu>J23Cl>U9OnqNyNX9&K#?oV`-1cCKD1Ixjz*XDpV_e6k4>x&v&aAmrs_9&lYe*~ zGC`=e->JGb0GRB_=C<>RqQSFJ^xps+JaHouCxx09lv811`>1T}6VZOw_1 zT!G2(d|T{u-hwE7_eW;o_?Vb(Kwn{S)R>uol6gB?>y#vVNth})U09n1OBu!Nl}Inu zG<#oILSp>;@O7gu#JaJ1z??`IjO?;3{_!6XmH+&8{^&>hCS0_;GIMk-t3Wa>K&wtJ zk6X(@BE>U1hp{jh0>ZW^!{Pq59IEyKmxHMY`_s+adA@7I##%**fxKY*N91vQUGk16 zyDAVqqRXvd%N%*GJW47E!7~g~daHyhGHX-`1`<`36L zg(P7M$6OSc=s4)*(mOXRfhR00bakoF8!m*D4k>I~@s{1fSd&989-bK2VxFK9H@4P@ zWLA{dS+qqdXz{0~vbsP*B`9N%BLUnMO;Az7So~-vneWXpKB=-BdOG?i zjUWgp%`h-9e$U}yqO?9}1K&74O0SUC?a{#ecVNi=_;2=BDwM@vErguM&py4&dF-s9 z8k$Ij6^8SSM@i(En&JVs(Ao&C`?C$->~E9yrvNNPy>t3`7KTYBFk2`c+Y55Du%N*p z6`~)(8fx3Dtg3li5J+T(gGVM};XYKC?8EeIja2hu%evj(LS*dtn*cUOCnQ><;sE=z z(5AAKHZ`?ldF?y+tJstwdPBk8RtYqeue?icxczYl0y~C@@-|L`)6?DEw_Fx6J0-gc zjAyj!Q8lhsU%X4P;&5k| z(~oK6XWb(cr`Oj6bEbfpq*+i|2ueaS##xl@b`0~h*7dzZ#u2!7!(+YGvsbNp#FcNG zOSlDtFFIE{(AAXa{R=3{TQ`1QjNvY-irf|JO}FQ_zZaz^itGRzdM>%s5vLeEtcGH) z14a&>DT=@KXf`+63gFVC7y-OfBL=smar|r+lbbr`=XVhjGKXO?-!fDeB0!~$-g!~! zis_~N=`0UR`IA^hs8qILI_8fKYvY5L%-&6gm|1}Wrhog*n*tu<>_#fGpjGqVr6vX~Qqh z09|QHj27#`d6)K{?PqqW*dL57$_hg@_0)fz(XiI!+r=*#ROL zhlWvSGgXkb?SO{(C3L%kt}<8-s5&w&U^+DFsq_QYnOk=U;2Ik+J&7BGts&rCWLkf% zOuss2w38ZD!o>@-_Or*kqHh$9pxWopF_L%O&Bs;3dM};!dLJ)iluJISn~or0a3yP zMy2&v{D`Fi4-YTOKb2l`TSsdM0<|~-xxyYXi+NWz94&tDE^cZeA+t|~BIOAQ67Y_I z@U_u(mC*^-hwjMiCB@x21Lkuh53Itjm(q&}lyF!!Qbdsld%~2I<+%!qi8*-v0sZaM z!_kk}qupI=$hN|7z?`+K-mW;@t6JrI;EF!wf4195Yr;!{e zV_-*F8PI|jobZU0^>4LWfXEe3Nshb#69z|VS21dvkkDNK&R_iw@P*Fy%JRN&b!R}J z!>8JkSPWH8U4)DEeb=E@GLqukH0{l9rukUfE{vbUP?%8Y{ZVNF$!82BH=8iK-b8|# zw;cry?Vv7CUvrSYl~s;y?*L4lIbm9zsP~osvwXyl>4;0fpm*~XNh)_6Ao1LFP6cst zRV!jfxyRn{&0~hDs!Jpa##g|y8>I)26-v>+ie&+J0P6Hgc|oakW8x8JMMUJtTt>*S7kG6nEuf~RlHR`--Mpa z!E}OsXc_62wTYnhxo0MDWJ2$UBMA_Xq0sm{{WWEOOKaJ`{|(A10|P^0cMiL-mI4i9 zK*u{k&??qXkm+uT;9XlMWJipYaKc(#doY$#wrJ^y?9D`$%d}LJms+83){z+gr~&*FocZUf8to`Mam5 zOpkF-U^|+@?iL^C6$*Z>u5KmU+1&gj0cWP~)&y5FM2Aefax#pM-OWiQ#3uZ2Bb9dr zlNs87Wqj0EzvS&@BHkcpy4(N$xY-1UuFr;ZB5WAt% z%6K#;y(3SbZL$`)P+nc3$<%3wmG!8Rer!OvCnYf31pP(dX`C~{{mQ%Z#h1m_&aO`+ zM#&7EQb>uuYmZP(45Pbu^07n%qODOk-{GQ=s1wOAJd7JK#$#=J(7WAWR1#uT_op?- zX(X#l62&6bz+-bTDZuzUpsA=>m_V}^awJU+owiWsub|d5G%OTm1zJO^^F}aSIzSo9 zR*Fs(TQ%AboK|x8YwTV{sL~u{(3W)?u)w6|Shol-L;JwmFQkcuh3XRu_HCBTpU?LP zg~neLKo$SKb#xfj;?D5I<14#&B*F zLdiJsj=z${sWSOlS`HwuXJ==Ce#WyW=iAR!LC@SBR=?8cag?KLVqu4AM!sM9BFUYD zRXNhrL1r{@^9k(gG*nSu-Z_%RNs;k8+^55Q2xkcjg@Cvz%Fx{1hyHlW`-=41)igJ!nC!Rhmktmkr|PWuEBQB6WbfE|_VUND(MPsi&-oOudwa3dOm z!k{eaC^jA5{{Y)n0ip zB(?_mXnr~NY8rDP4tw~SwJNjD=Wx}zL9+t#TxYXv;UqGHzeAoe3Gwl}rlvH7M6$e@ zIX~^5g#Y~VpA-eD;|rDoWd6HV0+tHB#4Qk!BRG-&o|CHAKSKj$Ptp7vMZX#2u#>oU zRO0!qNi0d3dZGgnjK4*Uhw+z*sHCO6X@3rdK?gR+7F?f-jjObaCN%1WPe_P18Ac>RACL>uo1wh; zw7$O|^BS1~4toV+=E^RE4;}OA5B-=A4~;&(FnvLVKNb0`GGTB?NaBFHD|P&xnHF`; z9b$@lIBGL_K$klkkGTu~;dmhW?G^~?Fdy9?fsHe?0pUHN zt*%fd^Y-qk8-4phdK*Y(`(W=(Vb@bKRT_uk&#EpP&!{k6)20QpHEbs;1BvB11T{{W1F*>^hr0FNkJ=<@^4 zzyduv^Xr;L9~)h$&~v$V?gAxX1~{{`i?5?FyFJlh18g&Cy8Rv2qBF>W5lt%B9}`N{ zSM3}8Qqwyh^Gp4M4zed}pg(3bJBOP`Ne2K>NkHP~eN8hg5PoVEVCvZ=YxJ6&iFd7T zApL+J_pLtB%*Z}tf?Z7N-*-;Js`ylEWLiW2k(|^X5G)xP8Q>B}5smsDx5zf= zg@=V9tKy!kG0@YCSy+@bs|NzMSQtz}Q^SuRW;bJkAwix<{}#NV+Gp927r~CF15N# z2(<5hRv8>Xws%C93!!=glGKIeEFG(OKV>kNTAk% z@NG{hk}QDiXm{)uFoa$pT>}O3VwdleHERPbEiG?$x&f!Qw|bu@!{86|JZQTa>Ma?u zSa&W|=YY$`@s(YRLi>amZu&V?#l2Uk2Xy9S3y6`X6ckxfM?e;HCyX4yU!3-IAf5zw z(b?Jg^!)9@6NZ_A`O^c2pSeP@ULO@pz+0u@FwPp8wdImi-89pi6*80ILr${%?XwF$@J>WFKNe(Jh$!bv4Kdw&nt;Z9x8A&_0`qcIxEg$fkZ62 zfF*+#ym%b{(d+xkO{<}i0CBZjKyiF{;#W|d!kgSH{kT-hnff|cmPQn?=7z?MvgI_9 zYHlTGeAC6rA10#OSJAehPk@9V!-b-+<-KmSd9r3WID zxZUs5i~q#Z^pWnGEZo6fPfwph^ghs3@N`~x_t1LoCJ_uU0G9Sk4Im4zpp~t*>?bBB zmJkksCP%nbEQIdk2p2k&*S>YgRqzu0KsCSQI2f6?K+_69JiIg-E*|p;o6q(j_K=C| zNGAKzgB)^!&gY&;Rgp!N4xL|5*PqLYTY$KfG+Cg8M0b9|;=%$WJmF|KJL|qHX0&^5 zBc{oLfa%ErDNce)8mKAvN=$O^KZ8r`YFbcwGDkCf=AlQtS)?j#K9p!yxT zfew@Q3qJ-6MI1ZpV8&+KNr&Lp!Qf*y<=TqR0W&-jQtWkKiul|#S-`EhR+-SX-pW^m zRQ(o<-vn#9E^Fb0F=3>m4O{{;PJ?c~)8$E3|4cz>X&NZCskOZxM!njnoOO6~g1&Ub zs0JZ>cX?fVosnwHKaFlbvyD`Io3OYeB?3~Hcj$L|K*soXzp7RWk3Ea<4|HSbcKfrF zl+6!Xt(o)nSk~+L*9>XA;y_t1B4c3jxl;sxj)f&!Mi#h_aBg*%Q2?G-Z#pT0rl zWx1Pw^!w?mF($rI#R0v|An8-)%l0IZiZrV+F;4cAPbC|TlP6{7DYXer<^Rg={Ak_o@&{Es}osw z$H*~M;@n3LS zYAm7kHQBs|<)i+{ao|$B>c@zeBL8;!wMEJ!(}tQ7>dkF^pw|6+@-2nHDXTgscXft| z=?)^Fm*Qe-DiELxlS+7iE6BtP{0KI z!aG1MmR|G;L_?s%Qdd_m!&9P<$<>&+4+S8x(Q>j-dg+0_DYLRkUTG51HkKMDoR)dd zs>yL_;l%Fm$6+q|5uuQ;4-UbSW-I#s?&zGr8?_5-?HkLr#IrQ_CAomnE9PisaNd!WIIe82+CP2+9zEv2zg(h>!Y_o(W#TX?u9u^I;7tc6@2 zrobbyiPC4FyF%!0Ge!71sa&bB7sx|~4@A|FpOl}To|4`$Xnpt^ppvWS!6DaNno1l} z2`fKBJ6Xm$|N861tyoj&)NBVpFmCN-m5JNWjvJ!|Wy25;D zt`L^&Wo2d2YH?fD0q^Q}xCF3YS3EPkG!M|1M(iXKR7Gt$pFOL&Sb~WaRLS7=_mDq9)En!oX#Srd!t>U}zGL z`2k+pb<<(+)~u|x$E-+z!`2V1?>Hbb9@Fv2yW*$m$B=(;B^Lji%~l_^ae7Y6#O<#FHZnt=rNHYlf-FCE#wg2`e~3H}0eKg><_TZS_XE8H*VkD z*}?pMO9UrPa&SNtDtR~Xq$nZmgX+|3qVVI)E(0l1c8)Lvl|U)8OT0tHZS?oxAfGtf ztL7Nq!qWprQz$`YLH}U7xNtMgjL;(NR6nPAW;xn^a z+T~h|Z8z%K@%JrjAt1|&r83W5ShL&tl3Kij^;I---AvUH$A{FmULUt1GVAimF@X?v zRk!P3A(n)?)q2j|0SmHeZ>i9wwf`Vt1B?cRDz$h@kl*TZck+oe6j-pt?%~n8_CF{N z@JJpq%GH0|9S+stiO_yJVMMPUfltj92o&wVq^QM-u_*hih$9EsTYyD_KSMkntFk=@ zGGoG<<)Q*1m@e|u8?l;w`(7_r;r?yjk$$z9SjHC+>mz`e=C$77&$OS?gE#Vk@G^Zb z_a!9zX7e>7AQShNyEkqhe1b(>K9c8ezDa9`3~^(O^c9=sUY@ zz3c&C&yP$CG@aNa403S)_~#PKMm$Yp?0=>G!<#_6_SMoB{_?V0ln^#ly>Of6vpp1a z3OE^3l9HkGvNjkEYKs^>m-61a5^+|b>m8lg(IJYO9+!HVJN~XQh2Yk74D)o}H!R{o z-ERTi%hspAh6CE9CID_^as*0E>g@^l6vpGhHU`R&2X~?kiuMKq>?IWb`wBLS?3@x0 zd2N2WEw%;86b~-(vX(?u_7^=#Ix3`-Eyj2 z;0wV~-4y}SaVafZvh?PR#F|o+^ag=*I{soaToz|PqK+m;EYv(e)!JF?WNzCK3FoAz zf{rM=s_rR!dVgfB+K&55HjJOEA!xl4YPEEYi$8DIV@;d#M1;z9zbL>AtzH4`JzlSb zF(LYGrAwA*V8^XmVfaY(ZfJ}tl&Dm-mC|4P7@N<4{0Th)otU&M%ui{s&0N(3ALqgj zYwHNPITFr-LCgYim0fm9yp$2e8sDRHZiq3H@uX;g_5On4uqahq76ZBRw@$*t}y5qfpj zCrJj>{T!cgiC`d%qkU;dD&U3;^e9O*(tVdy-aY#w>?db8HxCk z<^DAsFcLK!2Fc8yov?OC%_;Cy@Iq$=x4~y$<@2GUA+gbi<>&ku8wYaMq@+t+3QSym z0l}8IdA)LGRxz%|jlrPKtnClZPG)AYaK~0AJ~L$2%RfLsYMe-=D-1pgpnAyMzJNfn zE*a7^L}$LyAE!?iIozwN%_!o3e~EjozAeN|*8}9*q>MR67}U$A_z+grY(9EEvPRSP zNK53$>XEUOr+Iukd(SCVo|jX3BB!MDgQ~J%cO|8-k`qb+`QWWoi^6Z){n(yVdnuLw z(?DUkF0Wwjj4c9gA24b|Ctg99pjgYhb6aCe2_x$Kuw%Yi2wyWaQgA~edaVTbn`FvR;Pb)Jr8 z!Z$B;k1nHX$2kDpA)(H;OUm%5n+-1LF~_p1o;U=Fq2t~T1g)o>rZkaX?p7*Mg{uR&aN&Pp!n+!E%rofsq1Fu@0T|8 zhAGs?P(0%MKJuQVjP+vfUyv(y&I@~WN+1m275T7lwppvHszP!UIJ2~TcGuR}rzJU{ zUC6Y#j%#wu9~O%&ESvKynQ$z4NZu3n*P0D@qR^t3h$%9g^w88mubbQ2Vy)c(@7#>8 zy@52P4abG)=an%JOR`Jl8|@F39g*E&6s|hCq~nH6#(&9XetUcy06eA1Qp`dZou}b* z14vGn2BI8Qq}`C3(#An-waVynzt;+QC6A5vOI8R5q1t{H|pfs0g#Q zQs5jP#@a@=dvXD`;8^(M+lcSXkx*mE20Y)boT}C*N;pn7Ys3_N8qtSCP7!ygx@L~2 z5CxJWR9-93PluVvp`&{fbTVq47AEmjz$q#Ht$)(Ro3@y7g(~^k>c)x zS{}X3SAaE1ubre89v!skk|~}H$fB2*Zm%7t$bj4TWl4*5&cGEt?_)o`HH#9?!P_=+ zu>@dm<%E_@;|^dbXjaVv!atDdl=4St+>pav4CWkdBauy6DDN{pN^8#<`F;uT_MizH zGeK$ClsbH72L}gAlATw5yAVbCZY)ofEb!?ngJmTd;->1(19-F5#NVn$DrL6@K5>>F z_}4SORiFEVK^H?X_SffMSURL3Ov&ig>`U)BJx}fhlC^G|hI7Ao=B&Z66agaiIxStg zIyBlZ2=NAP?|axr)Q0{&!u1bp$zdPyZQI{0q|CSI7SY_%zLky{|a%G6cxQnA~s z1nKDLbT5Xb1J0l7=46UjH=B&v?LKL6Z+9!HME|FaH52qe!jBM_Of9w8J!0k&5Dt#i z7ys)IB7jRvx7o~P?nbi-mdW!k{s9+H@4r@6E}?m*K3`|jodcUKRs3M88KG<(hqQS4 zt8LMF-Mq(G*nue#b4TSND|5C1+v4Ld%dW6VL&dRIQP*dalao{Rz7^=UUrUlDCE8zP zA32@k{`_~1Ah_YrJ$5wStkjcHG(zLRM;AW*ObD2>xVi(Mq7t_5>q!_fw+c@>eLVLzv1VB1kfw%)RIG?uGndvTRsG$!d5p}iBR;ysZ&K9~ ziaL@rlLCK!k@jo7SBi;^bp{$X3xI|NadGiXPAiPC` zCG%Q^X^)SCs7PDd2(Q0xMRalsS>+;0uo{wEx^o+~t1Z1q<{#?Ud>y;D*RuBx%J?s! zuUV{Mb==)@b8z9Ds((;RE?t(2C1larhtuOaoPOmDS;&H0Zsm-QQnd~GB9v92n+do^ zC_odw-midmHtdnX!Ol3|W%}Nf!9h6)-z|{uKC7^VvQX^kwVg!uqTI+l1w=A14De&A z>A~eXh$$aO#fP#7y#AjKN}qYqfe(;hzDaM{aifwA4>3Y7eAEEw3?*F6eETf`syKoNz(j9`7)X*_>cXuiwosxopQi?G2 z&^44a44oo^pmYdIcSuT#APwTV=Q-~>Yn^Y;dOqOP|GxLW_I3SsCup7qzkcljzEaL} zOF%$irdx|)e<$vkF50t$m(!eXXG!&n%3&$t#l05M8TDfz{aT#=`|{=$+!K?$yT4!6 zI34AcpKI~RA<>_ywdAJoCDTHBMA^dc`SksA9h$c|;+w%mH}n}*hc2wroYFitUJPsO z_y5wducgSgst;Y5oS%;Y(-z~WaX`JZ@V3_t!!7-(jSxTwaiOirA!=!z2(`Ypeh6B< z039(-kX*$=-^Wt49rs!AV6!OjWp1Eyymg=NxGL|;bo01i6xlYpVqWhM!48PEqJ~B^ z(osXn1i23zr*V_UoGJos{FMqquMM1)Xod>s!k1)`Q^oILm_|S9!}oN7OoG_8kkd$LM1;!A z=JxV(b`T?zKshY08JK%=$xJdsm)Chre5vtd71mq~&3f+9%Zohu2VGE7#EoG!{`&#s zGM@TPo1g|G5iUMJO5FgFWKr|U+16HZ?d;wPgUH+jmduJI)7e%2^_W=Su1tq1o7LmQQ?{Y4;WmuB= zJX4F>ReZILV(*n?jGrbH7h)+30XH^AK|_N9&dlE6%QmVi6>?2CWL+jfJWYR+H!_uL zpTf#OfVI0LH>u`?bdlb%;=d=CQ^MG!(Pf<3;81N5$die!e5kNeEBH02v~RlAbws9f zmuBGFhwE4qGA=e#+F1^R=U9a)lZpQ~P|EX0Qnlbj+SVFO?4MIW?q1(G4Hgk`9N-AI z5~%nEtfCjwrsN?o0{cPX z7XL5hGK~6Y32%#S)Gx*7e-w-`7AM7J-xmLlmQq_)vLldYi@N>mVwenh$gZ0^_j4a4 zufIX+N9xCnlM{b$vyzVglFO?h(^dI>us?QncoXfSqv+8E6~}(Ak{}_piI)lz7%Hz2 z`U@y8Wy}CW5P{oFwE}2mJXHq;STr&@3>--3iYM$#3_c$jjHdwq(OeH~oI#Vbcu!75 zIL^$(Bm#sSANPKe16De7#;W3C3}E$ZB^js~{R#R|HC^3r8gC+*a*F$fToW3Ptk#jLg z`yU`$13LeFlQOWfN&o>|dQi6)T`ThzfY!nULAQUpTYEZ&y>~HM>#kf}>}!;;5M0n< z#=l_;CkC7oQu~TXW&Ad($@hUMlkT3fg*wj_$Tl8>*@?}+yTAG%oKKXxzIhWTcn93J z%3HQRK8-s=<;w4Yf4g;Hf9L0}hyz8f70C3&G2K?t7%`XEQ?E2W+w9_3IPJ{tzi7W_Uler*##7ojcHi|$-RN;rgh4HQov!zO{$%IU zmi>48f;2HBJ)O;ocnH%Ki1=-Rw2?HVT@KbAQC8gA(sb2phYq~8-z(l{gzC&@E>`k% zz@wmE{Aob{WBe}thrsDuZVbq-GewU1-GQ%a=Z`b;ZjD3a!$H$-4zP4}O^z}3W{1ryFTl6e5y7BCFEp`ZySa`t1 z#1z8kt5fQ>?Kf-5j_DLRE|NFuhjXYoaQx1fDc^>dM&`&z80r3_m`6cl0wU|>1lKk4 zQD-fjSMa$l+aqgJc+8b<2LY44cjr_E5IuL#N}qAJ2o2(m*_6Qe7P@ys4%bo21hM!t zPP>+e!@YL)Q1W^Dk!%t;#_;M=g-XKu$@?Hex+A0ApSSDYwU$H#c!^ zE8qZ%2N<7`Y!R*Mcv9UV=u;o!TWl>~X2zB1c-rElHEKeuU!LMN{8t_6UjJ0VtO!1T zdIp|js?r(25u$)*2rH=rcPGghA&PZ`En;tKV8Em~P+VNRw!_ia{*Hi)w0w5boh<}y zJpLm@xTUeNk>SSO!$XB%uE+O@7cy<9*+*F+kL9460>^vS8kaXlgf=mqr4;#?OdIb4 zRqRl>HZgUX(@IO1a8()=b_THXlj-buYiPtg9zfRAP_A&YPPkZoudvSNdIHEUQ6(j; zOa6-T`^$s5J>K0k1elbUw3LlNIHb9c3enuw4yMMSY| z!vT}aSMrJHHQe&vfoWV)iirMuF(s#GRY#=Iehx&^?tU7lkuoO}E-Pz>sRgmD2`dyz z3a-7j%O8)%VK4+J7yg#W{Q)zV^_mYWWJg*JS*#05A7Y&x@f}zGf#*@iFqoN{S^NYc zQAl6@O%@ZG%G5t#pd7awCvLqP$r1s#-k85kmk{~&>sL3qgZK`w;-o!Ur5=`LDu3G! zvv)|@ej_AprZ}?p59=4bJV}!h^)Y7+FRT9zr2} zSKH#oOuY^(evSt!NQKXxy2k0{oEb=on}a40@gYLh@!c<7f&D)CAx+-80hdX5Wq0C} zSiuG8TJsBo=4Fi6jd%{fZpqimy}Oen1Rb)HhpRuh&og`4?MA-ju)}QtEk$y*yx7RX z*!(=Fll)M0l6e>&KEC(7Vc+AAit3$>gqy$+vt|_uQ`SS<+)XNqg6}AU~DQXUSAG9fzdQ3T!>aC-}IiJj*gD`=M0~{icBMmHI+jBAD~ z0K9>;Gzz9lfe~C|^{}CF|04!UhHK`zQKIw5c+LJC1_i$}{ee8xkTZN&1NW3hKZwTZ%h&R4x zXsBYK8v!w6Gr`HwxZj0W$3e|CstdduTt^n0_S9ju>1oEQ9??_pF2M->2cUJ4uHm43 z{OUb>2L@v8XoMOvX9B*btJ!saDm93GYg`0On5FD5t?B%v7Z) zBHXAWkd{_A&eG2g%f7x29FKYpWVG1Xq()i8u~wWwYn{inPdS~WhCZ-LOFtcH5!CkT za?tB&S1?8lZVC4K(|l%l=AY^>YI0Aq&&_o;HS$h|7WA9(a}ax_z=U41lh!>gw8C>O z!2q`6g@gp6W5i0-2x-N`B&ZkHi6P27Yvze9e!UkY{+IbrES1}0n|lax1k?r@k<6um zGQ4>cb{=)!{9Xw*kZ#uaJ_NK74IHS)!r%f6rg{k)jU zBO%T2UV^0%2IwbU6#V^LTp|i-wA!d92&Jy1c+Hz}z$@o_Tw`8(7QmXwvDd`@hLp@^ zr%hMZC_6^Xw}Z71Huv#GIYMM~aF9goUv@*+X+&rNKh7qnip-5Kouq6QEcHwGc(=CJ zxPdpB>!BjjcgjXDy7)5%@4*U0lr-f`x=yiZ39?Dg*yJr_ zj0Gi5j8||jd_rr|6<3S*5~y?`8&58t7j&w-e#J!~j|!pp6UxiWNjSh%Pxn;<=HW_( z7<;(6Evh$b&^HeD!Y~c1B$yr&rHI#<=J`t>SD-B9S9#B*=QKUG2f-i9rSZk{rN{{A zj$fnOy6De;QJA@B?1*8N651`0om9ac!vc)zQu)+Qy~xo8Y-bahJ>!<>tXC&!gxj0V zYCM<;)#1)-fzMLXkIY8!@<8BAKoJz@DLM?S%`z!=xB(esBb-?Tcc8E-hYJ_y_+2Y1 z2$lZrx*xvnd};2sktk}q*Fmo~%JI3jBzIjB$zhJLVI)`m`Z!x76|y$Oo_|2vr!^~` zz4f%wVW{Any|o>#LN`3n-`H|=Vs;`^pxX|2lJ=)+MPJ{rT6Tz-ad!t@az#qzKXXk( zlq*7>iDedren>-2l$EvELVgKEDjdIk(|cXNW%^1&Y9~lsRj0T4&v<1c?4>jGAzlLb zKO;EyX|_urKYlFAv?4V50342PCv3ZUz4A?&+1AuJT=6CTbfYbKEA?FkS1NcvzupEJ z`|sqadtsA$Je{7447{;<#*PnxXYfh{1O#+f!6w`x+K5MWlJJg14mlas^qQ;@aSj~-i@h;x|HL>vU9pcEnW765^5qJkRg@?s30;BYIz+a4M+=kQ9t?z9 z*JHU)ua6uFc$w4$%Z+nt9xA#!wwB9GXwoJXpY%~L3<1*^mhqZee^qvW^Mm%A66$@N23<)U~U3~n+?liJ?^7G$*>uzfL3G>8)e%6Lv z(Z~&$pMuGc;787k?oBgjudLVy9N-w?E7$}XH+asg%_5@tfy~+ z>w$g${yO0J9C=p*X&4Xmt(_c{>=@l2R$p6CKQhF^i(v=<**ForWqmsd5OfBei{zI6p?JL(NX;Ju1&a0bj{w=Ft0J8YPuh zm23$pH1CRT7Vn>Xpj;g??c#rn&C@v&|~h;LJe^r5G{qzO~hbARM?t);zti^sswKC)7Wg zCF2}a`E{oYVvVg}PEn$N3oZn}xlaCTu>2Oq0^_=(d)?W(BzR$VfQChZOG+P*smJ1xF1hY7NQ zFvUM55#V6qG2?(_k>B#P;gDJYuRrv26|c{utce$fM3WCtw>N;V9fQd6254*#SM=Tm zZoXHu3Lz-wjwQb3o>3!-8Mn2(h==P^%h}@j7|YfxVr#b9<iz2zP2nvz`7$ynd$4xT#rB(yu zEcf|FtOr)F3TshvwV`dw#5Tr9g6LC0o-SDQA(?kVi(lVoA1$I{EY=hh6t=#piJX&A z*}{Srcz}3-741aAfgoY&Hu%+G$vI}08U;Lp>gR8U`|AY7xRx)cPtVnhZ=7P^I#cHr z9KiJY_!=sra|hV{#G^A{daI4R^3GEE_CoT`VYpiZsXhz$hsuU$YR}&`BA({!hKJVF;khXPF z%nvYI`%mitih#^JmM(|Gh4;bh)ZxWV!Y0+Ublo=E;(qUmKel9|9rB`{SevoGC>Cx4 z@K&sYI*j~q&-hHuLlR(sdH~DqOh&n1nL~o(D)S(7fTeptWwi&YaZiS>VKuOEj&J#< z9o2!S+V}vv*am3%C_Ps@0)BU4w|@ZRdo#-pwjP4KYvzIu+&uk9dRvaq!6>AtgRQHi zxsaZouW&-w^Q*0{;1+I|^E!aL$pf%W{wf9{SqT6( zs=0%m-u<5czLU^DCe*jU=0#s%cw8ak?du=$8VH0pA-_O7Fg3j>0QcP86XQ?0DZ-$- zZ((ca@8JXHFjp;#As-k?FC{nKvo5aNLn8uGm;j}y$?vW2Lk<jKAq*AU_;=qVn#W)~9&pJ_);|HK3t z5WJ{GT&MI`BW)w2G%LDUjke-k7}dPdg^j1iyKiWh8epPaANAgif3uFI0z)&d7padj zE5;tZ3=8i-77KA1|00#=wXy7(bt+?j_Uzd!V52?;F6h`zbvL(ta;|$cPRO|j>KY|F zZ_AH|=+LDhxx|iZ`@h{ZBPv_a1b?E*9zlkauu@U!-s)%lDNCPe`l&5^1k+zHk9R~` z**2CA)9Cxs%(RG7o18*=1hn5YQ!!HRo8OR#Qx}>Q)>!i-VYQ0>)P#hpUV7O?Mgex7 z?Rg-$K#w_{BBK@*U$tx(8?l97Ah3cn)IvFrq2jH~WaLSajUjKkgI4l_S9B=yvN{`0 zLCM7`Iz{QPhBx4^a`BK$!P6gvS&EyNiSk4}C%#qkgb>F;Z3aUVl|3p?|NQ>F(|}Ub zR(tFb3>=lL=vRs8{r1`p^;thcVl|eOD6jU|Xd^0(E8199D8pi) zmTPDu^>)sVZ?&IPWS5IPW6Sp-cT%T>P(0B{3P=xZmkXqQ3Wcxi3hLBElDn>r(J#9p zIW`5M{k>u4Qw!KVHKm%@Vwa8M6fc+o1Rj8PiNG2Ad&)?!Yh|T#;13uy1TRpBcYlOh zRM!NGt)$^bMHC@BLQR$H9b)UqC8TUX|*zSd|@FLpieQd zi5Xx`O+u(!4lpHO4-PnLr!JKFWBOA?w>`1f8Z-d&(+G!;a^3o2m7g3gl{F$m37Ueh zd>TlA@FKGY1LQ2kQE?WNt;Hv`>YNbv<19J_0Q3wS;qAo9d{E5yOe7cLvzW&zSkms2 z-ErWS^Iw8>7hBGmR($bcCo|*Zv}oGQTKsr(7wC88z^EVJUcoY&4do>S7&vya@3(*d zdIR{&I&ggU0ikN4&J@tV=}_Qs&^f8Rel3gQn?JA)CIxBTF9nHT5qw#WBGhc$vcItG zV1o{VQ*#k$Iyd7_f!hQKO}!}53*^*Ot?Fo;#)N0TG?@wJ_{XmMFDCcS&QpC})KPl% zl@TfN8&r0X;jyEV_5xZv&7lAQ>ujSuMJ1%t9)Z|QT`vE3YWEU>t4wMoKU@V3+1@VI zmrs>x!MNzJ{P-`UGVLxf(uf4t!!z}tyMR{zUsM8gnby(}D2!@B%zM3;-0Em&CmO_w zx@MnLt}yR3{V0rL=mrL}amzs2u?@j8t!Lk$@Jzn~!pHSKM6ia5Z89QZ^jJQHceXgL zT}!?s&u!nGT*&~Tl9;Rn$Sk_BqKo#d(EAZ(=z}}R|0Oz zi-UDQm*iF^UnrL-9u$b2Nl7g|QPIvMu_fS@=zVuxd*|H7SuT7(5eS~5$jf~@9i8~js6J|mbk3Z<>u6@8 zu3!Gw3<>k3QqPD$8(;rqrnvY=DC$=Ci5Nm9AHj^>Khq3k3vqy>4xg`Wr^u5@#lpo2 zCHAO-cs2?t2gajoX>zDYCsfPK+&uR3@)gQ)Thtp=P-i=WS=!hx8P286Cy;_iE*8X% zicyq*Q(I8DZ=_=qDwFv~kfgsB5DnxC#X9*vefrca>B!nfQdn3hb8d8^s~UOwMx7Q# zSOZKRf9n_6FP>ieD8xNHak16LF#C9VF}6;JZr=~wtq%NKGX{9gBKIE4jAqdM0WbV@ z7ope^TB#wYbRG(WT2=-D_#v8`i=(L2RPUuIfygK>J=cp$Us`^1jI3lw<4`Hlp>-&6 zkiP$p^(9tABD|tds0(%%J~7H|`Fj>jldnZ^BNUk?9yV`*MsomVB_3-8fcvT0+58h{ z^$P3O=S=Tjt>Z#-u7NHT`}zvtQ(nG7d-msHKO8xVEolyr9P)36$s1G+ZHsCJ=bz5T zs?u7|eW1|lCdP+oXW}SMhba5`y(fv;HD90wQ0y^K7%e-2a#w8E$(j~5L$`g^>bcy; zM4!1JoexI4H7lu5KDxcqyP%Jm-hh6Oi-)6}K8)_!c%S3zB+~_B6-xd`vwSgB979mM zyKn)%H2)_Xc_8;wTwrZ@MkA`US`5|V z=xgk?m(*{-9$Z5E@eE~wn#!OfQ?KnfH<$i|s!Tf>v&! zoxsRp8zhpLJ2`RzX}bGat|ncDq~jy-d#IylSKA_t=q6)g=zqad;K|6c9=@y_=U>|)#98`??TnNz*ykk(CdC}tW;2Fkbo{- z@zE7Hh)Ah9vRc4<*IO2Pw=fpea%_ys$blb-I2a_fU(ADZ-cZdi5h)7ZtuT|?Rum3D zwkenIxwUO?iqC{pNKmvKKv@ACz(|?s*a35LO3Fk>9q4{QDY5+hYye1rY)+6Nl20$) z#%vO_D&$zpT=?L}sZZuZpPLoV`4dTAt)>+!<+E+gO#Iag>D>I=^^EEm$v*Fq{KXeVmg~IX}~`M=%7le$orux?tdKJ9b%x7 zA+J$jU|?8>Ue%0U{_41}x?_9Dp+mDM|FYpD5w59AO;erU2paB%@0TMgd(xt(;ln-u zx?fHmYXtURj$i%bX`?BpU0Ff$clI2=-pf+cL53;+&Hdl!5e}m(<+p3c#IbMVuo!ey z_xy9eIw4MuKuKImY6HZKsJ3SS2ieYoJoc20#nV-1ifYf1-5?y3h%9@kd=EI1)s%a^ z!@q&5Kq>kWDfhakoU)1vu7SA`;`L^-T3fu;dkH@K>nVQ|J7cr!?#ZH`KbsBK zY1lBybK1y14+?JMnw*Zmk0%@Eu*)+itw_(SY#g%odc+L1oUC~7Je0zwc)9cS4XpOa zpQkYO_tYl3w_5InO?7QnN z;8(l*HQ?Y{ z-WXe#)nP;!_90nsz#mWobyMqcc`vPwI*!2y;|XeHZacrQ*7yHD4c`m~^8Nb*0}C+N5F`f(B=62-%b zodu@;ZS3sm*)SKf!3vQ(Py~>fKzs=q04~<_IvkUp%uHQ?$u<(IKWt>XXqKp&E)rY> z*$)zSN?hCt*x`6}-_!T7?i<$A@X@Wn-zCPULP_ zZBHAC)>M-9;EO40kn}3-L%|J&HT^4UeZ?z)h#kk!fxkYwTIy^73tY@o|hD>&a~dGlj){ zW~7LY>sMRU1}2v9O1gOD($y=+I7gZ9E!8X zM#13Q;{h4tV8E9{;8Gf1y^Ne#-660JQo}Fj3?YT_p#&&t&?iqov@X9(6NhO_MrkYq^L@v&rMVX8$adL1W z%qDcW!yG6&MAeL1s$b#W#X?=1DCjqS)+M2eFjJH#nP6bCnYsEp_E~#XLt`V^E}nyr zx*`sZ>-_wgvHAM|LVF0v>_fQT6uS>FO(}j~bK)N<|JMgX;sS8e6eCl3MWbtj#}++? zQ6Yc`y3B=V@VxK58rW!N+K+q>~?Qw`gMMLSFx@R_LlaVmyom}f-r#9HUtz8LR3k3)Ni z7RNP|A7QJCr%8VU{6hLBCet!+HIBPcF#%uy)4R&tL5{JB z{w*HBlmKILkRW|xxcTk+ise(^KXRek&AV-SvaGB&`i>$2|13k!rh6U^KL;$I=m;{l zn^+zvUoE3;QT@DISw~?$eBsina&OSs#rsBSh*t&hXD8N%FW>$bqE5mjPoTGlht1p{ zbj9y=qPitr+d{LCz)a0=3@HdBXq+)GC?t5kxyN~bxnu8too`z)tH}8Ds6-C|mLHaC zRMoRSjdrZ~d*^7idFk?QGBzH$)9{fWW*>dnP^jGUaf>S`W`h-0*9f1Smgn z0RaB~lFVZGb-sdHU8Ns1oa6NHF{vWUQJ}0gpthDE$IkMVQ`aIbd_d6KReY)}PDf?1 zIXT!_6<@WF?a|MAF~!YN`ER0+oJjM5e0P`6C>)7maBn@BA}xEu#Ek<5_EN)yWS#D`QUl zDKgm97DGzt!Sn4RKWi`euXs~15~|!7%T3C|O}R*P=PkfC=v=u3F?JWD0(X@-7?RjX z5nW}%@z>AIm3oHy$*yV*eUb(3i&5>JVFd1((XZ9djGdj9kTgq_!xdOhXHhz+E|<2t zK$b^Ia<}V24KK;2Q`E>q-C%|sV}W*!~_z`oc!7b_67g{(vrMMGA3`ck`>^y}>qEVE?DW{bN-1XYRw-yGRm!}%yComNyy^b>HBOJV_(?WC>zgRe zc7eGpo9@g~y<8G)x;-Hvy{di(%j>|hGyNrEFg+{+hb)S51hfYJH8GK(b9ZW~16x7G z<_}-WcnsWIE_Ht$=fy$kAbqeOKi=VJr<5wBe;ncW2$K_)-0oF#xFkT;)G<-$ zf-@O{$Zi~2caE2+EakCl>+a)dQQ1(A# z6O*nvTjEsGqMb(+mHxI|^dzFLB`fJPkI2I;k7KydQhZhb8K^+}4wyc8PI`R7;0ReUM{T{T>qAD|`~3OX3E$c5ZHQz!TGuKjBsjekEWI zq_V2y0FRI!`s~1em5JHD8zihPr;q1cdI3PlS?yT*{wE&=?R+5!RDX`bS&qA$7S=zT zgc$fW0)Q@968ISP;v|pxV~&M9|B;D|cSorJ@y#o7&LL7mPftx-TRR_McX|2~852?9 z?bAu25p|>0iG(i+U=YXPntg$D$Ja8b7&=!woT0fx^QQ#Z_}XP;I5==XZ?Qc7Wh$ko zW*^?t?Bs_FsYG>2jB2BBX)EZYetBcKpIQf!zz+T(uWVCUO>HApPnLAM4ybq(X2-rS zbiYI4U96iNe^t2SIOWUgS~BoTUS6M(L{Rtl^k4v@zp{b?y3=Sj+XCAVNyhb0z!<*% z30BIeY~BLNJVa z(#M#0H%D?yK}Q{6$qyN>BrsJIuYia_2yrG>rCrR24`Pq2O_>O6b-Mmr<71p7)T4Z5VA?WUY~V=vbIdz9n=luO z{%wv|i)3-MVjmTM0WbMZ{P_>Ga;U(41?MNk0g=Oc(FA3R)rl+Ny)_Qfm4h|XxLdgKJc7iw>dLw{Nq;<8(GrTKb+f2SrB!G_ox^Ak*d&dYkYVRWG9<**lR) z^;cP^P9U#W54JBXZf$Mh5E0Gv;LyD2Z!{!(xwxbw#H1GQh7@k!S+Qbf+Y)dZ0?Sau zyWli}!@(7SKSR05Ho~7?!5^XD z3}!RMG3ooo86F)g?A^fphwX`VMfsBPBe@K+)vu7CArXT+3PWrP`g zBI8juid##VXT#sYo;qZdJz}kpN2S`(aup3Oe|6dP;GB9lmS0IF&%+$YFe90 zDCj}Z>GzucwTD}8T=XokBRa8rchm$7im9|XAT<|+^^y&5ZBJDz()6Ee({PxZYU4f$ z;s$YmM>Rv%WZH9=>Ep-~7NaNT*NS|ZZfqHVH}?aW?;nK4fbV5z0HtqugFE5kMyTp> z4VhCTMLzKDvzfmMd_#mX0y7(?+KEn&bO!#;Lbgp$^&Lvx9`om?n#Zci`IN zM8H7S;=t52mV9;Jea|O!@9CHH#e&ht0!+>aDAG>Q`2lHDMu$O#aa$mFB#l7jghTd7 zFVy5wtq`;e_K1{2CN@6#P!`f@`wev)0ISK+OH{FLlT1N7u9)NuV2NwY^UtR!Yn>~!; zfV3*S5(j=_uP}_Den1Hiry)hKYGDY9p^?|2kUk**ouH(1>;kO3JXPwNO-SbXW6v5=iW&4?=Sgz#|TzECADoQ(|Q}b&afeH zk0j;i^AEp|x|i;m@7+&hClh$;;=c09Y(&2E@A=~2JAxQ))W(Cv{r!EQT)&An(|>Ps z0-E4x+LwEaPn5)dg60W*bh_S!gDOYx$Uq-qv-*=mj{UZbAdNx)p?;8%4QI$l#}V@E zh67%wB%F66bQfMlD!R4YXmDAHdw>;n6#+KHzUJ0O@+Ma{ z(Ue)IX>#D7Vw@&3>QZTFVHInsCXC~Lvro1MC-rw+k^OogvZO$j@6 zZGw0AK!eEPzWR7CSQXIU{A^NL7X<^GKO+19$qzn>*`e$JJf@(7d~xq00R@Kx6vj9}YX{QxJ4T!R{)(5h;Ml6zfGVw)UB$lItcp8O>R8=)}qJRTjl)ung`R=@VF zUkco>X$9177>x%Qnxj_W+Op~%O7FD>>ijkRzd}&YV#8Fi zDHf1<7l(&k)i+uJ@(pIHIJdYM$C?j@5wD%?IPVbJebe|RB7*%YCib+7=>c|&lfA%& z^-6O7kp;vAEyJ0pgDVcofSis@`MlHV4`xqx7B32Kj0ItA#PX55nPDAvex{U>)SnCI z83e9vgOLx;x!TFlnm+ul>w3zqjatITq^{3RFzW8wUrO3xa@JXpW8H@P>(ETGMgp5i z{nuD|7?%-}(dtmO7B>Kq^vKB6G;nUT2PAkxNu4Sk)-{ibo+vg#t)E^v>qpEPg_L1zJny~hTeriWEX ziZ<23PhauAh1?&6ZShT^PdiS*E=M*#5$LT(a1?pBr`ps_ScT0lz(nBU)jJ4wg<=qL zy@}~dLw659g3h>ct*Su~+DrMFQ*BMSk90hPB|oqVeD6C-0s-LqjtVC5qicxM(whw? zv$>At`c>D~`~CY7tW}Ha3}sAdmrFwhC`sR_PILb~`}*SQ!?Q7~G|cOoawZ(HOT@di zs&6C5R(56C6TR3>rae=9m0U;AUbxIydL_j%s8Y*I`9-JkY37<;Y!3P z%hL-b~=Vr;qwO*CUUh4dyuegAttKBcxJ zngWH-y7ze_^}cVj>rwmR+OrjYrE<2-^G-#A7sM?w)GsJqVD5&Bmb zz?-%D7jdnRfzjTXB-sB}6U!{Z*kkwNK4Cot2d~$)wW+tUb+Lynj*=hm7l=RHXE>oXD{wc0g3gCe?f3fR3fV5jzJz8 z{H2D;68KO~(UyBsqIKf7W!T?0q>_FpyBraaajDopUzaM0RfZ?Bxr^lh4)UP!^|TCoQ|$JsX{T7x&wuRh@F z=MaBAzu#Oz@f=U!@WkuHIY4Fp4C^E0fr}ev^}(48kE))&b{!wrzbQK$ldNFydqII7 zfuSu>5z|RgG3=F|2!+ZmYTSoEW89#oA4pT04z_gSl6#VQA=6V|pMy@d51bFxsZgQF zm=M1w?FESe)SZ>b@zlgy{xnb1ruC;Y6}LIw=R>#A1LTvtM6M7n09eXZ8$ZP?;Woq5 z5uXUPi6xT1PkEC5?)f=EXng6e?roOjhN5)66gQPK2a!4|$%%-vDf;!coH)$rtmi_M z-~it>lPUc#s7Lxy;o|dja3v3FjMDz2m-5G%oLNc!GL;|%40BM63a~Ul8Eo%B(3mJS ztg};?ATj=O0 zy?<}{U~+;nO?T!=!1>Ul@lCLZgZ30by;0O*g!^xXK;Pq|7Sf+mw@lHYK+MNv1t&ed z0P>UM>Bf!jUwduxwx6uT$ol$vhMV1N?R&ylWMF&NsmANfH!-odTCMa0h%AzW*!RN* ziUJ0XUT@v|Wq<`rh%9UfaII#3p6i1}bQOsB5@HfEASR8Z{=A!6esw z{K$ycPofn97T7387n`rm%Iz(a9;cvJGsrUIRY30iea5$w>E)4D!_~i?b?OC*u4e z({_0*{+)}Uke&@WyaWWNECt>TidQGu|4IYrc^7_Cn2zyB zsYm-R7(DRR-}7|TDKyW=?Ze;uJOZC`xEyRoCCmGt;{d0~D&i zxF+nFe|bs|^o5}x(~WRhaiy1pT(6s{*t*)d4PSNE?OudT9P~6yplK^eL%7_{w1&G zodO6HaDh~IJ>Ws8L`+Sd-WKCZP)aIMha;0pdC+p5!Ed6AnvW(dQ=O{j0#Mw5k6M@xa$!Gfd;X5+EL5X&s-MudTics?RR-H zZR+ALmvv(VlZ=jPh5CL4AOQ5Qz^I%j>t2Jb?w~vx@PU~MKSB3X38l&C6bjAH&lecg z)zl=bNyr`}41E4Pv%X(|1?JoXZD_%lWT6*LiW2PU)HeL3JSqUCRPAvl3XKTP)K$W@^whjI>Gn zj6YH;C-`NOkVfP#I(bXW1a$(jp-hRYF90;L8#|UuCmXc966fH@8gaHiyB`z{r!jau z3&Sy~RUbS~5dKc%!p}}imx5(aXK0YpN!$hg0KKE5BQrFLp!Fv(k<83I_O|r*h9(A4 zIE8K=?NVv42ZPd-;l|Jzo{P}<~Zb5wmgRY1uSn& zN>4AX`d~|4^Nc^~dMnkq(5ZA}^0SCapDcvn_l$+t8aN{Q7v8(|jjRIDF3SWpU}W`^ zW{gCqq-PMQnF%e};L@&AH%Z@6FlpWKDjQh=p}Yq!KtWH(z`&<%Ee9$F;9F^}h=`~Z zq%Onuh+p3RYp6){JuDDbmzUVVzB=8aVph;+H7Z0ydISRaS*tra7Uj7rDvu8eG z*jc)eV-aIFz7`=~|C^V*bZFl#wzZ9SHVA@?mLTyaNiD<2$q5i4X>(sd*4(3o)h5$4 z>K@*t*pFX{M8vzYLygQp@B{2supJInCo{i4_`i1diukl&mjJkYd=$Q`G0r4E9YdB* ztNFw8G5MRaZ@o4r(BuW5xq;ph%v3^J(P*Tm9cZ6Sn_ZGy4gP)pcO&P%+-8E(0T;&S ziE>;yW8{B1Tm3z;$FPLuNEWV_&^49T*X#G<0;6jImjurYVQq?yP3@fj)rVKYW&1%K zBRD7o0V^wObkN31(f~!w0>NbXy$brDp(%z8yd*z{WgnDv!)(M3cGBS1CJ{GpX99tA zLBrVv)6|(}i!i>cq0*zk!!pjD>VgYz4cHXAE9DIny|%UFs?8D@{!a5OiA&pIT0&l{ z236&~1+?SjG$poGf?}^+H#YReZaMUAxb@U44imvvj;g|HZeYAekQRXztOI|2yu24z zR^GjNpsj~@PVY5v>?gT)6bZEg84Lrr!?>rV4;(6WA9-b>+J-b6#d|}5$RCF)o6>^w z0lv>p?qXQzS~yteapWVWvFYm9xDK~_hlf#$>Fv$MRoEF&e&9rVj*1bY)~!Rr(-1}m z2IC!5Q&T(O0mvGgSOLCq?S?~ADCxE~BL9KU8gC1?U}=j%|7oG9dL^@lw)Vks-vtU5 z2KJSpc7JyyBtivTip*G;*b^4LwecdJMtUpoJ(Pvy0CKle3FiNAnCUx!9D{-bSB@MU zPuVX@X~!K*aMm$KzH@NDUGQlO(MDyg;0y({$6_n5lyK(24!j6}^OBa4Y0m`4^pm3q z8dAX*FV@(r$QEl0x2KusX|*EgupS$Zg!p9$hmRm+H%(4J86LO)3v64A3b{FtiBWZ( z%o6o@NX2gjb^{1TD(f(e>Bkarw1wf19Ldg1(J=PPLY!#0wZ(n_MBFs)%^T1&S$1Ic zxahduq3eHe{%FrbS3Sxv6XaeXWJm=2K|qHV%XWm;|0y~;TKt*yryAZ1B_S52mX+>L?62W55h^YhPreS1OGlfYf~iOlEYw{3nJ zqk^ioO%BB|JnjSvQ3Xh3>pJ%PWA5d0F%xuuPcU_wB;LNzNr8r><<-|^kl}3JZA;`x zK)ztnwsC0>x+hCnk2bM6ADI5Ry>TXpJOA|8&hn6KaT;#7VtQW>b67UQLg)Y9k>n6< z68s*Q4eQ1_mV1x!B*5OGOIVhTyi(~1<*w!%Gp;oJ5XN3Kst= z)Y&3P3z_LNh93)8RV)e#3a$WNX`N<&MoY*uLyu5PID=GUP*UrlzBl96RlIz(%?T?oK7J2n}?V z0`~m`V4tmo02b;ZYVh^<2NAaZ#K<=qC5af-JgxVJrk*!9pw<@nrwwR?X`DZ%($+Q+ zD2#h;y+}~3XRLy)qJnjm$%>i%GaebCNF??dXDWTJTVtNUxCC8xo0B0+XbKX5qVqH~ z9K(JBtYAb5>$^3l$jt2)UD$hi49hf`;_^Sc_em(}qTSPp6&=|)q+0M-HokBFvAh4@ z8q>XsauQ0)i28Z~l&u#;+PhD8Cy&A8PaSrMWzG>Y}y{NOyO4cOytQNOvDVx}-t6MY=l$ z5v032MOqpO5fCILq`q~Y_kDkSf1WWM;{ndzXYaM>P6 z+5PqB59cbQ01+FT%dAyYVFN^LxMPeJzV3)+HJeY35;A0Dw$RJN2QjJbch5%;-}WPhSI3F16MYEqM6EUtJEjPN;w3Z* z6r*arTv8e;_)dwOzVybG0isE`Z*4`*g^>TYc_8BdPSulkqJ4)pM!ZnBB0RH=a>L0 zs_#K@G&U(|Tuu%tly*sLI#`fO7xIHK_7qEp*t@^ZXRxuKfxe7@;AtC5siW zDjT56TpV*mJ4CP3&2Bd@FA&s8vRm9zPmr8{IB>SeDG8oq5}@Bv?mY#4l0aZslIEtVkBGMb+B=Ae|6w__{1IVkwqKJn zZ%+BC**2Yj{}V6FBsq&BVV)osruir6wa(3;@ArqV`q6@1GKY8TfYG!Aj@$#_OJnu_ zGoI%LurABZj+xk__d5-foZ-OJ0!=4Kq4^h=Lp}vAlIHP1N;OTO6hY4omH#xZcM~`q z@K=Ya8`@!-vjf0@)*V2@-sg)kyeic05346hWqSOuXE0h+Gmh(?mjoe{V8p1C!5v5r z@uYsk#(jb!GXu{lOM9W zHl*hgInaZi;!xRUTwYPA5nue^0^z0EXxs~E(06? zNqyp<)K8Hq1;CD^FE+iY&KroZ(>5@)SBy_jrXtefJw($_YYG*T4SA}Wzxh`1;qm?k ztv-VK{6G1W&GPEBZp7Ze!!DOZVUhE^JlSb(aI?QU#-q-9~a#Z{+R;&JE+MU z1I!f_W3bDGoL3i4zvZ(=zNs6viAR#Fr-$eFV>}38MvRrI1m)L;o6ZHNg=!AaO~FIW zwQKZgGtCKAN|pa2R#!;mO)W3XORbk*#o>9VQi5Uz0%uYuBci-26^0T_nf1j&nhG8; z#hH$&#QmGF)tVx0$;T^`Y{|pJ!{yRZ(-VS$%Zuqzgmuf?&F#R{LdyAb#7Q7K)@7lGx95!C-q9^&U-B;2z7od|r)PHIUDZWxt8|z(%Ki+z z9fOK~e(h~o{sNZ!ZGG!MC8=3p%Gyss`pqLGe5V7>gE1jQ$SExBkQO9C(4 zwBDQ~5;L1YL!a4ih5I8*Rvx;e4}c3}!dsnVCeibadyv z&yQH3dnF2lurC+NoKL5}Bx1P%lp=c6a-D@WOJ`3Sp)yWk{9#H?4m4y0jKrw^%d^N) z0rB&jAkTMpq7vhXSXD)35|35!-vz^LMn8FGj~h_w`fy#HTB4`URT;^$HV(I#lj}eH zl?$n0SVSVjd=>nN{(bbvVuT5*-in6H5?js0Z+H?G0E{F$G}>(lcHjT2hPh4 z`$Sl$=37>Dq7qxRn=B>A$=E)taVnu|3*f`7nsK)MfP%rI zLSJ=Qpr?`tz*D82^97BM4IJlian5hHq(n6o zvf?HL<;mhXSKK6f&{{{u%Q;zaiWDK?M^o0()4N_a2i5)Kx&`r+J5|6j&+JI4*@7-> z{C0AF7uiw+=E4NIRM=Lqu-kT zHl7=x!+4$K-+MK+(iP(K;i|@Xam@XK<)an5@7XDqdTG!wd1BLAO;^jc=n&Jr{6xK?rY!GQKB8~rYUS<$hzc_! z&ZhxGibi#UxxK+Rb|58(j)&(QUNe`(>^Y@7Un^Y-G!+XS`1*&ZQE|*Lmp`Tr@mjkg zh>8ItyR9&MDuBeOA>-q-scPh%foK?6)v^|wwIfvQoX3R-%9}5k;7brA!N-qiYJ%Dn zz*WXv=q$66%@#FCxgG!L9m=NtgSo`)lfgMqHSofT(S|XJczb7ucW+lC?1kK5YKZD0 zm8Uq+Tzq`*UW!VS%O%Me*gJ-bWpUq#!TB?WbBmvodvzEfwUCEb)x^F|jFl#! z2h+BY+FC9^B@g53eb73tr~-p4QX^Jk-M%Ci4!>tj6Y)EI-a$oUI*mML!S4$ypnGp- zVriwWitI6rqf4Aapf2gip;7kE0u>?~rX(*Pb&$gVyJkrm$u#Rz zvjU#7{{h9QH*Y0D1?Z0&qmvxF`w7nbR;rv{aA`(D0xJQR3*y!mouKe}0$0yjKr%gz zeu#Tjnj>-VowRPC=i6S7pURp_l`LZ#0q6{ApZvhobl5BNWqHhaD%1PX9G<~dpmUbU zFP*0r7q*y+Mxprv+|#n}dFB$>uX%Xr**(3AT3TBE zP^tz82Sam}aAh54Nn&`YziMdNAl(%up+1AUuC%%uy>-*y@y78_*QL6qgF4z>{JQV% zhn+VirKNIYGf=1YPy$FWu#yCOLFQ`HNzu;3%g)&>%lUcP6xfkyzumE94b`-AScCvr zpKE-Jrf77%alA|NijXX3@N5$i zurILIGP1FKUfX(&mt#@3q;}C(vg94-%Y<`(HD9jGY@3B)F3t#J6VjS0kmr17wnY9; zRZn2pqRNUasTn8hF$q+52S(hp5z38F#UIqDKQL(BABJG`d<;GHq&Xj5(rdrs7nKO3X|{7H$`l)*CMpHywf5i8A{M$>t4|FDk~U8+4`rSnS8A4n-2%RDz#RoWLKi z@{*!&-OZw~q`Y=(Y#kW+ zs0s5^Z|@Y=hz!Q@3qLQsbyaG60cPEnrt^YA+zlA^v&*7sRUHo02)2?Ud**E>r^4%| zYtS>aCpb!{voEy1THY-{t;#4S(Zn@bcA5#XtA;nj!pn7>UWw&n@@`k<+n5Qy95wgH zsrBp%mCv+W-kRL6jf(nG%Z1O?<$G?0^U0;^Okjn3rR554%4suZ5U15@N>>FGDdBIv zO{-;f?FaJrBYM9kfQz%tp0rZkBfSJCzBs~LP@lnY_1u=6h0I0F&B!NGe)u_=`CqE> z{g?KA(&MdO^WWcIeBGl|{)>WvL7=6fHsC=Jaw{l8 zkA#3EO2?+?iuw&%AuV3CEs|^7HsUO8d%%qgj=d6J@=;`<41isdi)Elw84|1(hin}f z28K2Ft!yHWvX@Vc?F?#(;X!gV(h;+bYt4JjUNRO-egD1#S|YLDZ`&VkIV75kL3U0Q zI9ucw#`#i@3V5tta{U6-8uUQ95KHr>mv;vsOW% zDsi~Q@{xp6vTas!AEWudi!J;<+Kurnob6DK3E`o!%h}|11j16zAFnjHFyiQs1#nH4j7>nBgT<)Yv4YSHOXx!Myuxb@^9rrR~Aw=mB{S;)MgDvWL2)4&2jKEri< z@tlV`RoLrpicVs~Zs>=SF~mY>HLPfDpQ<#?^G1TR7)PLzo}{D@x%Y(mXXGSJ1*+?m z%%0BQfb=(=-J!Bu{&C$+im?fxL9+Pm=jytn$2C*Y7KmPWsE}(aeacTZGcmQA9=Znu zkV8z<&7wWX060?2tu^NY|MIH!r&_^zOSm^nj{QT+ZsfWMN?0B(7gXgWk|;>{#ZRD7 z8#@X;Ca|+Z)irqZe0&&E%mf6%p%4RZ5@fS4oQm3t5_kyF^ucH&o_2tEz~fhpVw!kz z;`P198)y=tI%*(L^ttH)%a3$cw*%x>)ZkCsE+*JtEx?g~@S2h_dbM}Rm0jzz=#Xt0 zXjSb`Wl1V=udI`BofM(sZNRVcMlGbsBzNOq&XZwbsqa~M#w#Oa;(of(CJ@biT}wC> z<2LF#AsnCbtAxcF?|6r6|I&5r{hbO+Za#`Qa@Q%m{y%rt!bnmWZy8&}8gDpx-j0`W;ObBxz(s z3N#W7FEyYH^LnT(FFG?b6I%|dRDt4>pH?}zB5A9r_=SQtc#t#Q0C794mIQT^ z|dkTJxLz@%}-0fko=EQd}Fg12i zoWRbP<>zHULHjwQ{h|5e|WH zcDm+r^M78Rn+pR7V}$YXaq)suiMJi?HpHg0b4v*aQ5zsnQB8QZB2+}6UYoGUJy&2| zBRp>E@hrxg3t2ntPwFTTd4qb1@c(bCHz>fLeJZNLai*q;%190~@~|sT%iClTSEb_D zh5e~8Y}B;t*7f5WSuIq^W;}`;PT0813NbR4$=DzaJHcLXCbkb zJva_|oo>x;i#L2C{KC>C3GI54{xmKp4P)@)x8)Uc9abU_%}bT?1rFVz zKp<(aJSPcmF^CpqD($W}0#shlF=&ldRkyplD|hu}f3A=ymZzVRFOeHt4 zJc>*MHRYI%q>?Gx(SxnB7?|zz1YxB@;S~DOR$1Csg)AG2dI%oI{T9OFoG`|EiT$+0 zl>C&2C;`vs5BhJcz^E<;bg&u&!IU2=l8+c)Z^nJ%CAeS@!`Y(%mq3B;xYCb+~I9%7T9aE5JzU-iHjk_*sFaMNyNI=7VHy4 z`*I9nYZ1bVStS-jR%?(Nd&^1;Cm`l(T?J!W31jfa=n=@iO>Ew2GD2a(qaVwk$ zmc3*e#`_twH|_*mJ*itYmt>cYmR4FPgFBx3jiZm3l1emgd-{hROZtE;Zc=9v`mE#6 zO(XUN^;#ub*R~c5k%0+UA=9OD%;}-H#A5~;`7?do9rVGYTvpxY5~L71ncF=~++PuL z2Ovt^s1Q--*M%QHPf1CMZ2EW{0UI|^5>=aZ8zD0TXiV0tV2M#wKGAr*j5$h^QIEVj z&X|G@>>5@TUzSPD?6ImnKRyWfq9ilRi5>*KSP{byuP!9%q|@Ij*r z25{hfMLnc3=jU(#x><5yODL?4JBy5PWr1nd4iw%hw3{}K4Jc$S_Eh4d+#Lh7kLLB9 zmxWj&0(U&&R)5+Ij z=o3=QfQ;UI#ARA*cBYI&I4pgAdgI~uClB3hULLCQy}+Pl!VYLL1UIABT{Z2{O-lZm z&1zns!@e3G^;&5S=Q8m=(^u?Tu?aGj>$3Yj%&3z8gZZbUB%V!>2blZ}bO8})!e4FY zg8u=@2x@;>bF=Px9p9A3VI_;Sg?7X8b+#u?;S3G-k!9lZ@kfZV3hNP`exJ({MWBQl za=LOPKwm(B_kOv}y%fw92!28JEpb>)G`}FT~8;L$2pmoKQ@X5;>K~v$v z*7JL5$XUtd=|?^!?52v!R?FvO96#g!AqWV~FzSnP^-zrjdQ#}&AuUXMPb_xD-97yI z6;x&lexFKOB5*Ni-E2nvt*#R{jC3W_USuK z&^*@*k4<^mOH2N=U;X{58YG8xj1yVLV&0)aqZ`9)u&lPeV0dwUr zXwKzpf@iR(i~<_MGQV9IS_p9%l*Kqw=N&)k!iLC3yc` z;AIR2HXW!@tEssenzqsR0_$Z6=yPEJr9X*VF1@KX#LB7;L_;KBOX3WBP8C0)qcG~g z4iYmdU^>Y#qt3#q$WGht`k3O9ki4h&L*L^i;1%MUKddK-n#J2Y$)d@&rt=6jC{JHf z!CE;>Ka}fwK5rq9@Bt&0#8|VL6(RMU_OjfqO#mz-dXckOM)n&3WFEkhy7Td=ew1<$ zFbV&4_cK8ZmEZY-iK(W!IhQRzK;o;ezq{EGHv`xEYzZiLXP|v;rdkX?m!~1PNL^-j zbnlrvb|TzCJ+THGP*ZML8}~Q~UXBs&v#YBi@IzdxZGdtZ18C^)2`P-`oqhp5eD&Y@ zgJ!@iq=6d7124vzcG~DQvvQ9{j5@YwH;Dt=zaQHK-6%i%#$Mgp3{_Iyino z7BO~OtEl}k?*IqDg{ZSxQ>}**nN^1ili>VQd%Dd-N5HhMgJK{C8=5-1R4l7*lj_Sl zw-y?Vq>6>RFj9*kAZd`PU~sMX5FGFemQt>{=Uk{;1{sAR6)YNZ%$2&NKMDs;MAO}?Q$yR04W|J{`W2^(r-C<) z+S33OEe6EVr-2A}ex#oyF~*BKZ;GVCme!*kj?65chPz82CDU_Q%kCA24twYI0hcbJ~?Khi2A**UuT9jz1#_u(-0wP{h^a z{C~U^$VgJp7tQvOz;9~+*$nZ-JOdFsGaRPygm=L~)|=ny|0>AZ#q@S++X&a|2RpG> zzE@-;i+;*EKK&EJYXuHVZNQNl{}T8chrmQPv8jpQB;cgkpv}#)9tGLdu=}5#bVmk9 z{u*hs5G&#P!Kq83cB`X25s zA2-rr#>_oF`Wbi5C-;`gHj@;$Jdj|WZFHqmWx6f;hW*`7D6G-ix-6F_GEPLL6$jOmv7#GD0N#ry zrd>|REG2l^CEqcjR#VgG`*(wzRBpG$P1y(`7dj1p`##8kAQXYXElSu7>~6pb6Uw8k zn$0`h7NjlJ`eAM~48=J1&EkuU53M)p*IA$+G5Jywnp+Lxoe(Mg_HfY21ku-8oG<;& z{7cUAuHW-D54^H|y!+&5p6Ny^Jy3eZmxgzrlkd9e=%V4bEg3c9Kw5ifIpA^1kDr>9 zgw3Zk#%fy<_tp-p?(gfwh}sEr+PJ88(ly5Kw@hH>U}oT_%9^K~F2Kh&i8HES8nwGq zS8NpsCOw7I{kfRwE=wK1s;j;RKV4F#5?_N=j?Yh*SpOLWeFMyq!RDlx)-)TI{Z_Bd zCQ*d9?5_o#V4sQ!ocTvqNPJbVD{S>Uvd0YyO++`uMt(%x*I+o6e}3}?wDh*xYnw*F zIlJwo7m#M%L6j8U^dZK6(~igq(Pd*yTr?gTO8~{qbk>*5114q#qXKV)i)su0Nz>>n zH8%bwSXA*!dv+Rhv9cR47nd)FZxj={U+Y*def3Dg`|=&OQgf?RIzhTP(nnO#Q|)2( zd%gQ4RUb}ty_$|pcx;WL_9ySi-z`3h?i%B^s?49Id>P+4uQq*J^Y0CMoT;;v!IRLz z2N#Bda97#6{kE~K_iwp}F+0-q@gl<8?J>6cch>)Qjqa5TGCXq+|FM>h-b6`wmsD0;aa2Ssu|TXrYWTX>)O2Hy|1JC?_UkN#7R&1{j|6o zs7*GgL%Oda_7rV&+c9^4ScpNFF$zbU@)&ABNtpAY{b89!hxchtk;kGBMmzbVR5&7I zyC4Q}PoMRQYQc#S!Usx!u;TI7-wLAlKY+3;P$FtF&(P~9(8o*K*)gjFz}oK9pOOdW z+uxAOp5p0jWX#1WU%$7NKP4{G94D4=1U4P5p>4MRto;_=&R)UWd@(PzdAT_Te36N9IO6&L&j@h zABtiP`ZiW?IstAyd#FZGm3y%_I2gii$($fGi2QAPVkj05nw9~$UavCDG(|*iKg*2Y z^7Xt*acKV~i*2JYai~u{7$<$QelljH-}EaTnVhrpn0Gf>j%1u0bzk5Pj5Unm3(s|7SB<+{>{zJwnaNJmokt+2OZw;GUf z6BeTS?fnLhC80~tfbYc^oBy1-&RoNQ4FU#bMV<$$|J8xz&L0srKj2aA{AxX&CxQnM zhXTbyQ_j-gaQ(w)xOa>MZ-LyBhausv?+hFra(p#28uzLh@i07$w|W$I`(?}N@B28L zR-YRU6MlQuK-ag!g_k7rgRlGB+qbOlznvEOeeUCWYmmRv^G*!dC&M;6edt6*SDi}p z%1p|9P`X84$`HLT@j2ZbnNM7t$ZASQF>3#sPUhM*OYimfFL9J?gAtZYBr)&MQ1ld6 zdS0H1ErfcapoxU5R8vDjPob>DYpsBE2bEf)htQTOKT-QeRdRD(C`9`?TM{>&Nd4ht zt@T?)3%kw_)>ki@l`+k$&Gxg;I#+kunF0~9ag8da)!p1QnyF~F^OJs1H@RxyUCv$S zykvA1^+B@w4VNtz+O*5(Uv|ku5l^;=gcBr|4G4zW8V1xfxznO2+%#t_wB{gL2W~S(QVd7YXH?Oc zHYFR^~Ji!uK8!W9UWR=`&*AKSc8Tl5mES>(T|6vv$s2MCZ1*F z+WTa`gT~W{aNwGAt4Qm-#sI3t)ec?>J$r!!VK-Rf-e};i7I?QK*238@Rf!YI|CP)< zZeQlTWLTgO)Y~;5FaFX2*barO6LcUnyB=@(DbrZQvK3WC`Ia?M^`Rpz-9vFL6f=DM z$Q5S4S@fuxegf-5U1d}C?Y=-$>$RnrL+M(P<XG%hknjR8{tW0@@?(VPAdX=}=61Z2l9KPKxULLtk9LxINEtzbqwU-GY?}JxW^Cl2 z@4xmPx7#(oWo_WQq2X=O8}^aDMHhcCxqKPx5SM@4{1hwcM8SoK=a+@NrHod)UJ#ns z1s5SCK@wAiU|s$q_!*HO{Az>zlpa(|$j_hD_Tyx>em3*JHRu@S!?mTZNPIb#jK^c@ zF)im+xA4N_CPtHJWK=1W!60@(hZ;gmdnxO_l)9ZLeLFF?RZ(gqMT%*>ZO8Wm6C;o6 zVBwdv6S_kPu{C5^DB->oncV;Z)cb`)9IfkCDHePWCOVlO1JAyrzlaPBzQGr)o9H8g z2{si)RNezz^=9(+8MD23U%mFC2P-^@s%*LS-IR|;s|5(O7MQ(*+rrh3YbaL# zYRB&Ek#G2={nnXU$XJG~Z$@zd{(E)8plmI$g)}NXu}0JyWJErQaOM2`sq~9l(5(H# zgOs8ocS{qwL&opgKq5Z{%=>bx5>IaYl!73jC>{lSA`jrPrgld70cKSLf3+@7luGq; zvBp!%*MP?O3Q1WzZqg;zyf>=I-^jzg4W@TE?w?U6>oFJ+5J>AhmSs8eF8WKI)kbDn2^ z5V(i6XGCM?`{$8V_|@F@!&*IAv&PnHB!js`?G~*hG)`AOfjkzdW643?$X&nyCGrb8 zEnA=hx(?sSmMQ+v{){{Jn*-!RyP0wgVNAT92Glt0(GnS%=>CXUbBwR*F9vo);!hG9 z7E4T$`(<@R^#Y$INcUZbgV+!$IB#3QTFLRLPy-K*OxTtevY!~5{yBR}at~Tg0{z(s zpK&0~h@T4rHcL7NhGAl@2w_51a`MN^;I9`u9YiGsRgJglr0xRsjKes%i%vg(kBPQ@ z@1?+%h~Bw6TKue`%dLkC@$(_ogv$poMgqW#m1}j`c-Tmv80?Y&;w7)>nnh;4ssjiur3#Oz>mg^J{|y8++zS9Oz?gbvHVg zY+VlFJ1V}kNxbb8Tg-{_!sF>}F15ZvVcV44Pw;yBlfn$EGqAg};|BN)9nNnqzCSe4Y1$>iixu(%MN*MeW=^UAz(Hgv|iZ~24?lE?a&64L{PW>UI&lYaoeI@$?D7*ob8f;k~FwLp&7+foQONpz0}Lyw_E z<+<2^Bqyx0h`daV^ba_aL7+U`oGu1{b>XLB1L&BM5D%cGw7S1Ov0JQ4=W)9f@T{aG z*Mk@S-0R*YbbvlY-*K|qHfqUjPYbHAu%TLtG^|?4rj+`pkuRH+GLD z!QSo}kq-@jB}}kvVcefb&ZQY$INCuOO}9VHd#V&6OGv@PBj!xS<4XUW;ePJ>Ly`NS zTolyxAU2-n&Ici@ICS#yP>)gFn{Sl!g8cmW=jREx1~iJR6LJS#PXc@*|88P$ic~!F z5I^GLkmJU8@ln38HH+sA=Aiu&{rh~KgI zMfxK_Bw}Wd9p$y`&mza~X19M@RowPBUt^0q3MY6TypIvSS;5u3GXR`2pvFLGR4t7a zLfDKd=gj0V)+>I*OBcgudT#vv;b!1sZ2I8knRl>{k}plOe(*zw1+u#GGy314E+VAW zYrSP11_l}$Sn+`CD<2_QId==RxhVfFj>>)y^UNfT1B@e*=oE&r*>#$IL#tDxaA z24P^n@UDgPu7yo8vX`BNB~gvoGHm@JR>pZ>*j~%-;K!tHPkuZ8t%{T)S|XMMVq0w4 z&siOGiQ3fhiwr(eF;K_$;7>Quz7?*@%gLn&1k3(7`xS6g?DK?ptU!KbdPx~(QY98M zAy@I+Tz2)~)lAb5S9TH~ajnzbgdz($V>C^cE)~*3_yx~zk4^5cGyGh#=q@nBVt zG{eWEHlmY~^WV3PaZ|HW+ASd&+;k64(vK$xXryuY@8AS6yjznWdfkb$Ep=yr{f!cD7(3*<{QoPx%4Q$wvofY%qo9S~~ zzsvDw8HdLa=-V81kR`l_;ZG)#ic}=CWWt{J@UjCvd4N5_+)#AD6OYJXE`}n$o z<*{$b=KX|HWK{jWHGVuwo^qqhS&P>;!b!QN#XYE!)kca>M806SD2Xw z$m=QBZN-WFjw=@S!pq3sPI}qDHs4tlhH;~mnkaPad{#BF@P2aPlovZUlv0mOoN%H% z8e_qPg@vBH4}F)*U-vVlKt0lYOx%N*&8!`t<5F)ogdlu|O#;|Iny(ynJpP$^Fa=fp zj2U&ly4(Od(vRRzL@>X2GV8<_V8W2%u(nXMV=LP{s~QmqIq(~PwvVUef3d$uIvZSLeLb5y6&*r(b(E zdw+ILMC{s&L8GQ|+ER=2sY)1DPEiqgb?c6WP{C7R+&{Iq2bC=2VgJ+xMYFrE+G^0< zLlL(Q8#xQPt$N|}rv85f za4`T^)YRt4N+^3JX|2JT^R0tqvIiuOyP(i0_vgsH4e|LVC4StWQDi-|^%6q>_sEX@ zMbg+9bJN3jA_JTyN_XM-)zoNOn@EP`KavGZH4`Dm866Iu(mu;sG%v+<$isM;h!$a|97;L0pts{;Qp& z(VE=b$(Rs+kVR_ec8_0;swSmIF5OAxI<)R{svs5AGoqWuR@?KBb+yI$JpgL!ZY8&L ztE}dsMU3Jfnx^0rg)Sp6ZeTN1Sk^EP$wkl#Z4La}NPr(e)Pp$8r2F_-Eb?PGlhB37 zGW#@OQ4OpMxypQY<&d(30~bh9jr2r zyWuTUJZb#FKh9+JXOT1q^~b$2$P>dm2WByyzx5ZK7qoWu5GqN`$<+Ql!oGDh5BWij zCjK0RHmQ&w`_(b?w$rf$^)0aBK>$P%I=-r6xby347*F`Q@V;A6sd3QVfk^Np^0uR0 zpt7c=NOcCpTXoh#k0@Np+glLmvqJ%5g;)F||1W~_T}5xgr>raT>&IF;e-|oO{MJ`H z-{h_~f{WxFUSl{CPy@Cf)7Bj(;Z+b`Cr;uBLazJ3uV0qiXhe|7)#0Z<1^HV4}*LaL6!mL>uathi#d88qgNr!YeThP{8R;> z;H*y;k@aoDQ7}k+HoS;-c6Vnxyd0s9EWp?o`vXyaYo;mc{nSnP_LVREeW88gpGhi( zcaB2drG$j}SELFd14lURX#r;q4f#|Z`_Ac5c~bd^-l z%)n4dl+bSKgh58RTphw3*L=d&WJJV!jg=ZH6Y~iHi6oC<#f4ohiS+)$KE4tLA=A22)C~IuNu%w z_s+10>d6>IDphM!#ooM&)eW8=**-0ht{ChsRT;tRtENhl_{_M(P!L*|QBkT?F`uka z5!&0yrrZa`bm)H8vjm2sO4Ck3sJ1Q-*h-+Kz5@`&A3<;ZcCM;f@4=g6<7*DwmT&UE zyB6&NJ-1qlI+kbO35(`?VT6UTZREu=BaycLi5S6}8k$=%r}jkTEP9AyEJ|kLND(S@;Lf(WLm*?mU{s#BX4K*o3;P1`2T;|r|K%wcsbvD-K7Qo~ za6r%iU0JIdPB+4%zD?8RP6!^axAVX@g(G%a528EL_fn;4BR+_|wgrNvjckB*OAj)| zw{AmJ0|A?povoy&%Uru|A3_J3LFcWlevCS%4iS$XW7;M&vLQwRsjvPYG&{{85el*; zqFRPOCjpX0qe7h`o=gZ6gok=v3$U<^)8BQTkC3T&soGDIF+=ol_I~}Oxs(*Wc2bcU zNx&G}%#ZpZ&W020CP2FH;*mP;r^lT!awV&g={WPW(2tCPcH_7e8GQPaEvPVI@N!e` zD6~)wlPs5<4L?`rb>HT)-q>qpDOoM;p(W?2)$y+yrFvS;T`pCP@hlvR9#eXO2&!GA zm9yAw0W2C3JRQ4ZuI@kFI6rQAp=u@gqabT)HN3r?eVWZ4W2-w`3$LIPkvJ;M@6>~< z{R=NW5PJXpMY8UxsMrA#iT0FlPG{;iVh;mtbEqYi+o2q!{0j|rKJUH+c*{X!L z>zHNaTBq8y>foK!Xx$sb(erGnyLL$_&M?#q?6ksNU#>AZyG@#iUsTevL5wA+4cIm| zG)oiGff^D!-QKvuA;e{JK9b&psWVOA((S$%8P-1%>K0~D1mx;ZC({``{KmKDDvT1n zCoHz_XUx;6BVe+2LEwG!!gxJV%vx?oLxUd^X_Q(_m{dU;l1xMz9`?h{px?4COvVx+ zGRwwor7K$4#3I}zEv=OBhB|XhX3{>wr+$P=e8lGcrNOUGN3>RFo6+KGCmnf0fQ;?x zdMR`_PNoCU6Ul{}=wvE4!=OOGNX@A&6l5IazyfhTToP z3OnmkmEC_sE&A#Ok8p&+Z*B)f!?UAkJosZ7a={^Qsi65DyQSaKp2{unRAs%Q%;Zkg zNn!H%VUXs0tPX3<`;4CHa>%oy%ZlFF74*V>#d3ndoPt?ur^>aLqv2ylH0-Y*!~7tl zZdaW=i6GBOmHt&B^Mlhz)s~-)#!TxrZ)w_(SyIu)cQ4Y1L#Z?67-|wy{WX(EQr<;- z#MejgYtHGrlgma$7J->g^=dL0bgZK@DmjO&a)exY^-ZvVo_HK$Dri9F`gGWKretNs z0P1Va0(8~c8%w6!|LHJGyU`ji1N;uXn)<8>K^yNXL%V5Wg^9D{k8cT)Kj((6aA z|DG1+k##>S;oio~A3}YUmB;00yNKU@l0@oj~L@oH1Zs*dQuAZ7=Tgop6WkMdk zAvCNT<}KeZ-9$}s-!d(cdl44(pw)Zjx6mi7Om*{GvpHitK>CQ9u0bMUNJzmq98=L@ z76Bu-qU61G19MbP^Y4=1ea5is4liG~I2(oMI}%X`Oj^kvn|{bTrl`zs#fx2bT^&WF zkY~qyfe;Wv-chFWxLs52VF;q)Pmz`a1E$>aFcdB`7ivjjE8Pw!cW#TKQ+TqRUd04C zpU5IBV2m@F!A|+38{8J4GwRM-;07+RP8urcd%S&%qZP69YZ9zGTzo{mZ5Q;!wLT-3Dxc|@%i`Kg~{Ahx|O_q4epcs&!H zvT2$--?<2#hn2r6i|h>*_a(lDHQs+AmI3=Wu7^_&hE$bQ(8+Go@cKK!7a_ZuqW_*x z>)W&K+ne6!6T#e-N=-V??!Prhc$qA+2&~7=DMz{bUPHbrFHP=n^E)P9>$_rq;S2ou z-)<^5v6pL}u1Z*vhm4k3+0xM7Fkz!fGUy(K?`W`<^#xU=WchOY<$*{3?z?eW>QVQTSk@g&Y592KP#T%2A|M4i zSo}-`OaRX7jnNon`%afYz1^V2Df`>#?VLO^jjSczFzBGg00!uk4xlD)0_{Q~ zI5gsb>^aYtPQav|EmMMq{q$ErKNhw$vZj5v3Nh+>9a+*$)AC1kEWF6Q7+z``M)JQ7 zvR0%0PN|b+#;Nc(h-&vR%{g%Qb0Ic`FY;@b+Vlyq@ObTJs7u|TZm^H&+;|UP3&hvx z;hMG^9GO3G{miYzNfx^ z^ZkT%SkCg{cQ!!D=v!9D77SKv=G`d;x|jhC6RBm%+pw3+nWcrteNJL}JfB z&=yW`RNDR+i#m#9Q+S&$qIz+G)+OY@7@QAJKE804i3^$?|9v227{=EH@t`^>0fTvA zklEDT0-P}kN&_3E3Rst$wdSw1E$5<8TC)egU3!6zQ|=>BRq#$usWEib1rfU031R0W zHy!v)(I{&V=xbu~tH;QD`XYN=pyugjq0V0EP#23NrNXk`tM(QuA5UpAty3%gN05Bk5`)~eY0i^pxM4+YtWRy5wYRRzhEw&{RpT9%ut#= zMD`9!Mm;Rgv;yxG!8HY&`1{1D-7+)uh={vm%Q;y}#u9WCOiT~|Y|Ojrk?=@%Uw^|LC#cx(tHso-l*m`#on^Lc-8abu$dLCE z-~~D1^!V-^72tW19;q{JxLKe~js0#A%=Ghb05VOLNE+YN6GtE!8!hNR+H3m`YDH(67Y3f6u3PFBwfJx;b;3 zU*&ly^s4xLaXACtXyQ|v_H@hUS@GD?X*|4H|2>(=ng|x-+X9YD7LWh_PCEleRC9JYSR)(F?-?VoLt~^ps(3t$ ztq+A=zobd;8fVWovsJNnv=pxDQD{kXwr@- zG38rNpz_iD1~{j)Wk{lKR!_xm$=#CQa?c97Y9sK5>7Vp+{(B>_2iO1@MJxzJN=mPR zxrs`X-RwX%Xyt;yF_3tQLqXxJ{9?;1<@n&Cwzn2;g*CyZ*D`=ot-M6Qqw) z@QkYL_kcSdu%YlcqCL9p+5-@?K*y5xz_NK(u10+Z4!XV@(~dnrlwh0v%=OUgUJgEh zqM90qC;88L5V14!QH^Y9WP~=!GHwdUq%P6>J(lFgO*TiNBWJxDBZ9dT6t00KcSOVd87JKes+EW8kQyqt5a7eEp zZd>nevg;d0kAb4D2`KIPT^RNTv0gO|3=E(iVuBULW6c~H~BWhLqi5N#;t;<0D9gCmkyMbWE5Fjoj?~MPel3Bw=S16 z5D1bQzb<9ofdon7*2`P)g+K%3(sObgfOy`}w8N99_YyFce>1**FWzW|H~c*)u3~3Vt&hkHRFB3P6;^^z>$%SmpGCHJv>v>lotx+*18~ zj*kq>FdxB6@9xo)91?S|$Xvk0#RUQ%k)LR+ExdlqO0$-_&Kb!C(u57vB2Jxbha;7f zWMY?;VBVT{=rtG%vmd^NEN~5fdJyF~31+v^g{@HA*{zO2^@(4DZ(TL*4G-pm9^q1| z-@$&5PzLdDP6d~mtcSiEFQKF)2HiYejHH4$AI} z21k(AZ6FJUdgm|ljK>&TNcMJs{d?;+{HV?90StgiS1>n1T;dI_>?H2~+Xi`leqL<{ zUQ_ecg+X>(qBG7U!)pZo-d4AfL@16@V9T@wYRy(f^WTUwO`$mxN$aS&JMgf@t!-?W ze{R5r9IvEgXQi;V&yF**^yw` zz?zZhmN4!j>C{3^%kmWbZ!T7E!`f7)qzFGL?!vu_0a7@J!l*0BQzyx#2>>;8bL?b7 z%)%|#Uyh!g8fPJ5Rc2H6m7GVfAZy2MuU=SI$Pdz0luAoB(aWfEk0&0Q6E3`K>UU&#P|J*xUKFL6sHxy;x0-p^=eSXl8)3WH@d z{Ml!#1~-)_ijvPth?^Rhxi30!-Itb<5-utBzpQ6f7jM`ee`SPS9YgZmnLOS@pin?_nC+>P6ei|=Jnmpv53SSkKYuYAB525*u|@7#N%Xb z-dRDAwb4fe?&Vyz;Eq!sknnP?1b+=GW@Jmh^y?60wKfdVdrUoPZn2GsBB_!OY%Ac6 z2MxE-XD7~Nk<)?e7(N(w!kIT=R!Q9H$uYMF+l&M0N9>tnE09}R)2QjLL5-oj zPf0#tN$UjY(q`R}T+}+wC!{O3(Ymw7`uG^UX}+h%2@F2 z?{T$HHz08*Pk(Qx&PFR}5{#Wo%H*N)ja+Ct+IMRRgu-g@d6D!1#LhI`%8k*5 zKxi8#i!<*Q=in5dj;KqZ^^;Y6h~!6GW53;}0wZ!UhkVSYnGmVh5=_QlZ2&JjfL-PE zUasF>GYiLqOR0LK66a;@LtKKljK>0Jmqw~v536!7aeFUawhj0-T2c6=Jr3nhO?Qq+ z>j{Ly);msS)6Nqg>Q@eC!B$GPml{0@C82`=-Bybx{rU%#n5Cs<-78J2)5?(vD9lSp zeuODgfpUK0+o=Ox=i&Z1RDB@eDO9HIcAXc(p*R@!h++^P&Ow0ZNsZJnILm zV1>Q~>nhGLlm5#ojd64z>xiWzvJcs{Wrk9vqgx;cair>nS~UUiW5st4DC@N5x+gGdAD6Rh5?jv-J{B zw{2d+hl1VIkr;YU+N|YlX7s_mJ}Zb-;`itK@{z@2BsmDniOJ|wEHuvxD`#zS$~#{= ze7suwVDVr-_os!pH+9<8BlYKng_{hqGyR1bTj5CQ@Ibv?nE(|p<*TOhQwsr^c*9y} zAeDT=D{X_DP)kh*Xl7zQ2=^z+#*93H-1hR)v)ZH=;unZ(csa);Y+_a04~>^jiG|L> zjnj##b)hexk+j0OEz)wvnwM=tGp0NkW3bHolb|mun>*%T&{L5<<65hvJY*f3vynQ| z=fN)B=B>}eR4*Q9u51=kM&BhO+o5&O$Q{}S14bikt88xxrWh-<> zg_Or_L1=r!^Aw%=!0By%P{&-drfql#Mq)XrogS9S+MIt$dY{Y^9#h-A*zM5}mlb!K z@`Hg5KP{v`;J*H@b@`l5N&+I7Q|wwMxd*YNEu>qQx8~KcAr1_pvy46EW!h1zYPAkU zPYD1Cq0HlbeRt@(oz2q5%NHv|9*1=`)W<*RT~3#>5#dpznw4$e#Nbp*EGSU&R|5qh zagLb31Ck%D2LVeb>v5JDZUq_@2A6-ta~{Yx^^+8^lV>8ES94r+Otni}?2V~VtD(OF zb8YW1saMRLYB~^Me{xnLx@TXN0!3@YiLZefLzM@A8gnLe#D8P>bH@)y|IN&eGY*Qz zC=mgM`e&Bi-hZsOkgw(*SJ{l3p0+bEtXjKhP$ZEXyqD(jb|(YjhfDEbaF zUDx_r)s#4Htt9+}GI2Wp%yUrN4v~>CCM4F^;)YvqZ&-R1WGswn5%jSGu5MQ@xj^DF z0gvvdLK=;yt3ej?Gfc9G@8XX&6Y`0@5U3n=U}GNOm2z!-1_+^5=lbNfK$1=9azYaG z8bo|kAacn~Fd^!ge(o23l>pZ85s16BX2~R7lZ1%gWcz-Z*z7rIl71B0-ZW^!^XHnp zT!iaIf$@YO9aMDrNl#{l=Ab^yN77#wq<5sg)h>NR0FrimWQnNy^-^the^549DnH&?QU2Xh)$Nd&Ji&%&a{L|zMTz< z%Lj6g`Xmf`wt(r}<#bd6`g3W1bI_O{aXo;Yn9vFe`1KNYoFNH)gn_RK6wv$+8K18_ z<2U~@!wF0$Np$qRCo}x^Ai!%R@F4K#%Z|xuTrfoFMDqYXp77$I#Hw)1PVhpNC!~4_MSauv z?OP~EMPCRFoN6(E`b6i*p^q{U4y<-xr7CguV(ASZ>_uLitmP z;DPz(rD?nz%lP8pMD$$tugjbSi=VU)R#v|!$=b(uHqV$>5i#14vs->lf=)IEQ1ePy z%j}K^lDw3Uc zpyPZbJSq7&!~zA@=UOS_4+j01fua;KhtIYvlVywH`?$|&kk!D|LXgZrv2!DwDbSxk22S_6J%(h zF{F^?5hN?wXB|&20*@zlXib=as2K8hL~CPXB`os4j*ByH`*KF@`OBym(Cl5Zu}L4s zc>^pEuYgS_7a=3xmGQ=SS$m`W`t*zpD-a8q7*Gem+5-`J%Qh=5=%U?&J=Q>I`D17M zkcwYzLE0c)yApbk<~{6{EgslAG3qGE1I9ox#@O7I3DI!;x;BFl4Pn)BAjl8s4@+QP zfq;3nTyHqda(E`BSJ^q&kQ;%}l}h))sR5Zg zvZ(qh!Ob<8&jXaGgqNWq#M3DIT{^!Gi=Bf-d(dHtSr4oqX<7kfjR%Ed zo}gP~1*x3-rGDXps@4*xe!PVK{gB_@S{%7ZORSWNj!kAs%MSq&5dX=6r;qIZCVe)AKeJiJJsIoiJ-R zf99Pe=!JYqYPNHLcf)Z%vXQ~0ctO#b22srhzfQg119aS$5 zy%@_qczACm<|m-)bI;*c^5|&bHs*9%9<9}+?zf;FxM}{1dKmIqX<~%pTe(H~Cc)m{ zG6K5*3k!q>Sw63D%C?%%W5tOeMk?v;(aA|ps_o10yVyN%`uvPtQ{7vQdObm09p4yl zmgU&HGv)SdgQ001^!YNb_#4SJf zOV3{hj9id;ev82%AN1{|>Q3XvC4#R((m1tE{H?V1-5{(p74DAaHF^$t20*=}s|w)A zHLryO{|`g``lU+Dc)AXO7kbJ8B}5qov7yyie*h?v!y$s&fYCI9{1IJyOeQJY>%Re^ zqGkM0P3U}(kvMsV1U~dOiBn}@W7OrAdEmwl><4*g$~&<=0px`eM)OI4c%ZH$XILULeWI ztQ9MI`J?IQ&?N1{3Mm%KFikp75mKG;Z}qByocRL4lQBrovMb3rJMuMWkflj*Z<+>b zZ%PB!ORcm;var6gSEYb%LN)CC`}gmmWmRq2dk7HcB&Gl6{z=mB`C`}EJlEm9*Y4(w2i#Kgtf7Wn|3 zz{t=rIwmm@(*r{eM}9uO_}?f{>dONI$81>G&2QKb3J$&t%fye#J%GB+0kYwi69IYt z;Si}bCMs%d0Oh%2U2KKS?Gl};Xx_2GBx&g^EL_R1$im$!4Qn2#^Rb@kdS|l-t%pky zD*!$H>oBj7FIL{3PBVh38P@0D<$^4TGfWlr7uw!^{rYte;Id!VZK3F$B*95KlPw^+ z%t6uoIA<6lkr7}CiE|`5Z;#*i0*5s7EX!{NVqOz@8UTRULkxp+B4mZE#^L*#5QHf+JbKu%KX`A~X=`et-ye zJOq?+4MON{Glqpu$cEJjC#uUb$sW`q9qpeOCb1+?Tu z8J%iK!ElUKBAFfFsR9^t>WxyI{0Jyai^`5~<+9aRSWFvSFeV+8NI{ETIH+Po#SCl9 zRVU;IoC3R72C|IBDZXQ2a*7`(2I}xvFV5o@ei8l0C9}(_&wiZ$q}2Uzfv(KBYcPU& ze)P><`7c^#gRPjXGP?Fk{7uMy9}xM^HuPOFFNZYa|=) z#QIwmo%Ruy3ekb9L5Lk^|JB?u@FZ;a@a=QL51m`hzHfJ4-8-|mYc4@5%HqQ6rr?c; z3yqR3JPj%gxYzD*hWKwWLmaD_rI0WZf6tg8Mx0=JT=3ImpzVZeRIEo03vqBqwOb zsyk-NS;ek>qj^)m%w2jQ*!k7tWb2YwbnPR#R4-s6Y%(ro{+ZSEI?MyKtBW$sR46Ud zt<}%v=3mm(M>YfhHo}=MLwizP2i`E9W9fC>YL!s0iANEeYS!Kc3V(69B)EN;%7!#V?hi3G@^ zrhD(@yYG)4uYMe#mnGN+R>4sXALQp}PmmfVuQNqyE(=VV@&`=4nSv6O>U7c7tDX&L zfg!6@Biz-psv9RBqc^Czud)2Zik3bqFU1zUdQlDv-(fH*R#1POxm#!&@UI7Fh8sF3 z)9|zIRE6}6EIRs2YwX1wO^ciDifUG3bbPe6BO#5Zn6#r&2Hkf?Od6k2pT%u^q{-BK z1kxA^X|WDDR3AE;WO)Jou6if+pFhMmCpYRtstXSgCO%I8{G27k+Q`oEOv#ZM{ipQ9 z1E`p4fs|w`x_f5-lK_@_1&Te9u2k=C9XUKZ@5kA7oo2?NOCBd<`>mD!YL4yv5?M%B zq{Szl*8N%k7|$UZT;8oDWx%!56Aoj;H)nA^qIaDAna;5UP!ODp7>6bcshda@WF9{r z-F*IPxM)!otNF0Wvw)bE%xMEn@W7~6Xl_zEG_;Zc8xz+l@e=nMq1&}DlC-6%#@a=H zro`pZRUdvpTRLCRtgXw?YsQ}=!57SQ*G|cKts+fw6jUZ^ei+}ws99$cx){_QqX9B% zHjG|zraHZ{wQyMHQp*~=LH*OUIn>m%OT>8VwwQ*7YsD|^`2AC^XS39tuFY;S z8j`rjQ(uGCzfE;=1!}_MW!l(vC!~K3eV2GX=!T*tEx*=b>HTipLjOQ)eEf9mQUuv- z?3am6yzJO}zHSXdle}v1jmLVoHYwEVxu@8N8ayb4mKBl6(2C`Dd~*=9&ydpZ_VhoW z%kf{-ybY&!M7TOSiZ*czu7u8Y%}MuE@6T3Wgyu?gOXp^*S}|^$CsGC`QBBS}1KPVy zXU)q!9h$DQeGbtQuuBfy%TK9H7*RwKm(ee-msL@`wW+4r>TjZxX=s0&i9qOJbNIUF zW<{0HXl|e)6@2<$QRv&{r(CqO^_C?k=}wwuh*DabD_1H36`&IcDOY_otcJ)Z+9*kT#HF>|b|Y|P0wr^QNnRIKV5l^Kn)qzrM$eYt@9uk* z?Oc3rQykW-N^+#6Vzo<)e>SZcMfAWx-X#|SDX5%v9}$L+I%doj?61Y3HL+RFsAgz8 z?II6tyw#?lP_|yX@F@hlBfP!}FTzZUTH6gp;+m*Xc2f1&bh>U}Icz$NBJ(tYbA8)+ z4M$~N(O6m9w674(!<@@WjQL$GHH{_$^GyCPX#ZzyyL+g*3FLMUGbS|VdFt|}!#Gi@ zwrPiFH|&4?48jl#^$$uxwRG2ei?}_1$FP5e`oC99pqZq%E@J$jIq=e@|NKbe)c@~~ bN+<`te=vHQ`a4S*ax6m2j?(U{XO!B5&;>JQ=nDZ6Ypbun-_;^J=QY)9>}a&bK6;BxA?wTPRY^O@rg z_Uq&n73CCVM2@+*IG$0Kmp}aOK3}1b*}At#8`h(3B#gWz*1rCm$Hq=xv7hS=-6*YvSDK(MeRvpoHE?lih%LM}R0PK?{77eyqUfrHAL$$XUwYf6 zr@6EuVq*GBJv}`q`?HGJ`1u*!-QAm-o7XgiM@5zQ)Lcn^@F1E+NV&MGD&x&S(iTsS zP4=xZ(vPyUi+k%+Yn+v}w9>?`vT?Ap$3J@MJz-sYV{`VSM`eG0eXoCd`cOgn9yU6k znUPA5$zjpYc@7t%qLxLiP!ne2ktv?}^J{mTy?WxhqqUaB0W{VL=gyrQliaDLWyC?2 zBE{MG(UCnjwtDj%Ja{nV3qKbf4X1?ew)wf)irlTS-baOOCIaz z&!3MqW*Q~5?Ao=fG+JQO@YoN7DE@UzB6;P{UAV9>cKp$!N3n^CvZ`0AY;|;Xg9{2a zt4)N3NhRd^4JwMtgyiSvyR*C%6%*@;jE>$u@cBu+(2k7Y&`=vJ-PKJF!uKCMsA>3^ zw)0}P->jEnEE5aMt1$MJbx%&3;5WIZmaD0$$sEW{)1BpD*Q<~k_%6&@s;{ti?V=d} z`snEBctK`%_Ls8a;)~tf+`8r)jov1zxYyk?k$tK*Qdjg5_;0tdU1zLC?huWirW>mMB2G}ix#_4>xsQh8_UK7QPR<%z8v9~--M z_wL>OwePlyrBvU0e3ReE-FZ8IYmxs7%}|z#&=r34yLay%>#e6n1Xi;|;vh63jL5eg z8))IZzR5w(Mfml|*UB8bn#5n{dXZ$~=Qt`rlC9~&x~@5(Bg({OfP8!+SPGe7f-RoU%l z*m)rpv32V>+n%{q#Nkxcn>XdZzQ2o2 zNC=lNn&D`?XHrT2@$%&*BK{#ttgNh2f}1(yEegq-DzuLrxzn^4&pPtw`%T{GhfkkA zJ@f0G+T_@WeKg(gBwu)ph;2O8wEyhUeb~|i@y|8$Pc%xc5*N1`?`!OB$&;s3-=DtD zf6ixSZhELG&tXMhLq^b#4|h|KzDq(93OIX~Ce!HNx%>BJa{PAeSdwXyWgdH1T}w(% zUY>RH=FQbCn&Lltd$(Z^o2@SCv^+hHQ{N(X!Q`It15<%YR)LN8wFVab@fP$$4w#($ zdLfcm2AdTxb%jmt(9>nqaCg;3jSEMQ9I?jon-(~WV?*evrhKQB_wV1&KKf2LYWW7n z2Z!=@I65l4c=-}*a1M*<^Xu&DiNsR;gjmmeHEqL(j5qC3@;P4o8J22F&7>Yr}T2BeVJ z8|R;^4?QBpxeOLPI4C|Ew<_xWVZz+{vpU8{xLNu|flyo1@j4bD5XWyyWGsyPzL?h#p zB}<%J^bjhdTeg^)+1`1K4M6!iD{b=d(gt0zlwB)VuB1&)PJaFNt?bxl{F@B9_}%pP z5G~=HlGcAld-DBel{q*#ItB)q5g#Ev&vr|Rh)}h)wZ}d^Ow_99U|-Wtj(W1@QYX8H zc~wc2x<;d(b5Ztf&$w+~MX}#>ANnG+eED+I$H&-tWDn9&BtUG}@;`GQI{*0bdY7L~ z?3EW*$p11A`ts$=@bBNqIE=cwy44Ll>={=g1SN!DrdTAHTfFpgeeBRKtgNiev7Hp% zcq2Tf_IW{uefuglJ6yXq|GYUPHI>%i-+yv?+QiaUODnVF<42ykxw)<@$1*Z9CMVkc z>kECoZEbBk>Ql9|^YTJ-a&k&f{u&)6<#OxRtxC$u)wAt4E?x{m{49Ds@Bg`^gl5Bu zh8XYJ7T=d%C>mBUkB8btC>QhIAWD2hhpl7 zhaFvd>u8WSf-YXWlS`xIB+xZK=dtZ9BcyM+3cDpd0 zM7twLND3vV{N~LSclIVmY;yQQQG=}owDR)uBp>Aa&#MY=@d!Xn+o0U)?A%F1HKgm2 zO{ZsOu6T0t6B{RIP*@oK{R5A7Bxj|ittzjm5S5Wxh783n#W~=QN zsoB0}OG``ZKsu)aEd2f~Ml7W3r7n4BRuEV;KPMo2=&2U=aBgnep}>uUlapOo`26(5 zP+3LAVx%M4$MUBKq&D3{l1;DfynC8Kr+`(IUC+oM`f)e*ffu^Y$(GR3>VKXW|ls?#mDcD+b4S zJ+YM1AN~EQr(2#X`Q-OD8qUtnl912OS8`HJ2w~#w>L>|fbd|O?SHh2-Ua!V+xwZR> z96bYrx|!JxGfy|Sr%IV(Qc{ekKR;%_sIJcD__Ha8@j^Tnc`lSe6dWKUU4`7J{rFTf2V#v1z|Xsi&(cngf3k4;*`(;<sKl%DQ&Z`uxRc~f9!tv{!qnq1~=WYX+gcuiou9pB*MC0J#fH!wk$4ghU zgkZU_$!`{5CEk;bLLE<(V zI$CMpkZj^EUW~ndor!u~U0pidS?2Wh6|q!iS=!sn75@1qproQwhHQc?pmFS2dh5yl#(PVVYL+cuPyg}bM<9X{;4{k; zCnA7pZvhgeA9y6evO@KKlmQA%ipDSt7LSH9f8lXf?(nm1+S*IMzq=V45)$I^6IEUt zq5kw#^P)qC4$Ywa_kMY)V&9s77GQ+-^*#w+8PfpZQ|qs--ciu8yoBXygL1t#rAkac&sx*;cP$vMMp;`A}_zM zIhl=p=it4pLXEq76BV4hb-KTOv+jN!O9dc+dw=}s{PNPfuHn*6uZO9rD<@`(7`mpb zL8o*I5E21-d7B7ih>Kgqd6CgfBPlFB@Xhs2tf&KgTfNqgj*cpLjU8L>@I~;zfdlzx zzO$GeJ{&J3W~Ar(-MFnH_;0}fh<6lNE~c+WvX~C=`I%d(sX>64Vt_w3mFKr#5Z*dm z!E0eT{d)kMfZM##Cmh?EvNutgZ>?=uuBHU`P~RG{q{VpT%~cwJGs1oVbqUleoSQo7 zf)e-R#}9=~n=0?#^osx|F>6i+nbPA|z&X#PkN0T0{PN}2xVX4(W1htUYYgsKA_G$t zYVQni-XwM%IFW&tmNvvqSk)(e{~&S;5;4mol+(;Ka)L58@7c5G>a}Y;UT?6G$@jBu zv(ujqowy#RbDYPdQ$9m#gg44?!#`9rCG$eKU&gV*qQ7U8Jwpt*`YK?T@K!I1dgj`H z&Y@`5xN6~e8Oa)XOS9W)@An+>HBvi~z_y%^ueiN^1+Tn0A&&7vEDLXo)i?Ysnz}Y& z+41AYfq%S@zHDu6<;Z(*`}Sg9Uf%V9V2?Z5*|~SJ(bNl zV4C9EDN~FOok})fEmGcRxM=P`g^POgM)zlH0cWDJtJLG#pUsb)x?i);%uckYAAY{^ z&c2)H5mR6BA0W5jpdi|r*;yvv2bV7!Z{D$Q>~i(v_uN;~AF_dxDs0$LQFBF}h5|Ya z!fA<1)t3cZ1SSIP3eLzl9zU%%Tbrno?>!+05=zI!#1!%sDIWQM$zve9$Hxu$`1yCf zm!r&z{DkDqUu?rSvpjm#|eSCe{g@mGkmcG78SVt(4 zhZ!5)n`;}G)Ya9~Es9jvu3gK<%^iY@-t}Rhnyl;dZGLghMgIP+1!tBr3v4V02N`KJ zv9JPx>^YN*tasb+S@5tgNj9JcK9ilH)(IIIYYsj=6<$}jAGG?Z>A={J4@>Lo>%%Tw z2#t(n!a7Fkiv5ck@7uX^P0LQU*y{JdK~J7+IMJ9Hf+G!79OvTVlG&PAGCAonIW?8y zH#-&bC6SYk#deCV$+$sc_^CUw%OWx2N`yFBpc!V^!ZNE>!=JgarP* zH&vrS+EP)O8LL*J4%`Gz=ke(`hoG>4(l7T4{6U1)%;tQ=c8K*){rO{66(=qpbt$YN z0ec<4`(XNv&uEn-6(KyEl93V4zwXHE_-H=GMFeO8-9+gA{_^Re2z^tbugZ~kNzA|) z)SnjFC&xc5K~X2gL(52BR7T`t6<5*~+lPC>iX#qx`WMT-o0jG{w_V&Q;dgDPxssM4 zkEp096#z;S|14T^Uy_KTBD?It$1&0l&AH;GWo3~*LfWs`*fTEd%B$|3Zfa_x_TRYq zYqV##>7heccHi{!@V)s)fI^EePy>A3KPX9AP{-{!yPNIVMiAi8CR96sy|G- zxLbu}P@B$w%Cg}7qYN$K>eZ`ZtbPo;z@}F1roSM#Szq*!GJzwAX(iXbOQt-a6T`#9 zVkYA85y+{??~Xmy@y-LG;Od`H>xj5O(kQ@$w85cg&z@0Sc^W%+?+!{zGLOyrH8P^^ z?3_Cp79A~XAc)BE+ECQAdv+eSGrML$hhnz40+Dh)e%RX2kHT zx!LLVgvZ>W$efQKKjz|ihQtT3!u97_V638p8Y;vFJjJVuicZv)(%6;SgoPuTIsx_N zN0z)TDJjX$&DFp+(gS-~Ca`gtv9Yn~ORp!UM-e8V8n2piY&yHT79q3VP;yFnv*N~3 znF?y2p?TNWuS5#LE_EQ8bD0SEwx9+(;(J)lp9LFT<_C9T0jOr~Sa!cdeE)MqCK9AuJ8Uj)% zJ|#zyxj)}m5PbpxwJmi=^zgU00@#>h@FlFdbJm9S>$x~fjUOCL_8RZ2u;-;dKRq1@ z=Cf2_lYKeru7YJTrF(rN^VF0XV?tQis=f4QoShvfhpos{5N!v{X#~0aE3#Nc|EH`R z+bWJ_D^vyN=ccnRwHfmPWr7c_ggPc6AyLhO5Y7w(-Aq1|XTM!|)7rJAByw8L=jFMF zf0iZe3C!l(%W(wEtj=Y&+N7-lINqAZ#ynfLY;pYYUc8{f1foNZ)7Kq-E5X6>GTezb znm==4@bmM-rd<)J9o=~N@L|Et&RUsr(t==mq$tKp#jY2XIggyB(`Xm+H3r-tFMaVi z@nDdv?ZV(Pn%EqxBS$2R+!sDq%Wwz&rI50V$9E@YW@dsP@z5c7w_)4DN3!d!+4)p) z7K;!8oYwI=cBRMM%w_@{kv3C-TM1Th`u2ujYy0++%1UiKjoG$s)Q!Z%9-bN;AiOd& zS3TF9EMrx(oEU6Fo#Clbo$6iL)Y4K`Rz{oW(7wacQsf+qPy~+HuEx_LT|{NY3y<9< z8Wj-{c>DHkje_`i?v#`iNcjRAwe_nPl>Jh`K{_}H9kB+iJ%vb^{)&EhJDo)l6r6}Y}(~AE2e)Zz(hd#|g7$EjaF36V$7ibC?)cAV77qq6E<@NV zT9wjeT>GoEr#P=_7AysZ6O)$So%wBnh=irzK(;_)>%ytm-=O_>KYDa?MN^^P23@(r zyW@f|Gm=qnUthJ*icR)63=c0LANE)}q*V98Rt6M*L1h;mGo!K7nK5k6Ae#RyoOm!w zr2Yn@<4*tiv$y}K{wbN;-v=vzP6HTdK;f&%EiT@ccKi0uW=Oo`wR2l;@Gux@@8>7d z?>~HSnwfOU*&-*$qBb)eWC;11ykfQR2+*T)e5c)rknqq4OrCz(vP+o)3(p`H7iP;~ z1)z@%MN8Gy)v?u_K6Q$Xmsiqg)88+;ioJ?M0|gFhCl#}gUfwL9g3OTd>~GA7g=1g6 zJUy*OyQ{i>b0#DtC^>deuc8G)kydv#{_9DxJ2)@5v!6aa2T%oGwTzir@mQUR%a8Yq zq2OJ~6u8YuPap8;(Ynu1PTu{w|L?+A>*hxPfP|cFQ^_K8_!$?}#}Hi!O=wzmx72Af zp6yq**M+W$*TVJ(fCUH&3Ej58{P)*aNgUVU)az{OYrJ>+XT(3Bt%FB` zN=4KqWEm!W!;EWxNo0z%*Z~bbHnsrpv1Et#Lj4W@1ZIy;uF;N1xw#$RzDXFJ`MW%Z zwOC*k=*SQzGp29v&W+UFG49&dz}- zu&pCFm^&Md5)zf17GWJKv777=l>m&dF03udKMPBF%P?4 z^w-xP4+O|jKcq50hC&z(&;+6;wR!Er)}}^E1axGj5oebdpke-GOU z?a}BTHGOCp?EueP!n`~fIcDX$bq2|`sGt`rB6)3awn&ZnR+|_Ja@Yx84{cHd1*JaM zu12H9-+OgGRH+e^0vjZo9#`~{$SeMG8iSRoDIW?(U?}Sfa^k1}ggr^(Sg(o`HrTSd z#>NUX02sF>L2?6*vndH&JUli=NB#W#gbBE!smNaqd5Te5T3Yvp(n#Vgsb&7Nx33apwPF;z1}4i|VgKEi={fo`E7z=HfKJI% zL)5n;Z?AQNGgS21;6Ps8czQV&OySHoUHlz(MMcH!AK%s1LWhiKg)D|wdgetLLRBj8 zmvdbEjSEIQ%R*NwDD2O)2Rvh@%dwLvAXLoFyGLzoR{l`+$1YPKs4Gn#-n$nGUT*ya z6`7N$8cn`alarPo?;q&;b?Fk9M99Kg8}{sU3#|hk5_J3Hrs2_9x_IZsyMggqoE#k8 z)sRiag)d%9N)kr9g4B5stXtj_gFWwA7uHU1dmO&m=x8Yv{E7j|wd>Y7K|zTU*u(;% z4atQdNbs#my?ptL)maWA$T2lSsLg4$<=aBC_!BRTlxWh8))^qUFqD>w`#RaFc~`%7Z{ zzt`h`p8R;9z5o89JQn8V>jTiUdGqE?wnMwBppqj+gxx+D#tMS>`q0%yX{Q5}(LlXU zzITra#U6;JY4hfiy1MK-W$5GR0G@mD#5Jd7kB-hZAD=CKA0LqIDzMp?w50?xd3QD1A9dMQ zWgHcIk-m54ZbqZD;I=XniebVFd48Yk;9)s^SX8D|?F&0*r^f3ujid>5WOVhL`XNbB zNn;~7cv1kAatJQtwQj(I!_7x;mb`kk1dB}CDr|gwt4)qVMF8hzLY0R%1DkwE+Z;CIJt51fSg64Ah>oV+M;@S_J@hufI~rAF?IM3 zIp$D}vO!fRl8C5#(|N_(Yl(@>TerR(9lWFA2vIrKi=L6u%RvYYr9Xeb9r%|=(x?4=hsB3X9KwPEL8KRvK% z^3R`_>qKRu0o)c*pd$voBT(c;fi+h644*YC0Ko^bkudrF{ic5xAQd6~ILoBI;OD!R z%d@i^?diEjmi!j*b`!*p1J3~FrrJFZ&gQ~fr!^ogUtHH(+8Z0R1r`F@&0vNw+hWpPiUh!jo@tY9@qz&mFnim z3;e#gk}57M)0{bAV#2F7H@WhueOm zFYi(nmFHp>cOfz!d~!k*-M-h#s;a72H=MjYxkX&OC-F3T{*B^4Qq}?i=cBcYCJFcX z2j(viRzF0wsXlBKS&RmYC0atzUN1h*f(S;M@>v!|uQCkoa-9oAFP7_wt?ezVvU3o) z%9pP22_TJ;4<9(GnE3b*G(^A+mTsFX-GuHgR*1VL?ELv1keR_H4Q*whHAp=Y5k$k} zx-CN|VSvZ##gNx|fJ*c?>_*UJ@CgW%K?L0DHCBu`i5$OHUake`*nv7tjq*NF+^``8 z6anqsnCsUgX=s;pKqDjh7&@1jL@KH`=?GDl;MxCBQyQw>=NB_H?NEetDj?bL#6&2h z>-@~)d-t-CVhL6B*3OF(Vd3E=apJq{@||ovJUw^%9>=yYqDn2Jrzf-_!fg2=ZpQ^Z zJ)p2qHA&U?;Lj;uIkV!F?U59PM8d{vbzR9xOk(eiFvxAIR;?=j{CPRrRJU7CB6BHv z3|mrvsybVKaeI&Vk#>?L(ElV75^)Kb{D*l5p; z*2wQ7U_|F2sw_}kXlUqCd`WsJ{l|_Sd;On`#V8E9CL|YPoH`6M4E10TJNE%4!{eZ^ zZk;BS*yPFtgtwj%Ds*}9JLLK%S0X@&RjF1mUe1y0Q%3}F6EVntW@ITuoyhwa0nzZ- zw{T#&`S?+d$5yq4?r&V6JB<^d>ge?HUtMd*IQ4rVa^vaG#pqxMigchWmG9iccwTrb zBQz1zIcXI$l&7_z&C8gW%5aE>hdVU|0ZS?5_%NWVBKM{}M#V-u!ov(Lh#i8sJ)mPC zla{)-`w}cp1w=t}Y-zHLhod z8zIHpr9s-vGYS@=r*36iF2_%dB%4jHqlgmu4=F*)MAc`~5fa1#-_Z;CP*-P3kh0Xy z++a9!IB?WyMCO?@Vb4)&I7hYuJ`vXcZC1tef557+W{kh^RYX)(&6};Tq45IvyXaY? zFG&lW53|iCx53u%=k7z+XkygW*T)iKn8NsVXowYUrDgnU=@3j^s*mCGa$ePb^$U8a z=g*(l-*jk=qm37IHx3BPoRWJ*6cpHQ`iwH5v8s5YVKp&Cfx(-&d7#4B8Q%$Ztcc*Q zcnDVBn(Jcp&#w|?6-s+5Y9WkLGd{0x|^#Bm?M?5c0q3GdiU$wTTS!>vZ3RcnwnA+7)uBPrv%B8c9C&my{99ktAwT& znx9hJ%*+Hy8EE&LW=3EC)h+cPB0!NwPIGfJl<*Y_P~@HZQHD~$O1ImQ-^qyugkkH2WS|#-JQ|86iV8988ky)IMI7?gEEL2Kb z8blF;aD$VJ|8pGpyn(og5Sjn%Hzyz8WUX!XHUO>~H9kDMvj~2XH0c36Hh+G6oc8p< z%n_W$db9;jeSW+%(|*-2ls7`TU{?Va1VFu=tBK#-bp%CrLBk3H83CVPx@S*Sp#`bS z`;mb*ocvghbnH0vWh-efP{8eGYbK6IL`G`D+(*RIRe&bXhYHI`XVlg`10aOYW^%Z1^~^w z7y5GXyAlT3rlzN9DfIJ1=gckvH*-C21H`a|%_j_&Nfar#b_7C{A!s%|bCuRNFzD>- zV_dOf1u7#gC9LKbg@eKS`FCEs9}yi;XDq?%iEef9@v*Z2PrNFs5Y<=-h=cA;3$Z2V z4Nl$Jvu8UVIsNGg7}b*bxW`mV}ZRQB9(p zq}{nA)zF-6MSG<7MmW-ETkf%;Lrpz@ zv8Q&C-)#9>!njmaz5<0*^nJzSIJ&x4JU;%RqqFlYF_Gb@{ujD#*bcW{;N5*UOTT;( zCK`86jyjUU@XVhxq=Zrd_*Y%1?1s*1SoPaPTY)tMg-ZI;yX%|wnYkJ=F247&xvA-O zd`nYPSml?yP}5O#Ck6UR8EIk<4I)!rdtgKa2YjmM;LmY^?a>eA~EV>vyx6p(EShNC0fW&xH6dM(mxh-h{kP)hDVE*;ia17ECS>vd2f*s#vu-hGAVc_P3k>AH0J6r(y6gK87= z$mGaZn(iS@C70g)Xvmeld9w_4fYepsDDlQ0T-7Zt0@x3@r_P3l?=1KY6I%7e&*pVw zgKYv7$%5kAs0FLG{;kV&OPAU}C?(#x_3PJ@D%Jq>t~EexVFDXZ?O*NhZKQ`Zd;`X4 z2u?bC_H2i<462X8w=;m3UM-Lo;)NEWC=>wt$`GA&J$P$F)}~FHjJj&n3+@zm^sdYJR6KGAD0Sm zij+W=G5_I0pUuP+KtM0v&&W!O-Vp@+)vewey?*};M`tRh6_5^bWnyiM?R+2elf?>q z0!w*tq3`srM%&wEqNz|)df znkF<*u~~(;n06UG26&ZPS#>T724_L2OIHE^;qC2KRid#(+f?5bdu1pJ7YQ-feg!vN zNIBH$M=+U4UN~E$%@*c*h67{6+lDV(cPW)H#eBv2_D7i1sD4G~>HKhRi`~)41@xr^gCe$Ml7VBIH7Lw8D`lZsEN;d-uxawgHdb zKlp@^u$1@j-*^1@5e_CwCIPfu!IOL!*hz}mv6Cll5C%j}MpWE_>%`p$B0M}QWOl3VW^lkI2uG+&moI4 zC1s#73F|VvIlH(3RP}l|czHu{1jK-5(Xn(0`8|u-0xF=Oz%#iLf(Wu4Eh$^hJ@)qY zV8^mpXlGj-JDs>}cGrLRJrq%st2Jm;Us`@IMnVChH)qR74 zNClvyRvrHdFv!Zvs^X!+RrKO)j~h%fYJdEAI6iIn=PSArWk+xN60Aw@o;Xd79d`l0Z*pZ!y?b{lrXmXP$r*R>P1h?bmf)1oP*}&N z7oLw+spGgCEg=g3@1M;lwp>+ z5JHxgBF;I&lB})8;2&k87~Ka^Rf*b4^Lif(Oy3g1(-=8`EOQo;7?G)ueZ0?)!@7or zTh^Y0sYTqNCL%qe-G5#PEby!dJ<9JZEb@^EwARAB@6g?i*$qw3rh0Z3tNq#vk ze_anIv6XM%zO7IR9LlwCQx3^Rv&Lp-a%9Nouu~sNF;X7{OY_=ZcyaYL1cgfkA0v5Oe&=xyy*tVK`(;Z1MeR<+<&vz6hUcgr5JG5}nIKMP~AHSVhjV{j# zOUnRKm`8(y>G=5gbQ+`eofdd^8nh;KqmnVupt}U9={BGXi=Yx)Qc@C9!*)nxz=ddV z+Cd8=Qt1NY#A9o5#G-LCF`*4?OCkg=8%+y~73c|Sf%|nrQ~tNc?>Dwq^}?C`qanQF!2~xc8qw|11%V9KHS2DH(vS|9Jl;jrZH_N=r+#?P_?o_)M~)sMAuA zTddK_hKea;EbxEO-+cZ0buq9u=8Jg1W$#@&3KbJC!zXBt{l7HVHFH}2pgQMZK5H3P z95M=ym|^-aqGsV}6MqooN~h`Hr%CSyZci!ze<2n9ybx7@x@^mmMXMwwiHJOjUvV1g z+CKBU#lfzKe&H``8HL%p(=+iLo(Bm0ZPVn0^#g1PEezv*1~AXA>nyD zlp1mTdjnLuR#YY&4e!#oZwC@xeSCakZrqSjWsK8bh})D*-T$Q{!AZOxhpu205gA^Y zcIR(;Kh^S-Sx!z4Ox(L*47inB*ps9eK5l;=A8f35mJG%>w%YPfH zA&pD&;#P-hbmHUvaJ2K$GAymH*ULP@4WAxb5ww`TDc4@%OGi}EsVNPdT;SH8kMawa zX_&4IH4Ol2@d7>{WMd3O@+e=M_Xxd9bmx+Rji}M@63Ux5TVd?UI?=WNV=~&T+2}&R zHwl0j3M79EPDH!G`NJMWOUBDE9Px;@eXjDrp=w7g;#g_U7LQ<46RzZgb@~D*YVW`b0 z4VTw9=>Hch6g=wNVd%OIus{0y_c@pk_4V~FfnpahDW0qvwvxK`c8i5lhJQ|91c@w4 znPlz%(Mh5byf7I>v`PtyC1^G}SMtc1irAU#Dj@^}ue4owSU7RRKv+wvs~Mq7BD=~G zj)rrSg2j@Gh5Suk8602@wF&E%;@@k)JwtUMEfS#-iXQR!{TJuU@W%&-_%_*_`K4aF z_PVzA9F`hC35C41i==bXlKA_P9HnSHEXYJMva%!Ss8WBfzm^mi--)+*!nY<3d-3BhL*=6||6YIM)=RjDSx++wzY$CuMDnj3}gq2a~@bfiF$aJqNOc88RN& zQRDv2|8p;DZ^GK`GtFpsz$J0Ta1Z*Dcudy)~bYE6<{UVbN&_~ZA>~Lgn_x&T>uYxxS(uvO&%>8YflNg7?46ddf z$BwNA99a2pwUeWi%tNC@Q2`hgNJjKb4&=3Gdr#QIMX)W?eqmL^bi^QuVt53-w#5_~ zyudFlAp)D|=FJBd-jsO*=$t@f6zsr|ki}Sg(@f?0_!~E(HlO)+%k$SaVBtzoCs@2? zO^%`fWoKu{cw@fjKqiJrQl$36M1{1>j8Pq;IbfNTFw?sbu^3v2UvP>UZH9zN^k+ra zK0{=D5lP9rhOTobd+U-t#{0Pa{`Bxd8SlWnZou{H0`~2N%s_3_wu1+klMz~Isw1wS zKgapbaI))hOEyaeg8QKFJW?ZHWC=QXtUhHiWeL~tWZ%84w7wk~z>aM2SAjp+g=(M) z^BVpjz~r+iYL_xLh z+=AfZoq)cim`89+myZI`S``P-=)0yG{x{ZQBnrqC*Wh^wN&{oN@vlO(qyB{NdkCMou4^_6SJV&!Cgl*y%%PHVyizQTm%WZ8UQ0hy|nK z_{o!+hYktA$pJ!JRvyk7dH*`VJ-!~)^GC0hy}Z2YK75eAupidtxK1Gr=rd9T5IcL* zKeQ+k#_oWzV8P(aTIe#fuiQbszR5I+X_*cvN>l)fTa@tD<(Q_oUSP49A3I6~}AMdns= z?hea;cMHxX((6N7Ooif%aY;E$KRM0Kcs3wCi|tLscisF%aP2jGDGbS3LNK93?7xr} zw(t^GVLY1G>Ptm0?X;Zw(0yFFX_JZ1mvp_AH&onN;BmxP54v-wYvRRC-{1VI(?8eQ z+S#dFSQOpAi)fbGA7^{Y@cAjb?!Fff2I-jugdORw;sl>Q)ahYvE=)#tiP8nAMvZp~~xodXS$w0@(_3h-YZKYh^`$G{yU zgd4*B(cI>|(kmDBZ)(MleE|#4lOC7u;!fX=vayunGPYg^8STQ$eW1Y=zDW^f|4nAV zYNSYIRfG5c@9E{_{Sk&e9HswrQT&6wFHtEL z678{IoCg*PO%1(=zDpO3_Y@dM&u3N$Dl!}O-00>XDII8L2MEsy+2tNO49*9=^g(_^ zZ!iOA9q#BL&Aj_W2_Xm*5C9sMX`a0ha78q-WBkceFaBk*PJ0jirY@NlGW@OmbH6iF zV9g=(rql{#}2fp^T_-u!2U74l8Z=H;G(YthKXD>LmqGyj7( z{~orl|9JVsL`dV7(+7iLv8eLezXWjljl@|9d zSzB*8rh`nLBHi?Ud?0|P zTxfTz4rAYG*7>8(*g>&$n!hQwE2GV8++zpVvmSAW$3IwLCv^2%+9Tu+P6K?--8tvXm zEDS~Sb1L8tyNtdUk!($}IEV~zQZc$0ffsq3;V)PCYt8qEF>S6#w8402}{;-CX)4uW(DLjE3UaVX+G zcoZ@v`GMcupQF^aJo`3c4kEr~BK<(*gY&@9b_E<2@G6msXo?~Z7xb~vmKL2wr!w~Q zIz`3UwAvOx3W~y=IMxZ!#$fm$g9oIRL$xHHE#e4P##E#xx@eBr0G~fSSH%0!rZwD$ z{4TKJ#8~ZD;@^U#T}!0G@i-r6zuZrLY2rEd|%rf@;CW#YLy4R`j1K z-dsT~RjJG~Lae5C_4vu#ms3Pn<01>Y{G`Pmha-zm9#ZuNN~= zH>DWc4aC<}PH=ThXRhBh(|XT^p>vwp^QrxCcNUBygd!@xXag+~()qs zy1ivkBe|*ve*TPD;UR9EJCs&aAF+!we3evV^YG`(tmdCaSC%|M&6OQFoR_Huy_aBJ z*x*Q+yqb`pj!!0bI-Fk`3bs6oLI<|s6Q*s$Dj8GzZhDIw-Ja*pXqq?B&v$^GbxnO!4Iyt1}v2tZ9$7vy})2E{Wp`V(%`ug}Noct&=Qh;d+NV?d=ijY&8 znec|=>L>UPd2mfaHH)_0@UzP+%v(m2cYQKqqa!|oR&Ims;H|IFuV;ht2NE?wT@ZjE zAuOhx77swHEchf2?_6u^i`Q;Of6ip38UAn&8Xehcw5M;T@bdVXEL=gc*ufEoH;hhI zj6$Dqp8lqfhJR;EW8Sp!V*Ke76Ez0x*hJQ>(|`8I_h(kSFPTTVW`Yh+8#8~v1D0H$ z`Pm7`Kj#j@iU9J^+g?;Oc`Z9z0ko&!^~T0d@^^dOgXThqGEV4!ns_2}(>vZizJ3B` zcm@irK|`hn0D@dxgi~V|LK=O8Gcz;Y#-jL{Jh6R<_|v^biNr{5C;~Fl6$mj1z~n1# z$DsmX2Bk%*K~q{c{;S*#IuyUw2ngRTeg#nd3N zxbjhiUcggt2{<91$;r(vp0_6s(MaeN@?{x3%uphVL6`SGIJhCFmbfTjBLNmcJC}m{ zu$*KrK-p2%(@5frq}pQYVU`yKM&alGBP|H?Gb4KFl}PL|emeG_A2T3?wt@JQpdxG; z>6W;vsVINLwH|G*~I{Hzt`Eo~j0 zFbz-i4C|k{o*eP?@=``SKLoBrtVGx^$pzFEmhJ)I@UP;NTK%taD6!*YBpx73TvU_> zbIZWI59&6;Uq~!d80^;hD4%fwg9Z3l-w{B|rgcZqMGj zCGrAu31*)k((BUSQ$XDkRP`}UZiU(iCD9=LP?HTRm31N}l7F^6=fx^%;{E}~fk#TN zna{8o)w2EO3=UTy+3D!)D(QNL|wYW6`Qm`Vt0pvO> zz+|H-wacZ5ic(x^f?~#4iSglR4DB6Ewzs-~8WKJZV?;J=&8R}V&0PA5h?fT0I0Y&s zJo^enID+2sW8eO8(i{gHUUSI;?h$B`9;4miW^JVp`;j`j%>|$_!smdw@Wo)&K1b)t z01SG7*^ZqW$M=TyZY5V$fR*V?JvY0t5sfQF>vDRShp~**3*1?Q74GW$vFbs!v+o4P zW)L5@U+quA!zti>*nbPGss}vV@aW-!h$iRb{^eop&WE~;HsGA;NfqKOf;~%L(%!zk z6Lp!<71vSRib;nXM|-9KCj}#gt(D@YrXagD;T$l z3lH0{2x~wT8u%nH{%pN8fO^$s?&7d}=T7y7=go&0762sx&DHKc@c+Xzo*=TQ%AAFG zUP8Cf7naH$LbkLj4Q2p`ym!f;F6KmTc6INHr?x$tlX%t-0m=9=74?t4{S+>!X{3A(@JN<7kHu&#*E=qGoA zpg+QO(;ZWGJUl#PmQrG0l8omYqwSbj`QmvRXbF01Ac_^&HPY(o0H1XB?>G(%0=_r2 zO5>K>8DLHAo`*3%77n8|u1v|RQ@OAhz8Fs>*^V`dMe<1fe|I}@@1ZdDHWwN z-jUZPhL`Ftl6`9F{lFsDrBTasbY zL8QY>qr2sIVH5ajg;g-BA`AsA7!axh*UdegCY6>xu?pt>rL4kqG4tE+!EFevLWA+x zktd5keQIkH0?H}H_(&acywmufl!sYRW*(ZqjKJ1Ko_>j`8{pas*yLc`mY(=>xWIWa zi8<)hR`&KN0Q9|3<1FDCfxJ}Zo5Rq3AyXL?8MGDrt9odWvGsz_+1dFPF0+7-6Nb}W zgS&qL>(1c*9_OlOBJ^-l?7&ly3&NlgSOHs;Ti4**NA;i)5V)?9bsSkxLsOI7GJ{M6 z61KX*6N|6XqO*H9VYsj^g`$5@3WHxIh(F$cbv=$nX{1>599Gjan$Sk^RnH@QHD40pkgL6kwX9I2&C zmxgSlu|!N0ae=5V=mw<1Jj<9fgQoB>=HJMm0TMEC&j2r1z%)yByv(@`4FxEj3ILpd z0?Y|p!-7)nW9Dv!i0CfDe@45;1&-y2y{egfea!_zleC#@y)4ufpfF4b3wADp@>HT z=@A#jEW!0`9HHJUd@F43{}!k4Y7 zXbNi}MMWBI!o^X^ZSZ66fh))BXnRG5fsrrLZ6MfR>5~)nDIwH05V{%fe!uZXlaQyU zab*#?SY#-gG=~C-@PZb4#@^jO(BzY#*hmC9z659sIZL~g=brtkQ};DmK%)X5JUAWe zJ3TeUNQQxM|A;uMIX#k*>;(hE<>=Ox;QEEmgBWi#r9@CU=3ly^i;+=hzjyC>Y8zUX zS4wk0&qPqxnFBl!W>ccgG{h(l`Ij4{$0`|>mV67syN1Sg? zd?gGbN~5z+j}NOTR5jXj;zTC34Re#u$(43%6VTRO13f;>4pGTLh20bn94>m71l^7v z|D%WjB6|o_bT}eK*RMCEMCKC5&^Ce;X>S@0_!R zo|ToCOr_2*h0?wl6N^@;q}GXmxiuAsxJOv5xWE7Sk)a@82SfxEy4tuc(BYU4k+pG+ zOHVcQ=Vh#{7pxl}=%wz+m{!FdW(36$Yca+pSG%gjHv%|wos&kJ_<57-?sa#aacL8L z_ma4sB-Eks&k_sYac(#Q%)8vA9-&7oHKX#vZD2Wip^-+P-oMXn@)Z{sFTqd}9FJ^8 z_2QY!$ePWy-rmhiZsCKKnCQ8F^Rw=l%uDv4pR-OZJ$H$RkX5gV!D!%TS_vB;Xe z@X)*e2)Y8{fF!*Eu;K8ce8KodI#DjD`ldM<_qtw4V(tWB4P!*==nee*`EwZ3sPy9v zM{5N~j>1h!jvZ-pBHPpmes9tIzF55&kx1NQV6fN%%$%M)c@j$gw)=T#^PpX-|KegZ z+5|+gLt&9Sv&Co+nuWOYBmj**(olgKcl*Rqf(9DiSg=0A_#R>3s5->B2`^|F0(5YQ z+#i5@hbCD` zrGg!CkI_Vn#(@fHKZ;^Jvik$-u}1r+%<~MQdg4wn%o8UCy66=sTk%5YtEDC_{XbPF zjM?M9JtNcdqi96{ah1Qny?gVgt5V{az~vaYa0K`5;7+cB+Yi{4fI@lTc_CffL7+-yj&ZYR{gZ|3$K%ATWX`B$l!dC^BmLr@?x-Uc%F z5W$aenhz)u++GlT!&&+@yAiqBt`w?G_l~;mo*q#}#hkh+G%8C0=0OleFVDI^zlJIG z4s?*hA|m3X{YSbMqe?~y9V!vq*ymO`j3q$2?d^Z+Iv@xIS26iu(3c!%)QHc7 z+##En|7C^$jHpQ^nH`wBtg|@cm+B0t)Jsy@ptn`U^FG~rNDo$=AV9&Y0rzFyS!M^b zlYK$>h&{ca-P5S)RfIcz<7@0`4pj1jTmYL+G&W()w;D&vB%KOGjFV0?E^95{%vF(* zY7YmaY47lJ1PZb50RU7Y_0x3AXZ;)+x&Zn~28z)Rr2>#Z$u*5Y^p_7k7#Wz*7J7SQ zGbe_8E=!YHL;?{+{LL#-%A(PF1EGo>D#KCH1BpjNkW3bm({2f22alhOPeb=hC&$>| z$cPvPCO4f#g8+^PiUPvyF+Kv@yeLw*A}-?eLCxppmx{F|9#xW7KooJQ!a4NKKwWdZ z#!tX3RVUGdp-U1I zAttX425T0(E)Y3*cFCL}xuXp5N~*PO0}Pt@lTq;UTjJbe+Qly8+a$b+{IKGT6@fPZj(@#P@F!jvcm;OFb2%VS($l&ei3t`Mz z)0wf4=T&X(-WkvLX*+>-4bu%2{NG}V2$8k}(i?`#a6BHwooRu`R=<}=99#Da*4Lhg z%@8XU?5ep!o;f(w*W-FLjrq5QCp-CpJ3~&ZhE>=2Z;Hi@6@ky6KQ~JR-!5ruJ3KS0 zjW8$bCt`!(T)26<;OE!Cj0n?d1DKRh9Lm9qadQ~=dR%h>3S6ae^Rn`g1zaH1blgGq&ET72Bo?v-xA@U7}s{(c0 zalFq6xy}lck(f;iFujXnY^@9FfS6~=WG}9;2+y+aNycTtxH?+V%Hi|lH86JvJ+rTi8-9v$Ctsx$g`}zWA{+}i80=8?pUh@K%=Y_ocoC_Sc zcyWEbJg}{(56s+$fm=mDJNN^oL92v;yIC554GUoNjT^M`9XK(o|NZCo^7nCTfD`P% zGOQK22^iEh08XQHe++Y#YEs}h#Rptx4O|Dc1i13H6WD5Rsy`<*RSr5Y20uqNL{-#u z&E$@*e$Yk_5V#`p9=5KD&{3<12`Y?zK`ou%ubQ`x+QL MUHx3vIVCg!0E<3RA^-pY literal 21718 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 Z-+8rLKgn-w!Od?-5~8vqg~Ga@{uf^el4}3} literal 17310 zcmeIaRa6^X)Gdk=q_`G$w_?F5#fnpkyK8ZG3GSuEo#O6pfdDNI#fk=ZcRl&e|9r;1 zW8C|A9`F&8Y?*tlDLYzCMeZH?dvrKBxOboBrN6+z!6(5!NB}6X-?$p&`@q3{vivOl z@vC?CNe-&}*SR%_m#;hn2*-E7oA_fUI<4k`<}dUz=1G(o@uvYM>P1O$83JT7&0oYA z%0D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 S3A=X#?z4=Fbd8ir=>G!c{u)03 diff --git a/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.codeobj.json b/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.codeobj.json index cfc9371b8..c43cdb427 100644 --- a/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.codeobj.json +++ b/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.codeobj.json @@ -54,6 +54,22 @@ "name": "CouplingModel" } ], + "DEFAULT_BOUNDARY_N": [ + { + "is_class": false, + "is_explicit": false, + "module": "builtins", + "module_short": "builtins", + "name": "int" + }, + { + "is_class": false, + "is_explicit": false, + "module": "solprop.boundaries", + "module_short": "solprop.boundaries", + "name": "DEFAULT_BOUNDARY_N" + } + ], "EPS0": [ { "is_class": false, @@ -665,6 +681,22 @@ "name": "Simulation" } ], + "absorber": [ + { + "is_class": false, + "is_explicit": false, + "module": "builtins", + "module_short": "builtins", + "name": "function" + }, + { + "is_class": false, + "is_explicit": false, + "module": "solprop.boundaries", + "module_short": "solprop.boundaries", + "name": "absorber" + } + ], "admittance": [ { "is_class": false, @@ -841,6 +873,22 @@ "name": "Displayed.with_input" } ], + "capillary_grid": [ + { + "is_class": false, + "is_explicit": false, + "module": "solprop.grid", + "module_short": "solprop.grid", + "name": "EnvelopeGrid" + }, + { + "is_class": false, + "is_explicit": false, + "module": "solprop", + "module_short": "solprop", + "name": "EnvelopeGrid" + } + ], "carrier": [ { "is_class": false, diff --git a/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.ipynb b/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.ipynb index af0ab0dff..d65fd8213 100644 --- a/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.ipynb +++ b/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.ipynb @@ -15,7 +15,7 @@ }, "outputs": [], "source": [ - "import math\nimport time\n\nimport matplotlib.pyplot as plt\nimport numpy as np\nfrom scipy.special import j0, jn_zeros\n\nfrom solprop import fourier\nfrom solprop.constants import EPS0, C\nfrom solprop.coupling import CouplingModel, couple\nfrom solprop.driver import Simulation, SimulationSettings\nfrom solprop.grid import EnvelopeGrid, RadialGrid\nfrom solprop.modes.capillary import MarcatiliMode\nfrom solprop.nonlinear.optmat_rates import OptmatRate\nfrom solprop.nonlinear.responses import KerrResponse\nfrom solprop.physdata import chi3, gamma3, refractive_index\nfrom solprop.physdata.species import species\nfrom solprop.processing import field_plane, get_spectral_density\nfrom solprop.pulses import GaussianPulse, SpatialPulse\nfrom solprop.spatial import SpatialMedium, critical_power\nfrom solprop.stats import StatsSpec\nfrom solprop.stepper import PIController\n\nstarted = time.perf_counter()" + "import math\nimport time\n\nimport matplotlib.pyplot as plt\nimport numpy as np\nfrom scipy.special import j0, jn_zeros\n\nfrom solprop import fourier\nfrom solprop.boundaries import DEFAULT_BOUNDARY_N, absorber\nfrom solprop.constants import EPS0, C\nfrom solprop.coupling import CouplingModel, couple\nfrom solprop.driver import Simulation, SimulationSettings\nfrom solprop.grid import EnvelopeGrid, RadialGrid\nfrom solprop.modes.capillary import MarcatiliMode\nfrom solprop.nonlinear.optmat_rates import OptmatRate\nfrom solprop.nonlinear.responses import KerrResponse\nfrom solprop.physdata import chi3, gamma3, refractive_index\nfrom solprop.physdata.species import species\nfrom solprop.processing import field_plane, get_spectral_density\nfrom solprop.pulses import GaussianPulse, SpatialPulse\nfrom solprop.spatial import SpatialMedium, critical_power\nfrom solprop.stats import StatsSpec\nfrom solprop.stepper import PIController\n\nstarted = time.perf_counter()" ] }, { @@ -123,7 +123,7 @@ }, "outputs": [], "source": [ - "capillary = Simulation.from_capillary(\n RADIUS,\n LENGTH,\n \"Ar\",\n PRESSURE,\n wavelength=WAVELENGTH,\n grid=grid,\n envelope=True,\n fwhm=FWHM,\n energy=energy,\n modes=8,\n kerr=True,\n thg=False,\n plasma=False,\n raman=False,\n noise=None,\n n_save=21,\n)\nport = capillary.input_port()\nmodel = CouplingModel(\"scalar_paraxial\", model_error=0.05)\ncoupled = {name: couple(plane, port, model=model) for name, plane in planes.items()}\nshares = {\n name: np.sum(weights * np.abs(result.launch.samples[:, 0, :]) ** 2, axis=1)\n / result.report.incident_energy\n for name, result in coupled.items()\n}\nprint(coupled[\"Kerr\"].report)\nfor name, result in coupled.items():\n report = result.report\n print(\n f\"{name:>6}: s11 = {shares[name][0]:.5f}, s12 = {shares[name][1]:.5f}, \"\n f\"s13 = {shares[name][2]:.2e}; launched {report.efficiency:.5f} \"\n f\"of {report.incident_energy * 1e6:.3f} uJ; budget {report.budget:.3f}\"\n )\ndelta = shares[\"Kerr\"] - shares[\"linear\"]\nprint(f\"change: ds11 = {delta[0]:+.3e}, ds12 = {delta[1]:+.3e}, ds13 = {delta[2]:+.2e}\")" + "# The capillary's grid samples as the gap's does -- a launch is bound to its\n# lattice -- and is built for the capillary's own 5 mm, since a run ends at its\n# grid's length; its collar keeps the rate the gap's 20 mm grid gives.\ncapillary_grid = EnvelopeGrid.from_limits(\n LENGTH, WAVELENGTH, (500e-9, 1.4e-6), 300e-15, thg=False\n)\ncapillary = Simulation.from_capillary(\n RADIUS,\n LENGTH,\n \"Ar\",\n PRESSURE,\n wavelength=WAVELENGTH,\n grid=capillary_grid,\n absorber=absorber(capillary_grid, boundary_length=GAP / DEFAULT_BOUNDARY_N),\n envelope=True,\n fwhm=FWHM,\n energy=energy,\n modes=8,\n kerr=True,\n thg=False,\n plasma=False,\n raman=False,\n noise=None,\n n_save=21,\n)\nport = capillary.input_port()\nmodel = CouplingModel(\"scalar_paraxial\", model_error=0.05)\ncoupled = {name: couple(plane, port, model=model) for name, plane in planes.items()}\nshares = {\n name: np.sum(weights * np.abs(result.launch.samples[:, 0, :]) ** 2, axis=1)\n / result.report.incident_energy\n for name, result in coupled.items()\n}\nprint(coupled[\"Kerr\"].report)\nfor name, result in coupled.items():\n report = result.report\n print(\n f\"{name:>6}: s11 = {shares[name][0]:.5f}, s12 = {shares[name][1]:.5f}, \"\n f\"s13 = {shares[name][2]:.2e}; launched {report.efficiency:.5f} \"\n f\"of {report.incident_energy * 1e6:.3f} uJ; budget {report.budget:.3f}\"\n )\ndelta = shares[\"Kerr\"] - shares[\"linear\"]\nprint(f\"change: ds11 = {delta[0]:+.3e}, ds12 = {delta[1]:+.3e}, ds13 = {delta[2]:+.2e}\")" ] }, { @@ -247,7 +247,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.14.5" + "version": "3.14.7" } }, "nbformat": 4, diff --git a/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.py b/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.py index 57c14a8bf..019aee432 100644 --- a/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.py +++ b/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.py @@ -41,6 +41,7 @@ from scipy.special import j0, jn_zeros from solprop import fourier +from solprop.boundaries import DEFAULT_BOUNDARY_N, absorber from solprop.constants import EPS0, C from solprop.coupling import CouplingModel, couple from solprop.driver import Simulation, SimulationSettings @@ -276,13 +277,20 @@ # mode *m*, in its native true-power metric, over the incident energy of the # whole entrance plane in the coupling's common measure. +# The capillary's grid samples as the gap's does -- a launch is bound to its +# lattice -- and is built for the capillary's own 5 mm, since a run ends at its +# grid's length; its collar keeps the rate the gap's 20 mm grid gives. +capillary_grid = EnvelopeGrid.from_limits( + LENGTH, WAVELENGTH, (500e-9, 1.4e-6), 300e-15, thg=False +) capillary = Simulation.from_capillary( RADIUS, LENGTH, "Ar", PRESSURE, wavelength=WAVELENGTH, - grid=grid, + grid=capillary_grid, + absorber=absorber(capillary_grid, boundary_length=GAP / DEFAULT_BOUNDARY_N), envelope=True, fwhm=FWHM, energy=energy, diff --git a/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.py.md5 b/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.py.md5 index 147788a7c..0f168ce8c 100644 --- a/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.py.md5 +++ b/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.py.md5 @@ -1 +1 @@ -9e4fe96e839f0bc0b4f86df05a6d4597 \ No newline at end of file +af0e3d832e983700d7024ab3a450eb75 \ No newline at end of file diff --git a/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.rst b/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.rst index 43d41d357..903da4a33 100644 --- a/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.rst +++ b/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.rst @@ -47,7 +47,7 @@ capillary. The ionisation they would carry is estimated offline at the end. functions and a target on-axis nonlinear phase of the linear Gaussian beam, :math:`B_{\rm lin} = 0.3` rad, accumulated from the launch plane to the focus. -.. GENERATED FROM PYTHON SOURCE LINES 35-61 +.. GENERATED FROM PYTHON SOURCE LINES 35-62 .. code-block:: Python @@ -60,6 +60,7 @@ functions and a target on-axis nonlinear phase of the linear Gaussian beam, from scipy.special import j0, jn_zeros from solprop import fourier + from solprop.boundaries import DEFAULT_BOUNDARY_N, absorber from solprop.constants import EPS0, C from solprop.coupling import CouplingModel, couple from solprop.driver import Simulation, SimulationSettings @@ -84,7 +85,7 @@ functions and a target on-axis nonlinear phase of the linear Gaussian beam, -.. GENERATED FROM PYTHON SOURCE LINES 62-79 +.. GENERATED FROM PYTHON SOURCE LINES 63-80 The energy from the material functions -------------------------------------- @@ -104,7 +105,7 @@ Integrating :math:`k_0 n_2 I_0` from :math:`z = -L` to the focus gives energy is that of the beam through its launch plane, in the argon (:doc:`/guide/free-space/flux`). -.. GENERATED FROM PYTHON SOURCE LINES 79-109 +.. GENERATED FROM PYTHON SOURCE LINES 80-110 .. code-block:: Python @@ -154,7 +155,7 @@ energy is that of the beam through its launch plane, in the argon -.. GENERATED FROM PYTHON SOURCE LINES 110-117 +.. GENERATED FROM PYTHON SOURCE LINES 111-118 Two propagations through the gap -------------------------------- @@ -164,7 +165,7 @@ converged ones of the refinement study described at the end: 1 mm radial domain with 256 nodes, a 300 fs window over 500 nm to 1.4 um, and steps no longer than 0.25 mm. The only difference between the two runs is the response list. -.. GENERATED FROM PYTHON SOURCE LINES 117-138 +.. GENERATED FROM PYTHON SOURCE LINES 118-139 .. code-block:: Python @@ -196,13 +197,13 @@ with 256 nodes, a 300 fs window over 500 nm to 1.4 um, and steps no longer than -.. GENERATED FROM PYTHON SOURCE LINES 139-142 +.. GENERATED FROM PYTHON SOURCE LINES 140-143 The beam radius is the second moment of the time-integrated axial flux. The Kerr lens pulls the beam to a slightly smaller spot and moves its focus a little upstream. Its peak intensity rises by about 14 % but stays far from collapse. -.. GENERATED FROM PYTHON SOURCE LINES 142-163 +.. GENERATED FROM PYTHON SOURCE LINES 143-164 .. code-block:: Python @@ -245,7 +246,7 @@ upstream. Its peak intensity rises by about 14 % but stays far from collapse. -.. GENERATED FROM PYTHON SOURCE LINES 164-177 +.. GENERATED FROM PYTHON SOURCE LINES 165-178 The fields at the entrance -------------------------- @@ -261,7 +262,7 @@ L}(r,\omega_0)]`. Both planes carry the same reference, because both runs share one frame. It is masked where the linear field's amplitude at that bin falls below 1 % of its peak, where neither phase means much. -.. GENERATED FROM PYTHON SOURCE LINES 177-211 +.. GENERATED FROM PYTHON SOURCE LINES 178-212 .. code-block:: Python @@ -317,7 +318,7 @@ one frame. It is masked where the linear field's amplitude at that bin falls bel -.. GENERATED FROM PYTHON SOURCE LINES 212-224 +.. GENERATED FROM PYTHON SOURCE LINES 213-225 The fluence is the time integral of the axial flux, :math:`n_0\varepsilon_0c|E|^2/2` summed over the spectrum (:doc:`/guide/free-space/flux`). The Kerr beam arrives @@ -332,7 +333,7 @@ brighter, and the power through the whole plane is unchanged, since the gap is lossless. The plane's spectrum broadens a little by self-phase modulation, which shows only in its wings, three decades down. -.. GENERATED FROM PYTHON SOURCE LINES 224-264 +.. GENERATED FROM PYTHON SOURCE LINES 225-265 .. code-block:: Python @@ -388,7 +389,7 @@ shows only in its wings, three decades down. -.. GENERATED FROM PYTHON SOURCE LINES 265-278 +.. GENERATED FROM PYTHON SOURCE LINES 266-279 Coupling into the capillary --------------------------- @@ -404,18 +405,25 @@ The modal share is :math:`s_m = U_m/U_{\rm incident}`: the energy launched into mode *m*, in its native true-power metric, over the incident energy of the whole entrance plane in the coupling's common measure. -.. GENERATED FROM PYTHON SOURCE LINES 278-316 +.. GENERATED FROM PYTHON SOURCE LINES 279-324 .. code-block:: Python + # The capillary's grid samples as the gap's does -- a launch is bound to its + # lattice -- and is built for the capillary's own 5 mm, since a run ends at its + # grid's length; its collar keeps the rate the gap's 20 mm grid gives. + capillary_grid = EnvelopeGrid.from_limits( + LENGTH, WAVELENGTH, (500e-9, 1.4e-6), 300e-15, thg=False + ) capillary = Simulation.from_capillary( RADIUS, LENGTH, "Ar", PRESSURE, wavelength=WAVELENGTH, - grid=grid, + grid=capillary_grid, + absorber=absorber(capillary_grid, boundary_length=GAP / DEFAULT_BOUNDARY_N), envelope=True, fwhm=FWHM, energy=energy, @@ -484,14 +492,14 @@ whole entrance plane in the coupling's common measure. -.. GENERATED FROM PYTHON SOURCE LINES 317-321 +.. GENERATED FROM PYTHON SOURCE LINES 325-329 The Kerr-prepared beam puts 2.4 % of the incident energy less into :math:`HE_{11}` and almost all of it into :math:`HE_{12}`. The total captured share barely moves: the change is a redistribution between modes, not a loss. The narrower, more curved entrance field looks more like the second mode. -.. GENERATED FROM PYTHON SOURCE LINES 321-353 +.. GENERATED FROM PYTHON SOURCE LINES 329-361 .. code-block:: Python @@ -539,7 +547,7 @@ The narrower, more curved entrance field looks more like the second mode. -.. GENERATED FROM PYTHON SOURCE LINES 354-373 +.. GENERATED FROM PYTHON SOURCE LINES 362-381 The 5 mm capillary ------------------ @@ -561,7 +569,7 @@ of :math:`HE_{12}`. Because both cases go through the same capillary physics, th beating, the loss and the Kerr coupling are the same in both. The difference between the outputs comes from the prepared incident field. -.. GENERATED FROM PYTHON SOURCE LINES 373-422 +.. GENERATED FROM PYTHON SOURCE LINES 381-430 .. code-block:: Python @@ -637,7 +645,7 @@ between the outputs comes from the prepared incident field. -.. GENERATED FROM PYTHON SOURCE LINES 423-430 +.. GENERATED FROM PYTHON SOURCE LINES 431-438 In both cases :math:`HE_{12}` gives energy to :math:`HE_{11}` along the capillary, far more than its wall loss. Linear modes of a uniform capillary do not @@ -647,7 +655,7 @@ advances. The Kerr-prepared launch leaves the capillary with about 0.27 uJ less in :math:`HE_{11}` and 0.27 uJ more in :math:`HE_{12}`, close to the 0.29 uJ moved at the entrance. -.. GENERATED FROM PYTHON SOURCE LINES 432-440 +.. GENERATED FROM PYTHON SOURCE LINES 440-448 Checks ------ @@ -658,7 +666,7 @@ window, is printed below. So is the coupling's numerical item, which measures th entrance planes' content in the outer fifth of their transverse spectral window. Both are far below anything that could affect the shares. -.. GENERATED FROM PYTHON SOURCE LINES 440-457 +.. GENERATED FROM PYTHON SOURCE LINES 448-465 .. code-block:: Python @@ -687,13 +695,13 @@ Both are far below anything that could affect the shares. .. code-block:: none - linear: outer-domain fluence 2.7e-27, spectral-edge content 2.7e-36 + linear: outer-domain fluence 2.7e-27, spectral-edge content 2.4e-36 Kerr: outer-domain fluence 6.1e-27, spectral-edge content 8.9e-28 -.. GENERATED FROM PYTHON SOURCE LINES 458-474 +.. GENERATED FROM PYTHON SOURCE LINES 466-482 **Convergence.** A separate refinement study varied the radial domain (0.8 to 1.5 mm), the radial nodes (192 to 512), the window (200 to 500 fs), the @@ -712,7 +720,7 @@ share. The two differ by the ratio of the gas index to the mode index, about field of a 30 fs Gaussian at the highest on-axis intensity of the Kerr run. This is an offline estimate, not part of the propagation. -.. GENERATED FROM PYTHON SOURCE LINES 474-491 +.. GENERATED FROM PYTHON SOURCE LINES 482-499 .. code-block:: Python @@ -747,7 +755,7 @@ is an offline estimate, not part of the propagation. -.. GENERATED FROM PYTHON SOURCE LINES 492-501 +.. GENERATED FROM PYTHON SOURCE LINES 500-509 An ionised fraction of about 1e-7 lowers the index by about 2e-9. The Kerr index change it competes with is 6e-6. Leaving plasma out is defensible at this @@ -759,7 +767,7 @@ it through the window's Fresnel transmission yourself, or transport the plane through a :class:`~solprop.coupling.elements.PlanarInterface`, before giving it (:doc:`/guide/free-space/flux`, :doc:`/guide/workflows/coupling`). -.. GENERATED FROM PYTHON SOURCE LINES 501-504 +.. GENERATED FROM PYTHON SOURCE LINES 509-512 .. code-block:: Python @@ -774,12 +782,12 @@ through a :class:`~solprop.coupling.elements.PlanarInterface`, before giving it .. code-block:: none - run time 1.5 s + run time 9.6 s -.. GENERATED FROM PYTHON SOURCE LINES 505-512 +.. GENERATED FROM PYTHON SOURCE LINES 513-520 Related reading --------------- @@ -792,7 +800,7 @@ The design is .. rst-class:: sphx-glr-timing - **Total running time of the script:** (0 minutes 1.483 seconds) + **Total running time of the script:** (0 minutes 9.602 seconds) .. _sphx_glr_download_auto_tutorials_free_space_plot_08_radial_capillary_coupling.py: diff --git a/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.zip b/docs/auto_tutorials/free_space/plot_08_radial_capillary_coupling.zip index c6ebd4210959531e976b36ac6f10f4d9c6f04ea3..09b3987ebc310db4f7b4c03ec9afbb1ea777c1e7 100644 GIT binary patch delta 1024 zcmccqgK1?0vqXS5Gm8iV2()Sx#J&o;uh$jMz|a-GQNo%-Cn>))FD0=kGqqSDGq)hW zs6@fV)y*-~CnVmR1+1VnGp9r$Ex!nC5VA%2<#`JArV6>aIts;^c|c8x3Pq)P3aNQ1 zKzmD|27+7zv^pm>FTEtg8YHNYoDXuULUw9u0mOAhi6yB>&NMOrnhEhndS+Q_u^t!P z)_AbzY!zJd%2IRk3sT)D*N6&mb149UkE@@1h{xo9Q6nZU&B>~UHSwsrbik@0L6=%& z3u9=Yse%LuFeKw4PPTP-3{cR=5)GQ0mm2!0@PQ&R!}!gg=yV2#==9D1LobjRi~Hi1 z>r*urWAaFj#(D+3(Fih;8u1vDhZ@)lu!x*oDJskplZP6OtTB0-F?o~K4Amxg_r)fl zYSn?LhQ%T^qVr8(g$|?nXYB>=21Y6dj04OdyEC2ui diff --git a/docs/auto_tutorials/waveguides/images/sphx_glr_plot_05_general_modal_001.png b/docs/auto_tutorials/waveguides/images/sphx_glr_plot_05_general_modal_001.png index 44b56af4ad0178ca3a4331579041e0508b068fb6..bf4abae05ab79078c6b9674b9d30ed7c32f88cdd 100644 GIT binary patch literal 32341 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%0DRX`S^xk5 literal 29493 zcmX_o1yEL9*EWa}f*?qDgGhHHC0zp2-QC^N-5}j9-QC^N-GX#?e4FR}=f7vv(b03x zz0cljU9}9Bl@|H%9{W861jGk1QK9b;5O0(rARskip~0W1%;~6uUpVcBmF?xN4DFqC zYz-i!bnLCot?bQBbO{{|Z0$^}ESYE-7-$)&361UTt?fAJ=q&#K-=MX!HKMa!gt`S+ zfwLA>v4em>(s}&>S;$vl0s�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 diff --git a/docs/auto_tutorials/waveguides/images/thumb/sphx_glr_plot_05_general_modal_thumb.png b/docs/auto_tutorials/waveguides/images/thumb/sphx_glr_plot_05_general_modal_thumb.png index a83d6792cd8412db170236f570cb4c1e6644d80e..856d8bb760fdaef46d9370892d4f85a3cc8dcb96 100644 GIT binary patch literal 26042 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 diff --git a/docs/auto_tutorials/waveguides/plot_05_general_modal.codeobj.json b/docs/auto_tutorials/waveguides/plot_05_general_modal.codeobj.json index 3255921ea..75dc0d0be 100644 --- a/docs/auto_tutorials/waveguides/plot_05_general_modal.codeobj.json +++ b/docs/auto_tutorials/waveguides/plot_05_general_modal.codeobj.json @@ -24,6 +24,22 @@ "name": "float" } ], + "DEFAULT_BOUNDARY_N": [ + { + "is_class": false, + "is_explicit": false, + "module": "builtins", + "module_short": "builtins", + "name": "int" + }, + { + "is_class": false, + "is_explicit": false, + "module": "solprop.boundaries", + "module_short": "solprop.boundaries", + "name": "DEFAULT_BOUNDARY_N" + } + ], "EnvelopeGrid.from_limits": [ { "is_class": true, @@ -412,6 +428,22 @@ "name": "ndarray" } ], + "absorber": [ + { + "is_class": false, + "is_explicit": false, + "module": "builtins", + "module_short": "builtins", + "name": "function" + }, + { + "is_class": false, + "is_explicit": false, + "module": "solprop.boundaries", + "module_short": "solprop.boundaries", + "name": "absorber" + } + ], "area": [ { "is_class": false, @@ -728,6 +760,15 @@ "name": "IndexMaterial" } ], + "envelope": [ + { + "is_class": false, + "is_explicit": false, + "module": "builtins", + "module_short": "builtins", + "name": "dict" + } + ], "envelope_grid": [ { "is_class": false, @@ -797,6 +838,15 @@ "name": "ndarray" } ], + "field": [ + { + "is_class": false, + "is_explicit": false, + "module": "builtins", + "module_short": "builtins", + "name": "dict" + } + ], "fig": [ { "is_class": false, @@ -854,6 +904,15 @@ "name": "float" } ], + "gentle": [ + { + "is_class": false, + "is_explicit": false, + "module": "builtins", + "module_short": "builtins", + "name": "float" + } + ], "grid": [ { "is_class": false, @@ -1457,6 +1516,38 @@ "name": "tuple" } ], + "run_envelope_grid": [ + { + "is_class": false, + "is_explicit": false, + "module": "solprop.grid", + "module_short": "solprop.grid", + "name": "EnvelopeGrid" + }, + { + "is_class": false, + "is_explicit": false, + "module": "solprop", + "module_short": "solprop", + "name": "EnvelopeGrid" + } + ], + "run_grid": [ + { + "is_class": false, + "is_explicit": false, + "module": "solprop.grid", + "module_short": "solprop.grid", + "name": "FieldGrid" + }, + { + "is_class": false, + "is_explicit": false, + "module": "solprop", + "module_short": "solprop", + "name": "FieldGrid" + } + ], "runs": [ { "is_class": false, diff --git a/docs/auto_tutorials/waveguides/plot_05_general_modal.ipynb b/docs/auto_tutorials/waveguides/plot_05_general_modal.ipynb index d6c2274ef..b623b4ffc 100644 --- a/docs/auto_tutorials/waveguides/plot_05_general_modal.ipynb +++ b/docs/auto_tutorials/waveguides/plot_05_general_modal.ipynb @@ -15,7 +15,7 @@ }, "outputs": [], "source": [ - "import matplotlib.pyplot as plt\nimport numpy as np\n\nfrom solprop import fourier\nfrom solprop.constants import C\nfrom solprop.driver import prop_gnlse, prop_waveguide\nfrom solprop.grid import EnvelopeGrid, FieldGrid\nfrom solprop.modes import (\n IndexMaterial,\n MaterialKerr,\n MaterialRegion,\n ModalGuide,\n StepIndexMode,\n)\nfrom solprop.nonlinear.normalisation import modal_kerr_coefficient\nfrom solprop.physdata import chi3_from_n2, n2_from_chi3\nfrom solprop.translate.modal_tables import channel_area, sample_modal_table\n\nLENGTH = 2e-5\n\"\"\"Twenty microns, in about ten accepted steps.\n\nWhat sets the step here is neither the self-phase modulation nor the general\nroute: it is the explicit in-stage temporal collar (see \"Boundaries\" in the model\ndocumentation), whose\nrate is set by the length the *grid* was built for, and whose stable step is set\nby that rate. A general modal step is expensive, so this example builds its\ngrids for a millimetre -- a gentle collar -- and propagates twenty microns of it,\nto stay inside the documentation build's budget.\n\"\"\"\n\nWINDOW_LENGTH = 1e-3\n\"\"\"Length the grids and their collar are declared for, m.\"\"\"\n\nN2 = 2.6e-20\nCHI3 = chi3_from_n2(N2, 1.45)\n\"\"\"The core's absolute susceptibility, m^2/V^2.\n\nsolprop's own conversion, against the core's linear index: a hand-written\n``4 eps0 c n^2 n2 / 3`` beside it would be a second copy of the relation.\n\"\"\"" + "import matplotlib.pyplot as plt\nimport numpy as np\n\nfrom solprop import fourier\nfrom solprop.boundaries import DEFAULT_BOUNDARY_N, absorber\nfrom solprop.constants import C\nfrom solprop.driver import prop_gnlse, prop_waveguide\nfrom solprop.grid import EnvelopeGrid, FieldGrid\nfrom solprop.modes import (\n IndexMaterial,\n MaterialKerr,\n MaterialRegion,\n ModalGuide,\n StepIndexMode,\n)\nfrom solprop.nonlinear.normalisation import modal_kerr_coefficient\nfrom solprop.physdata import chi3_from_n2, n2_from_chi3\nfrom solprop.translate.modal_tables import channel_area, sample_modal_table\n\nLENGTH = 2e-5\n\"\"\"Twenty microns, in about ten accepted steps.\n\nWhat sets the step here is neither the self-phase modulation nor the general\nroute: it is the explicit in-stage temporal collar (see \"Boundaries\" in the model\ndocumentation), whose\nrate is set by the length the *grid* was built for, and whose stable step is set\nby that rate. A general modal step is expensive, so this example propagates\ntwenty microns -- a run ends at its grid's length, so its grids are built for\ntwenty microns -- and keeps the collar a millimetre's grid would have, a gentle one,\nthrough ``boundary_length``, to stay inside the documentation build's budget.\n\"\"\"\n\nWINDOW_LENGTH = 1e-3\n\"\"\"Length the collar's rate is declared for, m.\"\"\"\n\nN2 = 2.6e-20\nCHI3 = chi3_from_n2(N2, 1.45)\n\"\"\"The core's absolute susceptibility, m^2/V^2.\n\nsolprop's own conversion, against the core's linear index: a hand-written\n``4 eps0 c n^2 n2 / 3`` beside it would be a second copy of the relation.\n\"\"\"" ] }, { @@ -69,7 +69,7 @@ }, "outputs": [], "source": [ - "linear_guide = ModalGuide.from_provider(\n ModalGuide.from_step_index(\n [mode],\n core=core_law,\n cladding=cladding_law,\n regions=(\n MaterialRegion(\"core\", 0.0, mode.core_radius, core_law),\n MaterialRegion(\"cladding\", mode.core_radius, None, cladding_law),\n ),\n ).field_provider,\n guide.sampling.omega,\n nodes=nodes,\n)\ncommon = {\n \"noise\": None, # a 40 pJ comparison of two routes: the lesson is noiseless\n \"wavelength\": 835e-9,\n \"fwhm\": 40e-15,\n \"energy\": 4e-11,\n \"shape\": \"gauss\",\n \"n_save\": 2,\n \"backend\": \"numpy_ref\",\n \"progress\": \"none\",\n \"dz_max\": LENGTH / 10,\n \"dz_init\": LENGTH / 10,\n}\nchannel = guide.mode_collection.modes[0]\nruns = {\n \"general\": prop_waveguide(\n (), LENGTH, provider=guide, grid=grid, kerr_form=\"analytic\", **common\n ),\n \"general, linear\": prop_waveguide(\n (), LENGTH, provider=linear_guide, grid=grid, kerr_form=\"analytic\", **common\n ),\n \"gnlse\": prop_gnlse(\n gamma, LENGTH, grid=envelope_grid, fibre=channel, shock=True, **common\n ),\n \"gnlse, linear\": prop_gnlse(\n 0.0, LENGTH, grid=envelope_grid, fibre=channel, shock=True, **common\n ),\n}\n\n\ndef nonlinear_phase(turned, straight, kind):\n \"\"\"Return the phase the nonlinearity added, against time in the run's frame.\"\"\"\n a = fourier.inverse(turned.planes()[-1].field[0, 0], kind=kind)\n b = fourier.inverse(straight.planes()[-1].field[0, 0], kind=kind)\n if kind == \"field\":\n a, b = fourier.analytic_signal(a), fourier.analytic_signal(b)\n keep = np.abs(b) ** 2 > 1e-3 * np.max(np.abs(b) ** 2)\n return keep, np.angle(a[keep] / b[keep]), np.abs(b[keep]) ** 2" + "linear_guide = ModalGuide.from_provider(\n ModalGuide.from_step_index(\n [mode],\n core=core_law,\n cladding=cladding_law,\n regions=(\n MaterialRegion(\"core\", 0.0, mode.core_radius, core_law),\n MaterialRegion(\"cladding\", mode.core_radius, None, cladding_law),\n ),\n ).field_provider,\n guide.sampling.omega,\n nodes=nodes,\n)\ncommon = {\n \"noise\": None, # a 40 pJ comparison of two routes: the lesson is noiseless\n \"wavelength\": 835e-9,\n \"fwhm\": 40e-15,\n \"energy\": 4e-11,\n \"shape\": \"gauss\",\n \"n_save\": 2,\n \"backend\": \"numpy_ref\",\n \"progress\": \"none\",\n \"dz_max\": LENGTH / 10,\n \"dz_init\": LENGTH / 10,\n}\nchannel = guide.mode_collection.modes[0]\n# The runs' grids sample as the guide's did, over the twenty microns they propagate,\n# with the collar of a millimetre.\nrun_grid = FieldGrid.from_limits(LENGTH, 835e-9, (790e-9, 890e-9), 200e-15)\nrun_envelope_grid = EnvelopeGrid.from_limits(LENGTH, 835e-9, (790e-9, 890e-9), 200e-15)\ngentle = WINDOW_LENGTH / DEFAULT_BOUNDARY_N\nfield = {\"grid\": run_grid, \"absorber\": absorber(run_grid, boundary_length=gentle)}\nenvelope = {\n \"grid\": run_envelope_grid,\n \"absorber\": absorber(run_envelope_grid, boundary_length=gentle),\n}\nruns = {\n \"general\": prop_waveguide(\n (), LENGTH, provider=guide, kerr_form=\"analytic\", **field, **common\n ),\n \"general, linear\": prop_waveguide(\n (), LENGTH, provider=linear_guide, kerr_form=\"analytic\", **field, **common\n ),\n \"gnlse\": prop_gnlse(gamma, LENGTH, fibre=channel, shock=True, **envelope, **common),\n \"gnlse, linear\": prop_gnlse(\n 0.0, LENGTH, fibre=channel, shock=True, **envelope, **common\n ),\n}\n\n\ndef nonlinear_phase(turned, straight, kind):\n \"\"\"Return the phase the nonlinearity added, against time in the run's frame.\"\"\"\n a = fourier.inverse(turned.planes()[-1].field[0, 0], kind=kind)\n b = fourier.inverse(straight.planes()[-1].field[0, 0], kind=kind)\n if kind == \"field\":\n a, b = fourier.analytic_signal(a), fourier.analytic_signal(b)\n keep = np.abs(b) ** 2 > 1e-3 * np.max(np.abs(b) ** 2)\n return keep, np.angle(a[keep] / b[keep]), np.abs(b[keep]) ** 2" ] }, { @@ -114,7 +114,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.14.5" + "version": "3.14.7" } }, "nbformat": 4, diff --git a/docs/auto_tutorials/waveguides/plot_05_general_modal.py b/docs/auto_tutorials/waveguides/plot_05_general_modal.py index 3c7de1643..c47c832df 100644 --- a/docs/auto_tutorials/waveguides/plot_05_general_modal.py +++ b/docs/auto_tutorials/waveguides/plot_05_general_modal.py @@ -23,6 +23,7 @@ import numpy as np from solprop import fourier +from solprop.boundaries import DEFAULT_BOUNDARY_N, absorber from solprop.constants import C from solprop.driver import prop_gnlse, prop_waveguide from solprop.grid import EnvelopeGrid, FieldGrid @@ -44,13 +45,14 @@ route: it is the explicit in-stage temporal collar (see "Boundaries" in the model documentation), whose rate is set by the length the *grid* was built for, and whose stable step is set -by that rate. A general modal step is expensive, so this example builds its -grids for a millimetre -- a gentle collar -- and propagates twenty microns of it, -to stay inside the documentation build's budget. +by that rate. A general modal step is expensive, so this example propagates +twenty microns -- a run ends at its grid's length, so its grids are built for +twenty microns -- and keeps the collar a millimetre's grid would have, a gentle one, +through ``boundary_length``, to stay inside the documentation build's budget. """ WINDOW_LENGTH = 1e-3 -"""Length the grids and their collar are declared for, m.""" +"""Length the collar's rate is declared for, m.""" N2 = 2.6e-20 CHI3 = chi3_from_n2(N2, 1.45) @@ -154,18 +156,26 @@ "dz_init": LENGTH / 10, } channel = guide.mode_collection.modes[0] +# The runs' grids sample as the guide's did, over the twenty microns they propagate, +# with the collar of a millimetre. +run_grid = FieldGrid.from_limits(LENGTH, 835e-9, (790e-9, 890e-9), 200e-15) +run_envelope_grid = EnvelopeGrid.from_limits(LENGTH, 835e-9, (790e-9, 890e-9), 200e-15) +gentle = WINDOW_LENGTH / DEFAULT_BOUNDARY_N +field = {"grid": run_grid, "absorber": absorber(run_grid, boundary_length=gentle)} +envelope = { + "grid": run_envelope_grid, + "absorber": absorber(run_envelope_grid, boundary_length=gentle), +} runs = { "general": prop_waveguide( - (), LENGTH, provider=guide, grid=grid, kerr_form="analytic", **common + (), LENGTH, provider=guide, kerr_form="analytic", **field, **common ), "general, linear": prop_waveguide( - (), LENGTH, provider=linear_guide, grid=grid, kerr_form="analytic", **common - ), - "gnlse": prop_gnlse( - gamma, LENGTH, grid=envelope_grid, fibre=channel, shock=True, **common + (), LENGTH, provider=linear_guide, kerr_form="analytic", **field, **common ), + "gnlse": prop_gnlse(gamma, LENGTH, fibre=channel, shock=True, **envelope, **common), "gnlse, linear": prop_gnlse( - 0.0, LENGTH, grid=envelope_grid, fibre=channel, shock=True, **common + 0.0, LENGTH, fibre=channel, shock=True, **envelope, **common ), } diff --git a/docs/auto_tutorials/waveguides/plot_05_general_modal.py.md5 b/docs/auto_tutorials/waveguides/plot_05_general_modal.py.md5 index b61c4e3bc..cc8ebb108 100644 --- a/docs/auto_tutorials/waveguides/plot_05_general_modal.py.md5 +++ b/docs/auto_tutorials/waveguides/plot_05_general_modal.py.md5 @@ -1 +1 @@ -a1aef66c98ee8a3d05fa70ce2c572615 \ No newline at end of file +e9d2cb84def22d706be5ed1c0a0b97d7 \ No newline at end of file diff --git a/docs/auto_tutorials/waveguides/plot_05_general_modal.rst b/docs/auto_tutorials/waveguides/plot_05_general_modal.rst index 27831b1f7..3d6f5bd74 100644 --- a/docs/auto_tutorials/waveguides/plot_05_general_modal.rst +++ b/docs/auto_tutorials/waveguides/plot_05_general_modal.rst @@ -33,7 +33,7 @@ vector coefficient, which carries the longitudinal field and the ``|E.E|^2`` term, agrees with the scalar ``n2 omega / (c A_eff)`` to a fraction of a per cent here. On a sub-micron strand the two differ by a quarter. -.. GENERATED FROM PYTHON SOURCE LINES 21-63 +.. GENERATED FROM PYTHON SOURCE LINES 21-65 .. code-block:: Python @@ -42,6 +42,7 @@ a per cent here. On a sub-micron strand the two differ by a quarter. import numpy as np from solprop import fourier + from solprop.boundaries import DEFAULT_BOUNDARY_N, absorber from solprop.constants import C from solprop.driver import prop_gnlse, prop_waveguide from solprop.grid import EnvelopeGrid, FieldGrid @@ -63,13 +64,14 @@ a per cent here. On a sub-micron strand the two differ by a quarter. route: it is the explicit in-stage temporal collar (see "Boundaries" in the model documentation), whose rate is set by the length the *grid* was built for, and whose stable step is set - by that rate. A general modal step is expensive, so this example builds its - grids for a millimetre -- a gentle collar -- and propagates twenty microns of it, - to stay inside the documentation build's budget. + by that rate. A general modal step is expensive, so this example propagates + twenty microns -- a run ends at its grid's length, so its grids are built for + twenty microns -- and keeps the collar a millimetre's grid would have, a gentle one, + through ``boundary_length``, to stay inside the documentation build's budget. """ WINDOW_LENGTH = 1e-3 - """Length the grids and their collar are declared for, m.""" + """Length the collar's rate is declared for, m.""" N2 = 2.6e-20 CHI3 = chi3_from_n2(N2, 1.45) @@ -92,13 +94,13 @@ a per cent here. On a sub-micron strand the two differ by a quarter. -.. GENERATED FROM PYTHON SOURCE LINES 64-67 +.. GENERATED FROM PYTHON SOURCE LINES 66-69 The guide: a 4 um core at a 0.01 index step, with the Kerr response declared on the core region and nothing on the cladding, which is how a linear cladding is said to be linear. -.. GENERATED FROM PYTHON SOURCE LINES 67-98 +.. GENERATED FROM PYTHON SOURCE LINES 69-100 .. code-block:: Python @@ -155,13 +157,13 @@ said to be linear. -.. GENERATED FROM PYTHON SOURCE LINES 99-102 +.. GENERATED FROM PYTHON SOURCE LINES 101-104 The vector coefficient, and the scalar one the GNLSE would use. ``metric=`` is the channel's own sampled Poynting flux -- the metric the route's projection map contracts with -- so the coefficient is the same statement that map makes. -.. GENERATED FROM PYTHON SOURCE LINES 102-117 +.. GENERATED FROM PYTHON SOURCE LINES 104-119 .. code-block:: Python @@ -194,7 +196,7 @@ map contracts with -- so the coefficient is the same statement that map makes. -.. GENERATED FROM PYTHON SOURCE LINES 118-131 +.. GENERATED FROM PYTHON SOURCE LINES 120-133 A short run through each route, and each one's own dispersion-only reference: a guide whose regions declare no response, and gamma = 0. @@ -210,7 +212,7 @@ the general modal manual page says why — so what the comparison measures is the two routes and not the choice of form. -.. GENERATED FROM PYTHON SOURCE LINES 131-183 +.. GENERATED FROM PYTHON SOURCE LINES 133-193 .. code-block:: Python @@ -240,18 +242,26 @@ comparison measures is the two routes and not the choice of form. "dz_init": LENGTH / 10, } channel = guide.mode_collection.modes[0] + # The runs' grids sample as the guide's did, over the twenty microns they propagate, + # with the collar of a millimetre. + run_grid = FieldGrid.from_limits(LENGTH, 835e-9, (790e-9, 890e-9), 200e-15) + run_envelope_grid = EnvelopeGrid.from_limits(LENGTH, 835e-9, (790e-9, 890e-9), 200e-15) + gentle = WINDOW_LENGTH / DEFAULT_BOUNDARY_N + field = {"grid": run_grid, "absorber": absorber(run_grid, boundary_length=gentle)} + envelope = { + "grid": run_envelope_grid, + "absorber": absorber(run_envelope_grid, boundary_length=gentle), + } runs = { "general": prop_waveguide( - (), LENGTH, provider=guide, grid=grid, kerr_form="analytic", **common + (), LENGTH, provider=guide, kerr_form="analytic", **field, **common ), "general, linear": prop_waveguide( - (), LENGTH, provider=linear_guide, grid=grid, kerr_form="analytic", **common - ), - "gnlse": prop_gnlse( - gamma, LENGTH, grid=envelope_grid, fibre=channel, shock=True, **common + (), LENGTH, provider=linear_guide, kerr_form="analytic", **field, **common ), + "gnlse": prop_gnlse(gamma, LENGTH, fibre=channel, shock=True, **envelope, **common), "gnlse, linear": prop_gnlse( - 0.0, LENGTH, grid=envelope_grid, fibre=channel, shock=True, **common + 0.0, LENGTH, fibre=channel, shock=True, **envelope, **common ), } @@ -280,14 +290,14 @@ comparison measures is the two routes and not the choice of form. -.. GENERATED FROM PYTHON SOURCE LINES 184-188 +.. GENERATED FROM PYTHON SOURCE LINES 194-198 In the internal FFT convention both routes turn by ``-gamma P(t) L`` (the public optics-convention phase has the opposite sign), plotted against the local power so that the two grids' different time samples fall on one curve. -.. GENERATED FROM PYTHON SOURCE LINES 188-213 +.. GENERATED FROM PYTHON SOURCE LINES 198-223 .. code-block:: Python @@ -328,7 +338,7 @@ so that the two grids' different time samples fall on one curve. -.. GENERATED FROM PYTHON SOURCE LINES 214-221 +.. GENERATED FROM PYTHON SOURCE LINES 224-231 Related reading --------------- @@ -341,7 +351,7 @@ For a paced propagation lesson, return to .. rst-class:: sphx-glr-timing - **Total running time of the script:** (0 minutes 4.537 seconds) + **Total running time of the script:** (0 minutes 8.945 seconds) .. _sphx_glr_download_auto_tutorials_waveguides_plot_05_general_modal.py: diff --git a/docs/auto_tutorials/waveguides/plot_05_general_modal.zip b/docs/auto_tutorials/waveguides/plot_05_general_modal.zip index 44a0f300f73a933e7ed451cc2fd74ff12b846ca5..ec01f741a3e56d2b95b73303d258c2dd31eb911a 100644 GIT binary patch delta 1822 zcmcJQPfrs;7{=Qaso5Z)aA-l|n>Gd(7BJC-Xi^a5k6_ahLM6mC?ZQsmO?PMN?6z19 zX^8RW#Y{YV@ob_cUi=`Qj2`_8CYU(WWr4OpHO5Wav@>s>=Y8It-|nk7{!efHgR2h$ z9sNFW?Tr*4C-3d52!FWsBcN=N64o_pAR7#;NT>tz3yZU<_T4LNG) z!#0=*=bXF(HaS}5B^1F{$uJ$r5_*~%)}eq<(FP}vV4IkxM&sPWGECF3kV6qy76!0G zN~R8Zt&DiHkmGHc2na@s~-9)7Zmx3ma_BDsolL?Iu?;bYZU>x&ow(XuZd#iSV{7a5OMQio%ZJFP!>PtM|M3xdO%`@|fjpzc(;YIFvdRd^mPevRd4au-nXE_)bTW3|}81sAQ^nSS;)mTFlEGCbY)XE=SC zjy2$Pcjk%YpJE@EXNOweUG+Db`?b${S7d0!&gUCES+QqD*)JGk<(1yf%So~G8)p`3 A)KrZ}-Eb@Mrn2mF)wNcqTv)YyUu9fj=FqM~@9 zZMn8eiFt`Rl_irozGpQU7(iGW7+{i{7b>T- zOpag?+8nOo#cYEJwU|7RS)>LVvrbGNFx-;yh1nyWCBl=JIR$Wn9SinKjkC<;h0fxW z4V?WjM71XCyKpHI6&ye_q$f+b=-~>6e3u+9M$^f6{2XO5QV%FeLBW#AR{oj_7{LXT Y2GUC!A1X|?^_Q4D+h3IJxhF^l0Pix~D*ylh diff --git a/docs/auto_tutorials/waveguides/plot_06_graded_index.codeobj.json b/docs/auto_tutorials/waveguides/plot_06_graded_index.codeobj.json index 8842b2f55..5dc38ecb9 100644 --- a/docs/auto_tutorials/waveguides/plot_06_graded_index.codeobj.json +++ b/docs/auto_tutorials/waveguides/plot_06_graded_index.codeobj.json @@ -1333,7 +1333,7 @@ { "is_class": false, "is_explicit": false, - "module": "solprop.output.schema", + "module": "solprop.output.records", "module_short": "solprop.output", "name": "SavedPlane" }, @@ -1658,8 +1658,8 @@ { "is_class": false, "is_explicit": false, - "module": "solprop.output.schema", - "module_short": "solprop.output.schema", + "module": "solprop.output.store", + "module_short": "solprop.output.store", "name": "PlaneStore.planes" }, { diff --git a/docs/auto_tutorials/waveguides/plot_06_graded_index.ipynb b/docs/auto_tutorials/waveguides/plot_06_graded_index.ipynb index 8f3c2f248..3782d213d 100644 --- a/docs/auto_tutorials/waveguides/plot_06_graded_index.ipynb +++ b/docs/auto_tutorials/waveguides/plot_06_graded_index.ipynb @@ -76,7 +76,7 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "A continuous wave in both channels at once, propagated to that length in ten\nsteps. One coarse bin is exactly periodic on the time window, so the beat is\nthe two channels' relative phase and nothing else. A wave that fills the window\nwants neither the temporal collar nor the watch on the window's edges.\n\n" + "A continuous wave in both channels at once, propagated to that length in ten\nsteps. One coarse bin is exactly periodic on the time window, so the beat is\nthe two channels' relative phase and nothing else. A wave that fills the window\nwants neither the temporal collar nor the watch on the window's edges. A run\nends at its grid's length, so its grid samples as the guide's did, built for the\nimaging length.\n\n" ] }, { @@ -87,7 +87,7 @@ }, "outputs": [], "source": [ - "simulation = Simulation.from_waveguide(\n (),\n length,\n provider=guide,\n grid=grid,\n wavelength=WAVELENGTH,\n fwhm=40e-15,\n energy=1e-15,\n shape=\"gauss\",\n n_save=9,\n dz_max=length / 10,\n dz_init=length / 10,\n noise=None,\n absorber=False,\n boundary_check=None,\n)\nlaunch = np.zeros((2, 1, grid.n_omega), dtype=complex)\nlaunch[:, 0, centre] = 1.0\nrun = simulation.with_input(launch).run(progress=\"none\")\nplanes = run.planes()" + "simulation = Simulation.from_waveguide(\n (),\n length,\n provider=guide,\n grid=FieldGrid.from_limits(length, WAVELENGTH, (1.0e-6, 1.06e-6), 100e-15),\n wavelength=WAVELENGTH,\n fwhm=40e-15,\n energy=1e-15,\n shape=\"gauss\",\n n_save=9,\n dz_max=length / 10,\n dz_init=length / 10,\n noise=None,\n absorber=False,\n boundary_check=None,\n)\nlaunch = np.zeros((2, 1, grid.n_omega), dtype=complex)\nlaunch[:, 0, centre] = 1.0\nrun = simulation.with_input(launch).run(progress=\"none\")\nplanes = run.planes()" ] }, { diff --git a/docs/auto_tutorials/waveguides/plot_06_graded_index.py b/docs/auto_tutorials/waveguides/plot_06_graded_index.py index 28f26416d..91c85eb6e 100644 --- a/docs/auto_tutorials/waveguides/plot_06_graded_index.py +++ b/docs/auto_tutorials/waveguides/plot_06_graded_index.py @@ -112,12 +112,14 @@ # A continuous wave in both channels at once, propagated to that length in ten # steps. One coarse bin is exactly periodic on the time window, so the beat is # the two channels' relative phase and nothing else. A wave that fills the window -# wants neither the temporal collar nor the watch on the window's edges. +# wants neither the temporal collar nor the watch on the window's edges. A run +# ends at its grid's length, so its grid samples as the guide's did, built for the +# imaging length. simulation = Simulation.from_waveguide( (), length, provider=guide, - grid=grid, + grid=FieldGrid.from_limits(length, WAVELENGTH, (1.0e-6, 1.06e-6), 100e-15), wavelength=WAVELENGTH, fwhm=40e-15, energy=1e-15, diff --git a/docs/auto_tutorials/waveguides/plot_06_graded_index.py.md5 b/docs/auto_tutorials/waveguides/plot_06_graded_index.py.md5 index 5a949440a..9a7a3a456 100644 --- a/docs/auto_tutorials/waveguides/plot_06_graded_index.py.md5 +++ b/docs/auto_tutorials/waveguides/plot_06_graded_index.py.md5 @@ -1 +1 @@ -d3c231fe50cfeddc7ebd10a4e1aa6560 \ No newline at end of file +f3f61dd45d997e94d82ee41097abcd59 \ No newline at end of file diff --git a/docs/auto_tutorials/waveguides/plot_06_graded_index.rst b/docs/auto_tutorials/waveguides/plot_06_graded_index.rst index 47ca0cc74..80dd63b58 100644 --- a/docs/auto_tutorials/waveguides/plot_06_graded_index.rst +++ b/docs/auto_tutorials/waveguides/plot_06_graded_index.rst @@ -193,14 +193,16 @@ is 1 and 3. Their spacing sets the self-imaging length ``2 pi / Delta beta``. -.. GENERATED FROM PYTHON SOURCE LINES 112-116 +.. GENERATED FROM PYTHON SOURCE LINES 112-118 A continuous wave in both channels at once, propagated to that length in ten steps. One coarse bin is exactly periodic on the time window, so the beat is the two channels' relative phase and nothing else. A wave that fills the window -wants neither the temporal collar nor the watch on the window's edges. +wants neither the temporal collar nor the watch on the window's edges. A run +ends at its grid's length, so its grid samples as the guide's did, built for the +imaging length. -.. GENERATED FROM PYTHON SOURCE LINES 116-137 +.. GENERATED FROM PYTHON SOURCE LINES 118-139 .. code-block:: Python @@ -208,7 +210,7 @@ wants neither the temporal collar nor the watch on the window's edges. (), length, provider=guide, - grid=grid, + grid=FieldGrid.from_limits(length, WAVELENGTH, (1.0e-6, 1.06e-6), 100e-15), wavelength=WAVELENGTH, fwhm=40e-15, energy=1e-15, @@ -232,13 +234,13 @@ wants neither the temporal collar nor the watch on the window's edges. -.. GENERATED FROM PYTHON SOURCE LINES 138-141 +.. GENERATED FROM PYTHON SOURCE LINES 140-143 The transverse intensity along the beat. The two channels' patterns add in phase at the entrance, cancel on the axis half a beat later, and come back at the imaging length: the guide has reproduced its own launch. -.. GENERATED FROM PYTHON SOURCE LINES 141-164 +.. GENERATED FROM PYTHON SOURCE LINES 143-166 .. code-block:: Python @@ -277,13 +279,13 @@ the imaging length: the guide has reproduced its own launch. -.. GENERATED FROM PYTHON SOURCE LINES 165-168 +.. GENERATED FROM PYTHON SOURCE LINES 167-170 The residual phase after a full turn is the solved spacing's departure from the ideal one, and nothing else: the guide reproduces its own dispersion, and what is left over is the P1 discretisation of an analytic answer. -.. GENERATED FROM PYTHON SOURCE LINES 168-177 +.. GENERATED FROM PYTHON SOURCE LINES 170-179 .. code-block:: Python @@ -310,14 +312,14 @@ is left over is the P1 discretisation of an analytic answer. -.. GENERATED FROM PYTHON SOURCE LINES 178-182 +.. GENERATED FROM PYTHON SOURCE LINES 180-184 A launch declared as a **field** rather than as a channel. The route projects it onto the channels through the record's coordinate dual and reports what the bound channels did not capture, so a profile the guide cannot carry says so instead of being quietly rescaled. -.. GENERATED FROM PYTHON SOURCE LINES 182-193 +.. GENERATED FROM PYTHON SOURCE LINES 184-195 .. code-block:: Python @@ -350,13 +352,13 @@ instead of being quietly rescaled. -.. GENERATED FROM PYTHON SOURCE LINES 194-197 +.. GENERATED FROM PYTHON SOURCE LINES 196-199 A field the channels cannot span leaves a remainder, and the projection names it rather than rescaling it away: here the same pattern with its sign flipped on every other node, which is no combination of the two channels at all. -.. GENERATED FROM PYTHON SOURCE LINES 197-202 +.. GENERATED FROM PYTHON SOURCE LINES 199-204 .. code-block:: Python @@ -378,7 +380,7 @@ on every other node, which is no combination of the two channels at all. -.. GENERATED FROM PYTHON SOURCE LINES 203-209 +.. GENERATED FROM PYTHON SOURCE LINES 205-211 The same happens, less obviously, to a profile declared at **one** frequency and held across the band: the channels' patterns change with frequency, so away from @@ -387,7 +389,7 @@ projection reports that too. The share is a reconstruction residual on the guide's nodes, not radiated power: the energy account of an incident beam is what ``incident=`` records (:doc:`/guide/waveguides/general-modal`). -.. GENERATED FROM PYTHON SOURCE LINES 209-215 +.. GENERATED FROM PYTHON SOURCE LINES 211-217 .. code-block:: Python @@ -410,7 +412,7 @@ what ``incident=`` records (:doc:`/guide/waveguides/general-modal`). -.. GENERATED FROM PYTHON SOURCE LINES 216-222 +.. GENERATED FROM PYTHON SOURCE LINES 218-224 Related reading --------------- @@ -422,7 +424,7 @@ For a paced propagation lesson, return to .. rst-class:: sphx-glr-timing - **Total running time of the script:** (0 minutes 2.357 seconds) + **Total running time of the script:** (0 minutes 1.800 seconds) .. _sphx_glr_download_auto_tutorials_waveguides_plot_06_graded_index.py: diff --git a/docs/auto_tutorials/waveguides/plot_06_graded_index.zip b/docs/auto_tutorials/waveguides/plot_06_graded_index.zip index 10a49a985c3bc59cee84c0192766a6951f9f3096..110675b478296c8195ad51503fadfab92f34d879 100644 GIT binary patch delta 396 zcmeBK&iH60qjZ2bGm8iV2()Sx#9Hwly6dCNzyQMHlRqd)Y&8BVn4{pRP*j@7rL2&e zmr|^dSfY?wQml|(l$oMltdNtMmtK;gqfnd=7gZ=u%q_@C1*$AoD9K1wNH5JyNd+oR z$xP8vNGi?DDN#tvF9Jycjm*qVOwY_qhnl0uHCfL}eR6=1(d3KVVr&q@C%@*_+}tJ< zDZmGEV)GZ4@-_nohBkxEZ}c0{{T$GRgn| diff --git a/docs/tutorials/free_space/plot_08_radial_capillary_coupling.py b/docs/tutorials/free_space/plot_08_radial_capillary_coupling.py index 57c14a8bf..019aee432 100644 --- a/docs/tutorials/free_space/plot_08_radial_capillary_coupling.py +++ b/docs/tutorials/free_space/plot_08_radial_capillary_coupling.py @@ -41,6 +41,7 @@ from scipy.special import j0, jn_zeros from solprop import fourier +from solprop.boundaries import DEFAULT_BOUNDARY_N, absorber from solprop.constants import EPS0, C from solprop.coupling import CouplingModel, couple from solprop.driver import Simulation, SimulationSettings @@ -276,13 +277,20 @@ # mode *m*, in its native true-power metric, over the incident energy of the # whole entrance plane in the coupling's common measure. +# The capillary's grid samples as the gap's does -- a launch is bound to its +# lattice -- and is built for the capillary's own 5 mm, since a run ends at its +# grid's length; its collar keeps the rate the gap's 20 mm grid gives. +capillary_grid = EnvelopeGrid.from_limits( + LENGTH, WAVELENGTH, (500e-9, 1.4e-6), 300e-15, thg=False +) capillary = Simulation.from_capillary( RADIUS, LENGTH, "Ar", PRESSURE, wavelength=WAVELENGTH, - grid=grid, + grid=capillary_grid, + absorber=absorber(capillary_grid, boundary_length=GAP / DEFAULT_BOUNDARY_N), envelope=True, fwhm=FWHM, energy=energy, diff --git a/docs/tutorials/waveguides/plot_05_general_modal.py b/docs/tutorials/waveguides/plot_05_general_modal.py index 3c7de1643..c47c832df 100644 --- a/docs/tutorials/waveguides/plot_05_general_modal.py +++ b/docs/tutorials/waveguides/plot_05_general_modal.py @@ -23,6 +23,7 @@ import numpy as np from solprop import fourier +from solprop.boundaries import DEFAULT_BOUNDARY_N, absorber from solprop.constants import C from solprop.driver import prop_gnlse, prop_waveguide from solprop.grid import EnvelopeGrid, FieldGrid @@ -44,13 +45,14 @@ route: it is the explicit in-stage temporal collar (see "Boundaries" in the model documentation), whose rate is set by the length the *grid* was built for, and whose stable step is set -by that rate. A general modal step is expensive, so this example builds its -grids for a millimetre -- a gentle collar -- and propagates twenty microns of it, -to stay inside the documentation build's budget. +by that rate. A general modal step is expensive, so this example propagates +twenty microns -- a run ends at its grid's length, so its grids are built for +twenty microns -- and keeps the collar a millimetre's grid would have, a gentle one, +through ``boundary_length``, to stay inside the documentation build's budget. """ WINDOW_LENGTH = 1e-3 -"""Length the grids and their collar are declared for, m.""" +"""Length the collar's rate is declared for, m.""" N2 = 2.6e-20 CHI3 = chi3_from_n2(N2, 1.45) @@ -154,18 +156,26 @@ "dz_init": LENGTH / 10, } channel = guide.mode_collection.modes[0] +# The runs' grids sample as the guide's did, over the twenty microns they propagate, +# with the collar of a millimetre. +run_grid = FieldGrid.from_limits(LENGTH, 835e-9, (790e-9, 890e-9), 200e-15) +run_envelope_grid = EnvelopeGrid.from_limits(LENGTH, 835e-9, (790e-9, 890e-9), 200e-15) +gentle = WINDOW_LENGTH / DEFAULT_BOUNDARY_N +field = {"grid": run_grid, "absorber": absorber(run_grid, boundary_length=gentle)} +envelope = { + "grid": run_envelope_grid, + "absorber": absorber(run_envelope_grid, boundary_length=gentle), +} runs = { "general": prop_waveguide( - (), LENGTH, provider=guide, grid=grid, kerr_form="analytic", **common + (), LENGTH, provider=guide, kerr_form="analytic", **field, **common ), "general, linear": prop_waveguide( - (), LENGTH, provider=linear_guide, grid=grid, kerr_form="analytic", **common - ), - "gnlse": prop_gnlse( - gamma, LENGTH, grid=envelope_grid, fibre=channel, shock=True, **common + (), LENGTH, provider=linear_guide, kerr_form="analytic", **field, **common ), + "gnlse": prop_gnlse(gamma, LENGTH, fibre=channel, shock=True, **envelope, **common), "gnlse, linear": prop_gnlse( - 0.0, LENGTH, grid=envelope_grid, fibre=channel, shock=True, **common + 0.0, LENGTH, fibre=channel, shock=True, **envelope, **common ), } diff --git a/docs/tutorials/waveguides/plot_06_graded_index.py b/docs/tutorials/waveguides/plot_06_graded_index.py index 28f26416d..91c85eb6e 100644 --- a/docs/tutorials/waveguides/plot_06_graded_index.py +++ b/docs/tutorials/waveguides/plot_06_graded_index.py @@ -112,12 +112,14 @@ # A continuous wave in both channels at once, propagated to that length in ten # steps. One coarse bin is exactly periodic on the time window, so the beat is # the two channels' relative phase and nothing else. A wave that fills the window -# wants neither the temporal collar nor the watch on the window's edges. +# wants neither the temporal collar nor the watch on the window's edges. A run +# ends at its grid's length, so its grid samples as the guide's did, built for the +# imaging length. simulation = Simulation.from_waveguide( (), length, provider=guide, - grid=grid, + grid=FieldGrid.from_limits(length, WAVELENGTH, (1.0e-6, 1.06e-6), 100e-15), wavelength=WAVELENGTH, fwhm=40e-15, energy=1e-15, From 690bca25a6771ea114ba6b836d77dae206af370a Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 06:57:28 +0000 Subject: [PATCH 18/20] Drop an interior-launch check that adoption makes unreachable; cover the rest Every caller passes settings the setter has already adopted, which refuses an out-of-range initial_z and keeps every plane after it, so the check could no longer fire. Tests cover printing unadopted counts and a recipe refusal that is not about the planes keeping its own type. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- src/solprop/driver/inputs.py | 12 +++--------- tests/driver/test_save_planes.py | 10 ++++++++++ tests/recipe/test_save_planes.py | 10 +++++++++- 3 files changed, 22 insertions(+), 10 deletions(-) diff --git a/src/solprop/driver/inputs.py b/src/solprop/driver/inputs.py index 05093d9ec..296c789b0 100644 --- a/src/solprop/driver/inputs.py +++ b/src/solprop/driver/inputs.py @@ -117,17 +117,11 @@ def _check_initial_position( """Validate an absolute launch before translation can normalize its field. - ``simulation``: declared optical input, grid and absolute launch position in m. + + The position itself, finite, nonnegative and before the end, with every plane + after it, is already checked where the settings were adopted (SEP 51). """ z = simulation.initial_z - if ( - not np.isfinite(z) - or z < 0 - or z >= simulation.grid.length - or np.any(np.asarray(settings.save_planes) <= z) - ): - raise DriverError( - "initial_z must be finite, nonnegative and before every save plane" - ) if z == 0: return if ( diff --git a/tests/driver/test_save_planes.py b/tests/driver/test_save_planes.py index bf7321b8d..96a1b4906 100644 --- a/tests/driver/test_save_planes.py +++ b/tests/driver/test_save_planes.py @@ -105,6 +105,16 @@ def test_a_malformed_selector_is_refused_by_name_with_its_fix(given, match): ) +@pytest.mark.parametrize( + ("selectors", "shown"), + [({"n_save": 5}, "5 planes"), ({}, f"{DEFAULT_N_SAVE} planes (default)")], + ids=["count", "default"], +) +def test_unadopted_settings_print_their_count(selectors, shown): + settings = SimulationSettings(dz_max=1e-3, dz_init=1e-4, **selectors) + assert settings._planes_text() == shown + + def test_both_selectors_name_how_to_carry_a_count(): with pytest.raises(DriverError, match=r"dataclasses\.replace\(settings, n_save=N"): settings(save_planes=[], n_save=2) diff --git a/tests/recipe/test_save_planes.py b/tests/recipe/test_save_planes.py index c76479d87..eaa270b45 100644 --- a/tests/recipe/test_save_planes.py +++ b/tests/recipe/test_save_planes.py @@ -23,7 +23,7 @@ from recipe.test_recipe import GNLSE from solprop.driver import Simulation from solprop.driver import settings as settings_module -from solprop.exceptions import MaterialRangeWarning +from solprop.exceptions import DriverError, MaterialRangeWarning from solprop.output.hdf5 import open_file from solprop.recipe import Recipe, RecipeError, provenance @@ -79,6 +79,14 @@ def test_an_object_route_recipe_refuses_what_the_driver_refuses(selector, match, assert [issue.parameter for issue in errors] == [path] +def test_another_refusal_of_the_settings_keeps_its_own_type(): + # Only the refusals SEP 51 states become the recipe's; any other stays the driver's. + recipe = radial(f"{LISTED}\nnode_budget = -1") + with pytest.raises(DriverError, match="node_budget must be a positive") as refused: + recipe.build() + assert not isinstance(refused.value, RecipeError) + + def test_a_keyword_route_recipe_refuses_an_integer_save_planes(): with pytest.raises(RecipeError, match="write n_save = 80") as refused: Recipe.loads(GNLSE.replace("n_save = 3", "save_planes = 80")).build() From e0e1a976826991f6a3a2ba32a0e162b4cc0c46b3 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 08:10:43 +0000 Subject: [PATCH 19/20] Give the scaffold's n_save SEP 51's meaning; poll the heartbeat test propagate_fixed_rk4's n_save now counts evenly spaced planes over [0, z_end] with both ends included, at least 2, as on every Simulation route; n_steps must be a multiple of n_save - 1. The SEP records the maintainer's settlement of Q8 (length stays positional-or-keyword) and Q9 (this change). test_a_quiet_run_still_beats polls read_status to a deadline instead of reading once after a fixed sleep, which a loaded Windows runner missed. Closes #856 Closes #664 Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- changelog.d/856-scaffold-n-save.changed.md | 4 ++ docs/dev/seps/archive/sep-0051-save-planes.md | 14 ++++--- src/solprop/driver/scaffold.py | 37 ++++++++++++------- tests/driver/test_scaffold.py | 8 ++-- tests/service/test_record.py | 8 +++- 5 files changed, 46 insertions(+), 25 deletions(-) create mode 100644 changelog.d/856-scaffold-n-save.changed.md diff --git a/changelog.d/856-scaffold-n-save.changed.md b/changelog.d/856-scaffold-n-save.changed.md new file mode 100644 index 000000000..0a4897740 --- /dev/null +++ b/changelog.d/856-scaffold-n-save.changed.md @@ -0,0 +1,4 @@ +`solprop.driver.scaffold.propagate_fixed_rk4`'s `n_save` now means what it means on every +`Simulation` route: the number of evenly spaced saved planes over `[0, z_end]`, both ends +included, at least 2 (default 2). `n_steps` must be a multiple of `n_save - 1`. A call +that passed `n_save=4` now passes `n_save=5` for the same planes (#856). diff --git a/docs/dev/seps/archive/sep-0051-save-planes.md b/docs/dev/seps/archive/sep-0051-save-planes.md index 3e56f622a..aed71aaae 100644 --- a/docs/dev/seps/archive/sep-0051-save-planes.md +++ b/docs/dev/seps/archive/sep-0051-save-planes.md @@ -626,9 +626,8 @@ That count is what decided the first deviation below. **Deviations from the proposal.** 1. *`length` is optional but stays positional-or-keyword* (§5.1, Q7 item 6). Making it - keyword-only would edit about 509 calls in 227 files and regenerate 43 galleries. This - is an interim choice, pending with the maintainer; the signature - change is one commit, so the keyword-only form can follow as one mechanical commit. + keyword-only would edit about 509 calls in 227 files and regenerate 43 galleries. The + maintainer accepted this deviation on 2026-11-16, so the positional form stays. Because Python allows no required parameter after an optional one, `from_capillary`'s and `prop_capillary`'s `gas` now defaults to `None` and is refused when omitted. A hazard for the keyword-only form: with `length` keyword-only, the next @@ -685,9 +684,10 @@ coverage lane, `native/tests`, the front-end gate and the galleries; CI is the g **Open questions.** - Q8: keyword-only `length` (deviation 1), with the slide of `betas`/`gas` into its - slot. Owner: the maintainer. -- Q9: `driver/scaffold.py`'s fixed-step tool has its own `n_save`, which does not count - the entrance; it is a separate tool and left unchanged. Owner: the maintainer. + slot. Settled by the maintainer: `length` stays positional-or-keyword. +- Q9: `driver/scaffold.py`'s fixed-step tool had its own `n_save`, which did not count + the entrance. Settled by the maintainer: it now takes SEP 51's meaning, evenly spaced + planes over `[0, z_end]` with both ends counted, at least 2. - Q10: whether the loss clamp and the monitor spacing should follow a pinned reference length, as the absorber's does. Owner: an issue. @@ -789,6 +789,8 @@ estimated about 60 lines removed plus the new field and its tests. deviation on keyword-only `length` pending with the maintainer. - 2026-11-16: Phase 2 (front end) reported in Part II, on `feature/sep-0051-gui`. - 2026-11-16: Final. Both phases are reported in Part II and merge in PR #851. Open questions moved to issues: keyword-only `length` ([#857](https://github.com/LupoLab/solprop/issues/857)), the fixed-step scaffold's `n_save` ([#856](https://github.com/LupoLab/solprop/issues/856)) and further length-dependent defaults ([#855](https://github.com/LupoLab/solprop/issues/855)). +- 2026-11-16: The maintainer settled Q8 (`length` stays positional-or-keyword) and Q9 + (the scaffold's `n_save` takes SEP 51's meaning, in PR #851). ### AI review — 2026-11-15 diff --git a/src/solprop/driver/scaffold.py b/src/solprop/driver/scaffold.py index 79de04647..71c8cc03e 100644 --- a/src/solprop/driver/scaffold.py +++ b/src/solprop/driver/scaffold.py @@ -128,7 +128,7 @@ def propagate_fixed_rk4( z_end: float, n_steps: int, *, - n_save: int = 1, + n_save: int = 2, ) -> tuple[Float[np.ndarray, " n_z"], Complex[np.ndarray, "n_z n_omega"]]: """Propagate a mode-averaged envelope spectrum with fixed-step IP-RK4. @@ -160,15 +160,17 @@ def propagate_fixed_rk4( z_end : float Propagation length, m, positive. n_steps : int - Number of equal steps, at least 1 and a multiple of ``n_save``. + Number of equal steps, at least 1 and a multiple of ``n_save - 1``. n_save : int, optional - Number of planes to save after ``z = 0``, at least 1. Default 1: the end only. + Number of evenly spaced planes to save over ``[0, z_end]``, both ends included, + as on every :class:`~solprop.driver.simulation.Simulation` route; at least 2. + Default 2: the entrance and the end. Returns ------- tuple - ``(z, spectra)``: the saved positions, shape ``(n_save + 1,)``, m, starting at - zero; and the stored spectra there, shape ``(n_save + 1, n_omega)``. + ``(z, spectra)``: the saved positions, shape ``(n_save,)``, m, from zero to + ``z_end``; and the stored spectra there, shape ``(n_save, n_omega)``. Raises ------ @@ -176,8 +178,8 @@ def propagate_fixed_rk4( If the grid is not an envelope grid, or the spectrum does not match it. StepperError If the fibre varies along z, ``z_end`` is not positive and finite, - ``n_steps`` or ``n_save`` is below 1, or ``n_steps`` is not a multiple of - ``n_save``. + ``n_steps`` is below 1, ``n_save`` is below 2, or ``n_steps`` is not a + multiple of ``n_save - 1``. Examples -------- @@ -221,19 +223,26 @@ def propagate_fixed_rk4( if n_steps < 1: msg = f"n_steps must be at least 1, got {n_steps!r}" raise StepperError(msg) - if n_save < 1: - msg = f"n_save must be at least 1, got {n_save!r}" + if n_save < 2: + msg = ( + "n_save counts the saved planes, both ends included, so it must be at " + f"least 2, got {n_save!r}" + ) raise StepperError(msg) - if n_steps % n_save: - msg = f"n_steps ({n_steps}) must be a multiple of n_save ({n_save})" + intervals = n_save - 1 + if n_steps % intervals: + msg = ( + f"n_steps ({n_steps}) must be a multiple of n_save - 1 ({intervals}), the " + "number of intervals between saved planes" + ) raise StepperError(msg) operator = dispersion_operator(problem.mode, grid, Frame.comoving(grid)) step = z_end / n_steps half = np.exp(0.5 * step * operator) - per_save = n_steps // n_save + per_save = n_steps // intervals state = values * grid.active_mask - saved = np.empty((n_save + 1, grid.n_omega), dtype=np.complex128) + saved = np.empty((n_save, grid.n_omega), dtype=np.complex128) saved[0] = state logger.debug( "scaffold IP-RK4: %d steps of %.6e m over %.6e m, saving %d planes", @@ -252,4 +261,4 @@ def propagate_fixed_rk4( state = state + step / 6.0 * k4 if (index + 1) % per_save == 0: saved[(index + 1) // per_save] = state - return np.linspace(0.0, z_end, n_save + 1), saved + return np.linspace(0.0, z_end, n_save), saved diff --git a/tests/driver/test_scaffold.py b/tests/driver/test_scaffold.py index 8c8deedbc..e2d4e45dc 100644 --- a/tests/driver/test_scaffold.py +++ b/tests/driver/test_scaffold.py @@ -70,7 +70,7 @@ def test_the_fundamental_soliton_is_stationary_with_its_phase(grid, problem): def test_saving_planes_does_not_change_the_steps(grid, problem): initial = soliton(grid, 1) z, spectra = propagate_fixed_rk4( - problem, grid, initial, DISPERSION_LENGTH, 40, n_save=4 + problem, grid, initial, DISPERSION_LENGTH, 40, n_save=5 ) _, direct = propagate_fixed_rk4(problem, grid, initial, DISPERSION_LENGTH, 40) np.testing.assert_allclose(z, np.linspace(0.0, DISPERSION_LENGTH, 5)) @@ -148,11 +148,11 @@ def test_the_scaffold_rejects_a_spectrum_of_the_wrong_shape(grid, problem): ({"z_end": 0.0}, "z_end must be positive"), ({"z_end": math.inf}, "z_end must be positive"), ({"n_steps": 0}, "n_steps must be at least 1"), - ({"n_save": 0}, "n_save must be at least 1"), - ({"n_steps": 10, "n_save": 3}, "must be a multiple of n_save"), + ({"n_save": 1}, "must be at least 2"), + ({"n_steps": 10, "n_save": 4}, r"must be a multiple of n_save - 1 \(3\)"), ], ) def test_the_scaffold_rejects_a_bad_request(grid, problem, overrides, message): - request = {"z_end": 1.0, "n_steps": 10, "n_save": 1} | overrides + request = {"z_end": 1.0, "n_steps": 10, "n_save": 2} | overrides with pytest.raises(ValueError, match=message): propagate_fixed_rk4(problem, grid, soliton(grid, 1), **request) diff --git a/tests/service/test_record.py b/tests/service/test_record.py index 040756b61..134485a77 100644 --- a/tests/service/test_record.py +++ b/tests/service/test_record.py @@ -99,8 +99,14 @@ def test_progress_is_kept_on_a_period_and_the_summary_has_the_latest( def test_a_quiet_run_still_beats(tmp_path, monkeypatch): monkeypatch.setattr(record, "HEARTBEAT", 0.05) log = EventLog(tmp_path, "r1") - time.sleep(0.3) + # Poll to a generous deadline rather than read once after a fixed sleep: a loaded + # runner can delay the writer thread, and on Windows a read that meets the summary's + # atomic replace fails and reads as no summary (issue #664). + deadline = time.monotonic() + 10.0 status = read_status(tmp_path) + while status is None and time.monotonic() < deadline: + time.sleep(0.05) + status = read_status(tmp_path) log.close() assert status is not None and status["run_id"] == "r1" From 13b9f219fd1e76b1d0c938dc9e5adaeaff78a494 Mon Sep 17 00:00:00 2001 From: John Travers Date: Mon, 16 Nov 2026 10:34:50 +0000 Subject: [PATCH 20/20] Read the corpus case's length from save planes typed as optional Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01XGENPwwkUUG9KSAwneHjgH --- tests/backend_corpus_cases.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/backend_corpus_cases.py b/tests/backend_corpus_cases.py index 09fe2d42c..48d8d275d 100644 --- a/tests/backend_corpus_cases.py +++ b/tests/backend_corpus_cases.py @@ -328,7 +328,7 @@ def general_modal( One HE11 channel of a 1.5 um strand with a Kerr core, over the catalogue's 0.2 mm. """ simulation = general_constant(None) - length = float(simulation.settings.save_planes[-1]) + length = float(np.asarray(simulation.settings.save_planes)[-1]) planes = (length / 2, length) schedule = _schedule(length, planes[:1]) simulation.settings = dataclasses.replace(