[DEV] VESSL Docs
  • Welcome to VESSL Docs!
  • GETTING STARTED
    • Overview
    • Quickstart
    • End-to-end Guides
      • CLI-driven Workflow
      • SDK-driven Workflow
  • USER GUIDE
    • Organization
      • Creating an Organization
      • Organization Settings
        • Add Members
        • Set Notifications
        • Configure Clusters
        • Add Integrations
        • Billing Information
    • Project
      • Creating a Project
      • Project Overview
      • Project Repository & Project Dataset
    • Clusters
      • Cluster Integrations
        • Fully Managed Cloud
        • Personal Laptops
        • On-premise Clusters
        • Private Cloud (AWS)
      • Cluster Monitoring
      • Cluster Administration
        • Resource Specs
        • Access Control
        • Quotas and Limits
        • Remove Cluster
    • Dataset
      • Adding New Datasets
      • Managing Datasets
      • Tips & Limitations
    • Experiment
      • Creating an Experiment
      • Managing Experiments
      • Experiment Results
      • Distributed Experiments
      • Local Experiments
    • Model Registry
      • Creating a Model
      • Managing Models
    • Sweep
      • Creating a Sweep
      • Sweep Results
    • Workspace
      • Creating a Workspace
      • Exploring Workspaces
      • SSH Connection
      • Downloading / Attaching Datasets
      • Running a Server Application
      • Tips & Limitations
      • Building Custom Images
    • Serve
      • Quickstart
      • Serve Web Workflow
        • Monitoring Dashboard
        • Service Logs
        • Service Revisions
        • Service Rollouts
      • Serve YAML Workflow
        • YAML Schema Reference
    • Commons
      • Running Spot Instances
      • Volume Mount
  • API REFERENCE
    • What is the VESSL CLI/SDK?
    • CLI
      • Getting Started
      • vessl run
      • vessl cluster
      • vessl dataset
      • vessl experiment
      • vessl image
      • vessl model
      • vessl organization
      • vessl project
      • vessl serve
      • vessl ssh-key
      • vessl sweep
      • vessl volume
      • vessl workspace
    • Python SDK
      • Integrations
        • Keras
        • TensorBoard
      • Utilities API
        • configure
        • vessl.init
        • vessl.log
          • vessl.Image
          • vessl.Audio
        • vessl.hp.update
        • vessl.progress
        • vessl.upload
        • vessl.finish
      • Dataset API
      • Experiment API
      • Cluster API
      • Image API
      • Model API
        • Model Serving API
      • Organization API
      • Project API
      • Serving API
      • SSH Key API
      • Sweep API
      • Volume API
      • Workspace API
    • Rate Limits
  • TROUBLESHOOTING
    • GitHub Issues
    • VESSL Flare
Powered by GitBook
On this page
  • Objective
  • Common Parameters
  • Parameters
  • Early Stopping (Optional)
  • Runtime
  1. USER GUIDE
  2. Sweep

Creating a Sweep

PreviousSweepNextSweep Results

Last updated 3 years ago

To create a Sweep you need to specify a few options including objective, parameters, algorithm, and runtime.

Objective

You should log the objective metric with Python SDK in your code.

Specify the objective metric that you want to optimize. You can set either to maximize or minimize your target value.

Common Parameters

Specify the following parameters with a positive integer:

  • Max experiment count: The maximum number of experiments to run. A sweep will keep spawning a new experiment until the total number of experiments reaches the count.

  • Parallel experiment count: The number of parallel experiments to run. Sweep runs experiments concurrently up to the number of parallel experiment counts.

  • Max failed experiment count: The number of allowed failed experiments. If the number of failed experiments exceeds this number, the Sweep will no longer spawn new experiments.

Noted that both Parallel experiment count and Max failed experiment count should be less than or equal to Max experiment count.

Parameters

Algorithm name

Search space

  • Name: The name of the parameter that is applied to the experiment as an environment variable at runtime.

  • Type: Choose between categorical, int, or double type of the parameter.

  • Range: You can choose between search space and list options. For a categorical type, only a list option is available.

  • Value: The input form of the value is determined by the range type. For a search space, a continuous space is defined with min, max, and step, and for a list option, a search space is defined with discrete values.

Early Stopping (Optional)

You can set early stopping to prevent overfitting on the training dataset. It supports the median algorithm which takes two input values, min_experiment_required and start_step. VESSL examines the metric value for each step after start_step and compares it to the median value of the completed experiment to decide whether to trigger early stopping.

Runtime

Configuring the runtime option is similar to creating an experiment:

You can retrieve the configuration of prior experiments by clicking Configure from Prior Experiments.

A simple exhaustive searching by all combinations through a specified search space. All search space of parameters should be discrete and bounded. If each of the two parameters has three possible values, the total number of possible experiments is six.

****: Randomly selecting the parameter values existing in the search space, and spawn an experiment with those parameters. The search space could be discrete, continuous, or mixed.

****: A global optimization method for noisy black-box functions. Bayesian optimization will select the next parameter on the probabilistic model of the function mapping from hyperparameter values to the objective.

Parameters are set as hyperparameters of the experiment. on our GitHub repository.

Grid search:
Random search
Bayesian optimization
See example code
Creating an Experiment