figpack 0.3.4__tar.gz → 0.3.6__tar.gz

{figpack-0.3.4/figpack.egg-info → figpack-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: figpack
-Version: 0.3.4
+Version: 0.3.6
 Summary: A Python package for creating shareable, interactive visualizations in the browser
 Author-email: Jeremy Magland <jmagland@flatironinstitute.org>
 License: Apache-2.0
@@ -133,7 +133,7 @@ If you use figpack in your research, please cite it:
 
 Or in APA format:
 
-> Magland, J. (2025). figpack (Version 0.3.4) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.17419621
+> Magland, J. (2025). figpack (Version 0.3.6) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.17419621
 
 ## Contributing
 

{figpack-0.3.4 → figpack-0.3.6}/README.md

@@ -57,7 +57,7 @@ If you use figpack in your research, please cite it:
 
 Or in APA format:
 
-> Magland, J. (2025). figpack (Version 0.3.4) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.17419621
+> Magland, J. (2025). figpack (Version 0.3.6) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.17419621
 
 ## Contributing
 

{figpack-0.3.4 → figpack-0.3.6}/figpack/__init__.py

@@ -2,7 +2,7 @@
 figpack - A Python package for creating shareable, interactive visualizations in the browser
 """
 
-__version__ = "0.3.4"
+__version__ = "0.3.6"
 
 from .cli import view_figure
 from .core import FigpackView, FigpackExtension, ExtensionView

figpack-0.3.6/figpack/core/zarr.py

@@ -0,0 +1,129 @@
+from typing import Any, Dict
+import numpy as np
+
+
+_UNSPECIFIED = object()
+
+
+class Group:
+    def __init__(self, zarr_group):
+        self._zarr_group = zarr_group
+
+    def create_group(self, name: str) -> "Group":
+        return Group(self._zarr_group.create_group(name))
+
+    def create_dataset(
+        self,
+        name: str,
+        *,
+        data=_UNSPECIFIED,
+        dtype=_UNSPECIFIED,
+        chunks=_UNSPECIFIED,
+        compressor=_UNSPECIFIED,
+    ) -> None:
+        kwargs = {}
+        if data is not _UNSPECIFIED:
+            kwargs["data"] = data
+        if dtype is not _UNSPECIFIED:
+            kwargs["dtype"] = dtype
+        if chunks is not _UNSPECIFIED:
+            kwargs["chunks"] = chunks
+        else:
+            if data is not _UNSPECIFIED:
+                chunks2 = _get_optimal_chunk_size(data.shape, data.dtype)
+                if chunks2 is not _UNSPECIFIED:
+                    kwargs["chunks"] = chunks2
+        if compressor is not _UNSPECIFIED:
+            kwargs["compressor"] = compressor
+        if _check_zarr_version() == 2:
+            self._zarr_group.create_dataset(name, **kwargs)
+        elif _check_zarr_version() == 3:
+            self._zarr_group.create_array(name, **kwargs)  # type: ignore
+        else:
+            raise RuntimeError("Unsupported Zarr version")
+
+    @property
+    def attrs(self) -> Dict[str, Any]:
+        return self._zarr_group.attrs  # type: ignore
+
+    def __getitem__(self, key: str) -> Any:
+        return self._zarr_group[key]
+
+    # implement in operator
+    def __contains__(self, key: str) -> bool:
+        return key in self._zarr_group
+
+    def __iter__(self):
+        return iter(self._zarr_group)
+
+    def __reversed__(self):
+        return reversed(self._zarr_group)
+
+
+def _check_zarr_version():
+    import zarr
+
+    version = zarr.__version__
+    major_version = int(version.split(".")[0])
+    return major_version
+
+
+def _get_optimal_chunk_size(shape: tuple, dtype) -> tuple:
+    """Compute an optimal chunk shape targeting ~5 MB per chunk,
+    chunking along only one dimension and avoiding mostly empty chunks.
+    """
+    target_bytes = 5 * 1024 * 1024  # 5 MB
+
+    if np.prod(shape) <= 1:
+        # all dimensions are zero or one
+        # return shape of unspecified to let zarr choose on this edge case
+        return _UNSPECIFIED
+
+    # Ensure dtype is a numpy dtype to get itemsize
+    if isinstance(dtype, str):
+        dtype = np.dtype(dtype)
+
+    itemsize = np.dtype(dtype).itemsize
+
+    # Total array size in bytes
+    total_bytes = np.prod(shape) * itemsize
+    if total_bytes <= target_bytes:
+        # Entire array fits comfortably in one chunk
+        return shape
+
+    # Choose the first non-singleton dimension to chunk along
+    for axis, dim in enumerate(shape):
+        if dim > 1:
+            break
+    else:
+        return shape  # all singleton
+
+    # Compute how many elements fit in target_bytes
+    target_elements = target_bytes // itemsize
+
+    # Compute product of all other dimensions (fixed)
+    other_size = np.prod(shape) // shape[axis]
+
+    # Determine chunk length along chosen axis
+    chunk_len = max(1, min(shape[axis], target_elements // other_size))
+
+    # Construct chunk shape
+    chunk_shape = list(shape)
+    chunk_shape[axis] = chunk_len
+
+    return tuple([int(c) for c in chunk_shape])
+
+
+if __name__ == "__main__":
+    # Test the _get_optimal_chunk_size function for a variety of shapes and dtypes
+    test_cases = [
+        ((1000, 1000), np.float32),
+        ((5000, 2000), np.uint8),
+        ((100, 100, 100), np.float64),
+        ((10, 30, 30, 1500), np.int16),
+        ((1, 1, 1), np.float32),
+    ]
+
+    for shape, dtype in test_cases:
+        chunk_size = _get_optimal_chunk_size(shape, dtype)
+        print(f"Optimal chunk size for shape {shape} and dtype {dtype}: {chunk_size}")

figpack-0.3.6/figpack/figpack-figure-dist/assets/index-BQ9mn8rh.css

@@ -0,0 +1 @@
+.unitEntryBase{padding-right:13px;padding-top:10px}.unselectedUnitEntry{border:1px transparent solid;font-weight:400;color:#000;background-color:#fff}.selectedUnitEntry{border:1px solid blue;font-weight:700;color:#000;background-color:#b5d1ff}.unitIdsColumnLabelStyle{min-width:200px;font-weight:700;padding:7px 5px}.unitLabelsStyle{padding-right:3px;color:#333}.plotUnitLabel{text-align:left;margin-left:20px;margin-top:5px;font-weight:700}.plotWrapperButtonParent{display:inline-block}.plotWrapperStyleButton{padding-top:50px}.plotUnselectedStyle{border:3px solid rgb(202,224,231)}.plotSelectedStyle{border:3px solid #9999ff;background-color:#fff}.plotUnselectableStyle{border:3px solid transparent}.plotCurrentStyle{border:3px solid blue;background-color:#fff}.plotLabelStyle{font-weight:700;text-align:center;overflow:hidden;white-space:nowrap}:root{font-family:system-ui,Avenir,Helvetica,Arial,sans-serif;line-height:1.5;font-weight:400;color:#213547;background-color:#fff;font-synthesis:none;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}a{font-weight:500;color:#646cff;text-decoration:inherit}a:hover{color:#747bff}body{margin:0;overflow:hidden}h1{font-size:3.2em;line-height:1.1}button{border-radius:8px;border:1px solid transparent;padding:.6em 1.2em;font-size:1em;font-weight:500;font-family:inherit;background-color:#f9f9f9;cursor:pointer;transition:border-color .25s}button:hover{border-color:#646cff}button:focus,button:focus-visible{outline:4px auto -webkit-focus-ring-color}.status-bar{position:fixed;left:0;right:0;height:30px;background-color:#f5f5f5;color:#333;display:flex;align-items:center;padding:0 12px;font-size:12px;border-top:1px solid #ddd;z-index:1000}.status-bar.warning{background-color:#fff3cd;color:#856404;border-top:1px solid #ffeaa7}.status-bar.error,.status-bar.expired{background-color:#f8d7da;color:#721c24;border-top:1px solid #f5c6cb}.manage-button{background-color:#e0e0e0;color:#333;border:1px solid #ccc;padding:4px 8px;border-radius:4px;cursor:pointer;font-size:11px;height:22px;margin-left:12px;transition:background-color .2s}.manage-button:hover{background-color:#d0d0d0}.about-button{background-color:#e0e0e0;color:#333;border:1px solid #ccc;padding:4px 8px;border-radius:4px;cursor:pointer;font-size:11px;height:22px;margin-left:12px;transition:background-color .2s}.about-button:hover{background-color:#d0d0d0}.about-dialog-overlay{position:fixed;inset:0;background-color:#00000080;display:flex;justify-content:center;align-items:center;z-index:2000}.about-dialog{background-color:#fff;color:#333;border-radius:8px;max-width:600px;max-height:80vh;width:90%;box-shadow:0 4px 20px #00000026;overflow:hidden}.about-dialog-header{display:flex;justify-content:space-between;align-items:center;padding:16px 20px;border-bottom:1px solid #ddd}.about-dialog-header h2{margin:0;font-size:18px;font-weight:600}.about-dialog-close{background:none;border:none;color:#333;font-size:24px;cursor:pointer;padding:0;width:30px;height:30px;display:flex;align-items:center;justify-content:center;border-radius:4px;transition:background-color .2s}.about-dialog-close:hover{background-color:#f0f0f0}.about-dialog-content{padding:20px;overflow-y:auto;max-height:calc(80vh - 80px)}.about-dialog-description{line-height:1.6}.about-dialog-description h1,.about-dialog-description h2,.about-dialog-description h3{margin-top:0;margin-bottom:12px}.about-dialog-description p{margin-bottom:12px}.about-dialog-description code{background-color:#f5f5f5;color:#333;padding:2px 4px;border-radius:3px;font-family:Courier New,monospace;font-size:.9em}.about-dialog-description pre{background-color:#f5f5f5;color:#333;padding:12px;border-radius:4px;overflow-x:auto;margin-bottom:12px}.about-dialog-description ul,.about-dialog-description ol{margin-bottom:12px;padding-left:20px}.about-dialog-description blockquote{border-left:4px solid #ccc;padding-left:16px;margin:12px 0;font-style:italic}.manage-edits-view{display:flex;align-items:center;margin-left:12px}.edits-notification{color:#e65100;font-weight:500;margin-right:8px}.save-changes-button{background-color:#ff9800;color:#fff;border:1px solid #f57c00;padding:4px 8px;border-radius:4px;cursor:pointer;font-size:11px;height:22px;transition:background-color .2s}.save-changes-button:hover{background-color:#f57c00}.dialog-overlay{position:fixed;inset:0;background-color:#00000080;display:flex;justify-content:center;align-items:center;z-index:2000}.dialog-content{background-color:#fff;color:#333;border-radius:8px;max-width:500px;width:90%;box-shadow:0 4px 20px #00000026;overflow:hidden}.dialog-header{display:flex;justify-content:space-between;align-items:center;padding:16px 20px;border-bottom:1px solid #ddd}.dialog-header h3{margin:0;font-size:18px;font-weight:600}.dialog-close{background:none;border:none;color:#333;font-size:24px;cursor:pointer;padding:0;width:30px;height:30px;display:flex;align-items:center;justify-content:center;border-radius:4px;transition:background-color .2s}.dialog-close:hover{background-color:#f0f0f0}.dialog-body{padding:20px}.dialog-body p{margin:0 0 12px;line-height:1.5}.dialog-footer{padding:16px 20px;border-top:1px solid #ddd;display:flex;justify-content:flex-end}.dialog-button{background-color:#e0e0e0;color:#333;border:1px solid #ccc;padding:8px 16px;border-radius:4px;cursor:pointer;font-size:14px;transition:background-color .2s}.dialog-button:hover{background-color:#d0d0d0}.dialog-fullscreen{position:fixed;inset:0;background-color:#fff;color:#333;z-index:2000;display:flex;flex-direction:column}.dialog-content-fullscreen{display:flex;flex-direction:column;height:100%;overflow:hidden}.dialog-content-fullscreen .dialog-header{flex-shrink:0}.dialog-content-fullscreen .dialog-body{flex:1;overflow-y:auto;padding:20px}.dialog-content-fullscreen .dialog-footer{flex-shrink:0}