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
Returns a list of strings, one per non-reference option, plus a leading summary line.