Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/francescofugazzi/3dgsconverter

3D Gaussian Splatting Converter: A tool to seamlessly convert 3DGS .ply files to a Cloud Compare-friendly format and vice-versa. Features include RGB coloring, density filtering, and flyer removal for enhanced point cloud editing.
https://github.com/francescofugazzi/3dgsconverter

gaussian-splatting

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/francescofugazzi/3dgsconverter
Owner: francescofugazzi
License: mit
Created: 2023-10-28T15:09:50.000Z (8 months ago)
Default Branch: main
Last Pushed: 2023-12-06T18:46:51.000Z (7 months ago)
Last Synced: 2024-02-15T21:31:26.671Z (5 months ago)
Topics: gaussian-splatting
Language: Python
Homepage:
Size: 72.3 KB
Stars: 109
Watchers: 5
Forks: 6
Open Issues: 4
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-3D-gaussian-splatting - 3DGS Converter - A tool for converting 3D Gaussian Splatting .ply files into a format suitable for Cloud Compare and vice-versa (Open Source Implementations / Utilities)

README

# 3D Gaussian Splatting Converter

A tool for converting 3D Gaussian Splatting `.ply` and `.parquet` files into a format suitable for Cloud Compare and vice-versa. Enhance your point cloud editing with added functionalities like RGB coloring, density filtering, and flyer removal.

## Features

- **Format Conversion**: Seamlessly switch between 3DGS `.ply` and Cloud Compare-friendly `.ply` formats. Now also `.parquet` is supported as input file.
- **RGB Coloring**: Add RGB values to your point cloud for better visualization and editing in Cloud Compare.
- **Density Filtering**: Focus on the dense regions of your point cloud by removing sparse data.
- **Flyer Removal**: Get rid of unwanted outliers or floating points in your dataset. Especially useful when combined with the density filter due to its intensive nature.
- **Bounding box cropping**: command for cropping point clouds to focus on specific regions.

## Installation

There are two ways to install the 3D Gaussian Splatting Converter:

**1. Direct Installation via pip**:

Directly install the app from GitHub using pip. This method is straightforward and recommended for most users.

```bash
pip install git+https://github.com/francescofugazzi/3dgsconverter.git
```

**2. Installation by Cloning the Repository:**:

If you prefer to clone the repository and install from the source, follow these steps:

```bash
git clone https://github.com/francescofugazzi/3dgsconverter
cd 3dgsconverter
pip install .
```

## Usage

Here are some basic examples to get you started:

**1. Conversion from 3DGS to Cloud Compare format with RGB addition**:

```bash
3dgsconverter -i input_3dgs.ply -o output_cc.ply -f cc --rgb
```

**2. Conversion from Cloud Compare format back to 3DGS:**:

```bash
3dgsconverter -i input_cc.ply -o output_3dgs.ply -f 3dgs
```

**3. Applying Density Filter during conversion:**:

```bash
3dgsconverter -i input_3dgs.ply -o output_cc.ply -f cc --density_filter
```

**4. Applying Density Filter and Removing floaters during conversion:**:

```bash
3dgsconverter -i input_3dgs.ply -o output_cc.ply -f cc --density_filter --remove_flyers
```

For a full list of parameters and their descriptions, you can use the `-h` or `--help` argument:

```bash
gsconverter -h
```

## Debug Information

For detailed insights pass the `--debug` flag (or `-d` for short) when executing the script.

## Contribute

Feel free to open issues or PRs if you have suggestions or improvements for this tool!