Automatisez les calculs RF en Python avec rftools

Pourquoi automatiser les calculs RF ?

Écoutez, faire un calcul VSWR à la main n'est pas grave. Mais lorsque vous devez parcourir 50 longueurs de câble différentes, comparer les budgets de liaisons pour une douzaine d'options d'antennes ou créer un bloc-notes Jupyter pour votre prochaine révision de conception, cliquer sur des formulaires Web devient vite obsolète.

Le package Python rftools place l'intégralité du moteur de calcul rftools.io directement dans votre environnement Python. Pas de web scraping, pas de copie de numéros entre les fenêtres, juste des appels de fonction simples avec les types appropriés. J'ai vu trop de feuilles de calcul contenant des formules erronées et des erreurs de copier-coller. C'est plus propre.

Installation

§ 0§

Vous aurez besoin d'une clé API gratuite provenant de rftools.io/pricing. Le niveau gratuit vous permet de passer 5 appels par mois, ce qui est suffisant pour démarrer. Si vous intégrez cela à un flux de travail réel ou si vous effectuez régulièrement des balayages, le niveau d'API vous fait passer à 10 000 appels par mois. C'est suffisant pour la plupart des vrais travaux.

Votre premier calcul

§ 1§

La fonctionrftools.calculate()renvoie un objetCalculatorResult. Il se comporte comme un dictionnaire, vous pouvez donc extraire les résultats par clé. C'est assez simple : vous transmettez le slug de la calculatrice et un dict d'entrées, et vous obtenez vos réponses.

Stubs typés pour la saisie semi-automatique de l'IDE

Si vous souhaitez une meilleure visibilité et une saisie semi-automatique appropriée de l'IDE (et vous devriez le faire), utilisez les modules de catégorie typés au lieu de la fonction génériquecalculate():

from rftools.calculators import rf, antenna, pcb

# Parameter names and defaults match what you see on the rftools.io web UI
fspl = rf.free_space_path_loss(frequency=2400.0, distance=100.0)
print(f'FSPL: {fspl["pathLoss"]:.1f} dB')  # 80.0 dB

dipole = antenna.dipole_antenna(frequency=433.0)
print(f'Dipole length: {dipole["length"]:.0f} mm')

Les 13 catégories sont disponibles :rf,pcb,power,signal,antenna,general,motor,protocol,emc,thermal,sensor,unit_conversionetaudio. Votre IDE vous montrera les signatures des fonctions, ce qui vaut mieux que de parcourir la documentation chaque fois que vous oubliez s'il s'agit dutxPowerou dutx_power.

Mode batch (niveau d'API)

C'est là que les choses deviennent utiles pour un vrai travail. L'API batch vous permet d'exécuter jusqu'à 50 calculs en une seule requête HTTP. C'est parfait pour les balayages de paramètres dans le cadre desquels vous auriez autrement effectué des dizaines d'appels d'API individuels :

import rftools

client = rftools.Client(api_key='rfc_live_xxx')
# or just: export RFTOOLS_API_KEY=rfc_live_xxx

distances = [10, 50, 100, 500, 1000]
results = client.batch([
    ('free-space-path-loss', {'frequency': 2400, 'distance': d})
    for d in distances
])

for d, r in zip(distances, results):
    if r.ok:
        print(f'{d:>6}m  →  {r.values["pathLoss"]:.1f} dB')

Sortie :

    10m  →  60.0 dB
    50m  →  74.0 dB
   100m  →  80.0 dB
   500m  →  94.0 dB
  1000m  →  100.0 dB

C'est bien plus rapide que de passer des appels individuels en boucle, et cela ne perturbe pas l'API avec un flot de requêtes. Le point de terminaison du lot est conçu exactement pour ce genre de choses.

Support asynchrone

Si vous créez un service FastAPI ou si vous travaillez dans un noyau Jupyter asynchrone, il existe unAsyncClientqui fonctionne parfaitement avec le modèle async/wait de Python :

§ 5

Le client asynchrone utilise la même API en arrière-plan, mais avec des E/S non bloquantes. Si vous utilisez déjà une base de code asynchrone, tout reste cohérent.

CLIP

Parfois, vous avez juste besoin d'une réponse rapide dans le terminal. L'outil de ligne de commanderftoolsgère les points suivants :

§ 6

Je l'utilise principalement pour les contrôles d'intégrité lorsque je suis déjà en ligne de commande et que je ne veux pas lancer Python. C'est également pratique dans les scripts shell si vous automatisez quelque chose de rapide et sale.

Gestion des erreurs

La bibliothèque déclenche des exceptions typées, ce qui vous permet de détecter des problèmes spécifiques plutôt que des erreurs génériques :

§ 7§

LeRateLimitErrorvous indique même combien de temps vous devez attendre avant de réessayer, ce qui est utile si vous intégrez une logique de nouvelle tentative dans un système de production. LeValidationErrorvous indiquera exactement quelle saisie était erronée, afin que vous ne soyez pas obligé de deviner.

Parcourir le catalogue des calculatrices

203 calculatrices sont disponibles. Vous pouvez les répertorier par programmation si vous devez créer des outils en plus de cela :

§ 8§

Cela est particulièrement utile si vous créez une interface utilisateur ou une couche d'automatisation qui doit découvrir quelles calculatrices sont disponibles et quels paramètres elles acceptent. Les métadonnées incluent les unités, les valeurs par défaut et les descriptions de chaque champ.

Un exemple pratique : Link Budget Sweep

Voici un exemple concret : tracer la puissance reçue en fonction de la distance pour une liaison 915 MHz. C'est le genre de chose que vous feriez dans un bloc-notes Jupyter lorsque vous déterminez si un lien se fermera à votre portée maximale.

§ 9

Cela vous donne un joli graphique logarithmique indiquant où votre lien tombe en dessous de la sensibilité du récepteur. Vous pouvez ajuster la puissance d'émission, les gains d'antenne ou la fréquence et constater immédiatement l'impact. Bien plus rapide que de tout recalculer à la main ou de cliquer 40 fois sur un formulaire Web.

Vous pouvez l'étendre pour inclure la marge de décoloration, comparer différentes configurations d'antennes ou superposer les données mesurées lors d'essais sur le terrain. Le fait est que vous disposez du moteur de calcul complet dans un environnement scriptable, ce qui vous permet de créer tous les outils d'analyse dont vous avez réellement besoin.

Pour commencer

Installez-le avecpip install rftools-io. Le code source et l'outil de suivi des problèmes se trouvent sur github.com/rftools/rftools-py. Rendez-vous sur rftools.io/pricing pour récupérer une clé API et voir les niveaux de tarification. Le niveau gratuit est idéal pour essayer des choses, mais si vous faites un travail sérieux, le niveau payant est suffisamment bon marché pour que vous n'y réfléchissiez pas à deux fois.