hiplot-plus 0.1.0__py3-none-any.whl

hiplot/static/built/streamlit_component/index.html

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="theme-color" content="#000000" />
+    <meta name="description" content="Streamlit Component" />
+    <title>Streamlit Component</title>
+  </head>
+  <body>
+    <noscript>You need to enable JavaScript to run this app.</noscript>
+    <div id="root"></div>
+
+    <script src="hiplot_streamlit.bundle.js" type="text/javascript"></script>
+  </body>
+</html>

hiplot/streamlit_helpers.py

@@ -0,0 +1,127 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+import json
+import typing as tp
+import uuid
+import warnings
+from pathlib import Path
+
+from .experiment import Experiment, _is_running_ipython
+
+
+class _StreamlitHelpers:
+    component: tp.Callable[..., tp.Any] | None = None
+
+    @staticmethod
+    def is_running_within_streamlit() -> bool:
+        try:
+            from streamlit import runtime
+        except ImportError:
+            return False
+        return bool(runtime.exists())
+
+    @classmethod
+    def create_component(cls) -> tp.Callable[..., tp.Any]:
+        if cls.component is not None:
+            return cls.component
+        try:
+            from streamlit import runtime
+        except ImportError as e:
+            raise ImportError(
+                "Streamlit is required for Streamlit support. Install it with: pip install hiplot-plus[streamlit]"
+            ) from e
+        try:
+            import streamlit.components.v1 as components
+        except ModuleNotFoundError as e:
+            import streamlit as st
+
+            raise RuntimeError(f"""Your streamlit version ({st.__version__}) is too old and does not support components.
+Please update streamlit with `pip install -U streamlit`""") from e
+        assert runtime.exists()
+
+        built_path = (Path(__file__).parent / "static" / "built" / "streamlit_component").resolve()
+        assert (built_path / "index.html").is_file(), f"""HiPlot component does not appear to exist in {built_path}
+If you did not install hiplot using official channels (pip, conda...), maybe you forgot to build javascript files?
+See https://poipoi300.github.io/hiplot/contributing.html#building-javascript-bundle
+"""
+        component: tp.Callable[..., tp.Any] = components.declare_component("hiplot", path=str(built_path))
+        cls.component = component
+        return component
+
+
+class ExperimentStreamlitComponent:
+    def __init__(self, experiment: Experiment, key: str | None, ret: str | list[str] | None) -> None:
+        if key is None:
+            warnings.warn(
+                r"""Creating a HiPlot component with key=None will make refreshes slower.
+Please use `experiment.to_streamlit(..., key=\"some_unique_key\")`""",
+                stacklevel=3,
+            )
+            key = f"hiplot_autogen_{uuid.uuid4()!s}"
+        self._exp_json = json.dumps(experiment._payload(), allow_nan=False)
+        self._key = key
+        self._ret = ret
+        self._js_default_ret = tuple(self.get_default_return_for(experiment, ret=r) for r in self.js_ret_spec)
+
+    @property
+    def js_ret_spec(self) -> list[str]:
+        if self._ret is None:
+            return []
+        if isinstance(self._ret, str):
+            return [self._ret]
+        assert isinstance(self._ret, (tuple, list)), (
+            "HiPlot: Invalid return type specification. Should be `None`, a string, a list or a tuple."
+        )
+        return list(self._ret)
+
+    @classmethod
+    def get_default_return(cls, experiment: Experiment, ret: str | list[str] | None) -> tp.Any:
+        if ret is None:
+            return None
+        if isinstance(ret, str):
+            return cls.get_default_return_for(experiment, ret)
+        assert isinstance(ret, (tuple, list)), (
+            "HiPlot: Invalid return type specification. Should be `None`, a string, a list or a tuple."
+        )
+        return tuple(cls.get_default_return(experiment, r) for r in ret)
+
+    @staticmethod
+    def get_default_return_for(experiment: Experiment, ret: str) -> tp.Any:
+        if ret == "brush_extents":
+            return ()
+        if ret in ["selected_uids", "filtered_uids"]:
+            return tuple(dp.uid for dp in experiment.datapoints)
+        raise RuntimeError(f'HiPlot: Unknown return type "{ret}"')
+
+    def display(self) -> tp.Any:
+        if not _StreamlitHelpers.is_running_within_streamlit():
+            if _is_running_ipython():
+                raise RuntimeError(r"""`experiment.display_st` can only be called in a streamlit script.
+It appears that you are trying to create a HiPlot visualization in ipython:
+you should use `display` instead of `display_st`""")
+            raise RuntimeError(r"""`experiment.display_st` can only be called in a streamlit script.
+To render an experiment to HTML, use `experiment.to_html(file_name)` or `html_page = experiment.to_html()`""")
+
+        component = _StreamlitHelpers.create_component()
+
+        js_ret = component(experiment=self._exp_json, ret=self.js_ret_spec, key=self._key)
+
+        if js_ret is None:
+            js_ret = self._js_default_ret
+        assert len(self._js_default_ret) == len(js_ret), (
+            f"JS returned {len(js_ret)} fields, expected {len(self._js_default_ret)} (ret={self._ret})"
+        )
+
+        for idx in range(len(self.js_ret_spec)):
+            if js_ret[idx] is not None:
+                continue
+            # Use default value
+            js_ret = self._js_default_ret[idx]
+
+        if not js_ret:
+            return None
+        if isinstance(self._ret, str):
+            return js_ret[0]
+        return js_ret

