hiplot-mm 0.0.2__tar.gz → 0.0.3rc1__tar.gz

{hiplot-mm-0.0.2 → hiplot_mm-0.0.3rc1}/MANIFEST.in

@@ -1,4 +1,5 @@
 include LICENSE README.md
+include pyproject.toml
 include requirements/*.txt
 include hiplot/static/*
 include hiplot/static/built/*

hiplot_mm-0.0.3rc1/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: hiplot-mm
+Version: 0.0.3rc1
+Summary: High dimensional Interactive Plotting tool
+Author: Facebook AI Research, mathematicalmichael @ Mind the Math, LLC
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/mindthemath/hiplot
+Project-URL: Documentation, https://facebookresearch.github.io/hiplot/
+Project-URL: Repository, https://github.com/mindthemath/hiplot
+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.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: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: beautifulsoup4
+Requires-Dist: jinja2
+Provides-Extra: server
+Requires-Dist: flask; extra == "server"
+Requires-Dist: flask-compress; extra == "server"
+Provides-Extra: notebook
+Requires-Dist: ipython>=7.0.1; extra == "notebook"
+Requires-Dist: ipykernel; extra == "notebook"
+Provides-Extra: streamlit
+Requires-Dist: streamlit>=0.63; extra == "streamlit"
+Provides-Extra: all
+Requires-Dist: hiplot-mm[notebook,server,streamlit]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ty; extra == "dev"
+Requires-Dist: ipykernel; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Requires-Dist: mistune==0.8.4; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: pandas; extra == "dev"
+Requires-Dist: streamlit>=0.63; extra == "dev"
+Requires-Dist: beautifulsoup4; extra == "dev"
+Requires-Dist: optuna; extra == "dev"
+Requires-Dist: sphinx==5.2.0; extra == "dev"
+Requires-Dist: guzzle_sphinx_theme==0.7.11; extra == "dev"
+Requires-Dist: m2r2>=0.3.4; extra == "dev"
+Requires-Dist: flask; extra == "dev"
+Requires-Dist: flask-compress; extra == "dev"
+Requires-Dist: ipython>=7.0.1; extra == "dev"
+Dynamic: license-file
+
+# HiPlot - High dimensional Interactive Plotting
+
+![Logo](https://raw.githubusercontent.com/mindthemath/hiplot/main/hiplot/static/logo.png)
+
+[![CI](https://github.com/mindthemath/hiplot/actions/workflows/ci.yml/badge.svg)](https://github.com/mindthemath/hiplot/actions/workflows/ci.yml)
+[![Release](https://github.com/mindthemath/hiplot/actions/workflows/release.yml/badge.svg)](https://github.com/mindthemath/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-mm.svg)](https://pypi.python.org/pypi/hiplot-mm/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/hiplot-mm.svg)](https://pypi.python.org/pypi/hiplot-mm/)
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/mindthemath/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://mindthemath.github.io/hiplot/_static/demo/ml1.csv.html) or [upload your CSV](https://mindthemath.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/mindthemath/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://mindthemath.github.io/hiplot/tuto_streamlit.html)
+- In CLI to render standalone HTML
+
+
+```bash
+# Core package (HTML export only)
+pip install hiplot-mm
+
+# With Jupyter notebook support
+pip install hiplot-mm[notebook]
+
+# With web server support (hiplot CLI command)
+pip install hiplot-mm[server]
+
+# With Streamlit support
+pip install hiplot-mm[streamlit]
+
+# Everything
+pip install hiplot-mm[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'}]
+hip.Experiment.from_iterable(data).display()
+```
+
+### [See the live result](https://mindthemath.github.io/hiplot/_static/demo/demo_basic_usage.html)
+![Result](https://raw.githubusercontent.com/mindthemath/hiplot/main/assets/notebook.png)
+
+## Links
+
+* Repository: https://github.com/mindthemath/hiplot
+* Documentation: https://mindthemath.github.io/hiplot/
+* PyPI package: https://pypi.org/project/hiplot-mm/
+* Examples: https://github.com/mindthemath/hiplot/tree/main/examples
+* Original blog post: https://ai.facebook.com/blog/hiplot-high-dimensional-interactive-plots-made-easy/
+
+
+## Development
+
+To build from source:
+
+```bash
+# Install dependencies
+bun install
+uv sync --all-extras
+
+# Build JavaScript bundles
+bun run build
+
+# Build Python package
+uv build
+
+# Or use the all-in-one build script
+./build.sh
+```
+
+**Output directories:**
+- `npm-dist/` - NPM package artifacts
+- `dist/` - Python wheel and sdist
+- `hiplot/static/built/` - JS bundle included in Python package
+
+**Run the dev server:**
+```bash
+uv run hiplot --port 8765
+```
+
+
+## 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_mm-0.0.3rc1/README.md

@@ -0,0 +1,116 @@
+# HiPlot - High dimensional Interactive Plotting
+
+![Logo](https://raw.githubusercontent.com/mindthemath/hiplot/main/hiplot/static/logo.png)
+
+[![CI](https://github.com/mindthemath/hiplot/actions/workflows/ci.yml/badge.svg)](https://github.com/mindthemath/hiplot/actions/workflows/ci.yml)
+[![Release](https://github.com/mindthemath/hiplot/actions/workflows/release.yml/badge.svg)](https://github.com/mindthemath/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-mm.svg)](https://pypi.python.org/pypi/hiplot-mm/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/hiplot-mm.svg)](https://pypi.python.org/pypi/hiplot-mm/)
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/mindthemath/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://mindthemath.github.io/hiplot/_static/demo/ml1.csv.html) or [upload your CSV](https://mindthemath.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/mindthemath/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://mindthemath.github.io/hiplot/tuto_streamlit.html)
+- In CLI to render standalone HTML
+
+
+```bash
+# Core package (HTML export only)
+pip install hiplot-mm
+
+# With Jupyter notebook support
+pip install hiplot-mm[notebook]
+
+# With web server support (hiplot CLI command)
+pip install hiplot-mm[server]
+
+# With Streamlit support
+pip install hiplot-mm[streamlit]
+
+# Everything
+pip install hiplot-mm[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'}]
+hip.Experiment.from_iterable(data).display()
+```
+
+### [See the live result](https://mindthemath.github.io/hiplot/_static/demo/demo_basic_usage.html)
+![Result](https://raw.githubusercontent.com/mindthemath/hiplot/main/assets/notebook.png)
+
+## Links
+
+* Repository: https://github.com/mindthemath/hiplot
+* Documentation: https://mindthemath.github.io/hiplot/
+* PyPI package: https://pypi.org/project/hiplot-mm/
+* Examples: https://github.com/mindthemath/hiplot/tree/main/examples
+* Original blog post: https://ai.facebook.com/blog/hiplot-high-dimensional-interactive-plots-made-easy/
+
+
+## Development
+
+To build from source:
+
+```bash
+# Install dependencies
+bun install
+uv sync --all-extras
+
+# Build JavaScript bundles
+bun run build
+
+# Build Python package
+uv build
+
+# Or use the all-in-one build script
+./build.sh
+```
+
+**Output directories:**
+- `npm-dist/` - NPM package artifacts
+- `dist/` - Python wheel and sdist
+- `hiplot/static/built/` - JS bundle included in Python package
+
+**Run the dev server:**
+```bash
+uv run hiplot --port 8765
+```
+
+
+## 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-mm-0.0.2 → hiplot_mm-0.0.3rc1}/hiplot/__init__.py

@@ -5,7 +5,7 @@
 from .experiment import (Experiment, ExperimentFetcherDoesntApply, ExperimentValidationError, ExperimentValidationCircularRef,
                          ExperimentValidationMissingParent, Datapoint, ExperimentDisplayed, ValueDef, ValueType, Displays)
 from .server import run_server, run_server_main
-from .pkginfo import version as __version__, package_name
+from .pkginfo import __version__, package_name
 
 from . import fetchers
 

{hiplot-mm-0.0.2 → hiplot_mm-0.0.3rc1}/hiplot/fetchers.py

@@ -306,7 +306,7 @@ def get_fetcher(fetcher_spec: str) -> hip.ExperimentFetcher:
     if module is None:
         raise RuntimeError(f"Unable to create fetcher '{fetcher_spec}'")
 
-    return getattr(module, parts[-1])  # type: ignore
+    return getattr(module, parts[-1])
 
 
 def get_fetchers(add_fetchers: tp.List[str]) -> tp.List[hip.ExperimentFetcher]:

{hiplot-mm-0.0.2 → hiplot_mm-0.0.3rc1}/hiplot/fetchers_demo.py

@@ -50,8 +50,8 @@ def demo_line_xy() -> hip.Experiment:
         if i > 10:
             from_parent = random.choice(exp.datapoints[-10:])
             dp.from_uid = from_parent.uid  # <-- Connect the parent to the child
-            dp.values['loss'] += from_parent.values['loss']  # type: ignore
-            dp.values['param'] *= from_parent.values['param']  # type: ignore
+            dp.values['loss'] += from_parent.values['loss']
+            dp.values['param'] *= from_parent.values['param']
         exp.datapoints.append(dp)
     # DEMO_LINE_XY_END
     return exp

{hiplot-mm-0.0.2 → hiplot_mm-0.0.3rc1}/hiplot/ipython.py

@@ -8,11 +8,38 @@ import typing as t
 import json
 from pathlib import Path
 
-import IPython.display
-from ipykernel.comm import Comm
 from . import experiment as exp
 from .render import escapejs, make_experiment_standalone_page
 
+# Lazy imports for optional dependencies
+if t.TYPE_CHECKING:
+    import IPython.display
+    from ipykernel.comm import Comm
+
+
+def _get_ipython_display() -> t.Any:
+    """Lazy import of IPython.display with helpful error message."""
+    try:
+        import IPython.display
+        return IPython.display
+    except ImportError as e:
+        raise ImportError(
+            "IPython is required for notebook support. "
+            "Install it with: pip install hiplot-mm[notebook]"
+        ) from e
+
+
+def _get_comm_class() -> t.Any:
+    """Lazy import of ipykernel.comm.Comm with helpful error message."""
+    try:
+        from ipykernel.comm import Comm
+        return Comm
+    except ImportError as e:
+        raise ImportError(
+            "ipykernel is required for notebook support. "
+            "Install it with: pip install hiplot-mm[notebook]"
+        ) from e
+
 
 class GetSelectedFailure(Exception):
     pass
@@ -27,8 +54,9 @@ class NotebookJSBundleInjector:
 
     @classmethod
     def ensure_injected(cls) -> None:
+        IPython_display = _get_ipython_display()
         bundle = Path(__file__).parent / "static" / "built" / "hiplot.bundle.js"
-        IPython.display.display(IPython.display.Javascript(f"""
+        IPython_display.display(IPython_display.Javascript(f"""
 {bundle.read_text("utf-8")}
 // Local variables can't be accessed in other cells, so let's
 // manually create a global variable
@@ -76,12 +104,14 @@ class IPythonExperimentDisplayed(exp.ExperimentDisplayed):
         self._selected_ids: t.List[str] = []
         self._last_data_per_type: t.Dict[str, t.Any] = {}
 
-        def target_func(comm: Comm, open_msg: t.Dict[str, t.Any]) -> None:  # pylint: disable=unused-argument
+        Comm = _get_comm_class()
+
+        def target_func(comm: "Comm", open_msg: t.Dict[str, t.Any]) -> None:  # pylint: disable=unused-argument
             # comm is the kernel Comm instance
             # msg is the comm_open message
 
             # Register handler for later messages
-            @comm.on_msg  # type: ignore
+            @comm.on_msg
             def _recv(msg: t.Dict[str, t.Any]) -> None:
                 self._num_recv += 1
                 msg_data = msg["content"]["data"]
@@ -89,7 +119,7 @@ class IPythonExperimentDisplayed(exp.ExperimentDisplayed):
                 self._last_data_per_type[msg_data["type"]] = msg_data["data"]
 
         try:
-            ip: Any = get_ipython()  # type: ignore  # pylint: disable=undefined-variable
+            ip: t.Any = get_ipython()  # type: ignore  # pylint: disable=undefined-variable
             ip.kernel.comm_manager.register_target(comm_name, target_func)
         except NameError:  # NameError: name 'get_ipython' is not defined
             # We are not in an ipython environment - for example in testing
@@ -115,7 +145,7 @@ class IPythonExperimentDisplayed(exp.ExperimentDisplayed):
         last_msg = self._last_data_per_type.get("brush_extents")
         if last_msg is None:
             raise self.no_data_received_error
-        return last_msg  # type: ignore
+        return last_msg
 
 
 def _should_embed_js_with_html() -> bool:
@@ -133,6 +163,8 @@ def display_exp(
         embed_js_with_html: t.Optional[bool] = None,
         **kwargs: t.Any
 ) -> IPythonExperimentDisplayed:
+    IPython_display = _get_ipython_display()
+
     if embed_js_with_html is None:
         embed_js_with_html = _should_embed_js_with_html()
 
@@ -185,5 +217,5 @@ catch(err) {{
     else:
         NotebookJSBundleInjector.ensure_injected()
 
-    IPython.display.display(IPython.display.HTML(index_html))
+    IPython_display.display(IPython_display.HTML(index_html))
     return displayed_xp

hiplot_mm-0.0.3rc1/hiplot/pkginfo.py

@@ -0,0 +1,15 @@
+# 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.
+
+from importlib.metadata import version, PackageNotFoundError
+
+package_name = "hiplot-mm"
+
+# Dynamic version from installed package metadata
+# This ensures __version__ matches pyproject.toml when installed via pip
+try:
+    __version__ = version(package_name)
+except PackageNotFoundError:
+    # Package is not installed (e.g., running from source checkout)
+    __version__ = "0.0.0.dev0"

{hiplot-mm-0.0.2 → hiplot_mm-0.0.3rc1}/hiplot/render.py

@@ -36,7 +36,7 @@ def html_inlinize(html: str, replace_local: bool = True) -> str:
     static_root = str(Path(__file__).parent)
     soup = BeautifulSoup(html, "html.parser")
     for i in soup.find_all("link"):
-        href = i["href"]
+        href = str(i["href"])
         if href.startswith("http") or href.startswith("//"):
             continue
         if not replace_local:
@@ -54,7 +54,7 @@ def html_inlinize(html: str, replace_local: bool = True) -> str:
             i["href"] = f"data:{SUFFIX_TO_TYPE[file.suffix]};base64,{base64.b64encode(file.open('rb').read()).decode('ascii')}"
     for i in soup.find_all("script"):
         try:
-            src = i["src"]
+            src = str(i["src"])
         except KeyError:
             continue
         if src.startswith("http") or src.startswith("//"):

{hiplot-mm-0.0.2 → hiplot_mm-0.0.3rc1}/hiplot/server.py

@@ -18,8 +18,14 @@ def run_server(fetchers: List[exp.ExperimentFetcher], host: str = '127.0.0.1', p
     """
     Runs the HiPlot server, given a list of ExperimentFetchers - functions that convert a URI into a :class:`hiplot.Experiment`
     """
-    from flask import Flask, render_template, jsonify, request
-    from flask_compress import Compress
+    try:
+        from flask import Flask, render_template, jsonify, request
+        from flask_compress import Compress
+    except ImportError as e:
+        raise ImportError(
+            "Flask is required to run the HiPlot server. "
+            "Install it with: pip install hiplot-mm[server]"
+        ) from e
 
     app = Flask(__name__)
 
@@ -45,7 +51,7 @@ def run_server(fetchers: List[exp.ExperimentFetcher], host: str = '127.0.0.1', p
 
 def run_server_main() -> int:
     parser = argparse.ArgumentParser(prog="HiPlot", description="Start HiPlot webserver")
-    parser.add_argument('--version', action='version', version=f'{pkginfo.package_name} {pkginfo.version}')
+    parser.add_argument('--version', action='version', version=f'{pkginfo.package_name} {pkginfo.__version__}')
     parser.add_argument("--host", type=str, default="127.0.0.1")
     parser.add_argument("--port", type=int, default=5005)
     parser.add_argument("--dev", action='store_true', help="Enable Flask Debug mode (watches for files modifications, etc..)")