Researcher-facing browser interface for study profile, trajectory, timing, SOA, and trial-structure decisions, connected to the local backend via localhost.
- Profile ID
- —
- Source
- —
Calibration reference and safety ceiling. These values describe the playback calibration assumption. Use a measured calibration profile when one is available.
Half-step repetitions add balanced extra trials deterministically across families, rows, SOAs, and source lineage.
| Example | Part | Blocks | Block order |
|---|
Peripersonal space is the multisensory region immediately surrounding the body within which stimuli are processed differently from those beyond arm's reach. It was first characterized by Rizzolatti et al. (1981a, 1981b) in studies of periarcuate neurons, cells in the ventral premotor cortex and putamen that respond to both tactile stimulation of the body surface and nearby external stimuli, and has since been linked to defensive behavior, tool use, and bodily self-awareness.
The standard behavioral measure of human peripersonal space is the audio-tactile interaction task. In Canzoneri et al. (2012), participants respond to tactile stimulation on the body while sounds approach from several distances. Responses become faster as the sound nears the body. That distance-dependent facilitation curve is used to estimate the boundary of peripersonal-space representation. Although the paradigm is widely adopted, complete task parameters are rarely shared and implementations remain difficult to compare across labs.
The papers in this map are a curated cross-section of audio–tactile peripersonal-space research chosen to capture the main experimental paradigms and design variations that inform PPS Toolkit. Some already have Toolkit templates, while others help show the wider range of approaches the Toolkit aims to represent. This is a field overview, not a systematic or exhaustive review of all PPS publications.
Loading publication network…
Circle area increases with incoming citations from other papers in this 94-paper map; a larger circle was cited by more included papers. Node size and position are navigation encodings, not study-quality scores.
In Citation topology, linked papers stay nearer one another while every paper repels its neighbours, producing dense and sparse regions without an artificial perimeter. A paper with no line has no direct within-map citation captured by the dated sources; it may still cite or be cited by work outside this 94-paper set, or by references an index could not match. Select a circle to distinguish its incoming and outgoing citations and inspect the full readiness assessment. Publication year provides a chronological arrangement.
The Peripersonal Space Toolkit is a local-first research platform for designing and running audio-tactile peripersonal space experiments. Researchers can build a study from scratch by specifying trajectory, source material, timing, and tactile onset asynchronies through a graphical interface, or they can load published parameter sets to reproduce the design decisions reported in existing studies. The toolkit does not redistribute the stimuli from those studies, since these are rarely made available by authors, but it makes the decision parameters themselves explicit, version-controlled, and shareable across labs. All stimulus generation, experiment preparation, and data collection run locally on the lab PC through a local Python backend and a native experiment runner; the browser-based dashboard is a configuration interface only and communicates with the local backend at 127.0.0.1.
The toolkit is organized as a layered system in which the browser dashboard collects researcher decisions and passes them to a local Python backend that does all computational work. The browser never generates stimuli or controls timing directly. All rendering, file creation, and experiment execution happen on the lab PC, keeping participant data local and timing-sensitive work entirely out of the browser. The three-channel output design, enabled by the Komplete Audio 6 MK2 ASIO interface, carries left audio, right audio, and the tactile drive signal as a single synchronized stream whose inter-channel timing is governed by one hardware sample clock.
Researcher-facing browser interface for study profile, trajectory, timing, SOA, and trial-structure decisions, connected to the local backend via localhost.
Validates researcher decisions, writes project folders and manifests, and calls render and session preparation routines. Runs entirely on the lab PC and is not accessible externally.
Head-related transfer functions stored in SOFA format provide the binaural reference used to spatialize looming audio along the researcher-defined trajectory.
Open-source C++ spatial audio engine rendering moving binaural sources from the same trajectory decisions passed through the Python backend.
Channels 1 and 2 carry left and right spatial audio. Manifests record trajectory samples, render config, file hashes, and quality-control summaries alongside each WAV.
SOA schedules, block CSVs, and participant block order prepared alongside the WAVs and handed off to the experiment runner.
Native Windows application that opens the prepared session package and plays the three-channel ASIO stream to the lab hardware. Owns all timing-sensitive playback and response recording entirely outside the browser.
ASIO multichannel interface clocking all three output channels from one synchronized sample clock. Operated as a single device rather than separate Windows endpoints.
Binaural left and right auditory streams delivered to the participant. The looming sound approaches along the researcher-defined spatial trajectory.
Wired analog tactile transducer receiving the audio-encoded tactile cue on output 3. The tactile onset is a direct function of the SOA schedule and shares the same hardware clock as the auditory channels.
Spatialized sound is generated before a participant run. A researcher chooses a dry source, such as pink noise or a tone, and defines how that source should move through space: start distance, end distance, azimuth/elevation, duration, and whether the path is looming or receding. The local backend samples that path over time, looks up the matching left-ear and right-ear filters from a SOFA/FABIAN HRTF dataset, and asks the renderer to turn the moving source into a stereo binaural WAV. Channels 1 and 2 carry the headphone signal; tactile cues are added later as a separate channel-3 schedule, so the spatial audio bake stays auditory-only and auditable.
A head-related transfer function is a small acoustic fingerprint for one direction. It describes how the head, torso, and ears reshape a sound before it reaches the left and right eardrums. Applying different HRTFs over time makes a stationary source file behave like it is moving.
SOFA, the Spatially Oriented Format for Acoustics, is the standardized file container that stores spatial acoustic measurements such as HRTFs, HRIRs, and binaural room impulse responses with enough metadata for different tools to read them consistently.
Open SOFA ConventionsFABIAN is TU Berlin's head-and-torso simulator dataset. PPS uses its HRIR/HRTF measurements as the reference listener model when creating binaural looming audio, and credits the source data to Brinkmann.
Open TU DepositOnce Record Open TU Berlin SOFA Files3DTI and its newer BRT line provide the binaural-rendering toolbox layer: software that takes source audio, listener/source geometry, and HRIR data, then computes the left and right headphone signals. In PPS, this renderer layer is local infrastructure, not browser logic or participant data storage.
Open BRT Library Open 3DTI Toolkit PageEach bake writes the binaural WAV, trajectory samples, render configuration, quality-control rows, file hashes, and manifests. Those files make the exact spatialization decisions reviewable before data collection.
Segment 3 adds SOA-driven tactile cues as channel 3 for audio-tactile trial files. The native runner then plays channels 1, 2, and 3 together through one synchronized ASIO device.
Citable sources and toolboxes:
The validated lab route runs on Windows and delivers auditory and tactile stimuli through a single synchronized multichannel ASIO output stream using the Native Instruments Komplete Audio 6 MK2 interface. Channels 1 and 2 route binaural left and right audio to participant headphones while channel 3 drives a Woojer Strap 4 connected as a wired analog load, removing the timing variability introduced by Bluetooth. The tactile signal is not a separate conversion path but a conventional audio waveform written to output 3 and routed into the Woojer's wired analog auxiliary input, whose transducer converts low-frequency signal energy into vibrotactile stimulation. Encoding the tactile cue as an audio channel keeps its onset timing under exactly the same software and hardware control as the auditory channels, making the stimulus onset asynchrony between sound and touch a direct function of the SOA schedule.
Latency was measured using a direct electrical loopback in which the three output channels were patched back into the Komplete Audio 6 MK2's own analog inputs via TRS cables, and a calibration pulse train was played while the return signal was simultaneously recorded. Comparing transmitted and received pulse timing gives the round-trip delay per channel. The physical-minus-digital latency is 33.462 ± 0.013 ms across 20 recovered pulses, representing the time between when the software schedules a sample and when that signal appears at the physical output. All 20 response marker pulses were recovered. The critical finding for audio-tactile research is the inter-channel skew: the left and right audio channels are synchronized to within 0.023 ms of each other, and the tactile drive channel deviates from the audio channels by only 0.011 ms. These sub-millisecond differences are possible because the Komplete Audio 6 MK2, operated through its ASIO driver as a single multichannel device, clocks all three outputs from the same sample clock and renders them within the same output buffer; this result cannot be replicated by routing stimuli through separate Windows stereo endpoints. The full loopback protocol is documented in the latency validation report.
The Experiment Designer is a linear seven-segment workflow in which each segment owns a distinct decision layer and produces its own set of local files and manifests. Beginning with study or profile selection at Segment 0, the researcher progresses through defining auditory ingredients such as looming trajectories and source materials at Segment 1, assembling those into trial sequences at Segment 2, adding tactile timing via SOA schedules with baseline and catch-trial logic at Segment 3, setting repetition counts to build a trial-pool CSV at Segment 4, generating and inspecting block CSVs at Segment 5, and finally preparing participant block orders for handoff to the native runner at Segment 6. This sequential structure ensures every file produced at each stage is traceable to the decisions that generated it, supporting design transparency and replication.
The Experiment Runner is a native Windows application, PPSExperimentRunner.exe, launched from the Segment 6 setup package and entirely separate from the browser dashboard. It is responsible for all timing-sensitive work during data collection, opening the prepared session package, playing the three-channel ASIO stream to the lab hardware, and recording participant responses and event markers. All playback timing is handled natively to avoid the latency variability inherent in browser JavaScript execution. Session output folders contain event CSVs, XDF and marker mirrors for Lab Streaming Layer integrations, trigger dictionaries, timing quality-control reports, and analysis-ready trial rows.
The toolkit can currently recreate six study profiles whose reported parameters pass the Segment 0–4 profile gate and can be materialized for native runner handoff, drawn from the five publications below.
PPS Toolkit is released under the MIT License. Permission is granted to use, copy, modify, merge, publish, distribute, sublicense, and sell copies of the software, provided the copyright notice and permission notice stay with the software. The software is provided as is, without warranty of any kind, including implied warranties of merchantability, fitness for a particular purpose, or noninfringement. The authors and copyright holders are not liable for claims, damages, or other liability arising from use of the toolkit.
The MIT License covers the toolkit code and included project materials. It does not grant rights to redistribute third-party assets, vendor software, or external datasets.
Generated designs, sessions, participant outputs, and validation artifacts stay local under ignored folders such as local_data/ and artifacts/.
Researchers are responsible for validating timing, hardware routing, ethics approvals, and local data-handling procedures before using the toolkit for data collection.
Small GitHub-hosted bootstrapper published through GitHub Releases after a reviewed Windows package build.
Open Installer ReleasesHeavyweight release payload hosted outside GitHub for labs that need the full packaged toolkit bundle.
Open Full Package SearchBrowse source, issues, release notes, and development documentation on GitHub.
Open GitHub RepositoryAfter installing, start the trusted local companion before using hosted dashboard actions.
windows\Start_Website_Companion.bat
Segment 2 combines the ingredients created in Segment 1. Their noise colour changes spectral energy and can change how a looming sequence is perceived.
Power ∝ 1/f²
Strong low-frequency weighting; commonly heard as deep or rumbling. Brown and pink were rated less tense and more pleasant than blue and violet in one controlled comparison.
Power ∝ 1/f
Equal power per octave, with less top-end hiss than white. It often sounds spectrally balanced, but a looming validation rated pink more arousing and less pleasant than white.
Power ∝ f⁰
Equal power per hertz; wider high-frequency octaves therefore contain more total power and produce a broadband hiss. Ferri et al. used it as their neutral looming comparator.
Power ∝ f
High-frequency weighting gives a bright, sharp character. Blue and violet were associated with more perceived tension and movement, and lower pleasantness, than pink and brown.
Power ∝ f²
The strongest high-frequency weighting, usually heard as the sharpest hiss. Violet reached the highest modeled roughness and the greatest perceived movement in the five-noise comparison.