VMTKBIFURCATIONSECTIONS(1)

💖 NAME 💖

okay so bestie, welcome to vmtkbifurcationsections — literally the manual page for the vmtk script vmtkbifurcationsections, and yes the whole thing is a User Commands situation, we're in section 1, no cap 🎀

✨ DESCRIPTION ✨

okay so picture this: automatic piping… vmtkbifurcationsections… parsing options… vmtkbifurcationsections. that's the whole opener, we move ✨

vmtkbifurcationsections : it computes branch sections that are located a fixed number of spheres away from each bifurcation. and the tea is: the script takes in, as input, the surface AND the relative centerlines — both of them already split into branches. no un-split business allowed, we're being specific here 🦋

🌸 Input arguments 🌸

• -id Id (str,1); default=0 — the script id, the little name tag of the script 💅
• -handle Self (self,1) — a handle to self, like holding your own hand but make it code 🫶
• -disabled Disabled (bool,1); default=0 — set it and execution AND piping get disabled, we're sitting this one out 😴
• -i Surface (vtkPolyData,1) — the input surface, already split into branches (saying it again bc it matters)
• -ifile SurfaceInputFileName (str,1) — filename for the default Surface reader 📂
• -centerlines Centerlines (vtkPolyData,1) — the input centerlines, also already split into branches
• -centerlinesfile CenterlinesInputFileName (str,1) — filename for the default Centerlines reader 📂
• -distancespheres NumberOfDistanceSpheres (int,1); default=1 — how far from the bifurcation we take the sections; the distance is expressed in number of inscribed spheres, where each sphere touches the center of the previous one. so like a lil chain of spheres holding hands and each one's touching the center of the one before 💀
• -radiusarray RadiusArrayName (str,1); default=MaximumInscribedSphereRadius — the name of the array where the centerline radius is stored
• -groupidsarray GroupIdsArrayName (str,1); default=GroupIds — the name of the array where the centerline group ids are stored
• -centerlineidsarray CenterlineIdsArrayName (str,1); default=CenterlineIds — the name of the array where the centerline ids are stored
• -tractidsarray TractIdsArrayName (str,1); default=TractIds — the name of the array where the centerline tract ids are stored
• -blankingarray BlankingArrayName (str,1); default=Blanking — the name of the array where the centerline blanking information about branches is stored
• -bifurcationsectiongroupids BifurcationSectionGroupIdsArrayName (str,1); default=BifurcationSectionGroupIds — the name of the array where the group id each section belongs to has to be stored
• -bifurcationsectionbifurcationgroupids BifurcationSectionBifurcationGroupIdsArrayName (str,1); default=BifurcationSectionBifurcationGroupIds — the name of the array where the bifurcation group id each section belongs to has to be stored
• -bifurcationsectionpoint BifurcationSectionPointArrayName (str,1); default=BifurcationSectionPoint — the name of the array where the point at which bifurcation sections are defined has to be stored
• -bifurcationsectionnormal BifurcationSectionNormalArrayName (str,1); default=BifurcationSectionNormal — the name of the array where the bifurcation section normals have to be stored
• -bifurcationsectionarea BifurcationSectionAreaArrayName (str,1); default=BifurcationSectionArea — the name of the array where the area of bifurcation sections has to be stored
• -bifurcationsectionminsize BifurcationSectionMinSizeArrayName (str,1); default=BifurcationSectionMinSize — the name of the array where the minimum diameter of each section has to be stored
• -bifurcationsectionmaxsize BifurcationSectionMaxSizeArrayName (str,1); default=BifurcationSectionMaxSize — the name of the array where the maximum diameter of each bifurcation section has to be stored
• -bifurcationsectionshape BifurcationSectionShapeArrayName (str,1); default=BifurcationSectionShape — the name of the array where the shape index of each bifurcation section has to be stored, i.e. the ratio between minimum and maximum diameter 👑
• -bifurcationsectionclosed BifurcationSectionClosedArrayName (str,1); default=BifurcationSectionClosed — the name of the array containing 1 if a section is closed and 0 otherwise
• -bifurcationsectionorientation BifurcationSectionOrientationArrayName (str,1); default=BifurcationSectionOrientation — the name of the array containing 0 if a section is upstream and 0 downstream its bifurcation (yes bestie, the original says 0 twice, we report the facts, not our feelings 🙈)
• -bifurcationsectiondistancespheres BifurcationSectionDistanceSpheresArrayName (str,1); default=BifurcationSectionDistanceSpheres — the name of the array containing the number of spheres away from the bifurcation that the section is located at
• -sectionpointgroupid OutputSectionPointGroupId (int,1) >= 0; default=None — no default, so don't just leave it vibing
• -sectionpointbifurcationgroupid OutputSectionPointBifurcationGroupId (int,1) >= 0; default=None — same energy, None until you say otherwise
• -ofile BifurcationSectionsOutputFileName (str,1) — filename for the default BifurcationSections writer 📝

