DPsim
Loading...
Searching...
No Matches
DPComponents.cpp
1/* Copyright 2017-2021 Institute for Automation of Complex Power Systems,
2 * EONERC, RWTH Aachen University
3 *
4 * This Source Code Form is subject to the terms of the Mozilla Public
5 * License, v. 2.0. If a copy of the MPL was not distributed with this
6 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
7 *********************************************************************************/
8
9#include <DPsim.h>
10#include <dpsim-models/CSVReader.h>
11#include <dpsim-models/IdentifiedObject.h>
12#include <dpsim/RealTimeSimulation.h>
13#include <dpsim/Simulation.h>
14#include <dpsim/pybind/DPComponents.h>
15#include <dpsim/pybind/Utils.h>
16
17namespace py = pybind11;
18using namespace pybind11::literals;
19
20void addDPComponents(py::module_ mDP) {
21 py::class_<CPS::DP::SimNode, std::shared_ptr<CPS::DP::SimNode>,
22 CPS::TopologicalNode>(mDP, "SimNode", py::module_local())
23 .def(py::init<std::string>())
24 .def(py::init<std::string, CPS::PhaseType>())
25 .def(py::init<std::string, CPS::PhaseType,
26 const std::vector<CPS::Complex>>())
27 .def("set_initial_voltage",
28 py::overload_cast<CPS::MatrixComp>(
29 &CPS::DP::SimNode::setInitialVoltage, py::const_))
30 .def("set_initial_voltage",
31 py::overload_cast<CPS::Complex>(&CPS::DP::SimNode::setInitialVoltage,
32 py::const_))
33 .def("set_initial_voltage",
34 py::overload_cast<CPS::Complex, int>(
35 &CPS::DP::SimNode::setInitialVoltage, py::const_))
36 .def("single_voltage", &CPS::DP::SimNode::singleVoltage,
37 "phase_type"_a = CPS::PhaseType::Single)
38 .def_readonly_static("gnd", &CPS::DP::SimNode::GND);
39
40 py::module mDPPh1 =
41 mDP.def_submodule("ph1", "single phase dynamic phasor models");
42 addDPPh1Components(mDPPh1);
43
44 py::module mDPPh3 =
45 mDP.def_submodule("ph3", "triple phase dynamic phasor models");
46 addDPPh3Components(mDPPh3);
47}
48
49void addDPPh1Components(py::module_ mDPPh1) {
50 py::class_<CPS::DP::Ph1::VoltageSource,
51 std::shared_ptr<CPS::DP::Ph1::VoltageSource>,
52 CPS::SimPowerComp<CPS::Complex>>(mDPPh1, "VoltageSource",
53 py::multiple_inheritance())
54 .def(py::init<std::string>())
55 .def(py::init<std::string, CPS::Logger::Level>())
56 .def("set_parameters",
57 py::overload_cast<CPS::Complex, CPS::Real>(
58 &CPS::DP::Ph1::VoltageSource::setParameters),
59 "V_ref"_a, "f_src"_a = 0)
60 .def("connect", &CPS::DP::Ph1::VoltageSource::connect)
61 .def_property("V_ref", createAttributeGetter<CPS::Complex>("V_ref"),
62 createAttributeSetter<CPS::Complex>("V_ref"))
63 .def_property("f_src", createAttributeGetter<CPS::Real>("f_src"),
64 createAttributeSetter<CPS::Real>("f_src"));
65
66 py::class_<CPS::DP::Ph1::VoltageSourceNorton,
67 std::shared_ptr<CPS::DP::Ph1::VoltageSourceNorton>,
68 CPS::SimPowerComp<CPS::Complex>>(mDPPh1, "VoltageSourceNorton",
69 py::multiple_inheritance())
70 .def(py::init<std::string>())
71 .def(py::init<std::string, CPS::Logger::Level>())
72 .def("set_parameters",
73 py::overload_cast<CPS::Complex, CPS::Real>(
74 &CPS::DP::Ph1::VoltageSourceNorton::setParameters),
75 "V_ref"_a, "f_src"_a = -1)
76 .def("connect", &CPS::DP::Ph1::VoltageSourceNorton::connect);
77
78 py::class_<CPS::DP::Ph1::CurrentSource,
79 std::shared_ptr<CPS::DP::Ph1::CurrentSource>,
80 CPS::SimPowerComp<CPS::Complex>>(mDPPh1, "CurrentSource",
81 py::multiple_inheritance())
82 .def(py::init<std::string>())
83 .def(py::init<std::string, CPS::Logger::Level>())
84 .def("set_parameters", &CPS::DP::Ph1::CurrentSource::setParameters,
85 "I_ref"_a)
86 .def("connect", &CPS::DP::Ph1::CurrentSource::connect)
87 .def_property("I_ref", createAttributeGetter<CPS::Complex>("I_ref"),
88 createAttributeSetter<CPS::Complex>("I_ref"));
89
90 py::class_<CPS::DP::Ph1::Resistor, std::shared_ptr<CPS::DP::Ph1::Resistor>,
91 CPS::SimPowerComp<CPS::Complex>>(mDPPh1, "Resistor",
92 py::multiple_inheritance())
93 .def(py::init<std::string>())
94 .def(py::init<std::string, CPS::Logger::Level>())
95 .def("set_parameters", &CPS::DP::Ph1::Resistor::setParameters, "R"_a)
96 .def("connect", &CPS::DP::Ph1::Resistor::connect)
97 .def_property("R", createAttributeGetter<CPS::Real>("R"),
98 createAttributeSetter<CPS::Real>("R"));
99
100 py::class_<CPS::DP::Ph1::Capacitor, std::shared_ptr<CPS::DP::Ph1::Capacitor>,
101 CPS::SimPowerComp<CPS::Complex>>(mDPPh1, "Capacitor",
102 py::multiple_inheritance())
103 .def(py::init<std::string>())
104 .def(py::init<std::string, CPS::Logger::Level>())
105 .def("set_parameters", &CPS::DP::Ph1::Capacitor::setParameters, "C"_a)
106 .def("connect", &CPS::DP::Ph1::Capacitor::connect)
107 .def_property("C", createAttributeGetter<CPS::Real>("C"),
108 createAttributeSetter<CPS::Real>("C"));
109
110 py::class_<CPS::DP::Ph1::Inductor, std::shared_ptr<CPS::DP::Ph1::Inductor>,
111 CPS::SimPowerComp<CPS::Complex>>(mDPPh1, "Inductor",
112 py::multiple_inheritance())
113 .def(py::init<std::string>())
114 .def(py::init<std::string, CPS::Logger::Level>())
115 .def("set_parameters", &CPS::DP::Ph1::Inductor::setParameters, "L"_a)
116 .def("connect", &CPS::DP::Ph1::Inductor::connect)
117 .def_property("L", createAttributeGetter<CPS::Real>("L"),
118 createAttributeSetter<CPS::Real>("L"));
119
120 py::class_<CPS::DP::Ph1::NetworkInjection,
121 std::shared_ptr<CPS::DP::Ph1::NetworkInjection>,
122 CPS::SimPowerComp<CPS::Complex>>(mDPPh1, "NetworkInjection",
123 py::multiple_inheritance())
124 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
125 "loglevel"_a = CPS::Logger::Level::off)
126 .def("set_parameters",
127 py::overload_cast<CPS::Complex, CPS::Real>(
128 &CPS::DP::Ph1::NetworkInjection::setParameters),
129 "V_ref"_a, "f_src"_a = 0)
130 .def("connect", &CPS::DP::Ph1::NetworkInjection::connect);
131
132 py::class_<CPS::DP::Ph1::PiLine, std::shared_ptr<CPS::DP::Ph1::PiLine>,
133 CPS::SimPowerComp<CPS::Complex>>(mDPPh1, "PiLine",
134 py::multiple_inheritance())
135 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
136 "loglevel"_a = CPS::Logger::Level::off)
137 .def("set_parameters", &CPS::DP::Ph1::PiLine::setParameters,
138 "series_resistance"_a, "series_inductance"_a,
139 "parallel_capacitance"_a = 0, "parallel_conductance"_a = 0)
140 .def("connect", &CPS::DP::Ph1::PiLine::connect);
141
142 py::class_<CPS::DP::Ph1::RXLoad, std::shared_ptr<CPS::DP::Ph1::RXLoad>,
143 CPS::SimPowerComp<CPS::Complex>>(mDPPh1, "RXLoad",
144 py::multiple_inheritance())
145 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
146 "loglevel"_a = CPS::Logger::Level::off)
147 .def("set_parameters", &CPS::DP::Ph1::RXLoad::setParameters,
148 "active_power"_a, "reactive_power"_a, "volt"_a)
149 .def("connect", &CPS::DP::Ph1::RXLoad::connect);
150
151 py::class_<CPS::DP::Ph1::Switch, std::shared_ptr<CPS::DP::Ph1::Switch>,
152 CPS::SimPowerComp<CPS::Complex>, CPS::Base::Ph1::Switch>(
153 mDPPh1, "Switch", py::multiple_inheritance())
154 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
155 "loglevel"_a = CPS::Logger::Level::off)
156 .def("set_parameters", &CPS::DP::Ph1::Switch::setParameters,
157 "open_resistance"_a, "closed_resistance"_a,
158 // cppcheck-suppress assignBoolToPointer
159 "closed"_a = false)
160 .def("open", &CPS::DP::Ph1::Switch::open)
161 .def("close", &CPS::DP::Ph1::Switch::close)
162 .def("connect", &CPS::DP::Ph1::Switch::connect);
163
164 py::class_<CPS::DP::Ph1::varResSwitch,
165 std::shared_ptr<CPS::DP::Ph1::varResSwitch>,
166 CPS::SimPowerComp<CPS::Complex>, CPS::Base::Ph1::Switch>(
167 mDPPh1, "varResSwitch", py::multiple_inheritance())
168 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
169 "loglevel"_a = CPS::Logger::Level::off)
170 .def("set_parameters", &CPS::DP::Ph1::varResSwitch::setParameters,
171 "open_resistance"_a, "closed_resistance"_a,
172 // cppcheck-suppress assignBoolToPointer
173 "closed"_a = false)
174 .def("open", &CPS::DP::Ph1::varResSwitch::open)
175 .def("close", &CPS::DP::Ph1::varResSwitch::close)
176 .def("set_init_parameters",
177 &CPS::DP::Ph1::varResSwitch::setInitParameters, "time_step"_a)
178 .def("connect", &CPS::DP::Ph1::varResSwitch::connect);
179
180 py::class_<CPS::DP::Ph1::SynchronGeneratorTrStab,
181 std::shared_ptr<CPS::DP::Ph1::SynchronGeneratorTrStab>,
182 CPS::SimPowerComp<CPS::Complex>>(mDPPh1, "SynchronGeneratorTrStab",
183 py::multiple_inheritance())
184 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
185 "loglevel"_a = CPS::Logger::Level::off)
186 .def("set_standard_parameters_PU",
187 &CPS::DP::Ph1::SynchronGeneratorTrStab::setStandardParametersPU,
188 "nom_power"_a, "nom_volt"_a, "nom_freq"_a, "Xpd"_a, "inertia"_a,
189 "Rs"_a = 0, "D"_a = 0)
190 .def("set_fundamental_parameters_PU",
191 &CPS::DP::Ph1::SynchronGeneratorTrStab::setFundamentalParametersPU,
192 "nom_power"_a, "nom_volt"_a, "nom_freq"_a, "Ll"_a, "Lmd"_a, "Llfd"_a,
193 "H"_a, "D"_a = 0)
194 .def("set_initial_values",
195 &CPS::DP::Ph1::SynchronGeneratorTrStab::setInitialValues,
196 "elec_power"_a, "mech_power"_a)
197 .def("connect", &CPS::DP::Ph1::SynchronGeneratorTrStab::connect)
198 .def("set_model_flags",
199 &CPS::DP::Ph1::SynchronGeneratorTrStab::setModelFlags,
200 "convert_with_omega_mech"_a)
201 .def(
202 "set_reference_omega",
203 [](CPS::DP::Ph1::SynchronGeneratorTrStab &gen,
204 std::string refOmegaName, CPS::IdentifiedObject::Ptr refOmegaComp,
205 std::string refDeltaName,
206 CPS::IdentifiedObject::Ptr refDeltaComp) {
207 gen.setReferenceOmega(
208 refOmegaComp->attributeTyped<CPS::Real>(refOmegaName),
209 refDeltaComp->attributeTyped<CPS::Real>(refDeltaName));
210 },
211 "ref_omega_name"_a = "w_r", "ref_omage_comp"_a,
212 "ref_delta_name"_a = "delta_r", "ref_delta_comp"_a);
213
214 py::class_<CPS::DP::Ph1::ReducedOrderSynchronGeneratorVBR,
215 std::shared_ptr<CPS::DP::Ph1::ReducedOrderSynchronGeneratorVBR>,
216 CPS::Base::ReducedOrderSynchronGenerator<CPS::Complex>>(
217 mDPPh1, "ReducedOrderSynchronGeneratorVBR", py::multiple_inheritance());
218
219 py::class_<CPS::DP::Ph1::SynchronGenerator3OrderVBR,
220 std::shared_ptr<CPS::DP::Ph1::SynchronGenerator3OrderVBR>,
221 CPS::DP::Ph1::ReducedOrderSynchronGeneratorVBR>(
222 mDPPh1, "SynchronGenerator3OrderVBR", py::multiple_inheritance())
223 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
224 "loglevel"_a = CPS::Logger::Level::off)
225 .def("set_operational_parameters_per_unit",
226 py::overload_cast<CPS::Real, CPS::Real, CPS::Real, CPS::Real,
227 CPS::Real, CPS::Real, CPS::Real, CPS::Real,
228 CPS::Real>(
229 &CPS::DP::Ph1::SynchronGenerator3OrderVBR::
230 setOperationalParametersPerUnit),
231 "nom_power"_a, "nom_voltage"_a, "nom_frequency"_a, "H"_a, "Ld"_a,
232 "Lq"_a, "L0"_a, "Ld_t"_a, "Td0_t"_a)
233 .def("connect", &CPS::DP::Ph1::SynchronGenerator3OrderVBR::connect);
234
235 py::class_<CPS::DP::Ph1::SynchronGenerator4OrderVBR,
236 std::shared_ptr<CPS::DP::Ph1::SynchronGenerator4OrderVBR>,
237 CPS::DP::Ph1::ReducedOrderSynchronGeneratorVBR>(
238 mDPPh1, "SynchronGenerator4OrderVBR", py::multiple_inheritance())
239 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
240 "loglevel"_a = CPS::Logger::Level::off)
241 .def("set_operational_parameters_per_unit",
242 py::overload_cast<CPS::Real, CPS::Real, CPS::Real, CPS::Real,
243 CPS::Real, CPS::Real, CPS::Real, CPS::Real,
244 CPS::Real, CPS::Real, CPS::Real>(
245 &CPS::DP::Ph1::SynchronGenerator4OrderVBR::
246 setOperationalParametersPerUnit),
247 "nom_power"_a, "nom_voltage"_a, "nom_frequency"_a, "H"_a, "Ld"_a,
248 "Lq"_a, "L0"_a, "Ld_t"_a, "Lq_t"_a, "Td0_t"_a, "Tq0_t"_a)
249 .def("connect", &CPS::DP::Ph1::SynchronGenerator4OrderVBR::connect);
250
251 py::class_<CPS::DP::Ph1::SynchronGenerator5OrderVBR,
252 std::shared_ptr<CPS::DP::Ph1::SynchronGenerator5OrderVBR>,
253 CPS::DP::Ph1::ReducedOrderSynchronGeneratorVBR>(
254 mDPPh1, "SynchronGenerator5OrderVBR", py::multiple_inheritance())
255 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
256 "loglevel"_a = CPS::Logger::Level::off)
257 .def("set_operational_parameters_per_unit",
258 py::overload_cast<CPS::Real, CPS::Real, CPS::Real, CPS::Real,
259 CPS::Real, CPS::Real, CPS::Real, CPS::Real,
260 CPS::Real, CPS::Real, CPS::Real, CPS::Real,
261 CPS::Real, CPS::Real, CPS::Real, CPS::Real>(
262 &CPS::DP::Ph1::SynchronGenerator5OrderVBR::
263 setOperationalParametersPerUnit),
264 "nom_power"_a, "nom_voltage"_a, "nom_frequency"_a, "H"_a, "Ld"_a,
265 "Lq"_a, "L0"_a, "Ld_t"_a, "Lq_t"_a, "Td0_t"_a, "Tq0_t"_a, "Ld_s"_a,
266 "Lq_s"_a, "Td0_s"_a, "Tq0_s"_a, "Taa"_a)
267 .def("connect", &CPS::DP::Ph1::SynchronGenerator5OrderVBR::connect);
268
269 py::class_<CPS::DP::Ph1::SynchronGenerator6aOrderVBR,
270 std::shared_ptr<CPS::DP::Ph1::SynchronGenerator6aOrderVBR>,
271 CPS::DP::Ph1::ReducedOrderSynchronGeneratorVBR>(
272 mDPPh1, "SynchronGenerator6aOrderVBR", py::multiple_inheritance())
273 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
274 "loglevel"_a = CPS::Logger::Level::off)
275 .def("set_operational_parameters_per_unit",
276 py::overload_cast<CPS::Real, CPS::Real, CPS::Real, CPS::Real,
277 CPS::Real, CPS::Real, CPS::Real, CPS::Real,
278 CPS::Real, CPS::Real, CPS::Real, CPS::Real,
279 CPS::Real, CPS::Real, CPS::Real, CPS::Real>(
280 &CPS::DP::Ph1::SynchronGenerator6aOrderVBR::
281 setOperationalParametersPerUnit),
282 "nom_power"_a, "nom_voltage"_a, "nom_frequency"_a, "H"_a, "Ld"_a,
283 "Lq"_a, "L0"_a, "Ld_t"_a, "Lq_t"_a, "Td0_t"_a, "Tq0_t"_a, "Ld_s"_a,
284 "Lq_s"_a, "Td0_s"_a, "Tq0_s"_a, "Taa"_a)
285 .def("connect", &CPS::DP::Ph1::SynchronGenerator6aOrderVBR::connect);
286
287 py::class_<CPS::DP::Ph1::SynchronGenerator6bOrderVBR,
288 std::shared_ptr<CPS::DP::Ph1::SynchronGenerator6bOrderVBR>,
289 CPS::DP::Ph1::ReducedOrderSynchronGeneratorVBR>(
290 mDPPh1, "SynchronGenerator6bOrderVBR", py::multiple_inheritance())
291 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
292 "loglevel"_a = CPS::Logger::Level::off)
293 .def("set_operational_parameters_per_unit",
294 py::overload_cast<CPS::Real, CPS::Real, CPS::Real, CPS::Real,
295 CPS::Real, CPS::Real, CPS::Real, CPS::Real,
296 CPS::Real, CPS::Real, CPS::Real, CPS::Real,
297 CPS::Real, CPS::Real, CPS::Real, CPS::Real>(
298 &CPS::DP::Ph1::SynchronGenerator6bOrderVBR::
299 setOperationalParametersPerUnit),
300 "nom_power"_a, "nom_voltage"_a, "nom_frequency"_a, "H"_a, "Ld"_a,
301 "Lq"_a, "L0"_a, "Ld_t"_a, "Lq_t"_a, "Td0_t"_a, "Tq0_t"_a, "Ld_s"_a,
302 "Lq_s"_a, "Td0_s"_a, "Tq0_s"_a, "Taa"_a = 0)
303 .def("connect", &CPS::DP::Ph1::SynchronGenerator6bOrderVBR::connect);
304
305 py::class_<CPS::DP::Ph1::SynchronGenerator4OrderTPM,
306 std::shared_ptr<CPS::DP::Ph1::SynchronGenerator4OrderTPM>,
307 CPS::Base::ReducedOrderSynchronGenerator<CPS::Complex>,
308 CPS::MNASyncGenInterface>(mDPPh1, "SynchronGenerator4OrderTPM",
309 py::multiple_inheritance())
310 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
311 "loglevel"_a = CPS::Logger::Level::off)
312 .def("set_operational_parameters_per_unit",
313 py::overload_cast<CPS::Real, CPS::Real, CPS::Real, CPS::Real,
314 CPS::Real, CPS::Real, CPS::Real, CPS::Real,
315 CPS::Real, CPS::Real, CPS::Real>(
316 &CPS::DP::Ph1::SynchronGenerator4OrderTPM::
317 setOperationalParametersPerUnit),
318 "nom_power"_a, "nom_voltage"_a, "nom_frequency"_a, "H"_a, "Ld"_a,
319 "Lq"_a, "L0"_a, "Ld_t"_a, "Lq_t"_a, "Td0_t"_a, "Tq0_t"_a)
320 .def("connect", &CPS::DP::Ph1::SynchronGenerator4OrderTPM::connect);
321
322 py::class_<CPS::DP::Ph1::SynchronGenerator4OrderPCM,
323 std::shared_ptr<CPS::DP::Ph1::SynchronGenerator4OrderPCM>,
324 CPS::Base::ReducedOrderSynchronGenerator<CPS::Complex>,
325 CPS::MNASyncGenInterface>(mDPPh1, "SynchronGenerator4OrderPCM",
326 py::multiple_inheritance())
327 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
328 "loglevel"_a = CPS::Logger::Level::off)
329 .def("set_operational_parameters_per_unit",
330 py::overload_cast<CPS::Real, CPS::Real, CPS::Real, CPS::Real,
331 CPS::Real, CPS::Real, CPS::Real, CPS::Real,
332 CPS::Real, CPS::Real, CPS::Real>(
333 &CPS::DP::Ph1::SynchronGenerator4OrderPCM::
334 setOperationalParametersPerUnit),
335 "nom_power"_a, "nom_voltage"_a, "nom_frequency"_a, "H"_a, "Ld"_a,
336 "Lq"_a, "L0"_a, "Ld_t"_a, "Lq_t"_a, "Td0_t"_a, "Tq0_t"_a)
337 .def("connect", &CPS::DP::Ph1::SynchronGenerator4OrderPCM::connect);
338
339 py::class_<CPS::DP::Ph1::SynchronGenerator6OrderPCM,
340 std::shared_ptr<CPS::DP::Ph1::SynchronGenerator6OrderPCM>,
341 CPS::Base::ReducedOrderSynchronGenerator<CPS::Complex>,
342 CPS::MNASyncGenInterface>(mDPPh1, "SynchronGenerator6OrderPCM",
343 py::multiple_inheritance())
344 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
345 "loglevel"_a = CPS::Logger::Level::off)
346 .def("set_operational_parameters_per_unit",
347 py::overload_cast<CPS::Real, CPS::Real, CPS::Real, CPS::Real,
348 CPS::Real, CPS::Real, CPS::Real, CPS::Real,
349 CPS::Real, CPS::Real, CPS::Real, CPS::Real,
350 CPS::Real, CPS::Real, CPS::Real, CPS::Real>(
351 &CPS::DP::Ph1::SynchronGenerator6OrderPCM::
352 setOperationalParametersPerUnit),
353 "nom_power"_a, "nom_voltage"_a, "nom_frequency"_a, "H"_a, "Ld"_a,
354 "Lq"_a, "L0"_a, "Ld_t"_a, "Lq_t"_a, "Td0_t"_a, "Tq0_t"_a, "Ld_s"_a,
355 "Lq_s"_a, "Td0_s"_a, "Tq0_s"_a, "Taa"_a = 0)
356 .def("connect", &CPS::DP::Ph1::SynchronGenerator6OrderPCM::connect);
357
358 py::class_<CPS::DP::Ph1::AvVoltageSourceInverterDQ,
359 std::shared_ptr<CPS::DP::Ph1::AvVoltageSourceInverterDQ>,
360 CPS::SimPowerComp<CPS::Complex>>(
361 mDPPh1, "AvVoltageSourceInverterDQ", py::multiple_inheritance())
362 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
363 "loglevel"_a = CPS::Logger::Level::off)
364 .def(py::init<std::string, std::string, CPS::Logger::Level, CPS::Bool>(),
365 "uid"_a, "name"_a, "loglevel"_a = CPS::Logger::Level::off,
366 // cppcheck-suppress assignBoolToPointer
367 "with_trafo"_a = false)
368 .def("set_parameters",
369 &CPS::DP::Ph1::AvVoltageSourceInverterDQ::setParameters,
370 "sys_omega"_a, "sys_volt_nom"_a, "p_ref"_a, "q_ref"_a)
371 .def("set_filter_parameters",
372 &CPS::DP::Ph1::AvVoltageSourceInverterDQ::setFilterParameters,
373 "Lf"_a, "Cf"_a, "Rf"_a, "Rc"_a)
374 .def("set_controller_parameters",
375 &CPS::DP::Ph1::AvVoltageSourceInverterDQ::setControllerParameters,
376 "Kp_pll"_a, "Ki_pll"_a, "Kp_power_ctrl"_a, "Ki_power_ctrl"_a,
377 "Kp_curr_ctrl"_a, "Ki_curr_ctrl"_a, "omega_cutoff"_a)
378 .def("set_transformer_parameters",
379 &CPS::DP::Ph1::AvVoltageSourceInverterDQ::setTransformerParameters,
380 "nom_voltage_end_1"_a, "nom_voltage_end_2"_a, "rated_power"_a,
381 "ratio_abs"_a, "ratio_phase"_a, "resistance"_a, "inductance"_a)
382 .def("set_initial_state_values",
383 &CPS::DP::Ph1::AvVoltageSourceInverterDQ::setInitialStateValues,
384 "p_init"_a, "q_init"_a, "phi_d_init"_a, "phi_q_init"_a,
385 "gamma_d_init"_a, "gamma_q_init"_a)
386 .def("with_control",
387 &CPS::DP::Ph1::AvVoltageSourceInverterDQ::withControl)
388 .def("connect", &CPS::DP::Ph1::AvVoltageSourceInverterDQ::connect);
389
390 py::class_<CPS::DP::Ph1::Inverter, std::shared_ptr<CPS::DP::Ph1::Inverter>,
391 CPS::SimPowerComp<CPS::Complex>>(mDPPh1, "Inverter",
392 py::multiple_inheritance())
393 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
394 "loglevel"_a = CPS::Logger::Level::off)
395 .def("set_parameters", &CPS::DP::Ph1::Inverter::setParameters,
396 "carrier_harms"_a, "modul_harms"_a, "input_voltage"_a, "ratio"_a,
397 "phase"_a)
398 .def("connect", &CPS::DP::Ph1::Inverter::connect);
399
400 py::class_<CPS::DP::Ph1::Transformer,
401 std::shared_ptr<CPS::DP::Ph1::Transformer>,
402 CPS::SimPowerComp<CPS::Complex>>(mDPPh1, "Transformer",
403 py::multiple_inheritance())
404 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
405 "loglevel"_a = CPS::Logger::Level::off)
406 .def(py::init<std::string, std::string, CPS::Logger::Level, CPS::Bool>(),
407 "uid"_a, "name"_a, "loglevel"_a = CPS::Logger::Level::off,
408 // cppcheck-suppress assignBoolToPointer
409 "with_resistive_losses"_a = false)
410 .def("set_parameters",
411 py::overload_cast<CPS::Real, CPS::Real, CPS::Real, CPS::Real,
412 CPS::Real, CPS::Real>(
413 &CPS::DP::Ph1::Transformer::setParameters),
414 "nom_voltage_end_1"_a, "nom_voltage_end_2"_a, "ratio_abs"_a,
415 "ratio_phase"_a, "resistance"_a, "inductance"_a)
416 .def("set_parameters",
417 py::overload_cast<CPS::Real, CPS::Real, CPS::Real, CPS::Real,
418 CPS::Real, CPS::Real, CPS::Real>(
419 &CPS::DP::Ph1::Transformer::setParameters),
420 "nom_voltage_end_1"_a, "nom_voltage_end_2"_a, "rated_power"_a,
421 "ratio_abs"_a, "ratio_phase"_a, "resistance"_a, "inductance"_a)
422 .def("connect", &CPS::DP::Ph1::Transformer::connect);
423}
424
425void addDPPh3Components(py::module_ mDPPh3) {
426
427#ifdef WITH_SUNDIALS
428
429 py::class_<CPS::DP::Ph3::SynchronGeneratorDQODE,
430 std::shared_ptr<CPS::DP::Ph3::SynchronGeneratorDQODE>,
431 CPS::SimPowerComp<CPS::Complex>>(mDPPh3, "SynchronGeneratorDQODE",
432 py::multiple_inheritance())
433 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
434 "loglevel"_a = CPS::Logger::Level::off)
435 .def("set_parameters_fundamental_per_unit",
436 &CPS::DP::Ph3::SynchronGeneratorDQODE::
437 setParametersFundamentalPerUnit,
438 "nom_power"_a, "nom_volt"_a, "nom_freq"_a, "pole_number"_a,
439 "nom_field_cur"_a, "Rs"_a, "Ll"_a, "Lmd"_a, "Lmq"_a, "Rfd"_a,
440 "Llfd"_a, "Rkd"_a, "Llkd"_a, "Rkq1"_a, "Llkq1"_a, "Rkq2"_a,
441 "Llkq2"_a, "inertia"_a, "init_active_power"_a,
442 "init_reactive_power"_a, "init_terminal_volt"_a, "init_volt_angle"_a,
443 "init_mech_power"_a)
444 .def("connect", &CPS::DP::Ph3::SynchronGeneratorDQODE::connect);
445
446#endif
447
448 py::class_<CPS::DP::Ph3::SynchronGeneratorDQTrapez,
449 std::shared_ptr<CPS::DP::Ph3::SynchronGeneratorDQTrapez>,
450 CPS::SimPowerComp<CPS::Complex>>(
451 mDPPh3, "SynchronGeneratorDQTrapez", py::multiple_inheritance())
452 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
453 "loglevel"_a = CPS::Logger::Level::off)
454 .def("set_parameters_fundamental_per_unit",
455 &CPS::DP::Ph3::SynchronGeneratorDQTrapez::
456 setParametersFundamentalPerUnit,
457 "nom_power"_a, "nom_volt"_a, "nom_freq"_a, "pole_number"_a,
458 "nom_field_cur"_a, "Rs"_a, "Ll"_a, "Lmd"_a, "Lmq"_a, "Rfd"_a,
459 "Llfd"_a, "Rkd"_a, "Llkd"_a, "Rkq1"_a, "Llkq1"_a, "Rkq2"_a,
460 "Llkq2"_a, "inertia"_a, "init_active_power"_a,
461 "init_reactive_power"_a, "init_terminal_volt"_a, "init_volt_angle"_a,
462 "init_mech_power"_a)
463 .def("connect", &CPS::DP::Ph3::SynchronGeneratorDQTrapez::connect);
464
465 py::class_<CPS::DP::Ph3::SeriesResistor,
466 std::shared_ptr<CPS::DP::Ph3::SeriesResistor>,
467 CPS::SimPowerComp<CPS::Complex>>(mDPPh3, "SeriesResistor",
468 py::multiple_inheritance())
469 .def(py::init<std::string>())
470 .def(py::init<std::string, CPS::Logger::Level>())
471 .def("set_parameters", &CPS::DP::Ph3::SeriesResistor::setParameters,
472 "R"_a)
473 .def("connect", &CPS::DP::Ph3::SeriesResistor::connect);
474
475 py::class_<CPS::DP::Ph3::SeriesSwitch,
476 std::shared_ptr<CPS::DP::Ph3::SeriesSwitch>,
477 CPS::SimPowerComp<CPS::Complex>, CPS::Base::Ph1::Switch>(
478 mDPPh3, "SeriesSwitch", py::multiple_inheritance())
479 .def(py::init<std::string, CPS::Logger::Level>(), "name"_a,
480 "loglevel"_a = CPS::Logger::Level::off)
481 .def("set_parameters", &CPS::DP::Ph3::SeriesSwitch::setParameters,
482 "open_resistance"_a, "closed_resistance"_a,
483 // cppcheck-suppress assignBoolToPointer
484 "closed"_a = false)
485 .def("open", &CPS::DP::Ph3::SeriesSwitch::open)
486 .def("close", &CPS::DP::Ph3::SeriesSwitch::close)
487 .def("connect", &CPS::DP::Ph3::SeriesSwitch::connect);
488}
CPS::Base::Ph1::Capacitor::setParameters
void setParameters(Real capacitance)
Sets model specific parameters.
Definition Base_Ph1_Capacitor.h:26
CPS::Base::Ph1::Inductor::setParameters
void setParameters(Real inductance)
Sets model specific parameters.
Definition Base_Ph1_Inductor.h:26
CPS::Base::Ph1::Switch
Dynamic Phasor Three-Phase Switch.
Definition Base_Ph1_Switch.h:18
CPS::Base::Ph1::Switch::close
void close()
Close switch.
Definition Base_Ph1_Switch.h:41
CPS::Base::Ph1::Switch::open
void open()
Open switch.
Definition Base_Ph1_Switch.h:43
CPS::DP::Ph1::AvVoltageSourceInverterDQ::setParameters
void setParameters(Real sysOmega, Real sysVoltNom, Real Pref, Real Qref)
Setter for general parameters of inverter.
Definition DP_Ph1_AvVoltageSourceInverterDQ.cpp:96
CPS::DP::Ph1::AvVoltageSourceInverterDQ::setInitialStateValues
void setInitialStateValues(Real pInit, Real qInit, Real phi_dInit, Real phi_qInit, Real gamma_dInit, Real gamma_qInit)
Setter for initial values applied in controllers.
Definition DP_Ph1_AvVoltageSourceInverterDQ.cpp:178
CPS::DP::Ph1::AvVoltageSourceInverterDQ::setControllerParameters
void setControllerParameters(Real Kp_pll, Real Ki_pll, Real Kp_powerCtrl, Real Ki_powerCtrl, Real Kp_currCtrl, Real Ki_currCtrl, Real Omega_cutoff)
Setter for parameters of control loops.
Definition DP_Ph1_AvVoltageSourceInverterDQ.cpp:142
CPS::DP::Ph1::AvVoltageSourceInverterDQ::setTransformerParameters
void setTransformerParameters(Real nomVoltageEnd1, Real nomVoltageEnd2, Real ratedPower, Real ratioAbs, Real ratioPhase, Real resistance, Real inductance)
Setter for parameters of transformer.
Definition DP_Ph1_AvVoltageSourceInverterDQ.cpp:115
CPS::DP::Ph1::AvVoltageSourceInverterDQ::setFilterParameters
void setFilterParameters(Real Lf, Real Cf, Real Rf, Real Rc)
Setter for parameters of filter.
Definition DP_Ph1_AvVoltageSourceInverterDQ.cpp:162
CPS::DP::Ph1::CurrentSource
Dynamic phasor ideal current source.
Definition DP_Ph1_CurrentSource.h:25
CPS::DP::Ph1::NetworkInjection::setParameters
void setParameters(Complex voltageRef, Real srcFreq=0.0)
Definition DP_Ph1_NetworkInjection.cpp:46
CPS::DP::Ph1::RXLoad::setParameters
void setParameters(Real activePower, Real ReactivePower, Real volt)
Set model specific parameters.
Definition DP_Ph1_RXLoad.cpp:102
CPS::DP::Ph1::ReducedOrderSynchronGeneratorVBR
Base class for DP VBR synchronous generator model single phase.
Definition DP_Ph1_ReducedOrderSynchronGeneratorVBR.h:21
CPS::DP::Ph1::SynchronGenerator3OrderVBR
Voltage-Behind-Reactance (VBR) implementation of 3rd order synchronous generator model.
Definition DP_Ph1_SynchronGenerator3OrderVBR.h:20
CPS::DP::Ph1::SynchronGenerator4OrderPCM
4 Order Synchronous generator model for transient stability analysis
Definition DP_Ph1_SynchronGenerator4OrderPCM.h:25
CPS::DP::Ph1::SynchronGenerator4OrderTPM
4 Order Synchronous generator model for transient stability analysis
Definition DP_Ph1_SynchronGenerator4OrderTPM.h:25
CPS::DP::Ph1::SynchronGenerator4OrderVBR
Voltage-Behind-Reactance (VBR) implementation of 4th order synchronous generator model.
Definition DP_Ph1_SynchronGenerator4OrderVBR.h:20
CPS::DP::Ph1::SynchronGenerator5OrderVBR
Voltage-Behind-Reactance (VBR) implementation of 5th type 2 order synchronous generator model Ref: Mi...
Definition DP_Ph1_SynchronGenerator5OrderVBR.h:21
CPS::DP::Ph1::SynchronGenerator6OrderPCM
6 Order Synchronous generator model for transient stability analysis
Definition DP_Ph1_SynchronGenerator6OrderPCM.h:23
CPS::DP::Ph1::SynchronGenerator6aOrderVBR
Voltage-Behind-Reactance (VBR) implementation of 6th order synchronous generator model Marconato's mo...
Definition DP_Ph1_SynchronGenerator6aOrderVBR.h:21
CPS::DP::Ph1::SynchronGenerator6bOrderVBR
Voltage-Behind-Reactance (VBR) implementation of 6th order synchronous generator model Anderson - Fou...
Definition DP_Ph1_SynchronGenerator6bOrderVBR.h:21
CPS::DP::Ph1::SynchronGeneratorTrStab
Synchronous generator model for transient stability analysis.
Definition DP_Ph1_SynchronGeneratorTrStab.h:25
CPS::DP::Ph1::SynchronGeneratorTrStab::setStandardParametersPU
void setStandardParametersPU(Real nomPower, Real nomVolt, Real nomFreq, Real Xpd, Real inertia, Real Rs=0, Real D=0)
Initializes the machine parameters.
Definition DP_Ph1_SynchronGeneratorTrStab.cpp:107
CPS::DP::Ph1::SynchronGeneratorTrStab::setModelFlags
void setModelFlags(Bool convertWithOmegaMech)
Flags to modify model behavior.
Definition DP_Ph1_SynchronGeneratorTrStab.cpp:142
CPS::DP::Ph1::SynchronGeneratorTrStab::setFundamentalParametersPU
void setFundamentalParametersPU(Real nomPower, Real nomVolt, Real nomFreq, Real Ll, Real Lmd, Real Llfd, Real inertia, Real D=0)
Initializes the machine parameters.
Definition DP_Ph1_SynchronGeneratorTrStab.cpp:38
CPS::DP::Ph1::Transformer
Transformer that includes an inductance and resistance.
Definition DP_Ph1_Transformer.h:24
CPS::DP::Ph1::Transformer::setParameters
void setParameters(Real nomVoltageEnd1, Real nomVoltageEnd2, Real ratioAbs, Real ratioPhase, Real resistance, Real inductance)
Defines component parameters.
Definition DP_Ph1_Transformer.cpp:39
CPS::DP::Ph1::VoltageSource
Ideal Voltage source model.
Definition DP_Ph1_VoltageSource.h:42
CPS::DP::Ph1::VoltageSource::setParameters
void setParameters(Complex voltageRef, Real srcFreq=0.0)
Definition DP_Ph1_VoltageSource.cpp:42
CPS::DP::Ph1::VoltageSourceNorton
Resistive dynamic phasor voltage source.
Definition DP_Ph1_VoltageSourceNorton.h:25
CPS::DP::Ph1::VoltageSourceNorton::setParameters
void setParameters(Complex voltage, Real srcFreq=-1, Real resistance=1e9)
THISISBAD: This declaration and Base::Ph1::VoltageSource::setParameters(Complex, Real) are ambiguous ...
Definition DP_Ph1_VoltageSourceNorton.cpp:29
CPS::DP::Ph1::varResSwitch
Switch with variable resistance to avoid numerical oscillations, when an inductive current is suddenl...
Definition DP_Ph1_varResSwitch.h:31
CPS::DP::Ph3::SeriesSwitch
Dynamic phasor three-phase switch.
Definition DP_Ph3_SeriesSwitch.h:30
CPS::MNASyncGenInterface
Interface to be used by synchronous generators.
Definition MNASyncGenInterface.h:17
CPS::SimPowerComp
Base class for all components that are transmitting power.
Definition SimPowerComp.h:17
CPS::SimPowerComp< Complex >::connect
void connect(typename SimNode< Complex >::List nodes)
Definition SimPowerComp.cpp:265
Generated by doxygen 1.13.2