forecastscope 0.1.0__py3-none-any.whl

forecastscope/types.py

@@ -0,0 +1,12 @@
+"""Small numerical result type, independent of any application artifact schema."""
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class MethodForecast:
+    """Named point path and outer interval; units are those of the supplied history."""
+    name: str
+    family: str
+    point: tuple[float, ...]
+    lower: tuple[float, ...]
+    upper: tuple[float, ...]

forecastscope-0.1.0.dist-info/METADATA

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: forecastscope
+Version: 0.1.0
+Summary: Finite-prefix forecasting, temporal forecast combinations and sequence diagnostics.
+Author: Felipe Santibáñez-Leal
+License-Expression: MIT
+Project-URL: Repository, https://github.com/fsantibanezleal/CAOS_ForecastScope
+Project-URL: Issues, https://github.com/fsantibanezleal/CAOS_ForecastScope/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy<3,>=2.0
+Provides-Extra: diagnostics
+Requires-Dist: scipy<2,>=1.15; extra == "diagnostics"
+Requires-Dist: pandas<4,>=2.3; extra == "diagnostics"
+Requires-Dist: statsmodels<0.15,>=0.14.6; extra == "diagnostics"
+Requires-Dist: arch<9,>=8; extra == "diagnostics"
+Requires-Dist: ruptures<2,>=1.1.10; extra == "diagnostics"
+Requires-Dist: EMD-signal<2,>=1.9; extra == "diagnostics"
+Requires-Dist: PyWavelets<2,>=1.8; extra == "diagnostics"
+Requires-Dist: antropy<0.3,>=0.2.2; extra == "diagnostics"
+Requires-Dist: nolds==0.6.3; extra == "diagnostics"
+Requires-Dist: hurst==0.0.5; extra == "diagnostics"
+Requires-Dist: MFDFA==0.4.3; extra == "diagnostics"
+Requires-Dist: pycatch22<0.5,>=0.4.5; extra == "diagnostics"
+Requires-Dist: stumpy<2,>=1.14.1; extra == "diagnostics"
+Requires-Dist: scikit-learn<2,>=1.9; extra == "diagnostics"
+Requires-Dist: coreforecast<0.1,>=0.0.17; extra == "diagnostics"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff<0.17,>=0.15; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# forecastscope
+
+Finite-prefix forecasts, temporal combinations of reference experts, and sequence
+diagnostics in a reusable Python library. The core requires NumPy. Diagnostic
+implementations use optional scientific packages through `forecastscope.diagnostics`.
+
+Release availability is recorded on [PyPI](https://pypi.org/project/forecastscope/)
+and [GitHub](https://github.com/fsantibanezleal/CAOS_ForecastScope/releases).
+Application adoption is a separate step. The extraction preserves numerical
+equations while adding strict public request and output validation, lint
+normalization and warnings for unavailable optional diagnostics. It makes no new forecast
+accuracy, calibration, chaos-identification or operational-performance claim.
+
+```python
+import numpy as np
+from forecastscope import combine, forecast
+
+history = 20 + np.tile([1., 4., 2., 3.], 30)
+columns = forecast("HoltWinters", history, seasonality=4, horizon=8)
+allocation = combine("ValidationMix", history, seasonality=4, horizon=8)
+print(columns.shape, allocation.weights, allocation.origins)
+```
+
+The caller supplies a contiguous observed history; raw arrays contain no timestamps,
+so contiguity itself is a caller precondition. Future targets belong to the caller's evaluation
+protocol. NaNs, infinite values, fractional horizons, invalid seasonal lags and
+unsupported probability grids are refused by the public entry points. The reference kernels preserve their documented short-history policies, including
+Holt fallback when additive seasonal smoothing lacks two cycles or has lag one.
+Combination experts can consequently coincide on a nonseasonal input. The five
+reference experts use approximate Gaussian residual intervals; ordered columns do
+not establish calibration. Temporal validation filters an outer-prefix-defined
+historical grid, and does not reconstruct the exact grid a historical service
+would have proposed at every earlier date.
+
+The fixed contextual combination has an unfavorable comparison with its matching
+recency control in its original development study. Later validation-selected
+combinations have bounded point-score improvements on specified external collections,
+with stronger automatic-method and interval-score comparisons retained. The package
+does not turn those studies into a general superiority claim.
+
+For diagnostics, install the `diagnostics` extra and import the topic module, for
+example `forecastscope.diagnostics.sequence.matrix_profile`. Diagnostics describe
+their supplied sequence and can be retrospective. They must not be computed on a
+future block and then treated as prefix-only model-selection inputs.
+
+The source origin and exact input hashes are recorded in
+[docs/extraction-source.json](docs/extraction-source.json). The originating software
+is MIT licensed; its copyright and licence remain in this repository. Application
+cases, generator seeds, source CSVs, artifact schemas, pipeline stages and web assets
+are outside this library. See [the extraction boundary](docs/boundary.md).

forecastscope-0.1.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+forecastscope/__init__.py,sha256=dEaNYiGCK9Sbixndmoey3SwhYkL_zIsTBzLY5heD52A,197
+forecastscope/api.py,sha256=o44IkBduqhmApb-zn7hSwA0XeZ9JAbt2iAXslOrU6DA,3774
+forecastscope/forecasting.py,sha256=8QOG1O4RntSyB14kUkn9Vw65WOSVxRCc3IcvVhKhMuA,10786
+forecastscope/types.py,sha256=IjdIZUv-WdxlefuLLlX3WFbfJE2YhRSdxj7A1zcuQ88,370
+forecastscope/combinations/__init__.py,sha256=lern5haQjG2ZNkmYR0fSwJ9gJvsPmx_0gwFT4uGSajs,85
+forecastscope/combinations/context_memory.py,sha256=sg83Vh6ezrM4oWSoJLS7I9-DApl4OEM1eTpNfY2guA0,5264
+forecastscope/combinations/validated.py,sha256=zJ1ElDlKwLAs4X6yRk1OnlSHXHFngdnw1Q3VpDqfY10,6494
+forecastscope/diagnostics/__init__.py,sha256=AIJjbPYRAXDrUvpvkGfTRJKqIQJ3cuGazEAw9J0ZXUY,4515
+forecastscope/diagnostics/autocorrelation.py,sha256=oFtTjT2J1KEQgas16f8BQwFXVxBjpdrpr2XXEn4RBVI,10231
+forecastscope/diagnostics/causality.py,sha256=8QwjE-TyXzzakp7S22GT5FqwW9w2bPdpYoCagjNSaug,8702
+forecastscope/diagnostics/changepoints.py,sha256=xIKup3KBgeFiyVHaX254ericlY2p-n93F6iCuzJ1UcI,8137
+forecastscope/diagnostics/distribution.py,sha256=OdPOPVUXJ9RJY7_byq4HI_ZnNjn-g6MmfN73UiS1mIk,8900
+forecastscope/diagnostics/filters.py,sha256=EqhbI6tTDB0gqWDcLZfRCdL8P9pnqCd3xWzDpEZIe8w,9249
+forecastscope/diagnostics/fractal.py,sha256=xMl1LaCr7n0p7sjdKERbLryNfbSaUmTW4kBgGbwwh8w,9747
+forecastscope/diagnostics/nonlinear.py,sha256=09E54qZXFv35RxM1EBZ3oBUIzSrA-XJnnI_4JfqtvBg,12677
+forecastscope/diagnostics/seasonality.py,sha256=ycQa6QIw7vXj7scjpEeSR27VdkbKGvHxG25e6buaWs4,9308
+forecastscope/diagnostics/sequence.py,sha256=qJvH9TU_qJLpn8djg0NL3J1xfZiKaUK8bET74KiRyNo,6943
+forecastscope/diagnostics/stationarity.py,sha256=QkkMYUMOggEtFjMY-_IxoKIcULTlPKnS4cWKE78lcCk,10448
+forecastscope/diagnostics/volatility.py,sha256=EROHCodJ9SiCEmXBT-CZj9k2UhcEqspQwuYNUQKZchU,8903
+forecastscope-0.1.0.dist-info/licenses/LICENSE,sha256=rOxnRb9xsVTVlzpgyno82vGSy8WXWB7CGqF0cxh7HSQ,1079
+forecastscope-0.1.0.dist-info/METADATA,sha256=IhHMA75HIOI_pEx9UJl_hmnoa_Ro9lLP8A9S6hUZmUA,4590
+forecastscope-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+forecastscope-0.1.0.dist-info/top_level.txt,sha256=H83RDgCNs9lnwyVhqMzBbW6ABqlCWsK-YB74q1QC2bM,14
+forecastscope-0.1.0.dist-info/RECORD,,

forecastscope-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

forecastscope-0.1.0.dist-info/licenses/LICENSE

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

forecastscope-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+forecastscope