Appearance
Volume meshes and coordinates
O-grid volume meshes
sh
furca volume vessel.furca -o lumen.vtu --theta-res 48 --layers 12 --growth 1.15text
O-grid of vessel.furca
nodes 118767
hexahedra 113568
min scaled Jacobian 0.804writes 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.
| Option | Default | Meaning |
|---|---|---|
--theta-res | 48 | Nodes around each section (a multiple of 8). |
--tau-res | square cells at the wall | Sections along the vessel. |
--layers | 10 | Cell layers between the central block and the wall. |
--growth | 1.15 | Thickness ratio of consecutive layers from the wall inwards; 1 is uniform. |
--core | 0.7 | Size of the central block relative to the smallest wall radius. |
--nodes | auto | How 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 FILE | All 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 arraystau, 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