= 1. Installation & Configuration =
== 1.1 Python ==
This project runs on Python, so let's install that first. Let's also install some required packages at the same time.
{{{
$ sudo apt-get install python python-pygame python-numpy
}}}
Pygame is used as backend for rendering our heatmap images, and numpy is used for some calculations within the code.
[[BR]](Make sure you get Python 2.7 due to compatibility with used plugins.)

== 1.2 MySQL & MySQLdb ==
Set up a MySQL server to your liking. Make sure you get as minimal version 3.23-5.1 due to the MySQLdb support. Then create a database for django_gheat.
{{{
$ sudo apt-get install mysql-server
$ sudo mysqladmin password password
$ echo "CREATE DATABASE project_heatmap;" | mysql -uroot -ppassword
}}}

Now get the latest MySQLdb, make sure it's higher than 1.2.1p2.
{{{
$ sudo apt-get install python-mysqldb
}}}

== 1.3 Django ==
Get Django 1.3 from [http://www.djangoproject.com/download/1.3/tarball/ here] or check for a newer version [http://www.djangoproject.com/download/ here], then:
{{{
$ tar xzvf Django-1.3.tar.gz
$ cd Django-1.3
$ sudo python setup.py install
}}}

== 1.4 Django extensions ==
Get the Django extensions from [https://github.com/django-extensions/django-extensions here].
{{{
$ tar xzvf <tarball>
$ cd django-extensions
$ python setup.py install
}}}

== 1.5 Django_gheat ==
Get the latest django_gheat from the [http://svn.wirelessleiden.nl/svn/projects/Heatmap/src/ repository]
{{{
# cd to where you want 'django_gheat' to be located
$ svn co http://svn.wirelessleiden.nl/svn/projects/Heatmap/src/django_gheat/
$ cd django_gheat/
}}}

Open {{{./settings.py}}}, look for the 'DATABASES' section and edit the following lines:
{{{
# If you are using MySQL with MySQLdb, don't edit this line. 
# If you are using a different database, replace 'mysql' with 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
'ENGINE': 'django.db.backends.mysql',
# The name of your database, or the path to your database file if you are using sqlite3.
'NAME': ' ',
# Connection settings for your database. Not used with sqlite3
'USER': ' ',
'PASSWORD': ' ',
'HOST': ' ',
'PORT': ' ',
}}}
[[BR]]
[[BR]]
You are now ready to populate the database; [wiki:model_data Models & Data import]