PyPI - figpack - Versions diffs - 0.2.12__py3-none-any.whl → 0.2.14__py3-none-any.whl - Mend

figpack 0.2.12py3-none-any.whl → 0.2.14py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of figpack might be problematic. Click here for more details.

Files changed (11) hide show

figpack/figpack-figure-dist/index.html CHANGED Viewed

@@ -5,7 +5,7 @@
     <link rel="icon" type="image/png" href="./assets/neurosift-logo-CLsuwLMO.png" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>figpack figure</title>
-    <script type="module" crossorigin src="./assets/index-DvunBzII.js"></script>
+    <script type="module" crossorigin src="./assets/index-F6uGre7p.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-D9a3K6eW.css">
   </head>
   <body>

figpack/views/Box.py CHANGED Viewed

@@ -21,6 +21,7 @@ class Box(FigpackView):
         direction: Literal["horizontal", "vertical"] = "vertical",
         show_titles: bool = True,
         items: List[LayoutItem],
+        title: Optional[str] = None,
     ):
         """
         Initialize a Box layout view
@@ -29,6 +30,7 @@ class Box(FigpackView):
             direction: Layout direction - "horizontal" or "vertical"
             show_titles: Whether to show titles for layout items
             items: List of LayoutItem objects containing the child views
+            title: Optional title to display at the top of the box
         Raises:
             ValueError: If direction is not "horizontal" or "vertical"
@@ -39,6 +41,7 @@ class Box(FigpackView):
         self.direction = direction
         self.show_titles = show_titles
         self.items = items
+        self.title = title
     def _write_to_zarr_group(self, group: zarr.Group) -> None:
         """
@@ -53,6 +56,7 @@ class Box(FigpackView):
         # Set layout properties
         group.attrs["direction"] = self.direction
         group.attrs["show_titles"] = self.show_titles
+        group.attrs["title"] = self.title
         # Create a list to store item metadata
         items_metadata = []

figpack/views/TimeseriesGraph.py CHANGED Viewed

@@ -2,7 +2,8 @@
 Views module for figpack - contains visualization components
 """
-from typing import Any, Dict, List, Optional
+import math
+from typing import Any, Dict, List, Optional, Union
 import numpy as np
 import zarr
@@ -22,6 +23,8 @@ class TimeseriesGraph(FigpackView):
         y_range: Optional[List[float]] = None,
         hide_x_gridlines: bool = False,
         hide_y_gridlines: bool = False,
+        hide_nav_toolbar: bool = False,
+        hide_time_axis_labels: bool = False,
         y_label: str = "",
     ):
         """
@@ -32,12 +35,16 @@ class TimeseriesGraph(FigpackView):
             y_range: Y-axis range as [min, max]
             hide_x_gridlines: Whether to hide x-axis gridlines
             hide_y_gridlines: Whether to hide y-axis gridlines
+            hide_nav_toolbar: Whether to hide the navigation toolbar
+            hide_time_axis_labels: Whether to hide time axis labels
             y_label: Label for the y-axis
         """
         self.legend_opts = legend_opts or {}
         self.y_range = y_range
         self.hide_x_gridlines = hide_x_gridlines
         self.hide_y_gridlines = hide_y_gridlines
+        self.hide_nav_toolbar = hide_nav_toolbar
+        self.hide_time_axis_labels = hide_time_axis_labels
         self.y_label = y_label
         # Internal storage for series data
@@ -118,6 +125,41 @@ class TimeseriesGraph(FigpackView):
             )
         )
+    def add_uniform_series(
+        self,
+        *,
+        name: str,
+        start_time_sec: float,
+        sampling_frequency_hz: float,
+        data: np.ndarray,
+        channel_names: Optional[List[str]] = None,
+        colors: Optional[List[str]] = None,
+        width: float = 1.0,
+    ) -> None:
+        """
+        Add a uniform timeseries to the graph with optional multi-channel support
+        Args:
+            name: Base name of the series for legend
+            start_time_sec: Starting time in seconds
+            sampling_frequency_hz: Sampling rate in Hz
+            data: 1D array (single channel) or 2D array (timepoints × channels)
+            channel_names: Optional list of channel names
+            colors: Optional list of colors for each channel
+            width: Line width
+        """
+        self._series.append(
+            TGUniformSeries(
+                name=name,
+                start_time_sec=start_time_sec,
+                sampling_frequency_hz=sampling_frequency_hz,
+                data=data,
+                channel_names=channel_names,
+                colors=colors,
+                width=width,
+            )
+        )
     def _write_to_zarr_group(self, group: zarr.Group) -> None:
         """
         Write the graph data to a Zarr group
