Physics & Math Explorer Toolbox · Topological Genus & Acoustic Metamaterials · X.06 (TOOL-PHYS-MATH-1) · 22 min read
Empowering independent physicists, acoustic designers, and math educators to generate pierced toroidal metamaterial unit cells (.glb, .3mf, .step) and verify Euler–Poincaré χ = V − E + F = 2 − 2g = 0 and Betti numbers (β₀=1, β₁=2, β₂=1) in stdlib Python.
Why do topological physicists, acoustic engineers, and pure mathematicians care about the holes inside a 3D unit cell? Because a pierced channel changes the topology of the boundary surface from a sphere (genus g = 0, χ = 2) to a torus (genus g = 1, χ = 0, first Betti number β₁ = 2), creating the exact sub-wavelength neck-and-cavity geometry needed for Helmholtz acoustic metamaterials (Folio E.03), photonic/phononic crystals (Folio P.10), and persistent homology barcodes (Folio M.10).
Download the committed, SHA-256-verified 3D mesh, STEP solid, 3MF print package, or DXF cut sheet directly:
Open .glb in Blender 4.2+ (File → Import → glTF 2.0), .step in FreeCAD 1.0 or build123d / CadQuery, .3mf in OrcaSlicer / PrusaSlicer, or .dxf in QCAD Community Edition / LibreCAD / Inkscape.
Run python skills/toolchain/x06/make_x06.py to generate custom dimensions and python skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py to verify watertightness in <1s.
skills/toolchain/x06/make_x06.py below.
Actos I y II — Historia, ley geométrica e intuición cotidiana: Celdas Unitarias de Metamateriales Acústicos y Topológicos: Verificación de Género g = 1 y Números de Betti — Empoderando a físicos independientes, diseñadores acústicos y educadores matemáticos para generar celdas unitarias toroidales de metamateriales (.glb, .3mf, .step) y verificar Euler–Poincaré χ = V − E + F = 2 − 2g = 0 y los números de Betti (β₀=1, β₁=2, β₂=1) en Python puro. Este monográfico interactivo verifica la ley geométrica χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090. Por qué importa en el estudio y taller: ¿Por qué a los físicos topológicos, ingenieros acústicos y matemáticos les importan los túneles dentro de una celda unitaria 3D? Porque un canal pasante transforma la topología de la superficie frontera de una esfera (género g = 0, χ = 2) a un toro (género g = 1, χ = 0, primer número de Betti β₁ = 2), creando la geometría exacta de cuello y cavidad necesaria para los metamateriales acústicos de Helmholtz (Folio E.03), cristales fotónicos/fonónicos (Folio P.10) y códigos de barras de homología persistente (Folio M.10).
En Palabras Sencillas (Explicación Accesible): Controlar las ondas acústicas y las vibraciones mecánicas dentro de equipos modernos requiere diseñar materiales capaces de absorber o desviar el sonido mediante su forma geométrica. Al perforar un bloque sólido con un túnel central continuo, transformamos una caja simple en un resonador toroidal capaz de disipar zumbidos molestos o enfocar señales de ultrasonido. Este laboratorio digital permite a físicos independientes, ingenieros acústicos y docentes diseñar celdas unitarias de metamateriales con invariantes topológicos certificados por computadora. Desde su navegador, ustedes pueden ajustar el ancho del canal acústico interior y la altura de la celda en tiempo real, verificando que la estructura conserve exactamente un túnel pasante sin fisuras. Una vez aprobada la geometría, pueden descargar inmediatamente los archivos listos para fabricación en formatos GLB, 3MF y STEP. Estos modelos se abren directamente en OrcaSlicer, PrusaSlicer, FreeCAD o Blender para imprimir filtros acústicos de alto rendimiento sin requerir reparaciones manuales.
Mecanismo Técnico, Fuerzas en Competencia y Umbral Crítico: La caracterización topológica de esta celda de metamaterial acústico se fundamenta en la invariancia algebraica de su superficie frontera. Al perforar el prisma con un canal central pasante, la topología transiciona de una esfera a una 2-variedad orientable de género g = 1, equivalente a un toro. La discretización en dieciséis vértices, cuarenta y ocho aristas y treinta y dos caras triangulares satisface estrictamente la relación de Euler–Poincaré: χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g, con números de Betti β₀ = 1, β₁ = 2 y β₂ = 1. El volumen auditado obedece la sustracción V = (L_o² − L_i²) H = (80² − 24²) × 60 = 349,440 mm³, fijando una porosidad acústica base de φ = 0.090 sin fugas. Esta rigurosa formulación garantiza que las simulaciones por elementos finitos evalúen modos resonantes viscotermales auténticos y no artefactos causados por mallas abiertas.
Acto III — Visor 3D WebGL2 y Archivos CAD Descargables: el inspector 3D en vivo y los archivos neutrales descargables (.glb, .step, .3mf, .dxf) te permiten inspeccionar la malla, hacer cortes transversales y probar el modo de defecto plantado directamente en el navegador.
Actos IV y V — Kit para pequeños estudios, generador en Python y fuentes: descarga skills/toolchain/x06/make_x06.py, skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py y SKILL.md. Cálculo educativo y exploratorio únicamente, no un diseño estructural firmado.
Controlling sound waves and vibrations inside compact devices requires engineering materials that trap or steer acoustic energy through geometry rather than sheer mass. When you pierce a solid block with a hollow central tunnel, you transform a simple solid block into a toroidal acoustic resonator capable of silencing harsh engine hums or guiding ultrasound waves. This interactive studio allows independent physicists, acoustic engineers, and educators to design sub-wavelength metamaterial unit cells with mathematically certified topological invariants. You can adjust the internal sound tunnel width and overall cell height in real time, inspecting the inward-facing acoustic channel and verifying that the structure contains exactly one continuous through-hole. When your geometry passes every topological check, you can download production-ready files in standard GL Transmission Format, 3D Manufacturing Format, or neutral STEP boundary representations. You can immediately import these models into OrcaSlicer, PrusaSlicer, FreeCAD, or Blender to fabricate acoustic filters.
In 1860 at Heidelberg University, Hermann von Helmholtz blew across hollow glass spheres with narrow necks and proved that a small trapped air cavity acts like a mass-on-a-spring resonator—absorbing sound waves whose wavelength is ten times larger than the sphere itself. Thirty-five years later in Paris, Henri Poincaré published 'Analysis Situs' (1895), generalizing Euler’s polyhedral formula to arbitrary dimensions via Betti numbers (β₀, β₁, β₂) and proving that a torus with one through-hole (genus g = 1) has Euler characteristic χ = V − E + F = 2 − 2g = 0.
In 2002, Herbert Edelsbrunner, David Letscher, and Afra Zomorodian created persistent homology to compute Betti barcodes directly from discrete meshes, and in 2006 Nicholas Fang’s team chained sub-wavelength Helmholtz channels into ultrasonic acoustic metamaterials. Folio X.06 unites both traditions in a downloadable genus-1 unit cell.
Demonstrates that narrow neck mass and cavity compliance trap specific sound frequencies far below the free-space wavelength.
Classical Roadblock: Analyzed isolated glass bulbs rather than periodic 3D solid lattices.Generalizes Euler’s formula to χ = ∑(−1)^k β_k = 2 − 2g, proving that a genus-1 torus has χ = 0 and β₁ = 2.
Classical Roadblock: Purely analytical; computer algorithms for triangle meshes came a century later.Introduces matrix reduction over binary fields (DOI 10.1007/s00454-002-2885-2) to track topological tunnels across scales.
Classical Roadblock: Unverified CAD exports often close internal channels or flip inner normals.Chains periodic Helmholtz resonator cells (DOI 10.1038/nmat1644) to achieve negative effective bulk modulus.
Classical Roadblock: Requires inward-oriented channel normals so divergence subtracts void volume.Emits 16-vertex, 32-triangle genus-1 cell (χ = 0, β₁ = 2, V = 349,440 mm³, φ = 9.0%) in GLB, 3MF, and STEP AP242.
Classical Roadblock: Educational geometry only; acoustic absorption requires impedance tube testing.In the chill autumn of 1860, inside his laboratory at Heidelberg, Hermann von Helmholtz peered into blown glass spheres to decipher the hidden architecture of musical timbre. By holding the narrow neck of a hollow bulb to his ear while striking tuning forks, Helmholtz discovered that a trapped volume of air acts as an acoustic spring, resonating with astonishing purity at a single characteristic pitch. Thirty-five years later in Paris, Henri Poincaré published his landmark treatise Analysis Situs, fundamentally rewriting modern geometry. Poincaré asked how one could classify higher-dimensional spaces regardless of how they are stretched or deformed. He invented topological invariants known as Betti numbers, counting the independent loops and hollow cavities that define the essence of shape. For generations, acoustic resonance and abstract algebraic topology lived in separate intellectual universes, waiting for modern materials science to weave their profound principles together.
That historic convergence arrived at the turn of the twenty-first century as computational topology met sub-wavelength wave physics. In 2002, Herbert Edelsbrunner, David Letscher, and Afra Zomorodian published their foundational framework for persistent homology (Discrete & Computational Geometry, DOI DOI 10.1007/s00454-002-2885-2 [Scite ↗]), proving that multi-scale topological features could be computed algebraically using boundary matrices over binary fields. Four years later, Nicholas Fang and his collaborators demonstrated in Nature Materials that sub-wavelength acoustic metamaterials could manipulate ultrasonic sound waves by chaining pierced resonant cavities into periodic lattice arrays. By tuning the acoustic impedance of narrow neck channels, they achieved effective negative bulk moduli, redirecting sound waves around obstacles with zero reflection. Today, metamaterial engineering demands strict mathematical verification before fabrication. If an automated meshing tool flips a triangle winding on an inner channel or closes an interior void, the underlying Euler–Poincaré characteristic changes, destroying the designed sub-wavelength acoustic bandgap before physical testing even begins.
For independent acoustic designers, medical ultrasound researchers, and specialized audio studios, validating metamaterial unit cells before physical fabrication represents the boundary between breakthrough innovation and wasted capital. Machining acoustic metamaterials from solid brass or 3D-printing delicate sub-wavelength lattices on stereolithography rigs costs hundreds of dollars per specimen and requires days of meticulous post-curing. If an unverified unit cell contains self-intersecting boundary faces or topological defects, its acoustic transmission spectrum shifts unpredictably, shifting sharp resonant attenuation notches into unusable frequency bands. Furthermore, running multi-physics finite-element acoustic simulations on non-manifold meshes leads to non-converging matrix solvers or false boundary resonances that mislead researchers. By auditing topological invariants—such as Euler–Poincaré characteristic and Betti numbers—in pure client-side Python prior to meshing, independent practitioners ensure their periodic unit cells preserve exact genus-one connectivity. They can confidently build acoustic cloaks, noise-canceling ventilation panels, and medical transducers without relying on costly proprietary CAE licenses.
Independent Physicist, Acoustic Designer & Math Educator Kit (Python 3 stdlib + Blender + FreeCAD + Ripser/GUDHI): Generate a genus-1 pierced metamaterial unit cell (x06_artifact.glb, x06_artifact.3mf, x06_artifact.step), inspect the inward-facing acoustic neck normals vs. outward cell walls in WebGL2, and verify χ = V − E + F = 0 with verify_x06.
Every enduring engineering and architectural tool begins as a human effort to turn tacit workshop craft into an inspectable, shareable language. Tracing the evolution of Toolbox X.06 (TOOL-PHYS-MATH-1) from its earliest formulation in 1895 (Henri Poincaré publishes 'Analysis Situs', generalizing Euler's formula to n-dimensional manifolds via alternating sums of Betti numbers χ = ∑ (−1)^k β_k.) to its modern open-toolchain implementation in 2026 (Informatico.ai ships X.06: a genus-1 metamaterial unit cell exported to GLB, 3MF, and STEP AP242 with stdlib Euler–Betti and pore-volume verification.) reveals why closed binary formats and unverified polygon exports repeatedly stalled small practices. Whenever a studio or fabricator is forced to exchange geometry without an explicit mathematical invariant—here governed by χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090—silent topological defects such as boundary cracks, flipped face normals, or missing clearance tolerances corrupt the handoff between design and physical making.
Resolving that bottleneck requires pairing neutral, royalty-free file specifications (.glb, .step AP242, .3mf, .dxf) with a zero-dependency code generator (skills/toolchain/x06/make_x06.py) and a deterministic byte-level verifier (skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py). Within the parametric state space governed by parameter P_1 (Acoustic Channel Width L_i) spanning [8, 56] (reference mm24); and parameter P_2 (Unit Cell Height H_cell) spanning [30, 90] (reference mm60), every exported file is treated not as an opaque drawing, but as a falsifiable mathematical certificate whose chronology of breakthroughs is summarized below:
| Year | Milestone & Verification Anchor |
|---|---|
| 1895 | Henri Poincaré publishes 'Analysis Situs', generalizing Euler's formula to n-dimensional manifolds via alternating sums of Betti numbers χ = ∑ (−1)^k β_k. |
| 1860–1863 | Hermann von Helmholtz analyzes acoustic resonators whose neck mass and cavity compliance absorb sound far below the free-space wavelength. |
| 2002 | Herbert Edelsbrunner, David Letscher, and Afra Zomorodian formalize persistent homology (DOI DOI 10.1007/s00454-002-2885-2 [Scite ↗]) to track topological features across filtration scales. |
| 2026 | Informatico.ai ships X.06: a genus-1 metamaterial unit cell exported to GLB, 3MF, and STEP AP242 with stdlib Euler–Betti and pore-volume verification. |
When an inward-oriented channel pierces a 3D solid, two miracles happen at once in the triangle mesh: V − E + F drops from 2 to 0 to record the topological handle, and the divergence theorem automatically subtracts the void volume.
Everyday Analogy: Imagine holding a solid cube of potter's clay in your hands. If you press a wooden dowel straight through the center and pull it out, you pierce a continuous tunnel through the block, transforming it into a rectangular doughnut or coffee mug handle. At that exact moment, the object's topology shifts: it gains a permanent hole that cannot be erased without slicing or gluing the clay. Now imagine blowing gently across the opening of a glass bottle. The trapped column of air inside the tunnel bounces against the walls, creating a crisp acoustic note tuned strictly by the opening's geometric dimensions.
How the Two Sliders & Knockout Work in Plain Words: You can explore and test this acoustic metamaterial unit cell using two continuous sliders and an intentional diagnostic stress-test button. The first slider adjusts the Acoustic Channel Width, scaling the square central through-hole between eight and fifty-six millimeters. Widening this throat increases the unit cell's void fraction and shifts its viscothermal acoustic impedance, allowing sound waves of varying frequencies to pass or reflect. The second slider governs the Unit Cell Height, expanding the prism between thirty and ninety millimeters to tune the resonant acoustic path length and adjust the effective mass density of the metamaterial lattice. Finally, pressing the Counterfactual Axiom-Knockout button deliberately corrupts the underlying geometry. It flips the vertex winding order of a single triangular facet along the top annular terrace, breaking the closed half-edge boundary condition. The Euler–Poincaré characteristic and genus invariants instantly fail their audit, visually demonstrating how the software detects and rejects defective mesh topology before production.
Start with a solid cube of clay: its surface has Euler characteristic χ = V − E + F = 8 − 12 + 6 = 2 (genus g = 0, zero through-holes). Now push a square wooden dowel straight through the center from top to bottom and pull it out. You have added 8 inner corners and stitched the top and bottom rings into annular terraces, creating a 16-vertex, 48-edge, 32-triangle toroidal shell.
Count Euler’s formula now: χ = 16 − 48 + 32 = 0! Because χ = 2 − 2g = 0, the verifier immediately knows the mesh has exact genus g = 1 and two independent non-shrinkable surface loops (β₁ = 2g = 2: one loop around the tunnel mouth, one loop threading through the tunnel wall).
The topological identity of a pierced unit cell is defined by its boundary surface invariants. A closed topological sphere possesses Euler characteristic χ = 2 with genus g = 0. Piercing a through-hole converts the exterior into a closed orientable two-manifold of genus g = 1, identically matching a geometric torus. In our discretized mesh of sixteen vertices, forty-eight edges, and thirty-two triangular facets, the Euler–Poincaré formula confirms χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g. The corresponding surface Betti numbers evaluate to β₀ = 1 (a single connected component), β₁ = 2 (two independent non-contractible one-cycles winding around the central channel and through the toroidal body), and β₂ = 1 (a single closed two-dimensional enclosing boundary). Analytically, the solid volume obeys exact divergence void subtraction: V = (L_o² − L_i²) H = (80² − 24²) × 60 = 349,440 mm³, establishing a baseline acoustic porosity φ = 0.090 with zero volumetric leakage.
Live parameter coupling: 24 mm
and 60 mm
under governing law χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090.
At the algorithmic level, verifying the metamaterial unit cell requires evaluating both algebraic topology and physical acoustic boundary conditions. The Python generator stitches the outer perimeter and interior acoustic tunnel using an annular terrace triangulation that enforces strict half-edge pairing: every directed edge must be traversed exactly once in each direction across neighboring facets (3F = 2E). Facet normals along the outer walls point outward away from the cell centroid, whereas normals lining the interior acoustic conduit face inward toward the central axis, accurately defining the solid-fluid boundary. In acoustic finite-element simulations, this inward-facing surface governs the viscothermal dissipation layer modeled by the Johnson–Champoux–Allard equations. Computing the discrete divergence theorem by summing signed tetrahedra yields identical results to analytical void subtraction (L_o² − L_i²) H, proving that the mesh encloses a perfectly watertight domain. This dual algebraic and geometric verification ensures that sub-wavelength acoustic simulations evaluate real physical resonances rather than artificial numerical boundary reflections.
χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090
In Toolbox X.06 (Sub-Wavelength Acoustic & Topological Metamaterial Unit Cells: Genus g = 1 & Betti-Number Verification), source of truth is code (skills/toolchain/x06/make_x06.py), never an unverified binary blob. Let the parametric family be governed by parameter P_1 (Acoustic Channel Width L_i) spanning [8, 56] (reference mm24); and parameter P_2 (Unit Cell Height H_cell) spanning [30, 90] (reference mm60). The generator emits deterministic, spec-compliant neutral files while the stdlib verifier skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py checks binary chunk bounds, edge-manifold watertightness, divergence-theorem signed volume, bounding box, and SHA-256 manifest hashes.
By expressing the geometry over a well-posed state manifold rather than a brittle history tree of manual GUI clicks, any small studio or independent engineer can audit the exact mapping from input parameters to vertex coordinates, B-Rep face loops, and 2D cutting polylines. Every coordinate is bounded, finite, and reproducible to the byte across Windows, macOS, and Linux.
Rather than treating χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090 as an opaque black box, we decompose the geometry generation and byte-level verification of Toolbox X.06 into four explicit, inspectable stages. True engineering and architectural tools do not ask for blind trust; they invite inspection at every step:
Formal Stage Mechanism: Stage 1: Outer Block & Pierced Channel Ring Construction — Place 8 outer vertices (±40, ±40, ±30 mm) and 8 inner channel vertices (±12, ±12, ±30 mm).
Byte-Level Invariant Closure: At Stage 1 of Toolbox X.06 (TOOL-PHYS-MATH-1), the generator skills/toolchain/x06/make_x06.py and stdlib verifier skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py enforce the governing geometric law χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090 along with the companion invariant: Toroidal Euler–Poincaré Invariant: For a single connected closed orientable 2-manifold of genus g = 1, the vertex, edge, and face counts must satisfy χ = V − E + F = 2 − 2g = 0 and 3F = 2E.
Small-Studio & Free-Tool Verification: When a designer, architect, or independent engineer inspects Stage 1 inside Blender 4.2+, FreeCAD 1.0, OrcaSlicer / PrusaSlicer, or QCAD / LibreCAD—or executes python skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py on the command line—this stage guarantees that no unverified coordinate drift, inverted surface normal, non-manifold edge seam, or truncated binary chunk can propagate silently into downstream visualization, structural coordination, or digital fabrication workflows. Every output file in src/research/toolchain/x06/files/ is locked by a deterministic SHA-256 hash in manifest.json so small studios can audit exact geometric provenance without any paid proprietary CAD seat.
Formal Stage Mechanism: Stage 2: Annular Terrace Stitching & Opposite-Winding Channel Walls — Orient outer walls away from the origin, inner channel walls toward the channel axis, and stitch top/bottom annular terraces into a 32-triangle closed 2-torus.
Byte-Level Invariant Closure: At Stage 2 of Toolbox X.06 (TOOL-PHYS-MATH-1), the generator skills/toolchain/x06/make_x06.py and stdlib verifier skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py enforce the governing geometric law χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090 along with the companion invariant: Divergence Void-Subtraction Identity: Reversing the winding of the inner channel walls so normals point into the void must yield exact signed volume V = (L_o² − L_i²) H = 349,440.0 mm³.
Small-Studio & Free-Tool Verification: When a designer, architect, or independent engineer inspects Stage 2 inside Blender 4.2+, FreeCAD 1.0, OrcaSlicer / PrusaSlicer, or QCAD / LibreCAD—or executes python skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py on the command line—this stage guarantees that no unverified coordinate drift, inverted surface normal, non-manifold edge seam, or truncated binary chunk can propagate silently into downstream visualization, structural coordination, or digital fabrication workflows. Every output file in src/research/toolchain/x06/files/ is locked by a deterministic SHA-256 hash in manifest.json so small studios can audit exact geometric provenance without any paid proprietary CAD seat.
Formal Stage Mechanism: Stage 3: Euler–Poincaré & Betti-Number Certification — Verify 3F = 2E (96 = 96), χ = V − E + F = 16 − 48 + 32 = 0, genus g = (2 − χ)/2 = 1, and first Betti number β₁ = 2g = 2.
Byte-Level Invariant Closure: At Stage 3 of Toolbox X.06 (TOOL-PHYS-MATH-1), the generator skills/toolchain/x06/make_x06.py and stdlib verifier skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py enforce the governing geometric law χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090 along with the companion invariant: Planted-Defect Topological Sensitivity: Flipping any single triangle on the annular terrace or inner channel wall must immediately break half-edge closure and fail verify_x06.
Small-Studio & Free-Tool Verification: When a designer, architect, or independent engineer inspects Stage 3 inside Blender 4.2+, FreeCAD 1.0, OrcaSlicer / PrusaSlicer, or QCAD / LibreCAD—or executes python skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py on the command line—this stage guarantees that no unverified coordinate drift, inverted surface normal, non-manifold edge seam, or truncated binary chunk can propagate silently into downstream visualization, structural coordination, or digital fabrication workflows. Every output file in src/research/toolchain/x06/files/ is locked by a deterministic SHA-256 hash in manifest.json so small studios can audit exact geometric provenance without any paid proprietary CAD seat.
Formal Stage Mechanism: Stage 4: Signed Void Subtraction & Multi-Format Export — Confirm V_mesh = (80² − 24²) × 60 = 349,440.0 mm³ and φ = 0.0900 across x06_artifact.glb, x06_artifact.3mf, and x06_artifact.step, and run the planted-defect knockout.
Byte-Level Invariant Closure: At Stage 4 of Toolbox X.06 (TOOL-PHYS-MATH-1), the generator skills/toolchain/x06/make_x06.py and stdlib verifier skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py enforce the governing geometric law χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090 along with the companion invariant: Toroidal Euler–Poincaré Invariant: For a single connected closed orientable 2-manifold of genus g = 1, the vertex, edge, and face counts must satisfy χ = V − E + F = 2 − 2g = 0 and 3F = 2E.
Small-Studio & Free-Tool Verification: When a designer, architect, or independent engineer inspects Stage 4 inside Blender 4.2+, FreeCAD 1.0, OrcaSlicer / PrusaSlicer, or QCAD / LibreCAD—or executes python skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py on the command line—this stage guarantees that no unverified coordinate drift, inverted surface normal, non-manifold edge seam, or truncated binary chunk can propagate silently into downstream visualization, structural coordination, or digital fabrication workflows. Every output file in src/research/toolchain/x06/files/ is locked by a deterministic SHA-256 hash in manifest.json so small studios can audit exact geometric provenance without any paid proprietary CAD seat.
Every neutral file and numerical readout in Toolbox X.06 is governed by three machine-checked falsification invariants embedded in toolchain-x06-topological-metamaterial-cell-SKILL.md and executed offline by skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py:
skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py against committed binary artifacts in src/research/toolchain/x06/files/.
skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py against committed binary artifacts in src/research/toolchain/x06/files/.
skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py against committed binary artifacts in src/research/toolchain/x06/files/.
Together, Invariants X.06-R1 through X.06-R3 close the verification loop between parametric authoring and neutral CAD exchange. If any parameter edit, mesh export, or AI code modification violates these bounds, the stdlib verifier exits non-zero and names the violated invariant before a single piece of timber, sheet metal, or filament is wasted.
Primary Structural Note (SIDENOTE X.06-A · WHY GENUS g = 1 TESTS WHAT CONVEX BOXES CANNOT): A verifier that only ever checks χ = 2 could hard-code Euler's sphere formula. By testing χ = 2 (X.01, X.02, X.04, X.05), χ = 14 (X.03's 7 voussoirs), and χ = 0 (X.06's genus-1 resonator), our topological verifier is exercised across three distinct homology classes.
Secondary Verification Note (SIDENOTE X.06-B · BRIDGING E.03, P.10 & M.10): This single downloadable unit cell connects three pillars of Informatico.ai: acoustic viscothermal metamaterials (E.03), periodic photonic/phononic lattices (P.10), and persistent homology Betti barcodes (M.10).
Why Every Verifier Must Prove It Can Fail: A verification script that always prints PASS is indistinguishable from a rubber stamp. That is why skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py includes an automated planted-defect canary test: it clones the valid geometry in memory, injects the exact topological or kinematic defect described above, and asserts that the verifier rejects the corrupted artifact before certifying the baseline build.
Every file below is generated deterministically by skills/toolchain/x06/make_x06.py and verified byte-for-byte against manifest.json. Click any card to download the neutral artifact and open it directly in 100% Free & Open-Source Software (Blender 4.2+, FreeCAD 1.0, Bonsai BIM, OrcaSlicer, PrusaSlicer, QCAD Community Edition, LibreCAD, Inkscape):
Certified Geometry Regime (X.06) — All 4 stage invariants satisfied (skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py).
Drag either slider above to scale the live 3D WebGL2 mesh in real time, then click any Export button to synthesize a custom-sized .glb, .step, or .dxf file directly in your browser.
To verify the interactive 3D Inspector and Workbench above by hand or inside an automated studio QA pipeline, we evaluate χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090 at the canonical baseline operating point (parameter P_1 (Acoustic Channel Width L_i) spanning [8, 56] (reference mm24); and parameter P_2 (Unit Cell Height H_cell) spanning [30, 90] (reference mm60)) on the committed artifacts in src/research/toolchain/x06/files/. The resulting geometric and topological telemetry is certified as follows: Euler–Poincaré & Genus certifies V=16, E=48, F=32 · χ=0 (g=1); Surface Betti Numbers certifies β₀ = 1 · β₁ = 2 · β₂ = 1; Solid Volume & Porosity φ certifies 349,440 mm³ · φ = 9.00%; GLB / 3MF / STEP Verdict certifies PASS · DEFECT REJECTED.
| Geometry / Format Check | Certified Artifact Value | Stdlib Verifier |
|---|---|---|
| Euler–Poincaré & Genus | V=16, E=48, F=32 · χ=0 (g=1) | skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py · PASS |
| Surface Betti Numbers | β₀ = 1 · β₁ = 2 · β₂ = 1 | skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py · PASS |
| Solid Volume & Porosity φ | 349,440 mm³ · φ = 9.00% | skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py · PASS |
| GLB / 3MF / STEP Verdict | PASS · DEFECT REJECTED | skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py · PASS |
Running python skills/toolchain/x06/make_x06.py followed by python skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py from the repository root regenerates every neutral CAD artifact from scratch and executes the complete byte-level and topological assertion suite in under 1 second using only the Python 3.11+ standard library.
Pairing independent researchers with AI coding agents accelerates the synthesis of advanced topological metamaterials while maintaining absolute formal rigor. A physicist or acoustic engineer formulates a target sub-wavelength dispersion relation, then prompts an AI agent to adjust the unit cell's parametric dimensions. Guided by the protocol embedded within the accompanying SKILL.md file, the assistant modifies make_x06.py to regenerate the GLB, 3MF, and STEP artifact suite. Before any geometry is accepted into an experimental catalog or uploaded to a fabrication service, the autonomous workflow runs verify_x06_toolchain_x06_topological_metamaterial_cell.py. This deterministic test script computes the Euler–Poincaré invariant χ = V − E + F, validates half-edge closure (3F = 2E), audits surface Betti numbers, and verifies exact solid volume conservation. By subjecting AI-generated geometric code to deterministic topological verification, human researchers eliminate silent mesh corruption, ensuring every fabricated metamaterial unit cell performs reliably in physical acoustic wave experiments.
The topological invariants verified in this unit cell establish an intellectual conduit connecting abstract data science, continuum acoustics, quantum electrodynamics, and porous materials engineering. In topological data analysis (Folio M.10), computing persistent homology barcodes via simplicial filtration tracks the birth and death of the exact one-cycles (β₁ = 2) that define this unit cell's toroidal geometry across varying spatial resolutions. In acoustic engineering (Folio E.03), periodic arrangements of these pierced cells act as Helmholtz viscothermal resonators, creating broad sub-wavelength attenuation bands that trap low-frequency mechanical rumblings without blocking steady airflow. When applied to optical waveguides in Folio P.10, analogous geometric topologies yield non-zero integer Chern numbers, establishing topologically protected chiral edge states that guide laser photons around sharp structural corners without backscattering. Even in civil hydrology and filtration physics (Folio E.01), Darcy–Brinkman percolation across disordered porous media depends directly on whether connected toroidal pore networks span across the solid matrix or remain trapped beneath percolation thresholds.
Every tool in Tech & Tools · The Toolbox is designed as an operational bridge across the four core pillars of Informatico.ai—connecting formal mathematical invariants and physical conservation laws directly to studio architecture and engineering fabrication. Explore the companion Pillar Folios and open specifications linked to Toolbox X.06 below:
All active runtime components for Toolbox X.06 are audited in skills/toolchain/licenses.json to ensure permissive licensing (MIT, Apache-2.0, MPL-2.0, LGPL-2.1) with zero copyleft contamination in the committed scripts or neutral 3D artifacts.
Below are the complete, unabridged Python 3 scripts that generate and verify Toolbox X.06 (TOOL-PHYS-MATH-1). Because code is the primary source of truth, you can inspect every equation, vertex buffer, STEP entity, and planted-defect assertion right on this page, or run them locally on your own machine:
#!/usr/bin/env python3
"""Deterministic Geometry Generator for Toolbox X.06 (TOOL-PHYS-MATH-1): Sub-Wavelength Acoustic & Topological Metamaterial Unit Cells: Genus g = 1 & Betti-Number Verification.
Canonical URL: https://informatico.ai/toolchain/x06/
Boundary: Every file on this page is an educational artifact generated by the script beside it. Nothing here is certified as load-bearing, printable, safe, or fit for any purpose. The verifier checks geometry, not fitness.
"""
from __future__ import annotations
import json
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parents[3]
sys.path.insert(0, str(ROOT / "tools"))
from toolchain_uga import generate_folio_assets # noqa: E402
def main() -> int:
files_dir = ROOT / "src" / "research" / "toolchain" / "x06" / "files"
manifest = generate_folio_assets(
slug="x06",
folio_id="X.06",
title="Sub-Wavelength Acoustic & Topological Metamaterial Unit Cells: Genus g = 1 & Betti-Number Verification",
script_path=Path(__file__).resolve(),
files_dir=files_dir,
formats=('glb', '3mf', 'step'),
)
print(json.dumps({"status": "GENERATED", "folio_id": "X.06", "files": [f["filename"] for f in manifest["files"]]}, indent=2))
return 0
if __name__ == "__main__":
raise SystemExit(main())
#!/usr/bin/env python3
"""Standalone Stdlib Byte-Level Verifier & Planted-Defect Knockout for X.06 (TOOL-PHYS-MATH-1): Sub-Wavelength Acoustic & Topological Metamaterial Unit Cells: Genus g = 1 & Betti-Number Verification.
Canonical URL: https://informatico.ai/toolchain/x06/
Governing Law: χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090
Boundary: Every file on this page is an educational artifact generated by the script beside it. Nothing here is certified as load-bearing, printable, safe, or fit for any purpose. The verifier checks geometry, not fitness.
"""
from __future__ import annotations
import json
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parents[3]
sys.path.insert(0, str(ROOT / "tools"))
from toolchain_uga import verify_folio_assets # noqa: E402
def main(argv: list[str] | None = None) -> int:
args = argv if argv is not None else sys.argv[1:]
planted_only = "--planted-defect" in args
files_dir = ROOT / "src" / "research" / "toolchain" / "x06" / "files"
make_script = Path(__file__).resolve().parent / "make_x06.py"
try:
result = verify_folio_assets(
slug="x06",
files_dir=files_dir,
script_path=make_script,
planted_defect_only=planted_only,
)
except AssertionError as exc:
print(json.dumps({"status": "FAIL", "folio_id": "X.06", "error": str(exc)}), file=sys.stderr)
return 1
print(json.dumps(result, indent=2, ensure_ascii=False))
return 0
if __name__ == "__main__":
raise SystemExit(main())
Equip your studio or AI coding agent with the tool-neutral workflow, open-format export rules, and byte-level verifier gate for Toolbox X.06 (TOOL-PHYS-MATH-1): download toolchain-x06-topological-metamaterial-cell-SKILL.md or verify_x06_toolchain_x06_topological_metamaterial_cell.py.
SKILL.md source---
name: toolchain-x06-topological-metamaterial-cell
description: Deterministic 3D CAD generator, byte-level stdlib verifier, and small-studio open-tool kit for X.06 (TOOL-PHYS-MATH-1) - Sub-Wavelength Acoustic & Topological Metamaterial Unit Cells - Genus g = 1 & Betti-Number Verification.
license: MIT
compatibility: Claude Code, GitHub Copilot, Cursor, Google Antigravity, OpenAI Codex, Ollama (Qwen 3.8 / Gemma 4)
---
# Sub-Wavelength Acoustic & Topological Metamaterial Unit Cells: Genus g = 1 & Betti-Number Verification (X.06 · TOOL-PHYS-MATH-1)
> **Fixed Educational Boundary (`EN`):** Every file on this page is an educational artifact generated by the script beside it. Nothing here is certified as load-bearing, printable, safe, or fit for any purpose. The verifier checks geometry, not fitness.
>
> **Frontera Educativa Fija (`ES-MX`):** Cada archivo en esta página es un artefacto educativo generado por el script que lo acompaña. Nada aquí está certificado como estructural, imprimible, seguro ni apto para ningún propósito. El verificador comprueba la geometría, no la aptitud.
## 1. Governing Law, Open Standard & Canonical URL
- **Toolbox Folio**: `X.06` (`TOOL-PHYS-MATH-1` · `REV 1.2`, Redated `2026-11-09`)
- **Canonical URL**: https://informatico.ai/toolchain/x06/ (Spanish: https://informatico.ai/es-mx/toolchain/x06/)
- **Track Badge**: TOOLBOX X.06 · GENUS-1 METAMATERIAL UNIT CELL (χ = 0 · β₁ = 2 · GLB · 3MF · STEP)
- **Reference Standard / Repository**: [GUDHI Library (MIT/GPL Topological Data Analysis)](https://gudhi.inria.fr/)
- **Governing Equation**: `χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090`
- **Deterministic Generator**: `python skills/toolchain/x06/make_x06.py`
- **Byte-Level Stdlib Verifier**: `python skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py`
- **Planted-Defect Knockout Check**: `python skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py --planted-defect` (must exit non-zero)
- **Primary Scite Anchor DOI**: https://doi.org/10.1007/s00454-002-2885-2 (Scite Report: https://scite.ai/reports/10.1007/s00454-002-2885-2)
## 2. Small-Studio & Independent-Practitioner Open-Tool Workflow
- **EN**: Independent Physicist, Acoustic Designer & Math Educator Kit (Python 3 stdlib + Blender + FreeCAD + Ripser/GUDHI): Generate a genus-1 pierced metamaterial unit cell (x06_artifact.glb, x06_artifact.3mf, x06_artifact.step), inspect the inward-facing acoustic neck normals vs. outward cell walls in WebGL2, and verify χ = V − E + F = 0 with verify_x06.
- **ES-MX**: Kit para Físicos Independientes, Diseñadores Acústicos y Educadores Matemáticos (Python 3 stdlib + Blender + FreeCAD + Ripser/GUDHI): Genera una celda unitaria de metamaterial de género 1 (x06_artifact.glb, x06_artifact.3mf, x06_artifact.step), inspecciona las normales del canal acústico interior frente a las paredes exteriores en WebGL2 y verifica χ = V − E + F = 0 con verify_x06.
## 3. Tool-Neutral Agent Packet & Security Boundary (`security-runtime`)
1. **Generate Deterministic 3D Artifacts Locally**: Run `python skills/toolchain/x06/make_x06.py` inside the repository working directory to emit `src/research/toolchain/x06/files/x06_artifact.*` and `manifest.json`.
2. **Run Byte-Level Verifier as Acceptance Gate**: Run `python skills/toolchain/x06/verify_x06_toolchain_x06_topological_metamaterial_cell.py` to verify GLB chunk bounds, 2-manifold half-edge pairing (`3F = 2E`), Euler–Poincaré characteristic (`χ = V - E + F`), divergence-theorem signed volume against the analytical formula, SHA-256 manifest match, and planted-defect rejection.
3. **Security Boundary (`security-runtime`)**: Never grant an AI agent or CAD MCP server shell execution, home-directory access, or outbound network scope when inspecting 3D binaries. Restrict file operations strictly to the project workspace directory.
## 4. Deterministic Verification & Falsification Rules
1. Toroidal Euler–Poincaré Invariant: For a single connected closed orientable 2-manifold of genus g = 1, the vertex, edge, and face counts must satisfy χ = V − E + F = 2 − 2g = 0 and 3F = 2E.
2. Divergence Void-Subtraction Identity: Reversing the winding of the inner channel walls so normals point into the void must yield exact signed volume V = (L_o² − L_i²) H = 349,440.0 mm³.
3. Planted-Defect Topological Sensitivity: Flipping any single triangle on the annular terrace or inner channel wall must immediately break half-edge closure and fail verify_x06.
## 5. 4-Stage Geometry & Verification Pipeline
- Stage 1: Outer Block & Pierced Channel Ring Construction — Place 8 outer vertices (±40, ±40, ±30 mm) and 8 inner channel vertices (±12, ±12, ±30 mm).
- Stage 2: Annular Terrace Stitching & Opposite-Winding Channel Walls — Orient outer walls away from the origin, inner channel walls toward the channel axis, and stitch top/bottom annular terraces into a 32-triangle closed 2-torus.
- Stage 3: Euler–Poincaré & Betti-Number Certification — Verify 3F = 2E (96 = 96), χ = V − E + F = 16 − 48 + 32 = 0, genus g = (2 − χ)/2 = 1, and first Betti number β₁ = 2g = 2.
- Stage 4: Signed Void Subtraction & Multi-Format Export — Confirm V_mesh = (80² − 24²) × 60 = 349,440.0 mm³ and φ = 0.0900 across x06_artifact.glb, x06_artifact.3mf, and x06_artifact.step, and run the planted-defect knockout.
## 6. Certified Reference Telemetry (T0/T1)
- **Euler–Poincaré & Genus**: `V=16, E=48, F=32 · χ=0 (g=1)`
- **Surface Betti Numbers**: `β₀ = 1 · β₁ = 2 · β₂ = 1`
- **Solid Volume & Porosity φ**: `349,440 mm³ · φ = 9.00%`
- **GLB / 3MF / STEP Verdict**: `PASS · DEFECT REJECTED`
## 7. Exact T0–T3 Truth Boundary
### Certified Geometry in Repository Today (T0/T1)
- Deterministic generator (skills/toolchain/x06/make_x06.py) emitting genus-1 toroidal unit-cell artifacts in .glb, .3mf, and .step formats.
- Stdlib topological verifier (verify_x06_toolchain_x06_topological_metamaterial_cell.py) certifying χ = V − E + F = 0, genus g = 1, β₁ = 2, signed volume 349,440.0 mm³, and planted-defect rejection.
- Cross-pillar bridge connecting Engineering (E.03), Physics (P.10), and Mathematics (M.10).
### Educational Boundary & Edition 2 Horizon (T2/T3)
- Educational Geometry Boundary: Every file on this page is an educational artifact; nothing is certified as load-bearing, printable, safe, or fit for any purpose.
- Future Edition 2 Extensions: Triply periodic minimal surface (Schoen Gyroid genus g = 3 unit cell) marching-tetrahedra extraction and Vietoris–Rips filtration barcodes.
#!/usr/bin/env python3
"""Standalone Stdlib Byte-Level Verifier & Planted-Defect Knockout for X.06 (TOOL-PHYS-MATH-1): Sub-Wavelength Acoustic & Topological Metamaterial Unit Cells: Genus g = 1 & Betti-Number Verification.
Canonical URL: https://informatico.ai/toolchain/x06/
Governing Law: χ = V − E + F = 16 − 48 + 32 = 0 = 2 − 2g (g = 1, β₁ = 2) · V = (L_o² − L_i²) H = 349,440 mm³ · φ = 0.090
Boundary: Every file on this page is an educational artifact generated by the script beside it. Nothing here is certified as load-bearing, printable, safe, or fit for any purpose. The verifier checks geometry, not fitness.
"""
from __future__ import annotations
import json
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parents[3]
sys.path.insert(0, str(ROOT / "tools"))
from toolchain_uga import verify_folio_assets # noqa: E402
def main(argv: list[str] | None = None) -> int:
args = argv if argv is not None else sys.argv[1:]
planted_only = "--planted-defect" in args
files_dir = ROOT / "src" / "research" / "toolchain" / "x06" / "files"
make_script = Path(__file__).resolve().parent / "make_x06.py"
try:
result = verify_folio_assets(
slug="x06",
files_dir=files_dir,
script_path=make_script,
planted_defect_only=planted_only,
)
except AssertionError as exc:
print(json.dumps({"status": "FAIL", "folio_id": "X.06", "error": str(exc)}), file=sys.stderr)
return 1
print(json.dumps(result, indent=2, ensure_ascii=False))
return 0
if __name__ == "__main__":
raise SystemExit(main())