DeepCircuitX: A Comprehensive Repository-Level Dataset for RTL Code Understanding, Generation, and PPA Analysis

Zeju Li 1,6† , Changran Xu 1,6† , Zhengyuan Shi 1,6† , Zedong Peng 2,6 , Yi Liu 1,6 , Yunhao Zhou 1,6 , Lingfeng Zhou 3,6 , Chengyu Ma 4,6 , Jianyuan Zhong 1,6 , Xi Wang 5,6 , Jieru Zhao 2 , Zhufei Chu 4 , Xiaoyan Yang 3 , Qiang Xu 1,6 · 2025

Read DeepCircuitX: A Comprehensive Repository-Level Dataset for RTL Code Understanding, Generation, and PPA Analysis by Zeju Li 1,6† , Changran Xu 1,6† , Zhengyuan Shi 1,6† , Zedong Peng 2,6 , Yi Liu 1,6 , Yunhao Zhou 1,6 , Lingfeng Zhou 3,6 , Chengyu Ma 4,6 , Jianyuan Zhong 1,6 , Xi Wang 5,6 , Jieru Zhao 2 , Zhufei Chu 4 , Xiaoyan Yang 3 , Qiang Xu 1,6 (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2502-18297.txt.

Introduction

Zeju Li and co-authors release DeepCircuitX, a dataset built to teach language models the register-transfer level code that describes computer chips. Older datasets stop at single files or jump straight to physical layouts. This one spans whole repositories down through files, modules, and blocks. It adds step-by-step reasoning notes on function and structure at each level, plus synthesized netlists and power, performance, and area figures.

Models fine-tuned on the dataset improved at understanding, writing, and completing chip code, and at predicting those quality figures early in design. Human judges confirmed the gains. Early prediction matters because chip teams must trade power against speed before any layout exists. The authors present the dataset as core training material for machine learning in hardware design automation.

Catalog record

CREATORZeju Li 1,6† , Changran Xu 1,6† , Zhengyuan Shi 1,6† , Zedong Peng 2,6 , Yi Liu 1,6 , Yunhao Zhou 1,6 , Lingfeng Zhou 3,6 , Chengyu Ma 4,6 , Jianyuan Zhong 1,6 , Xi Wang 5,6 , Jieru Zhao 2 , Zhufei Chu 4 , Xiaoyan Yang 3 , Qiang Xu 1,6
YEAR2025
COLLECTIONPAPERS
FORMATTXT
FILE SIZE36 KB
VERSION1.0
LICENSEhttp://creativecommons.org/licenses/by/4.0/
RIGHTSCC BY
SOURCEarXiv

Source: https://arxiv.org/abs/2502-18297

Browse the full library · About the Tower of Babel

Full text

The opening of the work, from the library's hosted text:

DeepCircuitX: A Comprehensive Repository-Level Dataset for RTL Code Understanding, Generation, and PPA Analysis Zeju Li 1,6† , Changran Xu 1,6† , Zhengyuan Shi 1,6† , Zedong Peng 2,6 , Yi Liu 1,6 , Yunhao Zhou 1,6 , Lingfeng Zhou 3,6 , Chengyu Ma 4,6 , Jianyuan Zhong 1,6 , Xi Wang 5,6 , Jieru Zhao 2 , Zhufei Chu 4 , Xiaoyan Yang 3 , Qiang Xu 1,6 Abstract This paper introduces DeepCircuitX, a comprehensive repository-level dataset designed to advance RTL (Register Transfer Level) code understanding, generation, and power-performance-area (PPA) analysis. Unlike existing datasets that are limited to either file-level RTL code or physical layout data, DeepCircuitX provides a holistic, multilevel resource that spans repository, file, module, and block-level RTL code. This structure enables more nuanced training and evaluation of large language models (LLMs) for RTL-specific tasks. DeepCircuitX is enriched with Chain of Thought (CoT) annotations, offering detailed descriptions of functionality and structure at multiple levels. These annotations enhance its utility for a wide range of tasks, including RTL code understanding, generation, and completion. Additionally, the dataset includes synthesized netlists and PPA metrics, facilitating early-stage design exploration and enabling accurate PPA prediction directly from RTL code. We demonstrate the dataset’s effectiveness on various LLMs finetuned with our dataset and confirm the quality with human evaluations. Our results highlight DeepCircuitX as a critical resource for advancing RTL-focused machine learning applications in hardware design automation. Our data is available at https://zeju.gitbook.io/lcm-team . Fig. 1: Pipeline overview of the proposed framework, illustrating the key stages: data collection from GitHub using keywords, data annotation via chain-of-thought (COT), circuit transformation, and evaluation, including RTL code tasks for LLM and PPA prediction. I Introduction Register Transfer Level (RTL) modeling is a crucial step in the Electronic Design Automation (EDA) flow, where RTL code (e.g., Verilog and VHDL) represents hardware functionality, bridging design specifications and circuit implementations. Engineers then translate RTL into netlists, floorplans, and layouts, directly influencing circuit design quality. Integrating Artificial Intelligence (AI) into the EDA flow, particularly for RTL tasks, promises to enhance modern chip design and accelerate time-to-market. For instance, [ 1 ] employs large language models (LLMs) to understand and describe RTL designs in natural language to assist engineers. [ 2 , 3 ] focus on generating RTL code from the design specification. Clearly, the effectiveness of deep learning models is heavily contingent upon the quality of the training data [ 4 ] . However, we observe that existing RTL datasets suffer from notable limitations, hindering the application of AI-based solutions in practical RTL modeling and verification. One prominent limitation is the narrow scope of most datasets. Since the semiconductor ecosystem is far inferior to software openness, the accessible designs are limited. Many datasets either focus on a limited set of circuit types, often centering around a single design such as processors [ 5 , 6 ] ), or indiscriminately collect all Verilog files without accounting for their correctness and distribution [ 3 , 7 ] . This restricted diversity hampers the generalizability and effectiveness of these datasets. Another critical limitation is the lack of focus on circuit implementation in RTL-based datasets. For instance, RTLLM [ 8 ] gathers RTL specifications and verifies the functional correctness of RTL code, while [ 4 ] ensures functionality when constructing and augmenting datasets. RTL-Repo [ 1 ] collects 1000+ RTL design projects and make each sample in the dataset contains the context of the entire repository to train LLM for RTL code understanding. However, these works do not consider or include circuit-level information, such as netlists and layouts, which are crucial in later stages of the EDA flow. As a result, these datasets overlook the correlation between RTL code and its corresponding circuit implementations. Consequently, training RTL models with the existing datasets that both guarantee functional correctness and optimize Power, Performance, and Area (PPA) remains a significant challenge. To overcome these limitations, we present a multimodal and comprehensive repository-level circuit dataset for deep learning in EDA. Our dataset is meticulously curated according to the scope of the real-world chip and collect more than 4,000 circuit design projects from various data sources. Unlike previous datasets that provide verilog files only [ 4 , 3 ] , each data point in our dataset is structured as a complete repository and also splitted into files, modules and blocks for various scenarios. This multi-tiered structure enables training models at different scales, making it suitable for a variety of LLMs and models. Moreover, the repository-level data allows logic synthesis and physical design flows to convert RTL code into various circuit modalities, including Control/Data Flow Graph (CDFG) of RTL code, And-Invertor Graph (AIG), post-mapping netlist, floorplaning and layout. Therefore, we can build the interactions between RTL designs and circuit implementations. Furthermore, we meticulously label the circuits for unimodal RTL tasks and cross-modal PPA prediction to enhance accessibility of our dataset. We propose a Chain of Thought (CoT) [ 9 ] detailed annotation method to generate descriptions and comments for each of the four levels, namely, repo-level, file-level, module-level and block-level. By using GPT-4 [ 10 ] and Claude [ 11 ] , we leverage annotations from higher levels to assist in annotating lower levels. Additionally, we generate question-answer pairs to help describe the functionality and key features of each code segment, enabling better training data for LLMs. Moreover, we provide the corresponding logic synthesis results for the cross-stage PPA prediction on RTL code. With this dataset, we create a range of pre-training tasks, evaluation tasks, and benchmarks. One experiment focuses on RTL code understanding and generation with LLMs. We trained models including CodeLLama [ 12 ] , CodeT5+ [ 13 ] , CodeGen [ 14 ] , and DeepSeek [ 15 , 16 ] at scales ranging from 220M to 16B parameters on our dataset. Another experiment evaluates PPA using learning-based prediction models [ 17 , 18 , 19 ] , trained to assess area, power, and delay. The results reveal three key findings: 1) Fine-tuning LLMs on our dataset leads to significant performance improvements across all metrics, demonstrating the effectiveness of our dataset. 2) LLMs of different scales, such as CodeT5 220M, 7B, and 16B, show substantial gains after fine-tuning, indicating the adaptability of our dataset across varying model sizes. 3) PPA prediction results highlight the ongoing challenge of accurate early-stage PPA forecasting, providing valuable insights for future RTL and hardware design automation research. And the pipeline and framework are illustrated in Figure 1 . The main contributions of our work are summarized as follows: • We propose a holistic dataset including over 4,000 repository-level RTL projects, covering chip-designs, IP-designs, module-designs designs, and incorporating a diverse range of functional and algorithmic keywords. • Our dataset is organized into four levels, namely, repository, file, module, and block levels, allowing models to be trained at different scales and enabling broader applications in EDA tasks such as synthesis, netlist generation, PPA analysis, and layout design. • We propose a Chain of Thought (CoT) annotation method using GPT-4 and Claude to generate detailed comments, descriptions, and question-answer pairs, improving training data for LLMs on the tasks of RTL code understanding and generation. • We create pre-training and evaluation benchmarks for LLMs on RTL tasks

Read the complete text