@@ -133,6 +175,8 @@ class TimeseriesGraph(FigpackView):
                 series._write_to_zarr_group(series_group)
             elif isinstance(series, TGIntervalSeries):
                 series._write_to_zarr_group(series_group)
+            elif isinstance(series, TGUniformSeries):
+                series._write_to_zarr_group(series_group)
             else:
                 raise ValueError(f"Unknown series type: {type(series)}")
@@ -142,6 +186,8 @@ class TimeseriesGraph(FigpackView):
         group.attrs["y_range"] = self.y_range
         group.attrs["hide_x_gridlines"] = self.hide_x_gridlines
         group.attrs["hide_y_gridlines"] = self.hide_y_gridlines
+        group.attrs["hide_nav_toolbar"] = self.hide_nav_toolbar
+        group.attrs["hide_time_axis_labels"] = self.hide_time_axis_labels
         group.attrs["y_label"] = self.y_label
         # series names
@@ -253,3 +299,243 @@ class TGIntervalSeries:
         group.attrs["series_type"] = "interval"
         group.attrs["color"] = self.color
         group.attrs["alpha"] = self.alpha
+class TGUniformSeries:
+    def __init__(
+        self,
+        *,
+        name: str,
+        start_time_sec: float,
+        sampling_frequency_hz: float,
+        data: np.ndarray,
+        channel_names: Optional[List[str]] = None,
+        colors: Optional[List[str]] = None,
+        width: float = 1.0,
+    ):
+        assert sampling_frequency_hz > 0, "Sampling frequency must be positive"
+        # Handle both 1D and 2D data
+        if data.ndim == 1:
+            # Convert 1D to 2D with single channel
+            data = data.reshape(-1, 1)
+        elif data.ndim == 2:
+            # Already 2D, use as-is
+            pass
+        else:
+            raise ValueError("Data must be 1D or 2D array")
+        n_timepoints, n_channels = data.shape
+        self.name = name
+        self.start_time_sec = start_time_sec
+        self.sampling_frequency_hz = sampling_frequency_hz
+        self.data = data.astype(np.float32)  # Ensure float32 for efficiency
+        # Set channel names
+        if channel_names is None:
+            if n_channels == 1:
+                self.channel_names = [name]
+            else:
+                self.channel_names = [f"{name}_ch_{i}" for i in range(n_channels)]
+        else:
+            assert len(channel_names) == n_channels, (
+                f"Number of channel_names ({len(channel_names)}) must match "
+                f"number of channels ({n_channels})"
+            )
+            self.channel_names = [str(ch_name) for ch_name in channel_names]
+        # Set colors
+        if colors is None:
+            # Default colors for multiple channels
+            default_colors = [
+                "blue",
+                "red",
+                "green",
+                "orange",
+                "purple",
+                "brown",
+                "pink",
+                "gray",
+            ]
+            self.colors = [
+                default_colors[i % len(default_colors)] for i in range(n_channels)
+            ]
+        else:
+            assert len(colors) == n_channels, (
+                f"Number of colors ({len(colors)}) must match "
+                f"number of channels ({n_channels})"
+            )
+            self.colors = colors
+        self.width = width
+        # Prepare downsampled arrays for efficient rendering
+        self.downsampled_data = self._compute_downsampled_data()
+    def _compute_downsampled_data(self) -> dict:
+        """
+        Compute downsampled arrays at power-of-4 factors using a vectorized
+        min/max pyramid with NaN padding for partial bins.
+        Returns:
+            dict: {factor: (ceil(N/factor), 2, M) float32 array}, where the second
+                axis stores [min, max] per bin per channel.
+        """
+        data = self.data  # (N, M), float32
+        n_timepoints, n_channels = data.shape
+        downsampled = {}
+        if n_timepoints < 4:
+            # No level with factor >= 4 fits the stop condition (factor < N)
+            return downsampled
+        def _first_level_from_raw(x: np.ndarray) -> np.ndarray:
+            """Build the factor=4 level directly from the raw data."""
+            N, M = x.shape
+            n_bins = math.ceil(N / 4)
+            pad = n_bins * 4 - N
+            # Pad time axis with NaNs so min/max ignore the padded tail
+            x_pad = np.pad(
+                x, ((0, pad), (0, 0)), mode="constant", constant_values=np.nan
+            )
+            blk = x_pad.reshape(n_bins, 4, M)  # (B, 4, M)
+            mins = np.nanmin(blk, axis=1)  # (B, M)
+            maxs = np.nanmax(blk, axis=1)  # (B, M)
+            out = np.empty((n_bins, 2, M), dtype=np.float32)
+            out[:, 0, :] = mins
+            out[:, 1, :] = maxs
+            return out
+        def _downsample4_bins(level_minmax: np.ndarray) -> np.ndarray:
+            """
+            Build the next pyramid level from the previous one by grouping every 4
+            bins. Input is (B, 2, M) -> Output is (ceil(B/4), 2, M).
+            """
+            B, two, M = level_minmax.shape
+            assert two == 2
+            n_bins_next = math.ceil(B / 4)
+            pad = n_bins_next * 4 - B
+            lvl_pad = np.pad(
+                level_minmax,
+                ((0, pad), (0, 0), (0, 0)),
+                mode="constant",
+                constant_values=np.nan,
+            )
+            blk = lvl_pad.reshape(n_bins_next, 4, 2, M)  # (B', 4, 2, M)
+            # Next mins from mins; next maxs from maxs
+            mins = np.nanmin(blk[:, :, 0, :], axis=1)  # (B', M)
+            maxs = np.nanmax(blk[:, :, 1, :], axis=1)  # (B', M)
+            out = np.empty((n_bins_next, 2, M), dtype=np.float32)
+            out[:, 0, :] = mins
+            out[:, 1, :] = maxs
+            return out
+        # Level 1: factor = 4 from raw data
+        factor = 4
+        level = _first_level_from_raw(data)
+        downsampled[factor] = level
+        # Higher levels: factor *= 4 each time, built from previous level
+        factor *= 4  # -> 16
+        while factor < n_timepoints / 1000:
+            level = _downsample4_bins(level)
+            downsampled[factor] = level
+            factor *= 4
+        return downsampled
+    def _calculate_optimal_chunk_size(
+        self, shape: tuple, target_size_mb: float = 5.0
+    ) -> tuple:
+        """
+        Calculate optimal chunk size for Zarr storage targeting ~5MB per chunk
+        Args:
+            shape: Array shape (n_timepoints, ..., n_channels)
+            target_size_mb: Target chunk size in MB
+        Returns:
+            Tuple of chunk dimensions
+        """
+        # Calculate bytes per element (float32 = 4 bytes)
+        bytes_per_element = 4
+        target_size_bytes = target_size_mb * 1024 * 1024
+        if len(shape) == 2:  # Original data: (n_timepoints, n_channels)
+            n_timepoints, n_channels = shape
+            elements_per_timepoint = n_channels
+        elif len(shape) == 3:  # Downsampled data: (n_timepoints, 2, n_channels)
+            n_timepoints, _, n_channels = shape
+            elements_per_timepoint = 2 * n_channels
+        else:
+            raise ValueError(f"Unsupported shape: {shape}")
+        # Calculate chunk size in timepoints
+        max_timepoints_per_chunk = target_size_bytes // (
+            elements_per_timepoint * bytes_per_element
+        )
+        # Find next lower power of 2
+        chunk_timepoints = 2 ** math.floor(math.log2(max_timepoints_per_chunk))
+        chunk_timepoints = max(chunk_timepoints, 1)  # At least 1
+        chunk_timepoints = min(chunk_timepoints, n_timepoints)  # At most n_timepoints
+        # If n_timepoints is less than our calculated size, round down to next power of 2
+        if chunk_timepoints > n_timepoints:
+            chunk_timepoints = 2 ** math.floor(math.log2(n_timepoints))
+        if len(shape) == 2:
+            return (chunk_timepoints, n_channels)
+        else:  # len(shape) == 3
+            return (chunk_timepoints, 2, n_channels)
+    def _write_to_zarr_group(self, group: zarr.Group) -> None:
+        """
+        Write the uniform series data to a Zarr group
+        Args:
+            group: Zarr group to write data into
+        """
+        group.attrs["series_type"] = "uniform"
+        # Store metadata
+        group.attrs["start_time_sec"] = self.start_time_sec
+        group.attrs["sampling_frequency_hz"] = self.sampling_frequency_hz
+        group.attrs["channel_names"] = self.channel_names
+        group.attrs["colors"] = self.colors
+        group.attrs["width"] = self.width
+        n_timepoints, n_channels = self.data.shape
+        group.attrs["n_timepoints"] = n_timepoints
+        group.attrs["n_channels"] = n_channels
+        # Store original data with optimal chunking
+        original_chunks = self._calculate_optimal_chunk_size(self.data.shape)
+        group.create_dataset(
+            "data",
+            data=self.data,
+            chunks=original_chunks,
+            compression="blosc",
+            compression_opts={"cname": "lz4", "clevel": 5, "shuffle": 1},
+        )
+        # Store downsampled data arrays
+        downsample_factors = list(self.downsampled_data.keys())
+        group.attrs["downsample_factors"] = downsample_factors
+        for factor, downsampled_array in self.downsampled_data.items():
+            dataset_name = f"data_ds_{factor}"
+            # Calculate optimal chunks for this downsampled array
+            ds_chunks = self._calculate_optimal_chunk_size(downsampled_array.shape)
+            group.create_dataset(
+                dataset_name,
+                data=downsampled_array,
+                chunks=ds_chunks,
+                compression="blosc",
+                compression_opts={"cname": "lz4", "clevel": 5, "shuffle": 1},
+            )

