Skip to content

systemslab context attach

Description Replace an experiment on a context with a new one.
Usage systemslab context new <CONTEXT> <EXPERIMENT> [OPTIONS]

Description

The systemslab context replace command replaces an existing experiment on a context with another one.

By default, this will copy the parameters and tags from the previous experiment.

In order for the attach to work the context must be in the open state. Attempting to attach an experiment to a context after it has been marked complete will result in an error.

INFO

An experiment can be attached to multiple contexts at the same time, with different parameters for each.

If you want to create a new experiment and attach it to the context, use the --context parameter to systemslab submit instead.

Options

OptionDefaultDescription
-p, --param

Parameters to annotate this context experiment with. These may be used when generating summary reports for the experiment.

This flag can be supplied multiple times. By default, the value will be a string, but you can pass numbers and booleans by putting the type after the key like so: --param name:bool=true or --param name:number = 5.

-t, --tag Tags marking this experiment within the context. This flag can be supplied multiple times.
--nameThe name of the new context.
--inherit An existing context ID to base the new context off of. This will copy the experiments and (optionally) the name from the provided context into the new one.

Common Options

OptionDefaultDescription
--systemslab-url The URL at which to access the systemslab server.
--colorauto Controls when color is used in the output. Possible values are auto, always, and never.
--output-formatlong Output format to use when outputting messages. long will result output designed to be human-readable while short is short output meant to be used within scripts.

Environment Variables

VariableDescription
SYSTEMSLAB_URLSpecify the URL used to contact the SystemsLab server. Equivalent to --systemslab-url.