task_charts__single_series__order_statistic_label

Contract

1. Domain: charts
2. Scene id: single_series
3. Source implementation: src/trace_tasks/tasks/charts/single_series/order_statistic_label.py
4. Public task id: task_charts__single_series__order_statistic_label
5. Supported query_id values: median_order_statistic_label, nth_highest_order_statistic_label, nth_lowest_order_statistic_label
6. Query ids are internal replay metadata; scene style, label pool, mark count, and context mode are generation metadata.

Implementation

1. Registered class: trace_tasks.tasks.charts.single_series.order_statistic_label.ChartsSingleSeriesOrderStatisticLabelTask
2. Prompt lookup: src/trace_tasks/resources/prompts/charts/single_series/charts_statistics_v1.json
3. Generation is deterministic from instance_seed, explicit params, prompt bundle, renderer config, and code versions.
4. Answers and annotation are produced from the same metadata execution trace.

Program Contract

Program: label(select_ranked_mark(marks, statistic_kind)); output=string_label; annotation=point(selected_mark); scene=single_series; scope=order_statistic_label

Candidate set: the visible marks in the ordered single-series chart inside the order_statistic_label objective scope. Operands: prompt-bound labels, categories, series names, thresholds, intervals, references, and encoded chart values, plus the active query id's comparator, direction, target role, or extremum focus when present. Operation: evaluate label over the candidate set using the filters, comparisons, aggregations, rankings, projections, or counterfactual edits named in the program expression; generation enforces a unique final answer. Output binding: answer is the string_label value bound by string_label. Annotation witnesses: point witnesses bound by point(selected_mark). Annotation marks the selected ranked-statistic mark point only. Axes, legend, titles, captions, decorative context, and distractor text are context unless the task explicitly asks for them as annotation. Query ids: median_order_statistic_label, nth_highest_order_statistic_label, nth_lowest_order_statistic_label.

Reasoning Operations

Families: ranking

Annotation Contract

1. Answer schema: string_label.
2. Annotation schema: point.
3. Annotation marks the selected ranked-statistic mark point only.
4. Axes, legend, titles, captions, decorative context, and distractor text are context unless the task explicitly asks for them as annotation.

Query Details

Query id	Program signature	Answer schema	Annotation schema
median_order_statistic_label	label.selected_median_mark	string_label	point
nth_highest_order_statistic_label	label.selected_nth_highest_mark	string_label	point
nth_lowest_order_statistic_label	label.selected_nth_lowest_mark	string_label	point