art-tseries 0.1.0__tar.gz

art_tseries-0.1.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: art-tseries
+Version: 0.1.0
+Summary: Box-Jenkins-Treadway time series model-building toolkit + MCP server (uses fue and pyfug)
+Author-email: "David E. Guerrero" <davidesg@ucm.es>
+License: GPL-2.0-or-later
+Keywords: time series,ARIMA,Box-Jenkins,Treadway,MCP,forecasting
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+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
+Requires-Dist: fue>=0.1.3
+Requires-Dist: pyfug>=2.0
+Requires-Dist: numpy>=1.24
+Requires-Dist: matplotlib>=3.7
+Requires-Dist: scipy>=1.10
+Requires-Dist: statsmodels>=0.14
+Requires-Dist: mcp>=1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+
+# ART — Box-Jenkins-Treadway time series toolkit + MCP server
+
+`art-tseries` (ART) builds univariate time series models following the
+**Box-Jenkins-Treadway** methodology: an iterative, decision-driven process that
+uses graphical tools and formal tests to identify, estimate, diagnose and refine
+a model until it is adequate and parsimonious.
+
+ART is the orchestration layer of a four-part suite:
+
+| Package | Role |
+|---------|------|
+| **[fue](https://pypi.org/project/fue/)** | Exact maximum-likelihood estimation (ARMAX + transfer functions) and **FUF** forecasting. C engine with a pure-Python fallback. |
+| **pyfug** | High-definition graphics for time series analysis. |
+| **ART** (`art-tseries`) | Identification, model building, diagnosis, formal tests, versioning — and an **MCP server** that exposes all of this to an LLM. |
+
+The Box-Jenkins-Treadway loop needs *judgement* at each decision node. ART
+supplies the evidence (graphs, tests, numbers); a human analyst and/or Claude
+supply the criterion. Two modes:
+
+- **Guided** — analyst + Claude: Claude proposes with arguments, the analyst decides.
+- **Autonomous** — Claude/heuristic decides every step and presents a final model.
+
+## Install
+
+```bash
+pip install art-tseries          # pulls fue + pyfug automatically
+```
+
+This installs the `art-mcp` command (the MCP server).
+
+## Use as an MCP server (Claude Code, etc.)
+
+```bash
+claude mcp add art -- art-mcp
+```
+
+Then ask Claude to analyse a series. ART will ask whether you want a **guided**
+or **autonomous** analysis and drive the workflow from there.
+
+## Use as a library
+
+```python
+import fue
+from art.describe import describe_boxcox, describe_identification, model_equation
+
+ts, _ = fue.inp.load("series.inp")
+print(describe_boxcox(ts).summary)
+```
+
+## Methodology
+
+The model-building process is iterative and sequential: each estimation starts
+from the previous likelihood optimum (the `.pre` of the previous model), and
+every step produces a `.pre` (estimated parameters as initial values) and a
+`.out` (results), mirroring `fue`. Decisions and changes are recorded in a
+`guion.json` audit trail. See `docs/ARCHITECTURE.md` for the full design and the
+evidence-vs-criterion philosophy.
+
+## License
+
+GPL-2.0-or-later. © David E. Guerrero.

art_tseries-0.1.0/README.md

@@ -0,0 +1,61 @@
+# ART — Box-Jenkins-Treadway time series toolkit + MCP server
+
+`art-tseries` (ART) builds univariate time series models following the
+**Box-Jenkins-Treadway** methodology: an iterative, decision-driven process that
+uses graphical tools and formal tests to identify, estimate, diagnose and refine
+a model until it is adequate and parsimonious.
+
+ART is the orchestration layer of a four-part suite:
+
+| Package | Role |
+|---------|------|
+| **[fue](https://pypi.org/project/fue/)** | Exact maximum-likelihood estimation (ARMAX + transfer functions) and **FUF** forecasting. C engine with a pure-Python fallback. |
+| **pyfug** | High-definition graphics for time series analysis. |
+| **ART** (`art-tseries`) | Identification, model building, diagnosis, formal tests, versioning — and an **MCP server** that exposes all of this to an LLM. |
+
+The Box-Jenkins-Treadway loop needs *judgement* at each decision node. ART
+supplies the evidence (graphs, tests, numbers); a human analyst and/or Claude
+supply the criterion. Two modes:
+
+- **Guided** — analyst + Claude: Claude proposes with arguments, the analyst decides.
+- **Autonomous** — Claude/heuristic decides every step and presents a final model.
+
+## Install
+
+```bash
+pip install art-tseries          # pulls fue + pyfug automatically
+```
+
+This installs the `art-mcp` command (the MCP server).
+
+## Use as an MCP server (Claude Code, etc.)
+
+```bash
+claude mcp add art -- art-mcp
+```
+
+Then ask Claude to analyse a series. ART will ask whether you want a **guided**
+or **autonomous** analysis and drive the workflow from there.
+
+## Use as a library
+
+```python
+import fue
+from art.describe import describe_boxcox, describe_identification, model_equation
+
+ts, _ = fue.inp.load("series.inp")
+print(describe_boxcox(ts).summary)
+```
+
+## Methodology
+
+The model-building process is iterative and sequential: each estimation starts
+from the previous likelihood optimum (the `.pre` of the previous model), and
+every step produces a `.pre` (estimated parameters as initial values) and a
+`.out` (results), mirroring `fue`. Decisions and changes are recorded in a
+`guion.json` audit trail. See `docs/ARCHITECTURE.md` for the full design and the
+evidence-vs-criterion philosophy.
+
+## License
+
+GPL-2.0-or-later. © David E. Guerrero.

art_tseries-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=60", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name            = "art-tseries"
+version         = "0.1.0"
+description     = "Box-Jenkins-Treadway time series model-building toolkit + MCP server (uses fue and pyfug)"
+readme          = "README.md"
+license         = { text = "GPL-2.0-or-later" }
+requires-python = ">=3.10"
+authors         = [
+    { name = "David E. Guerrero", email = "davidesg@ucm.es" },
+]
+keywords        = ["time series", "ARIMA", "Box-Jenkins", "Treadway", "MCP", "forecasting"]
+classifiers     = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering :: Mathematics",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "fue>=0.1.3",
+    "pyfug>=2.0",
+    "numpy>=1.24",
+    "matplotlib>=3.7",
+    "scipy>=1.10",
+    "statsmodels>=0.14",
+    "mcp>=1.0",
+]
+
+[project.optional-dependencies]
+dev  = ["pytest>=7"]
+
+[project.scripts]
+art-mcp = "art.mcp_server:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

art_tseries-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

art_tseries-0.1.0/src/art/__init__.py

@@ -0,0 +1,69 @@
+from .identification import (
+    IdentificationListing, identification_listing,
+    BoxCoxSelection, boxcox_selection,
+    plot_boxcox_selection, save_boxcox_selection,
+    save_identification_report,
+    UnitRootResult, unit_root_tests, recommended_d,
+)
+from .seasonal_detection import (
+    SeasonalDetectionResult, detect_seasonality,
+    plot_seasonality, save_seasonality,
+)
+from .model_detection import (
+    ModelSpec, suggest_orders,
+    plot_model_comparison, save_model_detection_report,
+)
+from .diagnosis import (
+    DiagnosisResult, diagnose,
+    plot_diagnosis, plot_diagnosis_histogram, save_diagnosis_report,
+)
+from .formal_tests import (
+    ShinFullerResult, shin_fuller,
+    DCDResult, dcd, dcd_f,
+    RVResult, rv,
+    MEGResult, meg,
+)
+from .interventions import (
+    OutlierWarning, InterventionDiagnosis, diagnose_interventions,
+)
+from .full_report import FullReport, save_full_report
+from .guion import (
+    GuionStats, GuionEntry, Guion,
+    load_guion, save_guion,
+    _extract_spec, _extract_stats, _build_equation, export_guion_html,
+)
+from .describe import (
+    Description,
+    describe_boxcox, describe_seasonality, describe_identification,
+    describe_unit_root,
+    describe_diagnosis, describe_formal_tests, describe_interventions,
+    describe_prelim_scan,
+    _sample_acf_raw, _acf_outlier_contributions,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    "IdentificationListing", "identification_listing",
+    "BoxCoxSelection", "boxcox_selection",
+    "plot_boxcox_selection", "save_boxcox_selection",
+    "save_identification_report",
+    "SeasonalDetectionResult", "detect_seasonality",
+    "plot_seasonality", "save_seasonality",
+    "ModelSpec", "suggest_orders",
+    "plot_model_comparison", "save_model_detection_report",
+    "DiagnosisResult", "diagnose",
+    "plot_diagnosis", "plot_diagnosis_histogram", "save_diagnosis_report",
+    "ShinFullerResult", "shin_fuller",
+    "DCDResult", "dcd", "dcd_f",
+    "RVResult", "rv",
+    "MEGResult", "meg",
+    "OutlierWarning", "InterventionDiagnosis", "diagnose_interventions",
+    "FullReport", "save_full_report",
+    "UnitRootResult", "unit_root_tests", "recommended_d",
+    "describe_unit_root",
+    "describe_prelim_scan",
+    "_sample_acf_raw", "_acf_outlier_contributions",
+    "GuionStats", "GuionEntry", "Guion",
+    "load_guion", "save_guion",
+    "_extract_spec", "_extract_stats", "_build_equation", "export_guion_html",
+]