Gradient Docs
Gradient HomeHelp DeskCommunitySign up free
1.0.0
1.0.0
  • About Paperspace Gradient
  • Get Started
    • Quick Start
    • Core Concepts
    • Install the Gradient CLI
    • Common Errors
  • Tutorials
    • Tutorials List
      • Getting Started with Notebooks
      • Train a Model with the Web UI
      • Train a Model with the CLI
      • Advanced: Distributed training sample project
      • Registering Models in Gradient
      • Using Gradient Deployments
      • Using Custom Containers
  • Notebooks
    • Overview
    • Using Notebooks
      • The Notebook interface
      • Notebook metrics
      • Share a Notebook
      • Fork a Notebook
      • Notebook Directories
      • Notebook Containers
        • Building a Custom Container
      • Notebook Workspace Include Files
      • Community (Public) Notebooks
    • ML Showcase
    • Run on Gradient (GitHub badge)
  • Projects
    • Overview
    • Managing Projects
    • GradientCI
      • GradientCI V1 (Deprecated)
  • Workflows
    • Overview
      • Getting Started with Workflows
      • Workflow Spec
      • Gradient Actions
  • Experiments
    • Overview
    • Using Experiments
      • Containers
      • Single-node & multi-node CLI options
      • Experiment options
      • Gradient Config File
      • Environment variables
      • Experiment datasets
      • Git Commit Tracking
      • Experiment metrics
        • System Metrics
        • Custom Metrics
      • Experiment Logs
      • Experiment Ports
      • GradientCI Experiments
      • Diff Viewer
      • Hyperparameter Tuning
    • Distributed Training
      • Distributed Machine Learning with Tensorflow
      • Distributed Machine Learning with MPI
        • Distributed Training using Horovod
        • Distributed Training Using ChainerMN
  • Jobs
    • Overview
    • Using Jobs
      • Stop a Job
      • Delete a Job
      • List Jobs
      • Job Logs
      • Job Metrics
        • System Metrics
        • Custom Metrics
      • Job Artifacts
      • Public Jobs
      • Building Docker Containers with Jobs
  • Models
    • Overview
    • Managing Models
      • Example: Prepare a TensorFlow Model for Deployments
      • Model Path, Parameters, & Metadata
    • Public Models
  • Deployments
    • Overview
    • Managing Deployments
      • Deployment Containers
        • Custom Deployment Containers
      • Deployment States
      • Deployment Logs
      • Deployment Metrics
      • A Deployed Model's API Endpoint
        • Gradient + TensorFlow Serving
      • Deployment Autoscaling
      • Optimize Models for Inference
  • Data
    • Types of Storage
      • Managing Data in Gradient
        • Managing Persistent Storage with VMs
    • Storage Providers
    • Versioned Datasets
    • Public Datasets Repository
  • TensorBoards
    • Overview
    • Using Tensorboards
      • TensorBoards getting started with Tensorflow
  • Metrics
    • Metrics Overview
    • View and Query Metrics
    • Push Metrics
  • Secrets
    • Overview
    • Using Secrets
  • Gradient SDK
    • Gradient SDK Overview
      • Projects Client
      • Experiments Client
      • Models Client
      • Deployments Client
      • Jobs Client
    • End to end tutorial
    • Full SDK Reference
  • Instances
    • Instance Types
      • Free Instances (Free Tier)
      • Instance Tiers
  • Gradient Cluster
    • Overview
    • Setup
      • Managed Private Clusters
      • Self-Hosted Clusters
        • Pre-installation steps
        • Gradient Installer CLI
        • Terraform
          • Pre-installation steps
          • Install on AWS
          • Install on bare metal / VMs
          • Install on NVIDIA DGX
        • Let's Encrypt DNS Providers
        • Updating your cluster
    • Usage
  • Tags
    • Overview
    • Using Tags
  • Machines (Paperspace CORE)
    • Overview
    • Using Machines
      • Start a Machine
      • Stop a Machine
      • Restart a Machine
      • Update a Machine
      • Destroy a Machine
      • List Machines
      • Show a Machine
      • Wait For a Machine
      • Check a Machine's utilization
      • Check availability
  • Paperspace Account
    • Overview
    • Public Profiles
    • Billing & Subscriptions
    • Hotkeys
    • Teams
      • Creating a Team
      • Upgrading to a Team Plan
  • Release Notes
    • Product release notes
    • CLI/SDK Release notes
