Test wake body

A kinematic drag sphere that casts a lumped wake for the other objects.

Collaboration diagram for Test wake body:

A kinematic drag sphere moving at a constant velocity, casting a lumped wake.

A test and demonstration model of the one public casting path: an environment::wake::SingleBodyWake and the shape caster environment::sphere_hydro::SphereCaster, with no wake code of its own (ENV-0102). The body moves at the constant TowVelocity from its initial Position; zero holds it fixed. Its drag is environment::sphere_hydro's quadratic law F = ½ ρ C_d A |u| u on the relative flow u = u_water − TowVelocity, with A = π D²/4, the frontal area of a sphere in any direction. The drag does not act on the motion: the body is kinematic.

With CastWake set, the body registers one lumped source under its name in FinalSetup and rebuilds it in PreOdeFcn on the schedule of the Wake* parameters: the free stream at the centre is the ambient current with every other registered wake (never its own, never the waves); the momentum deficit is M = F·ê_U / (½ ρ |U|²) = C_d A for this law; the source sits at the rear face, D/2 downstream of the centre, where its wake starts. The body's centre is therefore never inside its own wake, and its own field is excluded from the flow it samples, so this also holds if the relative flow reverses between rebuilds (the wake frame does not rotate). The wake acts on the current part of every other object's flow. The body receives the other objects' wakes as every BodyWake does: held for the step with ExternalWakeUpdate Step (the default), live with Evaluation.

Example Configuration (XML)

<Lib LibName="fhsim_environment" SimObject="TestWakeBody" Name="Sphere"
     Diameter="1" DragCoefficient="0.5" CastWake="true" WakeUpdate="Freeze" />

Input ports

None.

Output ports

Port	Size	Description
Position	3	Centre [m], NED.
WaterVelocity	3	Waked water velocity at the centre, including waves [m/s], NED.
Force	3	Drag at WaterVelocity [N], NED.

States

Position (3) [m], NED: set its initial value with the initial condition <Name>.Position. Velocity (3) [m/s], NED: TowVelocity, constant.

Configuration Parameters

Name	Width	Description
Diameter	1	Diameter D [m], > 0. (Default: 1)
DragCoefficient	1	Drag coefficient C_d on the frontal area [-], >= 0; a test value, not a measured sphere coefficient. (Default: 0.5)
Rho	1	Water density [kg/m^3], > 0. (Default: 1025)
TowVelocity	3	Constant velocity of the body [m/s], NED. (Default: 0, 0, 0, fixed)
CastWake	1	Register and build the lumped wake; the other wake parameters (Wake*, ExternalWakeUpdate) are listed in doc/user/wake-parameters.md. (Default: false)

This SimObject is referred to as TestWakeBody