User:Tohline/vtk/XYPlotTutorial - Revision history

Tohline: /* Making a Movie */ Replace animated gif with best one (yet)

2015-09-12T20:10:07Z

Making a Movie: Replace animated gif with best one (yet)

← Older revision		Revision as of 20:10, 12 September 2015
Line 227:		Line 227:

	<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->		<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->
	[[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]]		<!-- [[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]] -->
	[[Image:~~pivotingBox02~~.gif\|~~150px~~\|Test Animated gif]]		[[Image:pivotingBox03.gif\|250px\|Test Animated gif]]

	=Related Discussions=		=Related Discussions=
	* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]		* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]

Tohline: /* Making a Movie */ Replace animated gif with "pivotingBox02.gif"

2015-09-12T20:04:05Z

Making a Movie: Replace animated gif with "pivotingBox02.gif"

← Older revision		Revision as of 20:04, 12 September 2015
Line 228:		Line 228:
	<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->		<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->
	[[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]]		[[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]]
	[[Image:~~CubePivoting02~~.gif\|~~400px~~\|Test Animated gif]]		[[Image:pivotingBox02.gif\|150px\|Test Animated gif]]

	=Related Discussions=		=Related Discussions=
	* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]		* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]

Tohline: /* Making a Movie */ Insert crude animated gif of pivoting cube

2015-09-12T17:27:44Z

Making a Movie: Insert crude animated gif of pivoting cube

← Older revision		Revision as of 17:27, 12 September 2015
Line 228:		Line 228:
	<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->		<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->
	[[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]]		[[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]]
			[[Image:CubePivoting02.gif\|400px\|Test Animated gif]]

	=Related Discussions=		=Related Discussions=
	* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]		* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]

Tohline: Insert new subsection explaining one crude way to assemble an animated gif from VisTrails images

2015-09-12T02:54:42Z

Insert new subsection explaining one crude way to assemble an animated gif from VisTrails images

← Older revision		Revision as of 02:54, 12 September 2015
Line 211:		Line 211:
	</tr>		</tr>
	</table>		</table>

			=Making a Movie=

			Here is a set of steps that can be followed to construct an animated gif (movie) from a set of images that have been constructed using VisTrails.
			* Use the "Explore" feature of VisTrails to sample a parameter range and thereby generate a sequences of spreadsheet images.
			* After viewing the spreadsheet results, use the spreadsheet's "Export/Separately" menu option to dump the image sequence into a new (otherwise empty) file folder. By default, VisTrails will name the files: a1.png, a2.png, a3.png, etc.
			* Via the Mac's terminal window, change directories into the folder that contains the image sequence. Type the following command:
			<pre>convert -set delay 3 -colorspace GRAY -colors 16 -dispose 1 -loop 0 -scale 50% *.png Output.gif</pre>
			* Related information:
			** I initially extracted this recommended "convert" instruction from [http://pages.uoregon.edu/noeckel/MakeMovie.html Jens Nöckel's web site].
			** My Mac contains a manual on this "convert" instruction (man convert); it points out that, "The <b>convert</b> program is a member of the ImageMagick(1) suite of tools."
			** The Mac's "convert" manual also refers to a [http://www.imagemagick.org/script/convert.php convert website].

			* Finally, simply upload the "Output.gif" file to the VisTrails wiki site, then insert it into the desired wiki page just as you would insert a single image.

			<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->
			[[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]]

	=Related Discussions=		=Related Discussions=
	* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]		* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]

Tohline: /* Binary Star System */ Inserted link to published visualization article

2015-09-11T21:49:19Z

Binary Star System: Inserted link to published visualization article

