fig_path_bid_prices

passengersim.contrast.fig_path_bid_prices(summaries: dict[str, SimulationTables], *, std_dev: bool = True, augmented: bool = False, 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 path bid prices from native summary history.

Parameters:
summaries : dict[str, SimulationTables]

Named results containing path_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.

augmented : bool, optional

Plot augmented bid prices instead of ordinary path totals. Defaults to False.

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 path IDs. By default, show every path.

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

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

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

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

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

Filter using path metadata. Values within a filter are alternatives; different filters and ids are intersected. Requires paths 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. Paths have distinct colors only when a dozen or fewer distinct paths remain after filtering.

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

  • ValueError – No comparison results are selected.