cloudglancer 0.1.0__tar.gz

cloudglancer-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI@HHMI
+
+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.

cloudglancer-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include cloudglancer *.py py.typed

cloudglancer-0.1.0/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: cloudglancer
+Version: 0.1.0
+Summary: Simple interactive visualization of 3D point clouds
+Author-email: Your Name <your.email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/cloudglancer
+Project-URL: Repository, https://github.com/yourusername/cloudglancer
+Project-URL: Issues, https://github.com/yourusername/cloudglancer/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: plotly>=5.0.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: nbformat>=4.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# cloudglancer
+
+Simple interactive visualization of 3D point clouds using Plotly.
+
+## Features
+
+- Interactive 3D scatter plots with pan, zoom, and rotation
+- Support for categorical and continuous color mapping
+- Combine multiple plots into subplot grids
+- Easy-to-use API with sensible defaults
+- Type hints for better IDE support
+
+## Installation
+
+```bash
+pip install cloudglancer
+```
+
+## Quick Start
+
+```python
+import numpy as np
+import cloudglancer
+
+# Generate random 3D points
+points = np.random.randn(500, 3)
+
+# Create and display the plot
+fig = cloudglancer.plot(points, title="My Point Cloud", size=2.0)
+fig.show()
+```
+More examples are in the `examples` folder.
+
+### Development Installation
+
+Clone the repository and install in editable mode:
+
+```bash
+git clone https://github.com/yourusername/cloudglancer.git
+cd cloudglancer
+python -m venv venv
+source venv/bin/activate
+pip install -e .
+```
+
+### Install with Development Dependencies
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Requirements
+
+- Python >= 3.9
+- plotly >= 5.0.0
+- pandas >= 2.0.0
+- numpy >= 1.24.0
+
+## API Reference
+
+### `cloudglancer.plot()`
+
+Create an interactive 3D scatter plot.
+
+**Parameters:**
+
+- `points` (np.ndarray): Array of shape (n_points, 3) containing 3D coordinates.
+- `labels` (np.ndarray, optional): Array of labels for color grouping.
+- `label_map` (dict, optional): Maps label values to display names. Enables discrete color mapping.
+- `color_map` (list or float, optional):
+  - With `label_map`: List of color strings for discrete coloring
+  - Without `label_map`: Float specifying the continuous color scale midpoint
+- `size` (float, optional): Size of scatter plot markers. Default is 1.5.
+- `title` (str, optional): Title of the plot.
+
+**Returns:**
+
+- `plotly.graph_objects.Figure`: Interactive 3D scatter plot.
+
+**Raises:**
+
+- `ValueError`: If points array is not of shape (n_points, 3).
+
+### `cloudglancer.combine_plots()`
+
+Combine multiple 3D plots into a single figure with subplots.
+
+**Parameters:**
+
+- `figs` (list): List of Plotly figures to combine.
+- `rows` (int, optional): Number of rows in the subplot grid. Default is 1.
+- `cols` (int, optional): Number of columns in the subplot grid. Default is 2.
+
+**Returns:**
+
+- `plotly.graph_objects.Figure`: Combined figure with all plots arranged in a grid.
+
+**Raises:**
+
+- `ValueError`: If the number of figures doesn't match rows * cols.
+
+## Examples
+
+See the [examples/](examples/) directory for more detailed usage examples.
+
+Run the examples:
+
+```bash
+python examples/basic_usage.py
+```
+
+## Development
+
+### Running Tests
+
+```bash
+pytest tests/ -v
+```
+
+### Code Formatting
+
+```bash
+black cloudglancer tests examples
+ruff check cloudglancer tests examples
+```
+
+### Building the Package
+
+```bash
+pip install build
+python -m build
+```
+
+This will create both wheel and source distributions in the `dist/` directory.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

cloudglancer-0.1.0/README.md

