imbajin commented on code in PR #552: URL: https://github.com/apache/hugegraph-doc/pull/552#discussion_r4432846861
########## content/en/docs/quickstart/computing/hugegraph-vermeer.md: ########## @@ -364,7 +377,42 @@ POST http://localhost:6688/tasks/create } ``` -`output.type=local` writes to the executing worker's local filesystem. For containers, mount the output directory if the host needs to read results. +`output.type=local` writes to the executing worker's local filesystem. For containers, mount the output directory if the host needs to read results. + +### 2.4 Submit and Integrate via Hubble + +With Chart-managed native integration, `POST /api/v1.3/vermeer/task` is used to load or reload a graph, not for computation. +It accepts `graphspace`, `graph`, `task_type:"load"`, and optional loading tuning parameters. +Once the graph is loaded, submit the algorithm via the graph-level computation endpoint: + +```bash +curl -b hubble.cookies -X POST \ + 'http://localhost:8088/api/v1.3/graphspaces/DEFAULT/graphs/hugegraph/algorithms/vermeer' \ + -H 'Content-Type: application/json' \ + -d '{"params":{"compute.algorithm":"pagerank","compute.parallel":1,"compute.max_step":10,"pagerank.damping":0.85,"pagerank.diff_threshold":0.00001}}' +``` + +Parameters and example values come from the current Hubble PageRank form: + +| Parameter | Meaning | Example | +|---|---|---| +| `compute.algorithm` | Supported algorithm name | `pagerank` | +| `compute.parallel` | Computation parallelism | `1` | +| `compute.max_step` | Maximum iteration steps | `10` | +| `pagerank.damping` | PageRank damping factor | `0.85` | +| `pagerank.diff_threshold` | Convergence threshold | `0.00001` | + +Current Hubble accepts `pagerank`, `wcc`, `lpa`, `degree`, `closeness_centrality`, `betweenness_centrality`, `triangle_count`, `kcore`, and `sssp`. Review Comment: [P3] Include PersonalPageRank in the current Hubble algorithm list This list and its Chinese counterpart (`content/cn/docs/quickstart/computing/hugegraph-vermeer.md:399`) still omit `ppr`. Merged [🔗 Toolchain #871](https://github.com/apache/hugegraph-toolchain/pull/871) adds it to the [versioned DirectVermeerService allowlist](https://github.com/apache/hugegraph-toolchain/blob/7e2a8769a70de88d11a4456299dfa0058024026c/hugegraph-hubble/hubble-be/src/main/java/org/apache/hugegraph/service/space/DirectVermeerService.java#L168-L174) and exposes PersonalPageRank in the loaded-Vermeer UI. Readers can otherwise infer that this supported algorithm is unavailable. Please add `ppr` to both lists and identify the applicable build when covering older deployments. Checked against [this documentation version](https://github.com/apache/hugegraph-doc/blob/f7261d77e88de277d66fed7402bf7eb4274a1463/content/en/docs/quickstart/computing/hugegraph-vermeer.md#L405). This is a static code/documentation contract check, not a live computation or RC acceptance result. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
