@enervance/insight-cim-model 0.0.62 → 0.0.64

package/dist/converter/integral7/utils.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getSpannungsband = exports.createRegulatingControl = exports.createWriteStreamPromise = exports.getPSRType = exports.putUUIDtoI7Ids = exports.getIntegral7IDs = exports.createTempDirPath = exports.determineEquipmentContainer = exports.getSchemaValue = exports.writeZipFile = exports.generateNodeStream = exports.writeFile = exports.generateFuelType = exports.getNumber = exports.getDescription = exports.getActiveReactivePower = exports.getTapChangerStepArray = exports.getTapChangerStepCount = exports.setTapChangerControl = exports.createPhaseTapChanger = exports.createRatioTapChanger = exports.getConductingEquipmentTerminalBySecNumber = exports.getTrafoIleer = exports.getTrafoPleer = exports.calculateG0ch = exports.calculateBC = exports.calculateGPerSection = exports.calculateBPerSection = exports.calculateB = exports.calculateG = exports.calculateX = exports.calculateSigma = exports.calculateR = exports.getUrTrafo = exports.getSrTrafo = exports.getUkrTrafo = exports.getPkrTrafo = exports.getSchaltgruppeAngleClock = exports.getSchaltgruppe = exports.convertToBooleanI7 = exports.isBooleanI7 = exports.convertToNumberI7 = exports.isNumericI7 = exports.getTerminalUn = exports.getU = exports.getLine = exports.getLineByAttribute = exports.getName = exports.ueberpruefeZeichenkette = void 0;
-const tslib_1 = require("tslib");
-const fs_1 = tslib_1.__importDefault(require("fs"));
+const fs = require("fs");
 const __1 = require("../..");
 const PhaseTapChangerAsymmetrical_1 = require("../../model/wires/PhaseTapChangerAsymmetrical");
 const PhaseTapChangerLinear_1 = require("../../model/wires/PhaseTapChangerLinear");
@@ -14,14 +13,13 @@ function ueberpruefeZeichenkette(str) {
 }
 exports.ueberpruefeZeichenkette = ueberpruefeZeichenkette;
 function getName(object) {
-    var _a, _b, _c;
-    if (((_a = object.bezeichner) === null || _a === void 0 ? void 0 : _a.length) > 0) {
+    if (object.bezeichner?.length > 0) {
         return object.bezeichner;
     }
-    else if (((_b = object.name) === null || _b === void 0 ? void 0 : _b.length) > 0) {
+    else if (object.name?.length > 0) {
         return object.name;
     }
-    else if (((_c = object.langname) === null || _c === void 0 ? void 0 : _c.length) > 0) {
+    else if (object.langname?.length > 0) {
         return object.langname;
     }
     return 'NN';
@@ -35,6 +33,9 @@ function getLineByAttribute(cimModel, lineAttribute, attributeInstance) {
             break;
         }
     }
+    // if(line === undefined){
+    //   const a = 1;
+    // }
     return line;
 }
 exports.getLineByAttribute = getLineByAttribute;
@@ -46,6 +47,9 @@ function getLine(cimModel, bezeichner, kurzname) {
             break;
         }
     }
+    // if(line === undefined){
+    //   const a = 1;
+    // }
     return line;
 }
 exports.getLine = getLine;
@@ -53,6 +57,7 @@ function getU(un, deafultUn) {
     return (isNaN(un) || un === null) ? deafultUn : +un;
 }
 exports.getU = getU;
