= 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
}}}
(Make sure you get Python 2.7 due to compatibility with used plugins.)
Pygame is used as backend for rendering our heatmap images, and numpy is used for some calculations within the code.

== 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]