Haptography

Saved in this browser

Recording Not connected

Keep grip and contact pressure consistent between takes.

0.0 s

Setup & notes
Connection & sensor details
IMU /s—
Mic /s—
ToF /s—
Wall—
Lost—
Bad—
Dropped—
Board—
IMUMicToF Hammer

    Recordings

    Recording statusReady

    Connect your board or try a simulated recording.

    Sliding speed
    —mm/sWaiting for motion
    Surface coverage

    Name a dataset and surface to track your progress.

    Live signals XYZ

    Vibration
    Connect the board or start the Demo to see it live.
    Rotation
    Sound
    Distance to the wall
    Speed (+ away from the wall)

    Recording quality

    Pick a recording, or record one.
    Dataset —
    No takes in this dataset yet.

    Plug the recording device (the capture build) into this computer's USB and press Connect board: Chrome or Edge on a computer lists its serial port. Demo plays a simulated board instead.

    Name the dataset and the surface, then Record (or press R). Hold the device still for the first 4 s so the gyro's bias can be learned, then slide it toward and away from the wall the distance sensor points at, at different speeds.

    Pick a recording to replay it: Listen plays its sound or vibration here, Play on actuator plays a selected stroke on the TacHammer (and the speakers), and Recreate selection opens it in Recreate.

    Lost counts packets that never arrived, Bad ones that arrived damaged, Dropped ones the board couldn't send. All three should stay at 0.

    Recordings are kept in this browser only. Export writes each take as a session folder (raw.bin, CSVs, mic.wav, info.json and labels.json) in the layout the recording tools on the computer read; Import reads such folders back.

    Export dataset writes every take of the dataset shown, plus dataset.json with its scores. A take you untick under Take details › Use stays here but doesn't count towards its dataset.

    Live shows the last 5 s from the board. Replay shows the selected recording: scroll to zoom, Shift-scroll to pan, click to move the playhead, drag to select a stretch, double-click to fit.

    Vibration is the accelerometer with gravity and hand motion filtered out (above 5 Hz). Listening to it plays its strongest axis at its own pace: the texture as you would feel it, heard.

    Speed comes from the distance sensor alone, uncorrected for tilt; shaded bands are the strokes found in it (blue away from the wall, red toward it).

    Spectrogram draws the vibration (to 835 Hz; the accelerometer rolls off above ~400 Hz) and the sound (to 8 kHz, log scale) as frequency over time. Spectrum shows their power spectra. Compare surfaces overlays every surface of the dataset.

    Each take scores out of 100: the serial link (15), the IMU's samples (10), the microphone (10), good distance readings (20), 4 s still at the start (10), strokes found (15), the texture signal (10: the strokes' vibration at least 10 dB over the quiet between them) and IMU headroom (10).

    Each surface in a dataset scores on its usable takes (scoring 60 or more and ticked Use): their mean score scaled by having 3 of them (40), 24 strokes (30) and 3 strokes in each mean-speed band (30).

    Common haptic waveforms. Click one to play it: on the computer's speakers when Speakers (top right) is on, and on the board's TacHammer when one is connected and Actuator is ticked.

    Star the ones you like; Export favorites writes library.json (each waveform's parameters) and a 16 kHz .wav of each drive, the same samples the board plays.

    From recordings lists the versions you saved in Recreate. Every drive stays inside the actuator's tested limits (70% peak, 7000-count RMS over 100 ms), so long buzzes play quieter than single clicks.

    Select a stroke in Record and press Recreate selection: its vibration becomes a TacHammer drive here. Listen plays the drive on the speakers; Play & measure plays it on the board (simulated in Demo) and records what the actuator did.

    Without a measured Actuator response the drive is just the recording's shape, scaled. Measure one, and the drive is shaped to make the actuator move like the recording; Refine corrects it from each measurement.

    Save to library keeps the drive, its settings and any measurement.