From CWRC
LaTeX code for OVis
Click here for a plain text version of this LaTeX code.
\documentclass[a4paper,11pt]{article}
\usepackage{ulem}
\usepackage{a4wide}
\usepackage[dvipsnames,svgnames]{xcolor}
\usepackage[pdftex]{graphicx}
\usepackage{hyperref}
% commands generated by html2latex
\begin{document}\href{/index.php/File:Ovis2.png}{
\includegraphics{/AnnokiUploadAuth.php/thumb/d/d1/Ovis2.png/450px-Ovis2.png}}
\begin{tabular}
\subsection{Contents}
\begin{itemize}
\item \hyperlink{Introduction}{1Introduction}
\item \hyperlink{How_Ovis_Works}{2How Ovis Works}
\item \hyperlink{Ingredients}{3Ingredients}
\item \hyperlink{Steps}{4Steps}
\begin{itemize}
\item \hyperlink{Open_and_Load}{4.1Open and Load}
\item \hyperlink{Navigate}{4.2Navigate}
\item \hyperlink{Search}{4.3Search}
\item \hyperlink{Limit_Results}{4.4Limit Results}
\item \hyperlink{Modify_Layout}{4.5Modify Layout}
\item \hyperlink{Save_and_Reload}{4.6Save and Reload}
\item \hyperlink{Take_a_Screenshot}{4.7Take a Screenshot}
\end{itemize}
\item \hyperlink{Features}{5Features}
\begin{itemize}
\item \hyperlink{Layout_Strategies}{5.1Layout Strategies}
\begin{itemize}
\item \hyperlink{Force-Directed}{5.1.1Force-Directed}
\item \hyperlink{Non_Force-Directed}{5.1.2Non Force-Directed}
\end{itemize}
\item \hyperlink{Example_1_.28please_refer_to_the_above_instructions_while_trying_these_examples.29}{5.2Example 1 (please refer to the above instructions while trying these examples)}
\item \hyperlink{Example_2}{5.3Example 2}
\end{itemize}
\item \hyperlink{Suggested_Activities}{6Suggested Activities}
\item \hyperlink{Discussion}{7Discussion}
\begin{itemize}
\item \hyperlink{Description}{7.1Description}
\item \hyperlink{Who_has_worked_on_creating_it}{7.2Who has worked on creating it}
\item \hyperlink{Where_to_read_about_it}{7.3Where to read about it}
\end{itemize}
\end{itemize}
\end{tabular}\hypertarget{Introduction}{}
\subsection{Introduction}
OrlandoVision (or OVis) is an experimental, interactive link-node graph designed for exploring the Orlando textbase. It enables the user to visualize the writers with entries in the Orlando textbase and the more than 30,000 people associated with them. \hypertarget{How_Ovis_Works}{}
\subsection{How Ovis Works}
OVis represents the connections between people as nodes and the relationship between them as edges, and enables the user to read about the context of the link through the text reading pane. The links or edges are colour-coded, which corresponds to the colouring of the particular semantic tag that indicates the context in which the association is mentioned, such as $<$politics$>$, $<$textualfeatures$>$, or literary $<$responses$>$. The tool also has a multi-functional search capacity which enables users to navigate large swaths of data at once. Users can learn about the connections between individuals in the Fabian Society, for instance, by searching for "Fabian" and tracing the links between the nodes (people) who appear on the graph.\hypertarget{Ingredients}{}
\subsection{Ingredients}
No external ingredients are needed.\hypertarget{Steps}{}
\subsection{Steps}
\begin{enumerate}\hypertarget{Open_and_Load}{}
\subsubsection{Open and Load}
\item Double-click the Ovis icon on the desktop.
\item Under "File," select ???Open Data.???
\item Navigate through the folders by clicking on "Desktop," "CWRC," "ovis," and "DATA" until you find a file called ???orlando\_entries\_all.??? Double-click it.
\item Wait briefly for the dataset to load.\hypertarget{Navigate}{}
\subsubsection{Navigate}
\item In order to navigate within the graph itself, you will need a conventional mouse.
\item To zoom into and out of the graph, use the scroll wheel, or right click and drag.
\item To move the entire graph, click the scroll wheel, hold, and drag into desired position.
\item To highlight (or select) a node or edge, left click on a node or edge.
\item To highlight multiple nodes or edges, press down the shift key and left click additional nodes and edges, or left click and drag a rectangular lasso.
\item Once a node is highlighted, the person's name will appear in the text pane at the bottom of the screen.
\item Once an edge is highlighted, the text extracted from the Orlando database will describe the context of the link in the text pane.
\item If you select multiple edges, the text extracted from the Orlando database will describe all the links you have selected. This text will appear in the scrollable text pane. The most recent links you have selected will appear at the top of the text pane.
\item To deselect nodes and edges, left click any empty space in the graph.\hypertarget{Search}{}
\subsubsection{Search}
\item In OVis, you can search using any of the following search options: "Text", "Author" (writer), or "Date Range".
\item To use the "Text" search feature, click on "Set" next to "Text" on the right-hand side of the screen.
\item Click ???Add??? in the window that pops up.
\item Double-Click in the empty box under ???Search Term.???
\item Type a search term in the text box.
\item To enter multiple search terms, click "Add" and enter another search term.
\item Click the box under "And/Or" to select "And" or "Or".
\item Click the box under "Stem" to select whether to stem your search term and include all variations of that term.
\item Select whether you want your search to be "broad" (showing all writers with entries in the Orlando database that mention the search term AND all other people to whom they are connected) or "narrow" (showing only the entries in the Orlando database that mention the search term).
\item Click "Remove" to remove the bottom search term.
\item Click "Cancel" to cancel search.
\item Click "OK" to set your search.
\item To use the "Author" (writer) search feature, click on "Set" next to "Author" on the right-hand side of the screen.
\item Click ???Add??? in the window that pops up.
\item Double-Click in the empty box under ???Search Term.???
\item Type an author name in the text box.
\item To use the "Date Range" search feature, click on "Set" under "Date Range" on the right-hand side of the screen.
\item A window will pop up.
\item Choose one of the options under "Historical Dates" or "Monarch Dates". DO NOT select both of these options.
\item Alternatively, enter a Start year into the text box below "Start" and "Year (1+)", select a Month and Day, and enter a End year into the text box below "End" and "Year (1+)", and select a Month and Day.
\item Click ???OK.???\hypertarget{Limit_Results}{}
\subsubsection{Limit Results}
\item Limit your results in OVis by selecting or deselecting the following options from the right-hand side of the screen below "Display Properties": "Visible Nodes", "Writer Sex" and "Writer Type".
\item Results may also be limited by selecting or deselecting Tags, on the lower right-hand side of the screen below "Active Tags".
\item To select all tags, click the "Check All" button.
\item To deselect all tags, click the "Uncheck All" button.
\item To select or deselect a particular tag, click the box to check or uncheck that tag.
\item Additional limiters are available through the "Search" function.\hypertarget{Modify_Layout}{}
\subsubsection{Modify Layout}
\item To change the size of nodes and links (edges), use the sliders on the top right of the screen.
\item To change the node colour, click "writers with entries" or "other people". Select colour from the colour wheel. Click "OK".
\item To change the node style, click on the "View" menu and navigate to "Set Node Style", which has more customization options.
\item To change the background colour, click on the "View" menu and navigate to "Set Background", which has more options.
\item To change the text that appears in the upper left hand corner of the screen, click on the "View" menu and navigate to "Set Annotation". A text box will appear. Write in your desired annotation.
\item To eliminate the text in the upper left hand corner of the screen, select or deselect "Show Annotation" in the "View" menu.
\item To see different ways to display the graph, click on the ???View??? menu, navigate to ???Set Layout Strategy,??? and select one of the other options. (**For a more detailed exploration of the Layout Strategies, see "Features" below.)\hypertarget{Save_and_Reload}{}
\subsubsection{Save and Reload}
\item To save a copy of your OVis Session, select "Save Session As" from the "Session" menu.
\item Write in the name of your session in the textbox that appears.
\item Select a folder in which to save your session.
\item Select the "Save" button.
\item To save subsequent changes to your session, select "Save Session" in the "Session" menu. This will save any subsequent changes you make to the session under your original session name.
\item To revert to your saved session once you have made changes to your graph that you wish to remain unsaved, select "Reload Session" in the "Session" menu.
\item Once you are finished with your session for a time, quit OVis.
\item To reload your previous session, double-click the OVis icon.
\item Under "Session," select ???Open Session.???
\item Navigate through the folders until you find the file you saved. Double-click it.\hypertarget{Take_a_Screenshot}{}
\subsubsection{Take a Screenshot}
\item To take a screenshot of your graph, select File from the menu and select Screenshot.
\item Save your screenshot where you want it.
\item To make the resolution of your screenshot higher, select "view" and then "Set Snapshot Magnification". Select desired magnification (from 1-10).
\item This screenshot feature will only take a picture of the graph itself, without the OVis frame.
\item To take a screen shot of the entire screen, press CTRL+SHIFT+4 on a Mac Keyboard, or the PrtSc button on a PC.
\\Try the example and suggested activities below!
\end{enumerate}\hypertarget{Features}{}
\subsection{Features}\hypertarget{Layout_Strategies}{}
\subsubsection{Layout Strategies}
The layout strategies available in Ovis can be divided into two categories: Force-Directed and Non Force-Directed.\hypertarget{Force-Directed}{}
\paragraph{Force-Directed}
In the case of the Orlando dataset, Force-Directed layouts will generally prove to be more useful, at the cost of requiring more time to produce results.
Force-Directed layouts use a physics based approach to arrange the nodes of a graph. The general goal of a force-directed layout is to attempt to ensure that the edges, i.e. the connections between nodes, are similar in length, and that they do not cross. However, given the structure of the graph this may not always be possible.
The best way to understand a force-directed layout is to think of the edges of a graph as though they were springs, and the nodes as though they were electrically charged particles. The nodes repel each other, while the springs attract. The interplay of forces continues until eventually the system reaches a point of relative equilibrium. At this point the graph is drawn using these positions.
For the most part, the force-directed layouts described below tend to represent the nodes with the most edges between them as being closer together in the graph. This is because the more edges between nodes, the stronger the attractive force between the nodes. This is particularly true of the "Simple 2D" and "Force-Directed" Graphs, which may prove the most useful for the Orlando dataset, at the cost of requiring more time to produce results.
For a more detailed explanation, please see: \href{http://en.wikipedia.org/wiki/Force-based_algorithms_%28graph_drawing%29}{http://en.wikipedia.org/wiki/Force-based\_algorithms\_\%28graph\_drawing\%29}
\\\textit{Simple 2D}
This layout uses the Fruchterman-Reingold algorithm (\href{https://nwb.slis.indiana.edu/community/?n=VisualizeData.Fruchterman-Rheingold}{https://nwb.slis.indiana.edu/community/?n=VisualizeData.Fruchterman-Rheingold}). Like the ForceDirected algorithm, it is fairly slow. A unique feature of this algorithm is that it uses an overall ???temperature??? in order to guarantee that the system will reach an equilibrium. This algorithm tends to produce graphs which are more dispersed than the ForceDirected algorithm.
\\\textit{Force-Directed}
This layout uses the Kamada-Kawai algorithm. It is a slow, force-directed layout algorithm and tends to produce graphs which have more clusters than the Simple2D algorithm.
\\\textit{Clustering2D, Community2D, and Fast2D}
These three layout algorithms are all fairly similar. While Clustering2D tends to produce a graph with more crossed edges, Community2D and Fast2D produce almost identical results. These algorithms create graphs much more quickly than the previous two layout algorithms, because they use a density grid which provides a random initial rough layout of the graph.\hypertarget{Non_Force-Directed}{}
\paragraph{Non Force-Directed}
Non Force-Directed layouts tend to be more random than Force-Directed layouts. This is particularly true of the "Random," and Circular layouts, which both place nodes within the boundaries of a graph in a random pattern.
\\\textit{Random}
Random is an extremely fast layout algorithm. As might be expected, this layout randomly places nodes within the boundaries of the graph. It is therefore not very helpful for displaying meaningful connections; however, due its speed it could be useful on slower computers and/or when working with a large number of nodes.
\\\textit{Circular}
This is a fast layout algorithm which arranges nodes around the circumference of a circle. Since there is no logic applied to the positioning of the nodes, it is not very useful for displaying meaningful connections.
\\\textit{Span Tree}
This is a fast layout algorithm which arranges nodes into a series of circular spanning trees. A spanning tree can be defined as the minimum number of edges that connect all the nodes of a graph. In the case of the Orlando dataset, we are usually working with a spanning forest, which consists of multiple, separate spanning trees. This layout is best suited to sparse graphs, wherein the number of edges is about the same as the number of nodes. For more information on spanning trees please see: \href{http://en.wikipedia.org/wiki/Spanning_tree}{http://en.wikipedia.org/wiki/Spanning\_tree}\hypertarget{Example_1_.28please_refer_to_the_above_instructions_while_trying_these_examples.29}{}
\subsubsection{Example 1 (please refer to the above instructions while trying these examples)}
\begin{enumerate}
\item Open and load the Orlando dataset, following the instructions above.
\item Using the "Text" search feature, search for "theosophy" OR "theosophist" (both unstemmed).
\item Limit your search by selecting "Narrow" (showing matching links only) in the "Text" search feature window.
\item Click "OK" to initiate this search.
\item Wait for the graph to load.
\item Set the "Fast 2D" layout strategy from the "View" menu.
\item Wait for the graph to load.
\item Determine what node is at the centre of the graph by using the navigation features of your conventional mouse.
\item Estimate which link or tag colour is the most prevalent in the graph, using the navigation features of your conventional mouse.
\item On the lower right-hand side of the screen below "Active Tags", click on "Uncheck All". Then select one tag to view only one type of link (ie: the "politics" tag).
\item Determine which nodes have the most links between them, using the navigation features of your conventional mouse.
\item Highlight one edge (or link) on the graph, by clicking on that edge using the left mouse button.
\item Read about the context of that link between two nodes in the text pane at the bottom of the page.
\end{enumerate}\hypertarget{Example_2}{}
\subsubsection{Example 2}
\begin{enumerate}
\item Open and load the Orlando dataset, following the instructions above.
\item Using the "Text" search feature, search for "Fabian Society" (unstemmed) OR "Fabian" (stemmed).
\item Limit your search by selecting "Narrow" (showing matching links only) in the "Text" search feature window.
\item Click "OK" to initiate this search.
\item Wait for the graph to load.
\item Set the "Force-Directed" layout strategy from the "View" menu.
\item Wait for the graph to load.
\item Determine what nodes (people) are at the centre of the graph by using the navigation features of your conventional mouse.
\item Using the shift key, select these nodes (people).
\item Determine which nodes have the most links between them, using the navigation features of your conventional mouse.
\item Estimate which link or tag colour is the most prevalent in the graph, using the navigation features of your conventional mouse.
\item Using the shift feature, highlight the edges (or links) that connect the nodes (people) in the graph.
\item Using the shift feature, draw a path between these people.
\item Read about the context of the links in the text pane at the bottom of the page.
\end{enumerate}\hypertarget{Suggested_Activities}{}
\subsection{Suggested Activities}
\begin{enumerate}
\item Try to find what connections exist between people involved with the "Men and Women's Club". Restrict the graph to "narrow" to get a sense of these connections. Observe what tag colours seem the most prevalent in the graph. Assess what figures appear to be central to the club by selecting the "Force-Directed" layout strategy, then viewing the nodes at the centre of the graph. Click on the links between individuals. Read about the context of these links.
\item Look at all people connected to the "poetess" movement who were alive during the early Victorian period. Restrict the graph to writers with entries to get a sense of relationships between them. Deselect all tags and then select only the reception-oriented tags to get a sense of the relationships involving reception amongst the group. See if you an arrive at a sense of who were the key figures related to reception in this literary network.
\end{enumerate}\hypertarget{Discussion}{}
\subsection{Discussion}
It should be remembered that this is an experimental interface that has not yet been officially released. This means that some bugs can be expected.\hypertarget{Description}{}
\subsubsection{Description}
A document with a more general description of OVis is available here: \href{http://entry.tapor.ca/?id=5}{http://entry.tapor.ca/?id=5}\hypertarget{Who_has_worked_on_creating_it}{}
\subsubsection{Who has worked on creating it}
Susan Brown guided the prototype design from a literary historical perspective, Michael Bauer directed the technical work, Jennifer Berberich and Jonathan Cable did the coding of the first prototype, and Patrick D. Emond coded the second prototype. Jana Smith Elford did significant testing and drafted the documentation.
Work on OrlandoVision has been generously supported by the Sharcnet High Performance Computing Consortium, which provided programming resources, by the Social Sciences and Humanities Research Council of Canada, and by the University of Alberta???s Faculty of Arts.\hypertarget{Where_to_read_about_it}{}
\subsubsection{Where to read about it}
Smith Elford, Jana, Susan Brown, Michael Bauer, Jennifer Berberich and Jonathan Cable. ???Elevating Influence???: Victorian Literary History by Graphs." The Victorian's Institute Journal Digital Annex. 1 (1). 2011.
\href{/index.php/General:Digital_Humanities_2011_Workshop}{ Click here to return to Workshop Homepage}
\end{document}