← Older revision		Revision as of 21:49, 11 September 2015
Line 201:		Line 201:

	=Binary Star System=		=Binary Star System=
	Within a couple of hours after I finished developing the above tutorial lesson, I successfully imported data from one of my group's binary star simulations and used the 2D XYPlot tools to display three separate density profiles cut through the volume occupied by the binary system. The following figure displays a VisTrails spreadsheet screenshot of these profiles, plotted adjacent to the "live" display of the star system's partially transparent, 3D iso-density contour.		Within a couple of hours after I finished developing the above tutorial lesson, I successfully imported data from one of my group's binary star simulations (see a [[User:Tohline/IVAJ/Level1#Interpretation_of_Results\|related discussion of this simulation]]) and used the 2D XYPlot tools to display three separate density profiles cut through the volume occupied by the binary system. The following figure displays a VisTrails spreadsheet screenshot of these profiles, plotted adjacent to the "live" display of the star system's partially transparent, 3D iso-density contour.

	<table align="center" border="1">		<table align="center" border="1">
Line 211:		Line 211:
	</tr>		</tr>
	</table>		</table>


	=Related Discussions=		=Related Discussions=
	* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]		* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]

Tohline: Show density profiles in DWD binary star system

2015-09-11T21:43:36Z

Show density profiles in DWD binary star system

← Older revision		Revision as of 21:43, 11 September 2015
Line 199:		Line 199:
	</table>		</table>
	</div>		</div>

			=Binary Star System=
			Within a couple of hours after I finished developing the above tutorial lesson, I successfully imported data from one of my group's binary star simulations and used the 2D XYPlot tools to display three separate density profiles cut through the volume occupied by the binary system. The following figure displays a VisTrails spreadsheet screenshot of these profiles, plotted adjacent to the "live" display of the star system's partially transparent, 3D iso-density contour.

			<table align="center" border="1">
			<tr><th align="center">Figure 5:     Binary Star Density Profiles</th></tr>
			<tr>
			<td align="center">
			[[File:DWDBinaryStars.png\|450px\|Default Workflow]]
			</td>
			</tr>
			</table>


	=Related Discussions=		=Related Discussions=
	* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]		* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]

Tohline: /* Other Parameters Available for Modification */

2015-09-11T20:12:37Z

Other Parameters Available for Modification

← Older revision		Revision as of 20:12, 11 September 2015
Line 121:		Line 121:

	==Other Parameters Available for Modification==		==Other Parameters Available for Modification==

			The following table identifies a variety of parameter values (assigned within a variety of Modules) that were changed or switched on/off in order to modify the appearance and/or content of the "Pressure vs. Point Id" line-plot that is displayed in the bottom panel of Figure 4. This is just a sampling of the large number of parameters that can be specified/modified in order to achieve a desired 2D plot outcome. Here are a few parameters of special note:
			* vtkTransform:RotateY — the cylindrical columns in the "live" 3D figure do not have to be vertical; the middle column displayed in the bottom panel of Figure 4 has been tipped at an angle of 60°. The middle curve drawn in the 2D plot has changed accordingly, as each curve displays how the pressure is varying ''along one of the identified columns.''
			* vtkXYPlotActor:SetBorder — The 2D plot shown in the bottom panel of Figure 4 includes a 50-px (?) wide white border. This is aesthetically more pleasing, as the axis labels and the figure title are not crammed against the edge of the image (as they are, above, in the bottom panel of Figure 1).

			<div align="center">
			<table border="1" cellpadding="5" align="center">
			<tr>
			<th align="center" rowspan="2">Module</th>
			<th align="center" rowspan="2">Parameter</th>
			<th align="center" colspan="2">Value</th>
			</tr>
			<tr>
			<th align="center">Default</th>
			<th align="center">For Figure 4</th>
			</tr>
			<tr>
			<td align="left"><b><font color="purple">vtkTransform</font></b></td>
			<td align="left">RotateY</td>
			<td align="center">90</td>
			<td align="center">60</td>
			</tr>
			<tr>
			<td align="left"> </td>
			<td align="left">Translate</td>
			<td align="center">(9.2, 0.0, 31.2)</td>
			<td align="center">(9.2, -2.0, 31.2)</td>
			</tr>
			<tr>
			<td align="left"><b><font color="purple">vtkTubeFilter</font></b></td>
			<td align="left">SetRadius</td>
			<td align="center">0.1</td>
			<td align="center">0.4</td>
			</tr>
			<tr>
			<td align="left"> </td>
			<td align="left">SetNumberOfSides</td>
			<td align="center">---</td>
			<td align="center">10</td>
			</tr>
			<tr>
			<td align="left"><b><font color="purple">vtkProperty2D</font></b></td>
			<td align="left">SetLineWidth</td>
			<td align="center">---</td>
			<td align="center">2</td>
			</tr>
			<tr>
			<td align="left"> </td>
			<td align="left">SetPointSize</td>
			<td align="center">3</td>
			<td align="center">5</td>
			</tr>
			<tr>
			<td align="left"><b><font color="purple">vtkTextProperty</font></b></td>
			<td align="left">SetFontFamilyToArial</td>
			<td align="center">Yes</td>
			<td align="center">---</td>
			</tr>
			<tr>
			<td align="left"> </td>
			<td align="left">SetFontFamilyToTimes</td>
			<td align="center">---</td>
			<td align="center">Yes</td>
			</tr>
			<tr>
			<td align="left"><b><font color="purple">vtkXYPlotActor</font></b></td>
			<td align="left">SetBorder</td>
			<td align="center">---</td>
			<td align="center">50</td>
			</tr>
			<tr>
			<td align="left"> </td>
			<td align="left">SetNumberOfXMinorTicks</td>
			<td align="center">---</td>
			<td align="center">6</td>
			</tr>
			</table>
			</div>

	=Related Discussions=		=Related Discussions=
	* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]		* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]

