Installation instructions: Windows

Here are step-by-step instructions to install Python Mapper and all its dependencies in Windows.

  1. Download and install Python 2.

    Go to Go to “Latest Python 2 Release”. Download the “Windows x86-64 MSI installer”. Start the installer and follow the instructions.

  2. Download and install wxPython from Make sure to match your Python version and architecture (32/64bit).

  3. Download the Windows NumPy package from You’ll need the package later. Again, make sure to match your Python version and architecture.

  4. Download the Windows SciPy package from

  5. Download and install Graphviz from

  6. Open a Command Prompt.

  7. The directory with the Graphviz executables must be appended to the PATH environment variable. There are lots of tutorials for this step in the internet, eg. here:

    (On my system, the directory is C:\Program Files (x86)\Graphviz2.38\bin.)

  8. Close the command prompt and open a new one to process the changes in the PATH variable.

  9. Check that the search path is configured correctly by typing:

    neato -?

    If Graphviz’s “neato” program responds with a help message, everything is alright.

  10. Go to the Scripts folder in your Python installation, eg.:

    cd /d C:\Python27\Scripts
  11. Type:

    pip install wheel
  12. Install the downloaded NumPy and SciPy packages as follows:

    pip install C:\Users\MYUSERNAME\Downloads\numpy-A.B.C+mkl-cp2X-none-win_amd64.whl
    pip install C:\Users\MYUSERNAME\Downloads\scipy-A.B.C-cp2X-none-win_amd64.whl
  13. Install the remaining Python packages:

    pip install matplotlib
    pip install pyopengl
    pip install fastcluster
    pip install mapper
    pip install cmappertools
  14. The Mapper GUI should work now:


    I recommend to always execute the GUI from the command line. This way, debugging information is displayed on the terminal if an error occurs.

  15. Optional: You may want to add the Python Scripts directory to the search path, in the same way as you did it for Graphviz. On my system, it is C:\Python27\Scripts. This way, the Mapper GUI can be started by the command from any directory.

Previous topic

Installation instructions: Ubuntu

Next topic

Installation tips: OS X

This Page