import type { ExpressionOrValue, ExpressionSource } from '@cloudpss/expression'; import type { ConditionExpression, ArgumentValue } from '@cloudpss/expression/definitions'; import type { ModelImplement } from './index.js'; export declare const PowerFlowNodeModelType: readonly ["bus", "pv-node", "pq-node", "slack-node", "static-load", "shunt-cs", "dc-bus", "dc-load"]; /** 实现类型枚举 */ export type PowerFlowNodeModelType = (typeof PowerFlowNodeModelType)[number]; export declare const PowerFlowBranchModelType: readonly ["short-circuit-line", "transmission-line", "transformer-2w", "vsc", "lcc-dc-2t", "dc-line"]; /** 实现类型枚举 */ export type PowerFlowBranchModelType = (typeof PowerFlowBranchModelType)[number]; export declare const PowerFlowDcModelType: readonly ["dc-bus", "dc-load", "lcc-dc-2t", "vsc", "dc-line"]; /** 实现类型枚举 */ export type PowerFlowDcModelType = (typeof PowerFlowDcModelType)[number]; /** 实现类型枚举 */ export declare const PowerFlowModelType: readonly ["bus", "pv-node", "pq-node", "slack-node", "static-load", "shunt-cs", "dc-bus", "dc-load", "short-circuit-line", "transmission-line", "transformer-2w", "vsc", "lcc-dc-2t", "dc-line"]; /** 实现类型枚举 */ export type PowerFlowModelType = (typeof PowerFlowModelType)[number]; /** 潮流类型映射 */ export type PowerFlowModelMap = { bus: PowerFlowBusModel; 'pv-node': PowerFlowPvNodeModel; 'pq-node': PowerFlowPqNodeModel; 'slack-node': PowerFlowSlackNodeModel; 'static-load': PowerFlowLoadModel; 'shunt-cs': PowerFlowShuntCsModel; 'dc-bus': PowerFlowDcBusModel; 'dc-load': PowerFlowDcLoadModel; 'short-circuit-line': PowerFlowShortCircuitLineModel; 'transmission-line': PowerFlowTransmissionLineModel; 'transformer-2w': PowerFlowTransformer2wModel; vsc: PowerFlowVscModel; 'lcc-dc-2t': PowerFlowLccDc2tModel; 'dc-line': PowerFlowDcLineModel; }; /** 潮流模型 */ export interface PowerFlowModelBase { /** 唯一键 */ key: string; /** 名称 */ name: string; /** 描述 */ description: string; /** 模型类型 */ type: PowerFlowModelType; /** 条件 */ condition?: ConditionExpression; /** 绑定引脚 */ pins: string[]; } /** 潮流节点模型 */ export interface PowerFlowNodeModel extends PowerFlowModelBase { /** @inheritdoc */ type: PowerFlowNodeModelType; /** @inheritdoc */ pins: [string]; } /** 交流母线模型 */ export interface PowerFlowBusModel extends PowerFlowNodeModel { /** @inheritdoc */ type: 'bus'; /** 初始电压(kV) */ vmi: ExpressionOrValue; /** 初始相角(deg) */ vai: ExpressionOrValue; /** 电压基值(kV) */ vBase: ExpressionOrValue; /** 频率(Hz) */ f: ExpressionOrValue; } /** PV 节点模型 */ export interface PowerFlowPvNodeModel extends PowerFlowNodeModel { /** @inheritdoc */ type: 'pv-node'; /** 注入有功(MW) */ pg: ExpressionOrValue; /** 节点电压(kV) */ vm: ExpressionOrValue; /** 无功下界(MVar) */ qMin: ExpressionOrValue; /** 无功上界(MVar) */ qMax: ExpressionOrValue; } /** PQ 节点模型 */ export interface PowerFlowPqNodeModel extends PowerFlowNodeModel { /** @inheritdoc */ type: 'pq-node'; /** 注入有功(MW) */ pg: ExpressionOrValue; /** 注入无功(MVar) */ qg: ExpressionOrValue; /** 电压下界(kV) */ vMin: ExpressionOrValue; /** 电压上界(kV) */ vMax: ExpressionOrValue; } /** 平衡节点模型 */ export interface PowerFlowSlackNodeModel extends PowerFlowNodeModel { /** @inheritdoc */ type: 'slack-node'; /** 节点电压(kV) */ vm: ExpressionOrValue; /** 节点相角(deg) */ va: ExpressionOrValue; /** 无功下界(MVar) */ qMin: ExpressionOrValue; /** 无功上界(MVar) */ qMax: ExpressionOrValue; } /** 负荷模型 */ export interface PowerFlowLoadModel extends PowerFlowNodeModel { /** @inheritdoc */ type: 'static-load'; /** 消耗有功(MW) */ pl: ExpressionOrValue; /** 消耗无功(MVar) */ ql: ExpressionOrValue; } /** 对地导纳模型 */ export interface PowerFlowShuntCsModel extends PowerFlowNodeModel { /** @inheritdoc */ type: 'shunt-cs'; /** 对地电导(S) */ gl: ExpressionOrValue; /** 对地电纳(S) */ bl: ExpressionOrValue; } /** 直流母线模型 */ export interface PowerFlowDcBusModel extends PowerFlowNodeModel { /** @inheritdoc */ type: 'dc-bus'; /** 电压基值(kV) */ vBase: ExpressionOrValue; /** 电压上限(p.u.) */ vMax: ExpressionOrValue; /** 电压下限(p.u.) */ vMin: ExpressionOrValue; } /** 直流负荷模型 */ export interface PowerFlowDcLoadModel extends PowerFlowNodeModel { /** @inheritdoc */ type: 'dc-load'; /** 有功功率(MW) */ pl: ExpressionOrValue; } /** 潮流支路模型 */ export interface PowerFlowBranchModel extends PowerFlowModelBase { /** @inheritdoc */ type: PowerFlowBranchModelType; /** @inheritdoc */ pins: [string, string]; } /** 短路线模型 */ export interface PowerFlowShortCircuitLineModel extends PowerFlowBranchModel { /** @inheritdoc */ type: 'short-circuit-line'; } /** 传输线模型 */ export interface PowerFlowTransmissionLineModel extends PowerFlowBranchModel { /** @inheritdoc */ type: 'transmission-line'; /** 线路电阻(Ω) */ rb: ExpressionOrValue; /** 线路电抗(Ω) */ xb: ExpressionOrValue; /** 线路充电电纳(S) */ bb: ExpressionOrValue; /** 线路参数是否已进行过长导线修正 */ corrected: ExpressionOrValue; } /** 变压器模型 */ export interface PowerFlowTransformer2wModel extends PowerFlowBranchModel { /** @inheritdoc */ type: 'transformer-2w'; /** 线路电阻(Ω) */ rb: ExpressionOrValue; /** 线路电抗(Ω) */ xb: ExpressionOrValue; /** 线路充电电纳(S) */ bb: ExpressionOrValue; /** 变比 to/from */ tr: ExpressionOrValue; /** 移相角度 to/from(deg) */ ps: ExpressionOrValue; } /** VSC 换流站模型 */ export interface PowerFlowVscModel extends PowerFlowBranchModel { /** @inheritdoc */ type: 'vsc'; /** 交流侧节点类型 */ acNode: ExpressionOrValue; /** 直流侧节点类型 */ dcNode: ExpressionOrValue; /** 换流站注入交流网络的有功功率(MW)*/ pConv: ExpressionOrValue; /** 换流站注入交流网络的无功功率(MVar)*/ qConv: ExpressionOrValue; /** 交流侧母线控制电压(p.u.)*/ vRef: ExpressionOrValue; /** 变压器电阻(p.u.) */ rtf: ExpressionOrValue; /** 变压器电抗(p.u.) */ xtf: ExpressionOrValue; /** 滤波器电纳(p.u.) */ bf: ExpressionOrValue; /** 换相电阻(p.u.) */ rc: ExpressionOrValue; /** 换相电抗(p.u.) */ xc: ExpressionOrValue; /** 交流侧基准电压(kV) */ vcBase: ExpressionOrValue; /** 交流测电压上限(p.u.) */ vcMax: ExpressionOrValue; /** 交流测电压下限(p.u.) */ vcMin: ExpressionOrValue; /** 换流站电流上限(p.u.) */ iMax: ExpressionOrValue; /** 恒定网损系数(MW) */ lossa: ExpressionOrValue; /** 线性网损系数(kV) */ lossb: ExpressionOrValue; /** 整流器二次损耗系数(Ω) */ losscr: ExpressionOrValue; /** 逆变器二次损耗系数(Ω) */ lossci: ExpressionOrValue; /** 直流电压下垂系数(MW/p.u.) */ droopk: ExpressionOrValue; /** 电压下垂功率设定值(MW) */ pdcSet: ExpressionOrValue; /** 电压下垂电压设定值(p.u.) */ vdcSet: ExpressionOrValue; /** 电压下垂死区范围(p.u.) */ dvdcSet: ExpressionOrValue; /** 容量基值 (MVA) */ sBase: ExpressionOrValue; } /** LCC DC 两端模型 */ export interface PowerFlowLccDc2tModel extends PowerFlowBranchModel { /** @inheritdoc */ type: 'lcc-dc-2t'; /** 送端直流电压(kV) */ vdi: ExpressionOrValue; /** 送端直流功率(MW) */ pdi: ExpressionOrValue; /** 送端给定点燃角(deg) */ alphai0: ExpressionOrValue; /** 送端最小点燃角(deg) */ alphaim: ExpressionOrValue; /** 受端高层直流电压(kV) */ vdjh: ExpressionOrValue; /** 受端高层直流功率(MW) */ pdjh: ExpressionOrValue; /** 受端高层给定息弧角(deg) */ gammajh0: ExpressionOrValue; /** 受端高层最小息弧角(deg) */ gammajhm: ExpressionOrValue; /** 送端换流器个数 */ ni: ExpressionOrValue; /** 送端变压器一次侧额定电压(kV) */ vi1: ExpressionOrValue; /** 送端变压器二次侧额定电压(kV) */ vi2: ExpressionOrValue; /** 送端变压器额定容量(MVA) */ sti: ExpressionOrValue; /** 送端变压器电阻(p.u.) */ rki: ExpressionOrValue; /** 送端变压器电抗(p.u.) */ xki: ExpressionOrValue; /** 送端变压器一次侧电压上限(kV) */ vi1Max: ExpressionOrValue; /** 送端变压器一次侧电压下限(kV) */ vi1Min: ExpressionOrValue; /** 送端变压器一次侧档位总数 */ ksi: ExpressionOrValue; /** 送端无功补偿器容量(MVar) */ qci: ExpressionOrValue; /** 受端高层换流器个数 */ njh: ExpressionOrValue; /** 受端高层变压器一次侧额定电压(kV) */ vjh1: ExpressionOrValue; /** 受端高层变压器二次侧额定电压(kV) */ vjh2: ExpressionOrValue; /** 受端高层变压器额定容量(MVA) */ stjh: ExpressionOrValue; /** 受端高层变压器电阻(p.u.) */ rkjh: ExpressionOrValue; /** 受端高层变压器电抗(p.u.) */ xkjh: ExpressionOrValue; /** 受端高层变压器一次侧电压上限(kV) */ vjh1Max: ExpressionOrValue; /** 受端高层变压器一次侧电压下限(kV) */ vjh1Min: ExpressionOrValue; /** 受端高层变压器一次侧档位总数 */ ksjh: ExpressionOrValue; /** 受端高层无功补偿器容量(MVar) */ qcjh: ExpressionOrValue; /** 直流线路电阻(Ω) */ rl: ExpressionOrValue; } /** 直流传输线模型 */ export interface PowerFlowDcLineModel extends PowerFlowBranchModel { /** @inheritdoc */ type: 'dc-line'; /** 线路电阻(Ω) */ rl: ExpressionOrValue; } /** * 潮流模型 */ export type PowerFlowModel = PowerFlowModelMap[PowerFlowModelType]; /** * 潮流输出回写 */ export interface PowerFlowOutput { /** 写回值 */ value: ExpressionSource; /** 写回参数名 */ to: string; /** 条件 */ condition?: ConditionExpression; } /** * 潮流方式实现 */ export interface PowerFlowImplement extends ModelImplement { /** @inheritdoc */ type: 'powerFlow'; /** 潮流元件建模 */ models: PowerFlowModel[]; /** 潮流结果写回 */ outputs: PowerFlowOutput[]; } //# sourceMappingURL=power-flow.d.ts.map