Introduction:

TweetTracker is a powerful tool from Arizona State University that can help you track, analyze, and understand activity on Twitter.

Developed by students and faculty in the Data Mining and Machine Learning Lab at Arizona State Univeristy, CrisisTracker is a great tool for delivering real time crisis information to first responders that interoperates with TweetTracker and its data.

This document will provide an introduction to the system so you can get acquainted with it.

Any additional questions, comments, or concerns can be emailed to crisistracker@gmail.com.

Requirements:

For the most effective use of CrisisTracker, you must have an updated version of a web browser, and an active internet connection. However, our team has made efforts to provide fallbacks for older browsers.

TweetTracker has been developed and tested on the following browsers.

  • Firefox Version 27+
  • Internet Explorer 8+
  • Google Chrome Version 33+

Overview:

CrisisTracker consists of two sides:

Dispatcher

The dispatcher decides what information is important and sends it off to the first responders. The importance of the information can be determined using first responder feedback and ratings, word clouds, trendlines, and personal knowledge of current crises.

First Responder

The first responder connects to one or more dispatchers in order to receive up-to-date information regarding crises that are occuring in their area. Each first responder can rate the tweets they receive and provide more substantial feedback using the chat system.

Registration:

On either login page, you will see a link at the bottom of the page that informs you that you can register for a new account if you do not already have one.

Dispatcher Login Page First Responder Login Page
Dispatcher Login Page First Responder Login page

Dispatcher:

These instructions will show you how to navigate the dispatcher application.

Logging In

After registration, you can log in to the application right away. You can only have one instance of your account logged in at a time. If you log in on one computer, and then try to log in again, you will be signed out of the first computer.

First Look

When you first sign in, you should see a screen like this:

Dispatcher Dashboard

Recent Tweets

This tab will allow you to see all the recent tweets and search/filter them.

Tweet Ratings

Here you can view the tweets that have been rated along with how many ratings there have been plus the average rating.

TweetTracker Jobs

You can edit, create, or delete TweetTracker jobs here. More info on these later.

Map

The map will allow you to see geotagged tweets, first responder locations, and search for locations. You can also annotate the map for first responders that connect to you.

Chat

You can communicate with first responders directly or amongst the groups you have created.

Stats

A trendline graph is available to show you the trend of tweets per active jobs. A customization panel allows you to tweak the graph to show you what you want to see.

Grouping

You can create as many groups as you want to help you organize the first responders that connect to you. The plus buttons adds a group. You can double click on the title to rename the group. Deleting a group requires clicking on the minus button. This will enable the deletion button per each group. If you want to add a user to a group, drag and drop the user from the All Responders group into your created group. To remove a user, simply drag them into the trash can icon that appears.

Sending Tweets

You can send tweets to first responders by selecting one or more tweets, then dragging them into the appropriate panel or user. Dropping the tweets into the group panels will send the tweets to all the connected first responders in that group. Dropping the tweets into the user will only send the tweets to that user.

Filtering Tweets

If you want to filter the tweets, there are options provided to the right of the tweet table. You can search for tweets that match certain keywords. You can sort the tweets by most recent, users with the most followers, or tweets that have been retweeted the most.

First Responder:

These instructions will show you how to navigate the first responder application.

Logging In

After registration, you can log in to the application right away. You can only have one instance of your account logged in at a time. If you log in on one computer, and then try to log in again, you will be signed out of the first computer.

First Look

When you first sign in, you should see a screen like this:

First Responder View

This is your user menu.

First Responder Menu
Dispatchers

The dispatchers page shows you which dispatchers are currently online and allows you to connect to one or more.

Tweets

The tweets page shows incoming tweets for you to read and rate. There is also a history to show you past tweets and their ratings.

Map

The map page displays your current location (if allowed), geotagged tweets, an optional overlay of medical facilities, and per dispatcher annotations.

Stats

The stats page lets you view a chart showing your tweets received over the past month. You can also view a trendline chart for active events.

Tweet Cloud

The tweet cloud is a wordcloud of the top 20 keywords of the collected data. The data is updated every minute.

Chat

The chat system allows you to chat to the dispatchers you connect to. You can also chat with others in the groups that the dispatcher has set.

Settings

The settings page is where you can update your personal information and change your password. You can also register your phone number so you can use the SMS system (recommended).

Rating Tweets

When you receive tweets, you have the ability to rate them so the dispatcher can have an idea of how useful they have been to you. All you need to do is tap which star rating you feel best represents the quality of the tweet(s).

Viewing Annotations

Above the map, you can choose which dispatcher's annotations to view (if they have any). Whenever a dispatcher updates them, they should be visible to you as long as you have that dispatcher selected.

Receiving SMS

After you register your phone number on the Settings page, you will be able to receive messages from and send messages to dispatchers. If you want to send a message and don't already have the number, save +14062043665 to your contacts for future use.

Troubleshooting:

Any additional questions, comments, or concerns can be emailed to crisistracker@gmail.com.

FAQ:

Tweets can be dragged and dropped. Multiple tweets can be selected via shift-clicking or ctrl-clicking. Then they can all be dragged to the groups and dropped to be sent off to the groups (or individual users).

There is a create button above the groups that will allow you to create any more groups that you want.

Yes, you can. Double click on the group header to rename the group. Be sure to save the groups to retain the name.

Like the tweets, users can be dragged and dropped into the groups.

Yes, groups can be saved on the server and recalled every time you log back in. You need to click the save button for that to be done, though.

There is a chat tab on both the dispatcher and first responder pages. They allow for you to send messages directly to whomever you need to contact. Dispatchers can select a whole group or individual first responders. First responders also have the ability to correspond with all dispatchers they are connected to or just one in particular.

Dispatchers can send SMS messages to first responders if the first responder has registered their phone number in their settings. Likewise, a first responder can contact a dispatcher through our backup SMS system.

The dispatchers control which first responders are in which groups. If you ask nicely, maybe the dispatcher will heed your request.