shepherd-core 2025.8.1__py3-none-any.whl → 2025.10.1__py3-none-any.whl

shepherd_core/vsource/virtual_storage_simulator.py

@@ -0,0 +1,104 @@
+"""Simulator for the virtual storage models / algorithms."""
+
+from collections.abc import Callable
+from pathlib import Path
+
+import numpy as np
+from pydantic import PositiveFloat
+from pydantic import validate_call
+
+from shepherd_core import log
+
+from .virtual_storage_model import ModelStorage
+
+
+class StorageSimulator:
+    """The simulator benchmarks a set of storage-models.
+
+    - monitors cell-current and voltage, open circuit voltage, state of charge and time
+    - takes config with a list of storage-models and timebase
+    - runs with a total step-count as config and a current-providing function
+        taking time, cell-voltage and SoC as arguments
+
+    The recorded data can be visualized by generating plots.
+    """
+
+    def __init__(self, models: list[ModelStorage], dt_s: PositiveFloat) -> None:
+        self.models = models
+        self.dt_s = dt_s
+        for model in self.models:
+            if self.dt_s != model.dt_s:
+                raise ValueError("timebase on models do not match")
+        self.t_s: np.ndarray | None = None
+
+        # models return V_cell, SoC_eff, V_OC
+        self.I_input: np.ndarray | None = None
+        self.V_OC: np.ndarray | None = None
+        self.V_cell: np.ndarray | None = None
+        self.SoC: np.ndarray | None = None
+        self.SoC_eff: np.ndarray | None = None
+
+    @validate_call
+    def run(self, fn: Callable, duration_s: PositiveFloat) -> None:
+        self.t_s = np.arange(0, duration_s, self.dt_s)
+        self.I_input = np.zeros((len(self.models), self.t_s.shape[0]))
+        self.V_OC = np.zeros((len(self.models), self.t_s.shape[0]))
+        self.V_cell = np.zeros((len(self.models), self.t_s.shape[0]))
+        self.SoC = np.zeros((len(self.models), self.t_s.shape[0]))
+        self.SoC_eff = np.zeros((len(self.models), self.t_s.shape[0]))
+        for i, model in enumerate(self.models):
+            SoC = 1.0
+            V_cell = 0.0
+            for j, t_s in enumerate(self.t_s):
+                I_charge = fn(t_s, SoC, V_cell)
+                V_OC, V_cell, SoC, SoC_eff = model.step(I_charge)
+                self.I_input[i, j] = I_charge
+                self.V_OC[i, j] = V_OC
+                self.V_cell[i, j] = V_cell
+                self.SoC[i, j] = SoC
+                self.SoC_eff[i, j] = SoC_eff
+
+    @validate_call
+    def plot(self, path: Path, title: str, *, plot_delta_v: bool = False) -> None:
+        try:
+            # keep dependencies low
+            from matplotlib import pyplot as plt  # noqa: PLC0415
+        except ImportError:
+            log.warning("Matplotlib not installed, plotting of results disabled")
+            return
+
+        offset = 1 if plot_delta_v else 0
+        fig, axs = plt.subplots(4 + offset, 1, sharex="all", figsize=(10, 2 * 6), layout="tight")
+        axs[0].set_title(title)
+        axs[0].set_ylabel("State of Charge [n]")
+        # ⤷ Note: SoC-eff is also available, but unused
+        axs[0].grid(visible=True)
+        axs[1].set_ylabel("Open-circuit voltage [V]")
+        axs[1].grid(visible=True)
+        axs[2].set_ylabel("Cell voltage [V]")
+        axs[2].grid(visible=True)
+        if plot_delta_v:
+            axs[3].set_ylabel("Cell voltage delta [V]")
+            axs[3].grid(visible=True)
+        axs[3 + offset].set_ylabel("Charge current [A]")
+        axs[3 + offset].set_xlabel("time [s]")
+        axs[3 + offset].grid(visible=True)
+
+        for i, model in enumerate(self.models):
+            axs[0].plot(
+                self.t_s, self.SoC[i], label=f"{type(model).__name__} {model.cfg.name}", alpha=0.7
+            )
+            axs[1].plot(self.t_s, self.V_OC[i], label=type(model).__name__, alpha=0.7)
+            axs[2].plot(self.t_s, self.V_cell[i], label=type(model).__name__, alpha=0.7)
+            if plot_delta_v:  # assumes that timestamps are identical
+                axs[3].plot(
+                    self.t_s,
+                    [v - ref for v, ref in zip(self.V_cell[i], self.V_cell[0], strict=False)],
+                    label=type(model).__name__,
+                    alpha=0.7,
+                )
+            axs[3 + offset].plot(self.t_s, self.I_input[i], label=type(model).__name__, alpha=0.7)
+        axs[0].legend()
+        plt.savefig(path / f"{title}.png")
+        plt.close(fig)
+        plt.clf()

