Skip to content

The .furca document ​

Encodings are stored as JSON. The document is self-describing and versioned:

json
{
  "format": "furca",
  "version": 2,
  "generator": "furca 0.1.0",
  "kind": "tube",
  "encoding": {
    "centerline": {
      "basis": { "kind": "clamped", "degree": 3, "size": 21 },
      "control_points": [[x, y, z], ...]
    },
    "reference": [ux, uy, uz],
    "tilt": [[a, b], ...],
    "frame_samples": 4096,
    "wall": {
      "domain": [-0.01, 1.004],
      "tau_basis":   { "kind": "clamped",  "degree": 3, "size": 38 },
      "theta_basis": { "kind": "periodic", "degree": 3, "size": 16 },
      "radial": [ ... ],
      "tangential": [ ... ]
    }
  },
  "params": { ... },
  "diagnostics": { ... },
  "source": "vessel.vtp"
}
FieldMeaning
encodingThe model. Together with the definitions in the Method chapters it fully determines the surface.
paramsThe encoder parameters used, for reproducibility.
diagnosticsMeasurements taken while encoding: sizes, residuals, timings.
sourceThe input path, as given.

Bases ​

A basis is identified by its kind, degree and size; knots are uniform and implied (see B-splines). The wall domain [τa,τb] is mapped linearly onto the unit interval of tau_basis; it may extend beyond [0,1] onto the straight centerline extensions. theta_basis is the basis in the harmonic angle φ. radial and tangential hold the coefficients of the components ρw and σw of the wall, each stored τ-major: the coefficient of Bi(τ)Pj(φ) is at index inφ+j.

Frame ​

The frame is not stored. It is recomputed deterministically from the centerline, reference and frame_samples with the double reflection method (see Rotation-minimizing frame). tilt holds the coefficients of the section tilt on the centerline basis (Vessel coordinates); it is omitted when the sections are normal to the centerline.

Feature vector ​

furca inspect reports the length of the feature vector: centerline control points (x,y,z interleaved), the reference direction, the section tilt coefficients (a,b interleaved, one pair per centerline control point; absent with frame.sections = "normal"), then the radial and then the tangential wall coefficients. With fixed sizes this is a fixed-length representation suitable for statistics.

Branched vessels ​

A document with "kind": "vessel" holds a branched vessel. Its encoding lists the branches, each a tube encoding as above (tube) with its radius and, where it meets a junction, its start or end: the junction's index and the window of τ over which the branch fades in or out. The junctions give their parent and children (branch indices), their apex and whether the parent continues past them (through). A vessel with saccular lobes lists them in lobes, each with its center, frame (three axes), the degree and coefficients of its spherical harmonics and its radius; the key is left out when there are none. smoothness is the width of the smooth union. What the encoder measured is in vessel_diagnostics: the residual overall and at junctions, the sweeps of the joint fit, and the diagnostics of every branch and lobe.

json
{
  "kind": "vessel",
  "encoding": {
    "branches": [
      { "tube": { "centerline": …, "wall": … }, "radius": 1.002 },
      { "tube": { … }, "radius": 0.507, "start": { "junction": 0, "window": [-0.75, 0.0] } }
    ],
    "junctions": [ { "parent": 0, "children": [1], "apex": [x, y, z], "through": true } ],
    "smoothness": 0.1
  },
  "vessel_diagnostics": { … }
}

An unbranched vessel is written as a tube: it is the same model.

Shape models ​

A document with "kind": "shape_model" holds a statistical shape model: a template vessel (the structure, with the mean shape: its branches, junctions and smoothness as in a vessel document, also for a model of unbranched vessels, which has one branch and no junctions), the mean feature vector (see Branched vessels for its layout), the unit modes, their variances, the total_variance, and the subjects with their scores. See Cohorts: alignment and shape models.

Precision ​

Numbers are written with the shortest representation that reads back to the same f64, and read back exactly: saving and loading a document is lossless.

Compatibility ​

Readers reject documents with a version newer than they support. Additions that do not change the meaning of existing fields do not bump the version. Version 2 replaced the radius function of version 1 (coefficients, over the polar angle) by the radial and tangential components over the harmonic angle; documents of version 1 are not read and are encoded again from their surfaces.

furca — parametric models of blood vessels.