RePlAce 全局布放置工具使用指南

一、项目目录结构及介绍

RePlAce 是一个全球布放置工具，致力于提高解决方案质量和可布线性验证。其仓库在 GitHub 上托管，采用 BSD-3-Clause 许可证。以下是项目的主要目录结构及其简介：

RePlAce/
├── AUTHORS.md           # 作者信息文件
├── CMakeLists.txt       # CMake 构建配置文件
├── Dockerfile           # Docker 镜像构建文件
├── Jenkinsfile          # Jenkins 持续集成脚本
├── LICENSE               # 许可证文件
├── README.md             # 项目说明文档
├── bench                # 测试基准数据集
├── cmake                # CMake 相关配置
├── doc                  # 文档资料
├── include/replace      # 主要头文件目录
├── jenkins              # Jenkins 相关脚本或配置
├── module               # 模块相关文件
├── ntuplace             # 可能是特定功能或数据处理相关的代码
├── prerequisite        # 依赖项相关信息或脚本
├── src                  # 源码目录
├── test                 # 测试用例和脚本
├── dockerignore         # Docker 忽略文件
├── gitignore            # Git 忽略文件
└── gitmodules           # Git 子模块配置文件

二、项目启动文件介绍

RePlAce 作为 OpenROAD 项目的一部分，推荐在其内部构建和使用。若需独立使用，则需切换到 standalone 分支获取。实际操作中，开发和部署通常基于其提供的 CMake 构建系统。启动流程不直接通过单一“启动文件”进行，而是通过编译后的命令行工具或TCL接口来调用。典型的启动过程涉及配置环境、编译源码、然后通过 OpenROAD 的集成环境或者直接调用生成的可执行文件来进行。

使用 OpenROAD 环境

• 在 OpenROAD 应用内，通过相应的TCL命令 global_placement 进行调用，该命令支持多个参数以控制放置过程。

独立编译与运行（仅做参考）

1. 克隆项目：git clone https://github.com/The-OpenROAD-Project/RePlAce.git
2. 切换到 standalone 分支（如果需要独立版本的话）。
3. 构建：进入项目目录，运行 CMake 和编译命令，如 cmake . 和 make。
4. 运行：编译完成后，使用相应生成的程序或脚本开始布放置任务，具体命令依据你的应用场景和配置而定。

三、项目的配置文件介绍

RePlAce 的配置并非通过传统的单一配置文件进行。它主要通过命令行参数或TCL脚本来定制化设置。在使用过程中，用户需了解并可能调整的配置选项包括目标密度(density)、初始密度惩罚(init_density_penalty)、迭代次数(initial_place_max_iter)等。这些参数可以在调用 global_placement 命令时指定，也可以预先定义在用于驱动RePlAce的TCL脚本中。

例如，一个简化的配置示例可能会涉及以下TCL命令行部分：

set_density 0.70
set_init_density_penalty 8e-5
global_placement -density $density -init_density_penalty $init_density_penalty

项目中虽然没有直接的配置文件，但可以通过脚本进行灵活配置，以适应不同设计需求。对于复杂的放置场景，开发者或用户会创建或修改TCL脚本来提供详细的放置策略和参数设定。

在实际应用中，确保详细阅读 README.md 文件以及相关的TCL命令文档，以获得更精确的操作指导。