Using Anaconda to setup a virtual Python environment is the fastest way to get wahooMapsCreator running!
- Download
Anaconda Individual Edition
for your OS
Click Download on top right to download Anaconda Distribution
for your OS:
https://www.anaconda.com/products/individual
- Install
Anaconda Individual Edition
with default settings
Java needs to be installed for every OS (Windows, macOS, Linux). You can use Oracle Java or OpenJDK.
- Download
Java Runtime Environment
for your OS from:
https://www.java.com/de/download/
- Install
Java Runtime Environment
with default settings
- Download
OpenJDK
build file for your OS and unzip
- Move the folder to the appropriate directory
- macOS:
/Library/Java/JavaVirtualMachines/
- Windows:
C:\Program Files\Java\
- Linux:
/usr/java
- Set environment variable
- macOS: nothing to do
- Windows: https://javatutorial.net/set-java-home-windows-10/
- Linux: https://www.cyberciti.biz/faq/linux-unix-set-java_home-path-variable/
The following programs are needed for macOS and Linux
Install using terminal https://brew.sh/
- Install osmium-tool using homebrew in terminal:
brew install osmium-tool
- Download Osmosis latest version from Github
brew install osmosis
- Open terminal (macOS/Linux) or Anaconda Prompt (Windows, via Startmenu)
- Create a new Anaconda environment with needed packages
conda create -n gdal-user python=3.10 geojson=2.5 gdal=3.6 requests=2.28 shapely=1.8 bs4=4.11 lxml=4.9 matplotlib=3.4.3 pip --channel conda-forge --override-channels
- activate Anaconda environment with the command printed out (this needs to be done each time you want to use wahooMapsCreator maps)
conda activate gdal-user
pip install wahoomc
If you have wahooMapsCreator already installed via pip and you want to install a newer version this can be done via:
pip install wahoomc --upgrade
If you want to upgrade to a version other than the release actual one, use this command:
pip install wahoomc==2.0.0a5 --upgrade
For integrating contour lines into the generated maps, some additional steps need to be taken. An additional Python packages has to be installed and you need an free account for USGS to query contour lines from.
- Download and unpack http://katze.tfiu.de/projects/phyghtmap/phyghtmap_2.23.orig.tar.gz
- Enter your Anaconda environment and go to the unpacked folder
- Install phyghtmap into your Anaconda environment
macOS / Linux
sudo python setup.py install
Windows
python setup.py install
You can verify the installation of phyghtmap and dependant python packages if you enter the following into your Anaconda shell.
phyghtmap
If there is a output, phyghtmap was installed and recognized successfully
- Enter https://ers.cr.usgs.gov/ and create a free account. It's straight forward.
- Remember your username and password.
Run wahooMapsCreater as described in the README
Additional information: https://opensourceoptions.com/blog/how-to-install-gdal-with-anaconda/