Skip to content

Quick start ​

Encode a vessel ​

sh
furca encode vessel.vtp

This writes vessel.furca next to the input and prints a report:

text
Encoded vessel.vtp

Geometry
  wall vertices          23018
  caps                   none
  length                 12.210
  mean radius            0.525
  inlet / outlet radius  0.571 / 0.462

Model
  centerline             21 control points, centered in 2 iterations
  wall                   38 × 16 coefficients, 589.9 effective dof
  parameters             671

Wall residual
  mean                   0.0001  (0.02% of mean radius)
  ...

The input can be open (two boundary loops) or closed. Closed surfaces are opened by removing the caps: from a CapID cell array, from the flat faces of a ModelFaceID cell array (as SimVascular writes them) or by detecting planar regions.

Look at the result ​

sh
furca reconstruct vessel.furca -o vessel.encoded.vtp
furca centerline  vessel.furca -o vessel.centerline.vtp
furca evaluate    vessel.furca vessel.vtp --write-distances vessel.error.vtp

reconstruct triangulates the encoded surface at any resolution. centerline exports the centerline with the arrays tau and mean_radius. evaluate measures the distance between the encoding and a mesh, and can write the per-vertex error for visualization in ParaView.

Try it without data ​

sh
furca synth --list
furca synth stenosis -o stenosis.vtp
furca encode stenosis.vtp --reconstruct stenosis.encoded.vtp

Use it from scripts ​

Every command accepts --json and then prints a single JSON object to standard output:

sh
furca encode vessel.vtp --json | jq '.diagnostics.residual'

furca — parametric models of blood vessels.