vuecore.schemas.basic.line module

class vuecore.schemas.basic.line.LineConfig(*, x: str | None = None, y: str | None = None, color: str | None = None, hover_name: str | None = None, hover_data: List[str] = [], facet_row: str | None = None, facet_col: str | None = None, labels: Dict[str, str] | None = None, color_discrete_map: Dict[str, str] | None = None, category_orders: Dict[str, List[str]] | None = None, log_x: bool = False, log_y: bool = False, range_x: List[float] | None = None, range_y: List[float] | None = None, title: str = 'Plotly Plot', x_title: str | None = None, y_title: str | None = None, subtitle: str | None = None, template: str = 'plotly_white', width: int | None = 800, height: int | None = 600, line_group: str | None = None, line_dash: str | None = None, symbol: str | None = None, text: str | None = None, error_x: str | None = None, error_y: str | None = None, line_dash_map: Dict[str, str] | None = None, symbol_map: Dict[str, str] | None = None, markers: bool = False, line_shape: str | None = 'linear', **extra_data: Any)

Bases: PlotlyBaseConfig

Pydantic model for validating and managing line plot configurations, which extends PlotlyBaseConfig.

This model serves as a curated API for the most relevant parameters for line plots, closely aligned with the plotly.express.line API (https://plotly.com/python-api-reference/generated/plotly.express.line.html).

This model includes the most relevant parameters for data mapping, styling, and layout. It ensures that user-provided configurations are type-safe and adhere to the expected structure. The plotting function handles parameters defined here, and also accepts additional Plotly keyword arguments, forwarding them to the appropriate plotly.express.line or plotly.graph_objects.Figure call.

attribute line_group: str | None = None

Column to group data into separate lines.

attribute line_dash: str | None = None

Column to assign dash styles to lines.

attribute symbol: str | None = None

Column to assign symbols to markers.

attribute text: str | None = None

Column for text labels on markers.

attribute error_x: str | None = None

Column for x-axis error bars.

attribute error_y: str | None = None

Column for y-axis error bars.

attribute line_dash_map: Dict[str, str] | None = None

Map values to specific dash styles.

attribute symbol_map: Dict[str, str] | None = None

Map values to specific symbols.

attribute markers: bool = False

If True, displays markers on the lines.

attribute line_shape: str | None = 'linear'

Line shape (e.g., ‘linear’, ‘spline’).

validator validate_x_or_y_provided  »  all fields

Ensure at least one of x or y is provided for the plot.

attribute x: str | None = None

Column for x-axis values.

attribute y: str | None = None

Column for y-axis values.

attribute color: str | None = None

Column to assign color to plot elements.

attribute hover_name: str | None = None

Column to appear in bold in the hover tooltip.

attribute hover_data: List[str] = []

Additional columns for the hover tooltip.

attribute facet_row: str | None = None

Column to create vertical subplots (facets).

attribute facet_col: str | None = None

Column to create horizontal subplots (facets).

attribute labels: Dict[str, str] | None = None

Dictionary to override column names for titles, legends, etc.

attribute color_discrete_map: Dict[str, str] | None = None

Specific color mappings for values in the color column.

attribute category_orders: Dict[str, List[str]] | None = None

Dictionary to specify the order of categorical values.

attribute log_x: bool = False

If True, use a logarithmic x-axis.

attribute log_y: bool = False

If True, use a logarithmic y-axis.

attribute range_x: List[float] | None = None

Range for the x-axis, e.g., [0, 100].

attribute range_y: List[float] | None = None

Range for the y-axis, e.g., [0, 100].

attribute title: str = 'Plotly Plot'

The main title of the plot.

attribute x_title: str | None = None

Custom title for the x-axis.

attribute y_title: str | None = None

Custom title for the y-axis.

attribute subtitle: str | None = None

The subtitle of the plot.

attribute template: str = 'plotly_white'

Plotly template for styling.

attribute width: int | None = 800

Width of the plot in pixels.

attribute height: int | None = 600

Height of the plot in pixels.