echopile 0.95.0__tar.gz

echopile-0.95.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 echopile contributors
+
+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.

echopile-0.95.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include LICENSE
+include README.md
+prune tests
+prune examples
+prune other_codes
+recursive-exclude * __pycache__
+recursive-exclude * *.py[cod]

echopile-0.95.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: echopile
+Version: 0.95.0
+Summary: Dash application for pile integrity signal analysis
+Author: echopile contributors
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: dash>=2.14
+Requires-Dist: dash-bootstrap-components>=1.5
+Requires-Dist: dash-mantine-components>=0.14
+Requires-Dist: dash-iconify>=0.1.2
+Requires-Dist: matplotlib>=3.7
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: plotly>=5.18
+Requires-Dist: scipy>=1.10
+Requires-Dist: EMD-signal>=1.6
+Provides-Extra: segy
+Requires-Dist: fsspec>=2024.2.0; extra == "segy"
+Requires-Dist: segy>=0.3; extra == "segy"
+Dynamic: license-file
+
+# echopile
+
+`echopile` is a Dash application for pile integrity signal loading, processing, and visual analysis.
+
+## Requirements
+
+- Python 3.10 or newer
+
+## Install
+
+Core install:
+
+```bash
+pip install .
+```
+
+Install with SEG-Y support:
+
+```bash
+pip install .[segy]
+```
+
+## Run
+
+From an installed package:
+
+```bash
+echopile
+```
+
+Or directly from source:
+
+```bash
+python -m echopile
+```
+
+The app starts on `http://127.0.0.1:8050` by default.
+
+## Example workflow
+
+1. Launch the app.
+2. Load one of the files from [`examples/`](examples/).
+3. Start with [`Vel (Z_component) (big probe)_F_2000.snc`](examples/Vel%20(Z_component)%20(big%20probe)_F_2000.snc) to verify the full SNC workflow.
+4. Use [`A_9_kazachya.pp.CSV`](examples/A_9_kazachya.pp.CSV) for PET import and [`ZBL1.txt`](examples/ZBL1.txt) for ZBL text import.
+5. If SEG-Y support is installed, load [`0305_no-arm.sgy`](examples/0305_no-arm.sgy).
+
+## Tests
+
+Run the current regression suite from the project root:
+
+```bash
+python -m unittest discover -s tests
+```
+
+## Release checklist
+
+- Build source and wheel artifacts:
+
+```bash
+python -m build
+```
+
+- Smoke test the installed wheel:
+
+```bash
+pip install dist/*.whl
+echopile --host 127.0.0.1 --port 8050
+```

echopile-0.95.0/README.md

@@ -0,0 +1,68 @@
+# echopile
+
+`echopile` is a Dash application for pile integrity signal loading, processing, and visual analysis.
+
+## Requirements
+
+- Python 3.10 or newer
+
+## Install
+
+Core install:
+
+```bash
+pip install .
+```
+
+Install with SEG-Y support:
+
+```bash
+pip install .[segy]
+```
+
+## Run
+
+From an installed package:
+
+```bash
+echopile
+```
+
+Or directly from source:
+
+```bash
+python -m echopile
+```
+
+The app starts on `http://127.0.0.1:8050` by default.
+
+## Example workflow
+
+1. Launch the app.
+2. Load one of the files from [`examples/`](examples/).
+3. Start with [`Vel (Z_component) (big probe)_F_2000.snc`](examples/Vel%20(Z_component)%20(big%20probe)_F_2000.snc) to verify the full SNC workflow.
+4. Use [`A_9_kazachya.pp.CSV`](examples/A_9_kazachya.pp.CSV) for PET import and [`ZBL1.txt`](examples/ZBL1.txt) for ZBL text import.
+5. If SEG-Y support is installed, load [`0305_no-arm.sgy`](examples/0305_no-arm.sgy).
+
+## Tests
+
+Run the current regression suite from the project root:
+
+```bash
+python -m unittest discover -s tests
+```
+
+## Release checklist
+
+- Build source and wheel artifacts:
+
+```bash
+python -m build
+```
+
+- Smoke test the installed wheel:
+
+```bash
+pip install dist/*.whl
+echopile --host 127.0.0.1 --port 8050
+```

echopile-0.95.0/echopile/__init__.py

@@ -0,0 +1,2 @@
+__all__ = ["__version__"]
+__version__ = "0.95.0"

echopile-0.95.0/echopile/__main__.py

@@ -0,0 +1,30 @@
+import argparse
+import sys
+from pathlib import Path
+
+if __package__ in (None, ""):
+    project_root = Path(__file__).resolve().parent.parent
+    if str(project_root) not in sys.path:
+        sys.path.insert(0, str(project_root))
+    from echopile.app import build_app
+else:
+    from .app import build_app
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Launch echopile Dash app")
+    parser.add_argument("--host", default="127.0.0.1")
+    parser.add_argument("--port", type=int, default=8050)
+    parser.add_argument("--debug", action="store_true")
+    args = parser.parse_args()
+
+    app = build_app()
+    app.run(
+        host=args.host,
+        port=args.port,
+        debug=args.debug,
+        use_reloader=args.debug,
+    )
+
+if __name__ == "__main__":
+    main()

echopile-0.95.0/echopile/app/__init__.py

@@ -0,0 +1,5 @@
+"""Interactive application package for echopile."""
+
+from .app import build_app
+
+__all__ = ["build_app"]

echopile-0.95.0/echopile/app/app.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from dash import Dash, _dash_renderer
+import dash_bootstrap_components as dbc
+import plotly.io as pio
+
+from ..config import APP_TITLE, PLOTLY_TEMPLATE
+from ..ui_components import build_layout
+from .profiles import resolve_profile
+
+
+def build_app(profile=None):
+    profile_obj = resolve_profile(profile)
+    pio.templates.default = PLOTLY_TEMPLATE  # use plain Plotly (no theme)
+    package_dir = Path(__file__).resolve().parents[1]
+    app = Dash(
+        external_stylesheets=[dbc.themes.JOURNAL],
+        assets_folder=str(package_dir / 'assets'),
+    )
+    app._echopile_profile = profile_obj.name
+    app.title = APP_TITLE
+    app._favicon = 'favicon.ico'
+    _dash_renderer._set_react_version('18.2.0')
+    app.layout = build_layout()
+    # Import after app/layout exist so Dash callback decorators can register.
+    from .callbacks import handlers  # noqa: F401
+    return app

echopile-0.95.0/echopile/app/callbacks/__init__.py

@@ -0,0 +1 @@
+"""Callback implementation package for echopile."""