contour-creator/README.md

37 lines
1.1 KiB
Markdown
Raw Normal View History

2024-04-06 15:50:03 +00:00
# Contour Creator 🗺️
This program takes a tiff heightmap and produces vector contours.
This is our project for the INF205: Resource-efficient programming course
## Status
- [x] Read .tif file into memory using gdal
2024-04-22 14:13:06 +00:00
- [x] Run the marching squares algorithm and produce a "cellmap"
2024-05-07 22:17:32 +00:00
- [x] Use a lookuptable to produce a vector file from the "cellmap"
2024-04-10 10:07:04 +00:00
## Dependencies
2024-04-23 20:28:40 +00:00
- GDAL >= 3.5
2024-04-10 10:07:04 +00:00
- OpenMP
2024-04-23 20:28:40 +00:00
- CMake
2024-05-07 22:17:32 +00:00
If you want to clone the repo with the example files you need [git-lfs](https://git-lfs.com/) installed and activated with ´git lfs install´
You also need to clone with submodules to get the argh library:
```
git clone --recurse-submodules https://gitlab.com/Trygve/contour-creator
```
2024-04-23 20:28:40 +00:00
To install the packages on Fedora run
```
dnf install g++ git-lfs cmake gdal-devel
```
on Debian:
```
apt install g++ git-lfs cmake libgdal-dev
```
2024-04-06 15:50:03 +00:00
## How to build:
```
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake --build . --parallel
```
2024-04-23 20:28:40 +00:00
Then you can run `./contour-creator PATH/TO/HEIGTHMAP.TIF`
2024-05-07 22:17:32 +00:00
Run an example file: `./contour-creator "../example_files/ås.tif"`
2024-04-23 20:28:40 +00:00
## Docs
[Doxygen output](https://trygve.gitlab.io/contour-creator/)