Skip to content

Commit

Permalink
Updated README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
tebben committed Jan 16, 2024
1 parent c37ce37 commit 05b1c31
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 16 deletions.
42 changes: 27 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@ CTOD is a service designed to fetch Cesium terrain tiles (quantized mesh) dynami

![CTOD](./img/ctod.jpg)

## TL;DR

```sh
docker run -p 5000:5000 -v ./ctod_cache:/cache -e CTOD_TILE_CACHING_PATH=/cache ghcr.io/sogelink-research/ctod:latest
```

[Open demo viewer](http://localhost:5000)

## Features

- Generate and fetch a layer.json derived from COG, accommodating all projections.
Expand All @@ -22,11 +30,11 @@ CTOD is a service designed to fetch Cesium terrain tiles (quantized mesh) dynami

- Pass processor options
- Add skipCache to viewer
- Pydelatin or Martini support
- Pydelatin and/or Martini support
- Refactoring
- Logging
- Cleanup viewer
- Move repository to Github (open-source)
- Cleanup viewer code
- Smaller docker image if possible

### V1.1

Expand All @@ -42,9 +50,17 @@ CTOD is a service designed to fetch Cesium terrain tiles (quantized mesh) dynami
- quantized-mesh-encoder: Encode a mesh to a Quantized Mesh. (MIT)
- morecantile: Tile Matrix Sets. (MIT)

## Running CTOD locally
## Run CTOD with Docker

Example running CTOD using the docker image with a mounted volume and caching enabled.

```sh
docker run -p 5000:5000 -v ./ctod_cache:/cache -e CTOD_TILE_CACHING_PATH=/cache ghcr.io/sogelink-research/ctod:latest
```

## Run CTOD from source

Create virtual environment, install and run the service.
Create a virtual environment, install and run CTOD.

```sh
python -m venv venv
Expand All @@ -54,18 +70,10 @@ poetry install
python app.py
```

To enable caching start the service with a path to the cache

```sh
python app.py ./cache
```

## Run CTOD with Docker

Example running docker with a mounted volume and caching enabled
To enable caching start the service with a path to the cache.

```sh
docker run -p 5000:5000 -v ./ctod_cache:/cache -e CTOD_TILE_CACHING_PATH=/cache ghcr.io/sogelink-research/ctod:latest
python app.py ./ctod_cache
```

## Example adding TerrainProvider to Cesium
Expand Down Expand Up @@ -117,8 +125,12 @@ When requesting neighbouring tiles we want to prevent duplicate requests to the

### CogProcessor

ToDo

### TerrainProcessor

ToDo

## Endpoints

### Endpoint: `/`
Expand Down
2 changes: 1 addition & 1 deletion ctod/handlers/terrain.py
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ class TerrainHandler(BaseHandler):
"""Handle Cesium terrain requests using a grid based system
returning quantized mesh tiles.
Heights and normals are averaged between adjacent tiles to
Heights and normals are averaged between adjecent tiles to
create a smooth transition between tiles.
"""

Expand Down

0 comments on commit 05b1c31

Please sign in to comment.