Skip to content

Visualization

Requires the viz extra: pip install aime-loc[viz]

Radar Chart

radar_chart(profiles, *, title=None, show=True, save=None, journal='default', dpi=300, figsize=(10, 10), **kwargs)

Generate 13-axis radar chart comparing one or more cognitive profiles.

Parameters:

Name Type Description Default
profiles list[CognitiveProfile]

One or more :class:CognitiveProfile objects.

required
title str | None

Chart title (auto-generated if None).

None
show bool

Display the chart interactively.

True
save str | None

Path to save the figure.

None
journal str

Style preset — "default", "nature", "ieee".

'default'
dpi int

Resolution for saved figures.

300
figsize tuple[float, float]

Figure size in inches.

(10, 10)
**kwargs Any

Additional keyword arguments passed to matplotlib.

{}

Returns:

Type Description
Any

class:matplotlib.figure.Figure object.

Bar Chart

bar_chart(profile, *, show=True, save=None, dpi=300, **kwargs)

Display per-function bar chart with gate breakdown for a single profile.

Parameters:

Name Type Description Default
profile CognitiveProfile

A :class:CognitiveProfile.

required
show bool

Display interactively.

True
save str | None

Path to save figure.

None
dpi int

Resolution.

300

Returns:

Type Description
Any

matplotlib Figure.

Benchmark Heatmap

benchmark_heatmap(benchmark, *, show=True, save=None, dpi=300, **kwargs)

Display per-function heatmap across all benchmarked models.

Parameters:

Name Type Description Default
benchmark BenchmarkResult

A :class:BenchmarkResult.

required
show bool

Display interactively.

True
save str | None

Path to save figure.

None
dpi int

Resolution.

300

Returns:

Type Description
Any

matplotlib Figure.

Delta Chart

delta_chart(comparison, *, show=True, save=None, dpi=300, **kwargs)

Display per-function delta bar chart between two models.

Green bars = model_b improved, red bars = model_b degraded.

Parameters:

Name Type Description Default
comparison ModelComparison

A :class:ModelComparison.

required
show bool

Display interactively.

True
save str | None

Path to save figure.

None
dpi int

Resolution.

300

Returns:

Type Description
Any

matplotlib Figure.

Figure Export

export_figure(profile, path, *, journal='default', dpi=300, fmt='png')

Export a publication-ready radar chart figure.

Parameters:

Name Type Description Default
profile CognitiveProfile

The cognitive profile to visualize.

required
path str

Output file path.

required
journal str

Style preset — "default", "nature", "ieee", "apa".

'default'
dpi int

Resolution for raster formats.

300
fmt str

Output format — "png", "svg", "pdf".

'png'