Method Names in Jupyter Notebooks: An Exploratory Study

Fuente: arXiv
Saved in:
Bibliographic Details
Main Authors: Wong, Carol, Larsen, Gunnar, Huang, Rocky, Sharif, Bonita, Peruma, Anthony
Format: Preprint
Published: 2025
Subjects:
Online Access:
Tags: Add Tag
No Tags, Be the first to tag this record!
_version_ 1866915265635155968
author Wong, Carol
Larsen, Gunnar
Huang, Rocky
Sharif, Bonita
Peruma, Anthony
author_facet Wong, Carol
Larsen, Gunnar
Huang, Rocky
Sharif, Bonita
Peruma, Anthony
contents Method names play an important role in communicating the purpose and behavior of their functionality. Research has shown that high-quality names significantly improve code comprehension and the overall maintainability of software. However, these studies primarily focus on naming practices in traditional software development. There is limited research on naming patterns in Jupyter Notebooks, a popular environment for scientific computing and data analysis. In this exploratory study, we analyze the naming practices found in 691 methods across 384 Jupyter Notebooks, focusing on three key aspects: naming style conventions, grammatical composition, and the use of abbreviations and acronyms. Our findings reveal distinct characteristics of notebook method names, including a preference for conciseness and deviations from traditional naming patterns. We identified 68 unique grammatical patterns, with only 55.57% of methods beginning with a verb. Further analysis revealed that half of the methods with return statements do not start with a verb. We also found that 30.39% of method names contain abbreviations or acronyms, representing mathematical or statistical terms and image processing concepts, among others. We envision our findings contributing to developing specialized tools and techniques for evaluating and recommending high-quality names in scientific code and creating educational resources tailored to the notebook development community.
format Preprint
id arxiv_https___arxiv_org_abs_2504_20330
institution arXiv
publishDate 2025
record_format arxiv
spellingShingle Method Names in Jupyter Notebooks: An Exploratory Study
Wong, Carol
Larsen, Gunnar
Huang, Rocky
Sharif, Bonita
Peruma, Anthony
Software Engineering
Method names play an important role in communicating the purpose and behavior of their functionality. Research has shown that high-quality names significantly improve code comprehension and the overall maintainability of software. However, these studies primarily focus on naming practices in traditional software development. There is limited research on naming patterns in Jupyter Notebooks, a popular environment for scientific computing and data analysis. In this exploratory study, we analyze the naming practices found in 691 methods across 384 Jupyter Notebooks, focusing on three key aspects: naming style conventions, grammatical composition, and the use of abbreviations and acronyms. Our findings reveal distinct characteristics of notebook method names, including a preference for conciseness and deviations from traditional naming patterns. We identified 68 unique grammatical patterns, with only 55.57% of methods beginning with a verb. Further analysis revealed that half of the methods with return statements do not start with a verb. We also found that 30.39% of method names contain abbreviations or acronyms, representing mathematical or statistical terms and image processing concepts, among others. We envision our findings contributing to developing specialized tools and techniques for evaluating and recommending high-quality names in scientific code and creating educational resources tailored to the notebook development community.
title Method Names in Jupyter Notebooks: An Exploratory Study
topic Software Engineering
url https://arxiv.org/abs/2504.20330