Entity Editor

Use the Entity Editor section of the Results Browser to view and edit various entity conditions/properties.

Click on an entity in the upper portion of the browser to automatically display the properties assigned to that entity in the Entity Editor located in the lower half of the browser.


Figure 1.

The Entity Editor is turned on and displayed in the browser by default; however, you can hide the editor by clicking on the show/hide toggle (located in the top right corner). In addition, the Entity Editor can be resized vertically and horizontally by clicking on the line that separates the editor from the browser or modeling window (note the double arrow) and dragging and releasing the mouse button once the desired height or width is reached.

The entity categories/properties that are displayed under the Name and Value headers will vary, depending upon the type of entity that is selected.
Note: The categories/sections can be expanded/hidden within the Entity Editor by clicking on plus /minus icons located next to each category name.

Components/Parts



Figure 2.

Standard

ID
The ID of the component/part.
Restriction: This field is not editable.
Visibility
Activate/deactivate the check box to turn the display of the component/part on/off in the modeling window.
Label
The label of the component/part.
Restriction: This field is not editable.

Display

Color
Click the Color box, select a color theme from the drop-down menu (Default, Median, or Rainbow), pick a color from the palette to change the component/part color.
Tip: Click in the color palette to assign and save custom colors.
ID Visibility
Activate/deactivate the display of the component/part ID using the check box.
FE Style
Select/change the element visualization mode of the component/part. The following options are available:
  • Wireframe Elements
  • Transparent Elements
  • Shaded Elements and Mesh Lines
  • Shaded Elements and Feature Lines
  • Shaded Elements
Use in fit
Activate the check box to scale the graphic to fit the window with respect to the selected entities in the animation.

Measures



Figure 3.

Standard

ID
The ID of the measure group.
Restriction: This field is not editable.
Visibility
Activate/deactivate the check box to turn the display of the measure group on/off in the modeling window.
Label
Click in the field to change the label of the measure group.
Type
Select a measure type using the drop-down menu:
  • Distance Between
  • Incremental Distance
  • Minimum Distance
  • Position
  • Relative Displacement
  • Relative Angle
  • Angle Between
  • Incremental Angle
  • Circle Radius
  • Yaw Pitch Roll
  • Elemental Contour
Pick
Select/change the type of entity that will be added to a measure group using the input collector. You can also left click the collector to display the Select by ID dialog.
Note: For Minimum Distance measure groups, clicking in the field will display the Minimum Distance dialog. Use the input collectors to select From and To entities.
Measure List
Display the Measures List dialog. Click Delete to remove the selected items from the Measures list. This dialog will remain active until it is closed.
Plot Measures
Displays a dialog with the list of Measures from which curves can be created.

Click Create Curves to display the Create Curves dialog. Use the re-order arrows to change the order of the measures. This is useful when creating a single curve from all the measures belonging to a particular group. This dialog will remain active until it is closed.

Note: For Minimum Distance measure groups only, the Review mode button and the Edit button will also be displayed in the Measures List dialog.

Display

Font
Display the Font Selector dialog which allows you to select the font type, font style, and font size.
Color
Select a measure color.
ID Visibility
Display the measure group ID.
Name
Display the measure group.
System
Display the system ID.
Magnitude
Display the magnitude value for the selected measure group.

If set to None, Magnitude is not displayed in the modeling window. If set to X+Y+Z (default), Magnitude is calculated from all three components. If set to any of the other options, Magnitude is calculated from two of the components and the measure text in the modeling window will display the option that was used.

