timoshenko-engine 2.0.2__tar.gz → 2.0.3__tar.gz

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: timoshenko-engine
-Version: 2.0.2
+Version: 2.0.3
 Summary: Composable structural engineering calculations and analysis primitives for Python applications.
 Author: Ayberk Korkmaz
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/Ayberkrk/timoshenko
 Project-URL: Repository, https://github.com/Ayberkrk/timoshenko
 Project-URL: Issues, https://github.com/Ayberkrk/timoshenko/issues
-Project-URL: Documentation, https://github.com/Ayberkrk/timoshenko/tree/main/docs
+Project-URL: Documentation, https://timoshenko.readthedocs.io/
 Project-URL: Changelog, https://github.com/Ayberkrk/timoshenko/blob/main/docs/changelog.md
 Keywords: civil engineering,structural engineering,structural health monitoring,modal analysis,digital twin
 Classifier: Development Status :: 3 - Alpha
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering
+Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -27,6 +28,10 @@ Provides-Extra: mqtt
 Requires-Dist: paho-mqtt<3,>=2.1; extra == "mqtt"
 Provides-Extra: test
 Requires-Dist: pytest>=7; extra == "test"
+Requires-Dist: pytest-cov>=5; extra == "test"
+Provides-Extra: lint
+Requires-Dist: ruff>=0.6; extra == "lint"
+Requires-Dist: mypy>=1.10; extra == "lint"
 Provides-Extra: docs
 Requires-Dist: mkdocs-material<10,>=9.5; extra == "docs"
 Dynamic: license-file
@@ -46,7 +51,10 @@ Dynamic: license-file
   <img alt="Python versions" src="https://img.shields.io/pypi/pyversions/timoshenko-engine?style=for-the-badge">
   <img alt="Alpha" src="https://img.shields.io/badge/stage-alpha-orange?style=for-the-badge">
   <img alt="Apache 2.0 license" src="https://img.shields.io/badge/license-Apache--2.0-green?style=for-the-badge">
+  <a href="https://doi.org/10.5281/zenodo.22968739"><img alt="DOI" src="https://img.shields.io/badge/DOI-10.5281%2Fzenodo.22968739-blue?style=for-the-badge"></a>
   <a href="https://github.com/Ayberkrk/timoshenko/actions/workflows/tests.yml"><img alt="Tests" src="https://github.com/Ayberkrk/timoshenko/actions/workflows/tests.yml/badge.svg"></a>
+  <a href="https://github.com/Ayberkrk/timoshenko/tree/python-coverage-comment-action-data"><img alt="Coverage" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2FAyberkrk%2Ftimoshenko%2Fpython-coverage-comment-action-data%2Fendpoint.json&style=for-the-badge"></a>
+  <a href="https://timoshenko.readthedocs.io/en/latest/"><img alt="Documentation" src="https://img.shields.io/readthedocs/timoshenko?style=for-the-badge"></a>
 </p>
 
 Timoshenko packages common structural calculations, modal analysis, sensor
@@ -56,7 +64,7 @@ Python library, not a hosted monitoring service or a general finite-element
 solver.
 
 > **Alpha:** the API may still change between releases. Every behavior change