+/** Wenn die Objektreferenzen nicht vorhanden sind, wird das BV-Objekt über die UUID bestimmt. */
 function getTerminalUn(cimModel, ce) {
     const terminals = ce.terminals.size > 0 ? [...ce.terminals.keys()] : ce.terminalsUUIDs;
     for (const terminalUUID of terminals) {
@@ -63,7 +68,7 @@ function getTerminalUn(cimModel, ce) {
             }
             else if (terminal.connectivityNodeUUID) {
                 const cn = cimModel.getObject(terminal.connectivityNodeUUID);
-                const cnContainerUUID = cn === null || cn === void 0 ? void 0 : cn.getConnectivityNodeContainerUUID();
+                const cnContainerUUID = cn?.getConnectivityNodeContainerUUID();
                 if (cnContainerUUID) {
                     const cnContainer = cimModel.getObject(cnContainerUUID);
                     let voltageLevel;
@@ -73,10 +78,10 @@ function getTerminalUn(cimModel, ce) {
                     else if (cnContainer instanceof __1.VoltageLevel) {
                         voltageLevel = cnContainer;
                     }
-                    if (voltageLevel === null || voltageLevel === void 0 ? void 0 : voltageLevel.baseVoltage) {
+                    if (voltageLevel?.baseVoltage) {
                         return voltageLevel.baseVoltage;
                     }
-                    else if (voltageLevel === null || voltageLevel === void 0 ? void 0 : voltageLevel.baseVoltageUUID) {
+                    else if (voltageLevel?.baseVoltageUUID) {
                         return cimModel.baseVoltages.get(voltageLevel.baseVoltageUUID);
                     }
                 }
@@ -92,12 +97,15 @@ function isNumericI7(value) {
         const dotValue = String(value).trim().replace(',', '.');
         const percentValue = dotValue.replace('%', '');
         if (Number.isFinite(value)) {
+            // 1. undefined, null, leere Strings
             isfinite_number = true;
         }
         else if (Number.isFinite(parseFloat(dotValue))) {
+            // 2.  parseFloat parseFloat('') liefert NaN! parseFloat('123_A') liefert 123!
             isfinite_number = true;
         }
         else if (isFinite(parseFloat(percentValue))) {
+            // 3. auf Textzeichen prüfen und Prozentzeichen berücksichtigen
             isfinite_number = true;
         }
     }
@@ -129,6 +137,8 @@ function convertToNumberI7(value) {
 }
 exports.convertToNumberI7 = convertToNumberI7;
 function isBooleanI7(value) {
+    // undefined-Werte werden nicht berücksichtigt
+    // leere-String werden nicht berücksichtigt
     if (convertToBooleanI7(value) === undefined) {
         return false;
     }
@@ -170,10 +180,15 @@ function convertToBooleanI7(value) {
 }
 exports.convertToBooleanI7 = convertToBooleanI7;
 function getSchaltgruppe(schaltgr, endNumber, isNeutralGrounded) {
+    //let pos_max = endsRATEDVoltage.indexOf(Math.max(...endsRATEDVoltage));
+    //let translate = undefined;
+    //Aktuell wird ignoriert: Groß- und Kleinschreibung von Spannungsniveaus
     switch (schaltgr) {
         case 'DD0':
+            //endnumber don't care
             return __1.WindingConnection.D;
         case 'DD6':
+            //endnumber don't care
             return __1.WindingConnection.D;
         case 'DY5':
         case 'DY6':
@@ -201,6 +216,7 @@ function getSchaltgruppe(schaltgr, endNumber, isNeutralGrounded) {
                 return __1.WindingConnection.Zn;
             }
         case 'Y0':
+            //Autotransformer:
             return __1.WindingConnection.A;
         case 'Y0D5':
             if (endNumber == 1 || endNumber == 2) {
@@ -237,8 +253,8 @@ function getSchaltgruppe(schaltgr, endNumber, isNeutralGrounded) {
             else {
                 return __1.WindingConnection.D;
             }
-        case 'YNd5':
-        case 'YNd7d7':
+        case 'YNd5': //N is ignored.
+        case 'YNd7d7': //N is ignored.
             if (endNumber === 1 && !isNeutralGrounded) {
                 return __1.WindingConnection.Y;
             }
@@ -394,7 +410,7 @@ function getSchaltgruppeAngleClock(schaltgr, endNumber) {
 }
 exports.getSchaltgruppeAngleClock = getSchaltgruppeAngleClock;
 function getPkrTrafo(i7Data, powerTransformerInfo, suffix) {
-    const prop = `pkr${suffix}`;
+    const prop = `pkr${suffix}`; // fix für 2W Trafos
     if (i7Data[prop] && i7Data[prop] !== 0) {
         return i7Data[prop];
     }
@@ -405,7 +421,7 @@ function getPkrTrafo(i7Data, powerTransformerInfo, suffix) {
 }
 exports.getPkrTrafo = getPkrTrafo;
 function getUkrTrafo(i7Data, powerTransformerInfo, suffix) {
-    const prop = `ukr${suffix}`;
+    const prop = `ukr${suffix}`; // fix für 2W Trafos
     if (i7Data[prop] && i7Data[prop] !== 0) {
         return i7Data[prop];
     }
@@ -416,7 +432,7 @@ function getUkrTrafo(i7Data, powerTransformerInfo, suffix) {
 }
 exports.getUkrTrafo = getUkrTrafo;
 function getSrTrafo(i7Data, powerTransformerInfo, endNumber, isTrafo3W) {
-    const prop = `sr${isTrafo3W ? endNumber : ''}`;
+    const prop = `sr${isTrafo3W ? endNumber : ''}`; // fix für 2W Trafos
     if (i7Data[prop] && i7Data[prop] !== 0) {
         return i7Data[prop];
     }
@@ -437,7 +453,7 @@ function getUrTrafo(i7Data, powerTransformerInfo, endNumber) {
         return i7Data[prop];
     }
     else if (powerTransformerInfo) {
-        const transformerEndInfo = powerTransformerInfo === null || powerTransformerInfo === void 0 ? void 0 : powerTransformerInfo.getTransformerEndInfos().find(element => element.endNumber === endNumber);
+        const transformerEndInfo = powerTransformerInfo?.getTransformerEndInfos().find(element => element.endNumber === endNumber);
         if (transformerEndInfo && transformerEndInfo.ratedU) {
             if (transformerEndInfo.ratedU && transformerEndInfo.ratedU.value !== 0) {
                 return transformerEndInfo.ratedU.value;
@@ -447,6 +463,10 @@ function getUrTrafo(i7Data, powerTransformerInfo, endNumber) {
     return 0;
 }
 exports.getUrTrafo = getUrTrafo;
+/**
+ * @param un Nennspannung in kV
+ * @param pkr Kurzschlussverluste im Bemessungsbetrieb kW
+ * @param sr Bemessungsscheinleistung in MVA  */
 function calculateR(un, pkr, sr) {
     const conversion_factor_un = Math.pow(10, 3);
     const conversion_factor_pkr = Math.pow(10, 3);
@@ -454,6 +474,8 @@ function calculateR(un, pkr, sr) {
     let ret_val = undefined;
     try {
         ret_val = (pkr * conversion_factor_pkr) * Math.pow((un * conversion_factor_un), 2) / Math.pow((sr * conversion_factor_sr), 2);
+        //ret_val = (pkr*conversion_factor_pkr) * Math.pow((un*conversion_factor_un), 2) / Math.pow((sr*conversion_factor_sr), 1); //TODO: Test (20220127)
+        //ret_val = Math.pow((un*conversion_factor_un), 2)/(pkr*conversion_factor_pkr); //TODO: Test (20220131)
     }
     catch (e) {
         ret_val = undefined;
@@ -461,6 +483,11 @@ function calculateR(un, pkr, sr) {
     return ret_val;
 }
 exports.calculateR = calculateR;
+/**
+ * @param fn Nennfrquenz in Hz
+ * @param pn Nennwirkleistung in MW
+ * @param kr Leistungszahl in MW/Hz
+ * @returns Statik Sigma des Generators. */
 function calculateSigma(fn, pn, kr) {
     let sigma = 0;
     try {
@@ -473,6 +500,11 @@ function calculateSigma(fn, pn, kr) {
     return sigma;
 }
 exports.calculateSigma = calculateSigma;
+/**
+ * @param un Nennspannung in kV
+ * @param ukr Kurzschlussspannung in %
+ * @param sr Bemessungsscheinleistung in MVA
+ * @param r Wiederstand in Ohm */
 function calculateX(un, ukr, sr, r) {
     const conversion_factor_un = Math.pow(10, 3);
     const conversion_factor_sr = Math.pow(10, 6);
@@ -487,6 +519,9 @@ function calculateX(un, ukr, sr, r) {
     return ret_val;
 }
 exports.calculateX = calculateX;
+/**
+ * @param un Nennspannung in kV
+ * @param pLeer P0 Leerlaufverluste in kW */
 function calculateG(un, pLeer) {
     const conversion_factor_un = Math.pow(10, 3);
     const conversion_factor_pLeer = Math.pow(10, 3);
@@ -500,6 +535,10 @@ function calculateG(un, pLeer) {
     return ret_val;
 }
 exports.calculateG = calculateG;
+/**
+ * @param un Nennspannung in kV
+ * @param iLeer Leerlaufstrom bezogen auf Wicklung mit dem grössten Sr in %
+ * @param pLeer P0 Leerlaufverluste in kW*/
 function calculateB(un, sr, iLeer, pLeer) {
     const conversion_factor_un = Math.pow(10, 3);
     const conversion_factor_sr = Math.pow(10, 6);
@@ -515,6 +554,11 @@ function calculateB(un, sr, iLeer, pLeer) {
     return ret_val;
 }
 exports.calculateB = calculateB;
+/**
+ * @param ur rated voltage in kV
+ * @param qr rated reactive power in MVar
+ * @param maxTap maximal step of the equipment.
+ */
 function calculateBPerSection(qr, ur, maxTap) {
     const conversion_factor_ur = Math.pow(10, 3);
     const conversion_factor_qr = Math.pow(10, 6);
@@ -528,6 +572,11 @@ function calculateBPerSection(qr, ur, maxTap) {
     return ret_val;
 }
 exports.calculateBPerSection = calculateBPerSection;
+/**
+ * @param ur rated voltage in kV
+ * @param pr rated reactive power in MW
+ * @param maxTap maximal step of the equipment.
+ */
 function calculateGPerSection(pr, ur, maxTap) {
     const conversion_factor_ur = Math.pow(10, 3);
     const conversion_factor_pr = Math.pow(10, 6);
@@ -541,6 +590,11 @@ function calculateGPerSection(pr, ur, maxTap) {
     return ret_val;
 }
 exports.calculateGPerSection = calculateGPerSection;
+/**
+ * @param c capacitance of a line in µF
+ * @param f frequency in Hz
+ * @returns susceptance of a line in S
+ */
 function calculateBC(c, f) {
     const conversion_factor = Math.pow(10, -6);
     let ret_val = undefined;
@@ -553,10 +607,24 @@ function calculateBC(c, f) {
     return ret_val;
 }
 exports.calculateBC = calculateBC;
+/**
+ * @param r reactance of a line in ohm
+ * @returns conductance of a line in S
+ */
 function calculateG0ch(r) {
+    // const conversion_factor = 1;
+    // let ret_val = undefined;
     return 0;
+    //always returns zero
+    // try {
+    //   ret_val = (1/r) * conversion_factor;
+    // } catch (e) {
+    //   ret_val = undefined;
+    // }
+    // return ret_val;
 }
 exports.calculateG0ch = calculateG0ch;
+// Leerlaufverluste
 function getTrafoPleer(i7Data, powerTransformerInfo) {
     if (i7Data['p_leer'] && i7Data['p_leer'] !== 0) {
         return i7Data['p_leer'];
@@ -567,6 +635,7 @@ function getTrafoPleer(i7Data, powerTransformerInfo) {
     return 0;
 }
 exports.getTrafoPleer = getTrafoPleer;
+// Leerlaufstrom bezogen auf Wicklung mit dem grössten Sr in %
 function getTrafoIleer(i7Data, powerTransformerInfo) {
     if (i7Data['i_leer'] && i7Data['i_leer'] !== 0) {
         return i7Data['i_leer'];
@@ -587,30 +656,62 @@ function getConductingEquipmentTerminalBySecNumber(conductingEquipment, sequence
 }
 exports.getConductingEquipmentTerminalBySecNumber = getConductingEquipmentTerminalBySecNumber;
 function createRatioTapChanger(i7Data, transformerEnd, cimModel, neutralU, terminals, knotenSpannungsband) {
+    // ist ein Stufenschalter vorhanden?
+    /**
+     * 0 - obere Spannungsseite (Anschluss 1)
+     * 1 - obere Spannungsseite (Anschluss 1)
+     * 2 - mittlere Spannungsseite (Anschluss 1)
+     * 3 - Niederspannungsseite (Anschluss 2)
+     * ? - Externer Knoten  (Anschluss 3)
+     * */
+    /**
+     * 1 obere Spannungsseite
+     * 2 mittlere Spannungsseite
+     * 3 Niederspannungsseite
+     * */
+    /** Regelung */
+    /** Spezialregelung - trafo_spezial
+     * 0 - keine Spezialitäten
+     *     Winkel == 0 Grad => Längsregler => RatioTapChanger
+     *     Querregler Winkel != 0 => Querregler => PhaseTapChanger =>  PhaseTapChangerLinear | PhaseTapChangerTabular
+     * 1 - Typ Meeden
+     *     Symetrischer Querregler => PhaseTapChangerSymmetrical
+     * 2 - Typ Helmstedt
+     *     Asymetrischer Querregler => PhaseTapChangerAsymmetrical
+     * */
     const wicklungsnummer = transformerEnd.endNumber;
+    /** Normieren auf die Wicklungsnummer, da 0 obere Spannungsseite ist */
     const gestufteSeite = i7Data[`gestufte_seite_s${wicklungsnummer}`] === 0 ? 1 : i7Data[`gestufte_seite_s${wicklungsnummer}`];
+    //const gestufteSeiteS1 = i7Data.gestufte_seite_s1 === 0 ? 1 : i7Data.gestufte_seite_s1;
     if (gestufteSeite === wicklungsnummer) {
         const lowStep = i7Data[`minstufe_s${transformerEnd.endNumber}`];
         const highStep = i7Data[`maxstufe_s${transformerEnd.endNumber}`];
         const neutralStep = i7Data[`mittelstufe_s${transformerEnd.endNumber}`];
         const currentStep = i7Data[`aktstufe_s${transformerEnd.endNumber}`];
+        /** die Stufenpositionen werden auf 1..n normiert
+         * Zu Betimmung der aktuellen Stufe, wird ein Array mit den i7 Stufennummern angelegt.
+         * Der Index wird später die verwendet, um die normierte Stufenposition zu bestimmen */
         const i7TapArray = getTapChangerStepArray(lowStep, highStep);
         const mappedCurrentStep = i7TapArray.indexOf(currentStep) + 1;
-        const lowerVoltageStepCount = getTapChangerStepCount(lowStep, neutralStep);
+        const lowerVoltageStepCount = getTapChangerStepCount(lowStep, neutralStep); // 9
         const increaseVoltageStepCount = getTapChangerStepCount(neutralStep, highStep);
-        const lowerVoltageStepIncrement = Math.abs(i7Data[`umin_s${transformerEnd.endNumber}`]) / lowerVoltageStepCount * -1;
-        let increaseVoltageStepIncrement = Math.abs(i7Data[`umax_s${transformerEnd.endNumber}`]) / lowerVoltageStepCount;
+        const lowerVoltageStepIncrement = Math.abs(i7Data[`umin_s${transformerEnd.endNumber}`]) /*/ 100*/ / lowerVoltageStepCount * -1; // -0.01778 => -1.78%
+        let increaseVoltageStepIncrement = Math.abs(i7Data[`umax_s${transformerEnd.endNumber}`]) /*/ 100*/ / lowerVoltageStepCount; // 0.01778 => 1.78%
         increaseVoltageStepIncrement = isNaN(increaseVoltageStepIncrement) ? 1 : increaseVoltageStepIncrement;
         const ratioTapChangerTable = new __1.RatioTapChangerTable((0, __1.generateUUID)(), `${transformerEnd.name} W${transformerEnd.endNumber}`);
+        // Spannung verringern
         for (let i = 0; i < lowerVoltageStepCount; i++) {
             (0, __1.createRatioTapChangerTablePoint)(ratioTapChangerTable, i + 1, 1 + (lowerVoltageStepIncrement * (lowerVoltageStepCount - i)));
         }
+        // neutral Step
         (0, __1.createRatioTapChangerTablePoint)(ratioTapChangerTable, lowerVoltageStepCount + 1, 1);
+        // Spannung erhoehen
         for (let i = 0; i < increaseVoltageStepCount; i++) {
             const step = (lowerVoltageStepCount + 1) + (i + 1);
             (0, __1.createRatioTapChangerTablePoint)(ratioTapChangerTable, step, 1 + (increaseVoltageStepIncrement * (i + 1)));
         }
         const ratioTapChanger = new __1.RatioTapChanger((0, __1.generateUUID)(), `${transformerEnd.name} W${transformerEnd.endNumber}`);
+        // Attribute
         ratioTapChanger.stepVoltageIncrement = increaseVoltageStepIncrement;
         ratioTapChanger.tculControlMode = __1.TransformerControlMode.volt;
         ratioTapChanger.ltcFlag = false;
@@ -624,14 +725,24 @@ function createRatioTapChanger(i7Data, transformerEnd, cimModel, neutralU, termi
         ratioTapChanger.neutralU = neutralU;
         ratioTapChanger.ratioTapChangerTableUUID = ratioTapChangerTable.mrid;
         ratioTapChangerTable.ratioTapChanger = ratioTapChanger;
+        // Ist die Regelungung aktiv?
+        // wenn ja, welche Art=
         const regelung = +i7Data[`regelung_s${transformerEnd.endNumber}`];
         if (regelung > 0) {
+            /** Ausprägungen
+             * 0 -> keine automatische Stufung
+             * 1 -> Spannungsbetragsregelung
+             * 2 -> Wirkflussvorgabe
+             * 3 -> Stromkompoundierung ->  stromabhängige Spannungsregelung
+             * 4 -> Blindleitungsbilazierung
+             * */
             const tapChangerControl = new __1.TapChangerControl((0, __1.generateUUID)(), `${transformerEnd.name} W_${transformerEnd.endNumber}`);
             tapChangerControl.discrete = true;
+            /** TODO usoll, umin, umax bestimmen -> Anschlusskoten bestimmen (ssab oder abzweigknoten) */
             const umax = getSpannungsband('umax', knotenSpannungsband, neutralU);
             const umin = getSpannungsband('umin', knotenSpannungsband, neutralU);
             const usoll = getSpannungsband('usoll', knotenSpannungsband, (umax + umin) / 2);
-            const pVorgabe = isNumericI7(i7Data[`p_vorgabe`]) ? +i7Data[`p_vorgabe`] : undefined;
+            const pVorgabe = isNumericI7(i7Data[`p_vorgabe`]) ? +i7Data[`p_vorgabe`] : undefined; // PST Trafo
             switch (regelung) {
                 case 1: {
                     ratioTapChanger.controlEnabled = true;
@@ -647,6 +758,7 @@ function createRatioTapChanger(i7Data, transformerEnd, cimModel, neutralU, termi
                     tapChangerControl.enabled = true;
                     tapChangerControl.mode = __1.RegulatingControlModeKind.activePower;
                     tapChangerControl.targetValue = pVorgabe;
+                    // TODO targetDeadband
                     tapChangerControl.targetValueUnitMultiplier = __1.UnitMultiplier.M;
                     break;
                 }
@@ -654,16 +766,23 @@ function createRatioTapChanger(i7Data, transformerEnd, cimModel, neutralU, termi
                     ratioTapChanger.controlEnabled = true;
                     tapChangerControl.enabled = true;
                     tapChangerControl.mode = __1.RegulatingControlModeKind.currentFlow;
+                    // TODO targetDeadband
+                    // TODO targetValue
+                    // TODO targetValueUnitMultiplier
                     break;
                 }
                 case 4: {
                     ratioTapChanger.controlEnabled = true;
                     tapChangerControl.enabled = true;
                     tapChangerControl.mode = __1.RegulatingControlModeKind.reactivePower;
+                    // TODO targetDeadband
+                    // TODO targetValue
+                    // TODO targetValueUnitMultiplier
                     tapChangerControl.targetValueUnitMultiplier = __1.UnitMultiplier.M;
                     break;
                 }
             }
+            // Assoziationen
             ratioTapChanger.tapChangerControl = tapChangerControl;
             tapChangerControl.addTapChanger(ratioTapChanger);
             cimModel.addTapChangerControl(tapChangerControl);
@@ -671,6 +790,14 @@ function createRatioTapChanger(i7Data, transformerEnd, cimModel, neutralU, termi
         else {
             ratioTapChanger.controlEnabled = false;
         }
+        // Spannungsgeregelter Anschluss
+        /**
+         * 0 - obere Spannungsseite (Anschluss 1)
+         * 1 - mittlere Spannungsseite (Anschluss 2)
+         * 2 - Niederspannungsseite (Anschluss 3)
+         * 3 - Externer Knoten
+         * */
+        /** Normieren auf die Wicklungsnummer, da 0 neben 1 obere Spannungsseite angibt */
         const terminal = knotenSpannungsband ? knotenSpannungsband.terminals.find(term => term.connected !== false) : undefined;
         if (terminal) {
             setTapChangerControl(ratioTapChanger, terminal.uuid);
@@ -681,16 +808,48 @@ function createRatioTapChanger(i7Data, transformerEnd, cimModel, neutralU, termi
                 transformerEnd.ratioTapChanger.tapChangerControlUUID = undefined;
             }
         }
+        //SV Profil: Aktuelle Stufenstellung
+        /*    const svTapStep = new SvTapStep(generateUUID(), i7TapArray.indexOf(currentStep) + 1, ratioTapChanger);
+            ratioTapChanger.svTapStepUUID = svTapStep.mrid;
+            cimModel.addSvTapStep(svTapStep);*/
         cimModel.addRatioTapChanger(ratioTapChanger);
         cimModel.addRatioTapChangerTable(ratioTapChangerTable);
     }
 }
 exports.createRatioTapChanger = createRatioTapChanger;
 function createPhaseTapChanger(i7Data, transformerEnd, cimModel, neutralU, trafoTerminals, knotenSpannungsband) {
+    // ist ein Stufenschalter vorhanden?
+    /**
+     * 0 - obere Spannungsseite (Anschluss 1)
+     * 1 - obere Spannungsseite (Anschluss 1)
+     * 2 - mittlere Spannungsseite (Anschluss 1)
+     * 3 - Niederspannungsseite (Anschluss 2)
+     * ? - Externer Knoten  (Anschluss 3)
+     * */
+    /**
+     * 1 obere Spannungsseite
+     * 2 mittlere Spannungsseite
+     * 3 Niederspannungsseite
+     * */
+    /** Regelung */
+    /** Spezialregelung - trafo_spezial
+     * 0 - keine Spezialitäten
+     *     Winkel == 0 Grad => Längsregler => RatioTapChanger
+     *     Querregler Winkel != 0 => Querregler => PhaseTapChanger =>  PhaseTapChangerLinear | PhaseTapChangerTabular
+     * 1 - Typ Meeden
+     *     Symetrischer Querregler => PhaseTapChangerSymmetrical
+     * 2 - Typ Helmstedt
+     *     Asymetrischer Querregler => PhaseTapChangerAsymmetrical
+     * */
     const wicklungsnummer = transformerEnd.endNumber;
+    /** Normieren auf die Wicklungsnummer, da 0 obere Spannungsseite ist */
     const gestufteSeite = i7Data[`gestufte_seite_s${wicklungsnummer}`] === 0 ? 1 : i7Data[`gestufte_seite_s${wicklungsnummer}`];
     if (gestufteSeite === wicklungsnummer) {
         const spezialregelung = i7Data.trafo_spezial;
+        /*    const tapChangerControl = new TapChangerControl(generateUUID(), `${transformerEnd.name} W_${transformerEnd.endNumber}`);
+            // TODO
+            tapChangerControl.mode = RegulatingControlModeKind.activePower;
+            tapChangerControl.discrete = true;*/
         let phaseTapChanger;
         switch (spezialregelung) {
             case (2): {
@@ -701,12 +860,15 @@ function createPhaseTapChanger(i7Data, transformerEnd, cimModel, neutralU, trafo
                 break;
             }
             default: {
+                // 0 - keine Spezialitäten
+                // 1 - Typ Meeden
                 const phaseTapChangerLinear = new PhaseTapChangerLinear_1.PhaseTapChangerLinear((0, __1.generateUUID)(), `${transformerEnd.name} W_${transformerEnd.endNumber}`);
                 phaseTapChangerLinear.stepPhaseShiftIncrement = convertToNumberI7(i7Data[`uzus_winkel_s${transformerEnd.endNumber}`]);
                 cimModel.addPhaseTapChangerLinear(phaseTapChangerLinear);
                 phaseTapChanger = phaseTapChangerLinear;
             }
         }
+        // Attribute
         phaseTapChanger.ltcFlag = false;
         phaseTapChanger.lowStep = i7Data[`minstufe_s${transformerEnd.endNumber}`];
         phaseTapChanger.highStep = i7Data[`maxstufe_s${transformerEnd.endNumber}`];
@@ -716,14 +878,24 @@ function createPhaseTapChanger(i7Data, transformerEnd, cimModel, neutralU, trafo
         phaseTapChanger.neutralU = neutralU;
         transformerEnd.phaseTapChanger = phaseTapChanger;
         phaseTapChanger.transformerEndUUID = transformerEnd.mrid;
+        // Ist die Regelungung aktiv?
+        // wenn ja, welche Art=
         const regelung = +i7Data[`regelung_s${transformerEnd.endNumber}`];
         if (regelung > 0) {
+            /** Ausprägungen
+             * 0 -> keine automatische Stufung
+             * 1 -> Spannungsbetragsregelung
+             * 2 -> Wirkflussvorgabe
+             * 3 -> Stromkompoundierung ->  stromabhängige Spannungsregelung
+             * 4 -> Blindleitungsbilazierung
+             * */
             const tapChangerControl = new __1.TapChangerControl((0, __1.generateUUID)(), `${transformerEnd.name} W_${transformerEnd.endNumber}`);
             tapChangerControl.discrete = true;
+            /** TODO usoll, umin, umax bestimmen -> Anschlusskoten bestimmen (ssab oder abzweigknoten) */
             const umax = getSpannungsband('umax', knotenSpannungsband, neutralU);
             const umin = getSpannungsband('umin', knotenSpannungsband, neutralU);
             const usoll = getSpannungsband('usoll', knotenSpannungsband, (umax + umin) / 2);
-            const pVorgabe = isNumericI7(i7Data[`p_vorgabe`]) ? +i7Data[`p_vorgabe`] : undefined;
+            const pVorgabe = isNumericI7(i7Data[`p_vorgabe`]) ? +i7Data[`p_vorgabe`] : undefined; // PST Trafo
             switch (regelung) {
                 case 1: {
                     phaseTapChanger.controlEnabled = true;
@@ -739,6 +911,7 @@ function createPhaseTapChanger(i7Data, transformerEnd, cimModel, neutralU, trafo
                     tapChangerControl.enabled = true;
                     tapChangerControl.mode = __1.RegulatingControlModeKind.activePower;
                     tapChangerControl.targetValue = pVorgabe;
+                    // TODO targetDeadband
                     tapChangerControl.targetValueUnitMultiplier = __1.UnitMultiplier.M;
                     break;
                 }
@@ -746,16 +919,23 @@ function createPhaseTapChanger(i7Data, transformerEnd, cimModel, neutralU, trafo
                     phaseTapChanger.controlEnabled = true;
                     tapChangerControl.enabled = true;
                     tapChangerControl.mode = __1.RegulatingControlModeKind.currentFlow;
+                    // TODO targetDeadband
+                    // TODO targetValue
+                    // TODO targetValueUnitMultiplier
                     break;
                 }
                 case 4: {
                     phaseTapChanger.controlEnabled = true;
                     tapChangerControl.enabled = true;
                     tapChangerControl.mode = __1.RegulatingControlModeKind.reactivePower;
+                    // TODO targetDeadband
+                    // TODO targetValue
+                    // TODO targetValueUnitMultiplier
                     tapChangerControl.targetValueUnitMultiplier = __1.UnitMultiplier.M;
                     break;
                 }
             }
+            // Assoziationen
             phaseTapChanger.tapChangerControl = tapChangerControl;
             tapChangerControl.addTapChanger(phaseTapChanger);
             cimModel.addTapChangerControl(tapChangerControl);
@@ -763,6 +943,14 @@ function createPhaseTapChanger(i7Data, transformerEnd, cimModel, neutralU, trafo
         else {
             phaseTapChanger.controlEnabled = false;
         }
+        // Spannungsgeregelter Anschluss
+        /**
+         * 0 - obere Spannungsseite (Anschluss 1)
+         * 1 - mittlere Spannungsseite (Anschluss 2)
+         * 2 - Niederspannungsseite (Anschluss 3)
+         * 3 - Externer Knoten
+         * */
+        /** Normieren auf die Wicklungsnummer, da 0 neben 1 obere Spannungsseite angibt */
         const terminal = knotenSpannungsband ? knotenSpannungsband.terminals.find(term => term.connected !== false) : undefined;
         if (terminal) {
             setTapChangerControl(phaseTapChanger, terminal.uuid);
@@ -772,8 +960,13 @@ function createPhaseTapChanger(i7Data, transformerEnd, cimModel, neutralU, trafo
                 transformerEnd.phaseTapChanger.tapChangerControl = undefined;
                 transformerEnd.phaseTapChanger.tapChangerControlUUID = undefined;
             }
+            // Phase
             console.log();
         }
+        //SV Profil: Aktuelle Stufenstellung
+        /*    const svTapStep = new SvTapStep(generateUUID(), i7TapArray.indexOf(currentStep) + 1, ratioTapChanger);
+            ratioTapChanger.svTapStepUUID = svTapStep.mrid;
+            cimModel.addSvTapStep(svTapStep);*/
     }
 }
 exports.createPhaseTapChanger = createPhaseTapChanger;
@@ -806,6 +999,7 @@ function getActiveReactivePower(i7Data, mf) {
     if (i7Data.guid === "_11efd627-73db-4762-8b97-4eea4d09c745") {
         let stop = true;
     }
+    //TODO: Ticket bei INTEGRAL erstellen und erfragen, wie die Priorisierung bei der Anwendung der MF und p0, q0, s0, cosphi ist.
     const flagInd = i7Data.flag_ind;
     let s0 = isNumericI7(i7Data.s0) ? convertToNumberI7(i7Data.s0) : undefined;
     const p0 = isNumericI7(i7Data.p0) ? convertToNumberI7(i7Data.p0) : undefined;
@@ -821,6 +1015,7 @@ function getActiveReactivePower(i7Data, mf) {
     let reactivePower = undefined;
     let reactivePowerMf = undefined;
     if (isNumericI7(p0) && !isNumericI7(q0Ind) && !isNumericI7(q0Kap) && !isNumericI7(s0) && !isNumericI7(cosPhi)) {
+        //Only p0 is given.
         activePower = p0;
         reactivePower = 0;
         activePowerMf = activePower * mf_p;
@@ -854,7 +1049,7 @@ function getActiveReactivePower(i7Data, mf) {
         reactivePower = (convertToBooleanI7(i7Data.flag_ind) || convertToBooleanI7(i7Data.flag_ind) === undefined) ? q0 : q0 * -1;
         if (mf) {
             activePowerMf = activePower * mf_p;
-            reactivePowerMf = reactivePower * mf_p;
+            reactivePowerMf = reactivePower * mf_p; //If p0 and cosphi is given then reactive power is directly proportional to mf_p.
         }
     }
     else if (isNumericI7(p0) && isNumericI7(q0Ind) && isNumericI7(q0Kap)) {
@@ -925,6 +1120,7 @@ function getActiveReactivePower(i7Data, mf) {
         activePower = (reactivePower) / (Math.sqrt(1 / cosPhi - 1));
         activePowerMf = activePowerMf * mf_p;
     }
+    //Overwrite values for reactivePower, in case of mfcosPhiInd of mf.cosPhiKap is given.
     if (mf && (mf.cosPhiInd || mf.cosPhiKap)) {
         if (mf.cosPhiInd && mf.cosPhiKap) {
             const inductiveReactivePowerMf = Math.sqrt((Math.pow(activePowerMf, 2) - Math.pow(activePowerMf * mf.cosPhiInd, 2)) / Math.pow(mf.cosPhiInd, 2));
@@ -932,9 +1128,11 @@ function getActiveReactivePower(i7Data, mf) {
             reactivePowerMf = inductiveReactivePowerMf - capacitivereactivePowerMf;
         }
         else if (mf.cosPhiInd) {
+            //compute inductive reactive power
             reactivePowerMf = Math.sqrt((Math.pow(activePowerMf, 2) - Math.pow(activePowerMf * mf.cosPhiInd, 2)) / Math.pow(mf.cosPhiInd, 2));
         }
         else if (mf.cosPhiKap) {
+            //compute capacitive reactive power
             reactivePowerMf = -1 * Math.sqrt((Math.pow(activePowerMf, 2) - Math.pow(activePowerMf * mf.cosPhiKap, 2)) / Math.pow(mf.cosPhiKap, 2));
         }
     }
@@ -978,12 +1176,13 @@ function generateFuelType(name, type, generatingUnit, cimModel) {
             fossilFuel.fossilFuelType = __1.FuelType.gas;
             break;
     }
+    // generatingUnit.addFossilFuel(fossilFuel);
     fossilFuel.thermalGeneratingUnit = generatingUnit;
     cimModel.addFossilFuel(fossilFuel);
 }
 exports.generateFuelType = generateFuelType;
 function writeFile(filePath, data) {
-    fs_1.default.writeFile(filePath, (typeof data === 'string') ? data : JSON.stringify(data), function (err) {
+    fs.writeFile(filePath, (typeof data === 'string') ? data : JSON.stringify(data), function (err) {
         if (err) {
             this.logger.info(err);
         }
@@ -1013,8 +1212,10 @@ exports.generateNodeStream = generateNodeStream;
 function writeZipFile(data, path) {
     return new Promise((resolve, reject) => {
         try {
-            data.pipe(fs_1.default.createWriteStream(path))
+            data.pipe(fs.createWriteStream(path))
                 .on('finish', function () {
+                // JSZip generates a readable stream with a "end" event,
+                // but is piped here in a writable stream which emits a "finish" event.
                 resolve({ status: 'successful', message: 'ok' });
             });
         }
@@ -1024,6 +1225,24 @@ function writeZipFile(data, path) {
     });
 }
 exports.writeZipFile = writeZipFile;
+/*export function writeZipFile(zip: JSZip, path: string): Promise<any> {
+  return new Promise((resolve, reject) => {
+    try {
+      zip
+        .generateNodeStream({type: 'nodebuffer', streamFiles: true})
+        .pipe(fs.createWriteStream(path))
+        .on('finish', function () {
+          // JSZip generates a readable stream with a "end" event,
+          // but is piped here in a writable stream which emits a "finish" event.
+          resolve();
+        });
+    } catch (e) {
+
+    }
+
+  });
+}*/
+/** Integral 7 Exporter */
 function getSchemaValue(variantenNr, schemaId, map) {
     for (const entry of map.entries()) {
         if (entry[0].variantenNr === variantenNr && entry[0].schemaId === schemaId) {
@@ -1060,7 +1279,7 @@ function determineEquipmentContainer(equipmentContainerType, equipmentContainer,
         case ('Substation'): {
             if (equipmentContainer instanceof __1.Bay) {
                 const voltageLevel = equipmentContainer.getVoltageLevel();
-                const subst_uuid = voltageLevel === null || voltageLevel === void 0 ? void 0 : voltageLevel.getSubstationUUID();
+                const subst_uuid = voltageLevel?.getSubstationUUID();
                 ret_val = cimModel.getObject(subst_uuid);
             }
             else if (equipmentContainer instanceof __1.VoltageLevel) {
@@ -1078,21 +1297,19 @@ function determineEquipmentContainer(equipmentContainerType, equipmentContainer,
     return ret_val;
 }
 exports.determineEquipmentContainer = determineEquipmentContainer;
-function createTempDirPath() {
-    return tslib_1.__awaiter(this, void 0, void 0, function* () {
-        const fs = require('fs');
-        const os = require('os');
-        const path = require('path');
-        return new Promise((resolve, reject) => {
-            const tempPath = path.join(os.tmpdir(), 'i7-');
-            fs.mkdtemp(tempPath, (err, folder) => {
-                if (err) {
-                    reject(err);
-                }
-                else {
-                    resolve(folder);
-                }
-            });
+async function createTempDirPath() {
+    const fs = require('fs');
+    const os = require('os');
+    const path = require('path');
+    return new Promise((resolve, reject) => {
+        const tempPath = path.join(os.tmpdir(), 'i7-');
+        fs.mkdtemp(tempPath, (err, folder) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve(folder);
+            }
         });
     });
 }
@@ -1125,14 +1342,12 @@ function getPSRType(cimModel, name) {
     return psrType;
 }
 exports.getPSRType = getPSRType;
-function createWriteStreamPromise(writeStream) {
-    return tslib_1.__awaiter(this, void 0, void 0, function* () {
-        return new Promise((resolve, reject) => {
-            writeStream.end();
-            writeStream.close();
-            writeStream.on('close', () => tslib_1.__awaiter(this, void 0, void 0, function* () {
-                resolve({ status: 'successful', message: 'ok' });
-            }));
+async function createWriteStreamPromise(writeStream) {
+    return new Promise((resolve, reject) => {
+        writeStream.end();
+        writeStream.close();
+        writeStream.on('close', async () => {
+            resolve({ status: 'successful', message: 'ok' });
         });
     });
 }