@enervance/insight-cim-model 0.0.61 → 0.0.63

package/dist/converter/PSDM/model/TransformerType.d.ts

@@ -1,17 +1,35 @@
+/**
+ * Describes the type of a Transformer (Transformer2WInput)
+ */
 export interface TransformerType {
+    /** generated unique identifier */
     uuid: string;
+    /** phase-to-ground susceptance (typically in nS) */
     b_m: number;
+    /** voltage angle deviation per tap position (typically in °) */
     d_phi: number;
+    /** voltage magnitude deviation per tap position (typically in %) */
     d_v: string;
+    /** phase-to-ground conductance (typically in nS) */
     g_m: number;
+    /** identifier (more understandable for humans) */
     id: string;
+    /** short circuit resistance (typically in Ohm) */
     r_sc: number;
+    /** rated apparent power (typically in MVA) */
     s_rated: number;
+    /** maximum available tap position */
     tap_max: number;
+    /** minimum available tap position */
     tap_min: number;
+    /** neutral tap position */
     tap_neutr: number;
+    /** selection of winding, where the tap changer is installed. Low voltage, if true */
     tap_side: string;
+    /** rated voltage of the high voltage winding (typically in kV) */
     v_rated_a: number;
+    /** rated voltage of the low voltage winding (typically in kV) */
     v_rated_b: number;
+    /** short circuit reactance (typically in Ohm) */
     x_sc: number;
 }

package/dist/converter/integral7/converter.integral7.d.ts

