figpack 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

figpack/views/PlotlyFigure.py

@@ -0,0 +1,58 @@
+"""
+PlotlyFigure view for figpack - displays plotly figures
+"""
+
+import zarr
+import json
+import numpy as np
+from typing import Union, Any, Dict
+from datetime import datetime, date
+from ..core.figpack_view import FigpackView
+
+
+class CustomJSONEncoder(json.JSONEncoder):
+    """Custom JSON encoder that handles numpy arrays and datetime objects"""
+
+    def default(self, obj):
+        if isinstance(obj, np.ndarray):
+            return obj.tolist()
+        elif isinstance(obj, (np.integer, np.floating)):
+            return obj.item()
+        elif isinstance(obj, (datetime, date)):
+            return obj.isoformat()
+        elif isinstance(obj, np.datetime64):
+            return str(obj)
+        elif hasattr(obj, "isoformat"):  # Handle other datetime-like objects
+            return obj.isoformat()
+        return super().default(obj)
+
+
+class PlotlyFigure(FigpackView):
+    """
+    A plotly figure visualization component
+    """
+
+    def __init__(self, fig):
+        """
+        Initialize a PlotlyFigure view
+
+        Args:
+            fig: The plotly figure object
+        """
+        self.fig = fig
+
+    def _write_to_zarr_group(self, group: zarr.Group) -> None:
+        """
+        Write the plotly figure data to a Zarr group
+
+        Args:
+            group: Zarr group to write data into
+        """
+        # Set the view type
+        group.attrs["view_type"] = "PlotlyFigure"
+
+        # Convert the plotly figure to a dictionary
+        fig_dict = self.fig.to_dict()
+
+        # Store the figure data as JSON string using custom encoder
+        group.attrs["figure_data"] = json.dumps(fig_dict, cls=CustomJSONEncoder)

figpack/views/__init__.py

@@ -4,3 +4,7 @@ from .Splitter import Splitter
 from .TabLayout import TabLayout
 from .LayoutItem import LayoutItem
 from .TabLayoutItem import TabLayoutItem
+from .Markdown import Markdown
+from .PlotlyFigure import PlotlyFigure
+from .MatplotlibFigure import MatplotlibFigure
+from .Image import Image

