Edgemaps visualization with Pundit annotations

= Introduction =

This tutorial demonstrates how particular types of annotations, created by scholars on web documents, can generate an interactive visualization. As a demonstrative example domain we focus on philosophy. We will guide users in the process of annotating citations among philosophical texts. Such annotations, made with Pundit, will be used to state that a text from an author “cites” another author. The annotations will be then used to create an interactive Edgemap graph (http://mariandoerk.de/edgemaps/) showing the influences among a the annotated philosphers.



The previous picture shows what the Edgemap we are going to create in this tutorial will look like. To make this demo work, you will need one of the following browsers: google chrome, firefox or safari.

= Audience =

This tutorial is targeted to end users, mainly scholars that want to test Pundit and the related technologies in a simple case study.

= Description =

Get the Pundit bookmarklet
The Pundit Philosphers demo bookmarlet is available here: http://thepund.it/bm/demo-philosophers/bookmarklet.html You just have to drag and drop the “Pundit Philosophers DEMO” link to your browser’s bookmark-toolbar.

Prepare for annotating
You can annotate a generic web page using the Pundit bookmarklet. We suggest you to go to http://wikisource.org and search for an interesting text. Once you are in the web page you want to annotate, click the “Pundit latest” button you find in your browser bookmarks-toolbar, to load Pundit and start annotating.

Create a new notebook
Create a new notebook and set it as current notebook in Pundit. In the Pundit top bar, go to “Your User Name” > “Manage Notebooks”. Under “Create a new notebook” type the name of your new notebook. Set the new notebook as “current notebook”. To do so click on the gear button corresponding to the notebook and choose “Set as Current Notebook”

Create Edgemaps compliant annotations
To assert that author-1 cites author-2 in his text-fragment, you must create two triples (the order is not important):

To do so, you will use the “Triple composer” component like this: Select the text fragment you want to annotate and click “annotate text fragment”.

(a) The triple composer will open. (b) Select the predicate by clicking on the yellow “predicate” box (c) Select the object by clicking on the red “object” box (d) To add a new triple click the “Add a new triple” button (e) Drag the text-fragment from the “subject” box to the empty “subject” box (f) Select the predicate by clicking on the empty yellow “predicate” box (g) Select the object by clicking on the empty red “object” box (h) Important: to make the visualization work, you must choose a philospher from the DEMO-PHILOSOPHERS vocabulary (i) Click “Save”

Visualize your notebook in Ask the Pundit
Go to http://ask.as.thepund.it and find your public notebook, or click on “My Ask” to login and find your personal notebooks. Click the “browse” button and your annotations will be shown.

Visualize and explore your notebook as an Edgemap
Once you opened your notebook in Ask the Pundit, click on the green “Edgemaps influence graph” button at the bottom of the page: an Edgemap graph will show the relations you established among authors. The timeline shows each philosopher as a circle. Clicking on a circle shows all of the links between this and other philosophers, putting the mouse on the linked philosopher will show the annotations that generated the link. The annotation box shows the author and the annotated page, which can be reached by clicking on “go to annotated webpage”.

Iterate
Create more annotations repeating step 3. Refresh the visualization page to update it.

Mashup notebooks
This demonstration was performed by a group of users in Pisa, we created an edgemap where all the annotations from the participants were put together. You can see the result following this URL: http://thepund.it/edgemaps_demo/demo.html?nbs={0542cd8d,0f9e15a8,12377d49,144c4b17,2fcf4383,628d0485,633e5e63,6bdcd4a5,8482b3de,86cffd13,9ec66f55,b2061a6b}&source={pundit}#phils;time;

Note: if you want to include your own notebook in the collective edgemap you just have to modify the URL by including your notebook id among the others.

To do so:

http://ask.as.thepund.it/#/notebooks/6290cd68 (id = 6290cd68) Modify the URL by adding the notebook id. In the case of notebook 6290cd68: http://thepund.it/edgemaps_demo/demo.html?nbs={6290cd68,0542cd8d,0f9e15a8,12377d49,144c4b17,2fcf4383,628d0485,633e5e63,6bdcd4a5,8482b3de,86cffd13,9ec66f55,b2061a6b}&source={pundit}#phils;time;
 * Get your notebook id from http://ask.tehpund.it by opening your notebook and copying the last part of the URL, which should look like the following:

Feedback
When done, you could spend 5 minutes and fill this survey: http://goo.gl/uOe1t

Still curious? Try out these alternative paths!

ALTERNATIVE Step 2 You can annotate one of the following Muruca Digital Libraries: http://burckhardtsource.org In this case you should use the “annotate” button that you find in the Digital Libraries pages (no bookmarklet needed).

ALTERNATIVE Step 4 You can create more precise annotations by linking two text fragments from different authors. In this case the annotation must have the form: