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

timoshenko_engine-2.0.3/PKG-INFO

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: timoshenko-engine
+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://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
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+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
+Requires-Dist: numpy>=1.24
+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
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Ayberkrk/timoshenko/main/assets/timoshenko-logo.png" alt="Timoshenko Engine logo" width="920">
+</p>
+
+<h1 align="center">Timoshenko Engine</h1>
+
+<p align="center">
+  Reusable structural engineering building blocks for Python applications.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/timoshenko-engine/"><img alt="PyPI" src="https://img.shields.io/pypi/v/timoshenko-engine?style=for-the-badge"></a>
+  <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
+workflows, and monitoring components so applications can reuse them instead
+of rebuilding the same foundations for every project. It is an embeddable
+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://timoshenko.readthedocs.io/en/latest/changelog/).
+
+## Install
+
+```bash
+python -m pip install timoshenko-engine
+```
+
+The distribution is named `timoshenko-engine`; the import package is
+`timoshenko`. Optional MQTT support is an extra:
+
+```bash
+python -m pip install "timoshenko-engine[mqtt]"
+```
+
+## Quick start
+
+Compare measured vibration with a reference model. This example simulates a
+record in which both modes are 5% below the model:
+
+```python
+import numpy as np
+import timoshenko as tm
+
+structure = tm.Structure(
+    structure_id="building-01",
+    story_masses_kg=[120_000.0, 110_000.0],
+    story_stiffness_n_m=[85_000_000.0, 70_000_000.0],
+)
+print(structure.natural_frequencies_hz)          # (2.626, 6.476)
+
+fs = 100.0
+t = np.arange(60_000) / fs
+f1, f2 = (0.95 * f for f in structure.natural_frequencies_hz)
+signal = np.sin(2 * np.pi * f1 * t) + 0.4 * np.sin(2 * np.pi * f2 * t)
+sensors = tm.SensorData(signal, sampling_hz=fs, unit="m/s^2")
+
+result = tm.monitor(structure, sensors, review_threshold_pct=3.0)
+print(result.structure.update_scale_factor)      # 0.903, since stiffness scales with frequency squared
+for change in result.health.mode_changes:
+    print(change.mode_number, change.change_pct)  # 1 -5.0, then 2 -5.0
+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`,
+`tm.update`, and `tm.health.assess`. The review flag is raised only when you
+pass a threshold: a meaningful value depends on the structure and its
+environmental variability, so the engine does not choose one.
+
+## Engineering calculations
+
+Closed-form functions take and return SI units and validate their inputs:
+
+```python
+import timoshenko as tm
+
+section = tm.rectangle_section(width_m=0.3, height_m=0.6)
+beam = tm.simply_supported_uniform_load(
+    20_000.0, 6.0, 30e9, section.second_moment_y_m4,
+    shear_modulus_pa=12.5e9, area_m2=section.area_m2,
+)
+print(beam.bending_m, beam.shear_m)  # 2.083 mm bending, 0.048 mm shear
+
+frequency = tm.propagate_uncertainty(
+    tm.natural_frequency_hz,
+    {"mass_kg": 250.0, "stiffness_n_m": 4e5},
+    standard_uncertainties={"mass_kg": 5.0, "stiffness_n_m": 8e3},
+)
+print(frequency.estimate, frequency.standard_uncertainty)  # 6.366 Hz ± 0.090 Hz
+```
+
+## What it provides
+
+| Area | Components |
+|---|---|
+| Engineering calculations | Section properties (including polygons with holes), beam deflection with shear, torsion, Euler buckling, plane stress, thin-wall pressure, SDOF vibration, Rayleigh damping, and GUM / Monte Carlo uncertainty |
+| Structural models | Lumped-mass shear-building models and their natural frequencies |
+| Modal analysis | Single-channel peak picking with resolution-checked damping, and multi-channel FDD with complex mode shapes |
+| Model comparison | Nearest-frequency mode pairing, global stiffness updating, and evidence-oriented health assessment |
+| Monitoring | Bounded rolling-window sessions, restart from local history, and source adapters for CSV, MQTT, and OGC SensorThings |
+| Data and reporting | Project manifests with SHA-256 provenance, local SQLite history, and standalone HTML reports |
+
+Sensor collection, alarm policy, and engineering interpretation remain with the
+application that embeds Timoshenko.
+
+## Multi-channel modal analysis
+
+Frequency domain decomposition needs synchronized channels with a common
+sample rate and unit:
+
+```python
+signals = tm.load_multichannel_csv(
+    "aligned_accelerometers.csv",
+    columns=["deck_left", "deck_center", "deck_right"],
+    sampling_hz=100.0,
+    units=["m/s^2"] * 3,
+)
+fdd = tm.identify_fdd(signals, nperseg=1024, max_modes=5)
+for mode in fdd.modes:
+    print(mode.frequency_hz, mode.shape_real)
+```
+
+## Monitoring sessions
+
+A host application feeds timestamped observation batches. The session aligns
+samples to the sample grid, waits for a fresh contiguous window after gaps, and
+analyzes every configured hop:
+
+```python
+session = tm.MonitoringSession(
+    structure,
+    sensor_ids=["deck-left", "deck-right"],
+    units=["m/s^2", "m/s^2"],
+    sampling_hz=100.0,
+    window_samples=2048,
+    hop_samples=512,
+    analysis_options={"nperseg": 512, "max_modes": 4},
+    review_threshold_pct=5.0,
+)
+result = session.ingest(batch)  # batch: tm.ObservationBatch from your gateway or a source adapter
+for report in result.reports:
+    tm.report.save_html(report, "reports/latest.html")
+```
+
+The session does not open network connections or run in the background. Use
+`tm.SessionRunner` with a source such as `tm.CSVObservationSource` or
+`tm.MqttObservationSource` to drive it.
+
+## Documentation
+
+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
+
+- Timoshenko is alpha software and is not a structural safety certification tool.
+- The shear-building model is a small lumped-mass reference model, not a full FEM solver.
+- Modal identification is a screening estimate. A single sensor may miss a mode near a modal node; unpaired peaks are reported rather than compared with the wrong mode.
+- Damping is a coarse screening estimate, reported only when the averaged spectrum resolves the half-power bandwidth. FDD does not estimate damping.
+- The model update applies a single stiffness scale. It cannot locate or size local damage.
+- A frequency shift is evidence for human review, not a damage verdict. Temperature, sensor placement, boundary conditions, and other effects also shift measured frequencies.
+- Closed-form mechanics and section functions rely on their documented ideal assumptions. They are not code-compliance checks.
+
+## Development
+
+```bash
+python -m pip install -e ".[test,lint]"
+python -m pytest --cov
+python -m ruff check .
+python -m mypy
+```
+
+To preview the documentation site:
+
+```bash
+python -m pip install -e ".[docs]"
+python -m mkdocs serve
+```
+
+Bug reports and pull requests are welcome in the
+[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 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
+
+Apache License 2.0. See [LICENSE](https://github.com/Ayberkrk/timoshenko/blob/main/LICENSE).

timoshenko_engine-2.0.3/README.md

@@ -0,0 +1,219 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Ayberkrk/timoshenko/main/assets/timoshenko-logo.png" alt="Timoshenko Engine logo" width="920">
+</p>
+
+<h1 align="center">Timoshenko Engine</h1>
+
+<p align="center">
+  Reusable structural engineering building blocks for Python applications.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/timoshenko-engine/"><img alt="PyPI" src="https://img.shields.io/pypi/v/timoshenko-engine?style=for-the-badge"></a>
+  <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
+workflows, and monitoring components so applications can reuse them instead
+of rebuilding the same foundations for every project. It is an embeddable
+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://timoshenko.readthedocs.io/en/latest/changelog/).
+
+## Install
+
+```bash
+python -m pip install timoshenko-engine
+```
+
+The distribution is named `timoshenko-engine`; the import package is
+`timoshenko`. Optional MQTT support is an extra:
+
+```bash
+python -m pip install "timoshenko-engine[mqtt]"
+```
+
+## Quick start
+
+Compare measured vibration with a reference model. This example simulates a
+record in which both modes are 5% below the model:
+
+```python
+import numpy as np
+import timoshenko as tm
+
+structure = tm.Structure(
+    structure_id="building-01",
+    story_masses_kg=[120_000.0, 110_000.0],
+    story_stiffness_n_m=[85_000_000.0, 70_000_000.0],
+)
+print(structure.natural_frequencies_hz)          # (2.626, 6.476)
+
+fs = 100.0
+t = np.arange(60_000) / fs
+f1, f2 = (0.95 * f for f in structure.natural_frequencies_hz)
+signal = np.sin(2 * np.pi * f1 * t) + 0.4 * np.sin(2 * np.pi * f2 * t)
+sensors = tm.SensorData(signal, sampling_hz=fs, unit="m/s^2")
+
+result = tm.monitor(structure, sensors, review_threshold_pct=3.0)
+print(result.structure.update_scale_factor)      # 0.903, since stiffness scales with frequency squared
+for change in result.health.mode_changes:
+    print(change.mode_number, change.change_pct)  # 1 -5.0, then 2 -5.0
+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`,
+`tm.update`, and `tm.health.assess`. The review flag is raised only when you
+pass a threshold: a meaningful value depends on the structure and its
+environmental variability, so the engine does not choose one.
+
+## Engineering calculations
+
+Closed-form functions take and return SI units and validate their inputs:
+
+```python
+import timoshenko as tm
+
+section = tm.rectangle_section(width_m=0.3, height_m=0.6)
+beam = tm.simply_supported_uniform_load(
+    20_000.0, 6.0, 30e9, section.second_moment_y_m4,
+    shear_modulus_pa=12.5e9, area_m2=section.area_m2,
+)
+print(beam.bending_m, beam.shear_m)  # 2.083 mm bending, 0.048 mm shear
+
+frequency = tm.propagate_uncertainty(
+    tm.natural_frequency_hz,
+    {"mass_kg": 250.0, "stiffness_n_m": 4e5},
+    standard_uncertainties={"mass_kg": 5.0, "stiffness_n_m": 8e3},
+)
+print(frequency.estimate, frequency.standard_uncertainty)  # 6.366 Hz ± 0.090 Hz
+```
+
+## What it provides
+
+| Area | Components |
+|---|---|
+| Engineering calculations | Section properties (including polygons with holes), beam deflection with shear, torsion, Euler buckling, plane stress, thin-wall pressure, SDOF vibration, Rayleigh damping, and GUM / Monte Carlo uncertainty |
+| Structural models | Lumped-mass shear-building models and their natural frequencies |
+| Modal analysis | Single-channel peak picking with resolution-checked damping, and multi-channel FDD with complex mode shapes |
+| Model comparison | Nearest-frequency mode pairing, global stiffness updating, and evidence-oriented health assessment |
+| Monitoring | Bounded rolling-window sessions, restart from local history, and source adapters for CSV, MQTT, and OGC SensorThings |
+| Data and reporting | Project manifests with SHA-256 provenance, local SQLite history, and standalone HTML reports |
+
+Sensor collection, alarm policy, and engineering interpretation remain with the
+application that embeds Timoshenko.
+
+## Multi-channel modal analysis
+
+Frequency domain decomposition needs synchronized channels with a common
+sample rate and unit:
+
+```python
+signals = tm.load_multichannel_csv(
+    "aligned_accelerometers.csv",
+    columns=["deck_left", "deck_center", "deck_right"],
+    sampling_hz=100.0,
+    units=["m/s^2"] * 3,
+)
+fdd = tm.identify_fdd(signals, nperseg=1024, max_modes=5)
+for mode in fdd.modes:
+    print(mode.frequency_hz, mode.shape_real)
+```
+
+## Monitoring sessions
+
+A host application feeds timestamped observation batches. The session aligns
+samples to the sample grid, waits for a fresh contiguous window after gaps, and
+analyzes every configured hop:
+
+```python
+session = tm.MonitoringSession(
+    structure,
+    sensor_ids=["deck-left", "deck-right"],
+    units=["m/s^2", "m/s^2"],
+    sampling_hz=100.0,
+    window_samples=2048,
+    hop_samples=512,
+    analysis_options={"nperseg": 512, "max_modes": 4},
+    review_threshold_pct=5.0,
+)
+result = session.ingest(batch)  # batch: tm.ObservationBatch from your gateway or a source adapter
+for report in result.reports:
+    tm.report.save_html(report, "reports/latest.html")
+```
+
+The session does not open network connections or run in the background. Use
+`tm.SessionRunner` with a source such as `tm.CSVObservationSource` or
+`tm.MqttObservationSource` to drive it.
+
+## Documentation
+
+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
+
+- Timoshenko is alpha software and is not a structural safety certification tool.
+- The shear-building model is a small lumped-mass reference model, not a full FEM solver.
+- Modal identification is a screening estimate. A single sensor may miss a mode near a modal node; unpaired peaks are reported rather than compared with the wrong mode.
+- Damping is a coarse screening estimate, reported only when the averaged spectrum resolves the half-power bandwidth. FDD does not estimate damping.
+- The model update applies a single stiffness scale. It cannot locate or size local damage.
+- A frequency shift is evidence for human review, not a damage verdict. Temperature, sensor placement, boundary conditions, and other effects also shift measured frequencies.
+- Closed-form mechanics and section functions rely on their documented ideal assumptions. They are not code-compliance checks.
+
+## Development
+
+```bash
+python -m pip install -e ".[test,lint]"
+python -m pytest --cov
+python -m ruff check .
+python -m mypy
+```
+
+To preview the documentation site:
+
+```bash
+python -m pip install -e ".[docs]"
+python -m mkdocs serve
+```
+
+Bug reports and pull requests are welcome in the
+[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 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
+
+Apache License 2.0. See [LICENSE](https://github.com/Ayberkrk/timoshenko/blob/main/LICENSE).

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "timoshenko-engine"
-version = "2.0.1"
+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,8 @@ 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]
 package-dir = { "" = "src" }
@@ -52,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.1 → 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.1"
+__version__ = "2.0.3"
 
 __all__ = [
     "HealthAssessment",

{timoshenko_engine-2.0.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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"