Commit 8fc081ab authored by arbennett's avatar arbennett
Browse files

Merge branch 'next' of https://github.com/eclipse/ice into next

parents b5c6a6d4 946f1cea
/documen.synctex.gz
/tmp/
/bin/
/OutputVisualizationTutorial.aux
/OutputVisualizationTutorial.log
/OutputVisualizationTutorial.out
/document.pdf
\documentclass{article}
\usepackage{graphicx}
\usepackage{hyperref}
\usepackage{url}
\setlength{\parskip}{1em}
\begin{document}
\title{Editing Geometries}
This article is designed to outline the basic controls of ICE's Geometry Editor.
\section{Getting Started}
Once ICE is installed on your computer, there are no further dependencies or
preparation required to use the Geometry Editor.
\section{Opening a Geometry Editor}
To open a Geometry Editor in ICE, you have three options:
\begin{center}
\includegraphics[height=5cm]{images/CreateNewMeshOptions.jpg}
\end{center}
Top to bottom, they are:
1) Click the File menu, then New, then Other\ldots and select the Create Item
Wizard in the new dialog and press next. Then select Geometry Editor from the
list and press Finish.
2) Click the New button and select Create Item Wizard in the new dialog and
press next. Then select Geometry Editor from the list and press Finish.
3) Enter the ICE Perspective by clicking the Open Perspective button in the
upper right corder of the screen, selecting ICE from the dialog that pops up,
and clicking OK. Afterwords, click the Create an Item button, select
Geometry Editor, and click OK.
\section{Working with the Geometry Editor}
\section{Camera}
You can change the perspecive of the camera by clicking and dragging inside the
Geometry Editor. You can see this initially by the way the three axes and the
reference plane move as you rotate the camera about the origin. Scrolling the
mouse wheel will zoom the camera in or out.
\section{Primitive Shapes}
\begin{center}
\includegraphics[height=5cm]{images/GeometryAddPrimitive.jpg}
\end{center}
Simple shapes can be added with the Add Primitives dropdown menu in the Shapes
view. Simply select an object from the menu to add it to the scene
\begin{center}
\includegraphics[height=5cm]{images/GeometryAddCube.jpg}
\end{center}
Clicking on the shape's name in the Shapes view will cause that shape to turn
red in the editor.
\begin{center}
\includegraphics[height=5cm]{images/GeometrySelectCube.jpg}
\end{center}
It will also activate the Transformation View in the lower left corder. Editing
the values here will change the displayed shape accordingly.
\begin{center}
\includegraphics[height=5cm]{images/GeometryCubeSize.jpg}
\end{center}
\textbm{Size} - Controls the overall size of the shape. Setting size to X is
equivalent to setting the shape's three scales to X times their current value.
\begin{center}
\includegraphics[height=5cm]{images/GeometryCubeTranslate.jpg}
\end{center}
\textbm{Translate} - Controls the position of the shape. Setting one of the
translations will move the shape that many units along the given axis.
\begin{center}
\includegraphics[height=5cm]{images/GeometryCubeRotate.jpg}
\end{center}
\textbm{Rotation} - Controls the orientation of the shape. Setting one of the
rotations will rotate that shape the given number of degrees about that axis.
\begin{center}
\includegraphics[height=5cm]{images/GeometryCubeScale.jpg}
\end{center}
\textbm{Scale} - Controls the size of the shape in three directions. Setting one
of the scales will stretch or compress the shape in that direction by a factor
of the scale's new setting.
\Section{Complex Shapes}
Multiple primitive shapes can be combined withing a single grouping for easier
editing. First, create a complex shape using the Add Complex button.
\begin{center}
\includegraphics[height=5cm]{images/GeometryAddComplex.jpg}
\end{center}
Currently, only unions are supported. The union will appear in the Shapes view
with an empty spot for a child shape.
\begin{center}
\includegraphics[height=5cm]{images/GeometryUnionAddShape.jpg}
\end{center}
Select <add shape> and add a primitive shape as before to add the shape as a
child of the union. To add additional shapes, select the child shape and add
another as normal.
Selecting the union will select all its child shapes, and changes to the
transformation view will affect the entire complex shape.
You can add a complex shape as a child to a complex shape in the same way as a
primitive shape, allowing for nested unions
\begin{center}
\includegraphics[height=5cm]{images/GeometryStackedUnions.jpg}
\end{center}
\Section{Copying}
Once you have a shape created, you can automatically create copies of that
shape.
\begin{center}
\includegraphics[height=5cm]{images/GeometryStackedUnions.jpg}
\end{center}
\begin{center}
\includegraphics[height=5cm]{images/GeometryDuplicateShape.jpg}
\end{center}
Press the Duplicate Shape button, highlighted above, to create an exact copy of
the highlighted primitive shape. The copy will appear as the child of the same
complex shape as the original, if any, and can be modified independently after
creation.
\begin{center}
\includegraphics[height=5cm]{images/GeometryReplicateShape.jpg}
\end{center}
You can systematically create many copies of a shape with the Replicate Shape
button highlighted above. This will open a new dialog.
\begin{center}
\includegraphics[height=5cm]{images/GeometryReplicateDialog.jpg}
\end{center}
The quantity is the number of desired copies of the shape which should be in the
replication. This includes the orignal (ie setting quantity to 2 will result in
2 shapes, the original and a copy).
The Shift boxes allow you to specify an offset to be placed between each copy.
For example, if you set X to 100 and Y to 50, then each copy will be 100 units
along the X axis and 50 along the Y away from the previous copy.
The original shape and all copies will be placed in a new complex shape, which
will take the original shape's position in the tree.
\section{Deletion}
You may remove a shape and all its children by selecting it in the Shapes view
and clicking the Delete button, highlighted below.
\begin{center}
\includegraphics[height=5cm]{images/GeometryDeleteButton.jpg}
\end{center}
......@@ -31,17 +31,22 @@ 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.
1) Click the File menu, then New, then Other\ldots and select the Create Item
Wizard in the new dialog and press next. Then select Mesh Editor from the list
and press Finish.
2) Click the New Item Button and select Create Item Wizard.
2) Click the New button and select Create Item Wizard in the new dialog and
press next. Then select Mesh Editor from the list and press Finish.
3) Click the Mesh Editor button.
4) In the ICE Perspective, click the Create an Item button, select Mesh Editor,
and click OK.
4) Enter the ICE Perspective by clicking the Open Perspective button in the
upper right corder of the screen, selecting ICE from the dialog that pops up,
and clicking OK. Afterwords, click the Create an Item button, select
Mesh Editor, and click OK.
\section{Working With the Mesh Editor}
......@@ -75,10 +80,10 @@ clicking inside of it.
\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
Scroll Up & W or Up Arrow\\ \hline
Scroll Down & S or Left Arrow\\ \hline
Scroll Left & A or Right Arrow\\ \hline
Scroll Right & D or Down Arrow\\ \hline
Zoom In & Scroll mouse wheel up \\ \hline
Zoom out & Scroll mouse wheel down \\
\hline
......@@ -114,10 +119,11 @@ 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.
Once the fourth vertex has been specified, the polygon will be displayed
in full. Clicking one more time will change it to purple to show that it has
been completed. At any time before this, you can press the backspace, delete,
or escape buttons to cancel the new polygon, removing it from the editor and
allowing you to start the process over.
\subsection{Editing Elements}
......@@ -134,7 +140,8 @@ 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.
The current selection can be cleared by pressing the backspace, delete, or
escape buttons.
\begin{center}
\includegraphics[width=12cm]{images/MeshEditorSelection}
......@@ -143,8 +150,9 @@ The current selection can be cleared by pressing the Esc button.
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.
White circles are displayed to show each vertex's new location. Pressing
backspace, delete, or escape during the drag will deselect the vertices and
cancel the movement.
\begin{figure}
\begin{center}
......@@ -164,7 +172,7 @@ top vertex is moved left by an equal amount.}
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 \\
Clear selection/Cancel move & Backspace, Delete, or Escape \\
\hline
\end{tabular}
\end{center}
......
......@@ -71,7 +71,7 @@ connection, change this to the hostname of that machine.
\textbf{Path:} Enter the full path to the directory containing the VisIt
executable, not the executable itself. The VisIt executable is named
\testem{visit} on Linux and Mac OS X. On Windows, \textem{VisIt.exe} is the
\textit{visit} on Linux and Mac OS X. On Windows, \textit{VisIt.exe} is the
appropriate file.
Once finished editing the cells in the new row, press Apply, then OK. ICE will
......@@ -380,6 +380,17 @@ series will be graphed at once with deselected series removed.
Finally, the Remove all series option in the context menu will completely clear
the graph.
\subsubsection{Viewing the Data}
At the bottom of the editor is a series of tabs.
\begin{center}
\includegraphics[width=12cm]{images/CSVTabs}
\end{center}
The Plot tab contains the graph described thus far. The Data tab will display
the raw numerical source data in a text editor.
\section{MOOSE Embedded Visualization}
MOOSE Workflow Items allow for easy visualization of their associated files,
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment