Technosport (tks-package)

Boîte à outils Python pour la lecture, le traitement et l'analyse de données biomécaniques et physiologiques, développée au sein du Technosport / ISM (Aix-Marseille Université).

Installation

# Depuis PyPI (une fois publié) :
pip install tks-package

# Ou directement depuis GitHub :
pip install git+https://github.com/Technosport/TKS-package.git

Pour les outils optionnels de développement et tests :

pip install "tks-package[dev] @ git+https://github.com/Technosport/TKS-package.git"

Démarrage rapide

import tks

# 1. Lecture de données (C3D, Delsys, QTM, Noraxon, Metalyzer, VO2 Master...)
data_c3d = tks.read_c3d("marche.c3d")
forces = data_c3d["Plateforms"]["PF_1"]["Force"]

# 2. Synchronisation de signaux
sig_synced, sig_ref, delta = tks.sync_two_signals(sig1, sig2, plot=True)

# 3. Analyse non-linéaire (Lyapunov & Floquet)
from tks.analysis import traitement_lyapunov_floquet
res = traitement_lyapunov_floquet(inlyap=data_kin, infloq=data_cycles, acq_freq=100.0)

# 4. Conversion Garmin FIT
from tks.converters import fit_to_df
df_fit = fit_to_df("activite.fit")

# 5. Thème graphique officiel ISM / Technosport pour figures Plotly
from tks.theme import setup_ism_theme
setup_ism_theme(target="powerpoint", logos=True)

💡 Note de compatibilité : Les anciens imports import TKS_package restent supportés pour assurer la rétrocompatibilité avec vos scripts existants.

Équipements & Formats pris en charge

Modules du package

• tks.readers : Import vers DataFrame / dict pour tous les formats de capteurs.
• tks.analyzer : Fréquences d'échantillonnage, rééchantillonnage, synchronisation, détection de pics, métriques semelles Moticon.
• tks.analysis : Analyse dynamique non-linéaire et stabilité (Lyapunov, Floquet, AMI, GFNN, reconstruction d'espace des phases).
• tks.converters : Conversion de fichiers FIT vers CSV et Excel.
• tks.theme : Charte graphique officielle ISM & Technosport pour figures scientifiques Plotly.
• tks.utils : Gestion de fichiers, calculs de repères 3D locaux, export multi-formats de figures.

Pipelines et scripts Visual3D (.v3s) disponibles sur le dépôt dédié : Technosport/Visual3D-Pipelines.