hiplot/templates/index.html

@@ -0,0 +1,68 @@
+<!doctype html>
+<html>
+  <head>
+    <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
+    <title>HiPlot</title>
+    <link rel="icon" href="static/icon.png" />
+    <style>
+      /*
+       * Only when HiPlot is the whole page: a notebook embeds this markup in its
+       * own body, where these selectors match nothing. The HiPlot theme fills
+       * the viewport; until it renders, the page follows the system theme.
+       */
+      body:has(> .hiplot-page) {
+        margin: 0;
+      }
+      body > .hiplot-page {
+        display: flex;
+        flex-direction: column;
+        min-height: 100vh;
+      }
+      body > .hiplot-page > * {
+        flex: 1 0 auto;
+      }
+      @media (prefers-color-scheme: dark) {
+        body:has(> .hiplot-page) {
+          background: #15181c;
+          color: #e4e7eb;
+        }
+      }
+    </style>
+  </head>
+  <body>
+    <div id="hiplot_element_id" class="hiplot-page">
+      <div style="text-align: center">Loading HiPlot...</div>
+      <noscript> HiPlot needs JavaScript to run </noscript>
+    </div>
+
+    <!--HIPLOT_DATA-->
+    <script src="static/built/hiplot.bundle.js" type="text/javascript">
+      /*BUNDLE_FILE*/
+    </script>
+    <script type="text/javascript">
+      function _hiplot_setup() {
+        if (typeof hiplot == "undefined") {
+          console.info("waiting for HiPlot bundle to be loaded...");
+          setTimeout(_hiplot_setup, 1000);
+          return;
+        }
+        var options = {};
+        var _sp = new URLSearchParams(location.search);
+        var _provider = _sp.get("provider");
+        if (_provider) {
+          options.dataProviderName = _provider;
+        }
+        /*ON_LOAD_SCRIPT_INJECT*/
+        var hiplot_instance = hiplot.render(document.getElementById("hiplot_element_id"), options);
+        Object.assign(window, { hiplot_last_instance: hiplot_instance }); // For debugging
+        /*AFTER_SETUP_SCRIPT_INJECT*/
+      }
+      if (document.readyState == "loading") {
+        document.addEventListener("DOMContentLoaded", _hiplot_setup);
+      } else {
+        // Either "complete" or "interactive"
+        _hiplot_setup();
+      }
+    </script>
+  </body>
+</html>

hiplot_plus-0.1.0.dist-info/METADATA

