Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 82 lines (52 sloc) 3.787 kb
c4cbeaa @patrickbaumann Updated Readme
patrickbaumann authored
1 ===============
2 GeoCam Memo Web
3 ===============
4
5 .. sectnum::
6
7 .. contents:: Contents
8
9 About
10 -----
11
12 The GeoCam Project helps people better understand and respond to disasters.
13 GeoCam consists of a GPS-enabled camera (or cell phone) and a web app for
14 sharing geotagged photos and other geospatial data.
15
16 GeoCam Memo is a scribing and note-taking application intended for use by search team members as they canvas the scene of a disaster. Notes can be recorded using text or audio and various forms of attachments (including but not limited to images) can be attached for transmission to a central server. All messages can be geotagged and categorized before saving to provide proper context when analyzing them via a web interface at a later time.
17
18 GeoCam Talk is a communication application intended to aid in communication during a search mission. Members can send text and audio messages to any subset of their team members while on the field from their mobile devices. All messages are sent through a central server which catalogs them for later analysis. Just as in Memo, all messages are geotagged to provide instant awareness of team member location.
19
20 This is the web application for both GeoCam Memo and GeoCam Talk
21
22 News
23 ----
24
25 Visit http://sites.google.com/site/geocampracticum2011/ and http://disastercam.blogspot.com/ for updates.
26
27 Setup
28 -----
29 The GeoCam Memo and Talk applications were built using the Django framework and run on top of Python.
30
31 Dependencies
32 ~~~~~~~~~~~~
33 * Python 2.4 or higher (http://www.python.org/download/)
34 * Django 1.2.5 or greater (http://www.djangoproject.com/)
35
2b862ba @patrickbaumann a couple more readme fixes
patrickbaumann authored
36 1. Once all dependencies have been installed, clone the GeoCamMemoWeb repository to the path of your choice::
c4cbeaa @patrickbaumann Updated Readme
patrickbaumann authored
37
38 git clone git@github.com:cheeseinvert/geocamMemoWeb.git
39
5dfa220 @patrickbaumann Added C2DM instructions to readme
patrickbaumann authored
40 2. If you haven't already, you'll need to register your gmail or google apps address here: http://code.google.com/android/c2dm/signup.html
41 3. Before running the Django application, rename geocamMemoWeb/geocamMemo/authentication_example.py to geocamMemoWeb/geocamMemo/authentication.py::
42
43 mv geocamMemoWeb/geocamMemo/authentication_example.py geocamMemoWeb/geocamMemo/authentication.py
44
45 4. Modify the newly moved file and follow the directions. You'll need to run the following from the console in order to retrieve your authentication token (curl with ssl libraries required: http://curl.haxx.se/)::
46
47 curl https://www.google.com/accounts/ClientLogin -k --data-urlencode Email=youraccount@gmail.com --data-urlencode Passwd=some_password -d accountType=GOOGLE -d source=com.patrickbaumann.pushprototype -d service=ac2dm
48
49 5. The response will contain an SID, AUTH, and LSID::
50
51 SID=alsdjfa;ljsdf;lajsdlfj...
52 AUTH=alsdjkfa;lskjdfl;asjd...
53 LSID=asl;dfjalskdjflasjdfl...
54
55 6. Paste the AUTH line after the '=' into authentication.py between the quotation marks.
56
57 7. CD into your ./geocamMemoWeb/example path and run syncdb, creating an admin user if prompted::
c4cbeaa @patrickbaumann Updated Readme
patrickbaumann authored
58
59 python manage.py syncdb
60
61 Running
62 -------
2b862ba @patrickbaumann a couple more readme fixes
patrickbaumann authored
63 To run a development server, navigate to your ./geocamMemoWeb/example path and execute runserver::
c4cbeaa @patrickbaumann Updated Readme
patrickbaumann authored
64
65 python manage.py runserver 0.0.0.0:8000
66
11c69dd @patrickbaumann Fixed name of android talk app
patrickbaumann authored
67 Pleast note that this must be done before the geocamTalkForAndroid and geocamTalkForAndroid can be successfully run on your mobile device.
c4cbeaa @patrickbaumann Updated Readme
patrickbaumann authored
68
69 Testing
70 -------
2b862ba @patrickbaumann a couple more readme fixes
patrickbaumann authored
71 Testing can be initiated from your ./geocamMemoWeb/example path using the test command::
c4cbeaa @patrickbaumann Updated Readme
patrickbaumann authored
72
73 python manage.py test geocamMemo geocamTalk
74
75 See the Django documentation for more information on using manage.py
f1fd143 Initial commit following geocamDjangoAppSkeleton creation
Adam Grant authored
76
ea490e9 @trey0 cleaned out inline copy of django-revisions; added license headers
trey0 authored
77 .. o __BEGIN_LICENSE__
78 .. o Copyright (C) 2008-2010 United States Government as represented by
79 .. o the Administrator of the National Aeronautics and Space Administration.
80 .. o All Rights Reserved.
81 .. o __END_LICENSE__
Something went wrong with that request. Please try again.