panel.ui.indicators package#

Module contents#

The Material UI progress indicators, plus the classic indicators.

class panel.ui.indicators.BooleanIndicator(*, throttle, disabled, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, label, value, name)[source]#

Bases: Indicator

BooleanIndicator is an abstract baseclass for indicators that visually indicate a boolean value.

Parameter Definitions

Parameters inherited from:

value = Boolean(default=False, label='Value'): Whether the indicator is active or not.
throttle = Integer(allow_refs=True, default=500, inclusive_bounds=(True, True), label='Throttle'): ” Throttles value change events, ensuring that they only toggle off after a minimum time specified in milliseconds has passed.

class panel.ui.indicators.BooleanStatus(*, color, throttle, disabled, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, label, value, name)[source]#

Bases: BooleanIndicator

The BooleanStatus is a boolean indicator providing a visual representation of a boolean status as filled or non-filled circle.

If the value is set to True the indicator will be filled while setting it to False will cause it to be non-filled.

Reference: https://panel.holoviz.org/reference/indicators/BooleanStatus.html

Example:

>>> BooleanStatus(value=True, color='primary', width=100, height=100)

Parameter Definitions

Parameters inherited from:

value = Boolean(default=False, label='Value'): Whether the indicator is active or not.
height = Integer(allow_None=True, bounds=(0, None), default=20, inclusive_bounds=(True, True), label='Height'): height of the circle.
width = Integer(allow_None=True, bounds=(0, None), default=20, inclusive_bounds=(True, True), label='Width'): Width of the circle.
color = Selector(default='dark', label='Color', names={}, objects=['primary', 'secondary', 'success', 'info', 'danger', 'warning', 'light', 'dark']): The color of the circle, one of ‘primary’, ‘secondary’, ‘success’, ‘info’, ‘danger’, ‘warning’, ‘light’, ‘dark’

class panel.ui.indicators.CircularProgress(*, bgcolor, color, size, thickness, variant, with_label, attached, description, disabled, dark_theme, sx, theme_config, use_shadow_dom, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, label, value, name)[source]#

Bases: MaterialWidget

The CircularProgress provides a visual representation as a spinner of the loading status.

References:

Example:

>>> CircularProgress(color='success')

Parameter Definitions

Parameters inherited from:

value = Number(bounds=(0, 100), default=0, inclusive_bounds=(True, True), label='Value'): The value of the loading indicator.
width = Integer(allow_None=True, allow_refs=True, bounds=(0, None), inclusive_bounds=(True, True), label='Width'): Width of the widget.
bgcolor = Selector(label='Bgcolor', names={}, objects=[None, 'light', 'dark']): The background color of the loading spinner.
color = Selector(default='primary', label='Color', names={}, objects=['default', 'primary', 'secondary', 'error', 'info', 'success', 'warning', 'light', 'dark', 'danger']): The color of the loading indicator.
size = Integer(default=40, inclusive_bounds=(True, True), label='Size'): The size of the loading spinner.
thickness = Number(default=3.6, inclusive_bounds=(True, True), label='Thickness'): The thickness of the loading spinner.
variant = Selector(default='indeterminate', label='Variant', names={}, objects=['determinate', 'indeterminate']): The variant of the loading indicator.
with_label = Boolean(default=False, label='With label'): Whether to show a label indicating the progress.

width = None#

class panel.ui.indicators.Dial(*, annulus_width, background, bounds, colors, default_color, end_angle, format, label_color, nan_format, needle_color, needle_width, start_angle, tick_size, title_size, unfilled_color, value_size, disabled, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, label, value, name)[source]#

Bases: ValueIndicator

A Dial represents a value in some range as a position on an annular dial. It is similar to a Gauge but more minimal visually.

Reference: https://panel.holoviz.org/reference/indicators/Dial.html

Example:

>>> Dial(label='Speed', value=79, format="{value} km/h", bounds=(0, 200), colors=[(0.4, 'green'), (1, 'red')])

Parameter Definitions

Parameters inherited from:

