Tools.Drawing

Quelques fonctions de dessin utiles

Ce module contient des fonctions pour la génération de graphiques interactifs avec Plotly, notamment pour gérer des palettes de couleurs et ajouter des éléments visuels représentant des données de tests.

Structure :

  1. `get_color_map_by_name`

    • Génère un dictionnaire associant des noms à des couleurs à partir d’une palette spécifiée.

    • Prend en charge la répétition cyclique des couleurs si la palette est insuffisante.

  2. `draw_test_section`

    • Ajoute des éléments visuels à un graphique Plotly pour représenter les périodes associées à des tests.

    • Comprend des zones colorées semi-transparentes et des lignes verticales pour marquer les événements.

get_color_map_by_name(names: list[str], palette: list[str] = ['#636EFA', '#EF553B', '#00CC96', '#AB63FA', '#FFA15A', '#19D3F3', '#FF6692', '#B6E880', '#FF97FF', '#FECB52']) → dict[str, str][source]

Génère un dictionnaire associant chaque nom de fichier à une couleur unique.

Cette fonction prend une liste de noms de fichiers et associe une couleur de la palette spécifiée à chaque nom de fichier. Si le nombre de fichiers dépasse le nombre de couleurs disponibles dans la palette, elle réutilise les couleurs de manière cyclique.

Paramètres:

  • names – Liste des noms des fichiers pour lesquels une couleur doit être attribuée.

  • palette – Liste des couleurs à utiliser pour les fichiers. Si non spécifié, la palette Plotly est utilisée par défaut.

Renvoie:

Un dictionnaire où les clés sont les noms de fichiers et les valeurs sont les couleurs attribuées.

draw_test_section(fig: Figure, y_range: list, tests: list[dict], color_map: dict, last_time: float, row: int)[source]

Ajoute des barres verticales et des zones colorées pour chaque test dans un graphique Plotly.

Cette fonction ajoute des zones colorées en fonction des timestamps des tests et leur fichier associé, ainsi que des lignes verticales pour marquer chaque test. Elle est utilisée pour représenter graphiquement les périodes d’exécution de chaque test dans le temps.

Paramètres:

  • fig – L’objet figure de Plotly dans lequel les éléments (barres et lignes) seront ajoutés.

  • y_range – La plage des valeurs sur l’axe Y pour la section du graphique où les zones colorées seront tracées. La plage est définie par deux valeurs [y_min, y_max].

  • tests – Une liste de dictionnaires représentant les tests effectués. Chaque dictionnaire doit contenir les clés : - « Timestamp » (float) : Le timestamp du test. - « File » (str) : Le nom du fichier associé au test. - « Test » (str) : Le nom du test effectué.

  • color_map – Un dictionnaire associant chaque fichier de test à une couleur. Le fichier est utilisé comme clé et la couleur (en format HTML) comme valeur.

  • last_time – Le dernier timestamp enregistré, utilisé pour déterminer la fin de la zone colorée pour le dernier test.

  • row – L’index de la ligne dans la figure Plotly (utile lorsque plusieurs sous-graphiques sont utilisés) pour ajouter les éléments (barres verticales et zones colorées) dans la section correspondante.

Renvoie:

Cette fonction modifie l’objet fig en ajoutant des traces et des formes, mais ne retourne rien.