Afficher le code source
launch_add(
uri: Optional[str] = None,
job: Optional[str] = None,
config: Optional[Dict[str, Any]] = None,
template_variables: Optional[Dict[str, Union[float, int, str]]] = None,
project: Optional[str] = None,
entity: Optional[str] = None,
queue_name: Optional[str] = None,
resource: Optional[str] = None,
entry_point: Optional[List[str]] = None,
name: Optional[str] = None,
version: Optional[str] = None,
docker_image: Optional[str] = None,
project_queue: Optional[str] = None,
resource_args: Optional[Dict[str, Any]] = None,
run_id: Optional[str] = None,
build: Optional[bool] = (False),
repository: Optional[str] = None,
sweep_id: Optional[str] = None,
author: Optional[str] = None,
priority: Optional[int] = None
) -> "public.QueuedRun"
| Arguments | Description |
|---|---|
uri | URI de l’expérience à exécuter. Un URI de run wandb ou un URI de dépôt Git. |
job | Référence (string) à un wandb.Job, par exemple : wandb/test/my-job:latest |
config | Un dictionnaire contenant la configuration du run. Peut également contenir des arguments propres à la ressource sous la clé “resource_args” |
template_variables | Un dictionnaire contenant les valeurs des variables de modèle pour une file d’attente de run. Format attendu : {"VAR_NAME": VAR_VALUE} |
project | Projet cible auquel envoyer le run lancé |
entity | entity cible à laquelle envoyer le run lancé |
queue | Le nom de la file d’attente dans laquelle placer le run |
priority | Le niveau de priorité du job, 1 étant la priorité la plus élevée |
resource | Backend d’exécution du run : W&B prend en charge nativement le backend “local-container” |
entry_point | Point d’entrée à exécuter dans le projet. Par défaut, le point d’entrée du run d’origine est utilisé pour les URI wandb, et main.py pour les URI de dépôt Git. |
name | Nom sous lequel lancer le run. |
version | Pour les projets basés sur Git, un hash de commit ou un nom de branche. |
docker_image | Le nom de l’image Docker à utiliser pour le run. |
resource_args | Arguments liés à la ressource pour lancer des runs sur un backend distant. Ils sont stockés dans la configuration de lancement générée, sous resource_args. |
run_id | String facultative indiquant l’identifiant du run lancé |
build | Indicateur facultatif, false par défaut ; nécessite que la file d’attente soit définie. Si build est activé, une image est créée, un artifact de job est créé et une référence à cet artifact de job est téléversée dans la file d’attente |
repository | String facultative permettant de définir le nom du dépôt distant, utilisée lors du téléversement d’images vers un registre |
project_queue | String facultative permettant de définir le nom du projet de la file d’attente. Principalement utilisée pour la rétrocompatibilité avec les files d’attente limitées à un projet |
Exemple :
from wandb.sdk.launch import launch_add
project_uri = "https://github.com/wandb/examples"
params = {"alpha": 0.5, "l1_ratio": 0.01}
# Exécuter le projet W&B et créer un environnement Docker reproductible
# sur un hôte local
api = wandb.apis.internal.Api()
launch_add(uri=project_uri, parameters=params)
| Renvoie | Description |
|---|---|
une instance dewandb.api.public.QueuedRun qui fournit des informations sur le run en file d’attente ou, si wait_until_started ou wait_until_finished sont appelées, donne accès aux informations du run sous-jacent. |
| Exceptions levées | Description |
|---|---|
wandb.exceptions.LaunchError en cas d’échec |