@graphty/webgpu-graph-algorithms 0.5.0 → 0.5.1

package/README.md

@@ -274,8 +274,10 @@ lane's own artifact; `bench:compare` skips when the card was not quiet during th
 `roundtrip` (T-2, T-3), `layout-exact` (T-4 and the Node side of T-5: `step(1)` on the exact ladder 1k / 4k / 8k / 16k /
 32k / 65k and at 10k, two rows per rung -- the wall time of one iteration with its readback, and the GPU time per iteration
 the profiler reports; every rung starts with an untimed clock warm-up burst, because NVIDIA's power management leaves the
-SM clock at its idle 210 MHz under sparse sub-millisecond dispatches and the kernels then measure 4-15x slower). The
-Chromium number of T-5 comes from the `bench`-tagged browser test (`GRAPHTY_BROWSER_GPU=nvidia node
+SM clock at its idle 210 MHz under sparse sub-millisecond dispatches and the kernels then measure 4-15x slower),
+`pagerank` (T-8), `wcc` (T-9), `layout-fr` (T-14: `step(1)` of `createFruchtermanReingold` and `createSpringElectrical`
+at 10k and at 100k with `repulsion: "exact"`, the same two rows per model and rung as `layout-exact`, tagged `fr` /
+`se`). The Chromium number of T-5 comes from the `bench`-tagged browser test (`GRAPHTY_BROWSER_GPU=nvidia node
 scripts/run-browser-project.js`), which appends its session through the Vitest commands bridge. `exactMaxNodes` is
 re-fixed from the ladder by the rule of plan section 7.8 (the largest rung under 4 ms per iteration, rounded down to a
 power of two; `benchmarks/layout-exact.bench.ts` `exactMaxNodesFromLadder`).
@@ -291,15 +293,16 @@ are the T-table of plan section 10.4. A missed target is re-fixed by a recorded
 
 Measured on nvidia-lovelace-driver580 (NVIDIA: 580.173.02 580.173.2.0), session 2026-09-20T01:06:48.656Z, medians of 5 runs; Chromium: nvidia / lovelace (nvidia-lovelace-driver0, the description is redacted by Chromium), session 2026-09-16T02:18:11.896Z.
 
-| Id  | What                                                                                                                                     | Target              | Measured               |
-| --- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ---------------------- |
-| T-1 | Upload of the 100k / 1M weighted hot prefix (16.4 MB); 1M / 10M (164 MB)                                                                 | <= 10 ms; <= 100 ms | 5.980 ms; 125.738 ms   |
-| T-2 | `degree` + 400 KB readback at 100k (core resident), Node                                                                                 | <= 2 ms             | 0.870 ms               |
-| T-3 | Empty submit + 4-byte `readU32` round trip, Dawn                                                                                         | <= 0.1 ms           | 0.181 ms               |
-| T-4 | ForceAtlas2 exact tier, GPU time per iteration (profiler) at 10k; at 16k                                                                 | <= 1 ms; <= 2 ms    | 0.586 ms; 1.053 ms     |
-| T-5 | ForceAtlas2 per-frame cost, `step(1)` + the 12n readback at 10k, Chromium (Node in brackets)                                             | <= 6 ms             | 2.400 ms (0.726 ms)    |
-| T-8 | PageRank, 100 iterations, wall end to end including the upload, at 100k / 1M; at 1M / 10M                                                | <= 150 ms; <= 1.5 s | 17.204 ms; 198.645 ms  |
-| T-9 | Weakly connected components (Afforest), wall end to end including the upload and the label readback, at 1M / 10M (100k / 1M in brackets) | <= 100 ms           | 145.970 ms (12.613 ms) |
+| Id   | What                                                                                                                                     | Target              | Measured               |
+| ---- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ---------------------- |
+| T-1  | Upload of the 100k / 1M weighted hot prefix (16.4 MB); 1M / 10M (164 MB)                                                                 | <= 10 ms; <= 100 ms | 5.980 ms; 125.738 ms   |
+| T-2  | `degree` + 400 KB readback at 100k (core resident), Node                                                                                 | <= 2 ms             | 0.870 ms               |
+| T-3  | Empty submit + 4-byte `readU32` round trip, Dawn                                                                                         | <= 0.1 ms           | 0.181 ms               |
+| T-4  | ForceAtlas2 exact tier, GPU time per iteration (profiler) at 10k; at 16k                                                                 | <= 1 ms; <= 2 ms    | 0.586 ms; 1.053 ms     |
+| T-5  | ForceAtlas2 per-frame cost, `step(1)` + the 12n readback at 10k, Chromium (Node in brackets)                                             | <= 6 ms             | 2.400 ms (0.726 ms)    |
+| T-8  | PageRank, 100 iterations, wall end to end including the upload, at 100k / 1M; at 1M / 10M                                                | <= 150 ms; <= 1.5 s | 17.204 ms; 198.645 ms  |
+| T-9  | Weakly connected components (Afforest), wall end to end including the upload and the label readback, at 1M / 10M (100k / 1M in brackets) | <= 100 ms           | 145.970 ms (12.613 ms) |
+| T-14 | Fruchterman-Reingold exact tier, GPU time per iteration (profiler) at 10k; at 100k (`repulsion: "exact"`)                                | recorded            | 0.617 ms; 16.367 ms    |
 
 Three rows miss their target in this session: the 1M / 10M upload (125.7 ms against 100 ms, the open owner decision of
 `docs/decisions/G1.md` section 7), the empty-submit round trip (0.181 ms against 0.1 ms: the row is measured after the
@@ -309,7 +312,9 @@ the working clock -- finding G3-F2 of `docs/decisions/G3.md` section 10), and WC
 with the core resident the same call takes 11-16 ms). The T-9 target is therefore below
 the T-1 upload it includes, an owner decision for `docs/decisions/G7.md`. The `pagerank` rows run all 100 iterations
 (`tolerance: 0`): at the NetworkX tolerance of 1e-6 the seeded G(n, m) input converges from the uniform start in one to
-four iterations, which would time one pull and call it a hundred.
+four iterations, which would time one pull and call it a hundred. The T-14 row is the `layout-fr` group of the later
+session 2026-09-20T19:25:37.311Z (the file's last session, the current baseline), whose other rows are within 1.08x of
+this table's; the spring-electrical preset measures 0.648 ms at 10k and 18.154 ms at 100k in the same session.
 
 The exact curve (the `layout-exact` group: 2D, E = 10n, seeded G(n, m), one simulation per rung; ms / iteration from the profiler):
 
@@ -338,15 +343,16 @@ RTX 4070 SUPER's at 10k and 3.0x at 65k.
 
 Measured on gpu-linux-t4 (NVIDIA: 580.126.20 580.126.20.0), session 2026-09-20T02:29:33.210Z (run 35483512705), medians of 5 runs; Chromium: nvidia / turing (nvidia-turing-driver0, the description is redacted by Chromium), session 2026-09-20T02:28:10.676Z.
 
-| Id  | What                                                                                                                                     | Target              | Measured               |
-| --- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ---------------------- |
-| T-1 | Upload of the 100k / 1M weighted hot prefix (16.4 MB); 1M / 10M (164 MB)                                                                 | <= 10 ms; <= 100 ms | 14.338 ms; 256.418 ms  |
-| T-2 | `degree` + 400 KB readback at 100k (core resident), Node                                                                                 | <= 2 ms             | 2.957 ms               |
-| T-3 | Empty submit + 4-byte `readU32` round trip, Dawn                                                                                         | <= 0.1 ms           | 1.296 ms               |
-| T-4 | ForceAtlas2 exact tier, GPU time per iteration (profiler) at 10k; at 16k                                                                 | <= 1 ms; <= 2 ms    | 0.972 ms; 1.953 ms     |
-| T-5 | ForceAtlas2 per-frame cost, `step(1)` + the 12n readback at 10k, Chromium (Node in brackets)                                             | <= 6 ms             | 2.600 ms (1.359 ms)    |
-| T-8 | PageRank, 100 iterations, wall end to end including the upload, at 100k / 1M; at 1M / 10M                                                | <= 150 ms; <= 1.5 s | 45.461 ms; 1092.799 ms |
-| T-9 | Weakly connected components (Afforest), wall end to end including the upload and the label readback, at 1M / 10M (100k / 1M in brackets) | <= 100 ms           | 293.079 ms (28.544 ms) |
+| Id   | What                                                                                                                                     | Target              | Measured                                                                                                                                       |
+| ---- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| T-1  | Upload of the 100k / 1M weighted hot prefix (16.4 MB); 1M / 10M (164 MB)                                                                 | <= 10 ms; <= 100 ms | 14.338 ms; 256.418 ms                                                                                                                          |
+| T-2  | `degree` + 400 KB readback at 100k (core resident), Node                                                                                 | <= 2 ms             | 2.957 ms                                                                                                                                       |
+| T-3  | Empty submit + 4-byte `readU32` round trip, Dawn                                                                                         | <= 0.1 ms           | 1.296 ms                                                                                                                                       |
+| T-4  | ForceAtlas2 exact tier, GPU time per iteration (profiler) at 10k; at 16k                                                                 | <= 1 ms; <= 2 ms    | 0.972 ms; 1.953 ms                                                                                                                             |
+| T-5  | ForceAtlas2 per-frame cost, `step(1)` + the 12n readback at 10k, Chromium (Node in brackets)                                             | <= 6 ms             | 2.600 ms (1.359 ms)                                                                                                                            |
+| T-8  | PageRank, 100 iterations, wall end to end including the upload, at 100k / 1M; at 1M / 10M                                                | <= 150 ms; <= 1.5 s | 45.461 ms; 1092.799 ms                                                                                                                         |
+| T-9  | Weakly connected components (Afforest), wall end to end including the upload and the label readback, at 1M / 10M (100k / 1M in brackets) | <= 100 ms           | 293.079 ms (28.544 ms)                                                                                                                         |
+| T-14 | Fruchterman-Reingold exact tier, GPU time per iteration (profiler) at 10k; at 100k (`repulsion: "exact"`)                                | recorded            | 0.942 ms; 54.232 ms (the spring preset 1.051 ms; 60.706 ms)                                                                                    |
 
 The exact curve (the `layout-exact` group: 2D, E = 10n, seeded G(n, m), one simulation per rung; ms / iteration from the profiler):
 

package/dist/browser.js

@@ -1,4 +1,4 @@
-import { G as GpuContext, W as WebGpuGraphError } from "./chunks/context-CRbw2Wyo.js";
+import { G as GpuContext, W as WebGpuGraphError } from "./chunks/context-BR7fx3vR.js";
 function navigatorGpu() {
   if (typeof navigator === "undefined") {
     return void 0;

package/dist/chunks/{context-CRbw2Wyo.js → context-BR7fx3vR.js}

@@ -49,6 +49,38 @@ const FA2_DISTANCE_FLOOR = 0.01;
 const FA2_DISTANCE_FLOOR_SQ = 1e-4;
 const FA2_COINCIDENT_SQ = 1e-8;
 const FA2_FLAG_FIRST = 1;
+const FA2_FLAG_ADAPTIVE = 2;
+const FR_START_TEMPERATURE = 0.1;
+const FR_REHEAT_FRACTION = 0.7;
+const FR_COOLING_STEP = 0.9;
+const FR_COOLING_PATIENCE = 5;
+const FR_ADAPTIVE_MAX_ITERATIONS = 1e4;
+const FR_DEFAULTS = Object.freeze({
+  k: null,
+  iterations: 50,
+  fixed: null,
+  dim: 2,
+  scale: 1,
+  settleThreshold: 1e-3,
+  settleWindow: 10,
+  iterationsPerStep: 1,
+  maxInFlight: 2,
+  cooling: "linear"
+});
+const SE_SCALE_REFERENCE_NODES = 300;
+const SE_DEFAULTS = Object.freeze({
+  springLength: 10,
+  springCoefficient: 0.8,
+  gravity: -12,
+  dragCoefficient: 0.9,
+  timeStep: 0.5,
+  dim: 2,
+  scale: 1,
+  settleThreshold: 1e-3,
+  settleWindow: 10,
+  iterationsPerStep: 1,
+  maxInFlight: 2
+});
 const PASSTHROUGH_FORMAT_CODES = Object.freeze(["E_GPU_INELIGIBLE", "E_UNKNOWN_NODE", "E_UNKNOWN_COLUMN", "E_COLUMN_LENGTH"]);
 const EMPTY_DETAILS = Object.freeze({});
 class WebGpuGraphError extends Error {
@@ -807,6 +839,9 @@ const FA2_DIST_FLOOR: f32 = ${wgslF32Literal(FA2_DISTANCE_FLOOR)};
 const FA2_DIST_FLOOR_SQ: f32 = ${wgslF32Literal(FA2_DISTANCE_FLOOR_SQ)};
 const FA2_COINCIDENT_SQ: f32 = ${wgslF32Literal(FA2_COINCIDENT_SQ)};
 const FA2_FLAG_FIRST: u32 = ${FA2_FLAG_FIRST}u;
+const FA2_FLAG_ADAPTIVE: u32 = ${FA2_FLAG_ADAPTIVE}u;
+const FR_COOLING_STEP: f32 = ${wgslF32Literal(FR_COOLING_STEP)};
+const FR_COOLING_PATIENCE: u32 = ${FR_COOLING_PATIENCE}u;
 const F32_MAX: f32 = 0x1.fffffep+127;
 override WG: u32 = ${WORKGROUP_SIZE}u;
 override USE_PERM: bool = false;
@@ -3285,11 +3320,18 @@ export {
   deviceLostError as d,
   MAX_1D_ITEMS as e,
   FA2_FLAG_FIRST as f,
-  PASSTHROUGH_FORMAT_CODES as g,
+  FR_ADAPTIVE_MAX_ITERATIONS as g,
   hasErrorCode as h,
   isWebGpuGraphError as i,
-  STORAGE_ALIGN as j,
-  WORKGROUP_SIZE as k,
-  isSoftwareAdapter as l
+  FR_START_TEMPERATURE as j,
+  FA2_FLAG_ADAPTIVE as k,
+  FR_REHEAT_FRACTION as l,
+  FR_DEFAULTS as m,
+  SE_DEFAULTS as n,
+  SE_SCALE_REFERENCE_NODES as o,
+  PASSTHROUGH_FORMAT_CODES as p,
+  STORAGE_ALIGN as q,
+  WORKGROUP_SIZE as r,
+  isSoftwareAdapter as s
 };
-//# sourceMappingURL=context-CRbw2Wyo.js.map
+//# sourceMappingURL=context-BR7fx3vR.js.map