e-mission is a project to gather data about user travel patterns using phone apps, and use them to provide an personalized carbon footprint, and aggregate them to make data available to urban planners and transportation engineers.
It has two components, the backend server and the phone apps. This is the backend server - the phone apps are available in the e-mission-phone repo
The backend in turn consists of two parts - a summary of their code structure is shown below. The webapp supports a REST API, and accesses data from the database to fulfill the queries.
A set of background scripts pull the data from moves, and preprocess results to ensure reasonable performance.
-
Install Mongodb (Note: mongodb appears to be installed as a service on Windows devices and it starts automatically on reboot) Note: If you are using OSX: You want to install homebrew and then use homebrew to install mongodb. Follow these instruction on how to do so ---> (http://docs.mongodb.org/manual/tutorial/install-mongodb-on-os-x/)
-
Start it at the default port $ mongod Ubuntu: http://docs.mongodb.org/manual/tutorial/install-mongodb-on-ubuntu/
We will use a distribution of python that is optimized for scientific computing. The anaconda distribution is available for a wide variety of platforms and includes the python scientific computing libraries (numpy/scipy/scikit-learn) along with native implementations for performance. Using the distribution avoids native library inconsistencies between versions.
The distribution also includes its own version of pip, and a separate package management tool called 'conda'.
After you install the anaconda distribution, please ensure that it is in your
path, and you are using the anaconda versions of common python tools such as
python
and pip
, e.g.
$ which python
/Users/shankari/OSS/anaconda/bin/python
$ which pip
/Users/shankari/OSS/anaconda/bin/pip
(You may need super user permissions to run these commands)
$ pip install -r requirements.txt
# If you are running this in production over SSL, copy over the cherrypy-wsgiserver
$ cp api/wsgiserver2.py <dist-packages>/cherrypy/wsgiserver/wsgiserver2.py
In order to test out changes to the webapp, you should make the changes locally, test them and then push. Then, deployment is as simple as pulling from the repo to the real server.
Here are the steps for doing this:
-
Copy config.json.localhost.android or config.json.localhost.ios to config.json, depending on which platform you are testing against.
-
Copy keys.json.sample to keys.json, register for the appropriate keys, and fill them in
-
Start the server (Note: mongodb appears to be installed as a service on Windows devices and it starts automatically on reboot)
$ cd CFC_WebApp $ python api/cfc_webapp.py
You may need to install some of the python dependencies from above Amongst the dependencies include: -cherrypy -pygeocoder
-
Browse to http://localhost:8080 or connect to it using the phone app
-
Make sure that the anaconda python is in your path
$ which python /Users/shankari/OSS/anaconda/bin/python
-
Run all tests.
$ ./runAllTests.sh
-
If you get import errors, you may need to add the current directory to PYTHONPATH.
$ PYTHONPATH=. ./runAllTests.sh
-
If you need to run any of the backend scripts, copy the config.json and keys.json files to that directory as well, and run the scripts:
cd CFC_DataCollector cp ../CFC_WebApp/config.json . cp ../CFC_WebApp/keys.json . python moves/collect.py python modeinfer/pipeline.py
These repositories don't have the associated client keys checked in for security reasons.
If you are associated with the e-mission project and will be integrating with our server, then you can get the key files from: https://repo.eecs.berkeley.edu/git/users/shankari/e-mission-keys.git
If not, please get your own copies of the following keys:
- Google Developer Console
- Android key
- iOS key
- webApp key
- Moves app
- Client key
- Client secret
And then copy over the sample files from these locations and replace the values appropriately:
- CFC_WebApp/keys.json
- CFC_DataCollector/keys.json
-
If a python execution fails to import a module, make sure to add current directory to your PYTHONPATH.
-
If starting the server gives a CONNECTION_ERROR, make sure MongoDB is actively running when you attempt to start the server.
-
On windows, if you get an error that
dbpath does not exist
, make sure to % md c:\data\db\
This site is currently designed to support commute mode tracking and aggregation. There is a fair amount of backend work that is more complex than just reading and writing data from a database. So we are not using any of the specialized web frameworks such as django or rails.
Instead, we have focused on developing the backend code and exposing it via a simple API. I have maintained separation between the backend code and the API glue so that we can swap out the API glue later if needed.
The API glue is currently Bottle, which is a single file webapp framework. I chose Bottle because it was simple, didn't use a lot of space, and because it wasn't heavy weight, could easily be replaced with something more heavyweight later.
The front-end is javascript based - I will experiment with Angular later, but right now, it uses jquery and NVD3, which is a wrapper layer that makes it easier to display simple graphs using D3.
If you are running this in production, you should really run it over SSL. We use cherrypy to provide SSL support. The default version of cherrypy in the anaconda distribution had some issues, so I've checked in a working version of the wsgiserver file.
TODO: clean up later
$ cp api/wsgiserver2.py <dist-packages>/cherrypy/wsgiserver/wsgiserver2.py
Also, now that we decode the JWTs locally, we need to use the oauth2client, which requires the PyOpenSSL library. This can be installed on ubuntu using the python-openssl package, but then it is not accessible using the anaconda distribution. In order to enable it for the conda distribution as well, use
$ conda install pyopenssl
Also, installing via requirements.txt
does not appear to install all of the
requirements for the google-api-client. If you get mysterious "Invalid token"
errors for tokens that are correctly validated by the backup URL method, try to
uninstall and reinstall with the --update option.
$ pip uninstall google-api-python-client
$ pip install --upgrade google-api-python-client