← 返回 Skills 市场
wu-uk

dc-power-flow

作者 wu-uk · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ 安全检测通过
114
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install grid-dispatch-operator-dc-power-flow
功能描述
DC power flow analysis for power systems. Use when computing power flows using DC approximation, building susceptance matrices, calculating line flows and lo...
使用说明 (SKILL.md)

DC Power Flow

DC power flow is a linearized approximation of AC power flow, suitable for economic dispatch and contingency analysis.

DC Approximations

  1. Lossless lines - Ignore resistance (R ≈ 0)
  2. Flat voltage - All bus voltages = 1.0 pu
  3. Small angles - sin(θ) ≈ θ, cos(θ) ≈ 1

Result: Power flow depends only on bus angles (θ) and line reactances (X).

Bus Number Mapping

Power system bus numbers may not be contiguous (e.g., case300 has non-sequential bus IDs). Always create a mapping from bus numbers to 0-indexed array positions:

# Create mapping: bus_number -> 0-indexed position
bus_num_to_idx = {int(buses[i, 0]): i for i in range(n_bus)}

# Use mapping for branch endpoints
f = bus_num_to_idx[int(br[0])]  # NOT br[0] - 1
t = bus_num_to_idx[int(br[1])]

Susceptance Matrix (B)

Build from branch reactances using bus number mapping:

# Run: scripts/build_b_matrix.py
# Or inline:
bus_num_to_idx = {int(buses[i, 0]): i for i in range(n_bus)}
B = np.zeros((n_bus, n_bus))

for br in branches:
    f = bus_num_to_idx[int(br[0])]  # Map bus number to index
    t = bus_num_to_idx[int(br[1])]
    x = br[3]  # Reactance
    if x != 0:
        b = 1.0 / x
        B[f, f] += b
        B[t, t] += b
        B[f, t] -= b
        B[t, f] -= b

Power Balance Equation

At each bus: Pg - Pd = B[i, :] @ θ

Where:

  • Pg = generation at bus (pu)
  • Pd = load at bus (pu)
  • θ = vector of bus angles (radians)

Slack Bus

One bus must have θ = 0 as reference. Find slack bus (type=3):

slack_idx = None
for i in range(n_bus):
    if buses[i, 1] == 3:
        slack_idx = i
        break
constraints.append(theta[slack_idx] == 0)

Line Flow Calculation

Flow on branch from bus f to bus t (use bus number mapping):

f = bus_num_to_idx[int(br[0])]
t = bus_num_to_idx[int(br[1])]
b = 1.0 / br[3]  # Susceptance = 1/X
flow_pu = b * (theta[f] - theta[t])
flow_MW = flow_pu * baseMVA

Line Loading Percentage

loading_pct = abs(flow_MW) / rating_MW * 100

Where rating_MW = branch[5] (RATE_A column).

Branch Susceptances for Constraints

Store susceptances when building constraints:

branch_susceptances = []
for br in branches:
    x = br[3]
    b = 1.0 / x if x != 0 else 0
    branch_susceptances.append(b)

Line Flow Limits (for OPF)

Enforce thermal limits as linear constraints:

# |flow| \x3C= rating  →  -rating \x3C= flow \x3C= rating
flow = b * (theta[f] - theta[t]) * baseMVA
constraints.append(flow \x3C= rate)
constraints.append(flow >= -rate)
安全使用建议
This skill appears coherent for DC power flow calculations. Before running: ensure you have Python and numpy available, validate that your input network JSON contains numeric fields in the expected MATPOWER-like layout (from_bus, to_bus, r, x, b, rateA, ...), and run the script on trusted input (it reads and prints local JSON data). The package does not attempt network access or request credentials, but because there's no install manifest you should run it in an environment you control (e.g., a virtualenv or container) if you have standard operational safety policies.
功能分析
Type: OpenClaw Skill Name: grid-dispatch-operator-dc-power-flow Version: 0.1.0 The skill bundle provides legitimate tools and instructions for DC power flow analysis in power systems. The Python script (scripts/build_b_matrix.py) and the agent instructions (SKILL.md) correctly implement standard electrical engineering calculations using numpy, with no evidence of malicious intent, data exfiltration, or unauthorized execution.
能力评估
Purpose & Capability
The SKILL.md and the included scripts are focused on DC power flow analysis, building B matrices, computing line flows, and related constraints. Required inputs (branch and bus arrays, baseMVA) match the described functionality. There are no extraneous credentials, binaries, or config paths requested that would be unrelated to power-flow analysis.
Instruction Scope
Runtime instructions stay within the stated domain: map bus numbers, build the susceptance matrix, compute power balance and line flows, and enforce limits. The SKILL.md directs running scripts/build_b_matrix.py on a local network JSON file and does not instruct reading unrelated files, environment variables, or contacting external endpoints.
Install Mechanism
This is instruction-only (no install spec). The shipped Python script uses numpy and assumes a Python runtime; the skill does not declare these dependencies. This is not a security concern, but users must ensure an appropriate Python+numpy environment is available before running the script.
Credentials
The skill requires no environment variables, secrets, or config paths. All inputs are explicit function arguments or a local JSON file. There are no requests for unrelated credentials or sensitive system access.
Persistence & Privilege
The skill does not request persistent installation, does not set always:true, and does not modify other skills or system-wide settings. It is user-invocable and can run when invoked, which is appropriate for its purpose.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install grid-dispatch-operator-dc-power-flow
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /grid-dispatch-operator-dc-power-flow 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.0
Bulk publish from all-task-skills-dedup
元数据
Slug grid-dispatch-operator-dc-power-flow
版本 0.1.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

dc-power-flow 是什么?

DC power flow analysis for power systems. Use when computing power flows using DC approximation, building susceptance matrices, calculating line flows and lo... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 114 次。

如何安装 dc-power-flow?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install grid-dispatch-operator-dc-power-flow」即可一键安装,无需额外配置。

dc-power-flow 是免费的吗?

是的,dc-power-flow 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

dc-power-flow 支持哪些平台?

dc-power-flow 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 dc-power-flow?

由 wu-uk(@wu-uk)开发并维护,当前版本 v0.1.0。

💬 留言讨论