Skip to content

Entry Points ​

BobLib standard entry points are Modelica models intended for BobSim workflows and direct OpenModelica experiments.

BobLib.Experiments.Standards.VehicleSim ​

VehicleSim is the main maneuver simulation wrapper. It follows the VehicleInterfaces demo-style stack while inserting BobLib's detailed physics through explicit subsystem redeclares.

The visible vehicle-level assembly includes:

  • road and atmosphere models from VehicleInterfaces
  • BobLib driver environment and brakes through VehicleInterfaces boundaries
  • BobLib chassis and suspension
  • BobLib aero interface and CFD aero map
  • BobLib battery pack
  • BobLib VCU
  • BobLib DC inverter
  • BobLib electric motor
  • BobLib rear final drive and differential
  • Modelica MultiBody world

The assembly uses one shared VehicleInterfaces controlBus. Subsystems publish their owned measurements and commands on their domain buses: chassis ride heights feed aero through chassisBus, chassis/battery/motor measurements feed the VCU through their buses, the driver environment publishes driver intent, and the VCU publishes electric-drive and mechanical-brake requests for downstream subscribers. With the default regen blend, negative PI speed-control torque goes to the mechanical brake request. Because VehicleInterfaces 2.0.2 atmospheres have no control-bus connector, BobLib also adds a shared AtmosphereBus; atmosphere publishes density and wind there, and aero subscribes to compute relative airspeed locally.

Current maneuver mode parameter:

useModeMode
0open-loop ramp steer
1open-loop sinusoidal steer
2step steer

Common output variables include:

  • speed
  • accX
  • accY
  • yawVel
  • roll
  • sideslip
  • handwheelAngle
  • handwheelTorque
  • leftSteerAngle
  • rightSteerAngle
  • Fz_FL, Fz_FR, Fz_RL, Fz_RR

BobSim uses this entry point for RampSteer, SteadyStateEval, and TransientEval workflows.

Tire Transients ​

Vehicle wrappers can redeclare the MF52 tire slip model to:

text
BobLib.Chassis.Suspension.Tires.MF52.SlipModel.TransientSlip

for front-left, front-right, rear-left, and rear-right tires. The transient slip model receives relaxation parameters from the matching tire model record:

text
pVehicle.pFrTireModel.relaxation
pVehicle.pRrTireModel.relaxation

The relaxation data is encoded in:

text
BobLib.Records.VehicleRecord.Chassis.Suspension.Templates.Tire.MF52.RelaxationRecord

If the relaxation coefficients are not populated, the transient slip model falls back to default longitudinal and lateral relaxation lengths.

Animation And Batch Runs ​

BobLib standard models use:

text
inner parameter Boolean headless = false

by default on the public simulation paths. This means OMEdit examples open with MultiBody animation geometry visible. Set headless=true for batch or CI runs where visualization geometry is not needed.

BobLib.Experiments.Standards.FourPostSim ​

FourPostSim isolates suspension/chassis response for heave and roll sweeps. It extends a static four-post architecture template and uses FourPostEvalRecord outputs so K&C-style response data can be extracted consistently.

Common output records:

  • frKnC
  • rrKnC

BobSim uses this entry point for FourPostEval and downstream suspension metrics.

Released as open-source vehicle simulation tooling.