PyPI - figpack - Versions diffs - 0.2.11__py3-none-any.whl → 0.2.13__py3-none-any.whl - Mend

figpack 0.2.11py3-none-any.whl → 0.2.13py3-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 (12) 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-htsKDix1.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/PlotlyExtension/plotly_view.js ADDED Viewed

@@ -0,0 +1,106 @@
+/**
+ * Plotly Extension for figpack
+ * Provides interactive graph visualization using Plotly library
+ */
+const loadFigureData = async (zarrGroup) => {
+    // Get the figure data from the zarr array
+    const data = await zarrGroup.file.getDatasetData(
+        joinPath(zarrGroup.path, "figure_data"),
+        {},
+    );
+    if (!data || data.length === 0) {
+        throw new Error("Empty figure data");
+    }
+    // Convert the uint8 array back to string
+    const uint8Array = new Uint8Array(data);
+    const decoder = new TextDecoder("utf-8");
+    const jsonString = decoder.decode(uint8Array);
+    // Parse the JSON string
+    const parsedData = JSON.parse(jsonString);
+    return parsedData;
+};
+(function() {
+    window.figpackExtensions = window.figpackExtensions || {};
+    window.figpackExtensions['figpack_plotly'] = {
+        render: async function(container, zarrGroup, width, height, onResize) {
+            container.innerHTML = '';
+            try {
+                const figureData = await loadFigureData(zarrGroup);
+                const makePlot = () => {
+                    window.Plotly.newPlot(
+                        container,
+                        figureData.data || [],
+                        {
+                            ...figureData.layout,
+                            width: width,
+                            height: height,
+                            margin: { l: 50, r: 50, t: 50, b: 50 },
+                        },
+                        {
+                            responsive: true,
+                            displayModeBar: true,
+                            displaylogo: false,
+                        },
+                    )
+                };
+                makePlot();
+                // Handle resize events
+                onResize((newWidth, newHeight) => {
+                    window.Plotly.relayout(container, {width: newWidth, height: newHeight});
+                });
+                return {
+                    destroy: () => {
+                        window.Plotly.purge(container);
+                    }
+                };
+            } catch (error) {
+                console.error('Error rendering plotly figure:', error);
+                this.renderError(container, width, height, error.message);
+                return { destroy: () => {} };
+            }
+        },
+        renderError: function(container, width, height, message) {
+            container.innerHTML = `
+                <div style="
+                    width: ${width}px;
+                    height: ${height}px;
+                    display: flex;
+                    align-items: center;
+                    justify-content: center;
+                    background-color: #f8f9fa;
+                    border: 1px solid #dee2e6;
+                    color: #6c757d;
+                    font-family: system-ui, -apple-system, sans-serif;
+                    font-size: 14px;
+                    text-align: center;
+                    padding: 20px;
+                    box-sizing: border-box;
+                ">
+                    <div>
+                        <div style="margin-bottom: 10px; font-weight: 500;">Force Graph Error</div>
+                        <div style="font-size: 12px;">${message}</div>
+                    </div>
+                </div>
+            `;
+        }
+    };
+})();
+const joinPath = function(p1, p2) {
+    if (p1.endsWith('/')) p1 = p1.slice(0, -1);
+    if (p2.startsWith('/')) p2 = p2.slice(1);
+    return p1 + '/' + p2;
+};

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
@@ -118,6 +119,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 +169,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)}")
@@ -253,3 +291,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.11.dist-info → figpack-0.2.13.dist-info}/METADATA RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: figpack
-Version: 0.2.11
+Version: 0.2.13
 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.11.dist-info → figpack-0.2.13.dist-info}/RECORD RENAMED Viewed

@@ -1,4 +1,4 @@
-figpack/__init__.py,sha256=dkV99qgN1ALjjQzp923hMJXVKIivfruPrK_ptSCt7oM,360
+figpack/__init__.py,sha256=Dx3Hx8Y0cLdDNiad3EXUGYb18ZXDSUJ_Zm1-ptbsO8k,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=43TC_xwYZKyIVAPEXf_i-aBzbVOy2RGF1XcrY_qMcrI,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-htsKDix1.js,sha256=0JVZ2euRidkKZCsLe_DgSLQ88sZwY8mUfmFYaz7-aJQ,1624444
 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,13 +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=lFE6FIXXXPC0Ww9GWOvLVxfwXxcNVCybwEoKkiWhe34,17461
 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-0.2.11.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-figpack-0.2.11.dist-info/METADATA,sha256=N8ftHEAJCS8R_5lHx6DxHSr5QQCWqdDAMPjQ6F084JI,3617
-figpack-0.2.11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-figpack-0.2.11.dist-info/entry_points.txt,sha256=l6d3siH2LxXa8qJGbjAqpIZtI5AkMSyDeoRDCzdrUto,45
-figpack-0.2.11.dist-info/top_level.txt,sha256=lMKGaC5xWmAYBx9Ac1iMokm42KFnJFjmkP2ldyvOo-c,8
-figpack-0.2.11.dist-info/RECORD,,
+figpack/views/PlotlyExtension/plotly_view.js,sha256=gCsZS0IaYGTN5a3DC2c4NmzoOxZi1xGfCAYI6WSoFpM,3596
+figpack-0.2.13.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+figpack-0.2.13.dist-info/METADATA,sha256=8TibM4nTAUoW2yQ143TtaPaVV09eP3Z07HmjLhcNmZ4,3617
+figpack-0.2.13.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+figpack-0.2.13.dist-info/entry_points.txt,sha256=l6d3siH2LxXa8qJGbjAqpIZtI5AkMSyDeoRDCzdrUto,45
+figpack-0.2.13.dist-info/top_level.txt,sha256=lMKGaC5xWmAYBx9Ac1iMokm42KFnJFjmkP2ldyvOo-c,8
+figpack-0.2.13.dist-info/RECORD,,

{figpack-0.2.11.dist-info → figpack-0.2.13.dist-info}/WHEEL RENAMED Viewed

File without changes

{figpack-0.2.11.dist-info → figpack-0.2.13.dist-info}/entry_points.txt RENAMED Viewed

File without changes

{figpack-0.2.11.dist-info → figpack-0.2.13.dist-info}/licenses/LICENSE RENAMED Viewed

File without changes

{figpack-0.2.11.dist-info → figpack-0.2.13.dist-info}/top_level.txt RENAMED Viewed

File without changes

figpack 0.2.11__py3-none-any.whl → 0.2.13__py3-none-any.whl

Potentially problematic release.

figpack 0.2.11py3-none-any.whl → 0.2.13py3-none-any.whl