How To Use SPEC Aggregator

Search Configs

Use the home page workflow cards to search, compare, or open the advisor. Search values like 8380 or 9374F, then click a config key to open details.

Config Detail

Open /config/2x8380 to see a humanized platform profile, generation, sockets, cores, vendor diversity, benchmark medians, samples, standard deviation, and confidence.

Compare Tool

Open /compare-tool to compare platforms without editing URLs. Both left and right inputs show live suggestions while typing.

Compare

Use the compare form or open /compare?left=2x8380&right=2x9374F&prefer_rate=true. The page includes humanized platform headers, explicit dataset scope, executive summary, confidence explanations, and vendor diversity. Use dataset_id=spec_jbb2015 for JBB-only comparisons.

Export

Click Export CSV on a compare page, or use /export/compare with the same query params.

Migration Advisor

Open /advisor, choose an analysis dataset, enter a current platform, and review ranked candidates with expected gain, confidence, platform similarity, rationale, Compare, and Provenance actions.

Platform Families

Open /families to explore observed platform generations such as Genoa, Turin, Bergamo, Ice Lake, and Sapphire Rapids. Family pages group by config key and support socket filters.

Provenance

Open /provenance/2x8380 to inspect raw public submissions. Click a system name to open a concrete submission detail page with exact selected metrics, selected submission id, related matching submissions, memory/storage/OS differences, change notes, system configuration, and SPEC disclosure links.

APIs

Use /search?q=8380 for benchmark-level rows across all current datasets. Use /api/recommend?target=2x8380, /api/provenance/2x8380, /api/stats, and the existing compare APIs for automation.

Dataset Pipeline

Use dataset_id on import, load, normalize, and aggregate endpoints for non-default datasets. For spec_jbb2015, aggregation shows JBB2015 Max-jOPS and JBB2015 Critical-jOPS as separate benchmark rows, with JBB vendor, memory, DIMMs, storage, SPEC links, date, and metric/value provenance fields mapped separately from CPU2017 base/peak scores.

API Docs

Open Swagger API Docs for all available endpoints.

Project File

The full guide is stored in docs/user_guide.md.