value = Number(allow_None=True, default=25, inclusive_bounds=(True, True), label='Value'): Value to indicate on the dial a value within the declared bounds.
height = Integer(allow_None=True, bounds=(1, None), default=250, inclusive_bounds=(True, True), label='Height'): The height of the component (in pixels). This can be either fixed or preferred height, depending on height sizing policy.
width = Integer(allow_None=True, bounds=(1, None), default=250, inclusive_bounds=(True, True), label='Width'): The width of the component (in pixels). This can be either fixed or preferred width, depending on width sizing policy.
annulus_width = Number(default=0.2, inclusive_bounds=(True, True), label='Annulus width'): Width of the radial annulus as a fraction of the total.
background = Parameter(allow_None=True, label='Background'): Background color of the component.
bounds = Range(default=(0, 100), inclusive_bounds=(True, True), label='Bounds', length=2): The upper and lower bound of the dial.
colors = List(allow_None=True, bounds=(0, None), item_type=<class 'tuple'>, label='Colors'): Color thresholds for the Dial, specified as a list of tuples of the fractional threshold and the color to switch to.
default_color = String(default='lightblue', label='Default color'): Color of the radial annulus if not color thresholds are supplied.
end_angle = Number(default=25, inclusive_bounds=(True, True), label='End angle'): Angle at which the dial ends.
format = String(default='{value}%', label='Format'): Formatting string for the value indicator and lower/upper bounds.
label_color = String(default='black', label='Label color'): Color for all extraneous labels.
nan_format = String(default='-', label='Nan format'): How to format nan values.
needle_color = String(default='black', label='Needle color'): Color of the Dial needle.
needle_width = Number(default=0.1, inclusive_bounds=(True, True), label='Needle width'): Radial width of the needle.
start_angle = Number(default=-205, inclusive_bounds=(True, True), label='Start angle'): Angle at which the dial starts.
tick_size = String(allow_None=True, label='Tick size'): Font size of the Dial min/max labels.
title_size = String(allow_None=True, label='Title size'): Font size of the Dial title.
unfilled_color = String(default='whitesmoke', label='Unfilled color'): Color of the unfilled region of the Dial.
value_size = String(allow_None=True, label='Value size'): Font size of the Dial value label.

class panel.ui.indicators.Gauge(*, annulus_width, bounds, colors, custom_opts, end_angle, format, num_splits, show_labels, show_ticks, start_angle, title_size, tooltip_format, disabled, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, label, value, name)[source]#

Bases: ValueIndicator

A Gauge represents a value in some range as a position on speedometer or gauge. It is similar to a Dial but visually a lot busier. Requires the ECharts extension to be loaded.

Reference: https://panel.holoviz.org/reference/indicators/Gauge.html

Example:

>>> pn.extension('echarts')
>>> Gauge(label='Speed', value=79, bounds=(0, 200), colors=[(0.4, 'green'), (1, 'red')])

Parameter Definitions

Parameters inherited from:

value = Number(allow_None=True, default=25, inclusive_bounds=(True, True), label='Value'): Value to indicate on the gauge a value within the declared bounds.
height = Integer(allow_None=True, bounds=(0, None), default=300, inclusive_bounds=(True, True), label='Height'): The height of the component (in pixels). This can be either fixed or preferred height, depending on height sizing policy.
width = Integer(allow_None=True, bounds=(0, None), default=300, inclusive_bounds=(True, True), label='Width'): The width of the component (in pixels). This can be either fixed or preferred width, depending on width sizing policy.
annulus_width = Integer(default=10, inclusive_bounds=(True, True), label='Annulus width'): Width of the gauge annulus.
bounds = Range(default=(0, 100), inclusive_bounds=(True, True), label='Bounds', length=2): The upper and lower bound of the dial.
colors = List(allow_None=True, bounds=(0, None), item_type=<class 'tuple'>, label='Colors'): Color thresholds for the Gauge, specified as a list of tuples of the fractional threshold and the color to switch to.
custom_opts = Dict(allow_None=True, class_=<class 'dict'>, label='Custom opts'): Additional options to pass to the ECharts Gauge definition.
end_angle = Number(default=-45, inclusive_bounds=(True, True), label='End angle'): Angle at which the gauge ends.
format = String(default='{value}%', label='Format'): Formatting string for the value indicator.
num_splits = Integer(default=10, inclusive_bounds=(True, True), label='Num splits'): Number of splits along the gauge.
show_ticks = Boolean(default=True, label='Show ticks'): Whether to show ticks along the dials.
show_labels = Boolean(default=True, label='Show labels'): Whether to show tick labels along the dials.
start_angle = Number(default=225, inclusive_bounds=(True, True), label='Start angle'): Angle at which the gauge starts.
tooltip_format = String(default='{b} : {c}%', label='Tooltip format'): Formatting string for the hover tooltip.
title_size = Integer(allow_None=True, default=18, inclusive_bounds=(True, True), label='Title size'): Size of title font.

class panel.ui.indicators.LinearGauge(*, bounds, colors, default_color, format, horizontal, nan_format, needle_color, show_boundaries, tick_size, title_size, unfilled_color, value_size, disabled, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, label, value, name)[source]#

Bases: ValueIndicator

A LinearGauge represents a value in some range as a position on an linear scale. It is similar to a Dial/Gauge but visually more compact.

Reference: https://panel.holoviz.org/reference/indicators/LinearGauge.html

Example:

>>> LinearGauge(value=30, default_color='red', bounds=(0, 100))

Parameter Definitions

