MotionView User's Guide

MotionView Project Browser

MotionView Project Browser

Previous topic Next topic Expand/collapse all hidden text  

MotionView Project Browser

Previous topic Next topic JavaScript is required for expanding text JavaScript is required for the print function  

The Project Browser (formerly the Model Browser) resides on a tab in a Tab Area sidebar and allows you to view the MotionView model structure while providing display and editing control of entities. There are several types of folders in the Project Browser:  Container folders, folderBlueMSystems-16, and Entity folders, folder-16.  Container folders can represent either a System, Assembly, or an Analysis.  These folders can contain entity folders and other container folders as applicable.  Each entity folder contains entities of a particular type; such as springs, joints, etc.  

The Project Browser can be turned on or off using the Browsers > MotionView > Project option located within the View pull-down menu.  A check mark indicates the Project Browser is activated for display in the Tab Area.

Note        The Project Browser is dockable, meaning it can be positioned anywhere within the HWD graphical user interface by dragging it with your mouse.

Click on the X to close the Project Browser.

mv_model_browser

Project Browser displaying many of various the entities available in MotionView

The key traits of the project browser are as follows:

Global default entities (such as Ground Body and Global Vectors) are listed at the beginning, under the Model folder, followed by the other container folders.
All of the entity folders within the container folders in the MotionView session will be listed in the tree in alphabetical order (for example: Bodies, DataSets, Markers, etc.).
Multiple entities of the same type are collected into a folder in the tree structure.
Each folder can be expanded or collapsed to display or hide its contents.
The variable name of each entity is displayed in the tree.
The ID, color, and display style of entities also display in the Project Browser, when appropriate.
The Context Sensitive Menu (available by right-clicking within the Project Browser) offers a variety of operation choices which are relevant to the entity and context.
Entities can be searched using keyboard inputs, as well as the Find tool.

Entity Selection

The Project Browser provides a powerful and easy way to find and query systems/entities, as well as to select entities for editing.  When a system or entity is selected from the Project Browser, the system or entity is highlighted in the graphics area (if the entity has a graphic representation) and the corresponding entity panel is displayed in the bottom of the window.

Picking in the Project Browser tree list

Left-click to select & highlight an entity in the browser – the entity is also highlighted in graphics area.  Information related to the entity is displayed in the panel and available for modification.
<Ctrl> + left-click to select multiple entities in both the browser and graphics area. 
<Shift> + left-click to select multiple (two or more) entities within the range in the browser and the graphics area.  
Right-clicking highlights components in the list and invokes the Context Sensitive Menu – no highlighting of the entity in graphics area will occur with this operation.

Picking in the Graphics Area

Left-click to select entities.

Selected entities' line items highlight within the browser.

Column Headers/Display Controls

The column headers and display controls allow you to change the visual style (color, mesh/shaded, etc.) of the individual entities displayed in the graphics area.  Each display control affects the specific entity that it appears beside.  You can select which columns will be displayed by right-clicking on the column heading area and using the Context Sensitive Menu to enable/disable each heading (a check mark indicates that the column header is activated for display in the Project Browser).

NoteThe display of the Objects column cannot be disabled/turned off.

The column widths may be changed/adjusted by dragging the line separating the columns, however the ordering of columns is fixed and cannot be changed (from left to right: Objects, Varname, ID, Color, Mesh).

Objects

Displays the labels of the items/entities that comprise the model.

Varname

Displays the variable name of each entity.  The varname of entity is commonly used when constructing parametric expressions or when debugging models, however they cannot be changed or modified.

ID

The ID column displays the ID of each entity (if available).  Pair IDs are shown comma-separated (0,0).  Entity IDs will only display in the Project Browser after a check on the model has been run, and they  cannot be modified from the browser.

Definition

Displays the definition name for definition based entities such as:  System, Assembly, Analysis, DataSets, Templates, Forms, and CommandSets.

Color

Containers and entities can be colored individually, the Project Browser allows you to set each entity’s color without using the Graphic Entity Attributes panel.  When appropriate, the currently assigned color for an entity displays in the Color column. To change an entity’s color, right-click on the current color in the Project Browser, click on Change Color, select a new color from the Colors/Materials dialog, and then click OK.  When the color of a system is changed, the new color 'cascades down' having an effect on the colors of its children; the colors are updated in both the browser (icons) and in the graphics window. Similarly, changing the color of the 'Model' (top level container) will affect the color of all of the entities in the Model, therefore this feature should be used with caution.

Mesh

Entities have several display states, based on a combination of their elements and their geometry.  You can select these display modes by clicking the small icons in the Mesh column for each entity.  Left or right-clicking allows you to open the Mesh/Shade dialog, from which you can choose the new style:

 

Mesh

There are four line options to apply to model components:

Mesh Lines visualizationElementsShadedWithMesh-24

Feature Lines visualizationElementsShadedWithFeatures-24

Edge Lines visualizationElementsShadedWithEdges-24

No Lines visualizationElementsShaded-24

Click the appropriate button to display the desired feature; click another button to remove the feature.

 

Shaded

