fig_leg_bid_prices

passengersim.contrast.fig_leg_bid_prices(summaries: dict[str, SimulationTables], *, std_dev: bool = True, include: tuple[str, ...] | None = None, raw_df: bool = False, ids: int | tuple[int, ...] | None = None, carrier: str | tuple[str, ...] | None = None, orig: str | tuple[str, ...] | None = None, dest: str | tuple[str, ...] | None = None) → Chart | HConcatChart | DataFrame[source]

Compare daily leg bid prices from native summary history.

Parameters:
summaries : dict[str, SimulationTables]

Named results containing leg_bid_price_history. No callback is required.

std_dev : bool, optional

Show a second panel with pooled sample standard deviations (default True).

include : tuple[str, ...] or None, optional

Result keys to include. By default, include all results.

raw_df : bool, optional

Return tidy data with native column names, observation counts, and a source column instead of a chart.

ids : int or tuple[int, ...] or None, optional

Restrict the plot to these leg IDs. By default, show every leg.

carrier : str or tuple[str, ...] or None, optional

Filter using leg metadata. Values within a filter are alternatives; different filters and ids are intersected. Requires legs data.

orig : str or tuple[str, ...] or None, optional

Filter using leg metadata. Values within a filter are alternatives; different filters and ids are intersected. Requires legs data.

dest : str or tuple[str, ...] or None, optional

Filter using leg metadata. Values within a filter are alternatives; different filters and ids are intersected. Requires legs data.

Returns:

alt.Chart or alt.HConcatChart or pandas.DataFrame – Mean bid prices, optionally beside standard deviations, or the plot data. Runs have distinct stroke styles. Legs have distinct colors only when a dozen or fewer distinct legs remain after filtering.

Raises:
  • MissingDataError – Native history or required metadata is absent in a selected result.

  • ValueError – No comparison results are selected.