Skip to content

Operators overview

An operator is a code module that provides a capability to perform an operation on a discoveryspace. For example the RandomWalk operator provides the capability to perform a random walk operation on a discoveryspace.

The pages in this section give details about some of the operators available in ado: what they are for, what they do and how to use them.

Info

The examples section contains worked examples of using some of these operators.

operator types

Operators are grouped into the following types:

  • explore: sample and measure entities from a discoveryspace
  • characterize: analyse a discoveryspace
  • modify: create a new discoveryspace by changing the entityspace or measurementspace of an input discoveryspace
  • compare: compare one or more discoveryspaces
  • fuse: create a new discoveryspace from a set of input discoveryspaces

This page describes explore operators in more detail as they are the only operators that sample and measure entities.

Listing the available operators

The following CLI command will list the available operators

ado get operators

Example output:

┌───────┬─────────────────────────┬──────────────┐
│ INDEX │ OPERATOR                │ TYPE         │
├───────┼─────────────────────────┼──────────────┤
│ 0     │ detect_anomalous_series │ characterize │
│ 1     │ profile                 │ characterize │
│ 2     │ trim                    │ characterize │
│ 3     │ random_walk             │ explore      │
│ 4     │ ray_tune                │ explore      │
│ 5     │ rifferla                │ modify       │
└───────┴─────────────────────────┴──────────────┘

Using operators

Using an operator involves the following steps:

  1. Find the input parameters for the operator:
  • ado template operation --operator-name $OPERATOR_NAME
  1. Write an operation YAML for applying the operator.
  • This involves setting specific values for its input parameters.
  1. Create the operation:
  • ado create operation -f $YAML
  1. Retrieve the results of the operation:
  • ado show related $OPERATION_IDENTIFIER
  • in addition ado show entities $OPERATION_IDENTIFIER for explore operations

These steps are covered in detail in operations.

What's next