Entities can be displayed with no shading, opaque, using material, or transparent.

Click visualizationElementsWireframeSkinOnly-24 to display the selected entities with no shading.

Click visualizationElementsShaded-24 to display the selected entities as opaque. Opaque entities are solid and hide the entities behind

Click visualizationElementsUser-24 to display the selected entities with the selected material.

Click visualizationElementsTransparent-24 to display the selected entities as transparent. Transparent entities are see-through and reveal the obscured entities behind them.

Keyboard Shortcuts

The keyboard can be used to navigate up and down the Project Browser, as well as perform several other operations such as: expand/collapse, rename, and delete.  The following keyboard shortcuts are currently available:

Shortcut

Description

Up arrow key

Moves up the browser tree.

Down arrow key

Moves down the browser tree.

Left arrow key

Moves quickly up the browser and collapses various folders along the way. For example, when an entity is selected and the left arrow key is pressed four times:

1.takes you to the entity folder
2.collapses the entity folder
3.takes you to the next parent folder
4.collapses the next parent folder

Right arrow key

Expands a collapsed folder.  Subsequent use will take you to the first available object within the folder (until an entity is encountered).

CTRL+Up arrow key

Scrolls up the browser tree without selecting the entity.

CTRL+Down arrow key

Scrolls down the browser tree without selecting the entity.

Spacebar

Selects the item that is currently chosen with the 'CTRL+Arrows'.

Backspace

Takes you from the active item in the browser tree to the parent item (without collapsing the folders).

CTRL+HOME

Takes you to the top level container 'Model' (at the top of the browser).

CTRL+END

Takes you to the last entity (at the bottom of the browser).

CTRL+X

Cuts the selected entity.

CTRL+V

Pastes a previously cut entity into the selected container.

CTRL+A

Selects all of the entities listed in the browser.

CTRL+\

Unselects all of the entities listed in the browser.

DELETE

Deletes the currently selected entity (after confirming the action in the Confirm Delete dialog).

SHIFT+DELETE

Allows you to delete the currently selected entity immediately, without being prompted by the Confirm Delete dialog.

F2

Allows you to rename the selected entity.

CTRL+F

Displays the Find dialog, which can be used to find an entity.

SHIFT+F10

Displays the context menu that appears on the right-click.

Entity Icons

Each of the entity labels are displayed with an icon image to indicate the entity type. The following table displays the icons for all MotionView entities that appear in the browser:

Entity Classification

Entity

Icon

 

 

 

Reference Entities

Points

point-16

Bodies

entityMultibodies-16

Vectors

entityVectors-16

Markers

entityMarkers-16

Curves

entityCurves-16

Spline3D

3d_spline_icon_small_mv

Graphics

entityGraphics-16

Surfaces

entityGeometry-16

Deformable Curves

entityCurvesDeformable-16

Deformable Surfaces

resultsContour-16

 

 

 

Constraint Entities

Joints

entityJoints-16

Motions

entityMotions-16

Couplers

entityCouplers-16

Gears

entityGears-16

Advanced Joints

entityAdvancedJoints-16

 

 

 

Force Entities

Forces

entityLoadsForces-16

Bushings

entityBushings-16

Fields

entityFields-16

Spring Dampers

entitySpringDampers-16

Beams

entityBeams-16

Polybeams

entityPolybeams-16

Contacts

entityContacts-16

 

 

 

Control Entities

Solver Variables

entitySolverVariables-16

Solver Arrays

entitySolverArrays-16

Solver Strings

entitySolverStrings-16

Solver Differential Equations

entitySolverDifferentialEquations-16

Control SISOs

entityControls-16

Sensors

entitySensors-16

 

 

 

General MDL Entities

Outputs

entityOutputs-16

Definition based entities (such as systems and datasets) are shown with two types of icons.  These entities display a regular icon, if they do not share their definition with another instance of the same type.  If the entity shares its definition with another instance, the icon is shown with a “hand” underneath the regular icon to indicate that it shares its definition.

Entity Classification

Entity

Regular Icon

Shared Icon

 

 

 

 

Definition Based Entities

Analysis (Inline)

analysis_panel_icon_small_mv

shared_instance_analysis_icon_browser_mv

CommandSets

command_sets_icon_small

shared_instance_commandsets_icon_browser_mv

DataSets

entityDatasets-16

shared_instance_dataset_icon_browser_mv

Forms

entityForms-16

shared_instance_forms_icon_browser_mv

GraphicSystems

graphic_systems_icon_small_mv

shared_instance_graphicsystems_icon_browser_mv

Systems

systems_icon_small_mv

shared_instance_systems_icon_browser_mv

Templates

entityTemplates-16

shared_instance_templates_icon_browser_mv

Refer to the Managing Shared Definitions topic for additional details.

hmtoggle_plus1To display and hide the project browser:
1.From MotionView menu bar, select the View menu.
2.If the Project Browser is currently hidden, select Browsers > MotionView > Project to display the project browser on the left side of the page.

OR

If the Project Browser is currently displayed, select Browsers > MotionView > Project to hide the project browser.

 

See Also:

Session Browser for information on the Session tab