@@ -0,0 +1,142 @@
+# cloudglancer
+
+Simple interactive visualization of 3D point clouds using Plotly.
+
+## Features
+
+- Interactive 3D scatter plots with pan, zoom, and rotation
+- Support for categorical and continuous color mapping
+- Combine multiple plots into subplot grids
+- Easy-to-use API with sensible defaults
+- Type hints for better IDE support
+
+## Installation
+
+```bash
+pip install cloudglancer
+```
+
+## Quick Start
+
+```python
+import numpy as np
+import cloudglancer
+
+# Generate random 3D points
+points = np.random.randn(500, 3)
+
+# Create and display the plot
+fig = cloudglancer.plot(points, title="My Point Cloud", size=2.0)
+fig.show()
+```
+More examples are in the `examples` folder.
+
+### Development Installation
+
+Clone the repository and install in editable mode:
+
+```bash
+git clone https://github.com/yourusername/cloudglancer.git
+cd cloudglancer
+python -m venv venv
+source venv/bin/activate
+pip install -e .
+```
+
+### Install with Development Dependencies
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Requirements
+
+- Python >= 3.9
+- plotly >= 5.0.0
+- pandas >= 2.0.0
+- numpy >= 1.24.0
+
+## API Reference
+
+### `cloudglancer.plot()`
+
+Create an interactive 3D scatter plot.
+
+**Parameters:**
+
+- `points` (np.ndarray): Array of shape (n_points, 3) containing 3D coordinates.
+- `labels` (np.ndarray, optional): Array of labels for color grouping.
+- `label_map` (dict, optional): Maps label values to display names. Enables discrete color mapping.
+- `color_map` (list or float, optional):
+  - With `label_map`: List of color strings for discrete coloring
+  - Without `label_map`: Float specifying the continuous color scale midpoint
+- `size` (float, optional): Size of scatter plot markers. Default is 1.5.
+- `title` (str, optional): Title of the plot.
+
+**Returns:**
+
+- `plotly.graph_objects.Figure`: Interactive 3D scatter plot.
+
+**Raises:**
+
+- `ValueError`: If points array is not of shape (n_points, 3).
+
+### `cloudglancer.combine_plots()`
+
+Combine multiple 3D plots into a single figure with subplots.
+
+**Parameters:**
+
+- `figs` (list): List of Plotly figures to combine.
+- `rows` (int, optional): Number of rows in the subplot grid. Default is 1.
+- `cols` (int, optional): Number of columns in the subplot grid. Default is 2.
+
+**Returns:**
+
+- `plotly.graph_objects.Figure`: Combined figure with all plots arranged in a grid.
+
+**Raises:**
+
+- `ValueError`: If the number of figures doesn't match rows * cols.
+
+## Examples
+
+See the [examples/](examples/) directory for more detailed usage examples.
+
+Run the examples:
+
+```bash
+python examples/basic_usage.py
+```
+
+## Development
+
+### Running Tests
+
+```bash
+pytest tests/ -v
+```
+
+### Code Formatting
+
+```bash
+black cloudglancer tests examples
+ruff check cloudglancer tests examples
+```
+
+### Building the Package
+
+```bash
+pip install build
+python -m build
+```
+
+This will create both wheel and source distributions in the `dist/` directory.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

cloudglancer-0.1.0/cloudglancer/__init__.py

@@ -0,0 +1,6 @@
+"""cloudglancer: Simple interactive visualization of 3D point clouds"""
+
+from cloudglancer.scatter import plot, combine_plots
+
+__version__ = "0.1.0"
+__all__ = ["plot", "combine_plots"]

cloudglancer-0.1.0/cloudglancer/scatter.py

