task_charts__scatter_cluster__cluster_area_rank_label

Contract

1. Domain: charts
2. Scene id: scatter_cluster
3. Task id: task_charts__scatter_cluster__cluster_area_rank_label
4. Supported query_ids: largest_cluster_area_label, smallest_cluster_area_label

Implementation

1. Registered class: trace_tasks.tasks.charts.scatter_cluster.cluster_area_rank_label.ChartsScatterClusterAreaRankLabelTask
2. Prompt bundle: src/trace_tasks/resources/prompts/charts/scatter_cluster/charts_scatter_cluster_v1.json
3. Generation is deterministic from instance_seed, explicit params, prompt bundle, renderer config, and code versions.

Program Contract

Program: ranked_label(cluster, footprint_area(cluster), rank); scene=scatter_cluster; scope=cluster_area_rank_label

Candidate set: the visible scatter points, clusters, and cluster labels inside the cluster_area_rank_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 ranked_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 value bound by string. Annotation witnesses: bbox witnesses bound by see_annotation_contract. Annotation should mark the answer cluster's shaded footprint, not the legend row or raw point labels. Renderer context such as legends, axes, decorative labels, titles, and distractor text is metadata unless the task explicitly asks for it as annotation. Query ids: largest_cluster_area_label, smallest_cluster_area_label.

Reasoning Operations

Families: ranking, formula_evaluation

Annotation Contract

1. Answer schema: string.
2. Annotation schema: bbox.
3. Annotation should mark the answer cluster's shaded footprint, not the legend row or raw point labels.
4. Renderer context such as legends, axes, decorative labels, titles, and distractor text is metadata unless the task explicitly asks for it as annotation.

Query Details

Query id	Program arguments	Answer schema	Annotation schema
largest_cluster_area_label	rank=largest	string	bbox
smallest_cluster_area_label	rank=smallest	string	bbox