DREAM.3D v6 User Manual
|
DREAM.3D has 4 main sections of its user interface:
The Pipeline Error Table can be undocked from the main window and moved around. Additionally, it can also have its visibility toggled by the appropriate button found in DREAM.3D's View menu.
DREAM.3D allows the user to spawn as many main windows as desired. To open a new DREAM.3D instance, click the New... option in the File menu. Each instance of DREAM.3D can act independently, and the user is allowed to run different Pipelines in each main window at the same time.
In order to keep the size of the DREAM.3D exeuctable manageable, most of the libraries it depends on are distributed as loose files. This means that the actual DREAM.3D exeuctable cannot be moved outside of the folder it came in unless all other contents of that folder are moved with it.
The DREAM.3D Toolbox contains the Filter List, Filter Library, and Bookmarks sections. Any of these sections can be hidden/shown via menu items in the View menu.
The Filter List section organizes the Filters of DREAM.3D alphabetically by name. Using the search bar, the user can search for Filters based on the name.
Clicking on the magnifying glass icon in the search bar allows the user to pick between three different search algorithms:
The Filter Library section organizes the Filters of DREAM.3D according to their group and subgroup. The user can expand a specific group (and possibly a subgroup) to expose the Filters. Filters are placed into groups and subgroups based on their functionality. This makes it easy to find Filters based on a desired function. In general, the Filter group will correspond to the Plugin that Filter resides in, but this may not always be the case.
The Bookmarks section is where the user can bookmark any Pipelines that they have saved on the file system for later use. This section allows the user to bookmark the pipelines in any structure that they want, using virtual folders. Visit the Saving & Opening Pipelines section for more information on handling saved Pipelines.
Pipelines and folders containing Pipelines can be dragged from the file system into Bookmarks. The user can right click anywhere in Bookmarks to make a contextual menu appear with additional options.
To add a bookmark to Bookmarks, open the Bookmarks menu and choose Add Bookmark. Users can also use the Bookmarks Contextual Menu to add a bookmark by right clicking on an existing virtual folder or empty space and selecting Add Bookmark. Bookmarks and virtual folders can be renamed by right clicking on them and selecting the Rename Bookmark or Rename Folder option. To update a bookmark in Bookmarks, use the Bookmarks Contextual Menu by right clicking on a bookmark and select Update Pipeline. The Bookmark that was right clicked will be updated with the pipeline that is currently in the Pipeline View. To remove a Bookmark or virtual folder from Bookmarks, use the Bookmarks Contextual Menu by right clicking on a bookmark or virtual folder and select Remove Bookmark or Remove Folder. This procedure does not delete the Pipeline files themselves, but only removes them from the Bookmarks View.
WARNING: Removing a virtual folder will also remove all of its contents!
To add a virtual folder to Bookmarks, open the Bookmarks menu and choose New Folder. Users can also use the Bookmarks Contextual Menu by right clicking on a bookmark, virtual folder, or empty space, and selecting New Folder. A specific Bookmark's location on the file system can be viewed by by right clicking on a Bookmark and selecting Show In Finder (Mac OS X) or Show In Windows Explorer (Windows). To open a Bookmark in the Pipeline View, drag and drop it into the Pipeline View. Bookmarks can be dropped into the middle of existing Pipelines if desired. Double clicking on a Bookmark will open the Pipeline in a new main window.
DREAM.3D provides several prebuilt Pipelines that can aid new users in getting started with DREAM.3D. These Pipelines are automatically added to Bookmarks when DREAM.3D is first launched. To open a prebuilt Pipeline in the Pipeline View, drag and drop it into the Pipeline View. Just as with other Bookmarks, prebuilt Pipelines can be dropped into the middle of existing Pipelines. Double clicking on a prebuilt Pipeline will open the Pipeline in a new main window.
The Pipeline View section displays which Filters are in the current pipeline, and in what order. This section is where the user will construct their Pipeline by double clicking on a Filter in the Filter List or the Filter Library. It is also possible to drag a Filter from these areas and drop it into the Pipeline View. Filters in this section can be rearranged into different orders via dragging and dropping the Filter objects. More information on creating Pipelines can be found in the Creating a Pipeline section.
As the user updates the Pipeline, a process called Preflight will be executed to make sure that the Pipeline will have all the necessary data available during execution. If a Filter object in the Pipeline has an error, it will be colored red. If this is the case, check the Pipeline Error Table for an explanation of the error.
A Filter can be selected by single left clicking. Multiple Filters can be selected by shift-clicking and Ctrl/Cmd clicking. Right clicking on a Filter opens a menu that allows the help for that Filter to be displayed by clicking Filter Help. Filters can be removed from the Pipeline by clicking the red X icon on the Filter object. The entire Pipeline View can be cleared by either choosing Clear Pipeline from the Pipeline menu, or right clicking in an empty area of the Pipeline View to make a contextual menu appear with the Clear Pipeline option. After solving any Preflight errors and creating a satisfactory Pipeline, click the Go button to start running.
Filters can be cut, copied, and pasted by using their right-click menus or the universal keyboard shortcuts (Ctrl+X, Ctrl+C, Ctrl+V). Additionally, Filters can be copied by pressing Alt and dragging them.
Note: Copying Filters puts them onto the system clipboard as a pipeline in JSON format. Therefore, it is possible to create a sub-pipeline of a pipeline currently loaded in DREAM.3D by copying filters to the clipboard in DREAM.3D and then pasting into any text editor.
In the example above, filters 2 and 4 are selected and then copied to the bottom of the pipeline by pressing the Alt key and dragging.
It is possible to undo and redo actions such as adding, removing, moving, and clearing Filters using the Undo and Redo items in the Edit menu. Additionally, Undo and Redo can also be invoked by pressing their universal keyboard shortcuts (Ctrl+Z, Ctrl+Shift+Z).
The Filter Input View contains all the parameters for the selected Filter. There are two sections: Variables and Current Structure:
To view the help page for the selected Filter, press the _?_ icon.
The Pipeline Error Table displays any errors and/or warnings associated with Filters that are actively being used in the Pipeline View.
This section gets repopulated every time the Pipeline runs its Preflight process, which makes sure that the Pipeline will have all the necessary data available to execute normally. The Preflight process is run any time the user modifies the Pipeline View or Filter Input View sections.