Scenario Services Components
light
IChart — Line & Scatter
IChart fetches IAMC time-series data from an ixmp4 platform and renders interactive line, bar, and scatter charts.
Provide datasetsBase for shared dimensions and one entry in datasets per series.
See also: Bar Charts and Interactive Features .

Line Charts

Basic multi-scenario chart
The most common setup: shared dimensions in datasetsBase , one entry per series in datasets . The variable name becomes the auto-title; the legend shows the distinguishing dimension. The explorer link icon appears by default.
Custom title, axis labels & decimal places
Override the auto-generated title with title . Set axis labels via y-label / x-label and control tooltip precision with :decimal-places .

Chart Configuration

Logarithmic Y-axis
Pass :config-options="{ scales: { y: { type: 'logarithmic' } } }" to switch to a log scale. configOptions also supports axis min / max , toggling display , and pointRadius for scatter mode.
Relative view toggle
:allow-relative-view="true" adds % / absolute toggle buttons to the toolbar. In relative mode each value is divided by the cross-dataset sum at that x-tick (×100). relative-view-y-label overrides the Y-axis label in relative mode.
Year whitelist
The years array restricts which x-ticks are shown. Data is fetched from the platform for all years and then filtered client-side, so no extra requests are made.
Hidden title & legend
:no-title="true" removes the title/subtitle area. :no-legend="true" hides the dataset legend. :explorer-link="false" hides the explorer link icon in the toolbar. :download="false" removes the toolbar entirely. Combine all four for a minimal embed-friendly chart.

Visual Encoding

Custom colors, dash patterns & labels
Set per-dataset visuals via datasetOptions : color (hex/CSS/rgb), borderDash ( [dashLen, gapLen] pixels), and label to override the auto-generated legend entry.
Filter-based datasets
Each dataset can use a full filter: IamcDataFilter object instead of plain strings, enabling advanced queries with name_in or name_ilike . datasetsBase accepts a filter object too.
Dual-variance: automatic color + dash encoding
When exactly two dimensions vary across datasets (and type is not bar ), IChart automatically maps the first varying dimension to color and the second to a dash pattern . No datasetOptions are needed — the encoding is inferred from the data shape. Here region drives color and scenario drives dash, making both groupings immediately readable.

Scatter Charts

Basic scatter chart
Set type="scatter" to render data points without connecting lines. Use configOptions.pointRadius to adjust dot size (default: 3).
Scatter with log scale & custom colors
Scatter charts support the same datasetOptions and configOptions as line charts. Dual-variance color encoding also applies automatically when two dimensions vary.