X
Display the X value for the selected measure group.
Y
Display the Y value for the selected measure group.
Z
Display the Z value for the selected measure group.
True angle
Display the projected true angle onto the plane.
Restriction: Applicable only for angle type measures (Relative Angle, Angle Between, and Incremental Angle).
x-proj
Display the projected true angle onto the plane, with the x-axis as the normal.
Restriction: Applicable only for angle type measures (Relative Angle, Angle Between, and Incremental Angle).
y-proj
Display the projected true angle onto the plane, with the y-axis as the normal.
Restriction: Applicable only for angle type measures (Relative Angle, Angle Between, and Incremental Angle).
z-proj
Display the projected true angle onto the plane, with the z-axis as the normal.
Restriction: Applicable only for a angle type measures (Relative Angle, Angle Between, and Incremental Angle).
Radius
Display the radius of the circle for the selected measure group.
Restriction: Applicable only for a Circle Radius measure.
Ctr X
Display the X-coordinate of the center of the circle for the selected measure group.
Restriction: Applicable only for a Circle Radius measure.
Ctr Y
Display the Y-coordinate of the center of the circle for the selected measure group.
Restriction: Applicable only for a Circle Radius measure.
Ctr Z
Display the Z-coordinate of the center of the circle for the selected measure group.
Restriction: Applicable only for a Circle Radius measure.

Advanced

Tracking
Change the resolved in system to a tracking system.
Resolved in
Select a system using the input collector. You can also hold down Shift and left click the collector to display the Select by ID dialog.

Global

Transparency
Activate/deactivate the transparency mode.
Auto hide
Hide the measure group box when the selected entities are not visible on the screen.
Format
Select the Fixed or Scientific format from the drop-down menu.
Precision
Increase or decrease the precision level using the up/down arrows.
Angle
Select Degrees or Radians for the angle using the drop-down menu.

Notes

Figure 4.

Standard

ID
The ID of the note.
Restriction: This field is not editable.
Visibility
Activate/deactivate the check box to turn the display of the note on/off in the modeling window.
Label
Click in the field to change the label of the note.
Text
Display the Note Text dialog. You can update the note text in the Description box by entering text directly, or by selecting a field name clicking Insert Field. You can also enter a Templex expression directly into the Description box.
Position Type
Allows you to change the position of the note (Screen or Coordinates).
Position
If Position Type is set to Screen, input values in terms of screen X and Y position (pixels). If Position Type is Coordinates, input values in terms of model X,Y,Z coordinates. Note that this is the position of the note text box.
For Coordinates positioned notes:
  • Arrangement methods will not work.
  • Can be fit on the screen using the Fit Model or Fit All Frames options.
  • Screen Anchor will be disabled.
  • Cannot be moved graphically.
Attach Type
Select the anchoring method for note using the drop-down menu:
  • Window (*Default)
  • Entity
  • Coordinates
Once attached, notes can be positioned anywhere in the window.

Display

Font
Display the Font Selector dialog which allows you to select the font type, font style, and font size.
Color
Select a note color.
Align Text
Select the text alignment (within the note box) from the drop-down menu:
  • Left
  • Center
  • Right
Fill Color
Select a fill color for the note box. You must remove the check mark from the Fill Transparency option in order to select a fill color.
Fill Transparency
Remove the color from the note box and make it transparent against the window.
Border Color
Select a border color.
Border Thickness
Select the border line thickness for the note box from the drop-down menu:
  • 0 (no border)
  • 1
  • 2
  • 3
  • 4
Shape
Select the outline shape of the note:
  • Rectangle
  • Circle
  • Ellipse
Note: This is option is only available only in the Entity Editor (it is not available in the Notes panel).

Advanced

Move to Entity
Position the note at the attachment location.
Note: This option is disabled if Window has been selected from the Attach To drop-down menu.
Activating the Move to entity check box will automatically override the Anchor to Screen option (if activated).
Auto Hide
Hide the note box when the entity that the note is attached to is not visible on the screen.
Screen Anchor
Keep the note stationary during animation or when manipulating the model view (rotating, zooming, etc.).
Note: This option is disabled if Window has been selected from the Attach To drop-down menu.

Properties



Figure 5.

Standard

Current Entity Editor support for Properties is limited to viewing only.
ID
The ID of the property.
Restriction: This field is not editable.
Label
The label of the property.
Restriction: This field is not editable.

Section Cuts

