Appearance
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"
}| Field | Meaning |
|---|---|
encoding | The model. Together with the definitions in the Method chapters it fully determines the surface. |
params | The encoder parameters used, for reproducibility. |
diagnostics | Measurements taken while encoding: sizes, residuals, timings. |
source | The 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 tau_basis; it may extend beyond theta_basis is the basis in the harmonic angle radial and tangential hold the coefficients of the components
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 (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 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.