getter-one 0.1.1__tar.gz

getter_one-0.1.1/LICENSE

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

getter_one-0.1.1/PKG-INFO

@@ -0,0 +1,259 @@
+Metadata-Version: 2.4
+Name: getter-one
+Version: 0.1.1
+Summary: GETTER One: Geometric Event-driven Tensor-based Time-series Extraction & Recognition - Structural event detection and causal network extraction for N-dimensional time series
+Author-email: Masamichi Iizumi <m.iizumi@miosync.email>
+Maintainer-email: Masamichi Iizumi <m.iizumi@miosync.email>
+License: MIT
+Project-URL: Homepage, https://github.com/miosync-masa/getter-one
+Project-URL: Repository, https://github.com/miosync-masa/getter-one
+Project-URL: Issues, https://github.com/miosync-masa/getter-one/issues
+Keywords: time-series,event-detection,causal-inference,structural-analysis,tensor-field,network-extraction,discrete-geometry,multivariate,lambda3,getter-one
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+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: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy<2.0.0,>=1.22.0
+Requires-Dist: scipy>=1.9.0
+Requires-Dist: pandas>=1.5.0
+Provides-Extra: gpu
+Requires-Dist: cupy-cuda12x>=13.0.0; extra == "gpu"
+Provides-Extra: gpu-cuda11
+Requires-Dist: cupy-cuda11x>=12.0.0; extra == "gpu-cuda11"
+Provides-Extra: viz
+Requires-Dist: matplotlib>=3.5.0; extra == "viz"
+Requires-Dist: plotly>=5.0.0; extra == "viz"
+Provides-Extra: excel
+Requires-Dist: openpyxl>=3.0.0; extra == "excel"
+Provides-Extra: parquet
+Requires-Dist: pyarrow>=10.0.0; extra == "parquet"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Provides-Extra: full
+Requires-Dist: getter-one[dev,excel,gpu,parquet,viz]; extra == "full"
+Dynamic: license-file
+
+# GETTER One
+
+**Geometric Event-driven Tensor-based Time-series Extraction & Recognition**
+
+*Omnidimensional Network Engine*
+
+[![CI](https://github.com/miosync-masa/getter-one/actions/workflows/ci.yml/badge.svg)](https://github.com/miosync-masa/getter-one/actions)
+[![PyPI](https://img.shields.io/pypi/v/getter-one)](https://pypi.org/project/getter-one/)
+[![Python](https://img.shields.io/pypi/pyversions/getter-one)](https://pypi.org/project/getter-one/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+GETTER One is a **discrete geometric framework** for structural event detection and causal network extraction in N-dimensional time series.
+
+It is **not** a forecasting model. It detects *what is changing*, *when*, and *which dimensions are driving the change* — using closed-form geometric computations with no MCMC, no gradient descent, and no threshold tuning.
+
+## Key Features
+
+- **Lambda³ (Λ³) structural analysis** — Computes displacement vectors (ΛF), structural tension (ρT), cross-dimension synchrony (σₛ), and cooperative events (ΔΛC) in closed form
+- **Causal network extraction** — Identifies directed, time-lagged causal relationships between dimensions
+- **Statistical confidence** — Permutation tests, bootstrap confidence intervals, and effect sizes (no Bayesian inference required)
+- **Domain-agnostic** — Works on any N-dimensional time series: weather, finance, sensors, biology
+- **Minimal dependencies** — Core requires only `numpy`, `scipy`, `pandas`
+- **GPU-ready** — Optional CUDA acceleration for large-scale datasets via CuPy
+
+## Installation
+
+```bash
+pip install getter-one
+```
+
+Optional extras:
+
+```bash
+pip install getter-one[gpu]       # CUDA/CuPy acceleration
+pip install getter-one[viz]       # matplotlib + plotly
+pip install getter-one[full]      # everything
+```
+
+## Quick Start
+
+```python
+from getter_one.pipeline import run
+
+# One line — full pipeline
+result = run("weather.csv", target="precipitation")
+print(result.report)
+```
+
+### Step by Step
+
+```python
+from getter_one.data import load
+from getter_one.structures import LambdaStructuresCore
+from getter_one.analysis import NetworkAnalyzerCore, assess_confidence
+
+# 1. Load data
+dataset = load("weather.csv", target="precipitation", normalize="range")
+
+# 2. Compute Λ³ structures
+core = LambdaStructuresCore()
+structures = core.compute_lambda_structures(
+    dataset.state_vectors, window_steps=24,
+    dimension_names=dataset.dimension_names,
+)
+
+# 3. Extract causal network
+analyzer = NetworkAnalyzerCore(sync_threshold=0.3, causal_threshold=0.25, max_lag=12)
+network = analyzer.analyze(dataset.state_vectors, dimension_names=dataset.dimension_names)
+
+# 4. Assess confidence
+confidence = assess_confidence(
+    state_vectors=dataset.state_vectors,
+    lambda_structures=structures,
+    network_result=network,
+    dimension_names=dataset.dimension_names,
+)
+```
+
+## CLI
+
+```bash
+# Run full pipeline
+getter-one run weather.csv --target precipitation --report report.md
+
+# Data preparation
+getter-one-loader load weather.csv --target precipitation -o prepared.csv
+getter-one-loader merge weather.csv air_quality.json --time date -o merged.csv
+getter-one-loader info data.csv
+
+# System info
+getter-one info
+getter-one check-gpu
+```
+
+## Pipeline Architecture
+
+```
+Input Data (csv/json/parquet/xlsx/npy)
+  │
+  ▼
+┌─────────────────────────────────┐
+│  Lambda³ Structures (Λ³)        │  Closed-form geometric computation
+│  ΛF, ΛFF, ρT, σₛ, Q_Λ, ΔΛC   │  No parameters to tune
+└──────────────┬──────────────────┘
+               │
+  ┌────────────┼────────────┐
+  ▼            ▼            ▼
+┌──────┐  ┌──────┐  ┌──────────┐
+│Bound │  │Topo  │  │Anomaly   │  Detection modules
+│ary   │  │Break │  │Detection │  (GPU-accelerated)
+└──┬───┘  └──┬───┘  └────┬─────┘
+   └─────────┼───────────┘
+             ▼
+┌─────────────────────────────────┐
+│  Causal Network Analysis        │  Sync + directed causal links
+│  Sync matrix, lag estimation    │  Hub/driver/follower detection
+└──────────────┬──────────────────┘
+               ▼
+┌─────────────────────────────────┐
+│  Confidence Assessment          │  Permutation test → p-values
+│  No MCMC, no Bayesian inference │  Bootstrap → confidence intervals
+└──────────────┬──────────────────┘
+               ▼
+┌─────────────────────────────────┐
+│  Report Generation              │  Markdown report with all results
+└─────────────────────────────────┘
+```
+
+## What GETTER One Is (and Isn't)
+
+| | GETTER One | Traditional Models |
+|---|---|---|
+| **Purpose** | Structural event detection | Forecasting / prediction |
+| **Method** | Discrete geometry (closed-form) | Regression / deep learning |
+| **Parameters** | Window size only | Thresholds, hyperparameters |
+| **Output** | Events, boundaries, causal network | Predicted values |
+| **Relationship** | Complements prediction models | Competes with each other |
+
+GETTER One detects **what changed and why**, not **what will happen next**. It can be used as a feature extractor for prediction models — experiments show that combining raw data with GETTER One features improves Transformer event detection F1 by +5.7% over raw data alone, and outperforms adding 7 additional weather variables (+4.3% vs +6.1%).
+
+## Benchmark Results
+
+Causal inference benchmark against 5 established methods on synthetic data with ground truth (6 scenarios, 3 repeats each):
+
+| Method | Composite | F1 (dir) | Lag MAE | Sign Acc | Spurious |
+|--------|-----------|----------|---------|----------|----------|
+| **GETTER One** | **0.824** | **0.800** | **0.000** | **1.000** | 0.500 |
+| PCMCI+ | 0.873 | 0.741 | 0.000 | 1.000 | 0.000 |
+| VAR Granger | 0.812 | 0.630 | 0.067 | 0.933 | 0.000 |
+| Transfer Entropy | 0.417 | 0.456 | 0.958 | — | 0.500 |
+| Event XCorr | 0.599 | 0.589 | 0.077 | — | 0.333 |
+| Graphical Lasso | 0.119 | — | — | — | 1.000 |
+
+GETTER One achieves **perfect F1 = 1.000** on all event-driven scenarios (S1, S2, S7, S8) with **zero lag error** and **perfect sign accuracy**.
+
+## Real-World Application: Weather Network
+
+Analysis of 7 cities around Tokyo (hourly data, October 2024) reveals physically correct causal structures:
+
+**Precipitation causal network:**
+- Nagano → Gunma (lag=1h) → Saitama (lag=1h) — inland-to-plains propagation
+- Yamanashi → Gunma (lag=2h) — basin-to-plains flow
+- Drivers: Nagano, Yamanashi (mountain sources)
+- Followers: Saitama, Tochigi (downstream receivers)
+
+**Cross-variable causality (42D full analysis):**
+- Temperature changes → Surface pressure changes (lag=2-3h) — thermodynamic law rediscovered from data alone
+
+## Supported Data Formats
+
+| Format | Extension | Read | Write |
+|--------|-----------|------|-------|
+| CSV / TSV | `.csv`, `.tsv` | ✅ | ✅ |
+| JSON | `.json` | ✅ | — |
+| Parquet | `.parquet` | ✅ | — |
+| Excel | `.xlsx`, `.xls` | ✅ | — |
+| NumPy | `.npy`, `.npz` | ✅ | ✅ |
+
+## Project Structure
+
+```
+getter_one/
+├── data/           Data loading & merging (multi-format)
+├── structures/     Lambda³ structural computation (CPU)
+├── core/           GPU infrastructure (CuPy/CUDA)
+├── detection/      Boundary, topology, anomaly, phase-space detection
+├── analysis/       Network analysis, confidence assessment, report generation
+├── pipeline.py     Full pipeline orchestration
+└── cli.py          Command-line interface
+```
+
+## Related Projects
+
+- [**BANKAI-MD**](https://github.com/miosync-masa/bankai) — GPU-accelerated molecular dynamics analysis built on the same Lambda³ theory. GETTER One is the domain-agnostic generalization; BANKAI-MD is the MD-specialized implementation.
+
+## Citation
+
+Paper in preparation. If you use GETTER One in your research, please cite this repository.
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+*Built with 💕 by Masamichi & Tamaki*
+
+*CHANGE EAGLE // Aerial Type // Structure Detection*

getter_one-0.1.1/README.md

@@ -0,0 +1,210 @@
+# GETTER One
+
+**Geometric Event-driven Tensor-based Time-series Extraction & Recognition**
+
+*Omnidimensional Network Engine*
+
+[![CI](https://github.com/miosync-masa/getter-one/actions/workflows/ci.yml/badge.svg)](https://github.com/miosync-masa/getter-one/actions)
+[![PyPI](https://img.shields.io/pypi/v/getter-one)](https://pypi.org/project/getter-one/)
+[![Python](https://img.shields.io/pypi/pyversions/getter-one)](https://pypi.org/project/getter-one/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+GETTER One is a **discrete geometric framework** for structural event detection and causal network extraction in N-dimensional time series.
+
+It is **not** a forecasting model. It detects *what is changing*, *when*, and *which dimensions are driving the change* — using closed-form geometric computations with no MCMC, no gradient descent, and no threshold tuning.
+
+## Key Features
+
+- **Lambda³ (Λ³) structural analysis** — Computes displacement vectors (ΛF), structural tension (ρT), cross-dimension synchrony (σₛ), and cooperative events (ΔΛC) in closed form
+- **Causal network extraction** — Identifies directed, time-lagged causal relationships between dimensions
+- **Statistical confidence** — Permutation tests, bootstrap confidence intervals, and effect sizes (no Bayesian inference required)
+- **Domain-agnostic** — Works on any N-dimensional time series: weather, finance, sensors, biology
+- **Minimal dependencies** — Core requires only `numpy`, `scipy`, `pandas`
+- **GPU-ready** — Optional CUDA acceleration for large-scale datasets via CuPy
+
+## Installation
+
+```bash
+pip install getter-one
+```
+
+Optional extras:
+
+```bash
+pip install getter-one[gpu]       # CUDA/CuPy acceleration
+pip install getter-one[viz]       # matplotlib + plotly
+pip install getter-one[full]      # everything
+```
+
+## Quick Start
+
+```python
+from getter_one.pipeline import run
+
+# One line — full pipeline
+result = run("weather.csv", target="precipitation")
+print(result.report)
+```
+
+### Step by Step
+
+```python
+from getter_one.data import load
+from getter_one.structures import LambdaStructuresCore
+from getter_one.analysis import NetworkAnalyzerCore, assess_confidence
+
+# 1. Load data
+dataset = load("weather.csv", target="precipitation", normalize="range")
+
+# 2. Compute Λ³ structures
+core = LambdaStructuresCore()
+structures = core.compute_lambda_structures(
+    dataset.state_vectors, window_steps=24,
+    dimension_names=dataset.dimension_names,
+)
+
+# 3. Extract causal network
+analyzer = NetworkAnalyzerCore(sync_threshold=0.3, causal_threshold=0.25, max_lag=12)
+network = analyzer.analyze(dataset.state_vectors, dimension_names=dataset.dimension_names)
+
+# 4. Assess confidence
+confidence = assess_confidence(
+    state_vectors=dataset.state_vectors,
+    lambda_structures=structures,
+    network_result=network,
+    dimension_names=dataset.dimension_names,
+)
+```
+
+## CLI
+
+```bash
+# Run full pipeline
+getter-one run weather.csv --target precipitation --report report.md
+
+# Data preparation
+getter-one-loader load weather.csv --target precipitation -o prepared.csv
+getter-one-loader merge weather.csv air_quality.json --time date -o merged.csv
+getter-one-loader info data.csv
+
+# System info
+getter-one info
+getter-one check-gpu
+```
+
+## Pipeline Architecture
+
+```
+Input Data (csv/json/parquet/xlsx/npy)
+  │
+  ▼
+┌─────────────────────────────────┐
+│  Lambda³ Structures (Λ³)        │  Closed-form geometric computation
+│  ΛF, ΛFF, ρT, σₛ, Q_Λ, ΔΛC   │  No parameters to tune
+└──────────────┬──────────────────┘
+               │
+  ┌────────────┼────────────┐
+  ▼            ▼            ▼
+┌──────┐  ┌──────┐  ┌──────────┐
+│Bound │  │Topo  │  │Anomaly   │  Detection modules
+│ary   │  │Break │  │Detection │  (GPU-accelerated)
+└──┬───┘  └──┬───┘  └────┬─────┘
+   └─────────┼───────────┘
+             ▼
+┌─────────────────────────────────┐
+│  Causal Network Analysis        │  Sync + directed causal links
+│  Sync matrix, lag estimation    │  Hub/driver/follower detection
+└──────────────┬──────────────────┘
+               ▼
+┌─────────────────────────────────┐
+│  Confidence Assessment          │  Permutation test → p-values
+│  No MCMC, no Bayesian inference │  Bootstrap → confidence intervals
+└──────────────┬──────────────────┘
+               ▼
+┌─────────────────────────────────┐
+│  Report Generation              │  Markdown report with all results
+└─────────────────────────────────┘
+```
+
+## What GETTER One Is (and Isn't)
+
+| | GETTER One | Traditional Models |
+|---|---|---|
+| **Purpose** | Structural event detection | Forecasting / prediction |
+| **Method** | Discrete geometry (closed-form) | Regression / deep learning |
+| **Parameters** | Window size only | Thresholds, hyperparameters |
+| **Output** | Events, boundaries, causal network | Predicted values |
+| **Relationship** | Complements prediction models | Competes with each other |
+
+GETTER One detects **what changed and why**, not **what will happen next**. It can be used as a feature extractor for prediction models — experiments show that combining raw data with GETTER One features improves Transformer event detection F1 by +5.7% over raw data alone, and outperforms adding 7 additional weather variables (+4.3% vs +6.1%).
+
+## Benchmark Results
+
+Causal inference benchmark against 5 established methods on synthetic data with ground truth (6 scenarios, 3 repeats each):
+
+| Method | Composite | F1 (dir) | Lag MAE | Sign Acc | Spurious |
+|--------|-----------|----------|---------|----------|----------|
+| **GETTER One** | **0.824** | **0.800** | **0.000** | **1.000** | 0.500 |
+| PCMCI+ | 0.873 | 0.741 | 0.000 | 1.000 | 0.000 |
+| VAR Granger | 0.812 | 0.630 | 0.067 | 0.933 | 0.000 |
+| Transfer Entropy | 0.417 | 0.456 | 0.958 | — | 0.500 |
+| Event XCorr | 0.599 | 0.589 | 0.077 | — | 0.333 |
+| Graphical Lasso | 0.119 | — | — | — | 1.000 |
+
+GETTER One achieves **perfect F1 = 1.000** on all event-driven scenarios (S1, S2, S7, S8) with **zero lag error** and **perfect sign accuracy**.
+
+## Real-World Application: Weather Network
+
+Analysis of 7 cities around Tokyo (hourly data, October 2024) reveals physically correct causal structures:
+
+**Precipitation causal network:**
+- Nagano → Gunma (lag=1h) → Saitama (lag=1h) — inland-to-plains propagation
+- Yamanashi → Gunma (lag=2h) — basin-to-plains flow
+- Drivers: Nagano, Yamanashi (mountain sources)
+- Followers: Saitama, Tochigi (downstream receivers)
+
+**Cross-variable causality (42D full analysis):**
+- Temperature changes → Surface pressure changes (lag=2-3h) — thermodynamic law rediscovered from data alone
+
+## Supported Data Formats
+
+| Format | Extension | Read | Write |
+|--------|-----------|------|-------|
+| CSV / TSV | `.csv`, `.tsv` | ✅ | ✅ |
+| JSON | `.json` | ✅ | — |
+| Parquet | `.parquet` | ✅ | — |
+| Excel | `.xlsx`, `.xls` | ✅ | — |
+| NumPy | `.npy`, `.npz` | ✅ | ✅ |
+
+## Project Structure
+
+```
+getter_one/
+├── data/           Data loading & merging (multi-format)
+├── structures/     Lambda³ structural computation (CPU)
+├── core/           GPU infrastructure (CuPy/CUDA)
+├── detection/      Boundary, topology, anomaly, phase-space detection
+├── analysis/       Network analysis, confidence assessment, report generation
+├── pipeline.py     Full pipeline orchestration
+└── cli.py          Command-line interface
+```
+
+## Related Projects
+
+- [**BANKAI-MD**](https://github.com/miosync-masa/bankai) — GPU-accelerated molecular dynamics analysis built on the same Lambda³ theory. GETTER One is the domain-agnostic generalization; BANKAI-MD is the MD-specialized implementation.
+
+## Citation
+
+Paper in preparation. If you use GETTER One in your research, please cite this repository.
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+*Built with 💕 by Masamichi & Tamaki*
+
+*CHANGE EAGLE // Aerial Type // Structure Detection*