The Entity Editor displays planar and spherical section cuts.
Tip: You can use the browser context menu to complete a variety of tasks such as; creating a new planar or spherical section cut, editing existing section cuts (planar only), renaming or deleting existing section cuts, etc.

Whenever a section cut is selected in the Results Browser, the manipulator will be active and ready to be edited.

Section Cuts - Planar

Standard

ID
The ID of the section cut.
Restriction: This field is not editable.
Type
The section cut type (Planar).
Restriction: This field is not editable.
Visibility
Activate/deactivate the check box to turn the display of the section cut on/off in the modeling window.
Label
Click in the field to change the label of the section cut.
Orientation
Click to display the Section Plane dialog, which allows you to change/define the plane of the section cut.
Base
Specifies the x, y, and z coordinates of the base point of the section cut plane.
Normal
Specifies the direction cosines of the normal of the section cut plane.

Display

Cross Section Only
Display a cross section of the section cut.
Clip Above
When activated, the portion of the model along the positive side of the section plane’s normal will be clipped.
Deformable
Allow the section cut to be deformed, along with the components, during animation.

When this option is selected, a time step/frame number is added next to the section cut label in the Results Browser and in the Section Cut panel.

Cross Section Width
Adjust the width of the cross section using the slider bar. The Cross Section Only check box (see above) must be activated in order for the slider bar to be displayed.
Clip Elements
Display the elements of the clipped part of the model.
Show Section Color
Change the section cut color.
Section Color
Select a color from the palette. The Show Section Color check box (see above) must be activated in order for the selected color to be displayed.
Grid
Display the grid lines in the modeling window.
Grid Text
Display the grid line text in the modeling window.
Grid Text Precision
Select the precision to be used for the grid line text value using the combo box.
Grid Line Space X
Change the spacing of the grid lines along the section plane's x direction
Grid Line Space Y
Change the spacing of the grid lines along the section plane's y direction

Global

Feature Lines
Display the feature lines of the clipped part of the model.
Transparency
Display the clipped part of the model as a transparent surface.

Section Cuts - Spherical

Standard

ID
The ID of the section cut.
Restriction: This field is not editable.
Type
The section cut type (Spherical).
Restriction: This field is not editable.
Visibility
Activate/deactivate the check box to turn the display of the section cut on/off in the modeling window.
Label
Click in the field to change the label of the section cut.
Center Node
Click to display the Node collector, which allows you to adjust the position of the base point of the section cut to the center node.
Center
Specifies the x, y, and z coordinates of the base point of the section cut. Click in the field to manually enter in coordinates if desired.
Radius
Specifies the radius of the spherical section cut. Click in the field to manually adjust the radius of the sphere

Display

Cross Section Only
Display a cross section of the section cut.
Clip Inside
Displays the cross section of the section cut inside the sphere when unchecked.
Sphere
Displays a sphere.
Deformable
Allow the section cut to be deformed, along with the components, during animation.

When this option is selected, a time step/frame number is added next to the section cut label in the Results Browser.

Show Section Color
Change the section cut color.
Section Color
Select a color from the palette. The Show Section Color check box (see above) must be activated in order for the selected color to be displayed.
Clip elements
Display the elements of the clipped part of the model.

Global

Feature Lines
Display the feature lines of the clipped part of the model.
Transparency
Display the clipped part of the model as a transparent surface.
Note: Spherical section cuts are not displayed in the Section Cuts list in the Section Cut panel.

Sets



Figure 6.

Standard

ID
The ID of the set.
Restriction: This field is not editable.
Visibility
Activate/deactivate the check box to turn the display of the set on/off in the modeling window.
Label
Click in the field to change the label of the set.
Entity IDs
Lists the number of entities in the active set. Click in the field to activate the input collector, which allows you to select/change the entity type of a set. You can also hold down Shift and left click the collector to display the Extended Entity Selection dialog.

Display

Color
Select/change the color of the feature lines of the entities in a set using the color box and palette.
ID Visibility
Display the IDs of entities in a set/group.
Draw Style
Select the drawing style for the active set using the input collector:
  • shaded (for Component sets only)
  • wire (for Component or Element sets only)
  • point (for Node sets only)
  • sphere (for Node sets only)