Parameters inherited from:

value = Number(allow_None=True, default=25, inclusive_bounds=(True, True), label='Value'): Value to indicate on the dial a value within the declared bounds.
height = Integer(allow_None=True, bounds=(1, None), default=300, inclusive_bounds=(True, True), label='Height'): The height of the component (in pixels). This can be either fixed or preferred height, depending on height sizing policy.
width = Integer(allow_None=True, bounds=(1, None), default=125, inclusive_bounds=(True, True), label='Width'): The width of the component (in pixels). This can be either fixed or preferred width, depending on width sizing policy.
bounds = Range(default=(0, 100), inclusive_bounds=(True, True), label='Bounds', length=2): The upper and lower bound of the gauge.
default_color = String(default='lightblue', label='Default color'): Color of the radial annulus if not color thresholds are supplied.
colors = Parameter(allow_None=True, label='Colors'): Color thresholds for the gauge, specified as a list of tuples of the fractional threshold and the color to switch to.
format = String(default='{value:.2f}%', label='Format'): Formatting string for the value indicator and lower/upper bounds.
horizontal = Boolean(default=False, label='Horizontal'): Whether to display the linear gauge horizontally.
nan_format = String(default='-', label='Nan format'): How to format nan values.
needle_color = String(default='black', label='Needle color'): Color of the gauge needle.
show_boundaries = Boolean(default=False, label='Show boundaries'): Whether to show the boundaries between colored regions.
unfilled_color = String(default='whitesmoke', label='Unfilled color'): Color of the unfilled region of the LinearGauge.
title_size = String(allow_None=True, label='Title size'): Font size of the gauge title.
tick_size = String(allow_None=True, label='Tick size'): Font size of the gauge tick labels.
value_size = String(allow_None=True, label='Value size'): Font size of the gauge value label.

class panel.ui.indicators.LinearProgress(*, active, color, max, value_buffer, variant, attached, description, disabled, dark_theme, sx, theme_config, use_shadow_dom, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, label, value, name)[source]#

Bases: MaterialWidget

The LinearProgress widget displays the progress towards some target based on the current value and the max value.

References:

Example:

>>> LinearProgress(value=20, color="primary")

Parameter Definitions

Parameters inherited from:

value = Number(bounds=(-1, None), default=-1, inclusive_bounds=(True, True), label='Value'): The value of the progress bar.
active = Boolean(default=True, label='Active'): Whether to animate the bar when in indeterminate mode.
color = Selector(default='primary', label='Color', names={}, objects=['default', 'primary', 'secondary', 'error', 'info', 'success', 'warning', 'light', 'dark', 'danger']): The color of the progress bar.
max = Number(bounds=(0, None), default=100, inclusive_bounds=(False, True), label='Max'): Maximum progress value.
value_buffer = Number(bounds=(-1, None), default=-1, inclusive_bounds=(True, True), label='Value buffer'): The buffer of the progress bar (if variant=”buffer”).
variant = Selector(default='determinate', label='Variant', names={}, objects=['determinate', 'indeterminate', 'buffer', 'query']): The variant of the progress bar.

panel.ui.indicators.LoadingSpinner[source]#: alias of CircularProgress

class panel.ui.indicators.Number(*, colors, default_color, font_size, format, nan_format, title_size, disabled, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, label, value, name)[source]#

Bases: ValueIndicator

The Number indicator renders the value as text optionally colored according to the colors thresholds.

Reference: https://panel.holoviz.org/reference/indicators/Number.html

Example:

