Users Guide/Bookmarks - Revision history

Emanuele at 22:17, 21 February 2008

2008-02-21T22:17:33Z

← Older revision		Revision as of 22:17, 21 February 2008
Line 1:		Line 1:
	This is a small how-to on how to use the ''Bookmarks'' available in old versions of VisTrails.		This is a small how-to on how to use the ''Bookmarks'' available in old versions of VisTrails.
	This was discontinued and will be replaced by a much more powerful framework called ''Medleys''.		This was discontinued and will be replaced by a much more powerful framework called ''Medleys''.

	~~=(Under Construction)=~~

	== Introduction ==		== Introduction ==

Emanuele at 22:17, 21 February 2008

2008-02-21T22:17:14Z

← Older revision		Revision as of 22:17, 21 February 2008
Line 31:		Line 31:

	[[Image:Bookmark3.png\|thumb\|center\|700px\|''Figure 3: Creating and add a bookmark based on the '''Isosurface Ready''' workflow.'']]		[[Image:Bookmark3.png\|thumb\|center\|700px\|''Figure 3: Creating and add a bookmark based on the '''Isosurface Ready''' workflow.'']]

			After adding a bookmark for the workflow '''Isosurface Ready'', we'll do the same to '''Volume Rendering HW'''.

			== Interacting with Bookmarks ==
			Users can interact with the bookmarks using the Bookmarks Window shown in Figure 4. It can be reached through the Builder Window Toolbar also shown in Figure 4.

			[[Image:Bookmark4.png\|thumb\|center\|700px\|''Figure 4: Activating the Bookmarks Window.]]

			On the Bookmarks Window users can select the workflows they want to explore. By marking the checkbox beside the bookmark name, we can view the parameters we are able to change in that workflow. For example, in the case of the '''Isosurface Ready''' bookmark, we can access only the filename and the isovalue. If multiple bookmarks are selected, the '''union''' of the parameters will be shown on the parameters panel. If the workflows have parameters with the same name, they will be collapsed into one, which means that they will be automatically synchronized.
			In this example, we can explore two rendering methods for the same dataset at the same time.

			To run the workflows, just press the Execute button on the top left of the Bookmarks Window. All the bookmarks that are checked will be executed at the same time.

Emanuele at 21:47, 21 February 2008

2008-02-21T21:47:25Z

← Older revision		Revision as of 21:47, 21 February 2008
Line 29:		Line 29:
	=== Adding a Bookmark ===		=== Adding a Bookmark ===
	To add a bookmark for a workflow, right-click the workflow node in the version tree and select ''Add to Bookmarks'' in the context menu, as shown in Figure 3.		To add a bookmark for a workflow, right-click the workflow node in the version tree and select ''Add to Bookmarks'' in the context menu, as shown in Figure 3.

			[[Image:Bookmark3.png\|thumb\|center\|700px\|''Figure 3: Creating and add a bookmark based on the '''Isosurface Ready''' workflow.'']]

Emanuele at 19:50, 21 February 2008

2008-02-21T19:50:11Z

← Older revision		Revision as of 19:50, 21 February 2008
Line 23:		Line 23:
	[[Image:Bookmark2.png\|thumb\|center\|700px\|''Figure 2: Clicking on a parameter type pops up a window to give it a name. Here the name '''filename''' is given to to the String parameter of the vtkStructuredPointsReader's SetFileName method.'']]		[[Image:Bookmark2.png\|thumb\|center\|700px\|''Figure 2: Clicking on a parameter type pops up a window to give it a name. Here the name '''filename''' is given to to the String parameter of the vtkStructuredPointsReader's SetFileName method.'']]

	After clicking ok, this will create a new ~~version~~ node in the version tree. Now we do the same to		After clicking ok, this will create a new node in the version tree. Now we do the same to the '''Float''' parameter of the SetValue method of the vtkContourFilter module. We will give the name ''isovalue''.

			We will tag this node as '''Isosurface Ready''' and this is going to be the workflow to which we will create the bookmark. The '''Volume Rendering HW''' workflow has already some named parameters. Now it is important that you save your work so the workflows are persistent to the vistrails file and you can add them to your bookmark collection.

			=== Adding a Bookmark ===
			To add a bookmark for a workflow, right-click the workflow node in the version tree and select ''Add to Bookmarks'' in the context menu, as shown in Figure 3.

Emanuele at 19:38, 21 February 2008

2008-02-21T19:38:08Z

← Older revision		Revision as of 19:38, 21 February 2008
Line 19:		Line 19:


	We want to expose only the dataset name and the isovalue in the bookmark. We first select the '''vtkStructuredPointsReader''' module and in the Set Methods panel we click over the parameter type (String) of ''SetFileName''. This will pop up a window where we can type a name, as shown in Figure 2.		We want to expose only the dataset name and the isovalue in the bookmark. We first select the '''vtkStructuredPointsReader''' module and in the Set Methods panel we click over the parameter type (the word String) of ''SetFileName''. This will pop up a window where we can type a name, as shown in Figure 2.

			[[Image:Bookmark2.png\|thumb\|center\|700px\|''Figure 2: Clicking on a parameter type pops up a window to give it a name. Here the name '''filename''' is given to to the String parameter of the vtkStructuredPointsReader's SetFileName method.'']]

			After clicking ok, this will create a new version node in the version tree. Now we do the same to

Emanuele at 19:16, 21 February 2008

2008-02-21T19:16:30Z

← Older revision		Revision as of 19:16, 21 February 2008
Line 13:		Line 13:

	=== Naming parameters ===		=== Naming parameters ===
	In the pipeline view, open the workflow to which you want to create a bookmark.		In the pipeline view, open the workflow to which you want to create a bookmark. For example, we will open the terminator.vt file and choose the '''Isosurface''' workflow as shown in Figure 1.


			[[Image:Bookmark1.png\|thumb\|center\|700px\|''Figure 1: Isosurface workflow is selected in the VisTrails Builder Window'']]


			We want to expose only the dataset name and the isovalue in the bookmark. We first select the '''vtkStructuredPointsReader''' module and in the Set Methods panel we click over the parameter type (String) of ''SetFileName''. This will pop up a window where we can type a name, as shown in Figure 2.

Emanuele at 17:28, 21 February 2008

2008-02-21T17:28:11Z

← Older revision		Revision as of 17:28, 21 February 2008
Line 3:		Line 3:

	=(Under Construction)=		=(Under Construction)=
	=== Introduction ===
			== Introduction ==
	The ''Bookmarks'' application was the first prototype of a framework to help users without programming expertise to better manipulate collections of workflows. Here we show how to create bookmarks and how to interact with them.		The ''Bookmarks'' application was the first prototype of a framework to help users without programming expertise to better manipulate collections of workflows. Here we show how to create bookmarks and how to interact with them.

	=== Creating a Bookmark ===		== Creating a Bookmark ==
	A bookmark is a workflow view that provides a simplified interface for a workflow by only exposing a designated set of components to the user. These components are identified by an '''alias map''' which associates a name to a workflow component. In this prototype, users can name only parameters, but the concept can be applied to modules and to subworkflows.		A bookmark is a workflow view that provides a simplified interface for a workflow by only exposing a designated set of components to the user. These components are identified by an '''alias map''' which associates a name to a workflow component. In this prototype, users can name only parameters, but the concept can be applied to modules and to subworkflows.

			So, in order to create a bookmark you need first to give names to the parameters you want to expose.

			=== Naming parameters ===
			In the pipeline view, open the workflow to which you want to create a bookmark.

Emanuele: New page: This is a small how-to on how to use the ''Bookmarks'' available in old versions of VisTrails. This was discontinued and will be replaced by a much more powerful framework called ''Medley...

2008-02-21T17:24:22Z

New page: This is a small how-to on how to use the ''Bookmarks'' available in old versions of VisTrails. This was discontinued and will be replaced by a much more powerful framework called ''Medley...

New page

This is a small how-to on how to use the ''Bookmarks'' available in old versions of VisTrails.
This was discontinued and will be replaced by a much more powerful framework called ''Medleys''.

=(Under Construction)=
=== Introduction ===
The ''Bookmarks'' application was the first prototype of a framework to help users without programming expertise to better manipulate collections of workflows. Here we show how to create bookmarks and how to interact with them.

=== Creating a Bookmark ===
A bookmark is a workflow view that provides a simplified interface for a workflow by only exposing a designated set of components to the user. These components are identified by an '''alias map''' which associates a name to a workflow component. In this prototype, users can name only parameters, but the concept can be applied to modules and to subworkflows.