Explorable lattice — interactive 3D viewer

A live, rotatable 3D model of an A=1 lattice state, produced by the dcl-lattice-viewer tool. Parity coloring shows the bipartite RGB/CMY sublattice split that defines the substrate.

A live, explorable A=1 lattice state — drag to rotate, scroll to zoom, right-drag to pan, double-click to reset. It is rendered straight from lattice field data by dcl-lattice-viewer (v0.1.0), the downstream visualization tool for the dcl-core engine.

Loading the lattice model… if nothing appears, your browser may not support WebGL.

What you are looking at

This is a demonstration lattice state — a minimum-uncertainty Gaussian wavepacket synthesised by the viewer’s demo command, not an experiment run. Even so, it is drawn by exactly the rules the tool applies to real dcl-core dumps:

• Position — each cube sits at its lattice coordinate, recenterd on the lattice (15 \times 15 \times 15 here).
• Size — \sqrt{}-scaled by the total token count at the site, so the dense core of the wavepacket reads larger than the tail.
• Color — this model uses parity mode: the RGB (even) sublattice is warm, the CMY (odd) sublattice is cool. The interleaved warm/cool cubes are the bipartite structure on which the whole framework rests — two interpenetrating sublattices related by the tick rule. (The tool also offers phase, a full color wheel keyed to the token-weighted phase, and count, a dark-to-amber ramp.)

Make your own

The viewer turns the .npy / .npz token-and-phase fields that dcl-core experiments write into a .glb (for a <model-viewer> like the one above) and a self-contained interactive three.js .html (orbit, zoom, pan, and — for a time series — scrub through ticks).

# install (base = HTML only; the [glb] extra adds .glb export)
pip install "dcl_lattice_viewer[glb] @ git+https://github.com/JackDMenendez/dcl-lattice-viewer@v0.1.0"

# see output immediately, no engine run required
dcl-lattice-viewer demo -o lattice --color parity        # writes lattice.glb + lattice.html

# render a real experiment dump (a directory of .npy, or an .npz)
dcl-lattice-viewer build data/exp_12_run/ -o figures/exp_12 --format both

A 4D array (T, nx, ny, nz) is read as a tick sequence and animates in the HTML viewer. The base install needs only NumPy; .glb export adds trimesh, and an [engine] extra can build frames straight from a live dcl-core session.

Provenance

• Tool: dcl-lattice-viewer v0.1.0 (MIT). The model above was produced with dcl-lattice-viewer demo -o explorable-lattice --color parity --shape 15 15 15 --units 12000 — a deliberately compact demo (≈1,800 sites) kept as a plain .glb so it loads with no external decoder.
• Engine of record: dcl-core, whose .npy field format the tool consumes.
• Substrate: the bipartite octahedral lattice of Paper I — Geometry First; see also the unit-cell model for the substrate’s geometric primitive.

Accessibility

The model carries a text description in its alt attribute, and a loading message stands in until WebGL initialises. For a high-resolution still or a guided walk-through, see the contact page.