WayriCAD results and cross-selection

Open the saved-result demo · WayriCAD tools · Complete library API and limits

From native tools to a browser

Use WayriCAD to compute the study, then use Save results / Pocket KiVi to retain its portable companion. The self-hosted KiCad WebView 0.4.0 SDK reads those existing JSON structures and displays the saved values beside the matching native PCB. It does not run the solver, execute a report, modify a design or fetch source paths found inside a result.

Keep the original solve-time saved PCB fingerprint and its corresponding PCB. A fresh hash of a changed board cannot establish where an older result came from. See WayriCAD’s pinned export contract.

Independent 3D field views use only supplied XYZ or an explicit saved layer elevation. They retain source coordinates, the producer’s elevation basis and source-unit probes. Values are not turned into invented heights. Unknown elevation stays in the 2D view. Use Show on matching PCB to register the field on the native 2D/3D board. Supported front-depth/board-center elevations map onto the actual board; without saved Z only explicitly named F.Cu/B.Cu surfaces are placed. Fields show through the substrate and models, with that presentation labelled. PCB layer visibility is respected.

Embed both views without Node.js

<div id="board" style="height:420px"></div>
<div id="results"></div>
<script src="https://wayri.github.io/assets/lib/kicad-webview/releases/0.4.0/kicad-webview.min.js"></script>
<script type="module">
  const board = new KiCadWebView.Viewer('#board', {theme:'dark'});
  await board.load('/designs/board.kicad_pcb');
  const results = new KiCadWebView.WayriCADResultsViewer('#results', {
    theme:'dark', boardViewer:board
  });
  await results.loadURL('/results/board.quick-pi.pocket-kivi.json');
  results.setBoardOverlay(true);
  await board.setView('3d');
  window.addEventListener('pagehide', () => {
    results.dispose();
    board.dispose();
  }, {once:true});
</script>

Host the script, source and result yourself, or use the versioned self-hosted script above. Normal CORS and authorization apply. No rendering server or runtime Node installation is required. The ES module exports the same names; the /results npm entry and dist/wayricad-results.js offer the result component separately.

results.load(jsonOrObject,{path}) accepts already supplied data without fetching. The demo’s local file pickers keep your files in the browser. Review the full result JSON, including any filesystem/model metadata, before sharing it. Quick start · Hosting.

Layers and linked views

Choose Saved result layer to retain the quantity while moving between saved layers. Use the PCB Layers panel to show or hide copper; hidden layers hide the corresponding overlay. The active result layer stays pinned while inspecting the board. Click a saved field or a PCB part/trace to link probe markers. Registered 3D clicks retain their exact hit value and elevation. Spatial probe links do not infer electrical connectivity.

The 0.4.0 SDK adds getResultLayers(), setLayer(name), setBoardOverlay(boolean) and getBoardOverlayState(). Viewer.getSelectionPosition() exposes a saved anchor or segment midpoint, or null. npm/CDN 0.3.0 remains available for the prior APIs; use the self-hosted 0.4.0 files for these additions.

Inspect, probe and cross-select

Choose a saved plot, then click to probe an original retained cell/sample or interpolate inside a supported saved nodal triangle. Curves break across missing values and retain repeated event times. SI data stays on its supplied axis; it is not painted over copper as a made-up spatial field.

For transient thermal data, move Saved frame to a retained time, probe a cell and choose Plot probe history. Return to saved field restores the field and frame. The scale remains fixed over that layer’s saved frames. Both 2D and 3D use the same palette/range; a labelled vertex-color fallback may be used if the scalar shader cannot run, while numerical probes remain exact to the supported saved interpolation.

On a verified matching PCB, Highlight saved net and Locate saved route use the exporter’s exact name/UUIDs. Selecting a matching PCB object or net reports its source match in the results panel. Unmatched and ambiguous targets remain unlinked. Source replacement disables association until it has been checked again.

Source state is separate from result validity

• Matching: the declared saved PCB SHA-256 equals the loaded bytes. This is byte association, not authentication, solver qualification or a measured result.
• Stale: the declared hash differs. PCB overlays and source actions are disabled; historical numerical results remain readable independently.
• Unverified: missing, unsaved, ambiguous or unsupported source evidence. Independent supported plots and the full data remain available.

Canonical wayricad.project-result/v1 library records are not independently content-identity-verified by this adapter, so their PCB association remains unverified. Use a supported portable companion with its retained saved-source evidence for registration. Producer save/load documentation.

Display and mobile limits

Inputs are JSON only, limited to 64 MiB with depth/work bounds. Duplicate keys and nonfinite input numbers are rejected. Large datasets need an explicit Load action, especially on phones. Full arrays, nulls and producer metadata remain in the frozen result and JSON download; the paged data browser avoids expanding every cell into the page.

The default graph selects up to four ordinary series or 32 eye traces and shows at most 100,000 selected points, with the limit and selection count visible. Grid cell edges follow adjacent saved center spacing; boundary cells are not clipped to copper, board outlines or openings. A singleton or unordered axis does not establish an area surface. Unsupported geometry remains numerical data. These display choices are not additional solver calculations.

3D rendering is demand-driven and pauses when unavailable/off-screen. Keep a stable mount height, dispose on unmount, and test representative files on the intended host/device. Physical-phone performance and compatibility with every application sandbox are not established by the desktop browser checks.

Example evidence and acknowledgements

The demo uses public WayriCAD saved-board examples pinned to 0617fd2. PI/thermal use the included generated two-layer PCB; SI uses its documented complete-channel derivative. These are computed example producer outputs under declared assumptions, not measured hardware or production designs. The eye display is illustrative. No solver was rerun for this WebView integration.

Original sample arrays and metadata spelling are retained, including legacy encoded unit strings; known plot labels follow the producer’s field conventions. No numerical unit conversion occurs. See the original assumptions and producer provenance, retained demo credits and upstream example notice. Upstream design/example terms remain separate from WebView’s MPL-2.0 license.

Development acknowledgements, including AI assistance · License and optional support · Library result API.