SEASR Analytics and Zotero University of Illinois at Urbana-Champaign
Outline Brief Zotero Introduction SEASR Analytics for Zotero Plugin Zotero Flows Configuration Mechanism Web Service Components Zotero-enabled Flows Attendee Project Work
The Zotero Picture The WEB The WEB Zotero Store
What is Zotero? (from Zotero Quick Start Guide) A citation manager. It is designed to store, manage, and cite bibliographic references, such as books and articles. In Zotero, each of these references constitutes an item. An extension for the Firefox web-browser by the Center for History and New Media at George Mason University. Installed by visiting zotero.org and clicking the download button on the page.
Zotero Features (from zotero.org) Automatically capture citations Remotely back up and sync your library Store PDFs, images, and web pages Cite from within Word and OpenOffice Take rich-text notes in any language Wide variety of import/export options Free, open source, and extensible Collaborate with group libraries Organize with collections and tags Access your library from anywhere Automatically grab metadata for PDFs Use thousands of bibliographic styles Instantly search your PDFs and notes Advanced search and data mining tools Interface available in over 30 languages
The Zotero + SEASR Picture The WEB Zotero Store The WEB
SEASR Analytics for Zotero An extension for the Firefox web-browser by the SEASR Team Uses your Zotero Collections Performs analysis using SEASR Services
SEASR Analytics for Zotero Interface
How to Setup Your Machine Install/Open Firefox Install Zotero – – Install the SEASR Zotero plugin – The plugin points to the default services provided by SEASR (running on our server)
Zotero and SEASR Tag Cloud Analysis Readability Analysis Automatic Summarization Network Analysis Date Entity to Simile Timeline Example: Zotero, SEASR, Protovis, Google Maps, Simile Location Entity to Google Map
Tag Cloud Examples Tag Cloud Viewer –Creates tag cloud for all items submitted (with a url), stop words filtered including common tokens (punctuation), stemmed, top 100 words displayed in tag cloud viewer NGram Tag Cloud Viewer –Creates tag cloud for all items submitted (with a url), stop words filtered including common tokens (punctuation), 2-grams, top grams displayed in tag cloud viewer
Entity Extraction Examples Date Entities to Simile Timeline –Extracts date entities from all items submitted (with a url), and plots these dates on the Simile Timeline Location Entities to Google Map –Extracts location entities from all items submitted (with a url), and plots these on a Google Map Entities to Protovis Network –Extracts entities, creates relationships of entities existing in the same sentence and display in a Protovis force directed link node graph
Text Summarization HITS Summarizer –Finds top sentences and tokens from all items submitted (with a url) and displays them in a report
Flesch-Kincaid Readability Test Given: Zotero item(s) Results show scores for each item selected –Designed to indicate comprehension difficulty when reading a passage of contemporary academic English –Flesch Reading Ease: higher scores indicate material that is easier to read; lower numbers mark passages that are more difficult to read –Flesch–Kincaid Grade Level: result is a number that corresponds with a grade level
Authorship Analysis Given: Zotero Collection (or multiple items selection) with Author/Co-Author Information Determine importance of given authors in this collection? –Each author is a vertex in the graph –Authors are connected with an edge if they are co-authors of an item –List of Authors ranked by the Betweenness Centrality Measure –Betweenness is a centrality measure of a vertex within a graph. Vertices that occur on many shortest paths between other vertices have higher betweenness than those that do not.
The Value Added Analytical Results are saved as Zotero items (View Snapshot) –Includes metadata –Item naming strategy identifies the item or collection processed –Creator indicates the Menu Label of the SEASR Analysis Related Tab links to the items processed in the Analysis No need to install the analysis, it runs as web service
The Zotero Plugin Open Firefox Install Zotero – Install the SEASR Zotero plugin – The plugin will point to the default services provided by SEASR You can develop and deploy your own (samples available) SEASR plugin preferences allow to point to other service providers
Demonstration We will be demonstrating how to install and use the SEASR Analytics extension for Zotero
Learning Exercises: Zotero Collection Have participants run some of the Zotero-enabled flows –Setup a Zotero collection you want to use, skip to the next step Create a collection by right-clicking on "My Library" and selecting "New Collection" –Give the collection a name (such as "DocSouth") Select this collection Use Firefox to navigate to Open Zotero by clicking the Zotero icon in Firefox (bottom-right corner) Capture the current webpage as a Zotero item by clicking the "Create new item from current page" button (fifth from the left on the Zotero toolbar) Navigate to and repeat the previous stephttp://docsouth.unc.edu/neh/adams/adams.html You should now have two documents in your "DocSouth" collection
Learning Exercise: Access SEASR Select one or more items in Zotero and then right-click on one of the selected items and choose SEASR Analytics -> SEASR -> Tag Cloud Viewer to create a tag cloud from text extracted from your Zotero item(s) Do the same thing but select SEASR Analytics -> SEASR -> Hits Summarizer instead, to view a list of top tokens and sentences extracted from your item(s) Repeat the same procedure one more time, but this time select SEASR Analytics -> SEASR -> Date Entities to Simile Timeline to view a timeline containing dates extracted from your item(s)
Discussion Questions What kinds of data assets would you be creating in Zotero? What other analysis would you like to use against this data?
Creating Zotero Flows
Outline Zotero Flow SEASR Configuration File
SEASR Plugin Preferences Configuration files are managed in a list Each configuration file can be enabled or disabled Reload will refresh the plugin with the flows in the configuration files
Local Setup Copy config file to your machine from – In Zotero, –Select Preferences from Menu –Go to SEASR Click Add –Specify a Provider Name –Specify a URL for the config file (file:///Users/lauvil/Sites/zotero.config)file:///Users/lauvil/Sites/zotero.config –Click box for Enabled Note: In the future, after editing the config you only need to click “Reload”
Extensible to Analysis that You Create You can deploy the flows we have on your server or request your university to host this analysis You can modify these flows and redeploy You can create new flows –Perhaps you want to see only nouns or verbs –Perhaps you want to see a list of extracted entities You can share these flows back to the community
Configuration File (XML or json) Contains 2 attribute-value pairs –name: label to use in the Zotero drop-down display –url: url for where to send the post XML json {"seasr_flows":[ {"name":"Author Centrality Analysis", "url":" ice-head-post/instance/shp" }, {"name":"Flesch-Kincaid Readability Test", "url":" ice-head-post/instance/shp" } ]}
What does a Web Service Flow Look Like Common components used for creating a web service flow Service Head Post –Receives the http post and sends the data to the rest of the flow Service Tail Text –Send the results back to the http request
Another Zotero Service Flow Components that read Zotero data from the web service Zotero Author Extractor (previous slide) –Extracts the author-coauthor from each item Zotero URL Extractor –Extracts the url from each item
Demonstration We will go through an example of what a Zotero-enabled flow looks like and what's special about it We will show how to modify an existing Zotero-enabled flow and how to "deploy" it so that it can be leveraged within Zotero
Learning Exercises 1.Create a new flow (or adapt an existing flow) using the Meandre Workbench that performs some simple analysis and "deploy" it for access by Zotero 1.We can use the flow we constructed in an earlier session as a base 2.Execute this flow 3.Change the configuration of SEASR plugin so that it knows how to access this flow 4.From Zotero, refresh the configuration file 5.Select some data to process through the updated SEASR flow
Discussion Questions What kinds of data assets would you be creating in Zotero? What other analysis would you like to use against this data?