10.1 Pre-UCJ节点

用于从 Hartree-Fock 节点生成的 .chk 分子结构文件中读取分子体系信息，并执行 PySCF 的 CCSD (Coupled Cluster Singles and Doubles) 电子相关计算。其主要目标是为后续量子模拟流程准备必要的活性空间和波函数数据。

10.1.1 node.json配置解析

本节点的所有配置说明、测试用例等，均集成于 node.json 文件中，您可以通过该文件来学习和配置您用于输入的计算节点。

{
    "id": "b763cdaa-eab0-4db7-b3b3-ccsd-node-2025",
	"name": {"cn":"Pre-UCJ 节点",
             "en":"Pre-UCJ Node"},
    "version": "1.0.0",
    "input":{
        "upstream":[
            {"var": "scf_obj",  // 变量名 与config.json和main.py一致
             "name": { "cn": "scf对象", // 前端显示名称，可缺省
                       "en": "scf object"},
             "description": "计算对象，来自于pyscf的内部结构，保存了轨道信息"}

        ],
        "web":[
            {"var": "activate_electrons", 
             "name": { "cn": "活跃电子数",
                       "en": "activate electrons"},
             "description": "活跃电子数",
             "ui": "plain_text"},
			{"var": "activate_orbit", 
             "name": { "cn": "激活轨道索引列表,来自前端页面输入",
                       "en": "activate orbit"},
             "description": "激活轨道索引列表,来自前端页面输入",
             "ui": "plain_text"}
        ]
    },
    "output":{
        "downstream":[
            {
                "var": "ccsd_file_path", 
             	"name": { "cn": "ccsd对象",
                       "en": "ccsd object"},
             	"description": "t2振幅, e_tot总能量"
            },
            {
                "var": "ffsim_file_path", 
             	"name": { "cn": "ffsim 对象",
                       "en": "ffsim object"},
             	"description": "分子数据用于后续量子计算"},
        ]

       		
	},
        
 
    "performance_config_path": "/app/Pre-UCJ/performance_config.json",
    "example_config_path": "/app/Pre-UCJ/example/test_config.json",
    "contact": {
        "name": "微观纪元量子化学团队",
        "email": "wuchuixiong@miqroera.com",
    },
    "execution_command": "python /app/Pre-UCJ/script/main.py  --config_path ${input_config_path}" // 必须囊括 ${input_config_path} 变量
}

---

下列表格旨在详细解析MiqroForge系统中节点配置文件的结构与内容。节点配置文件是确保各个计算节点能够正确部署、初始化并高效运行的关键。通过该表格，用户可以清晰地了解每个配置项的意义、数据类型、默认值以及是否为必需项。此外，还将提供一些示例值以帮助理解如何根据实际需要进行配置。

基本信息

字段名	必填	描述	约束/选项	示例值
id	是	节点全局唯一标识符，在初始化节点时自动生成	UUID格式	684bee08-a78d-4b1f-87a8-91910ca81f38
version	是	节点版本号	语义化版本	1.0.0

输入/输出配置 (inputs/outputs)

在图中清晰地展示了Pre-UCJ计算节点的输入输出关系及UI界面配置选项，强调了从分子结构输入到能量计算结果输出的数据处理流程，以及与上下游节点的交互方式。

1. 上游输入：（upstream）

   字段名	必填	描述	约束/选项
   var	是	字段标识	小写蛇形命名
   name	否	数据类型

2. webUI输入 (web)

   字段名	必填	描述	约束/选项
   var	是	字段标识
   name	否	数据类型
   ui	是	前端输入样式

3. 下游输出：（downstream）

   字段名	必填	描述	约束/选项
   var	是	字段标识	小写蛇形命名
   name	否	数据类型

4. webUI输出：（web）

   字段名	必填	描述	约束/选项
   var	是	字段标识
   name	否	数据类型
   ui	是	前端输出样式

性能配置/测试案例

字段名	必填	描述	约束/选项
performance_config	是	性能配置文件路径	绝对路径
example_config_path	是	运行测试输入文件test_config_path	绝对路径
execution_command	是	节点执行命令

联系信息 (contact)

字段名	必填	描述	约束/选项	示例值
name	是	维护者名称	-	"微观纪元量子化学团队"
email	是	联系邮箱	有效邮箱格式	"wuchuixiong@miqroera.com"

10.1.2 config.json 节点测试及配置说明

在 MiqroForge 平台中，每个节点镜像都包含一个标准化的测试配置文件 test_config.json。此文件位于节点的 /app/example/ 目录中，是验证节点功能的关键工具。

在节点的实际运行中，test_config.json或通过MiqroForge生成的${input_config_path}指向的config文件，他们的作用是作为计算时的输入/输出配置文件。用户在编写可执行程序时，需要保证main.py或其他可执行程序从config文件中读取到变量名。这些变量名和node.json中的变量名要保持一致。

测试配置文件示例（Pre-UCJ节点）：

{
    "activate_electrons": "[3,3]",
    "activate_orbit": "[3,4,5,6,7,8,9,10,11]",
    "ccsd_file_path": "/app/Pre-UCJ/example/h2o-ccsd.chk",
    "mol_file_path":"/app/Pre-UCJ/example/h2o-mol.chk" ,
    "ffsim_file_path":"/app/Pre-UCJ/example/h2o-molecule.json"
    
}