fullflow 2.0.1__tar.gz → 2.0.2__tar.gz

{fullflow-2.0.1 → fullflow-2.0.2}/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 2.0.2
+
+* Updated the FullPlot dependency to `fullplot>=0.1.1`.
+* Updated Sensor missing-data documentation to match current `extend` behavior.
+* Updated the test-data anchoring example to use shared `TimeAxis.window(...)` windowing.
+
 ## 2.0.1
 
 ### PID controller

{fullflow-2.0.1 → fullflow-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fullflow
-Version: 2.0.1
+Version: 2.0.2
 Summary: Python-native fluid, thermal, propulsion, control, and transient network simulation.
 Keywords: fluid-dynamics,fluid-network,network-analysis,thermodynamics,thermal-analysis,heat-transfer,propulsion,rocket-propulsion,rocket-engine,compressible-flow,turbomachinery,control-systems,transient-simulation,simulation,engineering,scientific-computing
 Author: Saaketh Ramoju
@@ -24,7 +24,7 @@ Requires-Dist: numpy>=1.26
 Requires-Dist: scipy>=1.11
 Requires-Dist: rich>=13.7
 Requires-Dist: h5py>=3.10
-Requires-Dist: fullplot>=0.1.0
+Requires-Dist: fullplot>=0.1.1
 Requires-Dist: pytest>=8.0 ; extra == 'dev'
 Requires-Dist: build>=1.2 ; extra == 'dev'
 Requires-Dist: twine>=5.0 ; extra == 'dev'
@@ -1742,27 +1742,32 @@ from fullflow import *
 Net = Network("Anchored Example")
 pressure = State(2.0e6)
 
+time = fplt.TimeAxis([0.0, 1.0, 2.0], name="Time")
 pressure_trace = fplt.Trace(
-    x=[0.0, 1.0, 2.0],
+    x=time,
     y=[2.0e6, 2.1e6, 2.05e6],
     name="measured pressure",
     role="data",
 )
 
+time.window(0.5, 2.0)
+
 PressureSensor = Sensor(
     "Chamber Pressure Sensor",
     Net,
     reading=pressure,
     variable=pressure,
     data=pressure_trace,
-    extend=False,
 )
 ```
 
 When used in a transient solve, the sensor samples the test data at
 `network.time` and exposes a balance between the model variable and the sampled
-trace value.  With `extend=False`, the transient stops cleanly when the trace no
-longer has data.
+trace value. A shared FullPlot `TimeAxis` can window all attached traces at once.
+With the default `extend=True`, an anchor is inactive when no finite data is
+available and the solve continues; an otherwise unconstrained anchored variable
+retains its last accepted value. With `extend=False`, the transient stops cleanly
+when data is unavailable.
 
 ## Sequences, controllers, and actuators
 

{fullflow-2.0.1 → fullflow-2.0.2}/README.md

@@ -1698,27 +1698,32 @@ from fullflow import *
 Net = Network("Anchored Example")
 pressure = State(2.0e6)
 
+time = fplt.TimeAxis([0.0, 1.0, 2.0], name="Time")
 pressure_trace = fplt.Trace(
-    x=[0.0, 1.0, 2.0],
+    x=time,
     y=[2.0e6, 2.1e6, 2.05e6],
     name="measured pressure",
     role="data",
 )
 
+time.window(0.5, 2.0)
+
 PressureSensor = Sensor(
     "Chamber Pressure Sensor",
     Net,
     reading=pressure,
     variable=pressure,
     data=pressure_trace,
-    extend=False,
 )
 ```
 
 When used in a transient solve, the sensor samples the test data at
 `network.time` and exposes a balance between the model variable and the sampled
-trace value.  With `extend=False`, the transient stops cleanly when the trace no
-longer has data.
+trace value. A shared FullPlot `TimeAxis` can window all attached traces at once.
+With the default `extend=True`, an anchor is inactive when no finite data is
+available and the solve continues; an otherwise unconstrained anchored variable
+retains its last accepted value. With `extend=False`, the transient stops cleanly
+when data is unavailable.
 
 ## Sequences, controllers, and actuators
 

{fullflow-2.0.1 → fullflow-2.0.2}/examples/testing/1test_data_anchoring.py

@@ -155,13 +155,12 @@ fflow = data.trace(y="FUEL_MDOT", x=time, name="Fuel Flow Test Data", role="data
 
 # A user can process a test-data trace before anchoring to it. The filtered trace
 # keeps the same role as the source trace, so it is still valid Sensor.data.
-ftpt_filtered = ftpt_raw.filter("moving_average", window=0.04)
-fipt_filtered = fipt_raw.filter("moving_average", window=0.04)
+ftpt = ftpt_raw.filter("moving_average", window=0.04) * psia_to_pa
+fipt = fipt_raw.filter("moving_average", window=0.04) * psia_to_pa
 
-# Only use the useful part of the test. Windowing keeps the trace role too.
-ftpt = ftpt_filtered.window(start=0.0, stop=6.5) * psia_to_pa
-fipt = fipt_filtered.window(start=0.0, stop=6.5) * psia_to_pa
-fflow = fflow.window(start=0.0, stop=6.5)
+# All three traces share this TimeAxis, so one window selects the useful part of
+# the test for every attached trace.
+time.window(start=0.0, stop=6.5)
 
 # Conditions are optional in this example. They demonstrate that a Sensor can
 # both anchor to data and log line-crossing events during the same run.

fullflow-2.0.2/pyproject.toml

@@ -0,0 +1,101 @@
+[project]
+name = "fullflow"
+version = "2.0.2"
+description = "Python-native fluid, thermal, propulsion, control, and transient network simulation."
+readme = "README.md"
+license = "GPL-3.0-only"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+keywords = [
+    "fluid-dynamics",
+    "fluid-network",
+    "network-analysis",
+    "thermodynamics",
+    "thermal-analysis",
+    "heat-transfer",
+    "propulsion",
+    "rocket-propulsion",
+    "rocket-engine",
+    "compressible-flow",
+    "turbomachinery",
+    "control-systems",
+    "transient-simulation",
+    "simulation",
+    "engineering",
+    "scientific-computing",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Education",
+    "Intended Audience :: Developers",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Scientific/Engineering :: Physics",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Topic :: Scientific/Engineering :: Mathematics",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "numpy>=1.26",
+    "scipy>=1.11",
+    "rich>=13.7",
+    "h5py>=3.10",
+    "fullplot>=0.1.1",
+]
+
+[[project.authors]]
+name = "Saaketh Ramoju"
+email = "skramoju@gmail.com"
+
+[project.optional-dependencies]
+thermo = ["thermoprop>=2.0.0"]
+examples = [
+    "thermoprop>=2.0.0",
+    "matplotlib>=3.8",
+]
+dev = [
+    "pytest>=8.0",
+    "build>=1.2",
+    "twine>=5.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/saakethramoju/FullFlow"
+Repository = "https://github.com/saakethramoju/FullFlow"
+Issues = "https://github.com/saakethramoju/FullFlow/issues"
+Changelog = "https://github.com/saakethramoju/FullFlow/blob/main/CHANGELOG.md"
+PyPI = "https://pypi.org/project/fullflow/"
+
+[project.scripts]
+fullflow = "fullflow:main"
+
+[build-system]
+requires = ["uv_build>=0.11.18,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+source-include = [
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "THIRD_PARTY_LICENSES.md",
+    "PUBLISHING.md",
+    "CONTRIBUTING.md",
+    "CODE_OF_CONDUCT.md",
+    "SECURITY.md",
+    "CITATION.cff",
+    "docs/**",
+    "examples/**",
+    "tests/**",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "build>=1.2",
+    "twine>=5.0",
+]

fullflow-2.0.1/pyproject.toml → fullflow-2.0.2/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "fullflow"
-version = "2.0.1"
+version = "2.0.2"
 description = "Python-native fluid, thermal, propulsion, control, and transient network simulation."
 readme = "README.md"
 license = "GPL-3.0-only"
@@ -50,7 +50,7 @@ dependencies = [
     "scipy>=1.11",
     "rich>=13.7",
     "h5py>=3.10",
-    "fullplot>=0.1.0",
+    "fullplot>=0.1.1",
 ]
 
 [project.optional-dependencies]

{fullflow-2.0.1 → fullflow-2.0.2}/src/fullflow/System/Components/Sensor.py

@@ -103,10 +103,11 @@ class Sensor(Component):
 
         Missing data
         ------------
-        ``extend=True`` holds the nearest data value outside the trace range.
-        ``extend=False`` requests a clean transient stop when no data value is
-        available.  This lets simulations end naturally when the test-data window is
-        exhausted."""
+        ``extend=True`` allows the solve to continue when no finite data value is
+        available.  The sensor anchor is inactive during those times; if its
+        variable would otherwise be unconstrained, FullFlow retains the last
+        accepted value.  ``extend=False`` requests a clean transient stop when no
+        data value is available."""
 
     def __init__(
         self,

{fullflow-2.0.1 → fullflow-2.0.2}/src/fullflow/__init__.py

@@ -2,7 +2,7 @@
 FullFlow: fluid, thermal, and propulsion network simulation.
 """
 
-__version__ = "2.0.1"
+__version__ = "2.0.2"
 
 from fullflow.System import *
 from fullflow.Solvers import *

{fullflow-2.0.1 → fullflow-2.0.2}/tests/test_imports.py

@@ -3,4 +3,4 @@ def test_fullflow_imports():
     import fullflow.System
     import fullflow.Solvers
 
-    assert fullflow.__version__ == "2.0.1"
+    assert fullflow.__version__ == "2.0.2"