Skip to content

Volume meshes and coordinates ​

O-grid volume meshes ​

sh
furca volume vessel.furca -o lumen.vtu --theta-res 48 --layers 12 --growth 1.15
text
O-grid of vessel.furca
  nodes                118767
  hexahedra            113568
  min scaled Jacobian  0.804

writes a structured hexahedral mesh of the lumen in VTK's .vtu format, readable by ParaView and convertible to the formats of most flow solvers. Nodes carry the arrays tau, phi and relative_radius (0 on the axis, 1 on the wall) and cells a region (0 central block, 1 ring). The construction is described in O-grid volume meshes.

OptionDefaultMeaning
--theta-res48Nodes around each section (a multiple of 8).
--tau-ressquare cells at the wallSections along the vessel.
--layers10Cell layers between the central block and the wall.
--growth1.15Thickness ratio of consecutive layers from the wall inwards; 1 is uniform.
--core0.7Size of the central block relative to the smallest wall radius.
--nodesautoHow the nodes of the sections are placed: algebraic (lines from the central block to the wall, which need sections star-shaped about the block), smoothed (an energy minimized section by section, for sections of any shape) or auto (algebraic unless a section folds). See Sections that are not star-shaped.
--params FILEAll of the above in TOML, plus core_roundness.

Meshes of subjects encoded with the same structure (see Cohorts) and the same o-grid parameters have the same topology: node k is at the same anatomical location in all of them, so flow fields can be compared node by node.

Vessel coordinates of points ​

sh
furca coords vessel.furca points.csv -o vcs.csv            # x,y,z → tau,theta,rho,phi,d
furca coords vessel.furca vcs.csv -o points.csv --inverse  # tau,theta,rho → x,y,z
furca coords vessel.furca other_mesh.vtp -o mapped.vtp     # adds tau/theta/rho/phi/d arrays

tau, theta, rho are the section through the point and its polar coordinates in it; phi and d its wall coordinates: the harmonic angle of the nearest point of the wall in its section and the signed distance to it, negative inside (for an unbranched vessel). CSV input files have three columns and an optional header line. Points beyond the ends of the centerline get τ<0 or τ>1 (see Vessel coordinates).

furca — parametric models of blood vessels.