cdb-to-3dtiles

KO | EN

gitlite — search

#javascript #hacktoberfest #react #go #rust #docker #macos #nodejs #windows #kubernetes #security #openai #ios #open-source

(★ 92)

Convert CDB to 3D Tiles

cdb-to-3dtiles 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CDB to 3D Tiles

Convert Open Geospatial Consortium (OGC) CDB datasets to 3D Tiles OGC Community Standard for efficient streaming and rendering across multiple platforms and devices.

Converted tilesets faithfully match the level of detail and precision of the source CDB, with support for most common CDB layers and their associated feature attributes. See [Features](#clipboard-Features) for a full list of supported datasets and [Performance](#checkered_flag-Performance) for performance comparisons.

3D Tiles is designed for efficient runtime visualization and analytics. The pipeline preserves feature attributes from CDB, enabling runtime querying, styling, and analytics to gain deeper insights into the data.

_View of downtown San Diego with terrain, imagery, clamped building models, instanced trees, and Coronado Bridge in the distance, loaded as 3D Tiles in [CesiumJS](https://cesium.com/cesiumjs/). See the live demo [here](https://sandcastle.cesium.com/standalone.html#c=tVZdc9o4FP0rGp7IDBGWJX+1JLMJJKmZQLbBadKs90GxRVDxB5XlULLT/76yDdQEUtrsrB8sW/fec+49urLcboMLQRMJuizjedwfARoELMuATMEizQXgaQJoljGZ+UnlA900gSEb0zySJ6Wzl05ZAo6A32CL/uThIuBXvO/ePLtoyN3MTa6NoOua7nR296nbd6By+hpeTJWT+zyMzyeD5/t4MEJ88GW6uPQ+kkFvIK9uz56vumh6H59/Gdx+/nYf3yyGty6/7PZn9wps2PuYuXE0CdXzwPs8H3onaOCdGEOswdC6i4cP52785xk+Nfhj/65/Y93bPXqqWbPT7Mv1wxR9kNLr5VO/8d5P/CRIk0yCJ87mTKg6EjZf6gE/lXNNvxGU7900kZQnTPiNg1rkWcSeqCykOgJ0TvlKTlgNuOfxiCkN4ViksZLvpBDUDZvINg1HK5AqbpgFLGFwJnjMJX9iGaRh2Fyj1ykvRoM0ZFH224wWtsk+xhX4BqFXzZ0KHj6y36bFurmfdoNiF7knGMvewm38KnfJUKf+sAhF+ijobLIYMjlPxfQt/Hgf/zZNPYnrlIb/gX1vi9XwK9pxngRlQ2eTdI57lTbN4uUA/OMn4EfLw2JSJVUM7wvLqnm2DRvL+6q5XIEX1u9bOW3rVc9u27oXsCZBHak2vQtiRJMwoJmMWKGjl6bRAxUDluTNIviv4gYqoOKS7Jt8pz6TowJorWBrLVkLKLi1EH6jtQpUTcAiFqjgdc7Ngx+4YHOZpMjL3VM37tBrTKNsy68uwwuH78t0VuPusgoAsER4cwU7U3tLCZtS/FoFNZ7/vYBdS/WzJVjmXwx/+8sDYbmxAxozQeE4Wnhps8wrZJnkSXUwvaufal0qpHqiCW4e6sTQHRNB09QxIoRoZgscEstyEEIQm4Q42DJIC2CiqxFBSye6iRxsmwelNqngTB2KS5K1HiEXLPgpswaJ5iADEQ1hhyBH1xTLoZpFxLBNE2GCLaTuRjlrI90memEwieUQ+2C9MPns9eI0qNsaNnXLxKahjj4TVRyORmyigLBl6bpt2i2gQaxr2HYsrNk2xlhfMlStEuZiVSFWO7/Sfeee29eory5wo9XoZHIRseOC8A8ez1IhQS6iJoRtyeJZRFVZ7Yc8mKqvfJCVh1SnvQrphPwJ8PBox58KCCL1B6cs4zyKRvyZ+Y3jTlv5b4RFKimePF49MRFR1fhlGp0JOr6sDBDCTlu9FqQvY2X13avh/gs)_.

#

### :rocket: Getting Started

See [Getting Started](#getting-started) for installation, build, and usage instructions.

### :green_book: License

[Apache 2.0](http://www.apache.org/licenses/LICENSE-2.0.html). CDB to 3D Tiles is free for both commercial and non-commercial use. See [LICENSE.md](./LICENSE.md) for more details.

The [San Diego CDB](https://gsa-temp-public.s3.us-east-1.amazonaws.com/CDB_san_diego_v4.1.zip) end-user license agreement can be found [here](./Doc/SanDiego_CDB_EULA.pdf).

### :sparkles: Contributions

Pull requests are appreciated.  Please use the same [Contributor License Agreement (CLA)](https://github.com/CesiumGS/cesium/blob/main/CONTRIBUTING.md) used for [CesiumJS](https://cesium.com/cesiumjs/).

### :clipboard: Features

The following CDB features are supported:

#### Feature checklist

Dataset|CDB Name|Supported
--|--|--
Primary Elevation|`001_Elevation`|:heavy_check_mark:
Primary Imagery|`004_Imagery`|:heavy_check_mark:
Road Network|`201_RoadNetwork`|:heavy_check_mark:
Rail Road Network|`202_RailRoadNetwork`|:heavy_check_mark:
Power Line Network|`203_PowerLineNetwork`|:heavy_check_mark:
Hydrography Network|`204_HydrographyNetwork`|:heavy_check_mark:
Geotypical models|`101_GTFeature`, `500_GTModelGeometry`, `501_GTModelTexture`|:heavy_check_mark:
Geospecific models|`100_GSFeature`, `300_GSModelGeometry`, `301_GSModelTexture`|:heavy_check_mark:
Moving models|`600_MModelGeometry`, `601_GSModelTexture`|:x:
Min Max Elevation|`002_MinMaxElevation` `003_MaxCulture`|:x:
Geopolitical Boundaries|`102_GeoPolitical`|:x:
Vector Materials|`200_VectorMaterial`|:x:
Raster Materials|`005_RMTexture`, `006_RMDescriptor`|:x:
Navigation|`400_NavData`, `401_Navigation`|:x:
Bathymetry||:x:
Seasonal Imagery||:x:

#### Additional capabilities

Capability|Supported
--|--
Preserve instance and class attributes for models and vector layers|:heavy_check_mark:
Preserve geometry and texture quality with command line options for controlling mesh decimation|:heavy_check_mark:
Clamp models to the primary elevation dataset|:heavy_check_mark:
Clamp vector layers to the primary elevation dataset|:x:

#### Roadmap

* Windows support
* Performance improvements
* Automatic upload to Cesium ion
* Support more CDB datasets
* Clamp vector layers
* Output 3D Tiles Next (for interoperability with One World Terrain Well-Formed Format)

If you would like to provide feedback or accelerate the product roadmap for features you would like to see included, please contact [Shehzan Mohammed](mailto:shehzan@cesium.com).

#### CDB versions

All versions of CDB are supported. CDB 3.0 and CDB OGC 1.2 (draft) have been tested most during development.

### :checkered_flag: Performance

Performance numbers for [San Diego CDB](https://gsa-temp-public.s3.us-east-1.amazonaws.com/CDB_san_diego_v4.1.zip) measured on a Dell XPS 15 7590

## Getting Started

### Prerequisites

- Linux (Windows support coming soon)
- C++ compiler that supports C++17 (tested on GCC 9.3.0)
- CMake version 3.15 or higher
- GDAL version 3.0.4 or higher
- OpenGL (needed by OpenSceneGraph)

To install GDAL 3.0.4 on Debian-based systems:

```bash
sudo add-apt-repository ppa:ubuntugis/ppa && sudo apt-get update
sudo apt-get update
sudo apt-get install libgdal-dev
```

To install OpenGL on Debian-based headless systems:

```bash
sudo apt-get install libgl1-mesa-dev
```

### Installing

Clone the repo with:
```
git clone --recurse-submodules git@github.com:CesiumGS/cdb-to-3dtiles.git
```

If `--recurse-submodules` is omitted, run the following command to update submodules:
```
git submodule update --init --recursive
```

### Building

The converter can be built on the command-line with CMake (given that you satisfy all [prerequisites](#prerequisites)):
```
cmake -B Build -S .
cmake --build Build --config Release -j 4
```

The executable can be found in the directory `Build/CLI/CDBConverter`

### Usage

```
Usage:

CDBConverter [OPTION...]

-i, --input arg               CDB directory
  -o, --output arg              3D Tiles output directory
      --combine arg             Combine converted datasets into one tileset.
                                Each dataset format is
                                {DatasetName}_{ComponentSelector1}_{ComponentSelector2}. Repeat this
                                option to group different dataset into
                                different tilesets.E.g:
                                --combine=Elevation_1_1,GSModels_1_1 --combine=GTModels_2_1,GTModels_1_1
                                will combine Elevation_1_1 and GSModels_1_1 into
                                one tileset. GTModels_2_1 and GTModels_1_1
                                will be combined into a different tileset
                                (default: Elevation_1_1,GSModels_1_1,GTModels_2_1,GTModels_1_1)
      --elevation-normal        Generate elevation normal
      --elevation-lod           Generate elevation and imagery based on
                                elevation LOD only
      --elevation-decimate-error arg
                                Set target error when decimating elevation
                                mesh. Target error is normalized to 0..1 (0.01
                                means the simplifier maintains the error to be
                                below 1% of the mesh extents) (default: 0.01)
      --elevation-threshold-indices arg
                                Set target percent of indices when decimating
                                elevation mesh (default: 0.3)
  -h, --help                    Print usage
```

### Example

The following command converts [San Diego CDB](https://gsa-temp-public.s3.us-east-1.amazonaws.com/CDB_san_diego_v4.1.zip) to 3D Tiles:
```
./Build/CLI/CDBConverter -i CDB_san_diego_v4.1 -o San_Diego
```

### Unit Tests

To run unit tests, run the following command:

```
./Build/Tests/Tests
```

### Docker

You can use Docker to simplify setting up the environment for building and testing. You must install [Docker Engine CE For Ubuntu](https://docs.docker.com/install/linux/docker-ce/ubuntu/) to do so.

The converter can be built with:

```bash
./Docker/build-container.sh
./Docker/build-cdb-to-3dtiles.sh
```

The executable can be found in the directory `Build/CLI/CDBConverter`

Run units tests with the following command:
```
./Docker/run-tests.sh
```

### 3D Tiles Structure

The converter generates multiple 3D Tilesets from the input CDB:

- Primary Elevation and Primary Imagery are combined into a single tileset
- Geotypical models are combined into a single tileset
- Geospecific models are combined into a single tileset
- Vector datasets are written as separate tilesets:
    - Road Network
    - Rail Road Network
    - Power Line Network
    - Hydrography Network

The generated tilesets will be placed in a GeoCell directory similar to how the CDB is organized. For example, the generated tilesets for San Diego will be placed in the `San_Diego/Tiles/N32/W118` directory.

A CDB tile can store different geometries depending on its component selectors. For example, a Hydrography Network tile can have lineal and polygon features within the same tile, which are differentiated by their second respective component selector in the file name. For this reason, a `tileset.json` will be placed in the directory name that make up of the two component selectors, `{Component Selector 1}_{Component Selector 2}`. For example:
- The lineal tileset of the Hydrography Network dataset will be placed in `HydrographyNetwork/2_3` directory 
- The polygon tileset of the Hydrography Network dataset will be placed in `HydrographyNetwork/2_5` directory

Below is the output directory of the converted San Diego 3D Tiles:

## Releases

We release as often as needed. CDB To 3D Tiles strictly follows [semver](https://semver.org/).

- Update the project version number in [CMakeLists.txt](./CMakeLists.txt)
- Proofread [CHANGES.md](./CHANGES.md) and make any required updates
- Make sure all unit tests pass
- Commit and push the above changes to `main`
- Create a git tag for the version and push it:
  - `git tag -a 0.1.0 -m "0.1.0 release"`
  - `git push origin 0.1.0`

## Featured Demo

[Live Demo](https://sandcastle.cesium.com/standalone.html#c=tVZdc9o4FP0rGp7IDBGWJX+1JLMJJKmZQLbBadKs90GxRVDxB5XlULLT/76yDdQEUtrsrB8sW/fec+49urLcboMLQRMJuizjedwfARoELMuATMEizQXgaQJoljGZ+UnlA900gSEb0zySJ6Wzl05ZAo6A32CL/uThIuBXvO/ePLtoyN3MTa6NoOua7nR296nbd6By+hpeTJWT+zyMzyeD5/t4MEJ88GW6uPQ+kkFvIK9uz56vumh6H59/Gdx+/nYf3yyGty6/7PZn9wps2PuYuXE0CdXzwPs8H3onaOCdGEOswdC6i4cP52785xk+Nfhj/65/Y93bPXqqWbPT7Mv1wxR9kNLr5VO/8d5P/CRIk0yCJ87mTKg6EjZf6gE/lXNNvxGU7900kZQnTPiNg1rkWcSeqCykOgJ0TvlKTlgNuOfxiCkN4ViksZLvpBDUDZvINg1HK5AqbpgFLGFwJnjMJX9iGaRh2Fyj1ykvRoM0ZFH224wWtsk+xhX4BqFXzZ0KHj6y36bFurmfdoNiF7knGMvewm38KnfJUKf+sAhF+ijobLIYMjlPxfQt/Hgf/zZNPYnrlIb/gX1vi9XwK9pxngRlQ2eTdI57lTbN4uUA/OMn4EfLw2JSJVUM7wvLqnm2DRvL+6q5XIEX1u9bOW3rVc9u27oXsCZBHak2vQtiRJMwoJmMWKGjl6bRAxUDluTNIviv4gYqoOKS7Jt8pz6TowJorWBrLVkLKLi1EH6jtQpUTcAiFqjgdc7Ngx+4YHOZpMjL3VM37tBrTKNsy68uwwuH78t0VuPusgoAsER4cwU7U3tLCZtS/FoFNZ7/vYBdS/WzJVjmXwx/+8sDYbmxAxozQeE4Wnhps8wrZJnkSXUwvaufal0qpHqiCW4e6sTQHRNB09QxIoRoZgscEstyEEIQm4Q42DJIC2CiqxFBSye6iRxsmwelNqngTB2KS5K1HiEXLPgpswaJ5iADEQ1hhyBH1xTLoZpFxLBNE2GCLaTuRjlrI90memEwieUQ+2C9MPns9eI0qNsaNnXLxKahjj4TVRyORmyigLBl6bpt2i2gQaxr2HYsrNk2xlhfMlStEuZiVSFWO7/Sfeee29eory5wo9XoZHIRseOC8A8ez1IhQS6iJoRtyeJZRFVZ7Yc8mKqvfJCVh1SnvQrphPwJ8PBox58KCCL1B6cs4zyKRvyZ+Y3jTlv5b4RFKimePF49MRFR1fhlGp0JOr6sDBDCTlu9FqQvY2X13avh/gs) of San Diego terrain, imagery, and models. Click individual models or vector features to see their metadata.

cdb-to-3dtiles

cdb-to-3dtiles 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

cdb-to-3dtiles

cdb-to-3dtiles 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README