2.4. User Defined Dynamics#

In Flow360, users are now able to specify arbitrary dynamics. In what follows, an example for a Proportional-Integral (PI) controller and an example for Aero-Structural Interaction (ASI) are given.

2.4.1. PI controller for angle of attack to control lift coefficient#

In this example, we add a controller to om6Wing case study. Based on the entries of the configuration file in this case study, the resulting value of the lift coefficient, CL, obtained from the simulation is ~0.26. Our objective is to add a controller to this case study such that for a given target value of CL (e.g., 0.4), the required angle of attack, alphaAngle , is estimated. To this end, a PI controller is defined under userDefinedDynamics in the configuration file as:

 1"userDefinedDynamics": [
 2    {
 3        "dynamicsName": "alphaController",
 4        "inputVars": [
 5            "CL"
 6        ],
 7        "constants": {
 8            "CLTarget": 0.4,
 9            "Kp": 0.2,
10            "Ki": 0.002
11        },
12        "outputVars": {
13            "alphaAngle": "if (pseudoStep > 500) state[0]; else alphaAngle;"
14        },
15        "stateVarsInitialValue": [
16            "alphaAngle",
17            "0.0"
18        ],
19        "updateLaw": [
20            "if (pseudoStep > 500) state[0] + Kp * (CLTarget - CL) + Ki * state[1]; else state[0];",
21            "if (pseudoStep > 500) state[1] + (CLTarget - CL); else state[1];"
22        ],
23        "inputBoundaryPatches": [
24            "1"
25        ]
26    }

The complete case configuration file can be downloaded here: Flow360.json.

Some of the parameters are dicussed in more detail here:

  1. dynamicsName: This is a name selected by the user for the dynamics. The results of user-defined dynamics are saved to udd_dynamicsName_v2.csv.

  2. constants: This includes a list of all the constants related to this dynamics. These constants will be used in the equations for updateLaw and outputVars. In the above-mentioned example, CLTarget, Kp, and Ki are the target value of the lift coefficient, the proportional gain of the controller, and the integral gain of the controller, respectively.

  3. outputVars: Each outputVars consists of the variable name and the relations between the variable and the state variables. For this example, we set the output variable equal to the angle of attack calculated by the controller after the first 500 pseudoSteps (i.e., state[0]).

  4. stateVarsInitialValue: There are two state variables for this controller. The first one, state[0], is the angle of attack computed by the controller, and the second one, state[1], is the summation of error (CLTarget - CL) over iterations. The initial values of state[0] and state[1] are set to alphaAngle and 0, respectively.

  5. updateLaw: The expressions for the state variables are specified here. The first and the second expressions correspond to equations for state[0] and state[1], respectively. The conditional statement forces the controller not to be run for the first 500 pseudoSteps. This ensures that the flow field is established to some extent before the controller is initialized.

  6. inputBoundaryPatches: The related boundary conditions for the inputs of the user-defined dynamics are specified here. In this example, the noSlipWall boundary conditions are where CL is calcualted. As seen in the configuration file, the boundary name for the No-Slip boundary condition is "1".

The following figure shows the values of lift coefficient, CL, and angle of attack, alphaAngle, versus the steps, pseudoStep. As specified in the configuration file, the initial value of angle of attack is 3.06. With the specified user-defined dynamics, alphaAngle is adjusted to a final value of 4.61 so that CL = 0.4 is achieved.


Fig. 2.4.1 Results of alphaController for om6Wing case study.#

2.4.2. Dynamic grid rotation using structural aerodynamic load#

In this example, we present an illustrative case where a flat plate rotates while being subjected to a rotational spring moment and damper as well as aerodynamic loads. Below is a video showing the flutter motion of the plate.


Fig. 2.4.2 Flutter motion of the plate under aerodynamic and structural forces.#

The userDefinedDynamics section of the case JSON is presented below:

 2    "userDefinedDynamics": [
 3        {
 4            "dynamicsName": "dynamicTheta",
 5            "inputVars": [
 6                "rotMomentY"
 7            ],
 8            "constants": {
 9                "I": 0.443768309310345,
10                "zeta": 4.0,
11                "K": 0.0161227107,
12                "omegaN": 0.190607889,
13                "theta0": 0.0872664626
14            },
15            "outputVars": {
16                "omegaDot[plate]": "state[0];",
17                "omega[plate]": "state[1];",
18                "theta[plate]": "state[2];"
19            },
20            "stateVarsInitialValue": [
21                "0.0",
22                "0.0",
23                "1.39626340e-01"
24            ],
25            "updateLaw": [
26                "if (pseudoStep == 0) (rotMomentY - K * ( state[2] - theta0 ) - 2 * zeta * omegaN * I *state[1] ) / I; else state[0];",
27                "if (pseudoStep == 0) state[1] + state[0] * timeStepSize; else state[1];",
28                "if (pseudoStep == 0) state[2] + state[1] * timeStepSize; else state[2];"
29            ],
30            "inputBoundaryPatches": [
31                "plateBlock/noSlipWall"
32            ]
33        }
34    ]

The complete case configuration file can be downloaded here: Flow360.json.

For this case the dynamics of the plate is:

(2.4.1)#\[\ddot{\theta} = \left[ \tau_y - K \cdot \left( \theta-\theta_0 \right) - 2\zeta\omega_N I \dot{\theta} \right]/I\]
(2.4.2)#\[\dot{\theta} -\dot{\theta}_0= \int_{0}^{t} \ddot{\theta}\left(t'\right) \, dt'\]
(2.4.3)#\[\theta -\theta_0 = \int_{0}^{t} \dot{\theta}\left(t'\right) \, dt'\]

which cooresponds to the three updateLaw shown above. Below is a table for the symbols and their respective physical meannings:




Rotation angle of the plate in radius.


Aerodynamic moment exerted on the plate.


Stiffness of the spring attached to the plate at the structural support.


Structural damping ratio.


Structural natural angular frequency.


Structural moment of inertia.

In the inputVars, the rotMomentY is the Y component of the rotational moment by the aerodynamic force. The moment is calculated around momentCenter.

Note that OutputVars follows the format of VarName[slidingInterfaceName] : Relation to state variable. In this case the name of sliding interface is plate. \(\ddot{\theta}\), \(\dot{\theta}\), \(\theta\), are assigned as the first, second and third state variables, respectively.