>>> Number(label='Rate', value=72, format='{value}%', colors=[(80, 'green'), (100, 'red')]

Parameter Definitions

Parameters inherited from:

default_color = String(default='currentcolor', label='Default color'): The color of the Number indicator if no colors are provided
colors = List(allow_None=True, bounds=(0, None), item_type=<class 'tuple'>, label='Colors'): Color thresholds for the Number indicator, specified as a tuple of the absolute thresholds and the color to switch to.
format = String(default='{value}', label='Format'): A formatter string which accepts a {value}.
font_size = String(default='54pt', label='Font size'): The size of number itself.
nan_format = String(default='-', label='Nan format'): How to format nan values.
title_size = String(default='18pt', label='Title size'): The size of the title given by the label.

panel.ui.indicators.Progress[source]#: alias of LinearProgress

class panel.ui.indicators.String(*, default_color, font_size, title_size, disabled, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, label, value, name)[source]#

Bases: ValueIndicator

The String indicator renders a string with a title.

Parameter Definitions

Parameters inherited from:

value = String(allow_None=True, label='Value'): The string to display
default_color = String(default='currentcolor', label='Default color'): The color of the indicator if no colors are provided
font_size = String(default='54pt', label='Font size'): The size of number itself.
title_size = String(default='18pt', label='Title size'): The size of the title given by the label.

class panel.ui.indicators.TooltipIcon(**params: Any)[source]#

Bases: Widget

The TooltipIcon displays a small ? icon. When you hover over the ? icon, the value will display.

Use the TooltipIcon to provide

helpful information to users without taking up a lot of screen space
tooltips next to Panel widgets that do not support tooltips yet.

Reference: https://panel.holoviz.org/reference/indicators/TooltipIcon.html

Example:

>>> pn.widgets.TooltipIcon(value="This is a simple tooltip by using a string")

Parameter Definitions

Parameters inherited from:

value = ClassSelector(class_=(<class 'str'>, <class 'bokeh.models.ui.tooltips.Tooltip'>), default='Description', label='Value'): The description in the tooltip.
align = Align(default='center', label='Align'): Whether the object should be aligned with the start, end or center of its container. If set as a tuple it will declare (vertical, horizontal) alignment.

class panel.ui.indicators.Tqdm(*, layout, lock, max, progress, text, text_pane, write_to_console, disabled, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, label, value, name)[source]#

Bases: Tqdm

Parameter Definitions

Parameters inherited from:

class panel.ui.indicators.Trend(*, data, layout, neg_color, plot_color, plot_type, plot_x, plot_y, pos_color, value_change, selection, disabled, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, label, value, name)[source]#

Bases: SyncableData, Indicator

The Trend indicator enables the user to display a dashboard kpi card.

The card can be layout out as:

a column (text and plot on top of each other) or a row (text and
plot after each other)

Reference: https://panel.holoviz.org/reference/indicators/Trend.html

Example:

>>> data = {'x': np.arange(50), 'y': np.random.randn(50).cumsum()}
>>> Trend(label='Price', data=data, plot_type='area', width=200, height=200)

Parameter Definitions

Parameters inherited from:

label = String(default='', label='Label'): The label or a short description of the card.
value = Parameter(default='auto', label='Value'): The primary value to be displayed.
sizing_mode = Selector(label='Sizing mode', names={}, objects=['fixed', 'stretch_width', 'stretch_height', 'stretch_both', 'scale_width', 'scale_height', 'scale_both', None]): How the component should size itself. This is a high-level setting for maintaining width and height of the component. To gain more fine grained control over sizing, use width_policy, height_policy and aspect_ratio instead (those take precedence over sizing_mode). "fixed" Component is not responsive. It will retain its original width and height regardless of any subsequent browser window resize events. "stretch_width" Component will responsively resize to stretch to the available width, without maintaining any aspect ratio. The height of the component depends on the type of the component and may be fixed or fit to component’s contents. "stretch_height" Component will responsively resize to stretch to the available height, without maintaining any aspect ratio. The width of the component depends on the type of the component and may be fixed or fit to component’s contents. "stretch_both" Component is completely responsive, independently in width and height, and will occupy all the available horizontal and vertical space, even if this changes the aspect ratio of the component. "scale_width" Component will responsively resize to stretch to the available width, while maintaining the original or provided aspect ratio. "scale_height" Component will responsively resize to stretch to the available height, while maintaining the original or provided aspect ratio. "scale_both" Component will responsively resize to both the available width and height, while maintaining the original or provided aspect ratio.
data = Parameter(allow_None=True, label='Data'): The plot data declared as a dictionary of arrays or a DataFrame.
layout = Selector(default='column', label='Layout', names={}, objects=['column', 'row']): The layout of the indicator, either a column (text and plot on top of each other) or a row (text and plot after each other).
plot_x = String(default='x', label='Plot x'): The name of the key in the plot_data to use on the x-axis.
plot_y = String(default='y', label='Plot y'): The name of the key in the plot_data to use on the y-axis.
plot_color = String(default='#428bca', label='Plot color'): The color to use in the plot.
plot_type = Selector(default='bar', label='Plot type', names={}, objects=['line', 'step', 'area', 'bar']): The plot type to render the plot data as.
pos_color = String(default='#5cb85c', label='Pos color'): The color used to indicate a positive change.
neg_color = String(default='#d9534f', label='Neg color'): The color used to indicate a negative change.
value_change = Parameter(default='auto', label='Value change'): A secondary value. For example the change in percent.

sizing_mode: t.Literal['fixed', 'stretch_width', 'stretch_height', 'stretch_both', 'scale_width', 'scale_height', 'scale_both'] | None = None#

class panel.ui.indicators.ValueIndicator(**params: Any)[source]#

Bases: Indicator

A ValueIndicator provides a visual representation for a numeric value.

Parameter Definitions

Parameters inherited from:

value = Number(allow_None=True, inclusive_bounds=(True, True), label='Value'): The widget value which the widget type resolves to when used as a reactive param reference.