Skip to content

Commit d2adea3

Browse files
committed
Add documentation of centerline arrays
1 parent dc8eaeb commit d2adea3

File tree

1 file changed

+22
-1
lines changed

1 file changed

+22
-1
lines changed

documentation/rom_simulation/intro/readme.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ this ROM can be complex enough to provide a good approximatation of circulatory
1717

1818
## Centerlines Geometry
1919

20-
The geometry of the one-dimensional networks used by the **sv1DSolver** is based on the centerlines computed from the surface
20+
The geometry of the vascular networks used by **1D** and **0D** solvers is based on the centerlines computed from the surface
2121
of a 3D geometric model. The 3D geometric model is created from image data using the typical
2222
SimVascular <a href="modeling.html"> modeling workflow</a>.
2323

@@ -35,6 +35,27 @@ The source and target points are selected from the model caps defined in the Sim
3535
</figure>
3636
<br>
3737

38+
The centerline `.vtp` file contains a number of point arrays that contain useful information about the vascular network:
39+
- **BifurcationId**: Junction number in junctions and $-1$ in branches
40+
- **BifurcationIdTmp**: Internal junction number used during branch/junction splitting
41+
- **BranchId**: Branch number in branches and $-1$ in junctions
42+
- **BranchIdTmp**: Internal branch number used during branch/junction splitting
43+
- **CenterlineId**: Contains an $n$-dimensional array for $n$ outlets (and thus $n$ centerlines). Here, each centerline is one inlet-outlet connection. The CenterlineId array is 1 on all points that belong to a centerline and 0 otherwise. A point can belong to several centerlines, e.g., all points on the inlet branch will belong to all centerlines.
44+
- **CenterlineSectionBifurcation**: 1 if a point is inside a junction and 0 otherwise
45+
- **CenterlineSectionNormal**: Normal vector to centerline sections, obtained from the tangent vector to the centerline
46+
- **GlobalNodeId**: Sequential numbering of centerline points
47+
- **Path**: Starts from zero in every branch and contains the path length along the centerline
48+
49+
Arrays inherited from [vmtkcenterlinesections](https://www.vmtk.org/vmtkscripts/vmtkcenterlinesections.html):
50+
- **CenterlineSectionArea**: Cross-sectional area of the vessel. Obtained from slicing the vessel at each centerline perpendicular to the centerline path.
51+
- **CenterlineSectionClosed**: 1 if a section is closed and 0 otherwise
52+
- **CenterlineSectionMaxSize**: Maximum diameter of each section
53+
- **CenterlineSectionMinSize**: Minimum diameter of each section
54+
- **CenterlineSectionShape**: Shape index, i.e. the ratio between minimum and maximum diameter
55+
56+
Array inherited from [vmtkcenterlines](https://www.vmtk.org/vmtkscripts/vmtkcenterlines.html):
57+
- **MaximumInscribedSphereRadius**: Radius values of maximal inscribed spheres
58+
3859
### Network Geometry and 1D Simulation Mesh
3960

4061
The centerlines geometry is used to define network **nodes** at vessel inlets, outlets and branching points. A number of cylindrical

0 commit comments

Comments
 (0)