Tohline: /* XY Plots Tutorial */

2015-09-11T18:33:46Z

XY Plots Tutorial

← Older revision		Revision as of 18:33, 11 September 2015
Line 105:		Line 105:

	* The workflow displayed in the top panel of Figure 4 has been modified (from the one shown in Figure 2) to generate only a single 2D plot, and to stretch the plot (bottom panel of Figure 4) so that its height matches the the height of the spreadsheet window. Specifically, the modified workflow contains only one set — instead of three sets — of modules dedicated to drawing a 2D x-y plot (the set of modules enclosed by the blue-bordered box) and, inside the vtkXYPlotActor module, the "SetPosition2" coordinate-pair has been set to (1.0, 1.0). Other parameter-value modifications are discussed below.		* The workflow displayed in the top panel of Figure 4 has been modified (from the one shown in Figure 2) to generate only a single 2D plot, and to stretch the plot (bottom panel of Figure 4) so that its height matches the the height of the spreadsheet window. Specifically, the modified workflow contains only one set — instead of three sets — of modules dedicated to drawing a 2D x-y plot (the set of modules enclosed by the blue-bordered box) and, inside the vtkXYPlotActor module, the "SetPosition2" coordinate-pair has been set to (1.0, 1.0). Other parameter-value modifications are discussed below.

			<table align="center" border="1">
			<tr><th align="center">Figure 4:     Displaying a Single 2D Plot</th></tr>
			<tr>
			<td align="center">
			[[File:Figure4WorkflowA.png\|350px\|Default Workflow]]
			</td>
			</tr>
			<tr>
			<td align="center">
			[[File:Figure4Single2Dplot.png\|350px\|Default Spreadsheet Figure]]
			</td>
			</tr>
			</table>

			==Other Parameters Available for Modification==

	=Related Discussions=		=Related Discussions=
	* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]		* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]

Tohline: /* Understanding Role of Various Modules */

2015-09-11T18:28:31Z

Understanding Role of Various Modules

← Older revision		Revision as of 18:28, 11 September 2015
Line 103:		Line 103:
	</tr>		</tr>
	</table>		</table>

			* The workflow displayed in the top panel of Figure 4 has been modified (from the one shown in Figure 2) to generate only a single 2D plot, and to stretch the plot (bottom panel of Figure 4) so that its height matches the the height of the spreadsheet window. Specifically, the modified workflow contains only one set — instead of three sets — of modules dedicated to drawing a 2D x-y plot (the set of modules enclosed by the blue-bordered box) and, inside the vtkXYPlotActor module, the "SetPosition2" coordinate-pair has been set to (1.0, 1.0). Other parameter-value modifications are discussed below.

	=Related Discussions=		=Related Discussions=
	* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]		* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]

