Skip to content

Model viewer

The controls, toolbar buttons, panels and sidebar tabs of Bramble's 3D model viewer. It opens full screen, and shows a simplified (decimated) version of each Part's mesh, so it loads faster than the uploaded file.

Where it opens

Open from Button Title shown
Part Libraries page, the Part table's Viewer column Viewer icon The Part number and description
Assembly Libraries page, or an Assembly page Viewer <number> \| <description>, plus (Locked Assembly) if the Assembly is locked
A Run's Model Build tab View all assemblies <Run name> - <description>
Results, the Attitude status dialog View Run Model <Run name> - <description>
A Run's Run Checks tab, View Processed Geometry row View Processed Geometry Processed Geometry - <Attitude name>
The Kinematic Setup dialog View Setup <name> - <description>

The viewer from View all assemblies and View Run Model is the Run model viewer. View Processed Geometry shows the geometry after kinematics have been applied, as it goes to the mesher. It's only available once processing has succeeded.

While it loads, a progress bar reads "Downloading: <description> <n> of <m> file(s)".

View all assemblies is disabled, with a tooltip, when:

  • "You do not have permission to load Part files."
  • "Accessing this model is not allowed."
  • "Template case has not finished loading."
  • "assemblies are empty."

Layout

  • The sidebar is on the left. The arrow button on its edge collapses and expands it.
  • The 3D scene is on the right, on a white background.
  • The toolbar is in the top bar, next to the close (×) button.
  • Toolbar buttons open floating panels. Drag a panel by its title bar. − / + minimises or restores it, and × closes it.

Mouse controls

Action Control
Orbit Left-drag
Pan Right-drag
Zoom Scroll wheel, or middle-drag. Zooms towards the rotation centre, not the cursor
Set the rotation centre Double-click a point on the model
Select a zone Click the model. The zone is highlighted and its Part expands in the sidebar tree. Click again to deselect. A longer press counts as a drag
Isolate a Part or zone Shift-click
Hide a Part or zone Ctrl-click (Windows) or Cmd-click (Mac)
Highlight Hover over a zone. It turns yellow in the scene and purple in the tree
  • Isolate and hide work on Parts or on zones, depending on the Parts / Zones option in the sidebar.
  • Hidden and clipped-away geometry can't be picked.
  • There are no keyboard shortcuts. The only keys are Shift, Ctrl and Cmd with a click, and Alt while measuring.
  • To reverse the scroll-wheel zoom, tick Invert Postpro Zoom Direction in user settings. Despite its name, it also affects the model viewer. Reopen the viewer after changing it.

Toolbar

Button Does Part Assembly Run model Processed geometry
Camera Opens the Camera panel. Hidden for Restricted Users — — ✓ —
Deltas Opens the Deltas panel — — ✓ —
Perspective Camera / Orthographic Camera Opens the View Angle panel. The label shows the current projection ✓ ✓ ✓ ✓
Model Opens the Model panel ✓ ✓ ✓ ✓
Parts Add Parts to the Assembly. Hidden if the Assembly is locked, and disabled while "Part Libraries are currently loading" — ✓ — —
Kinematics Toggles the Kinematic Setup overlay. Only shown if the Run has a Kinematic Setup — — ✓ ✓
Clipping Opens the Clipping panel ✓ ✓ ✓ ✓
Morphing Opens the morphing tools. See create a deformation volume ✓ — — —
Default Resets the camera to the default three-quarter view (from the front, right and above), and the rotation centre to the model's centre. Keeps the projection ✓ ✓ ✓ ✓
Screenshot Downloads the current view as a JPEG ✓ ✓ ✓ ✓
Reload Rebuilds the scene. Grid, axes, measurement and colour settings are kept ✓ ✓ — —

The View Setup viewer has no toolbar or sidebar. See Kinematic Setup viewer.

Panels

View Angle

Control Does
Perspective / Orthographic Switches the projection and keeps the current view. The default is Perspective
Default Same as the toolbar Default button
Front Looks from −X, downstream
Rear Looks from +X
Top / Bottom Looks from +Z / −Z
Left / Right Looks from −Y (the driver's left) / +Y (the driver's right)

Each view fits the whole model and resets the rotation centre to its centre. For the axes, see coordinate system and units.

Model

Control Does Default
Colour: and Reset Sets one colour for all model surfaces Light grey
Grid Shows a grid under the model, at the model's lowest point (not z = 0). Its cell size isn't a round number, so don't use it to measure Off
Axes (x, y, z) Draws the axes from the origin (0, 0, 0): "X (red), Y (green), Z (blue)" Off
Enable Measurement Turns on the measurement tool Off
Double Side Draws both sides of every surface. Untick it to hide back faces, so surfaces seen from behind disappear On
Dimensions (mm): The overall size of the loaded model's bounding box, X x Y x Z, in whole mm —
Intersection Point (mm): The coordinates of the surface point under the cursor, or None —
Zone Highlighted: The name of the zone under the cursor, or None —

Measurement

  1. In the Model panel, tick Enable Measurement. Orbit and pan switch off, and the cursor becomes a crosshair.
  2. Click a point on the model to place point A.
  3. Click a second point for point B. A line joins them, labelled with the distance and its components along the global axes, in whole mm, for example 1234 (1200, 50, 280) mm.
  4. Click again to clear it, then click to start a new measurement.
  5. Hold Alt to orbit or pan without placing points.
  6. Untick Enable Measurement to remove the measurement and turn orbiting back on.

There's one measurement at a time.

Clipping

