Abstract:Software comprehension is becoming increasingly time-consuming due to the continual growth in the size of codebases. Consequently, it is becoming more critical to speed up the code comprehension process to aid in software maintenance and lower the associated costs. A crucial aspect of this process is understanding and preserving the high quality of the code dependency structure. While a variety of code structure models already exist, there is a surprising scarcity of models that closely represent the source code and focus on software comprehension. As a result, there are no readily available and easy-to-use tools to assist with dependency comprehension, refactoring, and quality monitoring of code. To address this gap, we introduce the Semantic Code Graph (SCG), an information model that offers a detailed abstract representation of code dependencies with a close link to the source code. We establish the critical properties of the SCG model and demonstrate its implementation for Java and Scala languages. To validate the SCG model's usefulness in software comprehension, we compare it to nine other source code representation models. Additionally, we select 11 well-known and widely-used open-source projects developed in Java and Scala and perform a range of software comprehension activities on them using three different code representation models: the proposed SCG, the Call Graph, and the Class Collaboration Network. We then qualitatively analyze the results to compare the performance of these models in terms of software comprehension capabilities. These activities encompass project structure comprehension, identifying critical project entities, interactive visualization of code dependencies, and uncovering code similarities through software mining. Our findings demonstrate that the SCG enhances software comprehension capabilities compared to the prevailing Class Collaboration Network and Call Graph models. Moreover, the SCG-based data analysis yields actionable software comprehension insights. We also release an open-source tool, scg-cli, to assist with result reproduction and further research. We believe that the work described is a step towards the next generation of tools that streamline code dependency comprehension and management.

Facilitating Scenario-Based Program Comprehension with Topic Models

Measuring Program Comprehension: A Large-Scale Field Study with Professionals

[Journal First] Measuring Program Comprehension: A Large-Scale Field Study with Professionals

TASK CONTEXT: A Tool for Predicting Code Context Models for Software Development Tasks

A Smart Context-Aware Program Assistant Based on Dynamic Programming Event Modeling

An objective-oriented approach to program comprehension using multiple information sources

PLANT: A Pattern Language for Transforming Scenarios into Requirements Models.

SBTM: A Joint Sentiment and Behaviour Topic Model for Online Course Discussion Forums

Topic-Oriented Spoken Dialogue Summarization for Customer Service with Saliency-Aware Topic Modeling

Assessing Semantic Frames to Support Program Comprehension Activities

Source Code Comprehension: A Contemporary Definition and Conceptual Model for Empirical Investigation

Multi-turn dialogue comprehension from a topic-aware perspective

Semantic Code Graph—An Information Model to Facilitate Software Comprehension

Obtaining Functional Topics from Source Code Based on Topic Modeling and Static Analysis

Theories, tools and research methods in program comprehension: past, present and future

Semantic Code Graph -- an information model to facilitate software comprehension

A Tale of Two Comprehensions? Analyzing Student Programmer Attention during Code Summarization

Toward Summary Extraction Method for Functional Topic

Scenario-based modeling and its applications

Knowing-how & Knowing-that: A New Task for Machine Comprehension of User Manuals

Web Application Comprehension Based on Dependence Analysis