From CWRC

LaTeX code for Mandala Browser

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:Mandala-1.jpg}{
\includegraphics{/AnnokiUploadAuth.php/thumb/9/94/Mandala-1.jpg/450px-Mandala-1.jpg}}
\begin{tabular}

\subsection{Contents}
\begin{itemize}
	\item \hyperlink{Introduction}{1Introduction}
	\item \hyperlink{Ingredients}{2Ingredients}
	\item \hyperlink{Steps}{3Steps}
\begin{itemize}
	\item \hyperlink{Example}{3.1Example}
	\item \hyperlink{Screencast}{3.2Screencast}
\end{itemize}
	\item \hyperlink{Suggested_Activities}{4Suggested Activities}
	\item \hyperlink{Discussion}{5Discussion}
\begin{itemize}
	\item \hyperlink{Description}{5.1Description}
	\item \hyperlink{Advanced_Tips}{5.2Advanced Tips}
	\item \hyperlink{Who_has_worked_on_creating_it}{5.3Who has worked on creating it}
	\item \hyperlink{Where_to_read_about_it}{5.4Where to read about it}
	\item \hyperlink{Availability}{5.5Availability}
\end{itemize}
\end{itemize}
\end{tabular}\hypertarget{Introduction}{}

\subsection{Introduction}

It allows you to do fairly sophisticated visual browsing of any XML document or collection of documents. Parts of documents or entire documents appear as dots around the periphery. You create colourful magnets and assign values to them. These magnets draw the dots into the centre space. There is a text viewer off to the right, so you can see what is inside any given dot. You can also export what you find for later study.\hypertarget{Ingredients}{}

\subsection{Ingredients}
\begin{itemize}
	\item  An XML document, or a collection of XML documents.
	\item  A copy of the Mandala browser.
\end{itemize}\hypertarget{Steps}{}

\subsection{Steps}

\textbf{To set up Mandala:}
\begin{enumerate}
	\item go to \href{http://tapor-dev.mcmaster.ca/~humviz/mandala/dev/standalone/}{http://tapor-dev.mcmaster.ca/\textasciitildehumviz/mandala/dev/standalone/}
	\item click on the highest version number
	\item a ZIP file should download to your computer
	\item unzip the file to create the mandala folder
	\item doubleclick the .jar file to run the mandala browser
\end{enumerate}

\textbf{To use Mandala:}
\begin{enumerate}
	\item Figure out what tag in your xml file will be used as a dot in the mandala. 
	\item Copy your xml file into the mandala directory. 
	\item Copy the file name.
	\item Doubleclick the jar file to start the mandala.
	\item Paste the file name into the ???Open??? field top left.
	\item Type your dot tag into the ???Dots Represent??? field top left.
	\item Push the ???Load??? button. Dots should appear around the periphery. Large files may take a few minutes to load.
	\item An empty magnet is preloaded. Set up the criteria for it and watch the dots gather to it. For a free-text search on all XML fields, type the search text in the box and hit return. To narrow the search, first select an XML field from the picklist above the search box. You can also choose to see a type-ahead response while typing by clicking on the checkbox called ???Search as you type.???
	\item Create the next magnet, and fill in its criteria.
	\item Iterate as necessary.
	\item Read items in the panel on the right by clicking them or lassoing them in the main circle. 
	\item If you click on a given magnet, you may be unable to see information that you want. If this is the case, then click on the Display palette and on the "Fields always displayed" dropdown and select more boxes to display. If you return to the magnet, you will now be able to see the extra information in the reading pane on the right. 
	\item If you would like to see the finer details of your Mandala visualization, you may zoom in / out and adjust the screen with the Display palette. Click on the Display palette and you may zoom in / out with the ???+??? and ???-??? signs. Another way to zoom is with a mousewheel / two-finger scroll. You may also navigate the screen with the ???, ???, ???, ??? arrows. If you???d like more control, you can click on the hand tool to drag the screen around. 
	\item We may also export our Mandala visualization by clicking Export on the bottom-right side of the window. If you choose Text, you can save a copy of the text displayed in the reader panel. If you choose Screenshot, you can save a visual copy of the Mandala visualization.
\end{enumerate}\hypertarget{Example}{}

\subsubsection{Example}

You might be interested in occurrences of words representing emotions in the works of George Eliot.  To investigate this relationship, you could load the George Eliot collection, and then create magnets representing "happy," "sad," "angry," and so on.  You can examine the passages in which the various terms are mentioned, and find which works they they appear in.\hypertarget{Screencast}{}

\subsubsection{Screencast}

A screencast explaining how to use Mandala is here: \href{http://www.ualberta.ca/~sruecker/mandala_demo.mov}{http://www.ualberta.ca/\textasciitildesruecker/mandala\_demo.mov}\hypertarget{Suggested_Activities}{}

\subsection{Suggested Activities}
\begin{enumerate}
	\item Try to find all passages in Romeo and Juliet in which Romeo and Juliet mention the word "hate."
	\item Try to find the text of all passages in Jane Austen's works in which the words "think" and "feel" are both mentioned.  Click on one of the dots and then find out in which works they are mentioned by using the "Fields always displayed" function.
	\item Try zooming in and out and resetting the selection state.
\end{enumerate}\hypertarget{Discussion}{}

\subsection{Discussion}\hypertarget{Description}{}

\subsubsection{Description}

A document describing Mandala is available here: \href{http://entry.tapor.ca/?id=23}{http://entry.tapor.ca/?id=23}\hypertarget{Advanced_Tips}{}

\subsubsection{Advanced Tips}
\begin{enumerate}
	\item You can use regular expressions to set up magnet values, allowing you to have several tags, for instance, attracted to a single magnet.
	\item You can also search on tag attributes.
\end{enumerate}\hypertarget{Who_has_worked_on_creating_it}{}

\subsubsection{Who has worked on creating it}

Mandala was developed with funding from SSHRC by Stefan Sinclair, Anthony Sapp, Matt Patey (McMaster University), Stan Ruecker, Oksana Cheypesh, Constanza Pacher, Rhiannon Gainor (University of Alberta), Sandra Gabriele (York University)\hypertarget{Where_to_read_about_it}{}

\subsubsection{Where to read about it}

Brown, Susan, Patricia Clements, Isobel Grundy, Stan Ruecker, Jeffery Antoniuk, Sharon Balazs, St??fan Sinclair and Matt Patey. ???Thinking Beyond the Text: Using the Mandala Browser to Explore Orlando.??? Paper presented at the Society for Digital Humanities/ Soci??t?? pour l?????tude des m??dias interactifs annual conference at the 2008 Congress of the Social Sciences and Humanities, University of British Columbia. June 2-3, 2008.

Gainor, Rhiannon, St??fan Sinclair, Stan Ruecker, Matt Patey, and Sandra Gabriele. [Forthcoming]. ???A Mandala Browser User Study: Visualizing XML Versions of Shakespeare???s Plays.??? Visible Language 43(1). 2009.

Ruecker, Stan. ???Experimental Interfaces Involving Visual Grouping During Browsing.??? Partnership: the Canadian Journal of Library and Information Practice and Research. 1(1). 2006.\hypertarget{Availability}{}

\subsubsection{Availability}

Download from www.humviz.org.See a demo video at www.ualberta.ca/\textasciitildesruecker/mandala\_demo.mov.


\\\href{/index.php/General:Digital_Humanities_2011_Workshop}{ Click here to return to Workshop Homepage}

\end{document}