{figpack-0.2.12.dist-info → figpack-0.2.14.dist-info}/METADATA RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: figpack
-Version: 0.2.12
+Version: 0.2.14
 Summary: A Python package for creating shareable, interactive visualizations in the browser
 Author-email: Jeremy Magland <jmagland@flatironinstitute.org>
 License: Apache-2.0

{figpack-0.2.12.dist-info → figpack-0.2.14.dist-info}/RECORD RENAMED Viewed

@@ -1,4 +1,4 @@
-figpack/__init__.py,sha256=Cb1XSVRMpZegRqP62Tcld-PGzOpS2AO413SnbaziETg,360
+figpack/__init__.py,sha256=KdJ9_xbzXf9Bpdnm_0yFr6fWOzJY9CHQJRQOkZOZ7jA,360
 figpack/cli.py,sha256=xWF7J2BxUqOLvPu-Kje7Q6oGukTroXsLq8WN8vJgyw0,8321
 figpack/core/__init__.py,sha256=V4wVdyBJ80mi9Rz8HjDSQNkqhqYB6sq4vWH3xQ10kaE,232
 figpack/core/_bundle_utils.py,sha256=16hgTExPLkJCtGjVUCLlnbs_qgns6v01egVr3CEnUXE,6082
@@ -11,9 +11,9 @@ figpack/core/config.py,sha256=oOR7SlP192vuFhYlS-h14HnG-kd_3gaz0vshXch2RNc,173
 figpack/core/extension_view.py,sha256=flFj8X4XuDzzOyeOe3SBddbr_t4wbg1V3vFzJoEVAB4,1995
 figpack/core/figpack_extension.py,sha256=EJHZpe7GsQMUnSvxcYf8374-f6n85F_k1IEelFMRFP8,4332
 figpack/core/figpack_view.py,sha256=X_EtpWTloENfRnDEJcBxXBPditaObv5BWMzO-_stAho,6297
