guidellm.benchmark.outputs.plot
Plot output formatter for benchmark results.
This module provides the GenerativeBenchmarkerPlot class which exports benchmark reports to a static PNG image format containing comprehensive performance visualization charts.
GenerativeBenchmarkerPlot
Bases: GenerativeBenchmarkerOutput
Plot output formatter for benchmark results.
Generates a high-quality dashboard visualization of LLM benchmark results, enforcing light theme and saving to a PNG image file.
Source code in src/guidellm/benchmark/outputs/plot.py
766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 | |
finalize(report) async
Save the benchmark report as a static PNG plot visualization.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
report | GenerativeBenchmarksReport | The completed benchmark report | required |
Returns:
| Type | Description |
|---|---|
Path | Path to the saved PNG plot file |
Source code in src/guidellm/benchmark/outputs/plot.py
from_args(args) classmethod
Create a plot output formatter from output arguments.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
args | BenchmarkOutputArgs | Output configuration with path and dpi | required |
Returns:
| Type | Description |
|---|---|
GenerativeBenchmarkerPlot | Configured plot output formatter |
Source code in src/guidellm/benchmark/outputs/plot.py
PlotBenchmarkOutputArgs
Bases: BenchmarkOutputArgs
Model for Plot benchmark output arguments.
Defines parameters for generating static image visualizations, enforcing image output suffix.
Source code in src/guidellm/benchmark/outputs/plot.py
validate_plot_suffix(v) classmethod
Ensures the output file path ends with a supported plotting format extension.
If the suffix is missing, it defaults to .png. If an unsupported suffix is provided, it raises a ValueError.
Source code in src/guidellm/benchmark/outputs/plot.py
plot_generation_latency_vs_request_rate(ax, points)
Plot per-token generation latency against observed request rate.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ax | Axes | Matplotlib axis to draw on | required |
points | Sequence[_BenchmarkPoint] | Benchmark points extracted from the report | required |
Source code in src/guidellm/benchmark/outputs/plot.py
plot_latency_breakdown_at_peak_throughput(ax, points)
Plot latency component medians and p95s for the highest-throughput benchmark.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ax | Axes | Matplotlib axis to draw on | required |
points | Sequence[_BenchmarkPoint] | Benchmark points extracted from the report | required |
Source code in src/guidellm/benchmark/outputs/plot.py
plot_latency_vs_request_rate(ax, points)
Plot TTFT and end-to-end latency against observed request rate.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ax | Axes | Matplotlib axis to draw on | required |
points | Sequence[_BenchmarkPoint] | Benchmark points extracted from the report | required |
Source code in src/guidellm/benchmark/outputs/plot.py
plot_latency_vs_throughput(ax, points)
Plot first-token latency against token throughput to expose the saturation knee.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ax | Axes | Matplotlib axis to draw on | required |
points | Sequence[_BenchmarkPoint] | Benchmark points extracted from the report | required |
Source code in src/guidellm/benchmark/outputs/plot.py
plot_request_status_counts(ax, points)
Plot request status counts by concurrency level.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ax | Axes | Matplotlib axis to draw on | required |
points | Sequence[_BenchmarkPoint] | Benchmark points extracted from the report | required |
Source code in src/guidellm/benchmark/outputs/plot.py
plot_throughput_efficiency_vs_concurrency(ax, points)
Plot total token throughput per concurrent request.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ax | Axes | Matplotlib axis to draw on | required |
points | Sequence[_BenchmarkPoint] | Benchmark points extracted from the report | required |
Source code in src/guidellm/benchmark/outputs/plot.py
plot_token_throughput_mix_vs_request_rate(ax, points)
Plot input and output token throughput mix against request rate.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ax | Axes | Matplotlib axis to draw on | required |
points | Sequence[_BenchmarkPoint] | Benchmark points extracted from the report | required |
Source code in src/guidellm/benchmark/outputs/plot.py
plot_token_throughput_vs_concurrency(ax, points)
Plot total, input, and output token throughput against request concurrency.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ax | Axes | Matplotlib axis to draw on | required |
points | Sequence[_BenchmarkPoint] | Benchmark points extracted from the report | required |