{shepherd_core-2025.8.1.dist-info → shepherd_core-2025.10.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shepherd_core
-Version: 2025.8.1
+Version: 2025.10.1
 Summary: Programming- and CLI-Interface for the h5-dataformat of the Shepherd-Testbed
 Author-email: Ingmar Splitt <ingmar.splitt@tu-dresden.de>
 Maintainer-email: Ingmar Splitt <ingmar.splitt@tu-dresden.de>
@@ -22,6 +22,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Natural Language :: English

{shepherd_core-2025.8.1.dist-info → shepherd_core-2025.10.1.dist-info}/RECORD

@@ -3,37 +3,45 @@ shepherd_core/calibration_hw_def.py,sha256=aL94bA1Sf14L5A3PLdVvQVYtGi28S4NUWA65w
 shepherd_core/commons.py,sha256=_phovuhCgLmO5gcazQ5hyykUPc907dyK9KpY2lUtoIM,205
 shepherd_core/config.py,sha256=YegFEXuBUBnbq5mb67em8ozEnSkEQSPXjqHlKA2HXCQ,967
 shepherd_core/logger.py,sha256=Plx7JFZXSYWAKbeOTyo7uApe3sDBKEQhG4ovhiET9Sc,1772
-shepherd_core/reader.py,sha256=lFpcsnia72vGrR0othUZxh_pn_cM_9sbjzZRywjXus0,29246
-shepherd_core/version.py,sha256=iMNehsT3f5S69B39uUAurKGE93x8sHgh9iUY_vqvVt8,76
+shepherd_core/reader.py,sha256=irae0ezLOG6FkJNVsh_u7QG-u8B_qo7MEnzm51IjJ5w,29392
+shepherd_core/version.py,sha256=tUkZ6me00iSazuJnSdnp61gMccxWO_JUMJuiZDvpTfg,76
 shepherd_core/writer.py,sha256=W4jWCQ2br_iJHvgknnuCThC5JQ9p5VxsWhsMnviOGHY,14489
-shepherd_core/data_models/__init__.py,sha256=jBsk2RpD5Gw5GNe1gql9YrWD-7Uv7F2jwRRx-CHdceQ,1909
+shepherd_core/data_models/__init__.py,sha256=S13slmH4yByO9juym0PXVbi4_D-ymEcECIRB5eVoyso,2016
 shepherd_core/data_models/readme.md,sha256=DHPVmkWqDksWomRHRTVWVHy9wXF9oMJrITgKs4Pnz2g,2494
-shepherd_core/data_models/virtual_source_doc.txt,sha256=OK_7zYbLvr6cEj3KaUcWwZJ9naoFB2KwAaXudbhzouQ,6076
 shepherd_core/data_models/base/__init__.py,sha256=PSJ6acWViqBm0Eiom8DIgKfFVrp5lzYr8OsDvP79vwI,94
 shepherd_core/data_models/base/cal_measurement.py,sha256=ZZYoXfpehZkKRLnRqzuPakYHrpMwIMJVaPkUw0W_Ybo,3340
 shepherd_core/data_models/base/calibration.py,sha256=69ihSXuIjogqICRLhbZJu9-KdkGR8UXyMyBDSAY2ajY,10713
-shepherd_core/data_models/base/content.py,sha256=Oar3cSYF-ywIm5BKH77epdSy5zscw1UKC7h3PuhbJ9M,2064
+shepherd_core/data_models/base/content.py,sha256=35VQ4CRduULa0j2xridrBXp7T0cBwCJR8yuD6GEfgG8,2188
 shepherd_core/data_models/base/shepherd.py,sha256=bkG4UA4q6AXMnwvnZlDITnP-cYMr21tDthPi7DRVFAY,7345
 shepherd_core/data_models/base/timezone.py,sha256=2T6E46hJ1DAvmqKfu6uIgCK3RSoAKjGXRyzYNaqKyjY,665
 shepherd_core/data_models/base/wrapper.py,sha256=W82OHSfRIFQgBR19B-xVu-vPspkQjgo_aHKOMwcFR0g,747
-shepherd_core/data_models/content/__init__.py,sha256=69aiNG0h5t1OF7HsLg_ke5eaQKsKyMK8o6Kfaby5vlY,525
+shepherd_core/data_models/content/__init__.py,sha256=m3U5qbtHGWpox0B8tv0UVP-V2jQNWsftHK5vn-_B-04,624
 shepherd_core/data_models/content/_external_fixtures.yaml,sha256=BsHW5UP1UtrEkcI-efCHq4gFtnsuOvoCPv1ri-f6JOI,12132
 shepherd_core/data_models/content/energy_environment.py,sha256=y_DiLKkABFn0kP9XFEy918JQg-mBSXgOEMISOTV7S0g,1593
 shepherd_core/data_models/content/energy_environment_fixture.yaml,sha256=UBXTdGT7MK98zx5w_RBCu-f9uNCKxRgiFBQFbmDUxPc,1301
 shepherd_core/data_models/content/firmware.py,sha256=1N9dFY3hDiis4rmqrNyXHVNN5TLscIb3OwJ8R9aaKd0,6114
 shepherd_core/data_models/content/firmware_datatype.py,sha256=XPU9LOoT3h5qFOlE8WU0vAkw-vymNxzor9kVFyEqsWg,255
-shepherd_core/data_models/content/virtual_harvester.py,sha256=8MAzZm5P3vAvwJ5IsFZwHmZV-CBU5czAD_EmwUAaCr8,20263
+shepherd_core/data_models/content/virtual_harvester_config.py,sha256=6bUGvuzMrlVebtnkqLKdKdAH9YFfFyUuHTymYgp2IGM,20275
 shepherd_core/data_models/content/virtual_harvester_fixture.yaml,sha256=4eNQyFI9LozpButOTlBQ07T0MFCaPEYIxwtedMjUf3U,4575
-shepherd_core/data_models/content/virtual_source.py,sha256=GbdRghRLmLEUrMo1dyd0Pc0-bm7-3LCIgVaOhCb6NxQ,15850
-shepherd_core/data_models/content/virtual_source_fixture.yaml,sha256=WWbo9ACoD-JJ-jidMFTfwSn4PR_nRPwKQ0Aa2qKVrxE,11202
+shepherd_core/data_models/content/virtual_source_config.py,sha256=RF6yS0De-6kfiQgRuBeE7-hLruy-VoRbkCKATf2ESBA,16671
+shepherd_core/data_models/content/virtual_source_fixture.yaml,sha256=eW5JFlt7RxCF3WgLI5OW2i4sDd2uLITzhCRIiikbce4,11151
+shepherd_core/data_models/content/virtual_storage_config.py,sha256=U6ky_Wh3_Orreope-dovkaQ-YMA3JTdW0HV0uKAhnHM,15778
+shepherd_core/data_models/content/virtual_storage_fixture_creator.py,sha256=pFBNekbLvT61xZDMA00inIfvmuy2ujVkz3M-19fDmBs,9281
+shepherd_core/data_models/content/virtual_storage_fixture_ideal.yaml,sha256=_fal7Egnq1_yIMCh-clZhrs2yNKIBxAUpxm4Y4J6JtM,11838
+shepherd_core/data_models/content/virtual_storage_fixture_lead.yaml,sha256=m3aptqq7S0WCuHbkG_7Ly9isTcioVsayjV56CSBvfrs,926
+shepherd_core/data_models/content/virtual_storage_fixture_lipo.yaml,sha256=zAFUapOxAeW14ndqQHKnFgUOUylB4DCuwngC1ERMsGw,13788
+shepherd_core/data_models/content/virtual_storage_fixture_mlcc.yaml,sha256=DjvQVw3YY3Qwq_MUkSgt-mTHyixra_T73uZBiSJKc9A,3778
+shepherd_core/data_models/content/virtual_storage_fixture_param_experiments.py,sha256=7fFA_4K0QPYimjzRkW89s6daKSsTLud5RX65CmRoQOo,5209
+shepherd_core/data_models/content/virtual_storage_fixture_super.yaml,sha256=I4vuW4Pg94qxh17miNj8a_batVEFAL-nAhZS0hHPOKI,2875
+shepherd_core/data_models/content/virtual_storage_fixture_tantal.yaml,sha256=7E0zby__SvxWXO_saHbR8ir7N0KwuvGCyKlitZMUoeM,10600
 shepherd_core/data_models/experiment/__init__.py,sha256=lorsx0M-JWPIrt_UZfexsLwaITv5slFb3krBOt0idm8,618
 shepherd_core/data_models/experiment/experiment.py,sha256=6fv-UMIFweWHtJT4KxGcIrqk2EY8MKi0SXZQj0EADHo,4268
 shepherd_core/data_models/experiment/observer_features.py,sha256=culZr3_PXHas5SL9prSKCGLEyzd3mfVj6jDnYCKDy6I,8341
-shepherd_core/data_models/experiment/target_config.py,sha256=l0_TsE5UYLVe3E8ygsLQdG-KC5v2TVcP3vjDf8Fu_ek,4210
+shepherd_core/data_models/experiment/target_config.py,sha256=u1bGf5GFuwkMI5fznjT_iYZ_dT7IaiK0XlsUxYK05s8,4217
 shepherd_core/data_models/task/__init__.py,sha256=lW-U3Ativerhan_8JMlNSgvHvvS6PH02zmTJviLYoNg,3633
-shepherd_core/data_models/task/emulation.py,sha256=N--FYDHdBFaCcwCXn1p66xorSyKuobS7Vy50WrxutJw,7866
+shepherd_core/data_models/task/emulation.py,sha256=h3wuAcGwLj8bbipp2Fjb82enuP3VgGsdlQDPBHQoU6s,7873
 shepherd_core/data_models/task/firmware_mod.py,sha256=0UjCGi7SZ00B-ggZMowXrRlpV9bYjKjYMHEk23c_3Z0,3472
-shepherd_core/data_models/task/harvest.py,sha256=10xflQ9EPgB8Q2SBrymXFIDJyikTl4-PVwiCoaPYpV0,3716
+shepherd_core/data_models/task/harvest.py,sha256=dKLSvAoGN7kcC74f2uiOYh9_XH381rc3csocYx7bLeQ,3723
 shepherd_core/data_models/task/helper_paths.py,sha256=AOfbZekT1OxH8pUV_B0S_SR7O4tcRbJalhnUBGPfvd4,440
 shepherd_core/data_models/task/observer_tasks.py,sha256=udkAEfOjYnpDONHeZ5iPnM4qnARQMH_M_t8LG2UHSEI,3991
 shepherd_core/data_models/task/programming.py,sha256=zJ84oW-bchu4CNPK8z3dDQvBNc5FAtUI8bbXd3s2zOY,2932
@@ -53,7 +61,7 @@ shepherd_core/data_models/testbed/target_fixture.yaml,sha256=aoP7Al_sXw8nBQpIP25
 shepherd_core/data_models/testbed/testbed.py,sha256=e2szb1vFG0aiYMaYOT5Y1y1Y8mqvgnoP3oq9DcQgSGk,3727
 shepherd_core/data_models/testbed/testbed_fixture.yaml,sha256=ca5LI-fWoc3I9m2QScVAh84Bv-ftkSGAizR3ZR0lkC8,980
 shepherd_core/decoder_waveform/__init__.py,sha256=-ohGz0fA2tKxUJk4FAQXKtI93d6YGdy0CrkdhOod1QU,120
-shepherd_core/decoder_waveform/uart.py,sha256=oeGwwXOrc_36pc0vDW8m3cwkkwa8imzXSxcdeqUKX44,10985
+shepherd_core/decoder_waveform/uart.py,sha256=zQX64dBXmhEYXN__OfS2h_1fDgZLomhbptQX34-Fobc,10989
 shepherd_core/fw_tools/__init__.py,sha256=D9GGj9TzLWZfPjG_iV2BsF-Q1TGTYTgEzWTUI5ReVAA,2090
 shepherd_core/fw_tools/converter.py,sha256=wRJvcaFyMpApUTNBTh3a-vqqfRXDJWYppEaH0oyrACY,3626
 shepherd_core/fw_tools/converter_elf.py,sha256=DC-zDi1v7pCFTA1d4VqErDvIMAYwAbv_efqh17wLeRA,1058
@@ -61,7 +69,7 @@ shepherd_core/fw_tools/patcher.py,sha256=V5Dg-uhTxT7Ro4UdFS7pVl2GwkKHLWd8YIvZKxM
 shepherd_core/fw_tools/validation.py,sha256=unm6jsj2538EfIAuRcrpnA2dee1-THD5_dKWFVmCmMI,5095
 shepherd_core/inventory/__init__.py,sha256=yQxP55yV61xXWfZSSzekQQYopPZCspFpHSyG7VTqtpg,3819
 shepherd_core/inventory/python.py,sha256=uchavGsssM4CTYQ23kF6hxhl3NUeEpGVvJYX8t7dWU4,1210
-shepherd_core/inventory/system.py,sha256=VHXJjTgImppbYEkAZqBPduDMCQ1z1iYTr3OWKcUJGSc,3168
+shepherd_core/inventory/system.py,sha256=1BkS71SCOGscD6aW9EDW47-CZM9gyBLED28cy1u83Es,3162
 shepherd_core/inventory/target.py,sha256=4ju4HwXxEJ2naNEfL-gS8Z6s0eacllMmBu4iKKz-14Y,489
 shepherd_core/testbed_client/__init__.py,sha256=QtbsBUzHwOoM6rk0qa21ywuz63YV7af1fwUtWW8Vg_4,234
 shepherd_core/testbed_client/cache_path.py,sha256=BXklO72gFDhJ9i2gGlgw5MbuxexGA42two7DCdpd9dM,437
@@ -69,15 +77,19 @@ shepherd_core/testbed_client/client_abc_fix.py,sha256=DX51I8Wh4ROU4SBwdeM-2VznIN
 shepherd_core/testbed_client/client_web.py,sha256=7dEPjYOWXAbeU_zaJ7Pk9cj7LafKjFBfCw8UBD5v7HA,5939
 shepherd_core/testbed_client/fixtures.py,sha256=PzQLsMxs8Ddz01dMtpt59nOPGMWTKQ10dBDu49BjMyA,9317
 shepherd_core/testbed_client/user_model.py,sha256=9vqW9Vzs-QwD3SqgXDyNGLR8siQ9-2ueRcaI3yxs6yA,2037
-shepherd_core/vsource/__init__.py,sha256=vTvFWuJn4eurPNzEiMd15c1Rd6o3DTWzCfbhOomflZU,771
+shepherd_core/vsource/__init__.py,sha256=D8FB8ugsFp3XBM5io33j6SJTYy3TfK_-3FW7boLDCaw,933
 shepherd_core/vsource/target_model.py,sha256=BjOlwX_gIOJ91e4OOLB4_OsCpuhq9vm57ERjM-iBhAM,5129
-shepherd_core/vsource/virtual_converter_model.py,sha256=D9lkvRe6gTm3kEfyLmuBvuxDyacmCEQUPHPCDUu8IJo,11597
-shepherd_core/vsource/virtual_harvester_model.py,sha256=K9RnAHCz1ibdYMte5l_U7vrY6_mVRZBg7xBL2ZYC16c,9757
-shepherd_core/vsource/virtual_harvester_simulation.py,sha256=SGAqXb-PC_JblbyBRoYxu-64VKawnixuhsnlv_xk6Mk,2516
-shepherd_core/vsource/virtual_source_model.py,sha256=VMiDDJYhc5LZIBoi-uHWeXKPnZASqaLMd4FmArj21qw,3126
-shepherd_core/vsource/virtual_source_simulation.py,sha256=HL3Pt4-fZCdg75fXgYhNmnQ8DsGWs01skIfMHJK87XE,5253
-shepherd_core-2025.8.1.dist-info/METADATA,sha256=3XDbI3GGfnicMvDHugP-rVbdtx3XZyy6W6GXArmyAuA,7628
-shepherd_core-2025.8.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-shepherd_core-2025.8.1.dist-info/top_level.txt,sha256=wy-t7HRBrKARZxa-Y8_j8d49oVHnulh-95K9ikxVhew,14
-shepherd_core-2025.8.1.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-shepherd_core-2025.8.1.dist-info/RECORD,,
+shepherd_core/vsource/virtual_converter_model.py,sha256=k-Et_u4XZ7YIEMyCWqoC2J-vnz1Y1DYmf8IT2IBEirs,11618
+shepherd_core/vsource/virtual_harvester_model.py,sha256=n0kBtEGuXpCOmLC8w7lnLEeveCyplSOMi5rg2P2X7go,10091
+shepherd_core/vsource/virtual_harvester_simulation.py,sha256=0o9TgA-7UQ_Q9QGxRYdLXPUfEU93yzKTAQ9AtyA-h1Q,2659
+shepherd_core/vsource/virtual_source_model.py,sha256=N0oDy6lalUDzQ6yNe-BCvCND7nvhpgIOfFaisxIG5wk,3411
+shepherd_core/vsource/virtual_source_simulation.py,sha256=aiDGJZYdD5n61H1eVIdgSbixAZpsjJ7nQZ2Vy9QiKRA,5512
+shepherd_core/vsource/virtual_storage_model.py,sha256=UNV5HkU4ahiHE213ygpovs4FqgtIc3v6TWW1aaijKCc,5634
+shepherd_core/vsource/virtual_storage_model_fixed_point_math.py,sha256=v4SbEb7bY4ZBg0p9xgHd76Pq2B3M98xSZ16AWRyUNTQ,2050
+shepherd_core/vsource/virtual_storage_models_kibam.py,sha256=Gubk6VSBcXYfoa_yNLxTy2Qj_Iu4FDJz5czEtnTGVSE,18292
+shepherd_core/vsource/virtual_storage_simulator.py,sha256=qPWHwIdey9aDOA8oSJjNX5WKBMV8avzWkcEpp1m3uyY,4268
+shepherd_core-2025.10.1.dist-info/METADATA,sha256=muJaAktfPNxE3R4RzBqTcG_5SRpg8m57pE0q5hjEVfc,7680
+shepherd_core-2025.10.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+shepherd_core-2025.10.1.dist-info/top_level.txt,sha256=wy-t7HRBrKARZxa-Y8_j8d49oVHnulh-95K9ikxVhew,14
+shepherd_core-2025.10.1.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+shepherd_core-2025.10.1.dist-info/RECORD,,

shepherd_core/data_models/virtual_source_doc.txt

@@ -1,207 +0,0 @@
-from pydantic import Field
-
-from ..data_models import ShpModel
-from .content import VirtualHarvesterConfig
-from .content.virtual_source import LUT1D
-from .content.virtual_source import LUT2D
-
-
-@DeprecationWarning
-class VirtualSourceDoc(ShpModel, title="Virtual Source (Documented, Testversion)"):
-    # General Config
-    name: str = Field(
-        title="Name of Virtual Source",
-        description="Slug to use this Name as later reference",
-        default="neutral",
-    )
-    inherit_from: str = Field(
-        description="Name of converter to derive defaults from",
-        default="neutral",
-    )
-
-    enable_boost: bool = Field(
-        description="If false -> V_intermediate becomes V_input, "
-        "output-switch-hysteresis is still usable",
-        default=False,
-    )
-    enable_buck: bool = Field(
-        description="If false -> V_output becomes V_intermediate",
-        default=False,
-    )
-    log_intermediate_voltage: bool = Field(
-        description="Record / log virtual intermediate (cap-)voltage and "
-        "-current (out) instead of output-voltage and -current",
-        default=False,
-    )
-
-    interval_startup_delay_drain_ms: float = Field(
-        description="Model begins running but Target is not draining the storage capacitor",
-        default=0,
-        ge=0,
-        le=10e3,
-    )
-
-    harvester: VirtualHarvesterConfig = Field(
-        description="Only active / needed if input is ivsurface / curves,
-        default=VirtualHarvesterConfig(name="mppt_opt"),
-    )
-
-    V_input_max_mV: float = Field(
-        description="Maximum input Voltage [mV]",
-        default=10_000,
-        ge=0,
-        le=10e3,
-    )
-    I_input_max_mA: float = Field(
-        description="Maximum input Current [mA]",
-        default=4_200,
-        ge=0,
-        le=4.29e3,
-    )
-    V_input_drop_mV: float = Field(
-        title="Drop of Input-Voltage [mV]",
-        description="Simulate an input-diode",
-        default=0,
-        ge=0,
-        le=4.29e6,
-    )
-    R_input_mOhm: float = Field(
-        description="Resistance only active with disabled boost, range [1 mOhm; 1MOhm]",
-        default=0,
-        ge=0,
-        le=4.29e6,
-    )
-
-    C_intermediate_uF: float = Field(
-        description="Capacity of primary Storage-Capacitor",
-        default=0,
-        ge=0,
-        le=100_000,
-    )
-    V_intermediate_init_mV: float = Field(
-        description="Allow a proper / fast startup",
-        default=3_000,
-        ge=0,
-        le=10_000,
-    )
-    I_intermediate_leak_nA: float = Field(
-        description="Current leakage of intermediate storage capacitor",
-        default=0,
-        ge=0,
-        le=4.29e9,
-    )
-
-    V_intermediate_enable_threshold_mV: float = Field(
-        description="Target gets connected (hysteresis-combo with next value)",
-        default=1,
-        ge=0,
-        le=10_000,
-    )
-    V_intermediate_disable_threshold_mV: float = Field(
-        description="Target gets disconnected",
-        default=0,
-        ge=0,
-        le=10_000,
-    )
-    interval_check_thresholds_ms: float = Field(
-        description="Some BQs check every 64 ms if output should be disconnected",
-        default=0,
-        ge=0,
-        le=4.29e3,
-    )
-
-    V_pwr_good_enable_threshold_mV: float = Field(
-        description="Target is informed by pwr-good on output-pin (hysteresis) "
-        "-> for intermediate voltage",
-        default=2800,
-        ge=0,
-        le=10_000,
-    )
-    V_pwr_good_disable_threshold_mV: float = Field(
-        description="Target is informed by pwr-good on output-pin (hysteresis) "
-        "-> for intermediate voltage",
-        default=2200,
-        ge=0,
-        le=10_000,
-    )
-    immediate_pwr_good_signal: bool = Field(
-        description="1: activate instant schmitt-trigger, "
-        "0: stay in interval for checking thresholds",
-        default=True,
-    )
-
-    C_output_uF: float = Field(
-        description="Final (always last) stage to compensate undetectable "
-        "current spikes when enabling power for target",
-        default=1.0,
-        ge=0,
-        le=4.29e6,
-    )
-
-    # Extra
-    V_output_log_gpio_threshold_mV: float = Field(
-        description="Min voltage needed to enable recording changes in gpio-bank",
-        default=1400,
-        ge=0,
-        le=4.29e6,
-    )
-
-    # Boost Converter
-    V_input_boost_threshold_mV: float = Field(
-        description="min input-voltage for the boost converter to work",
-        default=0,
-        ge=0,
-        le=10_000,
-    )
-    V_intermediate_max_mV: float = Field(
-        description="Threshold for shutting off Boost converter",
-        default=10_000,
-        ge=0,
-        le=10_000,
-    )
-
-    LUT_input_efficiency: LUT2D = Field(
-        description="# input-array[12][12] depending on "
-        "array[inp_voltage][log(inp_current)], "
-        "influence of cap-voltage is not implemented",
-        default=12 * [12 * [1.00]],
-    )
-    LUT_input_V_min_log2_uV: int = Field(
-        description="Example: n=7, 2^n = 128 uV -> array[0] is for inputs < 128 uV",
-        default=0,
-        ge=0,
-        le=20,
-    )
-    LUT_input_I_min_log2_nA: int = Field(
-        description="Example: n=8, 2^n = 256 nA -> array[0] is for inputs < 256 nA",
-        default=0,
-        ge=0,
-        le=20,
-    )
-
-    # Buck Converter
-    V_output_mV: float = Field(
-        description="Fixed Voltage of Buck-Converter (as long as "
-        "Input is > Output + Drop-Voltage)",
-        default=2400,
-        ge=0,
-        le=5_000,
-    )
-    V_buck_drop_mV: float = Field(
-        description="Simulate LDO min voltage differential or output-diode",
-        default=0,
-        ge=0,
-        le=5_000,
-    )
-
-    LUT_output_efficiency: LUT1D = Field(
-        description="Output-Array[12] depending on output_current. In & Output is linear",
-        default=12 * [1.00],
-    )
-    LUT_output_I_min_log2_nA: int = Field(
-        description="Example: n=8, 2^n = 256 nA -> array[0] is for inputs < 256 nA, "
-        "see notes on LUT_input for explanation",
-        default=0,
-        ge=0,
-        le=20,
-    )