-figpack/figpack-figure-dist/index.html,sha256=KfLOqUjEskQz4IIEBQzZkvKk98OPHw0S0XMewpC5dsE,486
+figpack/figpack-figure-dist/index.html,sha256=XPYsJikUR1-63RUHsg32ruDH-agK82a6YZdCu4J3WDo,486
 figpack/figpack-figure-dist/assets/index-D9a3K6eW.css,sha256=ki61XkOz_TBJnU9Qyk5EgBzh2-_ilZQui2i8DHSarEo,5584
-figpack/figpack-figure-dist/assets/index-DvunBzII.js,sha256=arbzJNLZqctCBHw9XY0xmmOf9Pv7hOvroENh3NMYY4c,1620482
+figpack/figpack-figure-dist/assets/index-F6uGre7p.js,sha256=W3_Ue6DWBr7r7n2--jwQ6ZdOTPr5gsGChqtRI9rXXSA,1625513
 figpack/figpack-figure-dist/assets/neurosift-logo-CLsuwLMO.png,sha256=g5m-TwrGh5f6-9rXtWV-znH4B0nHgc__0GWclRDLUHs,9307
 figpack/franklab/__init__.py,sha256=HkehqGImJE_sE2vbPDo-HbgtEYaMICb9-230xTYvRTU,56
 figpack/franklab/views/TrackAnimation.py,sha256=3Jv1Ri4FIwTyqNahinqhHsBH1Bv_iZrEGx12w6diJ2M,5636
@@ -34,7 +34,7 @@ figpack/spike_sorting/views/UnitsTable.py,sha256=M3y1IDJzSnvOaM1-QOyJOVcUcdTkVvx
 figpack/spike_sorting/views/UnitsTableColumn.py,sha256=zBnuoeILTuiVLDvtcOxqa37E5WlbR12rlwNJUeWXxY4,847
 figpack/spike_sorting/views/UnitsTableRow.py,sha256=rEb2hMTA_pl2fTW1nOvnGir0ysfNx4uww3aekZzfWjk,720
 figpack/spike_sorting/views/__init__.py,sha256=2caaV9yxi97aHoYfUWUYyyIXQSZJRtRVqmPOW9ZeG1I,1159