Draw Size
Change the thickness of the wire and the size of the point/sphere drawing for the active set.

Views

Orthographic and Perspective are traditional HyperView view modes, while the Lens type simulates a camera lens (and can be used if you have the camera angle coordinates). These various modes will apply the view volume/clipping region differently.
Current View is a view which is always synchronized with the graphics window. It cannot be deleted or locked. All other user defined or image plane alignment generated views, are locked by default. You can however, “unlock” those views and modify them. When a view is unlocked, it is also synchronized with the graphics window.
Note: See the Views section of the Model View topic for additional information regarding creating, renaming, or displaying views.

Views - Orthographic

Orthographic is the default projection type, and is useful for orienting media that are primarily captured in near orthogonal views (Top, Left, Front, Bottom, Right, and Rear).

Standard

Label
The ID of the view.
Restriction: This field is not editable for Current View.
Lock
Activate to lock the view.
With Masking
Activate to save the current mask state to the view.

View Projection

Projection Type
Select/change the projection type of the view (Orthographic, Perspective, or Lens).

Views - Perspective

Perspective allows you to display graphics using true 3D perspective.

Standard

Label
The ID of the view.
Restriction: This field is not editable for Current View.
Lock
Activate to lock the view.
With Masking
Activate to save the current mask state to the view.

View Projection

Projection Type
Select/change the projection type of the view (Orthographic, Perspective, or Lens).
Perspective Angle
Click in the field and use the slider bar to adjust and set the angle of the perspective (from 5 to 45 degrees).

Views - Lens

The Lens type simulates a camera lens.


Figure 7. Camera and Model Example


Figure 8. Camera Example

Standard

Label
The ID of the view.
Restriction: This field is not editable for Current View.
Lock
Activate to lock the view.
With Masking
Activate to save the current mask state to the view.

Camera

Target
The coordinates of the point on the 3D model where the camera is focused on. There is no default value, a user defined value should always be provided.
Position
The coordinates of where the camera is in 3D model space. There is no default value, a user defined value should always be provided.
Orientation Method
Define which direction the top of the camera is pointing towards:
  • X-up
  • X-down
  • Y-up
  • Y-down
  • Z-up
  • Z-down
  • Vector (Default)
Orientation Vector
When an orientation method is chosen as any predefined method (XYZ axis and up or down), the orientation vector is automatically assigned with corresponding vectors. The default value is 0.33, 0.33, 0.33. When the orientation method is set to Vector, you can arbitrarily input a vector. This vector is an approximation of which direction the top of camera is pointing towards.
Up Vector
The actual direction the top of the camera is pointing towards. This value is calculated automatically based on the previous four entries. It is normalized, and is not editable.

View Projection

Projection Type
Select/change the projection type of the view (Orthographic, Perspective, or Lens).
Focal Length (Zoom)
The focal length of the camera lens in millimeters. This typically can be read from the camera lens. The default value is 25.0.
Sensor Height (mm)
The height of the camera sensor in millimeters. This typically can be found in the camera specifications. Some camera manufacturers specify a sensor width or diagonal, if that is the case the height needs to be calculated using the aspect ratio of the image/video. The default value is 15.6.
Focal Point Offset (mm)
Focal point is the intersection point between the principal direction of camera lens and the camera sensor plane. The Focal Point Offset is the difference from this point to center of camera sensor in millimeters. The default value is (0.0, 0.0). If the actual value is not known, the default value can be used.

Image Plane

If the image/video has been cropped, the sensor height and focal point offset inputs needs to be modified from the original specifications. This section is used to input the cropping information and HyperView will adjust the two automatically.
Image Plane ID
The ID of the image plane for which cropping information is input.
Top cropping
Pixels cropped at the top.
Bottom cropping
Pixels cropped at the bottom.
Left cropping
Pixels cropped at the left.
Right cropping
Pixels cropped at the right.
Adjusted sensor height (mm)
This is calculated by HyperView as follows:

