Historical Maps Vectorization Tools

A toolbox to vectorize fluvial corridor objects on historical maps.

Get started with the Command Line Interface environment

You will need a valid python3 installation. Create a python3 virtual environment and install the dependencies in requirements.txt :

python3 -m venv ./env --prompt hmvt
source ./env/bin/activate
pip install -r requirements.txt

chmod +x ./hmvt_cli.py

First, activate the virtual environment (the command may be different on a Windows OS) :

source ./env/bin/activate

Example to process full HMVT on a single tiff file :

hmvt_cli.py /path/to/working/directory -i path/to/rgb_map_image.TIF --mask --lab --sample --classif knn --reconstruct

Example to process full HMVT on all the tiff files in the "rgb" folder inside the working directory:

hmvt_cli.py /path/to/working/directory --mask --lab --sample --classif knn --reconstruct

Example to parallelize processing with hwloc:

First, use this script to prepare a "run.sh" file

  python prepareParallelProcessing.py -wd /path/to/wd/ --sample --classif knn