Package wethepeople. March 3, 2013

Transcription

1 Package wethepeople March 3, 2013 Title An R client for interacting with the White House s We The People petition API. Implements an R client for the We The People API. The client supports loading, signatures, and users. Additionally, the package includes petition and signature data samples. There are also several functions for analyzing and visualizing the data. Term frequency calculations and word clouds are supported using the tm and wordcloud package, respectively. Petition and issue summary plots are also implemented using the ggplot2 package. For additional information about the We The People project, see Version 0.2 License GPL-3 Author Yoni Ben-Meshulam Maintainer Yoni Ben-Meshulam <yoni@opower.com> Depends R (>= 2.10), rjson, ggplot2, plyr, reshape, tm, wordcloud,rcolorbrewer, RCurl Collate melt_issues.r plot_issues_over_time.r wethepeoplepackage.r plot_wordcloud.r WeThePeopleClient.r petition_term_document_matrix.r generate_wordcloud_plots.r plo NeedsCompilation no Repository CRAN Date/Publication :07:07 R topics documented: generate_wordcloud_plots melt_issues _from_json petition_term_document_matrix plot_issues_over_time

2 2 generate_wordcloud_plots plot_issues_pending_response plot_signature_count plot_status_by_creation plot_wordcloud signatures signatures_from_json users_from_json wethepeople WeThePeopleClient Index 10 generate_wordcloud_plots Generates plots of wordclouds for each petition. Generates plots of wordclouds for each petition. generate_wordcloud_plots(, path, column) path column data.frame of, e.g. loaded from client$() the path to write the images to the column to use as the input text data() one_petition <- head(, n=1) generate_wordcloud_plots(one_petition, tempdir(), body )

3 melt_issues 3 melt_issues Melts the data.frame, creating multiple rows for each petition issue. Melts the data.frame, creating multiple rows for each petition issue. melt_issues() data.frame loaded using load_ melted data.frame with one row per issue Petitions loaded Feb 19, 2013 Sample loaded from the API on February 19, Author(s) Yoni Ben-Meshulam <yoni@opower.com> _from_json Transforms from JSON to a data.frame Transforms from JSON to a data.frame _from_json() nested lists from the json representation

4 4 plot_issues_over_time users data.frame petition_term_document_matrix Calculates the TermDocumentMatrix for. Calculates the TermDocumentMatrix for. petition_term_document_matrix(, column) column data.frame of which column from the to use for the word cloud (e.g. body, title ) TermDocumentMatrix the tdm of the given petition column data() petition_body_tdm <- petition_term_document_matrix(, body ) petition_title_tdm <- petition_term_document_matrix(, title ) $body_and_title <- paste($body, $title, sep="\n") petition_body_and_title_tdm <- petition_term_document_matrix(, body_and_title ) plot_issues_over_time Generates a plot of issues over time. Generates a plot of issues over time. plot_issues_over_time()

5 plot_issues_pending_response 5 a data frame of data() plot_issues_over_time() plot_issues_pending_response Generates a plot of issues pending response over time. Generates a plot of issues pending response over time. plot_issues_pending_response() a data frame of data() plot_issues_pending_response() plot_signature_count Plots the signature counts over time. Plots the signature counts over time. plot_signature_count(signatures) signatures data.frame of the signatures to plot ggplot2 plot object

6 6 plot_wordcloud plot_status_by_creation Plots the statuses according to the creatio time. Plots the statuses according to the creatio time. plot_status_by_creation() data.frame of plot of the status by creation date plot_wordcloud Plots a wordcloud for the given. Shamelessly taken from example code in plot_wordcloud(, column, colors = brewer.pal(8, "Dark2"), scale = c(8, 0.2)) column colors scale a data frame of which column from the to use for the word cloud (e.g. body, title ) the colors to use for the words the scale to use for the wordcloud plot plot of the wordcloud for all

7 signatures 7 data() one_petition <- head(, n=1) print(plot_wordcloud(one_petition, body )) signatures Signatures loaded Feb 19, 2013 Sample signatures loaded from the API on February 19, Author(s) Yoni Ben-Meshulam <yoni@opower.com> signatures_from_json Transforms Signatures from JSON to a data.frame Transforms Signatures from JSON to a data.frame signatures_from_json(signatures) signatures nested lists from the json representation users data.frame

8 8 wethepeople users_from_json Transforms Users from JSON to a data.frame Transforms Users from JSON to a data.frame users_from_json(users) users nested lists from the json representation users data.frame wethepeople A package for working with the We The People data. wethepeople is an R package for working with the White House s We The People petition data. Author(s) Yoni Ben-Meshulam <yoni@opower.com> # Load a sample set of and generate some plots: data() some_ <- head(, n=5) plot_issues_over_time(some_) plot_wordcloud(some_, title ) # Create an API Client client <- WeThePeopleClient( SOME_API_KEY )

9 WeThePeopleClient 9 WeThePeopleClient We The People API Client, based on RCurl. see RCurl We The People API Client, based on RCurl. see RCurl WeThePeopleClient(key = "") key optionsl We the People API Key. All functions except for API calls should work without the key. WeThePeople Object with methods for interfacing with the API client <- WeThePeopleClient( MY_API_KEY )

10 Index Topic datasets, 3 signatures, 7 Topic data, 3 signatures, 7 generate_wordcloud_plots, 2 melt_issues, 3 petition_term_document_matrix, 4, 3 _from_json, 3 plot_issues_over_time, 4 plot_issues_pending_response, 5 plot_signature_count, 5 plot_status_by_creation, 6 plot_wordcloud, 6 signatures, 7 signatures_from_json, 7 users_from_json, 8 wethepeople, 8 wethepeople-package (wethepeople), 8 WeThePeopleClient, 9 10