Added LaTex documentation

Added LaTex tutorials for some of the visualization features. 
Signed-off-by: Robert Smith <SmithRW@ornl.gov>

docs/visualization/.gitignore

+/documen.synctex.gz

docs/visualization/.project

+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>tutorials</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>net.sourceforge.texlipse.builder.TexlipseBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>net.sourceforge.texlipse.builder.TexlipseNature</nature>
+	</natures>
+</projectDescription>

docs/visualization/.texlipse

+#TeXlipse project settings
+#Thu Feb 04 13:36:18 EST 2016
+markTmpDer=true
+builderNum=2
+outputDir=
+makeIndSty=
+bibrefDir=
+outputFormat=pdf
+tempDir=tmp
+mainTexFile=OutputVisualizationTutorial.tex
+outputFile=document.pdf
+langSpell=en
+markDer=true
+srcDir=

docs/visualization/MeshEditorTutorial.tex

+%%This is a very basic article template.
+%%There is just one section and two subsections.
+\documentclass{article}
+\usepackage{graphicx}
+
+\setlength{\parskip}{1em}
+
+\begin{document}
+
+
+\section{Editing Meshes}
+
+This document is designed to outline the basic user controls of the Mesh Editor plugin in ICE.
+
+\subsection{Getting Started}
+
+Once ICE is installed on your system, there are no addional dependencies or
+preparation required to use the Mesh Editor.
+
+\subsubsection{Opening a Mesh Editor}
+
+To open a Mesh Editor in ICE, you have four options:
+ 
+
+\begin{center}
+\includegraphics[height=5cm]{images/CreateNewMeshOptions.jpg}
+\end{center}
+
+The UI elements which can be used to open a Mesh Editor are
+highlighted. Instruction for how to use each one, from top to bottom, left to
+right, are given below.
+
+
+1) Click the File menu, then New, then Create Item Wizard.
+
+
+2) Click the New Item Button and select Create Item Wizard.
+
+
+3) Click the Mesh Editor button.
+
+
+4) In the ICE Perspective, click the Create an Item button, select Mesh Editor,
+and click OK.
+
+\section{Working With the Mesh Editor}
+
+The mesh editor will initially open to an empty grid, as shown below. There is
+currently no way to import pre-existing meshes from another source directly
+into the Mesh Editor.
+
+\begin{center}
+\includegraphics[width=12cm]{images/EmptyMeshEditor.jpg}
+\end{center}
+
+\subsection{Navigation}
+
+Meshes are constructed on the background grid. Gridlines are spaced one unit
+apart from each other. The origin is the initial center of the screen, with the
+x axis in red and the y axis in green coming out from it in the positive x and y
+directions, respectively. 
+
+\subsubsection{Camera Controls}
+
+The camera is controlled with keyboard and mouse commands. The W, A, S, and D
+keys are used to move the camera around the editor's area, while scrolling the
+mouse wheel is used to zoom the camera in and out. 
+
+If the controls are not working, ensure that the Mesh Editor has focus by
+clicking inside of it.
+
+\begin{center}
+    \begin{tabular}{| l | l |}
+    \hline
+    \multicolumn{2}{|c|}{\textbf{Camera Controls}} \\
+  	\hline
+    \textbf{Action} & \textbf{Key(s)} \\ \hline
+    Scroll Up & W \\ \hline
+    Scroll Down & S \\ \hline
+    Scroll Left & A \\ \hline
+    Scroll Right & D \\ \hline
+    Zoom In & Scroll mouse wheel up \\ \hline
+    Zoom out & Scroll mouse wheel down \\
+    \hline
+    \end{tabular}
+\end{center}
+
+\subsection{Adding Elements}
+
+2D meshes are constructed in the editor by specifying one quadtrilatiral at a
+time. To add a new polygon, the Mesh Editor must be in Add Elements Mode. This
+is the editor's default setting, and it can later be reset by clicking the Mode
+button in the top left corner. 
+
+\begin{center}
+\includegraphics[width=12cm]{images/MeshEditorAddMode}
+\end{center}
+
+\subsubsection{Placing Vertices}
+
+In Add Elements Mode, clicking anywhere on the grid will place a new vertex at
+that location. These new, temporary vertices and the edges between them will be
+colored in green, to show that the polygon in still under construction.
+
+Alternatively, you may select a vertex not already in the new polygon. This
+allows you to reuse vertices and/or edges already present in the mesh to form
+part of your new polygon.
+
+\begin{figure}
+\begin{center}
+\includegraphics[width=12cm]{images/MeshEditorReuseEdge}
+\caption{One of the edges from the trapezoid is being combined with a new edge
+in the creation of the current polygon.}
+\end{center}
+\end{figure}
+
+Once the fourth vertex has been specified, the polygon will change to purple to
+show that it has been completed. At any time before this, you can press the Esc
+button to cancel the new polygon, removing it from the editor and allowing you
+to start the process over. 
+
+\subsection{Editing Elements}
+
+To edit an already present element of the mesh, you must switch to Edit Elements
+Mode. The Mode button in the upper left corner alows you to switch between
+modes, as shown below.
+
+\begin{center}
+\includegraphics[width=12cm]{images/MeshEditorEditMode}
+\end{center}
+
+A vertex can be selected by either clicking it in the Mesh Editor, or by
+selecting it from the tree in the ICE Perspective's Mesh Elements View. Holding
+down shift while clicking will allow multiple vertices to be selected at once,
+while holding down control during a click will toggle a vertex's state either
+into or out of the selection. Selected elements are displayed in blue.
+The current selection can be cleared by pressing the Esc button.
+
+\begin{center}
+\includegraphics[width=12cm]{images/MeshEditorSelection}
+\end{center}
+
+Click on a selected vertex and drag it to change its location. The clicked
+vertex will stay beneath your mouse cursor, while all other selected vertices
+will be moved as well, keeping their relative position to the dragged vertex.
+White circles are displayed to show each vertex's new location. Pressing Escape
+during the drag will deselect the vertices and cancel the movement.
+
+\begin{figure}
+\begin{center}
+\includegraphics[width=12cm]{images/MeshEditorDragVertex}
+\caption{Two vertices are selected. When the bottom vertex is moved left, the
+top vertex is moved left by an equal amount.}
+\end{center}
+\end{figure}
+
+\begin{center}
+    \begin{tabular}{| l | l |}
+    \hline
+    \multicolumn{2}{|c|}{\textbf{Edit Mode Controls}} \\
+  	\hline
+    \textbf{Action} & \textbf{Key(s)} \\ \hline
+    Select vertex & Left click \\ \hline
+    Add to selection & Shift + left click \\ \hline
+    Toggle (Add/Remove) Selection & Ctrl + left click \\ \hline
+    Move selected vertices & Left click on vertex and drag mouse \\ \hline
+    Clear selection/Cancel move & Escape \\ 
+    \hline
+    \end{tabular}
+\end{center}
+
+Alternatively, you can edit a vertex more precisely by setting its exact
+coordinates. First, select it in the Mesh Elements view, then open the
+Properties View. The vertex's x and y coordinates will be displayed in editable
+text boxes.
+
+\begin{center}
+\includegraphics[width=12cm]{images/VertexPropertiesView}
+\end{center}
+
+Selecting a polygon in the same way, then opening the tab for one of its edges
+in the Properties View, will display the edge's boundary conditions for that
+polygon. These are editable, just like the vertices are.
+
+\begin{center}
+\includegraphics[width=12cm]{images/EdgeBoundaryConditions}
+\end{center}
+
+\subsection{Deleting Elements}
+
+Polygons in the mesh can be deleted. All four vertices for the polygon must be
+selected, then press the Delete button on the toolbar. Vertices and edges which
+are still part of other, undeleted, polygons will remain, but all others will be
+removed from the editor.
+
+\subsection{Additional Controls}
+
+The Toggle Axis button on the toolbar allows will add/remove the axes from the
+editor. 
+
+\begin{center}
+\includegraphics[width=12cm]{images/MeshEditorToggleAxis}
+\end{center}
+
+\end{document}

