pyflightstream 0.41.0__tar.gz → 0.43.0__tar.gz

{pyflightstream-0.41.0/src/pyflightstream.egg-info → pyflightstream-0.43.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyflightstream
-Version: 0.41.0
+Version: 0.43.0
 Summary: Version-aware, didactic Python driver for the FlightStream panel-method solver
 Author: Geovana Neves
 License: MIT
@@ -33,7 +33,7 @@ Requires-Dist: PyNiteFEA>=3.0; extra == "fsi"
 Provides-Extra: excel
 Requires-Dist: XlsxWriter<4,>=3.2.9; extra == "excel"
 Provides-Extra: manual
-Requires-Dist: pypdf; extra == "manual"
+Requires-Dist: pypdf>=4.0.0; extra == "manual"
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: packaging; extra == "dev"
@@ -60,8 +60,7 @@ Version-aware Python driver for the FlightStream panel-method solver: write a
 run matrix, and pyflightstream plans, runs and post-processes every point,
 from your workstation or a cluster. MIT licensed.
 
-This source tree contains 0.41.0; CHANGELOG.md describes its changes and the
-retained release history.
+CHANGELOG.md describes package changes and the retained release history.
 Use the [upgrade guidance](https://nevesgeovana.github.io/pyflightstream/upgrading/)
 when moving an existing workspace to a newer package version.
 
@@ -91,9 +90,14 @@ matrix  ->  plan  ->  run  ->  collect  ->  post  ->  products
 ## Install
 
 ```
-pip install "pyflightstream[geom,fsi,plot,excel]"
+pip install "pyflightstream[dev,plot,geom,fsi,excel]"
 ```
 
+The extras add development and documentation tools (`dev`), plotting (`plot`),
+spatial geometry queries (`geom`), structural coupling (`fsi`) and workbook
+authoring (`excel`). Maintainers reading licensed manuals also install
+`pyflightstream[manual]`.
+
 Python 3.12 or newer. FlightStream itself is licensed separately and is
 located through your workspace, never guessed.
 
@@ -140,19 +144,19 @@ and the evidence behind it is narrower than for the supported rows.
 
 ## Supported FlightStream versions
 
-| Version | Vendor name | Support level |
-|---|---|---|
-| 25.000 | 25.0 | `documented` |
-| 25.100 | 25.1 | `documented` |
-| 26.000 | 26.0 | `documented` |
-| 26.100 | 26.1 | `operational` |
-| 26.101 | 26.1 | `operational` |
-| 26.120 | 26.12 | `operational` |
-| 26.121 | 26.12 | `operational` |
-| 26.122 | 26.12 | `operational` |
-| 26.123 | 26.12 | `operational` |
-| 26.124 | 26.12 | `operational` |
-| 26.125 | 26.12 | `operational` |
+| Version | Vendor name | Support level | Build |
+|---|---|---|---|
+| 25.000 | 25.0 | `documented` | `12162024` |
+| 25.100 | 25.1 | `documented` | `5062025` |
+| 26.000 | 26.0 | `documented` | `10202025` |
+| 26.100 | 26.1 | `operational` | `2122026` |
+| 26.101 | 26.1 | `operational` | `5012026` |
+| 26.120 | 26.12 | `operational` | `7012026` |
+| 26.121 | 26.12 | `operational` | `7262026` |
+| 26.122 | 26.12 | `operational` | `8092026` |
+| 26.123 | 26.12 | `operational` | `8112026` |
+| 26.124 | 26.12 | `operational` | `8172026` |
+| 26.125 | 26.12 | `operational` | `10052026` |
 
 `operational` means the minimal geometry-to-loads workflow builds for that
 version, checked by a test. `documented` describes the database support level;

{pyflightstream-0.41.0 → pyflightstream-0.43.0}/README.md

@@ -8,8 +8,7 @@ Version-aware Python driver for the FlightStream panel-method solver: write a
 run matrix, and pyflightstream plans, runs and post-processes every point,
 from your workstation or a cluster. MIT licensed.
 
-This source tree contains 0.41.0; CHANGELOG.md describes its changes and the
-retained release history.
+CHANGELOG.md describes package changes and the retained release history.
 Use the [upgrade guidance](https://nevesgeovana.github.io/pyflightstream/upgrading/)
 when moving an existing workspace to a newer package version.
 
@@ -39,9 +38,14 @@ matrix  ->  plan  ->  run  ->  collect  ->  post  ->  products
 ## Install
 
 ```
-pip install "pyflightstream[geom,fsi,plot,excel]"
+pip install "pyflightstream[dev,plot,geom,fsi,excel]"
 ```
 
+The extras add development and documentation tools (`dev`), plotting (`plot`),
+spatial geometry queries (`geom`), structural coupling (`fsi`) and workbook
+authoring (`excel`). Maintainers reading licensed manuals also install
+`pyflightstream[manual]`.
+
 Python 3.12 or newer. FlightStream itself is licensed separately and is
 located through your workspace, never guessed.
 
@@ -88,19 +92,19 @@ and the evidence behind it is narrower than for the supported rows.
 
 ## Supported FlightStream versions
 
-| Version | Vendor name | Support level |
-|---|---|---|
-| 25.000 | 25.0 | `documented` |
-| 25.100 | 25.1 | `documented` |
-| 26.000 | 26.0 | `documented` |
-| 26.100 | 26.1 | `operational` |
-| 26.101 | 26.1 | `operational` |
-| 26.120 | 26.12 | `operational` |
-| 26.121 | 26.12 | `operational` |
-| 26.122 | 26.12 | `operational` |
-| 26.123 | 26.12 | `operational` |
-| 26.124 | 26.12 | `operational` |
-| 26.125 | 26.12 | `operational` |
+| Version | Vendor name | Support level | Build |
+|---|---|---|---|
+| 25.000 | 25.0 | `documented` | `12162024` |
+| 25.100 | 25.1 | `documented` | `5062025` |
+| 26.000 | 26.0 | `documented` | `10202025` |
+| 26.100 | 26.1 | `operational` | `2122026` |
+| 26.101 | 26.1 | `operational` | `5012026` |
+| 26.120 | 26.12 | `operational` | `7012026` |
+| 26.121 | 26.12 | `operational` | `7262026` |
+| 26.122 | 26.12 | `operational` | `8092026` |
+| 26.123 | 26.12 | `operational` | `8112026` |
+| 26.124 | 26.12 | `operational` | `8172026` |
+| 26.125 | 26.12 | `operational` | `10052026` |
 
 `operational` means the minimal geometry-to-loads workflow builds for that
 version, checked by a test. `documented` describes the database support level;

{pyflightstream-0.41.0 → pyflightstream-0.43.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyflightstream"
-version = "0.41.0"
+version = "0.43.0"
 description = "Version-aware, didactic Python driver for the FlightStream panel-method solver"
 readme = "README.md"
 license = {text = "MIT"}
@@ -19,10 +19,10 @@ authors = [{name = "Geovana Neves"}]
 # (2025-06-05) are the oldest of theirs still inside it. Until then the
 # window was chosen (">=3.11" since the first release, no floor on the
 # numerical dependencies), and a user reading it could not know how it
-# would move. tests/tier1_offline/test_support_window.py re-derives the
-# floors from the release dates and the date above, so moving one is a
-# commit that moves the date with it. The CI matrices, the ruff target and
-# the classifiers below follow this line.
+# would move. The floors are derived by hand from the release dates and the
+# date above, and moving one is a commit that moves the date with it; no test
+# re-derives them from the release dates. tests/tier1_offline/test_support_window.py
+# holds the CI matrices, the ruff target and the classifiers below to this line.
 requires-python = ">=3.12"
 # PyPA well-known metadata (audit 2026-07-23). The SPDX license
 # expression form is deferred with the VCS-versioning item: it needs a
@@ -63,13 +63,14 @@ classifiers = [
 # BOTH ENDS ARE PINNED DELIBERATELY. The floor is the oldest release this
 # package has been exercised against, and the ceiling excludes the next
 # major, which is a boundary this repository has no evidence about; a new
-# install resolves 5.0.0 today. tests/tier1_offline/test_extras.py holds the installed
-# version inside the declared range, so the envelope is a measurement rather
-# than a hope.
+# install resolves 5.0.0 today. tests/tier1_offline/test_support_window.py holds
+# the installed version of each declared dependency inside its declared range,
+# so the envelope is a measurement rather than a hope.
 #
 # numpy and pandas carry the SPEC 0 floor computed on 2026-09-09 (see
 # requires-python above); neither is above the version this tree runs
-# with, which tests/tier1_offline/test_support_window.py measures. pydantic
+# with, which the same test measures. The CI leg `test-floors` installs the
+# numpy and pandas floors themselves and runs tier 1 on them. pydantic
 # is not a SPEC 0 project: its floor is the major whose API this package
 # is written against (field_validator, model_validator).
 dependencies = [
@@ -99,8 +100,9 @@ excel = ["XlsxWriter>=3.2.9,<4"]
 # Reading a vendor manual pdf, for pyflightstream.utils.manual. A
 # MAINTAINER extra: no run path imports it, and the manual it reads is
 # licensed material that never enters Git. pypdf is BSD-3-Clause,
-# MIT-compatible (NFR-02).
-manual = ["pypdf"]
+# MIT-compatible (NFR-02). The floor is 4.0.0, the first release whose extract_text takes
+# extraction_mode="layout"; 3.17.4, the last 3.x, does not.
+manual = ["pypdf>=4.0.0"]
 dev = [
     # Licence evidence for every distribution in this block:
     # reports/RPT-033_development-tool-licences_2026-08-19.md, one card
@@ -113,10 +115,10 @@ dev = [
     # the edge would turn a guard into a collection error. Apache-2.0 and
     # BSD-2-Clause dual, MIT-compatible.
     "packaging",
-    # The coverage floor of NFR-16, enforced by the CI `coverage` job.
+    # The coverage floor is enforced by the release's frozen full suite.
     # Not in pytest's addopts: instrumentation costs about a third of the
     # suite's runtime and a developer running one test file does not need
-    # a whole-package number. The job passes --cov explicitly.
+    # a whole-package number. The suite-full receipt passes --cov explicitly.
     "pytest-cov",
     # Parallel tier 1: CI and the release gates run `pytest -n auto`, in place
     # of a serial run of about 36 minutes, the 0.33.0 release gate's serial
@@ -208,7 +210,9 @@ markers = [
 ]
 addopts = "-m 'not needs_flightstream'"
 
-# NFR-16, the test-coverage floor. The requirement states the rule and
+# The test-coverage floor, enforced by the release's frozen full suite.
+# The suite-full receipt passes --cov; push CI does not measure coverage.
+# The requirement states the rule and
 # deliberately does NOT state the number: it lives here, where the tool that
 # enforces it reads it, so raising the floor is one edit rather than two
 # statements drifting apart.
@@ -226,7 +230,7 @@ branch = true
 # The floor is set BELOW that, on purpose and twice over. It is a ratchet
 # against regression rather than a target to be gamed, so the measurement is
 # the fact and this is the promise; and the measurement above was taken on
-# Windows while the floor is enforced on Linux, where the Windows-only
+# Windows while the original CI floor ran on Linux, where the Windows-only
 # branches count as uncovered. Four points absorbs both. Raise it when the
 # suite earns it, in a commit that says so.
 fail_under = 87

{pyflightstream-0.41.0 → pyflightstream-0.43.0}/src/pyflightstream/__init__.py

@@ -18,23 +18,17 @@ Pipeline layers, dependencies flowing strictly downward:
 - ``results``: anchor-based parsers for solver output files.
 - ``cases``: simulation and campaign definitions.
 - ``workspace``: the managed workspace (input-artifact library plus run
-  layout) and the run manifest. The old ``files`` name was a
-  deprecation shim and was removed at v0.4.0.
-- ``run``: execution and the campaign loop, one row above ``workspace``
-  since 0.33.0: ``run`` imports ``workspace``, and nothing of
+  layout) and the run manifest.
+- ``run``: execution and the campaign loop, one row above ``workspace``: ``run`` imports
+``workspace``, and nothing of
   ``workspace`` imports ``run``.
 - ``post``: results into engineering data (sweep assembly, exports).
 - ``qa``: probe harness and physics regression tooling.
 
-Since 0.33.0 the largest modules are packages or facades over
-private modules: ``cases.workflows`` is a package whose modules import
-one another in a declared order, the roots of ``run`` and ``results``
-and the module ``post.products`` keep every public name over modules
-of their own, and every public name of 0.32.0 still imports from its
-0.32.0 path. Tier-1 architecture guards hold module size, function
-limits, import cycles, fan-out, private-name coupling of the tests,
-one home per constant and facade roots to ratchets that only fall,
-measured by ``scripts/arch_metrics.py``.
+The largest modules are packages or facades over private modules. Public import paths remain
+available through the facades. Tier-1 architecture guards ratchet module size, function
+limits, import cycles, fan-out, private-name coupling and shared constants, measured by
+``scripts/arch_metrics.py``.
 
 Side packages follow the same downward-only rule:
 
@@ -91,8 +85,8 @@ except metadata.PackageNotFoundError:
 import pyflightstream.post  # noqa: E402, F401
 
 # The run records register, the same way, the rebuild a restoring sync asks
-# for (P0320-SYNC-RESTORE-OPTIN): the storage layer sits BELOW the run since
-# 0.33.0 (AD-09) and calls whatever is registered, so no import points upward.
+# for (P0320-SYNC-RESTORE-OPTIN): the storage layer sits BELOW the run layer
+# (AD-09) and calls whatever is registered, so no import points upward.
 import pyflightstream.run.records  # noqa: E402, F401
 from pyflightstream._cli import cli_entrypoint as cli_entrypoint  # noqa: E402
 from pyflightstream.options import (  # noqa: E402

pyflightstream-0.43.0/src/pyflightstream/_atmosphere.py

@@ -0,0 +1,280 @@
+"""The standard atmosphere, below every pipeline layer (PFS-2027.03).
+
+This module computes atmospheric properties and imports only the package's
+base exception. Flight-condition resolution belongs to workspace, where a
+reference is available for Reynolds constraints. The script layer emits
+AIR_ALTITUDE or explicit fluid properties; this module emits no commands.
+
+AIR_ALTITUDE has no ISA-deviation argument. Conditions carrying dISA and
+conditions solved from density therefore need explicit fluid properties.
+The command is recorded broken on builds 26.100, 26.101 and 26.120. Only the
+26.120 evidence quantifies the discrepancy: density 1.056 against 0.736
+expected, consistent with the 5000-foot rather than 5000-metre standard state
+(RPT-014, build 7012026). On 26.100 and 26.101 the probe records absence of
+the expected effect, not its cause. A static effect_note is not a per-run
+reading. The emitter refuses a broken command unless allow_broken is set;
+on 25.000 AIR_ALTITUDE takes a bare value in feet. Explicit properties avoid
+these build-dependent command limitations.
+
+An ISA deviation changes temperature at unchanged pressure altitude and
+pressure. Density follows from the offset temperature. delta_isa_c is a
+temperature difference, with the same numerical value in Celsius and Kelvin.
+The model describes the standard atmosphere, not local weather, and refuses
+altitudes outside ISA's modeled layers instead of extrapolating.
+
+Atmosphere constants follow ISO 2533:1975, also published as ICAO Doc 7488/3
+[REF-01]. Sutherland's viscosity law uses the air coefficients attributed to
+White, Viscous Fluid Flow, third edition, equation (1-36) [REF-02].
+METRES_PER_FOOT is the exact defining value of the international foot.
+
+The viscosity attribution has an unresolved limitation: the cited book is
+not available in this repository. The implemented reference temperature and
+Sutherland constant are 273.15 K and 110.4 K. A 273 K / 111 K triplet commonly
+attributed to the equation gives different results: about 0.0492 percent
+at sea level, 0.0536 percent at 300 K and 0.0164 percent at the tropopause.
+The difference propagates into density solved on the REmi path. Resolving
+which triplet belongs to the cited equation requires the source.
+
+The atmosphere tests pin viscosity with rel=1e-4 at three temperatures.
+The alternative triplet differs by 1.64e-4 at 216.65 K, 3.59e-4 at 255.65 K
+and 5.36e-4 at 300 K, exceeding that tolerance at all three points.
+"""
+
+from __future__ import annotations
+
+import math
+from dataclasses import dataclass
+from typing import Final
+
+from pyflightstream._errors import PyflightstreamError
+
+
+class AtmosphereError(PyflightstreamError, ValueError):
+    """An atmosphere was asked for outside the range this module models.
+
+    Catalogued (SRS FR-39) rather than a bare :class:`ValueError`, so a
+    caller can tell a refusal of this package's from one of Python's.
+    """
+
+
+@dataclass(frozen=True)
+class IsaConstants:
+    """Hold the defining constants of ISO 2533:1975 [REF-01], in one citable object.
+
+    Held as data rather than as module-level names so that a test can
+    read the values it is checking out of the same object the physics
+    uses. A test that restates a constant proves the restatement.
+    """
+
+    #: Sea-level temperature, K.
+    sea_level_temperature_k: float = 288.15
+    #: Sea-level pressure, Pa.
+    sea_level_pressure_pa: float = 101325.0
+    #: Specific gas constant of dry air, J/(kg K).
+    gas_constant_j_per_kg_k: float = 287.05287
+    #: Ratio of specific heats of dry air, dimensionless.
+    heat_capacity_ratio: float = 1.4
+    #: Standard gravity, m/s2.
+    gravity_m_per_s2: float = 9.80665
+    #: Troposphere temperature lapse rate, K/m (a DECREASE with height).
+    lapse_rate_k_per_m: float = 0.0065
+    #: Geopotential height of the tropopause, m.
+    tropopause_altitude_m: float = 11000.0
+    #: Temperature of the isothermal layer above the tropopause, K.
+    tropopause_temperature_k: float = 216.65
+    #: The top of what this module models, m. ISO 2533 continues above [REF-01]
+    #: it with layers this module does not implement, so the ceiling is
+    #: a refusal boundary rather than the end of the standard.
+    ceiling_altitude_m: float = 20000.0
+    #: The bottom, m. ISO 2533 is defined from -2000 m. [REF-01]
+    floor_altitude_m: float = -2000.0
+
+
+#: The single instance every function here reads.
+ISA: Final = IsaConstants()
+
+#: Sutherland's law for air: White, *Viscous Fluid Flow*, 3rd ed., [REF-02]
+#: eq. (1-36). The reference viscosity is at the reference temperature,
+#: and S is the Sutherland constant of air.
+SUTHERLAND_REFERENCE_VISCOSITY_PA_S: Final = 1.716e-5
+SUTHERLAND_REFERENCE_TEMPERATURE_K: Final = 273.15
+SUTHERLAND_CONSTANT_K: Final = 110.4
+
+#: Exactly, by definition of the international foot.
+METRES_PER_FOOT: Final = 0.3048
+
+
+@dataclass(frozen=True)
+class AtmosphereState:
+    """Hold one fully determined air state.
+
+    Every field carries its unit in its name, which is this
+    repository's rule rather than this module's habit.
+    """
+
+    temperature_k: float
+    pressure_pa: float
+    density_kg_m3: float
+    sonic_velocity_m_per_s: float
+    viscosity_pa_s: float
+
+
+def feet_to_metres(altitude_ft: float) -> float:
+    """Convert an altitude in feet to metres.
+
+    Here rather than at the caller because ``ALTFT`` is the interface
+    unit a flight condition is written in and metres are the unit this
+    module works in, so the conversion belongs at the boundary between
+    them and should exist exactly once.
+    """
+    return altitude_ft * METRES_PER_FOOT
+
+
+def _require_finite(name: str, value: float) -> None:
+    """Refuse NaN and infinity, which every comparison below would let through."""
+    if not math.isfinite(value):
+        raise AtmosphereError(f"{name} {value} is not a finite number")
+
+
+def sutherland_viscosity(temperature_k: float) -> float:
+    """Dynamic viscosity of air at ``temperature_k``, in Pa s."""
+    _require_finite("temperature", temperature_k)
+    if temperature_k <= 0.0:
+        raise AtmosphereError(
+            f"temperature {temperature_k} K is not above absolute zero, so "
+            "Sutherland's law has no value there"
+        )
+    ratio = temperature_k / SUTHERLAND_REFERENCE_TEMPERATURE_K
+    return (
+        SUTHERLAND_REFERENCE_VISCOSITY_PA_S
+        * ratio**1.5
+        * (SUTHERLAND_REFERENCE_TEMPERATURE_K + SUTHERLAND_CONSTANT_K)
+        / (temperature_k + SUTHERLAND_CONSTANT_K)
+    )
+
+
+def speed_of_sound(temperature_k: float) -> float:
+    """Speed of sound in dry air at ``temperature_k``, in m/s."""
+    _require_finite("temperature", temperature_k)
+    if temperature_k <= 0.0:
+        raise AtmosphereError(
+            f"temperature {temperature_k} K is not above absolute zero, so the "
+            "speed of sound has no value there"
+        )
+    return math.sqrt(ISA.heat_capacity_ratio * ISA.gas_constant_j_per_kg_k * temperature_k)
+
+
+def density(pressure_pa: float, temperature_k: float) -> float:
+    """Density of dry air from the ideal gas law, in kg/m3."""
+    _require_finite("pressure", pressure_pa)
+    _require_finite("temperature", temperature_k)
+    if pressure_pa <= 0.0:
+        raise AtmosphereError(f"pressure {pressure_pa} Pa is not above zero")
+    if temperature_k <= 0.0:
+        raise AtmosphereError(
+            f"temperature {temperature_k} K is not above absolute zero, so the "
+            "ideal gas law has no density there"
+        )
+    return pressure_pa / (ISA.gas_constant_j_per_kg_k * temperature_k)
+
+
+def standard_pressure(altitude_m: float) -> float:
+    """ISA pressure at a geopotential altitude, in Pa.
+
+    An ISA deviation does NOT appear here, and that is the convention
+    this module exists to make explicit: a deviation moves temperature
+    and leaves the pressure at a pressure altitude alone.
+    """
+    if not ISA.floor_altitude_m <= altitude_m <= ISA.ceiling_altitude_m:
+        raise AtmosphereError(
+            f"altitude {altitude_m} m is outside the range this atmosphere "
+            f"models, {ISA.floor_altitude_m} m to {ISA.ceiling_altitude_m} m. "
+            "ISO 2533 continues above that ceiling with layers this module [REF-01] "
+            "does not implement, and extrapolating past either end of the range "
+            "would be wrong in a way the caller could not see."
+        )
+    exponent = ISA.gravity_m_per_s2 / (ISA.lapse_rate_k_per_m * ISA.gas_constant_j_per_kg_k)
+    if altitude_m <= ISA.tropopause_altitude_m:
+        temperature = ISA.sea_level_temperature_k - ISA.lapse_rate_k_per_m * altitude_m
+        return ISA.sea_level_pressure_pa * (temperature / ISA.sea_level_temperature_k) ** exponent
+    tropopause_pressure = (
+        ISA.sea_level_pressure_pa
+        * (ISA.tropopause_temperature_k / ISA.sea_level_temperature_k) ** exponent
+    )
+    height_above = altitude_m - ISA.tropopause_altitude_m
+    return tropopause_pressure * math.exp(
+        -ISA.gravity_m_per_s2
+        * height_above
+        / (ISA.gas_constant_j_per_kg_k * ISA.tropopause_temperature_k)
+    )
+
+
+def standard_temperature(altitude_m: float) -> float:
+    """ISA temperature at a geopotential altitude, in K, with no deviation."""
+    if not ISA.floor_altitude_m <= altitude_m <= ISA.ceiling_altitude_m:
+        raise AtmosphereError(
+            f"altitude {altitude_m} m is outside the range this atmosphere "
+            f"models, {ISA.floor_altitude_m} m to {ISA.ceiling_altitude_m} m"
+        )
+    if altitude_m <= ISA.tropopause_altitude_m:
+        return ISA.sea_level_temperature_k - ISA.lapse_rate_k_per_m * altitude_m
+    return ISA.tropopause_temperature_k
+
+
+def isa(altitude_m: float = 0.0, *, delta_isa_c: float = 0.0) -> AtmosphereState:
+    """Return the air state at a pressure altitude, with an optional ISA deviation.
+
+    Parameters
+    ----------
+    altitude_m:
+        Geopotential pressure altitude in metres. Defaults to sea level,
+        which is what an absent altitude means in a flight condition.
+    delta_isa_c:
+        Temperature offset from the standard value, in Celsius, applied
+        as a DELTA. Defaults to 0. Pressure is unaffected by it; see the
+        module docstring.
+
+    Raises
+    ------
+    AtmosphereError
+        For an altitude outside the modelled range, a deviation that is
+        NaN or infinite, or a deviation that puts the temperature at or
+        below absolute zero.
+
+    Examples
+    --------
+    >>> state = isa()
+    >>> round(state.temperature_k, 2)
+    288.15
+    >>> round(state.sonic_velocity_m_per_s, 3)
+    340.294
+
+    An ISA deviation moves temperature and density and leaves pressure
+    exactly where it was:
+
+    >>> hot = isa(0.0, delta_isa_c=15.0)
+    >>> hot.pressure_pa == state.pressure_pa
+    True
+    >>> hot.density_kg_m3 < state.density_kg_m3
+    True
+    """
+    _require_finite("delta_isa_c (the ISA deviation, degrees C)", delta_isa_c)
+    pressure = standard_pressure(altitude_m)
+    temperature = standard_temperature(altitude_m) + delta_isa_c
+    if not math.isfinite(temperature):
+        raise AtmosphereError(
+            f"an ISA deviation of {delta_isa_c} C at {altitude_m} m gives a non-finite "
+            f"temperature ({temperature}); the deviation must be a finite number"
+        )
+    if temperature <= 0.0:
+        raise AtmosphereError(
+            f"an ISA deviation of {delta_isa_c} C at {altitude_m} m puts the "
+            f"temperature at {temperature} K, which is not above absolute zero"
+        )
+    return AtmosphereState(
+        temperature_k=temperature,
+        pressure_pa=pressure,
+        density_kg_m3=density(pressure, temperature),
+        sonic_velocity_m_per_s=speed_of_sound(temperature),
+        viscosity_pa_s=sutherland_viscosity(temperature),
+    )

{pyflightstream-0.41.0 → pyflightstream-0.43.0}/src/pyflightstream/_cli.py

@@ -4,12 +4,12 @@ Decorating a console ``main`` preserves its return value and exceptions.
 Only the outermost entry point reports, including argparse's early exits.
 Machine-readable stdout is never used for human outcome reporting.
 
-Every invocation ends with the package's signature on stderr (0.30.0): a box
+Every invocation ends with the package's signature on stderr: a box
 drawn from :mod:`pyflightstream._signature` for an outcome, or one short line
 for ``--help`` and ``--version`` so their output stays compact. For the length
 of the call, a warning of the package's own categories prints as
 ``[warning] <message>`` with no file, line or echoed source, wrapped at 90
-columns under its text and followed by a blank line (0.31.0); ``--verbose``
+columns under its text and followed by a blank line; ``--verbose``
 keeps Python's full format. A Python caller outside a console script is never
 touched.
 
@@ -168,6 +168,9 @@ def _sign(outcome: str) -> None:
     except Exception:
         text = _signature.SEES_YOU
     stream = sys.stderr
+    if stream is None:
+        # print(file=None) would fall back to stdout and break its byte contract.
+        return
     try:
         try:
             print(text, file=stream)

{pyflightstream-0.41.0 → pyflightstream-0.43.0}/src/pyflightstream/_console.py

@@ -1,22 +1,22 @@
 """The console layout of a command's human output: titled blocks and wrapped lines.
 
 Below the package's domain layers, beside :mod:`pyflightstream._cli`, so
-every command prints the same shapes (0.31.0). A block is a short title line
+every command prints the same shapes. A block is a short title line
 saying what it is, then its lines indented under it; one blank line separates
 two blocks, and a block with nothing to say is not printed. A long line is
 wrapped at :data:`WIDTH` columns with its continuation lines indented under
 its text, never under its label, and every word is kept in order: only the
 spaces at a break change.
 
-Nothing here decides a stream. Each caller prints where it printed before:
+Nothing here decides a stream. Each caller chooses its stream:
 the human summary of ``plan`` on stdout, a warning on stderr.
 
-THE CONSOLE CONTRACT (0.32.0, FR-200 and FR-201). Every ``pyfs-matrix`` and
+THE CONSOLE CONTRACT (FR-200 and FR-201). Every ``pyfs-matrix`` and
 ``pyfs-workspace`` command opens with a titled block, the command's own name
 and what it is for (:func:`opening_lines`, :func:`opens_with_titled_block`),
 and a command's warnings are held and printed together at the end under
-``Warnings (<count>)`` (:func:`warnings_title`). The blocks the contract adds
-go to stderr, so standard output carries exactly what it carried before. The
+``Warnings (<count>)`` (:func:`warnings_title`). These console blocks
+go to stderr, keeping standard output available for command results. The
 progress of a long stage is one line of the shape :func:`progress_text` draws
 (FR-202). :mod:`pyflightstream._progress` holds the state that uses these
 shapes; this module holds only the shapes.
@@ -37,8 +37,8 @@ _Subparsers = argparse._SubParsersAction
 WIDTH = 90
 
 #: The console levels of a command (FR-997), least to most: ``quiet`` says the
-#: errors, the final summary line and the signature; ``normal`` is the console of
-#: 0.38.0; ``verbose`` is its ``--verbose``. The activity log is full at every level.
+#: errors, the final summary line and the signature; ``normal`` includes progress
+#: and summaries; ``verbose`` includes details. The activity log is full at every level.
 CONSOLE_LEVELS = ("quiet", "normal", "verbose")
 
 #: What a console warning starts with; its continuation lines align with the