last modified: 2017-02-19
Description of the plugin
You can find additional documentation on this plugin on Matthieu’s website.
This plugin enables you to:
Collect tweets in realtime, on the topic you choose
Get the connections between the users mentionned in these tweets
Visualize these connections in Gephi, or just export all the tweets to Excel
Installing the plugin
|The setup of the plugin will need you to create a Twitter account, if you don’t already have one. Get your Twitter login and password ready. You also need a mobile phone number where your Twitter account can be confirmed.|
Setting up a Twitter account and creating a Twitter app is a boring task.
It takes just 15 minutes, and you have to do it just once. Then you’ll have Twitter at your fingertips.
Initializing the plugin (to be done just once)
We need now to connect to a Twitter account. If you already have a Twitter account and you are logged in, skip to here.
|You have received an email by Twitter about the sign up. At some point (but now would be a good time), you must click on the link in this email to confirm it.|
The next screens of the sign up for Twitter are not important for us. Just follow the steps until you get to the page showing your Twitter profile, meaning the setup is finished.
You now have a Twitter account. We need to create a Twitter app which will authorize us to collect tweets automatically via Gephi
Go to https://apps.twiter.com:
INFO: Almost there!!
Well done. This setup had just to be done once. Your credentials are saved and will be loaded at each run. Now we can start using the plugin.
Using the plugin
With the Words to follow tab, you will be able to follow one or multiple words. For hashtags , just enter the word without the hash in front of it. (e.g if you want to follow '#Gephi' just add 'Gephi')
With the Users to follow tab, you will be able to follow the activity of one or multiple users. Any tweet from this user or retweeting or mentioning the user will be captured.
You can combine the 2 tabs, the tweet collected will be matching either the Words to follow query or the User to follow query
The Load Query File and Save Query File buttons are here to save your search queries in a file or to load it from a file. It’s convenient if you have a long list of words / users.
A Network Logic means: what should be done with an incoming tweet? How to transform it as a set of nodes and edges?
There are for the moment 3 Network Logics to choose from:
Full Twitter Network : This will represent all entities (User, Tweet, Hastags, URL, Media, Symbol etc…) as a graph.
User Network : This will represent the interaction between users. Any mentions, retweets or quotes between 2 users, will be represented. The size of the edge represent the number of interactions between 2 users.
Hashtag Network : This will create the network of hashtag.
In the following, we use the network logic "User Network":
Be careful that if you choose very common terms, tweets will arrive fast and in large volumes.
If you don’t have enough memory (RAM) on your computer, this could make it crash.
Click on "disconnect" to stop the collection of tweets.
You can see the users organize spatially in real time, while the tweets are being collected.
Just run Force Atlas 2 in the "Layout" panel. This will not interrupt the collection of tweets.
Shift to the
data laboratory to view the data collected, in a spreadsheet format:
There, you can export nodes and relations ("edges") as csv files by clicking on "Export table".
When you are finished with your stream, you can use the timeline feature to replay the stream of data and look at a particular time window.
This feature is still experimental and is higly subject to bug.