Powered by GitBook
On this page
  1. Experiments
  2. Using Experiments

Experiment options

PreviousSingle-node & multi-node CLI optionsNextGradient Config File

Last updated 4 years ago

Experiment web UI Options List

Option

Description

Machine Type

This is the type of instance to run your Experiment's on. Many Experiments benefit from a machine with a GPU, but some can run just using a CPU.

Container

Experiments are run within a docker container. You can run a public or private container. Learn more .

Workspace

The workspace is the collection of code that is run. The only option in the web UI is a Git repo (eg ). The CLI offers more advanced options such as specifying a local directory, private Git repos, S3 buckets, and more.

Command

The command is the entry point to the container. This is the line of code that will kick off your experiment's job. It could be a bash script ./run.sh or python main.py as a few examples.

Custom Metrics

Enter a list of custom metrics to use with Gradient's statd client, such as percent_failure or percent_success.

Experiment CLI Options List

Option

Description

name

Experiment name

workspace

Supports a path to a local directory, git repository, or s3 bucket.

workspaceRef

An option to specify a Git commit hash, branch name or tag. Learn more .

workspaceArchive

Path to workspace archive. (Currently being deprecated in an upcoming version.)

workspaceUrl

Path to workspace archive. (Currently being deprecated in an upcoming version.)

workspaceUsername

Used to pass-in a username to a private repo.

workspacePassword

Used to pass-in a password to a private repo.

ignoreFiles

When using the directory upload option, this command can be used to ignore certain files from uploading.

workingDirectory

Working directory for the experiment

artifactDirectory

Where artifacts can be located.

clusterId

Cluster ID of the private Gradient cluster. Learn more .

experimentEnv

Environmental variables in JSON String Format. Example:

{"HKS_EPOCHS":1,"HKS_MAX_EVALS":4,"DATASET_SIZE":100} Learn more .

projectId

Your .

modelType

This option is used to specify the format of your model. Learn more .

modelPath

This option is used to locate your model. Learn more .

isPreemptible

Flag that specifies if the Experiment is .

container

A reference to a docker image in a public or private docker registry, or a container name provided by Paperspace. Docker image repository references must be in lowercase and may include a tag and a hostname prefix followed by a slash; if committed the hostname defaults to that of the public Docker Hub registry. An example docker image reference: docker.io/mynamespace/myimage:mytag. A container name may be mixed case. (Designated container names are currently only provided as part of various Gradient tutorials and samples.)

machineType

An optional machine type to run the job on: either 'GPU+', 'P4000', 'P5000', 'P6000', 'V100', 'K80', 'P100', or 'TPU'.

command

Experiment entrypoint command.

containerUser

Name of user in container.

registryUsername

Used to pass-in a username to a private container registry.

registryPassword

Used to pass-in a password to a private container registry.

registryUrl

Used to pass-in a path to a container in private container registry.

no-logs

Flag to prevent streaming logs in terminal.

datasetUri

Url to S3 bucket with dataset

datasetName

Name of dataset

datasetAwsAccessKeyId

S3 bucket's Access Key ID

datasetAwsSecretAccessKey

S3 bucket's Secret Access Key

datasetVersionId

S3 dataset's version ID

datasetEtag

S3 dataset's ETag

tensorboard

Add to existing . If no or many TensorBoard exists a new one will be created.

apiKey

API key to use this time only.

optionsFile

Path to with predefined options.

createOptionsFile

Generate template options file

preemptible
here
https://github.com/Paperspace/fast-style-transfer.git
here
here
here
here
here
TensorBoard
YAML file
Project ID