@@ -0,0 +1,129 @@
+"""Core scatter plotting functionality for 3D point clouds."""
+
+from typing import Optional, List, Dict, Union
+import plotly.express as px
+import pandas as pd
+import numpy as np
+from plotly.graph_objects import Figure
+
+
+def plot(
+    points: np.ndarray,
+    labels: Optional[np.ndarray] = None,
+    label_map: Optional[Dict] = None,
+    color_map: Optional[Union[List[str], float]] = None,
+    size: float = 1.5,
+    title: Optional[str] = None
+) -> Figure:
+    """
+    Render an interactive 3D scatter plot using Plotly.
+
+    Args:
+        points (np.ndarray): Array of shape (n_points, 3) containing 3D coordinates.
+        labels (np.ndarray, optional): Array of labels for color grouping. When provided
+            with label_map, enables discrete color mapping. Without label_map, creates
+            a continuous color scale.
+        label_map (dict, optional): Maps label values to display names. When provided,
+            enables discrete color mapping.
+        color_map (list or float, optional): When label_map is provided, this should be
+            a list of color strings for discrete coloring. Without label_map, this can be
+            a float specifying the continuous color scale midpoint.
+        size (float, optional): Size of the scatter plot markers. Default is 1.5.
+        title (str, optional): Title of the plot.
+
+    Returns:
+        plotly.graph_objects.Figure: Interactive 3D scatter plot.
+
+    Raises:
+        ValueError: If points array is not of shape (n_points, 3).
+
+    Examples:
+        Basic scatter plot:
+        >>> import numpy as np
+        >>> points = np.random.randn(100, 3)
+        >>> fig = plot(points, title="Random Points")
+        >>> fig.show()
+
+        Plot with categorical labels:
+        >>> labels = np.random.choice([0, 1, 2], size=100)
+        >>> label_map = {0: "Class A", 1: "Class B", 2: "Class C"}
+        >>> color_map = ["red", "blue", "green"]
+        >>> fig = plot(points, labels=labels, label_map=label_map, color_map=color_map)
+        >>> fig.show()
+    """
+    if points.shape[1] != 3:
+        raise ValueError("points must be of shape (n_points, 3)")
+
+    # Create a DataFrame for easier plotting
+    df = pd.DataFrame(points, columns=["x", "y", "z"])
+
+    if labels is not None:
+        df["label"] = labels
+        if label_map:
+            df["label"] = df["label"].map(label_map).fillna(df["label"])
+            fig = px.scatter_3d(df, x="x", y="y", z="z", color="label",
+                              color_discrete_sequence=color_map)
+        else:
+            fig = px.scatter_3d(df, x="x", y="y", z="z", color="label",
+                              color_continuous_midpoint=color_map, range_color=[0, 1])
+    else:
+        fig = px.scatter_3d(df, x="x", y="y", z="z")
+
+    fig.update_traces(marker=dict(size=size))
+
+    # Fix: Apply title if provided
+    if title:
+        fig.update_layout(title=title)
+
+    return fig
+
+
+def combine_plots(figs: List[Figure], rows: int = 1, cols: int = 2) -> Figure:
+    """
+    Combine multiple 3D plots into a single figure with subplots.
+
+    Args:
+        figs (list): List of Plotly figures to combine.
+        rows (int, optional): Number of rows in the subplot grid. Default is 1.
+        cols (int, optional): Number of columns in the subplot grid. Default is 2.
+
+    Returns:
+        plotly.graph_objects.Figure: Combined figure with all plots arranged in a grid.
+
+    Raises:
+        ValueError: If the number of figures doesn't match rows * cols.
+
+    Examples:
+        Combine two plots side by side:
+        >>> points1 = np.random.randn(100, 3)
+        >>> points2 = np.random.randn(100, 3) + 5
+        >>> fig1 = plot(points1, title="Dataset 1")
+        >>> fig2 = plot(points2, title="Dataset 2")
+        >>> combined = combine_plots([fig1, fig2], rows=1, cols=2)
+        >>> combined.show()
+    """
+    from plotly.subplots import make_subplots
+
+    # Fix: Validate figure count
+    if len(figs) != rows * cols:
+        raise ValueError(
+            f"Number of figures ({len(figs)}) must equal rows * cols ({rows * cols})"
+        )
+
+    # Fix: Generate specs dynamically based on rows and cols
+    specs = [[{"type": "scene"} for _ in range(cols)] for _ in range(rows)]
+
+    combined_fig = make_subplots(
+        rows=rows, cols=cols,
+        specs=specs
+    )
+
+    for i, fig in enumerate(figs):
+        for trace in fig.data:
+            combined_fig.add_trace(trace, row=(i // cols) + 1, col=(i % cols) + 1)
+
+    combined_fig.update_layout(
+        margin=dict(l=0, r=0, t=0, b=0)
+    )
+
+    return combined_fig

cloudglancer-0.1.0/cloudglancer.egg-info/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: cloudglancer
+Version: 0.1.0
+Summary: Simple interactive visualization of 3D point clouds
+Author-email: Your Name <your.email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/cloudglancer
+Project-URL: Repository, https://github.com/yourusername/cloudglancer
+Project-URL: Issues, https://github.com/yourusername/cloudglancer/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: plotly>=5.0.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: nbformat>=4.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# cloudglancer
+
+Simple interactive visualization of 3D point clouds using Plotly.
+
+## Features
+
+- Interactive 3D scatter plots with pan, zoom, and rotation
+- Support for categorical and continuous color mapping
+- Combine multiple plots into subplot grids
+- Easy-to-use API with sensible defaults
+- Type hints for better IDE support
+
+## Installation
+
+```bash
+pip install cloudglancer
+```
+
+## Quick Start
+
+```python
+import numpy as np
+import cloudglancer
+
+# Generate random 3D points
+points = np.random.randn(500, 3)
+
+# Create and display the plot
+fig = cloudglancer.plot(points, title="My Point Cloud", size=2.0)
+fig.show()
+```
+More examples are in the `examples` folder.
+
+### Development Installation
+
+Clone the repository and install in editable mode:
+
+```bash
+git clone https://github.com/yourusername/cloudglancer.git
+cd cloudglancer
+python -m venv venv
+source venv/bin/activate
+pip install -e .
+```
+
+### Install with Development Dependencies
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Requirements
+
+- Python >= 3.9
+- plotly >= 5.0.0
+- pandas >= 2.0.0
+- numpy >= 1.24.0
+
+## API Reference
+
+### `cloudglancer.plot()`
+
+Create an interactive 3D scatter plot.
+
+**Parameters:**
+
+- `points` (np.ndarray): Array of shape (n_points, 3) containing 3D coordinates.
+- `labels` (np.ndarray, optional): Array of labels for color grouping.
+- `label_map` (dict, optional): Maps label values to display names. Enables discrete color mapping.
+- `color_map` (list or float, optional):
+  - With `label_map`: List of color strings for discrete coloring
+  - Without `label_map`: Float specifying the continuous color scale midpoint
+- `size` (float, optional): Size of scatter plot markers. Default is 1.5.
+- `title` (str, optional): Title of the plot.
+
+**Returns:**
+
+- `plotly.graph_objects.Figure`: Interactive 3D scatter plot.
+
+**Raises:**
+
+- `ValueError`: If points array is not of shape (n_points, 3).
+
+### `cloudglancer.combine_plots()`
+
+Combine multiple 3D plots into a single figure with subplots.
+
+**Parameters:**
+
+- `figs` (list): List of Plotly figures to combine.
+- `rows` (int, optional): Number of rows in the subplot grid. Default is 1.
+- `cols` (int, optional): Number of columns in the subplot grid. Default is 2.
+
+**Returns:**
+
+- `plotly.graph_objects.Figure`: Combined figure with all plots arranged in a grid.
+
+**Raises:**
+
+- `ValueError`: If the number of figures doesn't match rows * cols.
+
+## Examples
+
+See the [examples/](examples/) directory for more detailed usage examples.
+
+Run the examples:
+
+```bash
+python examples/basic_usage.py
+```
+
+## Development
+
+### Running Tests
+
+```bash
+pytest tests/ -v
+```
+
+### Code Formatting
+
+```bash
+black cloudglancer tests examples
+ruff check cloudglancer tests examples
+```
+
+### Building the Package
+
+```bash
+pip install build
+python -m build
+```
+
+This will create both wheel and source distributions in the `dist/` directory.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

cloudglancer-0.1.0/cloudglancer.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+cloudglancer/__init__.py
+cloudglancer/scatter.py
+cloudglancer.egg-info/PKG-INFO
+cloudglancer.egg-info/SOURCES.txt
+cloudglancer.egg-info/dependency_links.txt
+cloudglancer.egg-info/requires.txt
+cloudglancer.egg-info/top_level.txt
+tests/test_scatter.py

cloudglancer-0.1.0/cloudglancer.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cloudglancer-0.1.0/cloudglancer.egg-info/requires.txt

@@ -0,0 +1,9 @@
+plotly>=5.0.0
+pandas>=2.0.0
+numpy>=1.24.0
+nbformat>=4.2.0
+
+[dev]
+pytest>=7.0.0
+black>=23.0.0
+ruff>=0.1.0

cloudglancer-0.1.0/cloudglancer.egg-info/top_level.txt

@@ -0,0 +1 @@
+cloudglancer

cloudglancer-0.1.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cloudglancer"
+version = "0.1.0"
+description = "Simple interactive visualization of 3D point clouds"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+authors = [
+    {name = "Your Name", email = "your.email@example.com"}
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Visualization",
+]
+dependencies = [
+    "plotly>=5.0.0",
+    "pandas>=2.0.0",
+    "numpy>=1.24.0",
+    "nbformat>=4.2.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/yourusername/cloudglancer"
+Repository = "https://github.com/yourusername/cloudglancer"
+Issues = "https://github.com/yourusername/cloudglancer/issues"
+
+[tool.setuptools.packages.find]
+include = ["cloudglancer*"]
+
+[tool.setuptools.package-data]
+cloudglancer = ["py.typed"]
+
+[tool.black]
+line-length = 100
+target-version = ["py39"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"

cloudglancer-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cloudglancer-0.1.0/tests/test_scatter.py

@@ -0,0 +1,91 @@
+"""Unit tests for cloudglancer.scatter module."""
+
+import numpy as np
+import pytest
+from cloudglancer import plot, combine_plots
+
+
+def test_plot_basic():
+    """Test basic plot creation with random points."""
+    points = np.random.randn(100, 3)
+    fig = plot(points)
+    assert fig is not None
+    assert len(fig.data) == 1
+    assert fig.data[0].type == "scatter3d"
+
+
+def test_plot_with_labels():
+    """Test plot with continuous labels."""
+    points = np.random.randn(100, 3)
+    labels = np.random.rand(100)
+    fig = plot(points, labels=labels)
+    assert fig is not None
+    assert len(fig.data) == 1
+
+
+def test_plot_with_label_map():
+    """Test plot with discrete color mapping."""
+    points = np.random.randn(100, 3)
+    labels = np.random.choice([0, 1, 2], size=100)
+    label_map = {0: "Class A", 1: "Class B", 2: "Class C"}
+    color_map = ["red", "blue", "green"]
+    fig = plot(points, labels=labels, label_map=label_map, color_map=color_map)
+    assert fig is not None
+    assert len(fig.data) > 0
+
+
+def test_plot_invalid_shape():
+    """Test that ValueError is raised for incorrect point shape."""
+    points = np.random.randn(100, 2)  # Wrong shape
+    with pytest.raises(ValueError, match="points must be of shape"):
+        plot(points)
+
+
+def test_plot_title():
+    """Test that title is correctly applied to the figure."""
+    points = np.random.randn(100, 3)
+    title = "Test Plot Title"
+    fig = plot(points, title=title)
+    assert fig.layout.title.text == title
+
+
+def test_plot_title_none():
+    """Test that plot works without a title."""
+    points = np.random.randn(100, 3)
+    fig = plot(points, title=None)
+    assert fig is not None
+
+
+def test_combine_plots():
+    """Test combining multiple plots."""
+    points1 = np.random.randn(50, 3)
+    points2 = np.random.randn(50, 3)
+    fig1 = plot(points1)
+    fig2 = plot(points2)
+    combined = combine_plots([fig1, fig2], rows=1, cols=2)
+    assert combined is not None
+    assert len(combined.data) == 2
+
+
+def test_combine_plots_grid():
+    """Test combining plots in a 2x2 grid."""
+    figs = [plot(np.random.randn(30, 3)) for _ in range(4)]
+    combined = combine_plots(figs, rows=2, cols=2)
+    assert combined is not None
+    assert len(combined.data) == 4
+
+
+def test_combine_plots_invalid_count():
+    """Test that ValueError is raised when figure count doesn't match grid."""
+    fig1 = plot(np.random.randn(50, 3))
+    fig2 = plot(np.random.randn(50, 3))
+    with pytest.raises(ValueError, match="Number of figures"):
+        combine_plots([fig1, fig2], rows=2, cols=2)  # 2 figs, but 2x2 = 4 spaces
+
+
+def test_plot_size_parameter():
+    """Test that marker size parameter is applied."""
+    points = np.random.randn(100, 3)
+    size = 3.0
+    fig = plot(points, size=size)
+    assert fig.data[0].marker.size == size