Skip to content

Style Series Appearance#

Style the appearance of different series types like area, area range, bubble, column, line, and scatter with customizable color specifications and marker symbols.

AreaSeriesStyling #

AreaSeriesStyling(
    *,
    color_spec: ColorSpec,
    data_column: TemplatedStringItem | None = None,
    marker_symbol: MarkerSymbol = CIRCLE,
)

Customize appearance of filled areas in Charts.

Specify styling options for an area series within a Chart widget to customize the appearance of filled areas on the chart.

Constructor for AreaSeriesStyling.

Parameters:

Name Type Description Default
color_spec ColorSpec

spec for coloring area.

required
data_column TemplatedStringItem | None

name of column in pandas dataframe(s) used for color spec if a gradient is used. Optional for single colors.

None
marker_symbol MarkerSymbol

symbol for marker in tooltips and legends.

CIRCLE

Raises:

Type Description
ChartStylingMissingDataColumnError

if color_spec is ColorDiscreteMap/ColorGradient and data_column has not been specified

AreaRangeSeriesStyling #

AreaRangeSeriesStyling(
    *,
    color_spec: ColorSpec,
    data_column: TemplatedStringItem | None = None,
    marker_symbol: MarkerSymbol = CIRCLE,
)

Customize appearance of filled areas between values.

Specify styling specifications for an area range series within a Timeseries widget to customize the appearance of filled areas between low and high values on the chart.

Constructor for AreaRangeSeriesStyling.

Parameters:

Name Type Description Default
color_spec ColorSpec

spec for coloring area range.

required
data_column TemplatedStringItem | None

name of column in pandas dataframe(s) used for color spec if a gradient is used. Optional for single colors.

None
marker_symbol MarkerSymbol

symbol for marker in tooltips and legends.

CIRCLE

Raises:

Type Description
ChartStylingMissingDataColumnError

if color_spec is ColorDiscreteMap/ColorGradient and data_column has not been specified

BubbleCircleSeriesStyling #

BubbleCircleSeriesStyling(
    *,
    color_spec: ColorSpec,
    data_column: TemplatedStringItem | None = None,
    label_column: TemplatedStringItem | None = None,
    max_size_percentage: int | float | None = 0.5,
    min_size_percentage: int | float | None = 0.2,
)

Customize appearance of bubble markers.

Specify styling options for a bubble circle series within a Chart widget to customize the appearance of bubble markers on the chart.

Constructor for BubbleCircleSeriesStyling.

Parameters:

Name Type Description Default
color_spec ColorSpec

spec for coloring bubble.

required
data_column TemplatedStringItem | None

name of column in pandas dataframe(s) used for color spec if a gradient is used. Optional for single colors.

None
label_column TemplatedStringItem | None

name of column in pandas dataframe(s) used for labeling the bubble.

None
max_size_percentage int | float | None

Percentage of the highest one of the plot width and height.

0.5
min_size_percentage int | float | None

Percentage of the smallest one of the plot width and height.

0.2

Raises:

Type Description
ChartStylingMissingDataColumnError

if color_spec is ColorDiscreteMap/ColorGradient and data_column has not been specified

BubbleCountrySeriesStyling #

BubbleCountrySeriesStyling(
    *,
    country_column: TemplatedStringItem,
    max_size_percentage: int | float | None = 0.5,
    min_size_percentage: int | float | None = 0.2,
)

Customize appearance of country bubble markers.

Specify styling options for a bubble country series within a Chart widget to customize the appearance of bubble markers representing countries on the chart.

Constructor for BubbleCountrySeriesStyling.

Parameters:

Name Type Description Default
country_column TemplatedStringItem

name of column in pandas dataframe(s) with country codes.

required
max_size_percentage int | float | None

Percentage of the highest one of the plot width and height.

0.5
min_size_percentage int | float | None

Percentage of the smallest one of the plot width and height.

0.2

ColumnSeriesStyling #

ColumnSeriesStyling(
    *,
    color_spec: ColorSpec,
    data_column: TemplatedStringItem | None = None,
    marker_symbol: MarkerSymbol = SQUARE,
)

Customize appearance of vertical columns.

Specify styling options for a column series within a Chart widget to customize the appearance of vertical columns on the chart.

