Commit 1411511e authored by Chris Harris's avatar Chris Harris
Browse files

Merge remote-tracking branch 'origin/master' into module-proxies-optional

Conflicts:
	Wrapping/Python/paraview/servermanager.py
	Wrapping/Python/paraview/simple.py
	Wrapping/Python/paraview/vtk/__init__.py

Change-Id: Iead09f35d2dfd3c390625598297a962908e5c821
parents 90963207 487423db
......@@ -19,6 +19,9 @@
</div>
</div>
<div id="page">
<h1>
<a href="#">ParaView/Users Guide/Introduction</a>
</h1>
<div id="content">
<div class="post">
<h2 class="title">
......@@ -55,40 +58,40 @@
<p/>
<p align="center">
<p>
<img src="13294915041604800512.png" align="center"/>
<img src="13523631630767290368.png" align="center"/>
</p>
<strong>Figure 1.1</strong> ParaView GUI Overview</p>
<p> One very important thing to keep in mind when using ParaView is that the GUI is very modal. At any given time you will have one "active" module within the visualization pipeline, one "active" view, and one "active" selection. For example, when you click on the name of a reader or source within the Pipeline Browser, it becomes the active module and the properties of that filter are displayed in the Object Inspector. Likewise when you click within a different view, that view becomes the active view and the visibility "eye" icons in the Pipeline Browser are changed to show what filters are displayed within this View. These concepts will be described in detail in later chapters ( Multiple Views, Pipeline Basics, Selection). For now you should be aware that the information displayed in the GUI always pertains to these active entities. </p>
<p> Modern graphical applications allow users to treat the GUI as a document where informations can be queried and used by Copy/Paste from one place to another and that's precisely where we are heading to with ParaView. Typically user can query any Tree/Table/List view widget in the UI by activating that component and by hitting the Ctrl+F or Command+F on Mac keyboard shortcut, while the view widget is in focus. This will enable a dynamic widget showing up which get illustrated in the following screenshot. This search-widget will be closed when the view widget lost focus, or the Esc button is pressed, or the Close button on the search-widget is clicked. </p>
<p align="center">
<p>
<img src="13294915041625819136.png" align="center"/>
<img src="13523631630787788800.png" align="center"/>
</p>
<strong>Figure 1.2</strong> Searching in lists </p>
<p align="center">
<p>
<img src="13294915041636429824.png" align="center"/>
<img src="13523631630797901824.png" align="center"/>
</p>
<strong>Figure 1.3</strong> Searching in trees </p>
<p>In order to retrieve data from spreadsheet or complex UI, you will need to double click on the area that you are interested in and select the portion of text that you want to select to Copy. The set of screenshots below illustrate different selection use case across the UI components. </p>
<p align="center">
<p>
<img src="13294915041648240640.png" align="center"/>
<img src="13523631630809409536.png" align="center"/>
</p>
<strong>Figure 1.4</strong> Copying time values from Information Tab</p>
<p align="center">
<p>
<img src="13294915041659340800.png" align="center"/>
<img src="13523631630819850240.png" align="center"/>
</p>
<strong>Figure 1.5</strong> Copying values from trees on the Information Tab</p>
<p align="center">
<p>
<img src="13294915041670649856.png" align="center"/>
<img src="13523631630830450688.png" align="center"/>
</p>
<strong>Figure 1.6</strong> Copying values from Spreadsheet View</p>
<p align="center">
<p>
<img src="13294915041681289216.png" align="center"/>
<img src="13523631630840809472.png" align="center"/>
</p>
<strong>Figure 1.7</strong> Copying values from Information Tab</p>
</div>
......@@ -115,7 +118,7 @@
<p>Figure 1.8 demonstrates a three-element visualization pipeline, where the output of each module in the the pipeline is displayed in its own view. A reader takes in a vector field, defined on a curvilinear grid, which comes from a simulation study of a wind turbine. Next a slice filter produces slices of the field on five equally spaced planes along the X-axis. Finally, a warp filter warps those planes along the direction of the vector field, which primarily moves the planes downwind but also shows some complexity at the location of the wind turbine. </p>
<p align="center">
<p>
<img src="13294915041705930752.png" align="center"/>
<img src="13523631630864920576.png" align="center"/>
</p>
<strong>Figure 1.8</strong> A three-element visualization pipeline</p>
<p>There are more than one hundred filters available to choose from, all of which manipulate the data in different ways. The full list of filters is available in the Appendix and within the application under the Help menu. Note that many of the filters in the menu will be grayed out and not selectable at any given time. That is because any given filter may only operate on particular types of data. For example, the Extract Subset filter will only operate on structured data sets so it is only enabled when the module you are building on top of produces image data, rectilinear grid data, or structured grid data. (These input restrictions are also listed in the Appendix and help menu). In this situation you can often find a similar filter which does accept your data, or apply a filter which transforms your data into the required format. In ParaView 3.10, you can ask ParaView to try to do the conversion for you automatically, by clicking "Auto convert properties" in the application settings. The mechanics of applying filters are described fully in the Manipulating Data chapter. </p>
......
......@@ -19,15 +19,18 @@
</div>
</div>
<div id="page">
<h1>
<a href="#">ParaView/Users Guide/Python Calculator</a>
</h1>
<div id="content">
<div class="post">
<h2 class="title">
<a href="#">Using Python Calculator</a>
<a href="#">Introduction </a>
</h2>
<div class="entry">
<p align="center">
<p>
<img src="13294943141183700992.png" align="center"/>
<img src="13523635837402370048.png" align="center"/>
</p>
<strong>Figure 6.3</strong>
</p>
......
......@@ -8,28 +8,35 @@
</head>
<body>
<div id="wrapper">
<div id="header-wrapper">
<div id="header">
<div id="logo">
<h1><a href="http://www.paraview.org">ParaView </a></h1>
<p>User's Manual (Abridged)</p>
</div>
<div id="header-wrapper">
<div id="header">
<div id="logo">
<h1>
<a href="http://www.paraview.org">ParaView </a>
</h1>
<p>User's Manual (Abridged)</p>
</div>
</div>
</div>
</div>
<!-- end #header -->
<div id="page">
<h1>
<a href="#">ParaView/Users Guide/Query Data</a>
</h1>
<div id="content">
<div class="post">
<h2 class="title">
<a href="#">Find Data Dialog</a>
</h2>
<p>As previously described, Selection is a mechanism in ParaView for sub-setting and focusing on a particular elements in the dataset. Different views provides different mechanisms for selecting elements, for example, you can select visible cells or points using the 3D View. Another mechanism for creating selections is by specifying a selection criteria. For example, suppose you want to select all cells where the pressure value is between a certain threshold. In such cases, you can use the Find Data dialog. The Find Data dialog performs a dual role: not only does it enable specifying the selection criteria but also show details of the selected elements in a spreadsheet. This makes it easier to inspect the selected elements. </p>
<p align="center">
<p>
<img src="13281364655026108416.png" align="center"/>
</p>
<strong>Figure 6.13</strong> Find Data options</p>
<div class="entry">
<p> As previously described, Selection is a mechanism in ParaView for sub-setting and focusing on a particular elements in the dataset. Different views provides different mechanisms for selecting elements, for example, you can select visible cells or points using the 3D View. Another mechanism for creating selections is by specifying a selection criteria. For example, suppose you want to select all cells where the pressure value is between a certain threshold. In such cases, you can use the Find Data dialog. The Find Data dialog performs a dual role: not only does it enable specifying the selection criteria but also show details of the selected elements in a spreadsheet. This makes it easier to inspect the selected elements. </p>
<p>To open the Find Data dialog, go to <strong>Edit</strong>|Find Data.</p>
<p></p>
<p align="center">
<p>
<img src="13523630291398539264.png" align="center"/>
</p>
<strong>Figure 6.13</strong> Query based on field "Global ID" / Query based on Python expression (Generated by the query on the left)</p>
</div>
</div>
<div class="post">
<h2 class="title">
......@@ -78,7 +85,7 @@
<p>First, decide what type of elements you are interested in selecting, that is cells or points and from what data source. This can be done using the following combo boxes. Note that as you change these, any previous selections/queries will be cleared. </p>
<p align="center">
<p>
<img src="13281364655056769024.png" align="center"/>
<img src="13523630291431249920.png" align="center"/>
</p>
<strong>Figure 6.14</strong> Find Data options</p>
<p>Next, you must define the query string. The syntax for specifying the query string is similar to the expressions used in the Python Calculator. In fact, ParaView indeed uses Python and numpy under the covers to parse the queries. </p>
......@@ -127,6 +134,7 @@
<p> Queries can be combined using operators '&amp;' and '|'. </p>
</li>
</ul>
<p>The combobox allow the user to create queries in a more intuitive but in a more limited way. Although, this could be useful specially when you want to learn how to write more complex query. To do so, you will need to execute your selection by using a field directly from the combobox instead of the "Query" key word. Any selection execution will internally generate a Query string which can be seen by switching back to the "Query" combobox value. Such query can then be used as part of a more complex one if needed. </p>
</div>
</div>
<div class="post">
......@@ -137,7 +145,7 @@
<p>Once a query is executed, the selected elements will be highlighted in all views where the selected data is visible. If the active view is a 3D view, you can choose whether the show labels for selected elements as well as the color to use for showing the selected elements using the controls on the Find Data dialog itself. </p>
<p align="center">
<p>
<img src="13281364655165650944.png" align="center"/>
<img src="13523630291536910336.png" align="center"/>
</p>
<strong>Figure 6.15</strong>
</p>
......@@ -151,7 +159,7 @@
<p>The results of a query are temporary. They get replaced when a new query is executed or when the user creates a selection using any of the selection mechanisms. Sometimes, however, users may want to further analyze the selected elements such as apply more filters to only the selected elements, or plot the change in attributes on the selected elements over time. In that case, you should extract the selection. That creates a new filter that is setup to run the query on its input and produce a dataset matching the selection criteria. Both Extract Selection and Plot Selection Over Time are filters available through the Filters menu. The Find Data dialog provides shortcut buttons to quickly create those filters and set then up with the selection criteria chosen. </p>
<p align="center">
<p>
<img src="13281364655199721472.png" align="center"/>
<img src="13523630291551479808.png" align="center"/>
</p>
<strong>Figure 6.16</strong>
</p>
......
......@@ -19,6 +19,9 @@
</div>
</div>
<div id="page">
<h1>
<a href="#">ParaView/Users Guide/Plugins</a>
</h1>
<div id="content">
<div class="post">
<h2 class="title">
......@@ -64,10 +67,21 @@
<p>Generally, users don't have to worry whether a plugin is a server-side or client-side plugin. Simply load the plugin on the server as well as the client. ParaView will include relevant components from plugin on each of the processes.</p>
</div>
</div>
<div id="about">
<p>
This is an abridged version of the ParaView User's Manual. For a
regularly updated version of the manual, refer to the
<a href="http://paraview.org/Wiki/ParaView/Users_Guide/Table_Of_Contents">
ParaView Wiki (Manual)</a>
</p>
</div>
</div>
<div style="clear: both;"/>
</div>
<div id="page">
<h1>
<a href="#">ParaView/Users Guide/Included Plugins</a>
</h1>
<div id="content">
<div class="post">
<h2 class="title">
......@@ -139,12 +153,39 @@
<li>
<p> VisTrails </p>
</li>
</ul> The VisTrails plugin for ParaView incorporates the provenance management capabilities of VisTrails into ParaView. All of the actions a user performs while building and modifying a pipeline in ParaView are captured by the plugin. This allows navigation of all of the pipeline versions that have previously been explored. For more information about this plugin see [0]</div>
</ul> The VisTrails plugin for ParaView incorporates the provenance management capabilities of VisTrails into ParaView. All of the actions a user performs while building and modifying a pipeline in ParaView are captured by the plugin. This allows navigation of all of the pipeline versions that have previously been explored. For more information about this plugin see [0]<ul>
<li>
<p> WebGL Exporter </p>
</li>
</ul> The WebGL exporter plugin brings the ParaViewWeb WebGL code to ParaView to allow a 3D scene to be exported into a standalone HTML page. <ul>
<li>
<p> NonOrthogonalSource </p>
</li>
</ul> This plugin illustrate how to add FieldData to your dataset to customize the CubeAxis that should be presented along with your data. Typically this plugin allow a creation of a cube that can be sheared by the user by changing some parameters. By doing so, the CubeAxes can follow the generated shape by creating axis along non-orthogonal axis. Moreover, the cube axis can be replaced altogether by a single 3D crossed axis. That plugin can also be used just to provide a customized cube axes inside you 3D scene without changing any of your original reader of filter with those extra-annotation. <ul>
<li>
<p> QuadView </p>
</li>
</ul> This plugin add a new view into ParaView that allow the user to interactively move a 3D point that will be used to cut the 3D data along 3 planes. Each cut result will be presented inside a 2D view next to each other. More informations can be found here. <ul>
<li>
<p>UncertaintyRenderingPlugin</p>
</li>
</ul> Adds a Uncertainty Surface representation which is able to display both data values and data uncertainties on a surface.</div>
</div>
<div id="about">
<p>
This is an abridged version of the ParaView User's Manual. For a
regularly updated version of the manual, refer to the
<a href="http://paraview.org/Wiki/ParaView/Users_Guide/Table_Of_Contents">
ParaView Wiki (Manual)</a>
</p>
</div>
</div>
<div style="clear: both;"/>
</div>
<div id="page">
<h1>
<a href="#">ParaView/Users Guide/Loading Plugins</a>
</h1>
<div id="content">
<div class="post">
<h2 class="title">
......@@ -160,12 +201,12 @@
</ul>
<p/> Plugins can be loaded into ParaView using the <strong>Plugin Manager</strong> accessible from <strong>Tools | Manage Plugins/Extensions</strong> menu. The Plugin Manager has two sections for loading local plugins and remote plugins (enabled only when connected to a server). To load a plugin on the local as well as remote side, simply browse to the plugin shared library. If the loading is successful, the plugin will appear in the list of loaded plugins. The Plugin manager also lists the paths it searched to load plugins automatically. The Plugin Manager remembers all loaded plugins, so next time to load the plugin, simply locate it in the list and click "Load Selected" button. You can set up ParaView to automatically load the plugin at startup (in case of client-side plugins) or on connecting to the server (in case of server-side plugins) by checking the "Auto Load" checkbox on a loaded plugin. <p align="center">
<p>
<img src="13294937122604908544.png" align="center"/>
<img src="13523633405335750656.png" align="center"/>
</p>
<strong>Figure 16.1:</strong> Plugin Manager when not connected to a remote server, showing loaded plugins on the local site.</p>
<p align="center">
<p>
<img src="13294937122615717888.png" align="center"/>
<img src="13523633405346551808.png" align="center"/>
</p>
<strong>Figure 16.2:</strong> Plugin Manager when connected to a server showing loaded plugins on the local as well as remote sites.</p>
<p/>
......
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