/tiff2png-1

Independent TIFF to PNG converter module

Primary LanguageC++GNU General Public License v3.0GPL-3.0

build License: GPL v3

tiff2png

Stand-alone module that converts geoTIFF images into 8/16 bit PNG format. Used as part of the preprocessing step for terrain feature extraction. The terrain information (topo-bathymetry) is centered by substracting its mean value and then scaled according to the user-defined parameter max_z. Depending on the output resolution, the maximum value will be mapped to 255 (8 bits PNG) or 65535 (16 bits PNG). Additional parameters allow defining a ROI from the input file that will be extracted and converted.

Features

  • Can read any geoTIFF topography or bathymetry map supported by GDAL
  • Can export 8/18 bit PNG. Additionally, single channel (grayscale) or 3-channel (RGB) output formats are available
  • User defined ROI (Region of Interest) to be exported
  • Support CRS projections for Earth(WGS84) and Mars(IAU2000:49901)
  • Companion parallel bash script for processing large batches

Installation

Start with installing the following dependencies:

  • OpenCV 4.X:
sudo apt install libopencv-contrib-dev libopencv-core-dev libopencv-imgcodecs-dev libopencv-dev
  • GDAL 2.X, 3.X
sudo apt install libgdal-dev -y
  • yaml-cpp
sudo apt install libyaml-cpp-dev -y

Note: if you have installed OpenCV of GDAL from a different source (e.g. locally compiled), you can still use it defining their corresponding installation paths when running cmake

Then proceed to clone this repository:

git clone --recurse-submodules https://github.com/cappelletto/tiff2png.git

Create a build directory and run CMake

mkdir build
cd build
cmake ..

Finally, complete the compilation and installation (optional)

make -j `nproc --ignore=2`
make install

How to use it

How to contribute

Credits