@enervance/insight-cim-model 0.0.276 → 0.0.278

package/dist/analysis/powerflow/powerflow.util.d.ts

@@ -0,0 +1,213 @@
+import { ModelContainer } from '../../model-container/model/ModelContainer.js';
+import { IConnectivityNode } from '../../interfaces/model/core/IConnectivityNode.js';
+import { IConductingEquipment } from '../../interfaces/model/core/IConductingEquipment.js';
+import { IIdentifiedObject } from '../../interfaces/model/core/IIdentifiedObject.js';
+import { INTEGRALEquivalentInjection } from '../../model/extensions/integral/equivalents/INTEGRALEquivalentInjection.js';
+import { INTEGRALSynchronousMachine } from '../../model/extensions/integral/wires/INTEGRALSynchronousMachine.js';
+import { INTEGRALEnergySource } from '../../model/extensions/integral/wires/INTEGRALEnergySource.js';
+export declare class PowerflowUtil {
+    private static scalingFactor;
+    private static scalingFactorRn;
+    static synchronousMachineUUIDs: string[];
+    /**
+     * Ermittelt alle elektrischverbundene Elemente eines Netzes
+     * @param modelContainer das Netz als CIM Modell
+     * */
+    static getInterconnectedGrids(modelContainer: ModelContainer, withSwitchSates?: boolean): Array<IInterconnectedGridResult>;
+    private static breadthFirstSearch;
+    /**
+     * bestimmt den nächsten unbesuchten Knoten für die Breitensuche.
+     * @param connectivityNodes alle ConnectivityNodes eines Netzmodells
+     * @param visitedUUIDs UUIDs aller abgearbeiteten Elemente
+     * */
+    private static getNextNode;
+    /** Prüft, ob das Netz rechenfähig ist. */
+    static isGridComputable(network: IIdentifiedObject[]): boolean;
+    /** Prüft, ob im Teilnetz eine Slacks/Generators vorhanden sind */
+    static isGeneratorsExists(network: IIdentifiedObject[]): boolean;
+    /** Prüft, ob im Teilnetz eine Slacks/Generators vorhanden sind */
+    static isBranchExists(network: IIdentifiedObject[]): boolean;
+    static isEnergySourcesConsumersExists(network: IIdentifiedObject[]): boolean;
+    static convertCIM2PandaPowerNetwork(network: IIdentifiedObject[], nodeType: 'ConnectivityNode' | 'TopologicalNode', pandaDataFrame: IPandaPowerDataFrame, defaultsConfig: IPFDefaults): void;
+    static fromJsonPandaDataFrame(pandaDataFrameJSON: string): IPandaPowerDataFrame;
+    /** Serialize PandaDataFrame to JSON */
+    static toJsonPandaDataFrame(pandasDataFrame: any): void;
+    static getBaseVoltageAsNumber(node: IIdentifiedObject): number;
+    private static createPandaPowerTypeFromValues;
+    private static createStdTypeTrafo2WFromValues;
+    private static createStdTypeTrafo3WFromValues;
+    /** Normiert Bemessungsspannung (Ur) zu Nennspannung (Un)
+     * +/- 7%
+     * z.B. Ur=115 => Un=110 */
+    private static getNominalVoltage;
+    private static addSwitch;
+    /** Junctions werden als Bus-Bus Switch abgebildet
+     *  et="b", type="CB" */
+    private static addJunctionSwitch;
+}
+export declare function getKrInfo(tpLoadsNfeeders: Map<string, Map<string, IIdentifiedObject[]>>): {
+    krSum: number;
+    elementWithHighestKr: INTEGRALEquivalentInjection | INTEGRALSynchronousMachine | INTEGRALEnergySource;
+    wardsWithKrOnly: Array<INTEGRALEquivalentInjection>;
+    wardsWithTargetVoltageOnly: Array<INTEGRALEquivalentInjection>;
+    wardsWithTargetVoltageKr: Array<INTEGRALEquivalentInjection>;
+    gensWithKrOnly: Array<INTEGRALSynchronousMachine>;
+    gensWithTargetVoltageOnly: Array<INTEGRALSynchronousMachine>;
+    gensWithTargetVoltageKr: Array<INTEGRALSynchronousMachine>;
+    sgensWithKrOnly: Array<INTEGRALEnergySource>;
+};
+export interface IInterconnectedGridResult {
+    interconnectedGridElements: Array<IConnectivityNode | IConductingEquipment>;
+    computabe: boolean;
+    interconnectedGridCounter: number;
+}
+export interface PandaPowerObjectDataFrame {
+    _object: {
+        columns: any;
+        data: any[];
+        index: any[];
+    };
+}
+export interface IPandaPowerDataFrame {
+    version: string;
+    format_version: string;
+    converged: boolean;
+    name: string;
+    f_hz: number;
+    sn_mva: number;
+    _object: IPandaPowerDataFrameObject;
+    distributed_slack: boolean;
+}
+export interface IPandaPowerDataFrameObject {
+    bus: IPandaPowerObject;
+    load: IPandaPowerObject;
+    sgen: IPandaPowerObject;
+    motor: IPandaPowerObject;
+    asymmetric_load: IPandaPowerObject;
+    asymmetric_sgen: IPandaPowerObject;
+    storage: IPandaPowerObject;
+    gen: IPandaPowerObject;
+    switch: IPandaPowerObject;
+    shunt: IPandaPowerObject;
+    svc: IPandaPowerObject;
+    ssc: IPandaPowerObject;
+    ext_grid: IPandaPowerObject;
+    line: IPandaPowerObject;
+    trafo: IPandaPowerObject;
+    trafo3w: IPandaPowerObject;
+    impedance: IPandaPowerObject;
+    tcsc: IPandaPowerObject;
+    dcline: IPandaPowerObject;
+    ward: IPandaPowerObject;
+    xward: IPandaPowerObject;
+    measurement: IPandaPowerObject;
+    controller: IPandaPowerObject;
+    std_types: {
+        line: {
+            [key: string]: IPandaPowerStdTypeLine;
+        };
+        trafo: {
+            [key: string]: IPandaPowerStdTypeTrafo;
+        };
+        trafo3w: {
+            [key: string]: IPandaPowerStdTypetrafo3w;
+        };
+        fuse: {
+            [key: string]: any;
+        };
+    };
+    version: string;
+    format_version: string;
+    converged: boolean;
+    OPF_converged: boolean;
+    name: string;
+    f_hz: number;
+    sn_mva: number;
+    user_pf_options: {
+        ac: boolean;
+    };
+}
+export interface IPandaPowerObject {
+    _module: string;
+    _class: string;
+    _object: IPandaPowerObjectValue;
+    orient: string;
+    dtype: any;
+}
+export interface IPandaPowerObjectValue {
+    columns: Array<string>;
+    index: Array<number>;
+    data: Array<any>;
+}
+export interface IPandaPowerStdTypeLine {
+    name: string;
+    uuid: string;
+    type: 'ol' | 'cs';
+    r_ohm_per_km: number;
+    q_mm2: number;
+    x_ohm_per_km: number;
+    c_nf_per_km: number;
+    max_i_ka: number;
+    vn_kv: number;
+}
+export interface IPandaPowerStdTypeTrafo {
+    name: string;
+    uuid: string;
+    shift_degree: number;
+    vector_group: string;
+    vn_hv_kv: number;
+    pfe_kw: number;
+    i0_percent: number;
+    vn_lv_kv: number;
+    sn_mva: number;
+    tap_step_degree: number;
+    tap_neutral: number;
+    tap_min: number;
+    vkr_percent: number;
+    tap_step_percent: number;
+    tap_side: 'hv' | 'mv' | 'lv';
+    tap_phase_shifter: boolean;
+    tap_max: number;
+    vk_percent: number;
+}
+export interface IPandaPowerStdTypetrafo3w {
+    name: string;
+    uuid: string;
+    vector_group: string;
+    vn_mv_kv: number;
+    vn_lv_kv: number;
+    shift_lv_degree: number;
+    shift_mv_degree: number;
+    pfe_kw: number;
+    vn_hv_kv: number;
+    i0_percent: number;
+    sn_lv_mva: number;
+    sn_hv_mva: number;
+    sn_mv_mva: number;
+    vkr_lv_percent: number;
+    tap_neutral: number;
+    tap_min: number;
+    vk_mv_percent: number;
+    vkr_hv_percent: number;
+    vk_lv_percent: number;
+    tap_max: number;
+    vkr_mv_percent: number;
+    tap_step_percent: number;
+    tap_side: 'hv' | 'mv' | 'lv';
+    vk_hv_percent: number;
+}
+export interface IPFDefaults {
+    id: number;
+    name: string;
+    data: {
+        line: IPFDefaultsLines;
+        transformer: any;
+    };
+}
+export interface IPFDefaultsLines {
+    default_length: number;
+    default_r: number;
+    default_x: number;
+    default_ir: number;
+    default_u: number;
+}