One desktop application in which an fNIRS or hybrid EEG–fNIRS montage is designed or imported, turned into a printable cap for a given head, and exported as STL panels and Aurora-ready probe files, as one folder that says how it was made.
Version 0.0.6, a tester build for Linux and Windows. The companion to NIRWizard, for the cap the optodes sit in.
Each stage says what it holds. Change one and every stage after it is marked stale, so the panels you print always match the montage you see.
Sources and detectors on the 10-5 reference points or placed free anywhere on the scalp, in a top view with the same montage on the 3D head beside it. The channels follow.
The grommet type and rotation of each site, markers, anchors and rigid springs. They are saved with the montage, not in a sidecar.
The head circumference from 50 to 65.5 cm, the print bed and the cap profile: joints, seam hold, bore, ring height and strut width.
The engine runs inside the app and draws the cap on the head as it goes. Every grommet and every joint gets a status.
The flat panels on the print bed at one scale, and the cap draped on the head. See what will print before it prints.
One folder: the panels as STL, the probe files Aurora loads, the electrode positions of a hybrid cap, and a record of how the cap was made.
On the Montage stage, a flat editor and a third role. On Head and size, every value of the engine.
A patch designed in millimetres from nodes, springs, anchors and dummies, the way AtlasViewer’s SDgui works, and registered onto the scalp. An AtlasViewer .SD opens as one.
A third role beside the optodes, for a hybrid cap. An electrode gets a ring holder and goes through the engine like an optode. The export writes BIDS electrodes.tsv beside the fNIRS files.
Every physical value of the engine is a key of one YAML text, with the default beside it and errors on their line. Head and size edits seven of those keys; the Tuner reaches the rest.
The montage exported as a figure, as SVG or PNG, with a transparent variant. Numbered by optode or by channel, with the legend counted.
Sensorimotor 16 × 16 with 16 EEG electrodes, numbered by optode.
Anderson-HD: 25 sources, 58 detectors, 206 channels.
The same hybrid montage, numbered by channel.
It opens every montage source NIRWizard's Montage Creator reads: .nirwmontage , templates , SNIRF , AtlasViewer .SD . The Montage Creator is NIRWizard's own, brought across with its tests.
The slides I use to present WizardHat: why a printed cap, the six stages with one high-density montage, and its export opened file by file. About 15 minutes.
Click the slides, then use the arrow keys. Shows WizardHat 0.0.6.
The 10-minute versionThe cap is flattened into panels, printed, and joined into a lattice with a holder at every optode. It is the ninjaCap method of von Lühmann et al. (Neurophotonics, 2024), made by AdeptCap: my independent reimplementation, with snap-together panels and local generation.
The cap and the probe files are written together, on one head, and they name the same optodes, numbers and channels. A different head size changes the panels and nothing else.
<folder>/
cap.yaml holds values, not a reference to a profile, and says who set each one: the engine’s default, the cap profile, or your choice in the app. If a default changes next year, the file still says what this cap was made with.
The cap names the montage and the design head it was made from by their SHA-256 hashes, and the engine by name and version. Anyone can check them with sha256sum, without WizardHat.
The montage is designed on the design head, the ICBM 2009c symmetric average, and the cap is generated on the same head, scaled to the cap’s size. A grommet lies where its optode lies in the probe files.
Before the recording: the montage and the cap.
Version 0.0.6 is a tester build, free to use. Everything runs on your machine: an installer carries the cap engine and the design head.
Printed a cap with it, or hit a problem? Write to me.
Checksums, older versions and release notes are on the release archive.
x86_64. The cap engine and the design head are included.
$ chmod +x WizardHat_0.0.6_amd64.AppImage $ sudo apt install ./WizardHat_0.0.6_amd64.deb $ sudo dnf install ./WizardHat-0.0.6-1.x86_64.rpm Windows 10 and 11, x64. The cap engine and the design head are included. SmartScreen warns about the unsigned installer: choose More info, then Run anyway.