agi-app-flight-telemetry 0.1.0__tar.gz

agi_app_flight_telemetry-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Jean-Pierre Morard, THALES SIX GTS France SAS
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
+following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following
+disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
+disclaimer in the documentation and/or other materials provided with the distribution.
+3. Neither the name of Jean-Pierre MORARD nor the names of its contributors, or THALES SIX GTS France SAS, may be used
+to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

agi_app_flight_telemetry-0.1.0/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: agi-app-flight-telemetry
+Version: 0.1.0
+Summary: AGILAB flight telemetry app project
+Author: Jean-Pierre Morard
+Maintainer: Jean-Pierre Morard
+License-Expression: BSD-3-Clause
+Project-URL: Documentation, https://thalesgroup.github.io/agilab
+Project-URL: Source, https://github.com/ThalesGroup/agilab/tree/main/src/agilab/lib/agi-app-flight-telemetry
+Project-URL: Issues, https://github.com/ThalesGroup/agilab/issues
+Project-URL: Homepage, https://github.com/ThalesGroup/agilab
+Project-URL: Repository, https://github.com/ThalesGroup/agilab
+Project-URL: Discussions, https://github.com/ThalesGroup/agilab/discussions
+Project-URL: Changelog, https://github.com/ThalesGroup/agilab/releases
+Keywords: agilab,apps,reproducibility,workflow-orchestration
+Classifier: Intended Audience :: Developers
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: agi-core<2027.0,>=2026.05.13
+Dynamic: license-file
+
+# agi-app-flight-telemetry
+
+[![PyPI version](https://img.shields.io/pypi/v/agi-app-flight-telemetry.svg?cacheSeconds=300)](https://pypi.org/project/agi-app-flight-telemetry/)
+[![Python versions](https://img.shields.io/pypi/pyversions/agi-app-flight-telemetry.svg)](https://pypi.org/project/agi-app-flight-telemetry/)
+[![License: BSD 3-Clause](https://img.shields.io/pypi/l/agi-app-flight-telemetry)](https://opensource.org/licenses/BSD-3-Clause)
+
+`agi-app-flight-telemetry` publishes the `flight_telemetry_project` AGILAB app project as a self-contained
+package payload. The package advertises the project through the `agilab.apps`
+entry point group so `AgiEnv(app="flight_telemetry_project")` can resolve it without a
+monorepo checkout.
+
+## Install
+
+```bash
+pip install agi-app-flight-telemetry
+```
+
+Most users install these app packages through the umbrella `agi-apps` package or
+through `agilab[ui]` / `agilab[examples]`.

agi_app_flight_telemetry-0.1.0/README.md

@@ -0,0 +1,19 @@
+# agi-app-flight-telemetry
+
+[![PyPI version](https://img.shields.io/pypi/v/agi-app-flight-telemetry.svg?cacheSeconds=300)](https://pypi.org/project/agi-app-flight-telemetry/)
+[![Python versions](https://img.shields.io/pypi/pyversions/agi-app-flight-telemetry.svg)](https://pypi.org/project/agi-app-flight-telemetry/)
+[![License: BSD 3-Clause](https://img.shields.io/pypi/l/agi-app-flight-telemetry)](https://opensource.org/licenses/BSD-3-Clause)
+
+`agi-app-flight-telemetry` publishes the `flight_telemetry_project` AGILAB app project as a self-contained
+package payload. The package advertises the project through the `agilab.apps`
+entry point group so `AgiEnv(app="flight_telemetry_project")` can resolve it without a
+monorepo checkout.
+
+## Install
+
+```bash
+pip install agi-app-flight-telemetry
+```
+
+Most users install these app packages through the umbrella `agi-apps` package or
+through `agilab[ui]` / `agilab[examples]`.

agi_app_flight_telemetry-0.1.0/pyproject.toml

@@ -0,0 +1,84 @@
+[project]
+version = "0.1.0"
+name = "agi-app-flight-telemetry"
+description = "AGILAB flight telemetry app project"
+requires-python = ">=3.11"
+readme = "README.md"
+authors = [
+    { name = "Jean-Pierre Morard" }
+]
+maintainers = [{ name = "Jean-Pierre Morard" }]
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+
+classifiers = [
+    "Intended Audience :: Developers",
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+]
+
+keywords = [
+    "agilab",
+    "apps",
+    "reproducibility",
+    "workflow-orchestration",
+]
+
+dependencies = ["agi-core>=2026.05.13,<2027.0"]
+
+[project.urls]
+Documentation = "https://thalesgroup.github.io/agilab"
+Source = "https://github.com/ThalesGroup/agilab/tree/main/src/agilab/lib/agi-app-flight-telemetry"
+Issues = "https://github.com/ThalesGroup/agilab/issues"
+Homepage = "https://github.com/ThalesGroup/agilab"
+Repository = "https://github.com/ThalesGroup/agilab"
+Discussions = "https://github.com/ThalesGroup/agilab/discussions"
+Changelog = "https://github.com/ThalesGroup/agilab/releases"
+
+[project.entry-points."agilab.apps"]
+flight_telemetry = "agi_app_flight_telemetry:project_root"
+flight_telemetry_project = "agi_app_flight_telemetry:project_root"
+
+[dependency-groups]
+dev = [
+    "pytest",
+]
+
+[tool.uv.sources.agi-core]
+    path = "../../core/agi-core"
+    editable = true
+
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+include-package-data = false
+package-dir = {"" = "src"}
+packages = ["agi_app_flight_telemetry"]
+
+[tool.setuptools.package-data]
+"agi_app_flight_telemetry" = [
+    "project/**/*",
+]
+
+[tool.setuptools.exclude-package-data]
+"agi_app_flight_telemetry" = [
+    "project/**/.venv/**",
+    "project/**/__pycache__/**",
+    "project/**/*.pyc",
+    "project/**/*.pyo",
+    "project/**/*.pyx",
+    "project/**/*.c",
+    "project/**/*.so",
+    "project/**/uv.lock",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["test"]

agi_app_flight_telemetry-0.1.0/setup.cfg

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

agi_app_flight_telemetry-0.1.0/setup.py

@@ -0,0 +1,47 @@
+from __future__ import annotations
+
+import importlib.util
+from pathlib import Path
+
+from setuptools import setup
+from setuptools.command.build_py import build_py as _build_py
+from setuptools.command.sdist import sdist as _sdist
+
+APP_PROJECT = 'flight_telemetry_project'
+PACKAGE_IMPORT = 'agi_app_flight_telemetry'
+
+
+def _load_build_support():
+    module_path = Path(__file__).resolve().parents[4] / "src" / "agilab" / "lib" / "app_project_build_support.py"
+    if not module_path.exists():
+        return None
+    spec = importlib.util.spec_from_file_location("agilab_app_project_build_support", module_path)
+    if spec is None or spec.loader is None:
+        raise RuntimeError(f"Unable to load app project build support from {module_path}")
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+
+def _copy_payload(target_root: Path) -> None:
+    support = _load_build_support()
+    if support is None:
+        return
+    changed = support.copy_app_project_payload(APP_PROJECT, target_root)
+    for pyproject_path in changed:
+        print(f"[{PACKAGE_IMPORT}] sanitized packaged app manifest: {pyproject_path}")
+
+
+class build_py(_build_py):
+    def run(self):
+        super().run()
+        _copy_payload(Path(self.build_lib) / PACKAGE_IMPORT / "project")
+
+
+class sdist(_sdist):
+    def make_release_tree(self, base_dir, files):
+        super().make_release_tree(base_dir, files)
+        _copy_payload(Path(base_dir) / "src" / PACKAGE_IMPORT / "project")
+
+
+setup(cmdclass={"build_py": build_py, "sdist": sdist})

agi_app_flight_telemetry-0.1.0/src/agi_app_flight_telemetry/__init__.py

@@ -0,0 +1,33 @@
+"""Installed AGILAB app project provider for flight_telemetry_project."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+APP_SLUG = 'flight_telemetry'
+PROJECT_NAME = 'flight_telemetry_project'
+PACKAGE_NAME = 'agi-app-flight-telemetry'
+
+
+def package_root() -> Path:
+    return Path(__file__).resolve().parent
+
+
+def project_root() -> Path:
+    packaged_root = package_root() / "project" / PROJECT_NAME
+    if packaged_root.exists():
+        return packaged_root
+    source_root = Path(__file__).resolve().parents[4] / "apps" / "builtin" / PROJECT_NAME
+    return source_root if source_root.exists() else packaged_root
+
+
+def metadata() -> dict[str, str]:
+    return {
+        "slug": APP_SLUG,
+        "project": PROJECT_NAME,
+        "package": PACKAGE_NAME,
+        "project_root": str(project_root()),
+    }
+
+
+__all__ = ["APP_SLUG", "PACKAGE_NAME", "PROJECT_NAME", "metadata", "package_root", "project_root"]

agi_app_flight_telemetry-0.1.0/src/agi_app_flight_telemetry/project/flight_telemetry_project/README.md

@@ -0,0 +1,62 @@
+# Flight Telemetry Project
+
+`flight_telemetry_project` is the AGILAB install id for this built-in public flight example.
+
+The project focuses on a simple but useful workflow:
+- ingest flight data from files under shared storage
+- turn that input into a dataframe dataset under shared storage
+- inspect the result in the default AGILAB `view_maps` page and the optional
+  `view_maps_network` page
+
+## What it is good for
+
+- a compact end-to-end AGILAB demo around real-world flight data
+- validating the `PROJECT -> ORCHESTRATE -> WORKFLOW -> ANALYSIS` flow in one
+  packaged public app
+- showing how a raw data source becomes a reusable dataset for visual exploration
+
+## What is not implemented in the public version
+
+This public built-in example is intentionally narrow. It does **not** implement:
+- search-index ingestion inside this app; use an external app for that connector path
+- richer trajectory-centric study workflows
+- multi-stage trajectory reconstruction or scenario stitching
+- dedicated cross-run comparison views for complex flight studies
+- advanced trajectory replay, alignment, or domain-specific experiment dashboards
+
+The public version is meant to stay approachable: one small app that demonstrates
+data ingestion, pipeline reuse, and visual exploration without exposing a larger
+specialized workflow.
+
+## Main outputs
+
+Each run produces a structured flight dataframe dataset that can then be reused by
+analysis pages and downstream pipeline stages.
+
+Workers also emit a `reduce_summary_worker_<id>.json` `ReduceArtifact` beside
+the dataframe outputs. That summary records the reducer name, row count,
+aircraft/source-file counts, written output files, and trajectory distance/time-span
+fields so Release Decision can surface the flight run as first-class evidence.
+
+## Typical flow
+
+1. Select `flight_telemetry_project` in `PROJECT`.
+2. Configure the input source in `ORCHESTRATE`.
+3. Run the ingestion step.
+4. Inspect or extend the generated recipe in `WORKFLOW`.
+5. Explore the resulting dataset in `view_maps`, then open `view_maps_network`
+   when you want the network-style analysis route.
+
+Notebook imports do not try to infer flight UI intent from arbitrary code cells.
+The app declares compatible import views in `notebook_import_views.toml`, so the
+generic notebook importer can write a `notebook_import_view_plan.json` sidecar
+that matches declared flight views to produced artifacts.
+
+## What this teases in AGILAB
+
+This public example is only the entry point. The same framework can also support:
+- trajectory-focused studies with custom app logic and dedicated pages
+- replayable experiment pipelines built from generated or saved steps
+- richer domain-specific overlays on top of processed flight artifacts
+- distributed preprocessing and repeatable multi-run comparisons
+- domain-specific workflows that go beyond a generic dataframe export

agi_app_flight_telemetry-0.1.0/src/agi_app_flight_telemetry/project/flight_telemetry_project/dag_templates/flight_to_weather.json

@@ -0,0 +1,92 @@
+{
+  "schema": "agilab.multi_app_dag.v1",
+  "dag_id": "flight-to-weather-template",
+  "label": "Flight to weather review",
+  "description": "App-owned DAG template that hands flight reduce context to the weather forecast review app.",
+  "execution": {
+    "mode": "sequential_dependency_order",
+    "runner_status": "controlled_contract_stage_execution",
+    "adapter": "controlled_contract_dag",
+    "stage_bindings": {
+      "flight_context": "flight_telemetry_project.flight_context",
+      "weather_forecast_review": "weather_forecast_project.weather_forecast_review"
+    }
+  },
+  "nodes": [
+    {
+      "id": "flight_context",
+      "app": "flight_telemetry_project",
+      "execution": {
+        "entrypoint": "flight_telemetry_project.flight_context",
+        "params": {
+          "data_source": "file",
+          "files": "*",
+          "nfile": 1,
+          "nskip": 0,
+          "nread": 0,
+          "sampling_rate": 1.0,
+          "datemin": "2020-01-01",
+          "datemax": "2021-01-01",
+          "output_format": "parquet"
+        },
+        "stages": [],
+        "data_in": "flight/dataset",
+        "data_out": "flight/dataframe",
+        "reset_target": false
+      },
+      "purpose": "Run the flight scenario and produce trajectory summary context for downstream review.",
+      "produces": [
+        {
+          "id": "flight_reduce_summary",
+          "kind": "reduce_summary",
+          "path": "flight_analysis/reduce_summary_worker_0.json"
+        }
+      ]
+    },
+    {
+      "id": "weather_forecast_review",
+      "app": "weather_forecast_project",
+      "execution": {
+        "entrypoint": "weather_forecast_project.weather_forecast_review",
+        "params": {
+          "files": "*.csv",
+          "nfile": 1,
+          "station": "Paris-Montsouris",
+          "target_column": "tmax_c",
+          "lags": 7,
+          "horizon_days": 7,
+          "validation_days": 9,
+          "n_estimators": 100,
+          "random_state": 42
+        },
+        "stages": [],
+        "data_in": "weather_forecast/dataset",
+        "data_out": "weather_forecast/results",
+        "reset_target": false
+      },
+      "purpose": "Use flight summary context to produce forecast quality metrics for review.",
+      "consumes": [
+        {
+          "id": "flight_reduce_summary",
+          "kind": "reduce_summary",
+          "path": "flight_analysis/reduce_summary_worker_0.json"
+        }
+      ],
+      "produces": [
+        {
+          "id": "forecast_metrics",
+          "kind": "summary_metrics",
+          "path": "forecast_analysis/forecast_metrics.json"
+        }
+      ]
+    }
+  ],
+  "edges": [
+    {
+      "from": "flight_context",
+      "to": "weather_forecast_review",
+      "artifact": "flight_reduce_summary",
+      "handoff": "Use flight trajectory reduce summary as the forecast-review context."
+    }
+  ]
+}

agi_app_flight_telemetry-0.1.0/src/agi_app_flight_telemetry/project/flight_telemetry_project/notebook_import_views.toml

@@ -0,0 +1,56 @@
+schema = "agilab.notebook_import_views.v1"
+app = "flight_telemetry_project"
+description = "App-owned notebook import view declarations for flight artifacts."
+
+[[views]]
+id = "flight_map_dataframe"
+module = "view_maps"
+label = "Flight map"
+description = "Inspect imported flight dataframe artifacts as latitude/longitude map layers."
+priority = 10
+required_artifacts_any = [
+  "flight/dataframe/*.parquet",
+  "flight/dataframe/*.csv",
+  "*/flight/dataframe/*.parquet",
+  "*/flight/dataframe/*.csv",
+]
+optional_artifacts = [
+  "flight/dataframe/*.json",
+  "*/flight/dataframe/*.json",
+  "reduce_summary_worker_*.json",
+  "*/reduce_summary_worker_*.json",
+]
+launch_note = "Open this first for the public flight demo dataframe map."
+
+[views.settings_hints]
+dataset_subpath = "flight/dataframe"
+default_view = "view_maps"
+
+[[views]]
+id = "flight_network_overlay"
+module = "view_maps_network"
+label = "Flight network overlay"
+description = "Reuse flight trajectory artifacts with optional topology and allocation overlays."
+priority = 20
+required_artifacts_any = [
+  "flight/dataframe/*.parquet",
+  "flight/dataframe/*.csv",
+  "*/flight/dataframe/*.parquet",
+  "*/flight/dataframe/*.csv",
+  "*trajectory*.parquet",
+  "*trajectory*.csv",
+]
+optional_artifacts = [
+  "pipeline/topology.*",
+  "*/pipeline/topology.*",
+  "pipeline/edges.*",
+  "*/pipeline/edges.*",
+  "pipeline/routing_edges.*",
+  "*/pipeline/routing_edges.*",
+  "pipeline/allocations*.*",
+  "*/pipeline/allocations*.*",
+]
+launch_note = "Use this when the imported notebook also produced topology, edge, allocation, or trajectory overlay files."
+
+[views.query_params]
+datadir_rel = "flight/dataframe"

agi_app_flight_telemetry-0.1.0/src/agi_app_flight_telemetry/project/flight_telemetry_project/pipeline_view.dot

@@ -0,0 +1,15 @@
+digraph flight_pipeline {
+  rankdir=LR;
+  graph [fontname="Helvetica", fontsize=10];
+  node [shape=box, style="rounded,filled", fillcolor="#EEF7F2", color="#3F6B57", fontname="Helvetica", fontsize=10];
+  edge [color="#4F8068", arrowsize=0.8];
+
+  dataset [label="Flight telemetry input\nCSV trajectories"];
+  decode [label="Trajectory parsing\nlat/lon/time normalization"];
+  enrich [label="Route enrichment\nsegment distance + timing"];
+  reduce [label="Reduce summary\nworker trajectory metrics"];
+  artifacts [label="Map-ready artifacts\ntrajectory CSV + summaries"];
+  analysis [label="ANALYSIS views\nmaps + barycentric review"];
+
+  dataset -> decode -> enrich -> reduce -> artifacts -> analysis;
+}

agi_app_flight_telemetry-0.1.0/src/agi_app_flight_telemetry/project/flight_telemetry_project/pyproject.toml

@@ -0,0 +1,10 @@
+[project]
+name = "flight_telemetry_project"
+version = "0.1.0"
+description = "Built-in AGILab example app (flight telemetry preprocessing)"
+requires-python = ">=3.11"
+dependencies = ["agi-env>=2026.05.13.post3,<2027.0", "agi-node>=2026.05.13.post3,<2027.0", "agi-cluster>=2026.05.13.post3,<2027.0", "polars[rtcompat]", "pydantic", "py7zr", "streamlit>=1.56.0"]
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"