@@ -0,0 +1,207 @@
+import { ILogger } from '../../interfaces/ILogger';
+import { GeographicalRegion } from '../../model/core/GeographicalRegion';
+import { SubGeographicalRegion } from '../../model/core/SubGeographicalRegion';
+import { MySQLConfig, MysqlController } from '../../util/database/mysql-controller';
+import { ConverterStatus, IExportConfig, Integral7Model, ITargetVoltage } from './interface-i7/data-structures-i7';
+import { I7ExportFrame } from './interface-i7/export-frame-i7';
+import { IDefaultValuesConfig } from './interface-i7/IDefaultValuesConfig';
+import { IObjectMappingConfig } from './interface-i7/IObjectMappingConfig';
+import { AsynchronmotorTyp, Einspeisung, Ersatzquerzweig, GeneratorTyp, KDrosselTyp, Standort, Trafo2w } from './model/interfaces';
+import { INTEGRALModelContainer } from '../../model-container/model/INTEGRALModelContainer';
+import { DLConverterI7 } from './dl-convert/dl-converter-i7';
+import { ModelContainer } from '../../model-container/model/ModelContainer';
+export declare class ConverterIntegral7 {
+    logger: ILogger;
+    /** Verbindung zur MySQL DB */
+    mysqlController: MysqlController;
+    /** Exportnetze gemäß Konfiguration  */
+    exportFrames: Map<string, I7ExportFrame>;
+    /** Grenznetze gemäß Konfiguration  */
+    exportFramesBoundary: Map<string, I7ExportFrame>;
+    /** ContainerModel mit Default-CIM-Instanzen */
+    cimModelDefault: INTEGRALModelContainer;
+    /** Das Array hält die verfügbaren Tabellennamen der Projektdatenbank.
+     *  Integral 7 legt keine leeren Tabellen an.
+     *  Das heißt: wenn es keine Typinformation für Kabel gepflegt sind, dann existiert keine Tabelle in der Datenbank */
+    availableTableNames: Map<string, string[]>;
+    /** Speichert die Zuordnung der Integral7 DB-ID zu Typ  */
+    integralID2Type: Map<number, string>;
+    coordinateSystem: string;
+    /** Speichert die Zuordnung der Integral7 DB-ID zu CIM UUID */
+    private readonly integralID2UUID;
+    /** Speichert die Zuordnung der CIM UUID zu Integral7 ID */
+    private readonly UUID2Integral7ID;
+    /** AssetTypes */
+    kdrosseltypen: Map<string, KDrosselTyp>;
+    generatorTypen: Map<string, GeneratorTyp>;
+    asynchronmotorTypen: Map<string, AsynchronmotorTyp>;
+    /** IDs von Leitungsanlussknoten
+     * Die IDs werden zur Bestimmung der im Speicher zu haltenden Objekte (ConnectivityNodes, Terminals) herangezogen. */
+    leitungAnschlussKnotenIDs: Set<unknown>;
+    trafo2wAnschlussKnotenIDs: Set<unknown>;
+    trafo3wAnschlussKnotenIDs: Set<unknown>;
+    hgueAnschlussKnotenIDs: Set<unknown>;
+    lDrosselAnschlussKnotenIDs: Set<unknown>;
+    lKondensatorAnschlussKnotenIDs: Set<unknown>;
+    ersatzZweigAnschlussKnotenIDs: Set<unknown>;
+    /** List of Blocktransformatoren */
+    blocktransformatoren: any[];
+    dlConverterI7: DLConverterI7;
+    constructor();
+    /**
+     * Konvertiert das Netz aus der MySQL Datenbank
+     * @param defaultValuesConfig Standardwerte zur Verwendung bei nicht gepflegten Angaben
+     * @param energyTypesConfig Mapping von I7-Multiplikationsfaktoren auf CIM Klassen
+     * @param tempDirPath temporäres Verzeichnis zum Speichern der Zwischenergebnisse
+     * @return ein Promise mit Statusangabe */
+    convert(objectMappingConfig: IObjectMappingConfig, defaultValuesConfig: IDefaultValuesConfig, energyTypesConfig: any, exportConfig: IExportConfig[], tempDirPath: string): Promise<ConverterStatus>;
+    convertFrame(frame: I7ExportFrame, geoRegion: GeographicalRegion, objectMappingConfig: IObjectMappingConfig, energyTypesConfig: any, defaultValuesConfig: IDefaultValuesConfig): Promise<void>;
+    private assignTerminalSequenceNumber;
+    convertGeoRegionen(): Promise<GeographicalRegion[]>;
+    convertRegelzone(cimModel: ModelContainer, defaultValuesConfig: IDefaultValuesConfig): Promise<void>;
+    convertSubGeoRegionen(regions: GeographicalRegion[], defaultValuesConfig: IDefaultValuesConfig): Promise<SubGeographicalRegion[]>;
+    convertStandorte(cimModel: ModelContainer, integral7: Integral7Model, whereID: number[], defaultValuesConfig: IDefaultValuesConfig): Promise<void>;
+    convertSchaltanlagen(cimModel: ModelContainer, integral7: Integral7Model, standortIDs: number[], defaultValuesConfig: IDefaultValuesConfig): Promise<void>;
+    convertSchaltanlagenAbschnitte(cimModel: ModelContainer, integral7: Integral7Model, schaltanlagenIDs: number[]): Promise<void>;
+    convertSchaltfelder(cimModel: ModelContainer, integral7: Integral7Model, schaltanlagenAbschnittIDs: number[]): Promise<void>;
+    convertKnotenSo(frame: I7ExportFrame, integral7: Integral7Model, standortIDs: number[], defaultValuesConfig: IDefaultValuesConfig): Promise<void>;
+    convertKnotenHgue(frame: I7ExportFrame, integral7: Integral7Model, standortIDs: number[], defaultValuesConfig: IDefaultValuesConfig): Promise<void>;
+    convertSammelschienenAbschnitte(cimModel: ModelContainer, integral7: Integral7Model, schaltanlagenAbschnittIDs: number[]): Promise<void>;
+    convertKnotenSf(cimModel: ModelContainer, integral7: Integral7Model, schaltfeldIDs: number[]): Promise<void>;
+    convertKnotenKf(cimModel: ModelContainer, querkupplungIDs: number[]): Promise<void>;
+    convertKnotenLk(cimModel: ModelContainer, laengskupplungIDs: number[]): Promise<void>;
+    convertSchlaufen(cimModel: ModelContainer, integral7: Integral7Model, knotenSoIDs: number[]): Promise<void>;
+    convertBelastungen(cimModel: INTEGRALModelContainer, knotenSfIDs: number[], defaultValuesConfig: IDefaultValuesConfig, targetClass: string): Promise<any>;
+    convertEinspeisungen(cimModel: INTEGRALModelContainer, knotenSfIDs: number[], objectMappingConfig: IObjectMappingConfig): Promise<void>;
+    convertErsatzQuerZweige(cimModel: INTEGRALModelContainer, knotenSfIDs: number[], targetClass: string): Promise<void>;
+    convertGeneratoren(cimModel: INTEGRALModelContainer, knotenSfIDs: number[], energyTypesConfig: any): Promise<void>;
+    convertAsynchronmotor(cimModel: INTEGRALModelContainer, knotenSfIDs: number[], defaultValuesConfig: IDefaultValuesConfig): Promise<void>;
+    convertKraftwerksbloecke(cimModel: INTEGRALModelContainer, knotenSfIDs: number[], energyTypesConfig: any): Promise<void>;
+    convertErsatzQuerZweige2ExternalNetworkInjection(cimModel: INTEGRALModelContainer, result: Ersatzquerzweig[]): Promise<void>;
+    convertErsatzQuerZweige2EquivalentInjection(cimModel: ModelContainer, result: Ersatzquerzweig[]): Promise<void>;
+    convertBoundaryInjections(cimModel: INTEGRALModelContainer, knotenSfIDs: number[], targetClass: string): Promise<void>;
+    private convertBoundaryInjections2EquivalentInjection;
+    private convertBoundaryInjections2ExternalNetworkInjection;
+    /** Convert CErsatzlaengszweige to cim:EquivalentBranches*/
+    convertErsatzLaengszweige(frame: I7ExportFrame, integral7: Integral7Model, defaultValuesConfig: IDefaultValuesConfig): Promise<void>;
+    /** Kompensationsdrossel*/
+    convertKompensationsdrossel(cimModel: ModelContainer, targetVoltages: Map<number, ITargetVoltage>, knotenSfIDs: number[]): Promise<void>;
+    /** Kompensationskondensator*/
+    convertKompensationskondensatoren(cimModel: ModelContainer, targetVoltages: Map<number, ITargetVoltage>, knotenSfIDs: number[]): Promise<void>;
+    convertStatcom(cimModel: ModelContainer, knotenSfIDs: number[]): Promise<void>;
+    convertSVC(cimModel: ModelContainer, knotenSfIDs: number[]): Promise<void>;
+    convertCsConverterDC(cimModel: ModelContainer, integral7: Integral7Model, knotenSfIDs: number[]): Promise<void>;
+    convertVsConverterDC(cimModel: ModelContainer, integral7: Integral7Model, knotenSfIDs: number[]): Promise<void>;
+    convertEinspeisungen2EnergySource(cimModel: ModelContainer, result: Einspeisung[]): Promise<void>;
+    private convertEnergySourceToExternalNetworkInjection;
+    private convertEinspeisungen2EquivalentInjection;
+    private convertEinspeisungen2ExternalNetworkInjection;
+    private setTopologyEnergySourceConsumerObject;
+    convertQuerkupplungen(cimModel: ModelContainer, integral7: Integral7Model, schaltanlagenAbschnittIDs: number[]): Promise<void>;
+    convertLaegskupplungen(cimModel: ModelContainer, integral7: Integral7Model, schaltanlagenIDs: number[]): Promise<void>;
+    convertStarreVerbindungen(cimModel: ModelContainer, containerIDs: number[]): Promise<void>;
+    /** LK Trenner */
+    convertTrennerFi3f(cimModel: ModelContainer, containerIDs: number[]): Promise<void>;
+    convertTrenner3f(cimModel: ModelContainer, containerIDs: number[]): Promise<void>;
+    convertLeistungsschalter(cimModel: ModelContainer, containerIDs: number[]): Promise<void>;
+    private convertSwitch;
+    convertLaengsdrosseln(cimModel: ModelContainer, integral7: Integral7Model, defaultValuesConfig: IDefaultValuesConfig): Promise<void>;
+    convertLaengskondensatoren(cimModel: ModelContainer, integral7: Integral7Model, defaultValuesConfig: IDefaultValuesConfig): Promise<void>;
+    convertBetriebsmitteltypenKdrossel(): Promise<void>;
+    /**
+     * @return I7 IDs der Sternpunktschienen für die blockweise Verarbeitung von Sternpunktimpedanzen*/
+    convertSternpunktSchienen(cimModel: ModelContainer, integral7: Integral7Model, standortIDs: number[]): Promise<any>;
+    convertKdrossel(cimModel: ModelContainer, integral7: Integral7Model, stpScheinenID: number[]): Promise<any>;
+    /** Den Schaltzuszand bestimmen und zuvor angelegten (convertSternpunktSchienen) Terminalinstanz zuweisen. */
+    convertStpSchaltelemente(integral7: Integral7Model, stpSchienenID: number[]): Promise<any>;
+    convertLaengskupplungen(cimModel: ModelContainer, integral7: Integral7Model, schaltanlagenIDs: number[]): Promise<void>;
+    convertBetriebsmitteltypenLeitung(): Promise<void>;
+    private setWireInfoProperties;
+    convertLeitungen(frame: I7ExportFrame, integral7: Integral7Model, defaultValuesConfig: IDefaultValuesConfig): Promise<void>;
+    convertDCLines(cimModel: ModelContainer, integral7: Integral7Model, defaultValuesConfig: IDefaultValuesConfig): Promise<void>;
+    convertBetriebsmitteltypenTrafo(): Promise<void>;
+    convertBetriebsmitteltypenGenerator(): Promise<void>;
+    convertBetriebsmitteltypenAsynchronmotor(): Promise<void>;
+    convertMultiplikationsfaktoren(): Promise<void>;
+    convertTrafo2W(frame: I7ExportFrame, integral7: Integral7Model, defaultValuesConfig: IDefaultValuesConfig, standortIDs: number[]): Promise<void>;
+    convertTrafo3W(frame: I7ExportFrame, integral7: Integral7Model, defaultValuesConfig: IDefaultValuesConfig, standortIDs: number[]): Promise<void>;
+    private setTransformerEndInfoProperties;
+    /**
+     * @param frame Das zu transformierende Grenzmodell
+     * @param masFrame Die MAS-Grenzmodelle zum Export Geo-Koordinaten.
+     * */
+    transformBoundaryModel(frame: I7ExportFrame, masFrames: I7ExportFrame[]): Promise<void>;
+    private sortTransformerEnd;
+    private setACLineSegmentProperties;
+    private setConductingEquipmentCurrentLimit;
+    private setVoltageLimit;
+    private setACLineSegmentCurrentLimt;
+    private createIfNotExistOperationalLimitType;
+    private createConnection;
+    private createBoundaryConnection;
+    getConnectedBoundaryModel(anschlussUUID: string): I7ExportFrame | undefined;
+    /** create equivalent injection for the connected MAS to support voltage information and exchanged power. set active power and reactive power to zero if connection is active. */
+    private createBoundaryEquivalentInjection;
+    private determineEquipmentContainer;
+    getSpannungsbandTrafo2W(i7Data: Trafo2w): Promise<{
+        id: number;
+        usoll: number;
+        umin: number;
+        umax: number;
+    } | undefined>;
+    /** Fragt die verfügbaren Tabellennamen ab. */
+    getAvailableTableNames(database: string): Promise<void>;
+    /** Fragt die verfügbaren Tabellennamen ab. */
+    getAvailableTableColumnNames(database: string): Promise<void>;
+    init(mySqlConfig: MySQLConfig, logger: ILogger): Promise<ConverterStatus>;
+    private configExportFrames;
+    private initExportFrames;
+    private associateGeoRegionsToExportFrames;
+    queryDataInChuncks(objectName: string, ids: number[]): Promise<any[]>;
+    createColumnIndex(): Promise<void>;
+    dropColumnIndex(): Promise<void>;
+    initMySQLConnection(mySqlConfig: MySQLConfig): void;
+    private createDropIndex;
+    private addDefaultObjects;
+    private addDefaultObjectsRegion;
+    private addDefaultObjectsLoadModel;
+    private addDefaultObjectsGeo;
+    private setPowerTransformerEndProperties;
+    private convertTapChangers;
+    private setTapChangerVoltageProperties;
+    private createRatioTapChanger;
+    private createPhaseTapChanger;
+    private setTapChangerControl;
+    /** Trafo erden
+     * @param trafoObjektID Fall Trafo 2W: I7 ID des Trafos. Fall Trafo 3W: I7 ID der Wicklung
+     * @param powerTransformerEnd CIM Objekt der Wicklung
+     * @param cnUUID UIID der ConnectivityNode an dem die Wicklung angeschlossen ist
+     * @param sternpunktKnotenMap Map mit den Sterpunktknoten aus der I7 Datenbank
+     * */
+    private convertTrafoGrounding;
+    /** AnschlussIDs von Leitungen für Topologie abfragen */
+    private queryLeitungsAnschlussIDs;
+    /** AnschlussIDs von Trafos für Topologie abfragen */
+    private queryTrafosAnschlussIDs;
+    private queryHgueAnschlussIDs;
+    private queryLDroselAnschlussIDs;
+    private queryErsatzLaengsAnschlussIDs;
+    private queryLkondensatorAnschlussIDs;
+    private getVoltageLevelByVoltage;
+    private checkAnschlussIDs;
+    private checkLeitungsID;
+    private checkTrafo2WID;
+    private checkTrafo3WID;
+    private checkHgueID;
+    private checkLDrosselID;
+    private checkErsatzZweigID;
+    private checkLKondensatorID;
+    private filterTablesByAvailability;
+    private isTableAvailable;
+    private getAvailableColumnNames;
+    /** Erstellt das Mappig zwischen I7-ID und CIM-UUIDs */
+    private addIdMapping;
+    private annotateBoundaryNode;
+    release(tempDirPath?: string): Promise<ConverterStatus>;
+}
+export declare function getGeoCoordinates(i7Data: Standort): string[] | undefined;