Add operations¶

A recipe is composed of operations—transformations that will be applied to the source data to prepare it for modeling. Note that operations are applied sequentially, so you may need to reorder the operations in your recipe to achieve the desired result.

The table below describes the wrangling operations currently available in Workbench:

To add an operation to your recipe:

1. In the right panel, either click + Add operation to add individual transformations to your recipe, or Import recipe to import an existing recipe.

   

2. Select and configure an operation. Then, click Add to recipe.

   

   The live sample updates after DataRobot retrieves a new sample from the data source and applies the operation, allowing you to review the transformation in realtime.

3. Continue adding operations while analyzing their effect on the live sample. To add operations, you can:

   • Click + Add operation.
   • Open the Actions menu next to interact with specific operations.

   • Click the arrow to the right of the + Add operation button and select Import recipe. This allows you to add operations from an existing wrangling recipe.

     

4. When you're done, you can publish the recipe.

Join¶

Use the Join operation to combine datasets that are accessible via the same connection instance.

To join a table or dataset:

1. Click Join in the right panel.

2. Click + Select dataset to browse and select a dataset from your connection instance.

   

3. Once you've opened and profiled the dataset you want to add, click Select.

   

4. Select the appropriate Join type from the dropdown.

   • Inner only returns rows that have matching values in both datasets, for example, any rows with matching values in the order_id column.
   • Left returns all rows from the left dataset (the original), and only the rows with matching values in the right dataset (joined).

   

5. Select the Join condition, which defines how the two datasets are related. In this example, both the datasets are related by order_id.

   

6. Click Add to recipe.

Aggregate¶

Use the Aggregate operation to apply the following mathematical aggregations to the dataset (available aggregations vary by feature type):

• Sum
• Min
• Max
• Avg
• Standard deviation
• Count
• Count distinct
• Most frequent (Snowflake only)

To add an aggregation:

1. Click Aggregate in the right panel.

2. Under Group by key, select the feature(s) you want to group your aggregation(s) by.

   

3. Click the field below Feature to aggregate and select a feature from the dropdown. Then, click the field below Aggregate function and choose one or more aggregations to apply to the feature.

   

4. (Optional) Click + Add feature to apply aggregations to additional features in this grouping.

5. Click Add to recipe.

   After adding the operation to the recipe, DataRobot renames aggregated features using the original name with the _AggregationFunction suffix attached. In this example, the new columns are age_max and age_most_frequent.

   

Filter row¶

Use the Filter row operation to filter the rows in your dataset according to specified value(s) and conditions.

To filter rows:

1. Click Filter row in the right panel.

2. Decide if you want to keep the rows that match the defined conditions or exclude them.

3. Define the filter conditions, by choosing the feature you want to filter, the condition type, and the value you want to filter by. DataRobot highlights the selected column.

   

4. (Optional) Click Add condition to define additional filtering criteria.

5. Click Add to recipe.

De-duplicate rows¶

To de-duplicate rows, click De-duplicate rows in the right panel. This operation is immediately added to your recipe and applied to the live sample, removing all rows with duplicate information.

Find and replace¶

Use the Find and replace operation to quickly replace specific feature values in a dataset. This is helpful to, for example, fix typos in a dataset.

To find and replace a feature value:

1. Click Find and replace in the right panel.

2. Under Select feature, click the dropdown and choose the feature that contains the value you want to replace. DataRobot highlights the selected column.

   

3. Under Find, choose the match criteria—Exact, Partial, or Regular Expression—and enter the feature value you want to replace. Then, under Replace, enter the new value.

   

4. Click Add to recipe.

Compute a new feature¶

Use the Compute new feature operation to create a new output feature from existing features in your dataset. By applying domain knowledge, you can create features that do a better job of representing your business problem to the model than those in the original dataset.

To compute a new feature:

1. Click Compute new feature in the right panel.

2. Enter a name for the new feature, and under Expression, define the feature using scalar subqueries, scalar functions, or window functions for your chosen cloud data platform:

   SnowflakeBigQueryDatabricksSpark SQL

   See the Snowflake documentation for:

   • Scalar subqueries
   • Scalar functions
   • Window functions

   See the BigQuery documentation for:

   • Scalar subqueries
   • Scalar functions
   • Window functions

   See the Databricks documentation for:

   • Scalar subqueries
   • Scalar functions
   • Window functions

   See the Spark SQL documentation for:

   • Scalar functions
   • Window functions

   

   This example uses REGEXP_SUBSTR, to extract the first number from the [<age_range_start> - <age_range_end>) from the age column, and to_number to convert the output from a string to a number.

   Expression formatting

   For guidance on how to format your Compute new feature expressions, see the Expression field, which provides an example based on your data connection.

3. Click Add to recipe.

Rename features¶

Use the Rename features operation to rename one or more features in the dataset.

To rename features:

1. Click Rename features in the right panel.

   Rename specific features from the live sample

   Alternatively, you can click the Actions menu next to the feature you want to rename. This opens the operation parameters in the right panel with the feature field already filled in.

   

2. Under Feature name, click the dropdown and choose the feature you want to rename. Then, enter the new feature name in the second field.

   

3. (Optional) Click Add feature to rename additional features.

4. Click Add to recipe.

Remove features¶

Use the Remove features operation to remove features from the dataset.

To remove features:

1. Click Remove features in the right panel.

   Remove specific features from the live sample

   Alternatively, you can click the Actions menu next to the feature you want to remove. This opens the operation parameters in the right panel with the feature field already filled in.

   

2. Under Feature name, click the dropdown and either start typing the feature name or scroll through the list to select the feature(s) you want to remove. Click outside of the dropdown when you're done selecting features.

   

3. Click Add to recipe.

Time-aware operations¶

For time-aware operations, see time series data wrangling. These operations include:

• Derive time series features
• Lag features
• Derive rolling statistics (numeric)
• Derive rolling statistics (categorical)

Operation actions¶

After adding an operation to the recipe, you can access the Actions menu to the right of individual operations, allowing you to:

Preview up to this operation¶

The Preview up to this operation action allows you to quickly test different combinations of operations on the live sample. When you select Preview up to this operation, the action is added to the recipe panel. The live preview only displays the operations listed above this action, so you can drag-and-drop the action below/above operations to see how different operations affect the preview.

To view the preview without any operations applied, drag-and-drop the action to the top of the recipe.

Reorder operations¶

All operations in a wrangling recipe are applied sequentially, therefore, the order in which they appear affects the results of the output dataset.

To move an operation to a new location, click and hold the operation you want to move, and then drag it to a new position.

The live sample updates to reflect the new order.

Next steps¶

From here, you can:

• Publish the recipe to the data source, generating a new output dataset.

Read more¶

To learn more about the topics discussed on this page, see:

• Description of summary statistics and histograms in DataRobot Classic.