thibeq-sdk 0.1.0

Calcul de scores d'anomalie et conversions astronomiques

⚠️ AVERTISSEMENT BÊTA

Cette API est en version bêta. Ne l'utilisez PAS pour des applications cliniques, critiques ou de sécurité.
Usage recommandé : Recherche et expérimentation uniquement.

Installation

pip install thibeq-sdk

Démarrage rapide

from thibeq_sdk import ThibEqClient

# Initialiser le client
client = ThibEqClient(
    base_url="http://api.thibequation.com",
    api_key="your-api-key"
)

# Calculer un score ThibEquation
result = client.score(
    G=0.6,  # Facteur Géométrique/Physique
    K=0.7,  # Facteur Contextuel
    S=0.4,  # Facteur Documentation
    C=0.5   # Coefficient Fiabilité Témoin
)
print(f"ThibScore: {result['thibscore']}")

# Convertir des coordonnées astronomiques
coords = client.convert(
    lat=46.03,
    lon=-73.11,
    utc="2025-11-03T21:15:00Z",
    az=257.3,
    alt=42.1
)
print(f"RA: {coords['ra_h']}h, Dec: {coords['dec_deg']}°")

Fonctionnalités

Calcul de Score ThibEquation

La formule ThibEquation quantifie l'anomalie d'une observation :

ThibScore = (G × w_G + K × w_K + S × w_S) × C × 100

• G (0-1): Facteur Géométrique/Physique
• K (0-1): Facteur Contextuel
• S (0-1): Facteur Documentation
• C (0-1): Coefficient Fiabilité Témoin

Conversion de Coordonnées

Convertit des coordonnées horizontales (Azimut/Altitude) en coordonnées équatoriales (RA/Dec) avec calcul du Temps Sidéral Local (LST).

Gestion des Erreurs

Le SDK inclut des exceptions personnalisées :

from thibeq_sdk import (
    ThibEqError,
    ThibEqAuthError,
    ThibEqValidationError,
    ThibEqNetworkError
)

try:
    result = client.score(G=0.6, K=0.7, S=0.4, C=0.5)
except ThibEqAuthError:
    print("Authentification échouée")
except ThibEqValidationError as e:
    print(f"Paramètres invalides: {e}")
except ThibEqNetworkError as e:
    print(f"Erreur réseau: {e}")

Configuration Avancée

client = ThibEqClient(
    base_url="http://localhost:5000",
    api_key="your-key",
    timeout=10.0,      # Timeout en secondes (défaut: 5.0)
    max_retries=3      # Tentatives en cas d'erreur 502/503 (défaut: 1)
)

Développement

Installation des dépendances de développement

pip install -e ".[dev]"

Tests

# Tests unitaires
pytest

# Tests avec coverage
pytest --cov=thibeq_sdk

# Smoke test (nécessite une API en cours d'exécution)
python test_smoke.py

Linting et formatage

# Vérifier le code
ruff check .

# Formater le code
ruff format .

# Type checking
mypy thibeq_sdk.py

Documentation

• Repository: https://github.com/Thib4204/thibequation-api
• Issues: https://github.com/Thib4204/thibequation-api/issues

Citation

Si vous utilisez ce SDK dans vos recherches, veuillez citer :

Thibodeau, Pascal. (2025). THIBEQUATION – Certificat de complétion 2025 (v4.0). Zenodo.

@software{thibodeau_thibequation_2025,
  author       = {Thibodeau, Pascal},
  title        = {THIBEQUATION – Certificat de complétion 2025 (v4.0)},
  year         = 2025,
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.17510899},
  url          = {https://doi.org/10.5281/zenodo.17510899}
}

Licence

MIT License - Voir le fichier LICENSE pour plus de détails.

Auteur

Pascal Thibodeau (Thib4204)

ThibEquation SDK Python v0.1.0

⚠️ API en bêta - Pas d'usage clinique/critique