@@ -0,0 +1,197 @@
+Metadata-Version: 2.5
+Name: hiplot-plus
+Version: 0.1.0
+Summary: High dimensional Interactive Plotting tool
+Project-URL: Homepage, https://github.com/poipoi300/hiplot
+Project-URL: Documentation, https://poipoi300.github.io/hiplot/
+Project-URL: Repository, https://github.com/poipoi300/hiplot
+Author: Facebook AI Research, mathematicalmichael @ Mind the Math, LLC
+License-Expression: MIT
+License-File: LICENSE
+License-File: NOTICE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.12
+Requires-Dist: beautifulsoup4
+Requires-Dist: jinja2>=3.1.6
+Provides-Extra: all
+Requires-Dist: flask; extra == 'all'
+Requires-Dist: flask-compress; extra == 'all'
+Requires-Dist: ipykernel; extra == 'all'
+Requires-Dist: ipython>=7.0.1; extra == 'all'
+Requires-Dist: streamlit>=0.63; extra == 'all'
+Provides-Extra: notebook
+Requires-Dist: ipykernel; extra == 'notebook'
+Requires-Dist: ipython>=7.0.1; extra == 'notebook'
+Provides-Extra: server
+Requires-Dist: flask; extra == 'server'
+Requires-Dist: flask-compress; extra == 'server'
+Provides-Extra: streamlit
+Requires-Dist: streamlit>=0.63; extra == 'streamlit'
+Description-Content-Type: text/markdown
+
+# HiPlot - High dimensional Interactive Plotting
+
+## About this fork
+
+Thanks to [Facebook Research](https://github.com/facebookresearch/hiplot) for creating HiPlot, and to [Mind the Math](https://github.com/mindthemath/hiplot) for keeping it alive after the original was archived. This fork builds on their work; it is not affiliated with either.
+
+What changed:
+
+- **Rendering:** WebGL2 density lines with exact anti-aliasing and colors mapped by value, with a choice of what overlapping lines show (mean, lowest or highest). 100,000 rows by 30 columns stay interactive.
+- **Parallel plot:** several brushes per axis, value tags on brushes, axes that face the color gradient (high colors at the top), horizontal scrolling with middle-click autoscroll, spline lines and a searchable Columns menu.
+- **Scatter plots:** XY, one-axis and 3D panels with lasso selection, a shared axis picker and correlation and regression fits.
+- **Table:** multi-level sorting, column filters and aligned numbers.
+- **Look:** a redesigned light and dark theme, colorblind-safe palettes and a color legend.
+- **Data:** compact columnar transfer, NaN, inf and missing-value spellings read as such, numeric uids.
+- **Example:** a real GPU hyperparameter search in [examples/hptuning](examples/hptuning), with trials stored as Parquet.
+- **Engineering:** Python 3.12 to 3.15, ruff and mypy --strict, TypeScript strict and Biome, Playwright browser tests, and commit and push gates requiring 90% coverage of changed lines across all suites.
+
+
+![Logo](https://raw.githubusercontent.com/poipoi300/hiplot/main/hiplot/static/logo.png)
+
+[![CI](https://github.com/poipoi300/hiplot/actions/workflows/ci.yml/badge.svg)](https://github.com/poipoi300/hiplot/actions/workflows/ci.yml)
+[![Release](https://github.com/poipoi300/hiplot/actions/workflows/release.yml/badge.svg)](https://github.com/poipoi300/hiplot/actions/workflows/release.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT)
+[![PyPI version](https://img.shields.io/pypi/v/hiplot-plus.svg)](https://pypi.python.org/pypi/hiplot-plus/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/hiplot-plus.svg)](https://pypi.python.org/pypi/hiplot-plus/)
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/poipoi300/hiplot/blob/main/examples/HiPlotColabExample.ipynb)
+
+> **Community-maintained fork**: This is a community-maintained fork of [Facebook Research's HiPlot](https://github.com/facebookresearch/hiplot), which has been archived. We aim to keep the project alive with bug fixes, security updates, and new features.
+
+HiPlot is a lightweight interactive visualization tool to help AI researchers discover correlations and patterns in high-dimensional data using parallel plots and other graphical ways to represent information.
+
+### [Try a demo now with sweep data](https://poipoi300.github.io/hiplot/_static/demo/ml1.csv.html) or [upload your CSV](https://poipoi300.github.io/hiplot/_static/hiplot_upload.html) or [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/poipoi300/hiplot/blob/main/examples/HiPlotColabExample.ipynb)
+
+There are several modes to HiPlot:
+
+- As a web-server (if your data is a CSV for instance)
+- In a jupyter notebook (to visualize python data), or in [Streamlit apps](https://poipoi300.github.io/hiplot/tuto_streamlit.html)
+- In CLI to render standalone HTML
+
+## Quick Start
+
+```bash
+# Render a CSV to interactive HTML (no install needed)
+uvx hiplot-plus data.csv > output.html
+
+# Or start an interactive server
+uvx --from 'hiplot-plus[server]' hiplot --port 8765
+```
+
+## Installation
+
+```bash
+# Core package (HTML export, CLI rendering)
+pip install hiplot-plus
+
+# With Jupyter notebook support
+pip install hiplot-plus[notebook]
+
+# With web server support (hiplot command)
+pip install hiplot-plus[server]
+
+# With Streamlit support
+pip install hiplot-plus[streamlit]
+
+# Everything
+pip install hiplot-plus[all]
+```
+
+If you have a Jupyter notebook, you can get started with something as simple as:
+
+```python
+import hiplot as hip
+
+data = [
+    {"dropout": 0.1, "lr": 0.001, "loss": 10.0, "optimizer": "SGD"},
+    {"dropout": 0.15, "lr": 0.01, "loss": 3.5, "optimizer": "Adam"},
+    {"dropout": 0.3, "lr": 0.1, "loss": 4.5, "optimizer": "Adam"},
+]
+exp = hip.Experiment.from_iterable(data)
+exp.colorby = "loss"
+exp.display()
+```
+
+### [See the live result](https://poipoi300.github.io/hiplot/_static/demo/demo_basic_usage.html)
+
+![Result](https://raw.githubusercontent.com/poipoi300/hiplot/main/assets/notebook.png)
+
+## Links
+
+- Repository: https://github.com/poipoi300/hiplot
+- Documentation: https://poipoi300.github.io/hiplot/
+- PyPI package: https://pypi.org/project/hiplot-plus/
+- Examples: https://github.com/poipoi300/hiplot/tree/main/examples
+- Original blog post: https://ai.facebook.com/blog/hiplot-high-dimensional-interactive-plots-made-easy/
+
+## Development
+
+HiPlot is Python 3.12+ (built with [uv](https://docs.astral.sh/uv/)) plus a
+TypeScript frontend (React, d3, built with [Bun](https://bun.sh) and Vite).
+Contributor rules, including for coding agents, are in [AGENTS.md](AGENTS.md).
+
+```bash
+bun install && uv sync          # dependencies
+bun run build                   # JavaScript bundles into hiplot/static/built/
+uv run pre-commit install -t pre-commit -t pre-push   # quality gates, once
+uv run --extra server hiplot --port 8765              # dev server (load `demo`)
+```
+
+| Task | Command |
+|---|---|
+| Python tests | `uv run pytest` |
+| Frontend unit tests | `bun test` |
+| End-to-end tests (Playwright) | `bun run test:js` |
+| Format and lint | `uv run ruff format . && uv run ruff check .` · `bun run biome check --write .` |
+| Type checks | `uv run mypy .` · `bun run typecheck` |
+| Every commit gate | `uv run pre-commit run --all-files` |
+| Tests + 90% diff coverage (push gate) | `bash tools/stack_coverage_gate.sh` |
+| Rendering benchmark | `bash bench/run.sh` (results in [docs/PERFORMANCE.md](docs/PERFORMANCE.md)) |
+| Docs | `uv run --no-default-groups --group docs sphinx-build -b html docs docs/_build/html` |
+| Package | `bun run build && uv build` (or `./build.sh`, which also emits the npm types) |
+
+Commits run the fast gates (hygiene, ruff, mypy --strict, Biome, tsc
+--strict); pushes run pytest, `bun test` and Playwright under coverage and
+require 90% coverage of changed lines across all suites. Playwright and the
+combined coverage gate run locally and before pushes only. Hosted CI runs
+lint, types, Python and Bun unit tests, builds, Python 3.12 to 3.15, Windows,
+package installs and the docs build.
+
+**Output directories:** `hiplot/static/built/` (bundles shipped in the
+wheel), `dist/` (wheel and sdist), `npm-dist/` (npm package).
+
+## Citing
+
+```bibtex
+@misc{hiplot,
+    author = {Haziza, D. and Rapin, J. and Synnaeve, G.},
+    title = {{Hiplot, interactive high-dimensionality plots}},
+    year = {2020},
+    publisher = {GitHub},
+    journal = {GitHub repository},
+    howpublished = {\url{https://github.com/facebookresearch/hiplot}},
+}
+```
+
+## Credits
+
+Inspired by and based on code from [Kai Chang](http://bl.ocks.org/syntagmatic/3150059), [Mike Bostock](http://bl.ocks.org/1341021) and [Jason Davies](http://bl.ocks.org/1341281).
+
+External contributors (_please add your name when you submit your first pull request_):
+
+- [louismartin](https://github.com/louismartin)
+- [GoldenCorgi](https://github.com/GoldenCorgi)
+- [callistachang](https://github.com/callistachang)
+
+## License
+
+HiPlot is [MIT](LICENSE) licensed, as found in the [LICENSE](LICENSE) file.

hiplot_plus-0.1.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+hiplot/__init__.py,sha256=5AY97SbCpTuip_Svp21JB3EI8b7amNRgbXw654oPXMo,952
+hiplot/__main__.py,sha256=FAkGchVzZEBymfIhYWSvZTR1xQmEH1-PGjukAm85CrI,328
+hiplot/compress.py,sha256=cAYvA2k6G_1jHL70a_-IbDBzDu3eZJV_FW0NJ8-DrL0,2696
+hiplot/csvvalues.py,sha256=6JEyLElLXgc-sJ643gkcZS2HQJUA2oJ1on8BG5ICkI8,3101
+hiplot/experiment.py,sha256=-B7HCa6qncYlygz8yto0OnbZwkD0WRH4xJr5Bjmw-X8,24848
+hiplot/fetchers.py,sha256=Rp3kHL-qZ8ax47v0mydZi6i1MFUcWqjz0PtWjLrE7R8,11733
+hiplot/fetchers_demo.py,sha256=xCY0aGAUiUHJLCXziM2J9ayhtNJKWIsVA1Id7cHXdVM,15492
+hiplot/ipython.py,sha256=XHjvYTZnRBPgX_k3ZG-psv07zePoi17rzIaIS40zCXg,7541
+hiplot/pkginfo.py,sha256=pxIL3DkxWNoJKYdph60MHN1HwhTgvqi0TLNPzvPDP9I,564
+hiplot/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hiplot/render.py,sha256=eg_7RPio8aJo_UOF-OPUo388dbYyzIy886RU1QrLwfw,4778
+hiplot/server.py,sha256=8SI0XcJ4jJDLjlqV7KxXosIChvkzKwDesBiKYs41mXA,2752
+hiplot/streamlit_helpers.py,sha256=lPhFE90uKZQtrkwA96iNCjkNJne8ap-hPeWaZMgvBW0,5167
+hiplot/static/icon.png,sha256=hSllX0zW4r-6Cn8nqfiG9WbkGFU0HE3fTQyjBLg0dXE,21466
+hiplot/static/built/hiplot.bundle.js,sha256=_cgf_Q1CDZCHiSUAaPGUJQaR6YJGB_a1HYrrI9oVpBs,1666348
+hiplot/static/built/streamlit_component/hiplot_streamlit.bundle.js,sha256=OEvNp_BT3DCK18YKy66CczBw2pw0QeQofG2zDoAEqxo,1605435
+hiplot/static/built/streamlit_component/index.html,sha256=Er4-G5w4l1xsRrBRu6IQCdewvivUQRrj1ejBQEeuEwQ,511
+hiplot/templates/index.html,sha256=Im6F_ydcTMs2eMbk5bIB7CsgpEVMzD_KafmkLEtpPlg,2168
+hiplot_plus-0.1.0.dist-info/METADATA,sha256=dqoBK2X0r946lM38JRrThKTdA2GWmN50Ty6ZI72oFro,9268
+hiplot_plus-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+hiplot_plus-0.1.0.dist-info/entry_points.txt,sha256=gcP76M2oHsjL1sqJBDkBXWMhNQI-FgrkSTtPtMxrHbE,153
+hiplot_plus-0.1.0.dist-info/licenses/LICENSE,sha256=UkEte8fOQVfqYou6rLiCngqcs8WPV_mRdhJryM8r_IU,1086
+hiplot_plus-0.1.0.dist-info/licenses/NOTICE,sha256=BgJexxrr6wJp6w2Sh51mRAiLn1ymNC5o6F5KrnUV8Do,11609
+hiplot_plus-0.1.0.dist-info/RECORD,,

hiplot_plus-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

hiplot_plus-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+hiplot = hiplot.server:run_server_main
+hiplot-plus = hiplot.render:hiplot_render_main
+hiplot-render = hiplot.render:hiplot_render_main

hiplot_plus-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Facebook, Inc. and its affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.