Street View Image-Based Emotional Perception Modeling of Old Residential Communities: An Explainable Framework Integrating Random Forest and SHAP

Understanding how the built environment shapes residents’ emotional perceptions in old residential communities (ORCs) is essential for enhancing livability and supporting people-oriented urban regeneration. This study proposes an explainable analytical framework that integrates community attributes, streetscape indicators, and subjective evaluations. Using random forest (RF) regression combined with Shapley Additive Explanations (SHAP), we conducted an empirical study on ten ORCs in Yangzhou, China. A total of 1240 street view images (SVIs) were processed to extract social attributes, including building age, building scale, and point-of-interest (POI) diversity, as well as visual indicators such as walkability, green view index (GVI), and colorfulness. Six emotional perception scores were obtained from the MIT Place Pulse 2.0 model and further calibrated through questionnaires. The results show that the proposed framework effectively captures the spatial determinants of residents’ perceptions, with the model predictions being highly consistent with survey evaluations. Specifically, GVI and street enclosure are positively associated with perceptions of beauty, safety, and vitality, while building aging and functional monotony intensify negative feelings such as oppression and boredom. Visual diversity (VD) enhances aesthetic and vitality perceptions, whereas facility visual entropy demonstrates a dual role—reinforcing safety but potentially inducing oppressive feelings. By integrating interpretable machine learning with geospatial analysis, this study provides both theoretical and practical insights for micro-scale community renewal, and the framework can be extended to multimodal analyses including soundscapes and behavioral pathways.