Tunny Icon
TunnyDocs

The next-gen Grasshopper optimization tool.

Rank Plot 2D/3D

Overview

Rank Plot 2D plots two parameters on X/Y. Rank Plot 3D plots three parameters on X/Y/Z. Each point represents a COMPLETE trial and is colored by the selected objective's rank percentile (0 = best, 1 = worst), rather than its raw objective value. Use the 2D chart to inspect parameter pairs and the 3D chart to explore combinations involving a third parameter.

The 3D canvas fills the remaining chart area below the selectors and resizes with the widget, like the other 3D scatter charts. The vertical Best/Worst legend is overlaid inside the canvas's right edge rather than taking space beside the plot.

Controls

Control Rank Plot 2D Rank Plot 3D
Parameters X and Y, initially the first two parameters X, Y, and Z, initially the first three parameters
Axis selection Choose a parameter for each axis Choose three distinct parameters; parameters used by another axis are not offered
Required inputs At least 2 parameters and 1 objective At least 3 parameters and 1 objective
Objective In multi-objective studies, choose the objective used for rank colors Same

The axes use parameter values, not objective values. Categorical parameters use the same numeric encoding as other scatter charts. A point with a missing or non-finite selected coordinate (NaN or either infinity) is not plotted.

Rank and colors

Both charts use the same rank calculation over the full selected objective column of COMPLETE trials, independently of coordinate filtering and the displayed sample:

  • Finite objective values are ordered from best to worst according to the objective's minimize/maximize direction.
  • Tied objective values receive the average of their zero-based ranks.
  • With more than one finite objective value, that average is divided by the number of finite objective values minus one. A sole finite value has rank 0.
  • Missing and non-finite objective values (NaN, +Infinity, -Infinity) receive rank 1 (worst). A trial with such an objective can still be plotted if its selected coordinates are finite.

The selected colormap is shared by both charts. Best (rank 0) uses the high end of the colormap at the top of the legend; Worst (rank 1) uses the low end at the bottom. Changing parameter axes does not change objective ranks. Ranking reduces the influence of raw-value outliers; ties can still share a color.

Operations

Navigation follows the standard chart controls: 2D supports wheel/box zoom, right-drag pan, and double-click reset. In 3D, right-drag rotates, middle-drag or Shift + right-drag pans, and the wheel zooms.

Hover over a displayed point to see its trial number, selected X/Y (and Z) parameter values, selected objective value, and rank percentile. Left-click a point to open the shared Trial Detail modal, including Rank Percentile, parameter/objective values, and attached artifacts.

Rank Plot 3D displays at most 1,500 usable points using a deterministic sample. Hover and click apply to the displayed points. Sampling does not change ranks.

CSV export

CSV exports all COMPLETE trial rows, including rows with missing/non-finite coordinates and rows outside the displayed 3D sample. Columns are trial_id, the selected X/Y parameter names (plus Z in 3D), the selected objective name, and rank_percentile. Missing/non-finite numeric values are empty fields; non-finite objective values still have rank 1. Filenames are rank_plot_2d.csv and rank_plot_3d.csv.

How to read the charts

Regions containing many Best-colored points suggest promising parameter combinations. Mixed colors suggest that other parameters or interactions also matter. Try different axes, rotate the 3D view to separate overlapping points, or consult the Importance Chart. These plots show observed outcomes, not a fitted surface or proof of causality.