Adjusted sensor height = video height * sensor height/(top + bottom + video height)

where;

top: pixels cropped at the top

bottom: pixels cropped at the bottom

video height: vertical resolution in pixels

Restriction: This field is not editable.
Adjusted focal point
This is calculated by HyperView as follows:

The x value of new focal point offset = (left - right) / 2.0 / video height + input focal point offset x

The y value of new focal point offset = (bottom - top) / 2.0 / video height + input focal point offset y

Restriction: This field is not editable.

Model Files



Figure 9.

Standard

ID
The ID of the model file.
Restriction: This field is not editable.
Visibility
Activate/deactivate the check box to turn the display of the note on/off in the modeling window.
Small deformation
Activate to change the elemental system definition for transient results. The elemental system will be defined using model simulation step coordinates instead of current simulation step coordinates.
Result files
Click in the value field to bring up the Result File List dialog that displays the list of result files associated with the model.

Display

Color
Select/change the color of the model using the color box and palette.
Gradient
Activate/deactivate to turn the model gradient on/off.
Color By
Select the color by mode for the selected model using the drop-down menu:
  • component
  • model
  • normal
  • part

Statistics

No of Nodes
The number of nodes contained in the selected model.
No of Elements
The number of elements contained in the selected model.
No of Components
The number of components contained in the selected model.

Parts View - Components



Figure 10.
Edits of part and component attributes can be made for a single component or multiple components. If a component is selected, the Entity Editor displays component specific attributes.

Standard

ID
The ID of the part assembly.
Restriction: This field is not editable.
Visibility
Activate/deactivate the check box to turn the display of the part assembly on/off in the modeling window.
Label
Click in the field to change the label of the part assembly.

Display

Color
Click the Color box to select a part assembly color from the pop-up dialog.
ID Visibility
Activate/deactivate the display of the part assembly ID using the check box.
FE Style
Select/change the element visualization mode of the part assembly. The following options are available:
  • Wireframe Elements
  • Transparent Elements
  • Shaded Elements and Mesh Lines
  • Shaded Elements and Feature Lines
  • Shaded Elements
Use In Fit
Activate the check box to scale the graphic to fit the window with respect to the selected entities in the animation.

Parts View - Parts/Part Assemblies



Figure 11.
Edits of part and component attributes can be made for a single component or multiple components. If a component is selected, the Entity Editor displays component specific attributes.

Certain representation data and PDM data attributes displayed in the Entity Editor correspond to the columns displayed in the pane above the Entity Editor in the Results Browser. This information is read only.

Standard

Displays attributes that are unique to the part or assembly.

Parts and part assemblies require a unique name and a unique identifier (UID), both of which can contain alphanumeric characters. The UID is an optional field that is utilized in part representation management and import model entity management. For example, when merging a component with a part (module), the two entities will be matched using the UID if it exists. If a UID does not exist, merging will be based on the part name.

Name
The name of the component/part.
ID
The ID of the component/part.
Color
Click the Color box to select a component/part color from the pop-up dialog.
UID
The unique ID of the component/part.
Visibility
Activate/deactivate the check box to turn the display of the component/part on/off in the modeling window.

Representation Data

Displays attributes that are specific to a part representation.
These attributes are non-editable at the part level.
Note: Material and Property information is only available when loading result data using the Advanced Result-Math template.
Representation
The name of the representation
Representation File
The location of the representation file.
Component ID
The component ID.
Property ID
The property ID.
Material ID
The material ID.
Material Name
The name of the material.

Position

Displays the 4 x 3 transformation matrix of a part, namely its translation, rotation, and scaling.
These attributes are non-editable.
x0,y0,z0
dx1,dy1,dz1
dx2,dy2,dz2
dx3,dy3,dz3

PDM Data

Displays PDM attributes.
PDM PID
PDM PID
PDM MID
PDM MID
PDM Material
PDM Material
PDM Thickness
PDM Thickness
PDM ID
PDM ID
PDM Revision
PDM Revision