Control Does
Show Planes Shows the enabled cutting planes as translucent grey planes
YZ Plane Cuts at an X position (front to back)
XZ Plane Cuts at a Y position (side to side)
XY Plane Cuts at a Z position (height)
Plane Enabled Turns that plane's cut on
Distance (mm) Where the plane cuts, by number or slider, in 1 mm steps across the model's extent. Starts at the middle
Flip Swaps which side is cut away. By default the plane removes the geometry on the negative side, so the YZ plane removes everything upstream of the Distance
Show 2D Slice Keeps only a 20 mm slab at the plane, so you see the section outline. Flip is hidden while it's on
  • You can enable several planes at once. Geometry on the cut side of any enabled plane is removed.
  • Clipping applies to the model surfaces only, not to Kinematic Setup or Template Case overlays.

Camera

Run model viewer only, and hidden for Restricted Users. Use it to view, edit and create the postpro cameras in a camera set.

Control Does
Camera Set Choose a camera set. It's filled in if the Run's Attitudes use a single camera set
Camera Choose a camera in the set
New Camera / Delete Camera Add or remove a camera
Name The camera's name. It must be unique in the set
Focal Point X, Y and Z, in m
Elevation (°), Azimuth (°) The viewing direction. Azimuth 0° looks from the left, 90° from the rear, 180° from the right and 270° from the front. Elevation +90° looks down from above
View Type Perspective, with Distance (m), or Orthographic, with Orthographic Scale
Cancel / Reset Changes, Save as new, Update camera, Create camera Save or discard changes

While the panel is open, the scene is framed at the postpro images' 16:9 aspect ratio, with a Postpro View caption.

Deltas

Run model viewer only. It shows Baseline: (the Run's baseline, or (Not Available)). Choose a Programme, Project and Runs to compare against:

  • Parts added relative to that Run are shown green.
  • Parts removed relative to that Run are shown red, and listed under Removed Parts in the sidebar.

Kinematics

A toggle in the Run model and Processed geometry viewers, shown when the Run has a Kinematic Setup. It makes the model transparent and draws the Kinematic Setup:

  • single points as red spheres
  • multi-point components as coloured rods between their points
  • wheel axles as red rotation rings with arrows
  • the Ground Plane as a red plane across the model
Tab Viewer
Parts Part, Assembly and Processed geometry viewers
Assemblies Run model viewer
Template Cases Run model viewer. Hidden for Restricted Users
Morphing, Parameters / Parameter Deformation, Chain Deformation Part viewer, once you open Morphing. See deform a Part

Filter

At the top of the Parts and Assemblies tabs:

Control Does
Deselect All / Select All Hides or shows everything. With search text, only the matching items
Search Case-insensitive "contains" match. * splits the text into pieces that must all appear, in any order: fw*lhs matches names containing both fw and lhs
Invert "The inverse of the filtered state will be applied": shows the items that don't match
Parts / Zones Whether search, Shift-click and Ctrl/Cmd-click act on Part names or zone names. Default Parts
Filter Scene Off / On On (default): the scene shows only matching items. Off: only the tree is filtered

Tree

The tree (Loaded Assemblies, Loaded Assembly or Loaded Part) lists Assembly → Part → zone.

  • Tick or untick a node to show or hide it and everything under it.
  • Hover over a label to highlight it in the scene.
  • A Part's description is shown in italics under its name.
  • A red warning icon marks a Part with open edges ("This part has open edges").
  • Assembly viewer, unlocked Assembly only: the red − button ("Remove part from assembly") removes a Part. It then becomes an undo button ("Undo Remove Part from assembly"). Removed Parts turn red and added Parts turn green.

Warning

Adding or removing Parts in the Assembly viewer changes the Assembly straight away. There's no separate save.

  • Run model viewer, with Deltas: a Removed Parts tree above the main one lists Parts that are in the compared Run but not in this one.

Template Cases

Run model viewer only. Shows a Template Case's features in 3D against the model.

  1. Choose a Template Case ("Select a template case...").
  2. Choose a Case Data Type ("Select data type..."). The cog button beside it opens the mesh-size settings for spheres and cylinders.

The data types depend on the Template Case's methodology:

Methodology Case Data Types
OpenFOAM, OpenFOAM with CHT Radiators, Rotating, Components, Mesh Boxes, Force Groups, Wake Grids
Star-CCM+ Radiators, Rotating, Mesh Boxes, Components (CCM), CCM Mesh Defaults, CCM Wrapper Defaults, Force Groups
Acoustic FRPMs, Microphones, zCFD Domain, zMesh Boxes

Some types have extra toggles, for example View Unmatched Zones and Explode Groups for Force Groups, or View Zoneless Patches for Rotating. Lengths here are in metres, for example the Wake Grids Base Point (m). For the settings themselves, see the Template Case editor.

Screenshots

Screenshot downloads the current 3D view straight away as a JPEG, at the scene's on-screen size, on a white background. The sidebar and panels aren't included. The file is named after the viewer title (the Run name in the Run model and Processed geometry viewers), with spaces replaced by _.

Kinematic Setup viewer

View Setup in the Kinematic Setup dialog opens a viewer with no toolbar or sidebar. The mouse controls are the same. It draws each subsystem's points joined by rods, wheel axles as red rotation rings, and a grid at z = 0 with 1 m cells. View Setup is disabled while "Kinematic setup is invalid".

Related: Coordinate system and units · Create an Assembly · Configure pre-checks · Create a Kinematic Setup · Template Case editor · Postpro viewer · Geometry