Relay Voids — code, geometry, and verification data for "Evaluating inter-floor visibility and visual exposure in stacked atria: a parametric study of relay voids"

Abstract

Analysis code, input geometry, parameters, seeds, results, figure scripts, and verification data for the manuscript "Evaluating inter-floor visibility and visual exposure in stacked atria: a parametric study of relay voids" by Sanghyun Son (School of Architecture, University of Ulsan; manuscript under review). Earlier working title: "Distributing inter-floor visibility and exposure in stacked atria: a design-space exploration of relay voids". What the deposit reproduces. The study measures downward inter-floor visibility and visual exposure in a five-floor building with stacked floor openings (voids) by directional ray casting between upper-floor observer points and lower-floor target cells. A controlled model holds the floor plate, void shapes and areas, and floor heights fixed and varies only void placement, described by drift (d) and adjacent-void overlap (o). The repository reproduces the manuscript's Tables 3-4, Supplementary Tables S1-S4, and Figures 2-13, 15 and 16: the metrics M1-M5 and derived readings (code/engine.py, code/controlled_model/), chain layout generation and the feasibility sweep over the (d, o) grid, the cluster-representative enumeration, the threshold-sensitivity protocol, the floor-pair matrices, floor-gap decomposition, exposure by observer floor, M4 variants and measured-plate check, the figure scripts (code/figures/), the RelayVision Rhino package (relayvision/), 20 verification cases with expected results (tests/), all parameters and seeds (parameters.json), software versions (ENVIRONMENT.md), and Supplementary Video S1 (media/). See README.md for the file-by-file map, run instructions (Python 3.10; numpy, matplotlib, shapely; Rhino 8 for the geometry export and RelayVision) and the update log. Version 1.2.0 (this version). Every metric family is evaluated on one target grid (floor-surface targets 1 m) with observers on a 2 m grid at eye height 1.5 m; M4 samples its observers on a 1 m grid inside the 3 m edge zone, in both the canonical pipeline and the independent reimplementation. The M4 definition is unified (openings only, transparent balustrade), and the floor-pair matrices, floor-gap decomposition, exposure by observer floor, M4 variants and measured-plate check are added. Canonical values used in the manuscript: proposal M1 8,143 m², M2 0.770, M3 246 m², M4 1,335 m²; aligned well 9,954 / 0.632 / 1,170 / 1,413. The exposure family (total exposure 76,477 / 115,034, M5a 0.305 / 0.416, M5b 0.278 / 0.184) is unchanged from v1.0.0; pre-v1.2.0 grid values are kept in results/legacy_grids_v1.1.0.json. Verification: 20/20 test cases pass (tests/run_tests.py). Versions 1.0.1 and 1.1.0 were internal and were not uploaded; the change log is in README.md. How to cite. Son, S. (2026). Relay Voids — code, geometry, and verification data (v1.2.0) [Software]. Zenodo. https://doi.org/10.5281/zenodo.22287866 (this version; concept DOI for all versions: https://doi.org/10.5281/zenodo.22281723). Licensing. Code (code/, relayvision/, tests/) under the MIT License; research data, controlled-model inputs, generated arrangements, results, and figure scripts/outputs under CC BY 4.0. Competition-design materials (geometry/measured_floors_2F-6F.json, rhino_export_raw.json, voids_engine_frame.json, walkthrough_scene.json, real_stacked_2F-6F.json, media/Video_S1_walkthrough.gif): design by Sanghyun Son (University of Ulsan; design principal) with HAENGLIM ARCHITECTS & ENGINEERS CO., LTD.; reproduced with permission for reproducing the published analysis only; all other rights reserved; further reuse requires permission (see README, Rights and permissions). Contact: Sanghyun Son, sanghyun.son@ulsan.ac.kr. Funding: University of Ulsan (2026-0283).