docs/visualization/OutputVisualizationTutorial.tex

+\documentclass{article}
+\usepackage{graphicx}
+\usepackage{hyperref}
+\usepackage{url}
+
+\setlength{\parskip}{1em}
+
+\begin{document}
+
+
+\section{Visualizing Output}
+
+Currently, ICE features two plugins for visualizing and plotting simulation
+output data:
+
+\textbf{VisIt Tools} - An interactive 3D visualization tool for rendering
+meshes, scalar plots, contour plots, and more. 
+
+\textbf{CSV Plotting Tools} - A customizable, 2D data plotting utility for data 
+from .csv files.
+
+\subsection{Installation and Configuration}
+
+The CSV Plotting Tools require no additional software or preparation before use.
+The VisIt Tools need both an instance of VisIt and a connection between ICE and
+the VisIt session.
+
+\subsubsection{VisIt Installation} 
+
+Before preparing ICE,
+\href{https://wci.llnl.gov/simulation/computer-codes/visit/}{VisIt}, developed
+by Lawrence Livermore National Laboratory, must be downloaded. This must be
+version 2.8.2, and does not need to be on the same machine that ICE is installed
+on, as ICE is capable of launching a VisIt session on a remote machine. Make
+note of the folder where you installed VisIt for use in the next step.
+
+\subsubsection{Configuring the VisIt Connection}
+
+Once VisIt is installed, ICE must connect to a VisIt session in order to provide
+data visualization. There are two different parts of ICE which connect with
+VisIt, both providing slightly different functionalities. These are the Plot
+Editor, which is slightly more user friendly, and the Visualization Perspective,
+which allows for arbtrary Python commands to be sent to the VisIt client. 
+
+\paragraph{Connecting for the Plot Editor}
+
+This process will set up a default connection to VisIt in the ICE Preferences
+page, and so only needs to be performed once. After creating the connection, ICE
+will launch and connect with VisIt each time it is started.
+
+To set the connection, select Window $\rightarrow$ Preferences in ICE's toolbar. Then
+select Visualization $\rightarrow$ VisIt in the tree of the Preferences page. 
+
+\begin{center}
+\includegraphics[width=12cm]{images/VisItPreferencePage_ICE}
+\end{center}
+
+Press the new row button, the button with a "+" symbol in the upper right,
+highlighted in the image above. You can then click on each of the cells of the
+new row to edit them. The default values automatically supplied by ICE should
+be fine for most users. However, two fields may need to be changed:
+
+\textbf{Host:} The default value of "localhost" is for connections to local
+installations of VisIt on your computer. If you want to launch a remote VisIt
+connection, you must change this to the hostname of the machine to connect to.
+
+\textbf{Path:} You need to put the full path to the VisIt folder here. The path
+should end with the folder containing the VisIt executable. For example, if
+VisIt.exe is in a folder called VisIt 2.9.1, the the path should end in
+\textbackslash{}VisIt 2.9.1\textbackslash , not \textbackslash{}VisIt
+2.9.1\textbackslash VisIt.exe.
+
+Once finished, press Apply, then OK. ICE will then open VisIt and connect to it.
+
+\paragraph{Connecting for the Visualization Perspective} 
+
+First, open the Visualization perspective. On the main menu bar at the top of
+the window, click Window $\rightarrow$ Open Perspective $\rightarrow$
+Other\ldots, select Visualization in the fialog that pops up and click OK. Alternatively, you can
+also access the same pop-up dialog by clicking the Open Perspective button in
+the main toolbar in the upper right-hand corver of the ICE workbench. 
+
+\begin{center}
+\includegraphics{images/ICE_OpenPerspective}
+\end{center}
+
+Now click the Launch VisIt button in the menu bar.
+
+\begin{center}
+\includegraphics{images/ICE_VisItLaunchButton}
+\end{center}
+
+This will open a dialog offering you three options for connecting to VisIt.
+
+\begin{center}
+\includegraphics[width=12cm]{images/ICE_VisItLaunchOptions}
+\end{center}
+
+1) Launch VisIt locally - If you installed VisIt on your local machine, use the
+Browse button to direct ICE to your local installation directory. Using this
+method of connecting will launch a new VisIt session. Optionally, you can also
+set a port number (default 9600) and--if you want to share your VisIt session
+with another user--a password.
+
+2) Launch VisIt remotely - If you installed VisIt on a remote machine, specify
+the hostname and full path to the VisIt installation directory. Using this
+method of connecting will launch a new VisIt session. Optionally, you can
+specify a port number (default 9600) and--if you want to share your VisIt
+session with another user--a password. If you need or want to use an external
+gateway or proxy to access the remote VisIt installation, you may specify its
+URL and port number as well.
+
+3) Connect to VisIt - If you would like to connect to session of VisIt already
+running somewhere else, specify the hostname, port number, and password set on
+the VisIt session; you will need to obtain this information from the person who
+initially launched the VisIt session. If you need or want to use an external
+gateway or proxy to access the remote VisIt installation, you may specify its
+URL and port number as well.
+
+If you've forgotton where VisIt is installed on Windows, find a shortcut to
+VisIt eithero n your desktop or in the start menu. Right-click the shortcut and
+open its Properties. The path to the VisIt executable's directoy will be shown
+next to Target.
+
+Regardless of which method you choose to connect to VisIt, enter a Connection
+name at the bottom of the pop-up dialog. 
+
+If you are connecting to an existing session, specify a Window ID between 1 and
+16. Which Window ID you use depends on how you would like to connect to VisIt.
+If multiple users connect using the same Window ID, they will all see and be
+able to interact with the same VisIt view. However, if you would like multiple
+users to each have their own unique session each with its own controls, assign a
+unique Window ID to each user. The VisIt installation can support up to 16
+unique window IDs at a time.
+
+Once you are done, click the Finish button at the bottom, and ICE should begin
+connecting to VisIt.
+
+\subsubsection{Using VisIt}
+
+\paragraph{Plot Editor}
+
+To open a plot editor, first the file must be placed in the Project Explorer.
+This view lists files imported into ICE. To access the Project Explorer, use the
+the main menu bar at the top of the window and navigate to Window $/rightarrow$
+Show View $/rightarrow$ Project Explorer. 
+
+By default, the Project Explorer should automatically import the
+ICEFiles/default and ICEFiles/itemDB folders. If it does not, or it you want to
+import a different folder into ICE, right click in the Project Explorer and
+select Import... from the context menu. Then select General -> File System from
+the tree and press the Next button. You can then select directories and/or files
+to import into the Project Explorer.
+
+\end{document}