describe_tradeoffs_for_stakeholders

site.SiteSolutionSet.describe_tradeoffs_for_stakeholders(
    id_col='solution_rank',
    name_col=None,
    anchor=None,
    markdown=True,
)

Stakeholder-facing version of describe_tradeoffs().

Same underlying comparison, but written for people who don’t need (or want) to know what “Pareto-optimal” or “dominates” mean. Every option is framed relative to a single reference option, in terms of what it gains and what it gives up – no raw deltas, no jargon.

For best results, write each Metric.label as a short, plain phrase that reads naturally in a sentence (e.g. “average journey time” rather than “Weighted average”), and set unit / as_percentage so the numbers come out in a form people recognise (minutes, %, etc).

name_col: if you have a more meaningful label than the raw id (e.g. a short scenario name), pass its column name here. Otherwise options are labelled “Option ”. markdown: if True (default), returns Quarto/markdown-friendly bullet blocks; if False, returns plain-text paragraphs.

Returns a list of strings, one per non-reference option, plus a leading summary line.

Back to top