This project uses TurkServer to study how people can organize to do crisis mapping. It was used to run the experiment and generate the data for the following paper:
Running the app
Install Meteor. Then, clone this repository and run the following command:
meteor --settings settings.json
If that works, then you should be able to view the data from the experiment. Using this software to run another experiment is a bit more complicated, as it's not that well documented. However, the code is well-commented.
Viewing the data
CrowdMapper was designed to both facilitate a teamwork task as well as log the interactions for further analysis. Using the data from the experiment, you can access visualizations and replays with the following instructions:
- Start Meteor in development mode as above.
- Unzip the MongoDB dump to a local directory, e.g.
tar xjvf data.tar.bz2. Usually, you want to make sure this is in a folder preceded by
.so that Meteor doesn't try to read it, e.g.
- Replace the database
mongorestore --host localhost:3001 --drop .backups/data. Once this finishes, you will have a copy of the database from after the experiment.
- You will need to restart Meteor to reset the admin password. Then, you can access the visualizations and replays at http://127.0.0.1:3000/overview.
To do further analysis on the data, please consult the instructions below, and the source code.
If you are replicating the original analysis from the paper, this project has several dependencies that can't be installed by Meteor.
The data analysis uses libzmq for Node.js to make RPC calls to algorithms implemented in Python, as outlined in this blog post. If you don't have ZeroMQ installed on your system, you will see an error when starting the Meteor app (it should still start) and you won't be able to start the Python computation process or run any of the data analysis methods.
To make the analysis algorithms available, first install the
libevent libraries, using whatever is appropriate for your system. For example, on Ubuntu:
apt-get install libzmq-dev apt-get install libevent
If all the above works, Meteor should be able to install the
zerorpc npm package as part of the app without any issues.
In addition, install the python dependencies for ZeroRPC, and Munkres (the Hungarian algorithm):
pip install pyzmq pip install zerorpc pip install munkres