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 https://www.python.org/downloads/windows/. 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 http://wxpython.org/download.php. Make sure to match your Python version and architecture (32/64bit).

  3. Download the Windows NumPy package from http://www.lfd.uci.edu/~gohlke/pythonlibs/#numpy. You’ll need the package later. Again, make sure to match your Python version and architecture.

  4. Download the Windows SciPy package from http://www.lfd.uci.edu/~gohlke/pythonlibs/#scipy.

  5. Download and install Graphviz from http://www.graphviz.org/Download.php.

  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: https://www.java.com/en/download/help/path.xml.

    (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:

    C:\Python27\Scripts\MapperGUI.py
    

    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 MapperGUI.py from any directory.

Previous topic

Installation instructions: Ubuntu

Next topic

Installation tips: OS X

This Page