shepherd-data 2024.7.3__tar.gz → 2024.8.1__tar.gz

{shepherd_data-2024.7.3 → shepherd_data-2024.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: shepherd_data
-Version: 2024.7.3
+Version: 2024.8.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>
@@ -35,7 +35,7 @@ Requires-Dist: numpy
 Requires-Dist: pandas>=2.0.0
 Requires-Dist: pyYAML
 Requires-Dist: scipy
-Requires-Dist: shepherd-core[inventory]>=2024.7.3
+Requires-Dist: shepherd-core[inventory]>=2024.8.1
 Requires-Dist: tqdm
 Provides-Extra: elf
 Requires-Dist: shepherd-core[elf]; extra == "elf"

{shepherd_data-2024.7.3 → shepherd_data-2024.8.1}/pyproject.toml

@@ -37,7 +37,7 @@ dependencies = [
     "pandas>=2.0.0",  # full-version, v2 is OK
     "pyYAML",
     "scipy",   # full-version
-    "shepherd-core[inventory]>=2024.7.3",
+    "shepherd-core[inventory]>=2024.8.1",
     "tqdm",    # full-version
 ]
 

{shepherd_data-2024.7.3 → shepherd_data-2024.8.1}/shepherd_data/__init__.py

@@ -11,7 +11,7 @@ from shepherd_core import Writer
 
 from .reader import Reader
 
-__version__ = "2024.7.3"
+__version__ = "2024.8.1"
 
 __all__ = [
     "Reader",

{shepherd_data-2024.7.3 → shepherd_data-2024.8.1}/shepherd_data/cli.py

@@ -58,7 +58,7 @@ def path_to_flist(data_path: Path) -> List[Path]:
     help="Prints version-info at start (combinable with -v)",
 )
 @click.pass_context  # TODO: is the ctx-type correct?
-def cli(ctx: click.Context, verbose: bool, version: bool) -> None:  # noqa: FBT001
+def cli(ctx: click.Context, *, verbose: bool, version: bool) -> None:
     """Shepherd: Synchronized Energy Harvesting Emulator and Recorder."""
     if verbose:
         increase_verbose_level(3)
@@ -355,13 +355,21 @@ def downsample(in_data: Path, ds_factor: Optional[float], sample_rate: Optional[
     is_flag=True,
     help="Plot all files (in directory) into one Multiplot",
 )
+@click.option(
+    "--only-power",
+    "-p",
+    is_flag=True,
+    help="Plot only power instead of voltage, current & power",
+)
 def plot(
     in_data: Path,
     start: Optional[float],
     end: Optional[float],
     width: int,
     height: int,
-    multiplot: bool,  # noqa: FBT001
+    *,
+    multiplot: bool,
+    only_power: bool,
 ) -> None:
     """Plot IV-trace from file or directory containing shepherd-recordings."""
     files = path_to_flist(in_data)
@@ -378,12 +386,12 @@ def plot(
                         continue
                     data.append(date)
                 else:
-                    shpr.plot_to_file(start, end, width, height)
+                    shpr.plot_to_file(start, end, width, height, only_pwr=only_power)
         except TypeError:
             logger.exception("ERROR: Will skip file. It caused an exception.")
     if multiplot:
         logger.info("Got %d datasets to plot", len(data))
-        mpl_path = Reader.multiplot_to_file(data, in_data, width, height)
+        mpl_path = Reader.multiplot_to_file(data, in_data, width, height, only_pwr=only_power)
         if mpl_path:
             logger.info("Plot generated and saved to '%s'", mpl_path.name)
         else:

{shepherd_data-2024.7.3 → shepherd_data-2024.8.1}/shepherd_data/reader.py

@@ -171,7 +171,6 @@ class Reader(CoreReader):
 
         if self.get_datatype() == "ivcurve":
             self._logger.warning("Downsampling-Function was not written for IVCurves")
-            return data_dst
         ds_factor = max(1, math.floor(ds_factor))
 
         if isinstance(end_n, (int, float)):
@@ -345,7 +344,6 @@ class Reader(CoreReader):
         """
         if self.get_datatype() == "ivcurve":
             self._logger.warning("Plot-Function was not written for IVCurves.")
-            return None
         if not isinstance(start_s, (float, int)):
             start_s = 0
         if not isinstance(end_s, (float, int)):
@@ -357,7 +355,7 @@ class Reader(CoreReader):
             return None
         samplerate_dst = max(round(self.max_elements / (end_s - start_s), 3), 0.001)
         ds_factor = float(self.samplerate_sps / samplerate_dst)
-        data = {
+        data: dict = {
             "name": self.get_hostname(),
             "time": self._cal.time.raw_to_si(
                 self.downsample(
@@ -383,31 +381,50 @@ class Reader(CoreReader):
         return data
 
     @staticmethod
-    def assemble_plot(data: Union[dict, list], width: int = 20, height: int = 10) -> plt.Figure:
+    def assemble_plot(
+        data: Union[dict, list], width: int = 20, height: int = 10, *, only_pwr: bool = False
+    ) -> plt.Figure:
         """Create the actual figure.
 
+        Due to the 50 mA limits of the cape the default units for current & power are mA & mW.
+
         :param data: plottable / down-sampled iv-data with some meta-data
                 -> created with generate_plot_data()
         :param width: plot-width
         :param height: plot-height
+        :param only_pwr: plot power-trace instead of voltage, current & power
         :return: figure
         """
-        # TODO: add power (if wanted)
+        # TODO: allow choosing freely from I, V, P, GPIO
         if isinstance(data, dict):
             data = [data]
-        fig, axes = plt.subplots(2, 1, sharex="all")
-        fig.suptitle("Voltage and current")
+        if only_pwr:
+            fig, ax = plt.subplots(1, 1, figsize=(width, height), layout="tight")
+            axs = [ax]
+            fig.suptitle("Power-Trace")
+        else:
+            fig, axs = plt.subplots(3, 1, sharex="all", figsize=(width, height), layout="tight")
+            fig.suptitle("Voltage, current & power")
+            axs[0].set_ylabel("voltage [V]")
+            axs[1].set_ylabel("current [mA]")
+            # last axis is set below
+
         for date in data:
-            axes[0].plot(date["time"], date["voltage"], label=date["name"])
-            axes[1].plot(date["time"], date["current"] * 10**6, label=date["name"])
-        axes[0].set_ylabel("voltage [V]")
-        axes[1].set_ylabel(r"current [$\mu$A]")
+            if not only_pwr:
+                axs[0].plot(date["time"], date["voltage"], label=date["name"])
+                axs[1].plot(date["time"], date["current"] * 10**3, label=date["name"])
+            axs[-1].plot(
+                date["time"], date["voltage"] * date["current"] * 10**3, label=date["name"]
+            )
+
         if len(data) > 1:
-            axes[0].legend(loc="lower center", ncol=len(data))
-        axes[1].set_xlabel("time [s]")
-        fig.set_figwidth(width)
-        fig.set_figheight(height)
-        fig.tight_layout()
+            axs[0].legend(loc="lower center", ncol=len(data))
+        axs[-1].set_xlabel("time [s]")
+        axs[-1].set_ylabel("power [mW]")
+        for ax in axs:
+            # deactivates offset-creation for ax-ticks
+            ax.get_yaxis().get_major_formatter().set_useOffset(False)
+            ax.get_xaxis().get_major_formatter().set_useOffset(False)
         return fig
 
     def plot_to_file(
@@ -416,6 +433,8 @@ class Reader(CoreReader):
         end_s: Optional[float] = None,
         width: int = 20,
         height: int = 10,
+        *,
+        only_pwr: bool = False,
     ) -> None:
         """Create (down-sampled) IV-Plots.
 
@@ -425,6 +444,7 @@ class Reader(CoreReader):
         :param end_s: time in seconds, relative to start of recording, optional
         :param width: plot-width
         :param height: plot-height
+        :param only_pwr: plot power-trace instead of voltage, current & power
         """
         if not isinstance(self.file_path, Path):
             return
@@ -440,14 +460,19 @@ class Reader(CoreReader):
             self._logger.warning("Plot exists, will skip & not overwrite!")
             return
         self._logger.info("Plot generated, will be saved to '%s'", plot_path.name)
-        fig = self.assemble_plot(data, width, height)
+        fig = self.assemble_plot(data, width, height, only_pwr=only_pwr)
         plt.savefig(plot_path)
         plt.close(fig)
         plt.clf()
 
     @staticmethod
     def multiplot_to_file(
-        data: list, plot_path: Path, width: int = 20, height: int = 10
+        data: list,
+        plot_path: Path,
+        width: int = 20,
+        height: int = 10,
+        *,
+        only_pwr: bool = False,
     ) -> Optional[Path]:
         """Create (down-sampled) IV-Multi-Plots (of more than one trace).
 
@@ -456,6 +481,7 @@ class Reader(CoreReader):
         :param plot_path: optional
         :param width: plot-width
         :param height: plot-height
+        :param only_pwr: plot power-trace instead of voltage, current & power
         """
         start_str = f"{data[0]['start_s']:.3f}".replace(".", "s")
         end_str = f"{data[0]['end_s']:.3f}".replace(".", "s")
@@ -465,7 +491,7 @@ class Reader(CoreReader):
         if plot_path.exists():
             logger.warning("Plot exists, will skip & not overwrite!")
             return None
-        fig = Reader.assemble_plot(data, width, height)
+        fig = Reader.assemble_plot(data, width, height, only_pwr=only_pwr)
         plt.savefig(plot_path)
         plt.close(fig)
         plt.clf()

{shepherd_data-2024.7.3 → shepherd_data-2024.8.1}/shepherd_data.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: shepherd_data
-Version: 2024.7.3
+Version: 2024.8.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>
@@ -35,7 +35,7 @@ Requires-Dist: numpy
 Requires-Dist: pandas>=2.0.0
 Requires-Dist: pyYAML
 Requires-Dist: scipy
-Requires-Dist: shepherd-core[inventory]>=2024.7.3
+Requires-Dist: shepherd-core[inventory]>=2024.8.1
 Requires-Dist: tqdm
 Provides-Extra: elf
 Requires-Dist: shepherd-core[elf]; extra == "elf"

{shepherd_data-2024.7.3 → shepherd_data-2024.8.1}/shepherd_data.egg-info/requires.txt

@@ -5,7 +5,7 @@ numpy
 pandas>=2.0.0
 pyYAML
 scipy
-shepherd-core[inventory]>=2024.7.3
+shepherd-core[inventory]>=2024.8.1
 tqdm
 
 [dev]