Datalore Help

Interactive controls

Interactive controls are a special cell type that helps you quickly customize the output without manually changing the code. Use one of the controls (dropdown, slider, or text field) to provide values for one of the variables in your code and update the output on the fly.

We suggest that you go to this tutorial to see how you can use interactive controls. Click Edit copy in the upper right corner and try it for yourself.

Add a dropdown control

A dropdown control allows you to choose from a set of options that will be used as values for one of the variables in your code.

  1. Create an array to use as a source of values for your dropdown control. This step allows you to use a dynamic dataset based on the visualized DataFrame, as opposed to manually provided values. Follow the example below:

    [array_name] = [DataFrame_name].columns.values
    Use this array when selecting a set of variables for your dropdown control.

  2. Run this cell to make the array available for your dropdown control.

  3. Add a dropdown cell:
    • Hover over the lower border of the previous cell, click More cell types, and select Dropdown.

    • Use the cell context menu to add the required cell type.

  4. Hover over the control in the cell and click the settings icon.

  5. In the Dropdown dialog, do the following:
    • Provide a name for the control.

    • Provide a name for the variable. You will reference this variable in your code.
    • Provide the values:
      • (Recommended) Use an array of values created earlier. Switch to the Dynamic tab to select a source of values. This is where you can select the array created in the first step.

      • Enter the values manually on the Static tab. Separate each entry with a comma.
      Dropdown control dialog
    • Click Apply to close the dialog. The control is added to the notebook.

  6. Edit the code by inserting the variable name from the previous step. For example, in the code below, the column variable is used to provide values for the X axis.

    from lets_plot import * ggplot() + geom_line(aes(x=column, y="imdb_score"), data=df, sampling=sampling_systematic(n=5000)) + scale_x_log10()

  7. Use the added control to set a value for the specified variable and run the cell with the code to verify how it works.

    Dropdown in use

Add a slider control

  1. Add a slider cell:
    • Hover over the lower border of the previous cell, click More cell types, and select Slider.

    • Use the cell context menu to add the required cell type.

  2. Hover over the control in the cell and click the settings icon.

  3. In the Slider dialog, do the following:
    • Provide a name for the control.

    • Provide a name for the variable. You will reference this variable in your code.
    • Specify the minimum value and the maximum value. Step size is an optional field: when not specified, the slider supports floating numbers.

      Slider control dialog

    • Click Apply to close the dialog. The control is added to the notebook.

  4. Edit the code by inserting the variable name from the previous step. For example, in the code below, the num variable is used to define the number of rows to be displayed.

    df.iloc[:num]

  5. Use the added control to set a value for the specified variable and run the cell with the code to verify how it works.

    Slider in use

Add a text control

  1. Add a text cell:
    • Hover over the lower border of the previous cell, click More cell types, and select Text.

    • Use the cell context menu to add the required cell type.

  2. Hover over the control in the cell and click the settings icon.

  3. In the Text dialog, do the following:
    • Provide a name for the control.

    • Provide a name for the variable. You will reference this variable in your code.
    • Text control dialog
    • Click Apply to close the dialog. The control is added to the notebook.

  4. Add the variable name from the previous step to your code cell.

  5. Enter a text in the added text control and run the cell with the code to verify how it works.

    Slider in use

Last modified: 13 August 2021