Skip to content

qruise flow remove

Remove a scheduled flow.

Syntax

qruise flow remove [OPTIONS] FLOW_ID

Description

The qruise flow remove command removes a flow from QruiseOS. The flow is no longer visible in QruiseOS, but experiment and calibration data are still preserved.

Arguments

Argument Description
FLOW_ID ID of the flow to remove. Required.

Options

Option Description
--help Show a help message and exit.

Examples

Remove a single flow

Assume that after running qruise flow list you get the following output:

 Name                       ID
 sc-daily-calibration       ee165cf5-60ce-4a51-a473-6183228e39ab
 sc-long-experiments        b6ed3d68-b5a1-4f34-831e-39dc8094ee73
 experimental-setup         d63d0327-481e-4b10-8530-429c16635375

To remove the experimental-setup flow, simply run:

qruise flow remove d63d0327-481e-4b10-8530-429c16635375

After the above command completes, experimental-setup workflow will no longer be present:

 Name                       ID
 sc-daily-calibration       ee165cf5-60ce-4a51-a473-6183228e39ab
 sc-long-experiments        b6ed3d68-b5a1-4f34-831e-39dc8094ee73

Bulk flow removal

You can use qruise flow list in conjunction with qruise flow remove to remove multiple flows at the same time. For instance, assume you have the following flows defined:

$ qruise flow list
 Name                               ID
 superconducting-daily              d68d44d3-0c58-489e-8f37-001104320ead
 superconducting-long-experiments   0b6ef159-1d3a-4f22-9f49-09ae5506d7cd
 superconducting-experimental       970f5a40-dd4a-43ed-bc7e-3ec81282c9a2
 rydberg-test                       8828e546-30ca-4096-9cd4-cc370da31374
 rydberg-daily                      3ef43d8b-81ba-4ee3-803c-f2b04cf3c6d4

To remove all flows, run the following (see below for explanation):

qruise flow list --no-headers | awk '{print $2}' | xargs qruise flow remove

To see how the above command chain works, observe that the qruise flow list --no-headers command prints the list of all flows in a table without the header row. The output is then passed to the awk command to reduce the output to just the second column (i.e. the column of flow identifiers):

$ qruise flow list --no-headers | awk '{print $2}'
d68d44d3-0c58-489e-8f37-001104320ead
0b6ef159-1d3a-4f22-9f49-09ae5506d7cd
970f5a40-dd4a-43ed-bc7e-3ec81282c9a2
8828e546-30ca-4096-9cd4-cc370da31374
3ef43d8b-81ba-4ee3-803c-f2b04cf3c6d4

This can now be passed to the xargs command, which is equivalent to executing qruise flow rm multiple times manually.

Removing flows by name

You can also remove flows with flow names matching a particular pattern by using the grep command in the aforementioned command chain. For instance, if you want to remove all flows containting the word "superconducting" in the name, run the following:

qruise flow list --no-headers | grep superconducting | awk '{print $2}' | xargs qruise flow remove