ggtb

ggtb(size_basis=None, size_zoomin=None) → FeatureSpec

Add a toolbar to a chart.

This function adds a toolbar containing three tool-buttons (pan, rubber-band zoom, and center-point zoom) to a chart. Each tool uses mouse-drag for its specific functionality. Additionally, the mouse wheel can be used for zooming in and out, regardless of the selected tool.

The toolbar includes:

• Pan: Drag to move the plot.

• Rubber-band zoom: Drag to define a rectangular area to zoom into.

• Center-point zoom: Drag up or down to zoom in or out from a center point.

• Reset button: Click to reset the plot and tools to their original state.

Double-clicking anywhere on the plot resets it to its original coordinates, regardless of whether a tool is selected or not.

Limitations:

• The toolbar does not work with interactive maps.

• The toolbar cannot be used with plots using a polar coordinate system.

Parameters:

size_zoominint, default=0

Control how zooming in affects the size of geometry objects on the plot. Currently, works only with the geom_point layer and layers based on it (geom_jitter, geom_sina, etc.).

0 - size never increases;

-1 - size will be increasing without limits;

n - the number of times the size of objects will increase (relative to the initial state of the plot). Farther zooming will no longer affect the size.

size_basis{‘x’, ‘y’, ‘min’, ‘max’}, default=’max’

Defines the axis along which the scaling factor for geometry objects will be calculated.

‘x’ - size changes only when zooming in/out along x-axis;

‘y’ - size changes only when zooming in/out along y-axis;

‘min’ - size changes when zooming in/out along any axis, but the change is determined by the axis with the minimum zoom factor;

‘max’ - size changes when zooming in/out along any axis, but the change is determined by the axis with the maximum zoom factor.

Returns:

FeatureSpec

Toolbar feature specification.

Examples

import numpy as np
from lets_plot import *
LetsPlot.setup_html()
x = np.linspace(-2 * np.pi, 2 * np.pi, 100)
y = np.sin(x)
ggplot({'x': x, 'y': y}, aes(x='x', y='y')) + \
    geom_point() + \
    ggtb()