A BIM-Embedded Computational Workflow for Spatial Graph Analysis of Architectural Floor Plans

Graph-based spatial analysis methods are widely used to evaluate accessibility, visibility, spatial hierarchy, and movement-related properties of architectural floor plans. However, these analyses are often conducted using standalone tools and separate simplified models, which can delay design feedback and introduce additional data preparation steps. This paper presents a BIM-embedded computational workflow for configuring, computing, and visualising spatial graph analyses within Autodesk Revit using Dynamo, Python scripting, and the Accessibility and Visibility Analysis (AVA) package. The contribution is not the development of new graph algorithms, but the documentation of a reproducible workflow that sequences existing tools, graph construction settings, metric configuration, spatial measure computation, and 2D/3D visual feedback within a modelling environment. The workflow is demonstrated through a two-storey residential case study and supports accessibility, visibility, centrality measures, visual step depth, shortest path, isovist, object visibility, and activity-based origin–destination analysis. Particular attention is given to incorporating vertical circulation connections into level-based accessibility graphs for selected cross-level movement analysis. Building on prior AVA–DepthmapX verification by the authors, the paper focuses on workflow transparency, reproducibility, and multi-level accessibility representation. The findings indicate that BIM-embedded spatial graph analysis can support iterative, performance-informed design evaluation.