VMTKSURFACECONNECTIVITY(1)

💖 VMTKSURFACECONNECTIVITY 💖

okay so bestie, listen — this one lives in the User Commands manual (section 1, the classic, iykyk) and it's genuinely one of those little scripts that just works. no cap. 💅

---

🌸 NAME 🌸

vmtksurfaceconnectivity — vmtk script vmtksurfaceconnectivity ✨

---

🦋 DESCRIPTION 🦋

Automatic piping vmtksurfaceconnectivity Parsing options vmtksurfaceconnectivity

vmtksurfaceconnectivity : extract the largest connected region, the closest point-connected region, the scalar-connected region from a surface, or all connected regions of a surface tagged with an id

like… the way it just goes in, figures out which chunks of your surface are actually connected, and hands you back the one you asked for? iconic. it's giving "i sorted your mesh into friend groups and you get to pick your fave." 🫶

---

🫶 Input arguments 🫶

these are the ones you feed in, babe. the <italic> bits are placeholders, the (type,size) in parentheses is what it actually wants, and default= is what happens if you just… don't. no judgement. 🙈

• -id — Id (str,1); default=0: script id
• -handle — Self (self,1): handle to self
• -disabled — Disabled (bool,1); default=0: disable execution and piping
• -i — Surface (vtkPolyData,1): the input surface
• -ifile — SurfaceInputFileName (str,1): filename for the default Surface reader
• -method — Method (str,1) in ['largest', 'closest', 'all']; default=largest: connectivity method
• -closestpoint — ClosestPoint (float,3); default=None: coordinates of the closest point
• -r — ReferenceSurface (vtkPolyData,1): the reference surface, whose barycenter will be used as closest point for the connectivity filter
• -rfile — ReferenceSurfaceInputFileName (str,1): filename for the default ReferenceSurface reader
• -cleanoutput — CleanOutput (bool,1); default=0: clean the unused points in the output
• -groupidsarray — GroupIdsArrayName (str,1); default=GroupIds: name of the array containing the connectivity scalar
• -groupid — GroupId (int,1); default=-1: value of the connectivity scalar
• -ofile — SurfaceOutputFileName (str,1): filename for the default Surface writer

---

👑 Output arguments 👑

and here's what it hands back to you when it's done. clean. tidy. slay. 💖

• -id — Id (str,1); default=0: script id
• -handle — Self (self,1): handle to self
• -o — Surface (vtkPolyData,1): the output surface

---

fr fr though — read your -method values carefully before you pipe anything, bestie. largest, closest, and all are three very different vibes and this script will absolutely do exactly what you told it to. 💀

okay that's the whole page!! vmtksurfaceconnectivity 1.5, April 2026 🎀 ily, go extract something gorgeous, and remember: your meshes deserve main character energy 🌈⭐💜