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: 3 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/francescofugazzi/3dgsconverter
- Owner: francescofugazzi
- License: mit
- Created: 2023-10-28T15:09:50.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-22T11:58:57.000Z (8 months ago)
- Last Synced: 2024-05-27T17:05:58.355Z (6 months ago)
- Topics: gaussian-splatting
- Language: Python
- Homepage:
- Size: 73.2 KB
- Stars: 194
- Watchers: 5
- Forks: 7
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- 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!