pip requirements, unix setup script, updated docs

Author: tanmaykm

docs/4.0/circuitscape_4_0.md

@@ -312,10 +312,10 @@ the Python packages repository. You will also need to install several packages
 upon which Circuitscape depends. 
 
 Python can be installed from http://www.python.org/ and the `pip` installer 
-can be installed from http://www.pip-installer.org/en/latest/installing.html. 
+can be installed from http://www.pip-installer.org/. 
 
 Before running Circuitscape, you will also need to install the Numpy, Scipy, 
-PyAMG, wxPython 2.8, and PythonCard Python packages. 
+PyAMG, wxPython and PythonCard Python packages. 
 
 Once these are installed, run the following command to get Circuitscape: 
 
@@ -331,10 +331,16 @@ Circuitscape:
 
 ## Linux 
 
-?Replace below? Would pip work for this? 
+Circuitscape can be installed as a Python package on Linux, following the instructions above.
+
+Optionally, you may download the following two files from the Circuitscape source repository:
+
+- `setup-unix.sh`
+- `pip_requirements.txt`
+
+And run the command `sh setup-unix.sh` to guide you through the installation process.
+
 
-Instructions to install and run Circuitscape on Linux can be found on the 
-Circuitscape website. 
 
 #4. Using Circuitscape with the graphical user interface 
 

pip_requirements.txt

@@ -0,0 +1,8 @@
+scipy>=0.11.0
+numpy>=1.6.2
+pyamg>=2.1.0
+psutil>=1.1.3
+
+# manual install required for:
+# PythonCard>=0.8.2
+# wxPython>=2.8

setup-unix.sh

@@ -0,0 +1,38 @@
+# check if python is installed
+echo "Looking for python..."
+which python
+if [ $? -ne 0 ]; then
+    echo "Can't find python command"
+    echo "Install python from http://www.python.org/"
+    exit 1
+fi
+
+# check if pip is installed
+echo "Looking for pip..."
+which pip
+if [ $? -ne 0 ]; then
+    echo "Can't find python package installer pip"
+    echo "Install pip from http://www.pip-installer.org/"
+    exit 1
+fi
+
+
+echo "Installing packages required by circuitscape..."
+pip install -r pip_requirements.txt
+if [ $? -ne 0 ]; then
+    echo "Failed to install required packages for circuitscape"
+    exit 1
+fi
+
+echo "Installing circuitscape..."
+pip install circuitscape
+if [ $? -ne 0 ]; then
+    echo "Failed to install circuitscape"
+    exit 1
+fi
+
+echo "Circuitscape command line mode is now installed."
+echo "For a graphical user interface the following packages need to be installed manually:"
+echo "1. wxPython. Refer: http://wiki.wxpython.org/How%20to%20install%20wxPython"
+echo "2. PythonCard. Refer: http://pythoncard.sourceforge.net/installation.html"
+