Constructor for ColumnSeriesStyling.

Parameters:

Name Type Description Default
color_spec ColorSpec

spec for coloring columns.

required
data_column TemplatedStringItem | None

name of column in pandas dataframe(s) used for color spec if a gradient is used. Optional for single colors.

None
marker_symbol MarkerSymbol

symbol for marker in tooltips and legends.

SQUARE

Raises:

Type Description
ChartStylingMissingDataColumnError

if a data_column is not defined when color_spec is a ColorDiscreteMap or ColorGradient

ErrorBarSeriesStyling #

ErrorBarSeriesStyling(
    *,
    color_spec: ColorSpec,
    data_column: TemplatedStringItem | None = None,
    marker_symbol: MarkerSymbol = SQUARE,
)

Customize appearance of error bars in Chart.

Specify styling options for an error bar series within a Chart widget to customize the appearance of error bars representing data variability or uncertainty on the chart.

Constructor for ErrorBarSeriesStyling.

Parameters:

Name Type Description Default
color_spec ColorSpec

spec for coloring columns.

required
data_column TemplatedStringItem | None

name of column in pandas dataframe(s) used for color spec if a gradient is used. Optional for single colors.

None
marker_symbol MarkerSymbol

symbol for marker in tooltips and legends.

SQUARE

Raises:

Type Description
ChartStylingMissingDataColumnError

if a data_column is not defined when color_spec is a ColorDiscreteMap or ColorGradient

LineSeriesStyling #

LineSeriesStyling(
    *,
    color_spec: ColorSpec | None = None,
    data_column: TemplatedStringItem | None = None,
    dash_style: DashStyle | TemplatedStringItem = SOLID,
    marker_symbol: MarkerSymbol = CIRCLE,
    width: int = 2,
)

Customize appearance of lines in Chart.

Specify styling options for a line series within a Chart widget to customize the appearance of the lines connecting data points on the chart.

Constructor for LineSeriesStyling.

Parameters:

Name Type Description Default
color_spec ColorSpec | None

spec for coloring area.

None
data_column TemplatedStringItem | None

name of column in pandas dataframe(s) used for color spec if a gradient is used. Optional for single colors.

None
dash_style DashStyle | TemplatedStringItem

dash style of line.

SOLID
marker_symbol MarkerSymbol

symbol for marker in tooltips and legends.

CIRCLE
width int

width of line.

2

Raises:

Type Description
ChartStylingMissingDataColumnError

if a data_column is not defined when color_spec is a ColorDiscreteMap or ColorGradient

PointSeriesStyling #

PointSeriesStyling(
    *,
    color_spec: ColorSpec,
    data_column: TemplatedStringItem | None = None,
    marker_symbol: MarkerSymbol = CIRCLE,
)

Customize appearance of data points in Chart.

Specify styling options for a point series within a Chart widget to customize the appearance of individual data points on the chart.

Constructor for PointSeriesStyling.

Parameters:

Name Type Description Default
color_spec ColorSpec

spec for coloring columns.

required
data_column TemplatedStringItem | None

name of column in pandas dataframe(s) used for color spec if a gradient is used. Optional for single colors.

None
marker_symbol MarkerSymbol

symbol for each point.

CIRCLE

Raises:

Type Description
ChartStylingMissingDataColumnError

if a data_column is not defined when color_spec is a ColorDiscreteMap or ColorGradient

ScatterSeriesStyling #

ScatterSeriesStyling(
    *,
    color_spec: ColorSpec,
    data_column: TemplatedStringItem | None = None,
    marker_symbol: MarkerSymbol = CIRCLE,
)

Customize appearance of scatter markers.

Specify styling options for a scatter series within a Timeseries widget to customize the appearance of individual data points represented as scatter markers on the chart.

Constructor for ScatterSeriesStyling.

Parameters:

Name Type Description Default
color_spec ColorSpec

spec for coloring columns.

required
data_column TemplatedStringItem | None

name of column in pandas dataframe(s) used for color spec if a gradient is used. Optional for single colors.

None
marker_symbol MarkerSymbol

symbol for each point.

CIRCLE

Raises:

Type Description
ChartStylingMissingDataColumnError

if a data_column is not defined when color_spec is a ColorDiscreteMap or ColorGradient