Tohline: /* Understanding Role of Various Modules */

2015-09-11T17:49:56Z

Understanding Role of Various Modules

← Older revision		Revision as of 17:49, 11 September 2015
Line 41:		Line 41:
	* To the left of the vertical yellow line in Figure 2, several distinct module groups have been identified by the three blue-bordered boxes:		* To the left of the vertical yellow line in Figure 2, several distinct module groups have been identified by the three blue-bordered boxes:
	** The uppermost group of modules is used to read in the 3D, "comb" fluid flow data set.		** The uppermost group of modules is used to read in the 3D, "comb" fluid flow data set.
	** The lower, left-most blue-bordered box identifies the modules that are used to draw the boundaries of the 3D data set.		** The lower, left-most blue-bordered box identifies the modules that are used to draw the (black) boundaries of the 3D data set in the lefthand "live" portion of the spreadsheet window.
	** The lower, right-most blue-bordered box identifies the group of modules that is used to draw three vertical, multi-colored "posts" inside of the 3D volume.		** The lower, right-most blue-bordered box identifies the group of modules that is used to draw three vertical, multi-colored "posts" inside of the 3D volume. The location, tilt, length, radius, etc. of each "post" is prescribed by variable values that have been specified inside one of the three vtkProbeFilter modules (found to the right of the vertical yellow line in Figure 2).

	* Modules that lie to the right of the vertical yellow line in Figure 2 are used to draw the set of three different 2D line-plots; for the most part, these have, in turn, been grouped into three sets (columns) containing an identical set of modules. Each column ~~presumably~~ is used to draw one of the three separate 2D line-plots.		* Modules that lie to the right of the vertical yellow line in Figure 2 are used to draw the set of three different 2D line-plots; for the most part, these have, in turn, been grouped into three sets (columns) containing an identical set of modules. Each column of modules in the Figure 2 workflow diagram is used to draw one of the three separate 2D line-plots.

	4. Placing each 2D Plot		4. Placing each 2D Plot
