Skip to content

Latest commit

 

History

History
129 lines (99 loc) · 4.46 KB

install.md

File metadata and controls

129 lines (99 loc) · 4.46 KB

Installation Instructions

Base Install

  • Install Anaconda (I'm using Anaconda-2.0.1 [64-Bit - Python 2.7])

  • Create a new virtual environment (Skip this step on Windows, trust me, it'll be easier):

conda create -n scipygis pandas ipython-notebook
source acivate scipygis
conda install pip

  • If you don't want to use something like Anaconda (or Enthought Canopy), I still strongly recommend you use virtualenvs and probably even virtualenvwrapper.

  • If you don't already have it, you might need to install cython

conda install cython
  • Install required packages (on Windows, use binaries from here for shapely, pyproj, and rasterio)
conda install matplotlib
conda install shapely
conda install fiona
pip install pyproj
pip install descartes
pip install rasterio
  • Install geopandas (important!)
pip install git+git://github.com/kjordahl/geopandas.git

(Web)mapping Packages

pip install pyshp
pip install Cython
pip install git+git://github.com/SciTools/cartopy.git
  • Alternatively (better?), you can install cartopy via conda like this:
conda remove geos shapely cartopy
conda install -c rsignell cartopy
  • mplleaflet (for making slippy maps)
pip install git+git://github.com/mpld3/mplexporter.git
pip install git+git://github.com/jwass/mplleaflet.git
  • geojson.py for shooting data to the web!
pip install git+git://github.com/jwass/geojsonio.py.git

Optional Packages

  • Install basemap, a common package for making static maps
conda install basemap
  • Install psycopg2 for interacting with PostGIS
pip install psycopg2

Install QGIS

  • Go to the official QGIS page for details, or install via brew on OSX, apt-get on Linux, or OSGeo4W on Windows.

Alternative Install Guide

Known Issues

  • Linux Initial Setup
sudo add-apt-repository -y ppa:ubuntugis/ppa
sudo apt-get update -qq
sudo apt-get install -y gdal-bin libgdal-dev
  • OSX Initial Setup
    • First install brew: ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"
    • Then update and install gdal
brew doctor
brew update
brew install gdal

  • Windows Initial Setup

    • Download and install GDAL from here
    • If you use this one, then you can also use the fiona binary from that site. Otherwise, you'll have to play around with system PATHs etc. Others have had success with OSGeo4W, which includes many important libraries and their Python bindings.

  • If you don't already have it, you'll need to install git

    • Linux: sudo apt-get install git
    • OSX: brew install git
    • Windows: Download and install git from here. When installing, make sure you choose to "Use Git from the Windows Command Prompt" (You may also want to install optional Unix tools). You can also download GitHub for Windows here.

  • In some cases, it may be better to pip install shapely than to conda install shapely, particularly when using cartopy.

  • The openpyxl dependency of pandas may produce a funny warning: UserWarning: Installed openpyxl is not supported at this time. Use >=1.6.1 and <2.0.0

    • To fix this warning, try the following:
pip install openpyxl
pip uninstall openpyxl
pip install openpyxl==1.8.6
  • On vanilla Ubuntu, you might need to install g++ before installing rasterio:
sudo apt-get install g++

  • On OSX (Mavericks), if you don't already have developer tools installed, pip install pyproj will probably fail (due to missing gcc) and then ask you if you want to install them, so click 'yes' and then rerun pip install pyproj.

  • On Windows, source is not needed when activating a virtual environment if you are using the Anaconda Command Prompt: activate scipygis.