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¶
- In the Model panel, tick Enable Measurement. Orbit and pan switch off, and the cursor becomes a crosshair.
- Click a point on the model to place point A.
- 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. - Click again to clear it, then click to start a new measurement.
- Hold Alt to orbit or pan without placing points.
- 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
Sidebar¶
| 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.
- Choose a Template Case ("Select a template case...").
- 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