Line 50:		Line 50:
	As we shall explore more fully below, the vtkXYPlotActor module plays a key role in specifying the layout and annotation of each 2D plot, as the module contains a large number of methods whose values can be specified by the user. In §4.12, the [http://www.kitware.com/products/books/vtkguide.html ''VTK User's Guide''] explicitly describes how the location and relative size of an individual plot is specified. The following explanation is provided:		As we shall explore more fully below, the vtkXYPlotActor module plays a key role in specifying the layout and annotation of each 2D plot, as the module contains a large number of methods whose values can be specified by the user. In §4.12, the [http://www.kitware.com/products/books/vtkguide.html ''VTK User's Guide''] explicitly describes how the location and relative size of an individual plot is specified. The following explanation is provided:

			<div id="SetPosition">
	<table border="1" align="center" width="600px" cellpadding="8">		<table border="1" align="center" width="600px" cellpadding="8">
	<tr>		<tr>
Line 68:		Line 69:
	</tr>		</tr>
	</table>		</table>
			</div>

	So, "SetPosition" is essentially the x-y coordinates of the ''location'' of the bottom-left corner of a 2D plot, while "SetPosition2" essentially specifies the width and height of the 2D plot. The default values specified for "SetPosition" and for "SetPosition2" in all three of the 2D plots are shown here, immediately following the above quote.		So, "SetPosition" is essentially the x-y coordinates of the ''location'' of the bottom-left corner of a 2D plot, while "SetPosition2" essentially specifies the width and height of the 2D plot. The default values specified for "SetPosition" and for "SetPosition2" in all three of the 2D plots are shown here, immediately following the above quote. Notice that all three have same width/height specifications (100% & 33%; see SetPosition2 values), but the bottom-left corner location differs.

	5. Demonstrate the functionality of each identified module grouping:		5. Demonstrate the functionality of each identified module grouping:
	* Suppose we want to remove all three 2D plots and just render the 3D configuration that is displayed in the lefthand portion of the default spreadsheet image (bottom panel of Figure 1)? We should be able to do this by severing the connection between the vtkCell module and the right-most vtkRenderer module — the one used to draw all of the 2D line-plots. Figure 3 shows this modified (severed) workflow (top panel) as well as the resulting spreadsheet image (bottom panel).		* Suppose we want to remove all three 2D plots and just render the 3D configuration that is displayed in the lefthand portion of the default spreadsheet image (bottom panel of Figure 1)? We should be able to do this inside the workflow window by severing the connection between the vtkCell module and the right-most vtkRenderer module — the one used to draw all of the 2D line-plots. Figure 3A shows this modified (severed) workflow (top panel) as well as the resulting spreadsheet image (bottom panel).
	*The result is that the rendered 3D image (left half of the lower panel image) is fine, but a garbage image has been drawn in the right half of the image.		*The result is that the rendered 3D image (left half of the lower, Figure 3A panel image) is fine, but a garbage image has been drawn in the right half of the image.
	* Looking more closely at the list of methods that are available in the vtkRenderer module (see righthand list in the top (workflow) panel of Figure 3), we see that, for the default demonstration, the "SetViewport" coordinates were set to (0.0,0.0) and (0.5, 1.0). By changing the second coordinate pair to (1.0,1.0), the problem is fixed as the rendered 3D image is stretched across 100%, rather than just 50%, of the spreadsheet window.		* Looking more closely at the list of methods that are available in the vtkRenderer module [see righthand list in the top (workflow) panel of Figure 3A], we see that, for the default demonstration, the "SetViewport" coordinates were set to (0.0,0.0) and (0.5, 1.0). These coordinates effectively play the same role as the [[#SetPosition\|SetPosition and SetPosition2 coordinates discussed above]], in that the first pair specifies the location of the lower left-hand corner of the image ''within the spreadsheet window'' while the second pair specifies the width/height of the image in that window. Notice that, by default, the 3D "live" image is set up to fill only 50% of the window. As is illustrated in the two panels of Figure 3B, by changing the second coordinate pair to (1.0,1.0), the problem is fixed as the rendered 3D image (bottom panel) is stretched across 100%, rather than just 50%, of the spreadsheet window.


	<table align="center" border="1">		<table align="center" border="1">
	<tr><th align="center" colspan="2">~~Figure 3:    ~~ Remove 2D Plots</th></tr>		<tr><th align="center" colspan="3">Remove 2D Plots</th></tr>
	<tr>		<tr>
	<th align="center">Default Viewport Value</th>		<th align="center">Figure 3A:     Default Viewport Value</th>
	<th align="center">Modified Viewport Value</th>		<th align="center" rowspan="3" width="5%" bgcolor="black"> </th>
			<th align="center">Figure 3B:     Modified Viewport Value</th>
	</tr>		</tr>
	<tr>		<tr>

← Older revision		Revision as of 20:10, 12 September 2015
Line 227:		Line 227:

	<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->		<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->
	[[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]]		<!-- [[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]] -->
	[[Image:~~pivotingBox02~~.gif\|~~150px~~\|Test Animated gif]]		[[Image:pivotingBox03.gif\|250px\|Test Animated gif]]

	=Related Discussions=		=Related Discussions=
	* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]		* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]

← Older revision		Revision as of 20:04, 12 September 2015
Line 228:		Line 228:
	<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->		<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->
	[[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]]		[[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]]
	[[Image:~~CubePivoting02~~.gif\|~~400px~~\|Test Animated gif]]		[[Image:pivotingBox02.gif\|150px\|Test Animated gif]]

	=Related Discussions=		=Related Discussions=
	* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]		* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]

← Older revision		Revision as of 17:27, 12 September 2015
Line 228:		Line 228:
	<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->		<!-- [[Image:LSUtest01.gif\|200px\|Test Animated gif]] -->
	[[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]]		[[Image:LSU_Stable.animated.gif\|74px\|Test Animated gif]]
			[[Image:CubePivoting02.gif\|400px\|Test Animated gif]]

	=Related Discussions=		=Related Discussions=
	* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]		* [[User:Tohline/vtk/Understanding#Understanding_vtk_Tools_Inside_VisTrails\|Understanding vtk Tools Inside VisTrails]]