-> is listed in the [changelog](https://github.com/Ayberkrk/timoshenko/blob/main/docs/changelog.md).
+> is listed in the [changelog](https://timoshenko.readthedocs.io/en/latest/changelog/).
 
 ## Install
 
@@ -100,6 +108,10 @@ for change in result.health.mode_changes:
 print(result.health.review_recommended)          # True
 ```
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Ayberkrk/timoshenko/main/assets/modal-comparison.svg" alt="Both identified modes plot 5% below the reference model, past the 3% review threshold" width="800">
+</p>
+
 Real records load from CSV or JSON with
 `tm.load_sensors("acceleration.csv", sampling_hz=100.0, column="acc")`. The
 steps inside `tm.monitor` are also available separately as `tm.modal.identify`,
@@ -188,13 +200,15 @@ The session does not open network connections or run in the background. Use
 
 ## Documentation
 
-- [Documentation home](https://github.com/Ayberkrk/timoshenko/blob/main/docs/index.md)
-- [API reference](https://github.com/Ayberkrk/timoshenko/blob/main/docs/api.md)
-- [Numerical methods and limits](https://github.com/Ayberkrk/timoshenko/blob/main/docs/numerical-methods.md)
-- [Architecture](https://github.com/Ayberkrk/timoshenko/blob/main/docs/architecture.md)
-- [Monitoring sessions](https://github.com/Ayberkrk/timoshenko/blob/main/docs/live-sessions.md) and [source adapters](https://github.com/Ayberkrk/timoshenko/blob/main/docs/adapters.md)
-- [Runnable examples](https://github.com/Ayberkrk/timoshenko/tree/main/examples), including a [cross-check of PyNite shear-deformable beams](https://github.com/Ayberkrk/timoshenko/blob/main/docs/pynite-verification.md)
-- [Changelog](https://github.com/Ayberkrk/timoshenko/blob/main/docs/changelog.md)
+The full documentation is at
+[timoshenko.readthedocs.io](https://timoshenko.readthedocs.io/en/latest/). Good places to start:
+
+- [API reference](https://timoshenko.readthedocs.io/en/latest/api/)
+- [Numerical methods and limits](https://timoshenko.readthedocs.io/en/latest/numerical-methods/)
+- [Architecture](https://timoshenko.readthedocs.io/en/latest/architecture/)
+- [Monitoring sessions](https://timoshenko.readthedocs.io/en/latest/live-sessions/) and [source adapters](https://timoshenko.readthedocs.io/en/latest/adapters/)
+- [Runnable examples](https://github.com/Ayberkrk/timoshenko/tree/main/examples), including a [cross-check of PyNite shear-deformable beams](https://timoshenko.readthedocs.io/en/latest/pynite-verification/)
+- [Changelog](https://timoshenko.readthedocs.io/en/latest/changelog/)
 
 ## Limits and engineering posture
 
@@ -209,8 +223,10 @@ The session does not open network connections or run in the background. Use
 ## Development
 
 ```bash
-python -m pip install -e ".[test]"
-python -m pytest
+python -m pip install -e ".[test,lint]"
+python -m pytest --cov
+python -m ruff check .
+python -m mypy
 ```
 
 To preview the documentation site:
@@ -221,13 +237,20 @@ python -m mkdocs serve
 ```
 
 Bug reports and pull requests are welcome in the
-[issue tracker](https://github.com/Ayberkrk/timoshenko/issues).
+[issue tracker](https://github.com/Ayberkrk/timoshenko/issues). See
+[`CONTRIBUTING.md`](https://github.com/Ayberkrk/timoshenko/blob/main/CONTRIBUTING.md)
+for the checks a pull request needs to pass; issues labelled
+[good first issue](https://github.com/Ayberkrk/timoshenko/labels/good%20first%20issue)
+are small, self-contained starting points.
 
 ## Citation
 
-If you use Timoshenko in research, please cite it using the metadata in
-[`CITATION.cff`](https://github.com/Ayberkrk/timoshenko/blob/main/CITATION.cff)
-(GitHub's "Cite this repository" button reads the same file).
+If you use Timoshenko in research, please cite it with its DOI,
+[10.5281/zenodo.22968739](https://doi.org/10.5281/zenodo.22968739), which
+always resolves to the latest release; each release also has its own DOI on
+[Zenodo](https://zenodo.org/records/22968740). The metadata is in
+[`CITATION.cff`](https://github.com/Ayberkrk/timoshenko/blob/main/CITATION.cff),
+which GitHub's "Cite this repository" button reads.
 
 ## License
 

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/README.md

@@ -13,7 +13,10 @@
   <img alt="Python versions" src="https://img.shields.io/pypi/pyversions/timoshenko-engine?style=for-the-badge">
   <img alt="Alpha" src="https://img.shields.io/badge/stage-alpha-orange?style=for-the-badge">
   <img alt="Apache 2.0 license" src="https://img.shields.io/badge/license-Apache--2.0-green?style=for-the-badge">
+  <a href="https://doi.org/10.5281/zenodo.22968739"><img alt="DOI" src="https://img.shields.io/badge/DOI-10.5281%2Fzenodo.22968739-blue?style=for-the-badge"></a>
   <a href="https://github.com/Ayberkrk/timoshenko/actions/workflows/tests.yml"><img alt="Tests" src="https://github.com/Ayberkrk/timoshenko/actions/workflows/tests.yml/badge.svg"></a>
+  <a href="https://github.com/Ayberkrk/timoshenko/tree/python-coverage-comment-action-data"><img alt="Coverage" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2FAyberkrk%2Ftimoshenko%2Fpython-coverage-comment-action-data%2Fendpoint.json&style=for-the-badge"></a>
+  <a href="https://timoshenko.readthedocs.io/en/latest/"><img alt="Documentation" src="https://img.shields.io/readthedocs/timoshenko?style=for-the-badge"></a>
 </p>
 
 Timoshenko packages common structural calculations, modal analysis, sensor
@@ -23,7 +26,7 @@ Python library, not a hosted monitoring service or a general finite-element
 solver.
 
 > **Alpha:** the API may still change between releases. Every behavior change
-> is listed in the [changelog](https://github.com/Ayberkrk/timoshenko/blob/main/docs/changelog.md).
+> is listed in the [changelog](https://timoshenko.readthedocs.io/en/latest/changelog/).
 
 ## Install
 
@@ -67,6 +70,10 @@ for change in result.health.mode_changes:
 print(result.health.review_recommended)          # True
 ```
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Ayberkrk/timoshenko/main/assets/modal-comparison.svg" alt="Both identified modes plot 5% below the reference model, past the 3% review threshold" width="800">
+</p>
+
 Real records load from CSV or JSON with
 `tm.load_sensors("acceleration.csv", sampling_hz=100.0, column="acc")`. The
 steps inside `tm.monitor` are also available separately as `tm.modal.identify`,
@@ -155,13 +162,15 @@ The session does not open network connections or run in the background. Use
 
 ## Documentation
 
-- [Documentation home](https://github.com/Ayberkrk/timoshenko/blob/main/docs/index.md)
-- [API reference](https://github.com/Ayberkrk/timoshenko/blob/main/docs/api.md)
-- [Numerical methods and limits](https://github.com/Ayberkrk/timoshenko/blob/main/docs/numerical-methods.md)
-- [Architecture](https://github.com/Ayberkrk/timoshenko/blob/main/docs/architecture.md)
-- [Monitoring sessions](https://github.com/Ayberkrk/timoshenko/blob/main/docs/live-sessions.md) and [source adapters](https://github.com/Ayberkrk/timoshenko/blob/main/docs/adapters.md)
-- [Runnable examples](https://github.com/Ayberkrk/timoshenko/tree/main/examples), including a [cross-check of PyNite shear-deformable beams](https://github.com/Ayberkrk/timoshenko/blob/main/docs/pynite-verification.md)
-- [Changelog](https://github.com/Ayberkrk/timoshenko/blob/main/docs/changelog.md)
+The full documentation is at
+[timoshenko.readthedocs.io](https://timoshenko.readthedocs.io/en/latest/). Good places to start:
+
+- [API reference](https://timoshenko.readthedocs.io/en/latest/api/)
+- [Numerical methods and limits](https://timoshenko.readthedocs.io/en/latest/numerical-methods/)
+- [Architecture](https://timoshenko.readthedocs.io/en/latest/architecture/)
+- [Monitoring sessions](https://timoshenko.readthedocs.io/en/latest/live-sessions/) and [source adapters](https://timoshenko.readthedocs.io/en/latest/adapters/)
+- [Runnable examples](https://github.com/Ayberkrk/timoshenko/tree/main/examples), including a [cross-check of PyNite shear-deformable beams](https://timoshenko.readthedocs.io/en/latest/pynite-verification/)
+- [Changelog](https://timoshenko.readthedocs.io/en/latest/changelog/)
 
 ## Limits and engineering posture
 
@@ -176,8 +185,10 @@ The session does not open network connections or run in the background. Use
 ## Development
 
 ```bash
-python -m pip install -e ".[test]"
-python -m pytest
+python -m pip install -e ".[test,lint]"
+python -m pytest --cov
+python -m ruff check .
+python -m mypy
 ```
 
 To preview the documentation site:
@@ -188,13 +199,20 @@ python -m mkdocs serve
 ```
 
 Bug reports and pull requests are welcome in the
-[issue tracker](https://github.com/Ayberkrk/timoshenko/issues).
+[issue tracker](https://github.com/Ayberkrk/timoshenko/issues). See
+[`CONTRIBUTING.md`](https://github.com/Ayberkrk/timoshenko/blob/main/CONTRIBUTING.md)
+for the checks a pull request needs to pass; issues labelled
+[good first issue](https://github.com/Ayberkrk/timoshenko/labels/good%20first%20issue)
+are small, self-contained starting points.
 
 ## Citation
 
-If you use Timoshenko in research, please cite it using the metadata in
-[`CITATION.cff`](https://github.com/Ayberkrk/timoshenko/blob/main/CITATION.cff)
-(GitHub's "Cite this repository" button reads the same file).
+If you use Timoshenko in research, please cite it with its DOI,
+[10.5281/zenodo.22968739](https://doi.org/10.5281/zenodo.22968739), which
+always resolves to the latest release; each release also has its own DOI on
+[Zenodo](https://zenodo.org/records/22968740). The metadata is in
+[`CITATION.cff`](https://github.com/Ayberkrk/timoshenko/blob/main/CITATION.cff),
+which GitHub's "Cite this repository" button reads.
 
 ## License
 

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "timoshenko-engine"
-version = "2.0.2"
+version = "2.0.3"
 description = "Composable structural engineering calculations and analysis primitives for Python applications."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -29,11 +29,13 @@ classifiers = [
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Topic :: Scientific/Engineering",
+  "Typing :: Typed",
 ]
 
 [project.optional-dependencies]
 mqtt = ["paho-mqtt>=2.1,<3"]
-test = ["pytest>=7"]
+test = ["pytest>=7", "pytest-cov>=5"]
+lint = ["ruff>=0.6", "mypy>=1.10"]
 docs = ["mkdocs-material>=9.5,<10"]
 
 [project.entry-points."timoshenko.plugins"]
@@ -44,7 +46,7 @@ sensorthings = "timoshenko.sensorthings:SensorThingsPlugin"
 Homepage = "https://github.com/Ayberkrk/timoshenko"
 Repository = "https://github.com/Ayberkrk/timoshenko"
 Issues = "https://github.com/Ayberkrk/timoshenko/issues"
-Documentation = "https://github.com/Ayberkrk/timoshenko/tree/main/docs"
+Documentation = "https://timoshenko.readthedocs.io/"
 Changelog = "https://github.com/Ayberkrk/timoshenko/blob/main/docs/changelog.md"
 
 [tool.setuptools]
@@ -53,6 +55,29 @@ package-dir = { "" = "src" }
 [tool.setuptools.packages.find]
 where = ["src"]
 
+[tool.setuptools.package-data]
+timoshenko = ["py.typed"]
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 xfail_strict = true
+
+[tool.coverage.run]
+source = ["timoshenko"]
+relative_files = true
+
+[tool.coverage.report]
+show_missing = true
+
+[tool.ruff]
+target-version = "py310"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F"]
+
+[tool.mypy]
+files = ["src/timoshenko"]
+check_untyped_defs = true
+warn_unused_ignores = true
+warn_redundant_casts = true

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko/__init__.py

@@ -59,7 +59,7 @@ from .update import update
 from .uncertainty import UncertaintyError, UncertaintyResult, propagate as propagate_uncertainty
 from .vibration import RayleighDampingResult, damping_ratio, harmonic_response, natural_frequency_hz, rayleigh_damping_coefficients
 
-__version__ = "2.0.2"
+__version__ = "2.0.3"
 
 __all__ = [
     "HealthAssessment",

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko/adapters.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Iterator, Protocol, runtime_checkable
+from typing import Iterator, Literal, Protocol, runtime_checkable
 
 from .observations import ObservationBatch
 from .session import MonitoringSession, SessionIngestResult
@@ -73,7 +73,7 @@ class SessionRunner:
         self._consuming = False
         return self
 
-    def __exit__(self, exc_type, exc, traceback) -> bool:
+    def __exit__(self, exc_type, exc, traceback) -> Literal[False]:
         self._active = False
         try:
             self.source.close()

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko/modal.py

@@ -8,7 +8,7 @@ import math
 import numpy as np
 
 from .sensors import SensorData
-from .oma import FDDMode, FDDResult, identify_fdd
+from .oma import FDDMode as FDDMode, FDDResult as FDDResult, identify_fdd as identify_fdd
 
 
 @dataclass(frozen=True)
@@ -105,7 +105,7 @@ def identify(
         )
         for idx in selected
     )
-    notes = ["Frequency spacing is limited by the record duration."] if resolution > 0.25 else []
+    notes: list[str] = ["Frequency spacing is limited by the record duration."] if resolution > 0.25 else []
     if any(mode.damping_ratio is not None for mode in modes):
         notes.append(
             "Damping ratios are coarse half-power screening estimates from an averaged spectrum; "
@@ -116,7 +116,6 @@ def identify(
             "Damping is withheld where the record is too short to resolve the half-power bandwidth "
             f"with {_MIN_DAMPING_AVERAGES} averages and at least {_MIN_DAMPING_BINS:g} frequency bins."
         )
-    notes = tuple(notes)
     return ModalResult(
         modes=modes,
         sampling_hz=sensor_data.sampling_hz,
@@ -124,7 +123,7 @@ def identify(
         resolution_hz=resolution,
         channel=sensor_data.channel,
         status="ok" if modes else "no_peaks_found",
-        notes=notes,
+        notes=tuple(notes),
     )
 
 

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko/multichannel.py

@@ -54,11 +54,11 @@ class MultiChannelData:
 
     @property
     def sample_count(self) -> int:
-        return int(self.samples.shape[0])
+        return int(np.shape(self.samples)[0])
 
     @property
     def channel_count(self) -> int:
-        return int(self.samples.shape[1])
+        return int(np.shape(self.samples)[1])
 
 
 def load_multichannel_csv(
@@ -93,7 +93,7 @@ def load_multichannel_csv(
         for row_number, row in enumerate(reader, start=2):
             record: list[float] = []
             for name in names:
-                raw = row.get(name)
+                raw = row.get(name) or ""
                 try:
                     value = float(raw)
                 except (TypeError, ValueError):

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko/oma.py

@@ -93,7 +93,7 @@ def identify_fdd(
         raise TypeError("observations must be MultiChannelData; use tm.load_multichannel_csv() or construct it explicitly")
     if len(set(observations.units)) != 1:
         raise ValueError("FDD requires channels with the same measurement unit; calibrate/transform mixed-unit channels first")
-    sample_count, channel_count = observations.samples.shape
+    sample_count, channel_count = np.shape(observations.samples)
     nperseg_value, hop, segment_count, resolution, low, high = _plan(
         sample_count,
         observations.sampling_hz,

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko/project.py

@@ -223,6 +223,7 @@ def run_project(project: LoadedProject | str | Path) -> ProjectRunResult:
     if not isinstance(loaded, LoadedProject):
         raise TypeError("project must be a manifest path or LoadedProject from tm.load_project()")
     manifest = loaded.manifest
+    modal: ModalResult | FDDResult
     if manifest.method == "peak_picking":
         if not isinstance(loaded.observations, SensorData):
             raise TypeError("peak_picking manifest must load one SensorData channel")

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko/sections.py

@@ -94,7 +94,6 @@ def rectangular_tube(
     if 2.0 * thickness >= min(width, height):
         raise ValueError("twice wall_thickness_m must be smaller than both outer dimensions")
     inner_height = height - 2.0 * thickness
-    inner_width = width - 2.0 * thickness
     horizontal_plate_offset = (height - thickness) / 2.0
     vertical_plate_offset = (width - thickness) / 2.0
     area = 2.0 * width * thickness + 2.0 * thickness * inner_height

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko/sensors.py

@@ -16,7 +16,7 @@ import numpy as np
 class SensorData:
     """A single regularly sampled sensor channel."""
 
-    samples: tuple[float, ...] | Sequence[float]
+    samples: Sequence[float] | np.ndarray
     sampling_hz: float
     unit: str = "m/s^2"
     channel: str = "sensor"

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko/session.py

@@ -178,7 +178,7 @@ class MonitoringSession:
         self._review_threshold_pct = validate_review_threshold(review_threshold_pct)
         self._baseline_structure = structure
         self._store = store
-        self._buffers = {sensor_id: deque(maxlen=window) for sensor_id in ids}
+        self._buffers: dict[str, deque[tuple[int, float]]] = {sensor_id: deque(maxlen=window) for sensor_id in ids}
         self._last_key: dict[str, int] = {}
         self._seen_by_key: dict[int, set[str]] = {}
         self._seen_key_heap: list[int] = []
@@ -350,23 +350,25 @@ class MonitoringSession:
         if snapshot is None:
             return None
         keys, matrix = snapshot
+        observations: SensorData | MultiChannelData
+        modal: ModalResult | FDDResult
         if len(self._sensor_ids) == 1:
-            observations: SensorData | MultiChannelData = SensorData(
+            channel = SensorData(
                 samples=matrix[:, 0],
                 sampling_hz=self._sampling_hz,
                 unit=self._units[0],
                 channel=self._sensor_ids[0],
             )
-            modal = identify(observations, **self._options)
+            observations, modal = channel, identify(channel, **self._options)
             method = "peak_picking"
         else:
-            observations = MultiChannelData(
+            channels = MultiChannelData(
                 samples=matrix,
                 sampling_hz=self._sampling_hz,
                 channel_ids=self._sensor_ids,
                 units=self._units,
             )
-            modal = identify_fdd(observations, **self._options)
+            observations, modal = channels, identify_fdd(channels, **self._options)
             method = "fdd"
         if modal.modes:
             self._structure = update(self._baseline_structure, modal)

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko/storage.py

@@ -75,7 +75,7 @@ class SQLiteStore:
         timeout = float(timeout_seconds)
         if not math.isfinite(timeout) or timeout <= 0.0:
             raise ValueError("timeout_seconds must be finite and positive")
-        self._connection = sqlite3.connect(self.path, timeout=timeout)
+        self._connection: sqlite3.Connection | None = sqlite3.connect(self.path, timeout=timeout)
         self._connection.row_factory = sqlite3.Row
         self._db.execute("PRAGMA foreign_keys = ON")
         self._initialize()
@@ -154,8 +154,9 @@ class SQLiteStore:
         return connection
 
     def close(self) -> None:
-        if getattr(self, "_connection", None) is not None:
-            self._connection.close()
+        connection = getattr(self, "_connection", None)
+        if connection is not None:
+            connection.close()
             self._connection = None
 
     def __enter__(self) -> "SQLiteStore":

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko/uncertainty.py

@@ -227,7 +227,7 @@ def _finite_scalar(value: Any, label: str) -> float:
     if isinstance(value, (bool, np.bool_)) or not np.isscalar(value):
         raise UncertaintyError(f"{label} must be a finite real number")
     try:
-        result = float(value)
+        result = float(value)  # type: ignore[arg-type]
     except (TypeError, ValueError) as error:
         raise UncertaintyError(f"{label} must be a finite real number") from error
     if not math.isfinite(result):
@@ -235,7 +235,7 @@ def _finite_scalar(value: Any, label: str) -> float:
     return result
 
 
-def _evaluate(function: Callable[..., float], names: tuple[str, ...], values: Sequence[float], label: str) -> float:
+def _evaluate(function: Callable[..., float], names: tuple[str, ...], values: Sequence[float] | np.ndarray, label: str) -> float:
     try:
         result = function(**dict(zip(names, values)))
     except Exception as error:
@@ -243,7 +243,7 @@ def _evaluate(function: Callable[..., float], names: tuple[str, ...], values: Se
     if isinstance(result, (bool, np.bool_)) or not np.isscalar(result):
         raise UncertaintyError(f"equation output for {label} must be a finite scalar number")
     try:
-        output = float(result)
+        output = float(result)  # type: ignore[arg-type]
     except (TypeError, ValueError) as error:
         raise UncertaintyError(f"equation output for {label} must be a finite scalar number") from error
     if not math.isfinite(output):
@@ -251,7 +251,7 @@ def _evaluate(function: Callable[..., float], names: tuple[str, ...], values: Se
     return output
 
 
-def _try_evaluate(function: Callable[..., float], names: tuple[str, ...], values: Sequence[float]) -> float | None:
+def _try_evaluate(function: Callable[..., float], names: tuple[str, ...], values: Sequence[float] | np.ndarray) -> float | None:
     try:
         return _evaluate(function, names, values, "finite difference input")
     except UncertaintyError:

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko_engine.egg-info/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: timoshenko-engine
-Version: 2.0.2
+Version: 2.0.3
 Summary: Composable structural engineering calculations and analysis primitives for Python applications.
 Author: Ayberk Korkmaz
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/Ayberkrk/timoshenko
 Project-URL: Repository, https://github.com/Ayberkrk/timoshenko
 Project-URL: Issues, https://github.com/Ayberkrk/timoshenko/issues
-Project-URL: Documentation, https://github.com/Ayberkrk/timoshenko/tree/main/docs
+Project-URL: Documentation, https://timoshenko.readthedocs.io/
 Project-URL: Changelog, https://github.com/Ayberkrk/timoshenko/blob/main/docs/changelog.md
 Keywords: civil engineering,structural engineering,structural health monitoring,modal analysis,digital twin
 Classifier: Development Status :: 3 - Alpha
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering
+Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -27,6 +28,10 @@ Provides-Extra: mqtt
 Requires-Dist: paho-mqtt<3,>=2.1; extra == "mqtt"
 Provides-Extra: test
 Requires-Dist: pytest>=7; extra == "test"
+Requires-Dist: pytest-cov>=5; extra == "test"
+Provides-Extra: lint
+Requires-Dist: ruff>=0.6; extra == "lint"
+Requires-Dist: mypy>=1.10; extra == "lint"
 Provides-Extra: docs
 Requires-Dist: mkdocs-material<10,>=9.5; extra == "docs"
 Dynamic: license-file
@@ -46,7 +51,10 @@ Dynamic: license-file
   <img alt="Python versions" src="https://img.shields.io/pypi/pyversions/timoshenko-engine?style=for-the-badge">
   <img alt="Alpha" src="https://img.shields.io/badge/stage-alpha-orange?style=for-the-badge">
   <img alt="Apache 2.0 license" src="https://img.shields.io/badge/license-Apache--2.0-green?style=for-the-badge">
+  <a href="https://doi.org/10.5281/zenodo.22968739"><img alt="DOI" src="https://img.shields.io/badge/DOI-10.5281%2Fzenodo.22968739-blue?style=for-the-badge"></a>
   <a href="https://github.com/Ayberkrk/timoshenko/actions/workflows/tests.yml"><img alt="Tests" src="https://github.com/Ayberkrk/timoshenko/actions/workflows/tests.yml/badge.svg"></a>
+  <a href="https://github.com/Ayberkrk/timoshenko/tree/python-coverage-comment-action-data"><img alt="Coverage" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2FAyberkrk%2Ftimoshenko%2Fpython-coverage-comment-action-data%2Fendpoint.json&style=for-the-badge"></a>
+  <a href="https://timoshenko.readthedocs.io/en/latest/"><img alt="Documentation" src="https://img.shields.io/readthedocs/timoshenko?style=for-the-badge"></a>
 </p>
 
 Timoshenko packages common structural calculations, modal analysis, sensor
@@ -56,7 +64,7 @@ Python library, not a hosted monitoring service or a general finite-element
 solver.
 
 > **Alpha:** the API may still change between releases. Every behavior change
-> is listed in the [changelog](https://github.com/Ayberkrk/timoshenko/blob/main/docs/changelog.md).
+> is listed in the [changelog](https://timoshenko.readthedocs.io/en/latest/changelog/).
 
 ## Install
 
@@ -100,6 +108,10 @@ for change in result.health.mode_changes:
 print(result.health.review_recommended)          # True
 ```
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Ayberkrk/timoshenko/main/assets/modal-comparison.svg" alt="Both identified modes plot 5% below the reference model, past the 3% review threshold" width="800">
+</p>
+
 Real records load from CSV or JSON with
 `tm.load_sensors("acceleration.csv", sampling_hz=100.0, column="acc")`. The
 steps inside `tm.monitor` are also available separately as `tm.modal.identify`,
@@ -188,13 +200,15 @@ The session does not open network connections or run in the background. Use
 
 ## Documentation
 
-- [Documentation home](https://github.com/Ayberkrk/timoshenko/blob/main/docs/index.md)
-- [API reference](https://github.com/Ayberkrk/timoshenko/blob/main/docs/api.md)
-- [Numerical methods and limits](https://github.com/Ayberkrk/timoshenko/blob/main/docs/numerical-methods.md)
-- [Architecture](https://github.com/Ayberkrk/timoshenko/blob/main/docs/architecture.md)
-- [Monitoring sessions](https://github.com/Ayberkrk/timoshenko/blob/main/docs/live-sessions.md) and [source adapters](https://github.com/Ayberkrk/timoshenko/blob/main/docs/adapters.md)
-- [Runnable examples](https://github.com/Ayberkrk/timoshenko/tree/main/examples), including a [cross-check of PyNite shear-deformable beams](https://github.com/Ayberkrk/timoshenko/blob/main/docs/pynite-verification.md)
-- [Changelog](https://github.com/Ayberkrk/timoshenko/blob/main/docs/changelog.md)
+The full documentation is at
+[timoshenko.readthedocs.io](https://timoshenko.readthedocs.io/en/latest/). Good places to start:
+
+- [API reference](https://timoshenko.readthedocs.io/en/latest/api/)
+- [Numerical methods and limits](https://timoshenko.readthedocs.io/en/latest/numerical-methods/)
+- [Architecture](https://timoshenko.readthedocs.io/en/latest/architecture/)
+- [Monitoring sessions](https://timoshenko.readthedocs.io/en/latest/live-sessions/) and [source adapters](https://timoshenko.readthedocs.io/en/latest/adapters/)
+- [Runnable examples](https://github.com/Ayberkrk/timoshenko/tree/main/examples), including a [cross-check of PyNite shear-deformable beams](https://timoshenko.readthedocs.io/en/latest/pynite-verification/)
+- [Changelog](https://timoshenko.readthedocs.io/en/latest/changelog/)
 
 ## Limits and engineering posture
 
@@ -209,8 +223,10 @@ The session does not open network connections or run in the background. Use
 ## Development
 
 ```bash
-python -m pip install -e ".[test]"
-python -m pytest
+python -m pip install -e ".[test,lint]"
+python -m pytest --cov
+python -m ruff check .
+python -m mypy
 ```
 
 To preview the documentation site:
@@ -221,13 +237,20 @@ python -m mkdocs serve
 ```
 
 Bug reports and pull requests are welcome in the
-[issue tracker](https://github.com/Ayberkrk/timoshenko/issues).
+[issue tracker](https://github.com/Ayberkrk/timoshenko/issues). See
+[`CONTRIBUTING.md`](https://github.com/Ayberkrk/timoshenko/blob/main/CONTRIBUTING.md)
+for the checks a pull request needs to pass; issues labelled
+[good first issue](https://github.com/Ayberkrk/timoshenko/labels/good%20first%20issue)
+are small, self-contained starting points.
 
 ## Citation
 
-If you use Timoshenko in research, please cite it using the metadata in
-[`CITATION.cff`](https://github.com/Ayberkrk/timoshenko/blob/main/CITATION.cff)
-(GitHub's "Cite this repository" button reads the same file).
+If you use Timoshenko in research, please cite it with its DOI,
+[10.5281/zenodo.22968739](https://doi.org/10.5281/zenodo.22968739), which
+always resolves to the latest release; each release also has its own DOI on
+[Zenodo](https://zenodo.org/records/22968740). The metadata is in
+[`CITATION.cff`](https://github.com/Ayberkrk/timoshenko/blob/main/CITATION.cff),
+which GitHub's "Cite this repository" button reads.
 
 ## License
 

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko_engine.egg-info/SOURCES.txt

@@ -19,6 +19,7 @@ src/timoshenko/plugins.py
 src/timoshenko/polygon.py
 src/timoshenko/pressure.py
 src/timoshenko/project.py
+src/timoshenko/py.typed
 src/timoshenko/report.py
 src/timoshenko/sections.py
 src/timoshenko/sensors.py

{timoshenko_engine-2.0.2 → timoshenko_engine-2.0.3}/src/timoshenko_engine.egg-info/requires.txt

@@ -3,8 +3,13 @@ numpy>=1.24
 [docs]
 mkdocs-material<10,>=9.5
 
+[lint]
+ruff>=0.6
+mypy>=1.10
+
 [mqtt]
 paho-mqtt<3,>=2.1
 
 [test]
 pytest>=7
+pytest-cov>=5