-figpack/views/Box.py,sha256=TfhPFNtVEq71LCucmWk3XX2WxQLdaeRiWGm5BM0k2l4,2236
+figpack/views/Box.py,sha256=KEItT39xpw0Nl_4NU3WpPmi67wQKVSgiMyB4zAFGf4w,2409
 figpack/views/DataFrame.py,sha256=VFP-EM_Wnc1G3uimVVMJe08KKWCAZe7DvmYf5e07uTk,3653
 figpack/views/Gallery.py,sha256=sHlZbaqxcktasmNsJnuxe8WmgUQ6iurG50JiChKSMbQ,3314
 figpack/views/GalleryItem.py,sha256=b_upJno5P3ANSulbG-h3t6Xj56tPGJ7iVxqyiZu3zaQ,1244
@@ -47,14 +47,14 @@ figpack/views/Spectrogram.py,sha256=GfTNinkuMFu4dxn35MvSB4Perz84sx4LMcjUrOviz6c,
 figpack/views/Splitter.py,sha256=x9jLCTlIvDy5p9ymVd0X48KDccyD6bJANhXyFgKEmtE,2007
 figpack/views/TabLayout.py,sha256=5g3nmL95PfqgI0naqZXHMwLVo2ebDlGX01Hy9044bUw,1898
 figpack/views/TabLayoutItem.py,sha256=xmHA0JsW_6naJze4_mQuP_Fy0Nm17p2N7w_AsmVRp8k,880
-figpack/views/TimeseriesGraph.py,sha256=OAaCjO8fo86u_gO_frNfRGxng3tczxGDGKcJEvZo3rE,7469
+figpack/views/TimeseriesGraph.py,sha256=nfmlh4LYB4Ut7htMZTtArqxUAsh66TW8dSx7jE3vdRI,17929
 figpack/views/__init__.py,sha256=nyd3Ot2x702W4j9oBN0lK6i0DZzg9Ai41XoYCm5DeQ8,546
 figpack/views/PlotlyExtension/PlotlyExtension.py,sha256=_-GiqzHFb9uF1O6RNKEkd85SX8z9z5kFOh8tO_9aAbk,3778
 figpack/views/PlotlyExtension/__init__.py,sha256=80Wy1mDMWyagjuR99ECxJePIYpRQ6TSyHkB0uZoBZ_0,70
 figpack/views/PlotlyExtension/plotly_view.js,sha256=gCsZS0IaYGTN5a3DC2c4NmzoOxZi1xGfCAYI6WSoFpM,3596
-figpack-0.2.12.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-figpack-0.2.12.dist-info/METADATA,sha256=IyjYIuqCQXp3_TFeUyfEI7XV6Ac6oJum5wq5Qo_lqN8,3617
-figpack-0.2.12.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-figpack-0.2.12.dist-info/entry_points.txt,sha256=l6d3siH2LxXa8qJGbjAqpIZtI5AkMSyDeoRDCzdrUto,45
-figpack-0.2.12.dist-info/top_level.txt,sha256=lMKGaC5xWmAYBx9Ac1iMokm42KFnJFjmkP2ldyvOo-c,8
-figpack-0.2.12.dist-info/RECORD,,
+figpack-0.2.14.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+figpack-0.2.14.dist-info/METADATA,sha256=oJeyH6JXAlLFa7evpVpDEHuFzDnNrpeKd4jv0llhxuM,3617
+figpack-0.2.14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+figpack-0.2.14.dist-info/entry_points.txt,sha256=l6d3siH2LxXa8qJGbjAqpIZtI5AkMSyDeoRDCzdrUto,45
+figpack-0.2.14.dist-info/top_level.txt,sha256=lMKGaC5xWmAYBx9Ac1iMokm42KFnJFjmkP2ldyvOo-c,8
+figpack-0.2.14.dist-info/RECORD,,

{figpack-0.2.12.dist-info → figpack-0.2.14.dist-info}/WHEEL RENAMED Viewed

File without changes

{figpack-0.2.12.dist-info → figpack-0.2.14.dist-info}/entry_points.txt RENAMED Viewed

File without changes

{figpack-0.2.12.dist-info → figpack-0.2.14.dist-info}/licenses/LICENSE RENAMED Viewed

File without changes

{figpack-0.2.12.dist-info → figpack-0.2.14.dist-info}/top_level.txt RENAMED Viewed

File without changes

figpack 0.2.12__py3-none-any.whl → 0.2.14__py3-none-any.whl

Potentially problematic release.

figpack 0.2.12py3-none-any.whl → 0.2.14py3-none-any.whl