figpack-0.1.3.dist-info/METADATA

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: figpack
+Version: 0.1.3
+Summary: A Python package for creating shareable, interactive visualizations in the browser
+Author-email: Jeremy Magland <jmagland@flatironinstitute.org>
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/magland/figpack
+Project-URL: Repository, https://github.com/magland/figpack
+Project-URL: Documentation, https://github.com/magland/figpack#readme
+Project-URL: Bug Tracker, https://github.com/magland/figpack/issues
+Keywords: visualization,plotting,timeseries,interactive
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: zarr
+Requires-Dist: requests
+Dynamic: license-file
+
+# figpack
+
+A Python package for creating shareable, interactive visualizations in the browser.
+
+## Overview
+
+figpack enables you to create interactive data visualizations that can be displayed in a web browser and optionally shared online. The package focuses on timeseries data visualization with support for complex, nested layouts.
+
+### Key Features
+
+- **Interactive timeseries graphs** with line series, markers, and interval plots
+- **Flexible layout system** with boxes, splitters, and tab layouts
+- **Web-based rendering** that works in any modern browser
+- **Shareable visualizations** that can be uploaded and shared via URLs
+- **Zarr-based data storage** for efficient handling of large datasets
+
+## Installation
+
+Install figpack using pip:
+
+```bash
+pip install figpack
+```
+
+## Quick Start
+
+```python
+import numpy as np
+import figpack.views as vv
+
+# Create a timeseries graph
+graph = vv.TimeseriesGraph(y_label="Signal")
+
+# Add some data
+t = np.linspace(0, 10, 1000)
+y = np.sin(2 * np.pi * t)
+graph.add_line_series(name="sine wave", t=t, y=y, color="blue")
+
+# Display the visualization
+graph.show(open_in_browser=True)
+```
+
+## Examples
+
+See the `examples/` directory.
+
+## Usage Modes
+
+### Local Development
+
+```python
+view.show(open_in_browser=True)
+```
+
+### Sharing Online
+
+Set the `FIGPACK_UPLOAD_PASSCODE` environment variable and use:
+
+```python
+view.show(upload=True, open_in_browser=True)
+```
+
+### Development Mode
+
+Set `_dev=True` in the call to show() to enable development mode, which allows for live updates and debugging with figpack-gui.
+
+## Command Line Interface
+
+figpack includes a command-line interface for working with figures:
+
+### Download a Figure
+
+```bash
+figpack download <figure-url> <dest.tar.gz>
+```
+
+Download a figure from any figpack URL and save it as a local archive.
+
+### View a Figure Archive
+
+```bash
+figpack view <figure.tar.gz>
+```
+
+Extract and view a figure archive in your browser. The server will run locally until you press Enter.
+
+Use `--port <number>` to specify a custom port.
+
+## License
+
+Apache-2.0
+
+## Contributing
+
+Visit the [GitHub repository](https://github.com/magland/figpack) for issues, contributions, and the latest updates.

figpack-0.1.3.dist-info/RECORD

@@ -0,0 +1,38 @@
+figpack/__init__.py,sha256=-4qSEkw4VgfVncJfihv21PT13mZzoJFiU3Ou0Uoh3yo,228
+figpack/cli.py,sha256=QCyYeehyWL_TgenCWM86du1bIAMquaCBeGS5AwYa2Fc,10294
+figpack/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+figpack/core/_bundle_utils.py,sha256=9_-xsswlzweJtr5JqZd0KjsCwlQVGNww02Fk6sz0pU4,1911
+figpack/core/_show_view.py,sha256=AZbo1o9xaTXOMijWaMs6gigaHnt9Lgh_ST7ZS7bvTIE,4269
+figpack/core/_upload_bundle.py,sha256=mja1vDGHfgQjmAkJoAUeUxzeZKPRi43KbSmaYZYComM,15303
+figpack/core/figpack_view.py,sha256=N6MO8LpAU8sZlunOE9Ql1SO0JRWrOKuTkeDEFHD2ZFk,2092
+figpack/figpack-gui-dist/index.html,sha256=qtQT4-zp172Zww9NhcSEKp14gKp_GjDqmNJmw9BB3Z8,486
+figpack/figpack-gui-dist/assets/index-BDa2iJW9.css,sha256=9Zg_hJUZuEk-nNZZ7qun6pYlhUySqVDSal9YD8_2vHo,5499
+figpack/figpack-gui-dist/assets/index-ByLxmrzp.js,sha256=ZCtm_eJW4Ahxf4I1BhCHkD3y85qTy_YKBwe8iphKFEM,1471141
+figpack/figpack-gui-dist/assets/neurosift-logo-CLsuwLMO.png,sha256=g5m-TwrGh5f6-9rXtWV-znH4B0nHgc__0GWclRDLUHs,9307
+figpack/spike_sorting/__init__.py,sha256=09njqh-oFaCTdZUsc4HAOFTliUYV9DClddfZ0Q_dm0I,61
+figpack/spike_sorting/views/AutocorrelogramItem.py,sha256=921ZB9Na3XCWTXNelrJwcDjFnuCggXmt84N1GQfy4CI,1036
+figpack/spike_sorting/views/Autocorrelograms.py,sha256=SarNMJeduI2XpSXP8ksODCH776xLyqwNSon443WMfzo,2299
+figpack/spike_sorting/views/CrossCorrelogramItem.py,sha256=Mp00VzW8190kNcYluxcEWDP8neMKc1hEYA3ButmkX5E,1226
+figpack/spike_sorting/views/CrossCorrelograms.py,sha256=gnHjFAFKxr-1UNmfQvPKB18yYkgrkKcYbCryqv-QtA4,2715
+figpack/spike_sorting/views/UnitSimilarityScore.py,sha256=cJA9MkETos9qHhV1tqgA7SfNEaPo-duXYCE76hSFGnA,948
+figpack/spike_sorting/views/UnitsTable.py,sha256=bs6l6olgunMvqyXkXhh1ooBBlD4P70AajkDSyMsexFM,2171
+figpack/spike_sorting/views/UnitsTableColumn.py,sha256=zBnuoeILTuiVLDvtcOxqa37E5WlbR12rlwNJUeWXxY4,847
+figpack/spike_sorting/views/UnitsTableRow.py,sha256=s0UNar7bai3Uz7ufZi3XgAkhxPqW0i8H3F3-_HMBvwU,720
+figpack/spike_sorting/views/__init__.py,sha256=L-r9JCTwPjiwPxKLurTFNecAXDfIXcAASUmy0FrHMr4,630
+figpack/views/Box.py,sha256=6o39JWSls2UscnNFQZXWr_15hdIOCnhanOQgbqMWfVU,2005
+figpack/views/Image.py,sha256=hDW-brx36SyxFTXjA0A_-BGJ0BTVsMg63wGGn37vM9Y,2718
+figpack/views/LayoutItem.py,sha256=XOdvyF9S_Ij1IwxIYOqt4Wk9_wddWTSoM2x5W4kZqTQ,1594
+figpack/views/Markdown.py,sha256=ytwfwygAIuvitV_v-S2IPIJqIFXKTCGHu6EwtRJ8CIU,768
+figpack/views/MatplotlibFigure.py,sha256=hBONRqtfkyO7e47wgFBOo29GLPMk_6VgL6N0H-uQFiU,1937
+figpack/views/PlotlyFigure.py,sha256=Kdn9mGqBO3E2nCta7j7Nohaob3xjOqIS6p-8XSW4vIc,1631
+figpack/views/Splitter.py,sha256=E0mek7RgXtgxdGpFM0evCLtplGwAd70EMfmXX0pcd4o,2005
+figpack/views/TabLayout.py,sha256=d2x2zWGKYdvukW14HOCiU-9C7-N1ED-a1HrRIpSM6Jg,1896
+figpack/views/TabLayoutItem.py,sha256=dvNCdPcRDaDr8LDd8D3zfMudQFbkiAMF0Z7XVcpIhLM,879
+figpack/views/TimeseriesGraph.py,sha256=de85xUz22CeQxslXds5tbTJaZ_tyJlXs5GPPEB-8Fh4,7468
+figpack/views/__init__.py,sha256=fb3k4hiFMfhS5zNPIlQTZJhqFT_v-6bSuPlCpqIpuEk,348
+figpack-0.1.3.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+figpack-0.1.3.dist-info/METADATA,sha256=ZxV-oO8uQRBNa5vyPtpEdvQOr-evnD86bb51mkVRWek,3508
+figpack-0.1.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+figpack-0.1.3.dist-info/entry_points.txt,sha256=l6d3siH2LxXa8qJGbjAqpIZtI5AkMSyDeoRDCzdrUto,45
+figpack-0.1.3.dist-info/top_level.txt,sha256=lMKGaC5xWmAYBx9Ac1iMokm42KFnJFjmkP2ldyvOo-c,8
+figpack-0.1.3.dist-info/RECORD,,

figpack-0.1.3.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+figpack = figpack.cli:main

figpack-0.1.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+figpack