Model rotating wheels¶
Bramble models wheel rotation with a moving reference frame (MRF) region, called an RRF in the Template Case, or with a rotating-wall boundary condition. You set them up on the Template Case's Rotating tab.
Before you start
- Nothing needs enabling. The tables are in Template Cases of the OpenFoam and OpenFoam with CHT Methodology Groups. Star-CCM+ Template Cases have their own Rotating With RRF (CCM) table.
- Name the wheel zones following the zone naming conventions.
- To have the Kinematic Setup fill in the axes and speeds, you need a Kinematic Setup whose model includes the wheels.
Choose a method¶
| Method | Table | The rotating region is defined by | Use for |
|---|---|---|---|
| Standard MRF | Rotating With RRF, Zoneless off | A toint-rrf-<name> zone in the geometry |
Wheels, including spokes and rims |
| Zoneless MRF | Rotating With RRF, Zoneless on | Regexes of the zones to rotate, with no toint zone |
Wheels, when you don't want to build an MRF volume. v1806F methodology only |
| Rotating wall | Rotating Without RRF | The matching zones only (no MRF region) | Rotating walls such as driveshafts |
Prepare the geometry¶
| Zone | Pattern | Example |
|---|---|---|
| Rotating wheel parts | fr-wh-…, rr-wh-… |
fr-wh-rim-lhs |
| Parts that move with the wheel but don't rotate | fr-int-…, rr-int-… |
fr-int-upright-lhs |
| MRF volume (standard MRF only) | toint-rrf-<description>-<side> |
toint-rrf-fr-lhs |
Tyre zones whose names match -tyre or -tire, such as fr-wh-tyre-lhs, get a rough-wall condition
automatically. See toint zones.
Add a standard MRF¶
- In the Template Case editor, go to the Rotating tab. In Rotating With RRF, click New.
-
Fill in the row:
Field Enter Name The part of the MRF zone name after toint-rrf-. For the zonetoint-rrf-fr-lhs, enterfr-lhsRegex The zones to rotate, for example fr.*wh.*lhsZoneless Off Axis The rotation axis vector Origin A point on the axis (m) Omega The rotational speed Mrf Point A point inside the MRF region (m) Non-Rotating-Patches Zones inside the MRF region that mustn't rotate, such as int-uprights and brake partsTags The wheel's kinematic tag, so the Kinematic Setup can fill in Axis, Origin and Omega (see below) -
Click Save. Repeat for each wheel, then click Save in the header.
Let the Kinematic Setup set the rotation¶
When a Kinematic Setup's wheel model drives a row, it sets:
- Axis from the inboard to the outboard axle point
- Origin at the inboard axle point
- Omega from the velocity divided by the rolling radius (with crossflow, the velocity × cos(yaw))
The Kinematic Setup applies to rows whose Tags include <region>__<model name>, in lower case with spaces
replaced by _, for example front_lhs__wheel. If no row has the tag, case creation fails.
To check the positions before you launch, use Validate on the Run's CFD Setup tab. With a Kinematic Setup loaded, it fills Origin from the inboard axle point and Mrf Point from the kinematic model's MRF point. It reports "No points matching: <name>", "No MRF point in kinematic setup for: <name>" or "No points in the kinematic setup" if it can't find them.
Use a zoneless MRF¶
- In Rotating With RRF, click New and turn on Zoneless.
- Fill in Name, Regex, Axis, Origin, Omega and Tags as for a standard MRF.
- In Zoneless Patches, list the regexes of the zones that make up the rotating region, for example
["fr.*wh.*lhs"]. At least one is required. Non-Rotating-Patches and Mrf Point show N/A. - Click Save.
Zoneless MRFs:
- need a v1806F methodology ("Zoneless MRFs can only be used with the v1806F methodology.")
- can't be combined with a moving mesh
Add a rotating wall¶
- On the Rotating tab, in Rotating Without RRF, click New.
- Fill in Name, Regex (the zones to rotate), Axis, Origin (m), Omega and Tags.
- Click Save.
Check the set-up¶
Pre-checks (see the checks reference):
| Check | Fails when |
|---|---|
| Zoneless patches in a Zoneless MRF do not match any zones | A zoneless MRF's Zoneless Patches match no zones |
| Zones have been matched in the zoneless or non-rotating patches for multiple MRFs | Two MRFs claim the same zone |
| Non-Rotating Patches do not match any zones | A Non-Rotating-Patches entry doesn't exist in the geometry |
| Tyre Roughness | A tyre zone has no rough-wall condition |
To see each rotating region, choose Rotating: … in Select Pre-check Plots on the Run Checks tab. The Rotational Geometry Plots show the axis in red and the MRF point in green. Zoneless Patches Plots and Non-Rotating Patches Plots show the patch selections.
Solution checks:
| Check | Fails when | Usual cause |
|---|---|---|
| Check Centroid Distance | A wheel's rotating region is more than 5 mm off its axis | Wrong Axis or Origin |
| Check Cell Total | A rotating region holds more than 90 % of the cells | The outer domain has been assigned to the MRF region |
| Check Cell Zone Sizes | Needs a baseline. A rotating region's cell count differs from the baseline by more than 10 % | A change to the MRF volume or mesh |
Related: Template Case editor reference · Zone naming · Configure pre-checks · Checks reference