vessl sweep

Overview

Run vessl sweep --help to view the list of commands, or vessl sweep [COMMAND] --help to view individual command instructions.

Create a sweep

vessl sweep create [OPTIONS]

Option	Description
-T, --objective-type	minimize or maximize
-G, --objective-goal	Objective goal ex. 0.99
-M, --objective-metric	Objective metric ex. val_accuracy
--num-experiments	Maximum number of experiments
--num-parallel	Number of experiments to be run in parallel
--num-failed	Maximum number of experiments to allow to fail
-a, --algorithm	grid, random, or bayesian
-p, --parameter (multiple)	Search space parameters in the form of [name] [type] [range_type] [values...]. [type] must be one of categorical, int, or double. [range_type] must be either space or list. If space, [values...] is a 3-tuple of [min] [max] [step]. If list , [values...] is a list of values to search. ex. -p epochs int space 100 1000 50
-c, --cluster	Cluster name (must be specified before other options)
-x, --command	Start command to execute in experiment container
-r, --resource	Resource type to run an experiment (for managed cluster only)
--processor	CPU or GPU (for custom cluster only)
--cpu-limit	Number of vCPUs (for custom cluster only)
--memory-limit	Memory limit in GiB (for custom cluster only)
--gpu-type	GPU type (for custom cluster only) ex. Tesla-K80
--gpu-limit	Number of GPU cores (for custom cluster only)
-i, --image-url	Kernel docker image URL ex. vessl/kernels:py36.full-cpu
--early-stopping-name	Early stopping algorithm name
--early-stopping-settings	Early stopping algorithm settings in the format of [key] [value] ex. --early-stopping-settings start_step 4
--message	Message
-h, --hyperparameter (multiple)	Hyperparameters in the form of [key]=[value] ex. -h lr=0.01 -h epochs=100
--dataset (multiple)	Dataset mounts in the form of [mount_path] [dataset_name] ex. --dataset /input mnist
--root-volume-size	Root volume size (defaults to 20Gi)
--working-dir	Working directory path (defaults to /work/[project_name])
--output-dir	Output directory path (defaults to /output
--local-project	Local project file URL

List all sweeps

vessl sweep list

View logs of the sweep container

vessl sweep logs [OPTIONS] NAME

Argument	Description
NAME	Sweep name

Option	Description
--tail	Number of lines to display from the end (defaults to 200)

View information on the sweep

vessl sweep read NAME

Argument	Description
NAME	sweep name

Terminate the sweep

vessl sweep terminate NAME

Argument	Description
NAME	sweep name

Find the best sweep experiment

vessl sweep best-experiment

Argument	Description
NAME	sweep name