semvec/pypi-packages huggingface dataset:
langchain-google-vertexai 3.2.2
An integration package connecting Google VertexAI and LangChain
License: MIT
Requires Python: <4.0.0,>=3.10.0

# langchain-google-vertexai

[![PyPI - Version](https://img.shields.io/pypi/v/langchain-google-vertexai?label=%20)](https://pypi.org/project/langchain-google-vertexai/#history)
[![PyPI - License](https://img.shields.io/pypi/l/langchain-google-vertexai)](https://opensource.org/licenses/MIT)
[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-google-vertexai)](https://pypistats.org/packages/langchain-google-vertexai)
[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchainai.svg?style=social&label=Follow%20%40LangChainAI)](https://twitter.com/langchainai)

Looking for the JS/TS version? Check out [LangChain.js](https://github.com/langchain-ai/langchainjs).

This package contains the LangChain integrations for Google Cloud generative models via the [Vertex AI Platform](https://cloud.google.com/vertex-ai).

## Quick Install

```bash
pip install langchain-google-vertexai
```

## 📖 Documentation

For full documentation, see the [API reference](https://reference.langchain.com/python/integrations/langchain_google_vertexai/). For conceptual guides, tutorials, and examples on using these classes, see the [LangChain Docs](https://docs.langchain.com/oss/python/integrations/providers/google#google-cloud).

## 📕 Releases & Versioning

See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/versioning) policies.

## 💁 Contributing

As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.

For detailed information on how to contribute, see the [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview).
cloudglancer 0.1.0
Simple interactive visualization of 3D point clouds
License: MIT
Requires Python: >=3.9

# 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.