smappR (version 0.5)

count.tweets: Connect to Mongo database and return count of tweets that match conditions specified in the arguments.

Description

count.tweets opens a connection to the Mongo database in the lab computer and will return the number of tweets that match a series of conditions: whether it contains a certain keyword, whether it is or not a retweet, or whether or not it contains a hashtag.

Usage

count.tweets(set, string = NULL, retweets = NULL, hashtags = NULL, from = NULL, to = NULL, user_id = NULL, screen_name = NULL, verbose = TRUE)

Arguments

set

string, name of the collection of tweets in the Mongo database to query.

string

string or vector of strings, set to NULL by default (will return count of all tweets). If it is a string, it will return the number of tweets that contain that string. If it is a vector of string, it will return all tweets that contain at least one of them.

retweets

logical, set to NULL by default (will return count of all tweets). If TRUE, will count only tweets that are retweets (i.e. contain an embededed retweeted status - manual retweets are not included). If FALSE, will count only tweets that are not retweets (manual retweets are now included).

hashtags

logical, set to NULL by default (will return count of all tweets). If TRUE, will count only tweets that use a hashtag. If FALSE, will count only tweets that do not contain a hashtag.

from

date, in string format. If different from NULL, will consider only tweets after that date. Note that using this field requires that the tweets have a field in ISODate format called timestamp. All times are GMT.

to

date, in string format. If different from NULL, will consider only tweets after that date. Note that using this field requires that the tweets have a field in ISODate format called timestamp. All times are GMT.

user_id

numeric ID of a user. If different form NULL, will count only tweets sent by that Twitter user (if there are any in the collection)

screen_name

screen name of a user. If different form NULL, will count only tweets sent by that Twitter user (if there are any in the collection)

verbose

logical, default is TRUE, which generates some output to the R console with information about the count of tweets. If codeFALSE, function will not return any object.

Examples

## Not run: 
# ## connect to the Mongo database
#  mongo <- mongo.create("SMAPP_HOST:PORT", db="DATABASE")
#  mongo.authenticate(mongo, username="USERNAME", password="PASSWORD", db="DATABASE")
#  set <- "DATABASE.COLLECTION"
# 
# ## count all tweets in the database
#  count.tweets(set)
# 
# ## count tweets that mention the word 'turkey'
#  count.tweets(set, string="turkey")
# 
# ## count tweets that mention the words 'turkey' and 'gezi'
#  count.tweets(set, string=c("turkey", "gezi"))
# 
# ## count all retweets in the database
#  count.tweets(set, retweets=TRUE)
# 
# ## count all tweets that mention 'turkey' and are not retweets
#  count.tweets(set, string="turkey", retweets=FALSE)
# 
# ## count all tweets that use a hashtag
#  count.tweets(set, hashtags=TRUE)
# 
# ## count all tweets from January 1st to January 15th
#  count.tweets(set, from="2014-01-01 00:00:00", to="2014-01-15 23:59:59")
# ## End(Not run)