💅 Output arguments 💅

• -id Id (str,1); default=0 — script id, hello again bestie 💖 (yes it shows up on both lists, that's just how the page reads)
• -handle Self (self,1) — handle to self, encore 🫶
• -o BifurcationSections (vtkPolyData,1) — the output sections, the actual ✨goods✨
• -bifurcationsectiongroupids BifurcationSectionGroupIdsArrayName (str,1); default=BifurcationSectionGroupIds — the name of the array where the group id each section belongs to are stored
• -bifurcationsectionbifurcationgroupids BifurcationSectionBifurcationGroupIdsArrayName (str,1); default=BifurcationSectionBifurcationGroupIds — the name of the array where the bifurcation group id each section belongs to has to be stored
• -bifurcationsectionpoint BifurcationSectionPointArrayName (str,1); default=BifurcationSectionPoint — the name of the array where the point at which bifurcation sections are defined are stored
• -bifurcationsectionnormal BifurcationSectionNormalArrayName (str,1); default=BifurcationSectionNormal — the name of the array where bifurcation section normals are stored
• -bifurcationsectionarea BifurcationSectionAreaArrayName (str,1); default=BifurcationSectionArea — the name of the array where the area of bifurcation sections are stored
• -bifurcationsectionminsize BifurcationSectionMinSizeArrayName (str,1); default=BifurcationSectionMinSize — the name of the array where the minimum diameter of each section are stored
• -bifurcationsectionmaxsize BifurcationSectionMaxSizeArrayName (str,1); default=BifurcationSectionMaxSize — the name of the array where the minimum diameter of each bifurcation section has to be stored ⚠️ (no i'm not fixing it, the page literally says minimum here, i just report 🔥)
• -bifurcationsectionshape BifurcationSectionShapeArrayName (str,1); default=BifurcationSectionShape — the name of the array where the shape index of each bifurcation section are stored, i.e. the ratio between minimum and maximum diameter
• -bifurcationsectionclosed BifurcationSectionClosedArrayName (str,1); default=BifurcationSectionClosed — the name of the array containing 1 if a section is closed and 0 otherwise
• -bifurcationsectionorientation BifurcationSectionOrientationArrayName (str,1); default=BifurcationSectionOrientation — the name of the array containing 0 if a section is upstream and 0 downstream its bifurcation (again with the double 0, iconic)
• -bifurcationsectiondistancespheres BifurcationSectionDistanceSpheresArrayName (str,1); default=BifurcationSectionDistanceSpheres — the name of the array containing the number of spheres away from the bifurcation the section is located at
• -sectionpoint OutputSectionPoint (float,3); default=[] — an empty list until you fill it, the potential is real ⭐
• -sectionnormal OutputSectionNormal (float,3); default=[] — also starting from nothing, we love a blank slate 🌈
• -sectionarea OutputSectionArea (float,1); default=0.0 — zero point zero, we begin 🎀

and that's the whole page bestie, no details left behind, every flag accounted for, we ate 💅✨

oh and before i go — the whole vibe check: this is vmtkbifurcationsections version 1.5, dated April 2026, and that's the official sign-off right there. mwah 🫶💖