Yujie Su , Hong Gao , Han Meng , Jinming Wang , Gang Mei
{"title":"RockDisc-Gen: A python software package for rock discontinuity generation","authors":"Yujie Su , Hong Gao , Han Meng , Jinming Wang , Gang Mei","doi":"10.1016/j.softx.2025.102369","DOIUrl":null,"url":null,"abstract":"<div><div>Rock discontinuity generation possesses considerable application value in geotechnical engineering. However, current tools exhibit constraints regarding functionality, usability, and adaptability. Here, we developed a Python software package, <strong>RockDisc-Gen</strong>, for ease-of-use rock discontinuities generation and visualization. RockDisc-Gen incorporates four methods (i.e., the Monte Carlo method, Copula-based method, generative adversarial networks (GANs), and denoising diffusion probability model (DDPM)), for generating synthetic datasets that accurately reflect rock discontinuity orientations and sizes, derived from limited field observation data. The software package can also assess the statistical properties of generated data against the original input data, thus systematically evaluating the generation performance.</div></div>","PeriodicalId":21905,"journal":{"name":"SoftwareX","volume":"32 ","pages":"Article 102369"},"PeriodicalIF":2.4000,"publicationDate":"2025-09-18","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":"0","resultStr":null,"platform":"Semanticscholar","paperid":null,"PeriodicalName":"SoftwareX","FirstCategoryId":"94","ListUrlMain":"https://www.sciencedirect.com/science/article/pii/S2352711025003358","RegionNum":4,"RegionCategory":"计算机科学","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":null,"EPubDate":"","PubModel":"","JCR":"Q2","JCRName":"COMPUTER SCIENCE, SOFTWARE ENGINEERING","Score":null,"Total":0}
引用次数: 0
Abstract
Rock discontinuity generation possesses considerable application value in geotechnical engineering. However, current tools exhibit constraints regarding functionality, usability, and adaptability. Here, we developed a Python software package, RockDisc-Gen, for ease-of-use rock discontinuities generation and visualization. RockDisc-Gen incorporates four methods (i.e., the Monte Carlo method, Copula-based method, generative adversarial networks (GANs), and denoising diffusion probability model (DDPM)), for generating synthetic datasets that accurately reflect rock discontinuity orientations and sizes, derived from limited field observation data. The software package can also assess the statistical properties of generated data against the original input data, thus systematically evaluating the generation performance.
期刊介绍:
SoftwareX aims to acknowledge the impact of software on today''s research practice, and on new scientific discoveries in almost all research domains. SoftwareX also aims to stress the importance of the software developers who are, in part, responsible for this impact. To this end, SoftwareX aims to support publication of research software in such a way that: The software is given a stamp of scientific relevance, and provided with a peer-reviewed recognition of scientific impact; The software developers are given the credits they deserve; The software is citable, allowing traditional metrics of scientific excellence to apply; The academic career paths of software developers are supported rather than hindered; The software is publicly available for inspection, validation, and re-use. Above all, SoftwareX aims to inform researchers about software applications, tools and libraries with a (proven) potential to impact the process of scientific discovery in various domains. The journal is multidisciplinary and accepts submissions from within and across subject domains such as those represented within the broad thematic areas below: Mathematical and Physical Sciences; Environmental Sciences; Medical and Biological Sciences; Humanities, Arts and Social Sciences. Originating from these broad thematic areas, the journal also welcomes submissions of software that works in cross cutting thematic areas, such as citizen science, cybersecurity, digital economy, energy, global resource stewardship, health and wellbeing, etcetera. SoftwareX specifically aims to accept submissions representing domain-independent software that may impact more than one research domain.