增加注释

mems/examples/ds-powerflow/README.md

@@ -5,7 +5,50 @@
 
 
 ## 2. 拓扑分析
 ## 2. 拓扑分析
 ###  2.1 静态拓扑分析
 ###  2.1 静态拓扑分析
+
+输入:
+1. 电气岛
+2. 属性定义
+3. 资源定义
+
+输出:
+
+- 默认输出下面六列
+<table>
+    <th>source</th>
+    <th>target</th>
+    <th>id</th>
+    <th>type</th>
+    <th>open</th>
+    <th>name</th>
+</table>
+
+- terminal_cn_dev，如果输出的边是该名称，则输出下面四列
+<table>
+    <th>terminal</th>
+    <th>cn</th>
+    <th>dev</th>
+    <th>type</th>
+</table>
+
+- point_terminal_phase： 如果输出的边是该名称，则输出下面三列
+<table>
+    <th>point</th>
+    <th>terminal</th>
+    <th>phase</th>
+</table>
+
 ###  2.2 动态拓扑分析
 ###  2.2 动态拓扑分析
 
 
-## 3. 潮流计算
-###  3.1 潮流计算模型
+输入:
+1. 电气岛
\ No newline at end of file
+2. 属性定义
+3. 资源定义
+
+
+## 3. 输入参数准备
+### 3.1 设备电气参数计算
+### 3.2 潮流已知量输入
+
+## 4. 潮流计算
+###  4.1 潮流计算模型
\ No newline at end of file

mems/examples/ds-powerflow/ds-static-topo/src/lib.rs

@@ -26,13 +26,17 @@ pub unsafe fn run(ptr: i32, len: u32) -> u64 {
         input
         input
     };
     };
     let mut error = None;
     let mut error = None;
+    // 获取island
     let r = get_island_from_plugin_input(&input);
     let r = get_island_from_plugin_input(&input);
     if let Err(s) = &r {
     if let Err(s) = &r {
         error = Some(s.clone());
         error = Some(s.clone());
     }
     }
+
     let output = if error.is_none() {
     let output = if error.is_none() {
+        // 获取电气岛、属性定义、资源定义
         let (island, prop_defs, defines) = r.unwrap();
         let (island, prop_defs, defines) = r.unwrap();
         let mut outgoing = vec![];
         let mut outgoing = vec![];
+        // 获取输出的
         for model_input in &input.model {
         for model_input in &input.model {
             match model_input {
             match model_input {
                 ModelType::Outgoing(edge_name) => {
                 ModelType::Outgoing(edge_name) => {
@@ -58,6 +62,7 @@ pub unsafe fn run(ptr: i32, len: u32) -> u64 {
             is_matched = true;
             is_matched = true;
             create_static_topo(&island, &prop_defs, &defines, &mut csv_bytes, &mut schema);
             create_static_topo(&island, &prop_defs, &defines, &mut csv_bytes, &mut schema);
         }
         }
+        //  根据输出名称来确定形成不同的data frame
         if outgoing.contains(&TERMINAL_DF_NAME.to_string()) {
         if outgoing.contains(&TERMINAL_DF_NAME.to_string()) {
             is_matched = true;
             is_matched = true;
             let mut terminal_csv_str = String::from("terminal,cn,dev,type\n");
             let mut terminal_csv_str = String::from("terminal,cn,dev,type\n");
@@ -94,6 +99,7 @@ pub unsafe fn run(ptr: i32, len: u32) -> u64 {
         // } else {
         // } else {
         //     let _ = file.sync_all();
         //     let _ = file.sync_all();
         // }
         // }
+
         if outgoing.contains(&POINT_DF_NAME.to_string()) {
         if outgoing.contains(&POINT_DF_NAME.to_string()) {
             is_matched = true;
             is_matched = true;
             let mut point_csv_str = String::from("point,terminal,phase\n");
             let mut point_csv_str = String::from("point,terminal,phase\n");