Aller au contenu

Telemachus

Format pivot ouvert, Parquet-native, pour la télématique haute fréquence.

PyPI Python DOI License: MIT (spec) / AGPL-3.0 (SDK)

Telemachus réconcilie la rigueur de la cinématique scientifique (GNSS+IMU multi-cadence 10-100 Hz, suivi du repère accéléromètre) et l'analytique flotte à l'échelle (OBD, métadonnées de trajet, état porteur) dans un seul format — interrogeable instantanément avec Pandas, Spark, DuckDB ou Athena.

pip install telemachus

Essayez le notebook de démo AEGIS (ouvrir dans Colab) pour voir le format en action sur un vrai dataset Open en 5 minutes.

  • Démarrage rapide

    Installer, valider votre premier fichier, charger un dataset exemple.

    Commencer

  • Guide

    Articles pratiques pour valider, lire et adapter des données Telemachus.

    Lire le guide

  • Concepts

    Le modèle en couches Telemachus record format, AccPeriod, CarrierState, multi-rate.

    Comprendre

  • RFCs

    La spécification normative, versionnée et revue sous licence MIT.

    Parcourir les RFCs

Ce que Telemachus apporte

  • Neutralité fabricant : un seul schéma pour l'IMU, le GNSS, le mouvement, l'OBD et les événements.
  • Modèle en couches : Telemachus (sortie device brute) → enriched (nettoyé et contextualisé) → events layer (événements).
  • Reproductibilité : chaque dataset embarque un manifest.yaml normatif (SPEC-02).
  • Ouverture : schémas, adapters de référence et outils Python sous licence MIT.

Où Telemachus se place dans l'écosystème télématique

Les fournisseurs se répartissent grossièrement en deux familles :

Type de fournisseur Exemples Ce qu'ils émettent
Fabricants de boîtiers (installés dans le véhicule) Danlaw, Teltonika, Queclink Sortie device brute → naturellement Telemachus
Fournisseurs de services (SaaS au-dessus d'un ou plusieurs boîtiers) Geotab, Samsara, Webfleet, Verizon Connect Données nettoyées et enrichies → naturellement enriched / events layer

Telemachus est la langue commune entre ces deux familles. Un constructeur peut publier un adapter qui projette son flux en Telemachus. Un opérateur de services peut soit consommer du Telemachus (et émettre son propre enriched/events layer), soit publier directement ses adapters vers enriched/events layer. Personne n'a besoin d'apprendre un énième format pour intégrer.

Pour qui ?

  • Data scientists et chercheurs

    Vous travaillez sur des logs qui existent déjà. Vous voulez un schéma stable pour que votre pipeline pandas ou DuckDB n'ait pas à être réécrit à chaque fournisseur. Et vous voulez un accord clair sur ce que « vitesse » ou « accélération » signifie, quelle que soit la source.

  • Concepteurs de dataloggers

    Vous concevez un device (ou un firmware) qui va produire des logs. Vous voulez viser un format déjà accepté par les consommateurs en aval, avec un validateur et une suite de tests.

Versions

Artefact Version
Dernière spec publiée v0.8 (2026-04-16) — 4 piliers SPEC
Dernier brouillon v0.8 — Telemachus Record Format (SPEC-01) + Dataset Manifest (SPEC-02)

Telemachus est hébergé dans un unique monorepo GitHub et publié sous forme d'un seul package PyPI : pip install telemachus.