Passer au contenu principal

​
class Table

La classe Table permet d’afficher et d’analyser des données tabulaires. Contrairement aux feuilles de calcul traditionnelles, les Tables prennent en charge de nombreux types de données : des valeurs scalaires, des chaînes de caractères, des tableaux NumPy et la plupart des sous-classes de wandb.data_types.Media. Cela signifie que vous pouvez intégrer Images, Video, Audio et d’autres types de médias enrichis et annotés directement dans les Tables, aux côtés d’autres valeurs scalaires plus classiques. Cette classe est la classe principale utilisée pour générer des W&B Tables https://docs.wandb.ai/guides/models/tables/.

​
méthode Table.__init__

__init__(
    columns=None,
    data=None,
    rows=None,
    dataframe=None,
    dtype=None,
    optional=True,
    allow_mixed_types=False,
    log_mode: "Literal['IMMUTABLE', 'MUTABLE', 'INCREMENTAL'] | None" = 'IMMUTABLE'
)
Initialise un objet Table. Le paramètre rows est disponible pour des raisons de compatibilité et ne doit pas être utilisé. La classe Table utilise data pour reproduire l’API Pandas. Arguments :
  • columns: (List[str]) Noms des colonnes du tableau. Valeurs par défaut : [“Input”, “Output”, “Expected”].
  • data: (List[List[any]]) Tableau 2D de valeurs orienté par lignes.
  • dataframe: (pandas.DataFrame) Objet DataFrame utilisé pour créer le tableau. Lorsqu’il est défini, les arguments data et columns sont ignorés.
  • rows: (List[List[any]]) Tableau 2D de valeurs orienté par lignes.
  • optional: (Union[bool,List[bool]]) Détermine si les valeurs None sont autorisées. Valeur par défaut : True
    • S’il s’agit d’une valeur booléenne unique, le caractère facultatif est appliqué à toutes les colonnes spécifiées lors de la création
    • S’il s’agit d’une liste de valeurs booléennes, le caractère facultatif est appliqué à chaque colonne ; la liste doit avoir la même longueur que columns
  • allow_mixed_types: (bool) Détermine si les colonnes peuvent contenir des types mixtes (désactive la validation de type). Valeur par défaut : False
  • log_mode: Optional[str] Contrôle la façon dont la Table est enregistrée lorsque des modifications surviennent. Options :
    • “IMMUTABLE” (par défaut) : la Table ne peut être enregistrée qu’une seule fois ; les tentatives d’enregistrement suivantes après modification du tableau seront sans effet.
    • “MUTABLE” : la Table peut être enregistrée à nouveau après des modifications, créant une nouvelle version d’artifact à chaque enregistrement.
    • “INCREMENTAL” : les données de la Table sont enregistrées de façon incrémentielle, chaque enregistrement créant une nouvelle entrée d’artifact contenant les nouvelles données depuis le dernier enregistrement.

​
méthode Table.add_column

add_column(name, data, optional=False)
Ajoute une colonne de données au tableau. Arguments :
  • name: (str) - le nom unique de la colonne
  • data: (list | np.array) - une colonne de données homogènes
  • optional: (bool) - si les valeurs nulles sont autorisées

​
méthode Table.add_computed_columns

add_computed_columns(fn)
Ajoute une ou plusieurs colonnes calculées à partir des données existantes. Arguments :
  • fn : fonction qui accepte un ou deux paramètres, ndx (int) et row (dict), et qui doit renvoyer un dict représentant les nouvelles colonnes de cette ligne, avec pour clés les noms des nouvelles colonnes.
    • ndx est un entier représentant l’index de la ligne. Il est inclus uniquement si include_ndx est défini sur True.
    • row est un dictionnaire dont les clés correspondent aux colonnes existantes

​
méthode Table.add_data

add_data(*data)
Ajoute une nouvelle ligne de données au tableau. Le nombre maximal de lignes d’un tableau est déterminé par wandb.Table.MAX_ARTIFACT_ROWS. Le nombre d’éléments des données doit correspondre au nombre de colonnes du tableau.

​
méthode Table.add_row

add_row(*row)
Obsolète. Utilisez plutôt la méthode Table.add_data.

​
méthode Table.cast

cast(col_name, dtype, optional=False)
Convertit une colonne vers un type de données spécifique. Il peut s’agir d’une classe Python standard, d’un type interne de W&B ou d’un objet d’exemple, comme une instance de wandb.Image ou de wandb.Classes. Arguments :
  • col_name (str): Le nom de la colonne à convertir.
  • dtype (class, wandb.wandb_sdk.interface._dtypes.Type, any): Le type cible.
  • optional (bool): Indique si la colonne doit accepter des valeurs None.

​
méthode Table.get_column

get_column(name, convert_to=None)
Récupère une colonne du tableau et, éventuellement, la convertit en objet NumPy. Arguments :
  • name: (str) - le nom de la colonne
  • convert_to: (str, facultatif)
    • “numpy”: convertit les données sous-jacentes en objet NumPy

​
méthode Table.get_dataframe

get_dataframe()
Renvoie un pandas.DataFrame contenant le tableau.

​
méthode Table.get_index

get_index()
Renvoie un tableau d’indices de lignes à utiliser dans d’autres tableaux afin de créer des liens.