Image Planes



Figure 12.

Standard

ID
The ID of the image plane.
Restriction: This field is not editable.
Label
The label of the image plane.
Restriction: This field is not editable.
Visibility
Turn the display of the image plane on/off in the modeling window.
File
The path of the image plane file.
Restriction: This field is not editable.
Zoom
Activate to zoom the image plane along with the model.

Cross Sections

Visualize Cross Sections defined in an LS-DYNA input deck in HyperView.

Cross Sections defined in an LS-DYNA analysis via *DATABASE_CROSS_SECTION can be read and visualized in HyperView.
Although Cross Sections share some characteristics with Section Cuts, there are some important differences:
  • Cross Sections are model entities and cannot be created or deleted in HyperView (read-only) at this time, whereas Section Cuts are window-level entities that are fully editable.
  • Cross Sections are cuts defined at specific locations in the model for the purpose of extracting resultant forces and has one or more Sets (Component, Element or Node depending on Cross Section type) associated with them, whereas Section Cuts are global and typically cut the entire model for the purpose of seeing details inside it.
  • Therefore, Cross Sections cannot be manipulated or moved to a different location and are not deformable.
  • Cross Sections and Section Cuts are listed in separate folders in the HyperView Results Browser.
To view Cross Sections, load any LS-DYNA input deck containing these entities as a model file in HyperView. Two types of Cross Sections can be read from LS-DYNA input deck:
  • Planar (DATABASE_CROSS_SECTION_PLANAR)
  • Set (DATABASE_CROSS_SECTION_SET
The type of Cross Section is mentioned in the Info column of the HyperView Results Browser.
Figure 13.

Displaying a Cross Section

Cross Sections can be displayed or hidden using the following methods:
  • Toggling on/off the icon next to the label of the item in the HyperView Results Browser.
  • Selecting the item in the HyperView Results Browser and using the right-click context menu options to Show/Hide/Isolate/Isolate Only.
  • Using the Visibility check box in the Entity Editor of the Results Browser.
  • Cross Sections can be also be turned off globally from the Show/Hide dialog in the View toolbar.
Note:
  • For a Planar Cross Section, turning on the display will result in the display of both the plane and the associated entity set (referenced in the PSID field in the Entity Editor).
  • For a Set Based Cross Section, turning on the display will result in the display of entities belonging to the associated element set (SSID) and the display of the associated node set (NSID).

Changing Display Options of Cross Sections

You can change the appearance of Planar Cross Sections using the following Display options. These options are listed under the Display Section of the Entity Editor.
Figure 14.
In the Section Cuts panel, use the following options to set the display:
Option Description
Cross Section No Clip (default): This will display the cross-section plane on top of the associated set without any clipping of the components. An outline is shown at the location of the cut and its thickness and color can be changed.
Figure 15.
Clipping Plane: The cross-section plane will clip the components on one side of the plane (you can control which side gets clipped).
Figure 16.
Cross Section Only: Only the Cross section is displayed.
Figure 17.
Width slider bar Adjust the width of the cross section. Applicable only for Cross Section Only display mode.
Clipping plane Display the side of the model opposite to where the Cross Section was applied. Not applicable for No Clip display mode.
Clip elements Display the elements of the clipped components.
Thickness Set the thickness of the cross-section outline. Values can be from 1 (thinnest) to 6 (thickest) or Global (use the value from Preferences dialog).
Section color Change the cross-section color by activating the check box and clicking on the color box.
Plane Display the cross-section plane.
Note: You cannot directly change the appearance of Set Based Cross Sections; it can only be changed by modifying the appearance of entities in the associated sets.

Coverage and Limitations

  • Cross Sections can be only be read from LS-DYNA input decks at this time.
  • Cross Sections can be saved to .mvw/.tpl and .h3d files.
  • Planar Cross Sections of finite size (fixed length and width) or circular shape (radius) are not supported in HyperView at this time. Such Cross Sections will be read, but will be displayed of infinite size.