finitewave 0.9.0__tar.gz

finitewave-0.9.0/.codecov.yml

@@ -0,0 +1,5 @@
+coverage:
+  status:
+    patch:
+      default:
+        enabled: false

finitewave-0.9.0/.coveragerc

@@ -0,0 +1,20 @@
+[run]
+branch = True
+parallel = True
+concurrency = multiprocessing,thread
+omit =
+    */__init__.py
+    */_version.py
+    */__pycache__/*
+    */numba_cache/*
+    */stencil/*
+    */tests/*
+    *setup.py
+    finitewave/tools/*
+
+[report]
+exclude_lines =
+    pragma: no cover
+    def __repr__
+    if self\.debug
+    if __name__ == .__main__.:

finitewave-0.9.0/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: Run Finitewave tests
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+  pull_request:
+    branches:
+      - main
+      - develop
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    env:
+      NUMBA_DISABLE_JIT: "1"
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+          pip install pytest pytest-cov
+
+      - name: Run tests with coverage
+        run: |
+          pytest --cov=./finitewave --cov-report=term --cov-report=xml
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: true
+          token: ${{ secrets.CODECOV_TOKEN }}
+          slug: finitewave/Finitewave

finitewave-0.9.0/.github/workflows/full_check.yml

@@ -0,0 +1,51 @@
+name: Finitewave Full Check
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  install-smoke:
+    runs-on: ubuntu-latest
+
+    env:
+      NUMBA_DISABLE_JIT: "1"
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install package from repository
+        run: |
+          python -m pip install --upgrade pip
+          pip install .
+          python -c "import finitewave; print('finitewave local install OK')"
+
+      - name: Show installed packages
+        run: |
+          python -m pip list
+
+  install-from-pypi:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install package from PyPI
+        run: |
+          python -m pip install --upgrade pip
+          pip install finitewave
+          python -c "import finitewave; print('finitewave PyPI install OK')"
+
+      - name: Show installed packages
+        run: |
+          python -m pip list

finitewave-0.9.0/.github/workflows/test-os.yml

@@ -0,0 +1,29 @@
+name: Platform compatibility test
+
+on:
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Test on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+          pip install .[test]
+
+      - name: Run tests
+        run: pytest

finitewave-0.9.0/.gitignore

@@ -0,0 +1,131 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+.DS_Store
+auto_examples/
+
+# PyInstaller
+# Usually these files are written by a python script from a template
+# before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Jupyter Notebook
+playground.ipynb
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# CMake
+CMakeFiles/
+CMakeCache.txt
+cmake_install.cmake
+CMakeScripts/
+CTestTestfile.cmake
+Testing/
+Makefile
+cmake-build-*/
+
+# Sphinx documentation
+docs/_build/
+
+# Temporary files
+*.bak
+*.swp
+*.tmp
+
+# Packaging
+*.tar.gz
+*.whl
+
+# Editor directories and files
+.idea/
+.vscode/
+*.sublime-project
+*.sublime-workspace
+
+# Logs and databases
+*.log
+*.sql
+*.sqlite
+
+# Ignore coverage files generated during tests
+.cache/
+.coverage
+.coverage.*
+
+# Images
+# *.png
+*.jpg
+*.jpeg
+# *.gif
+# *.svg
+*.zip
+
+# ffmpeg output
+*.mp4
+*.avi
+*.mkv
+*.mov
+
+# State files and tip files
+*.txt
+*.npy
+
+# Ignore vtk files
+*.vtk
+*.vtu

finitewave-0.9.0/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+## [0.9.0] March 2026
+
+### Added
+
+- Node-specific model parameters. You can now define model parameters as arrays with individual values for each mesh node. See the **parameter_regions.py** example.
+
+- External model library support. Cardiac models are now maintained in separate repositories and used as dependencies by Finitewave.
+
+- Observers. You can now attach observers that are evaluated during the simulation. See the **observers.py** example.
+
+- Lazy imports and environment checks for heavy or 'problematic' dependencies.
+
+---
+
+### Changed
+
+- Removed **2D/3D** prefixes from class names.  
+  Example: use **CardiacTissue** instead of **CardiacTissue2D** or **CardiacTissue3D**.  
+  The framework automatically adjusts dimensionality based on the mesh.
+
+- Kernel generation system. Finitewave now uses kernel generators to compose computational steps.  
+  This enables node-specific parameters and observer integration.
+
+- **VariablesTracker** replaces both **VariableTracker** and **MultiVariableTracker**.  
+  Use **VariablesTracker** in the same way as the former **MultiVariableTracker**.
+
+- Finitewave is now available via **pip**.
+
+---
+
+### Notes
+
+- The old **2D/3D** class prefixes are still supported for backward compatibility.  
+  Existing scripts remain compatible with this version.

finitewave-0.9.0/CITATION.cff

@@ -0,0 +1,10 @@
+cff-version: 1.2.0
+title: Finitewave
+message: "If you use Finitewave in your research, please cite this repository."
+authors:
+  - family-names: Nezlobinsky
+    given-names: Timur
+  - family-names: Okenov
+    given-names: Arstanbek
+repository-code: https://github.com/finitewave/finitewave
+license: MIT

finitewave-0.9.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 TiNezlobinsky
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.