User Control File Format
The user.ctl file is created by the user control program. Below are descriptions of the keywords that can be used in a user.ctl file, and indicating the solver types for which they are valid.
| Keyword | Description | 2D | 3D | 3D A-Phi |
|---|---|---|---|---|
| windingSrc <winding_name> <val>*** | Voltage [V]/Current [A] value for Winding | X | X | X |
| windingR <winding_name> <val>*** | Resistance value [Ohm] for Voltage Winding | X | X | X |
| windingL <winding_name> <val>*** | Inductance value [H] for Voltage Winding | X | X | X |
| loadTorque <value> | Load Torque [N*m] for rotational motion only | X | X | |
| loadForce <value> |
Load force in MotionSetup [N] for translational only |
X | X | |
| damping <value> |
Damping coefficient [translational: N*s/m; rotation: N*m*s/rad] |
X | X | |
| loadInertia <value> |
Load Inertia in MotionSetup [kg*m²] for rotational only |
X | X | |
| mass <value> | Mass in MotionSetup [kg] for translational only | X | X | |
| speed <value> |
Speed of the moving object [translation - m/s; rotation - rad/s] |
X | X | |
| position <value> |
Position of the moving object [[translation - user unit (from Motion Setup); rotation – rad] |
X | X | |
| timeStep <value> | Time step size [s] | X | X | X |
| stop <0 or 1> | Stop solver if value is equal to 1 | X | X | X |
| exportFieldAtMeshNodeOnAllObjects | Request to export fields on all object in design | X | X | X |
| exportFieldAtMeshNodeOnObject <objectID>* | Request to export fields on specific object | X | X | X |
| NStep <value> | Export fields only every N steps (works only in conjunction with exportFieldAtMeshNode<...>) | X | ||
| FieldSelect <value>** | Export only specific field (one of A,B,H,J) (works only in conjunction with exportFieldAtMeshNode<...>) | X | ||
| Binary <0 or 1> | Export fields in binary format (works only in conjunction with exportFieldAtMeshNode<...>) | X | ||
| voltageSrc <voltage_name> <source_value>*** | Voltage source value [V] | X | ||
| currentSrc <current_name> <source_value>*** | Current source value [A] | X | ||
| Full line could be repeated for *multiple object IDs; **multiple fields; ***multiple excitation names | ||||
The following user.ctl file example:
-
Sets the time step to 5 ms.
-
Sets Resistance to 1 μOhm and Inductance to 1 μH for Winding A and Winding B.
-
Sets Voltage for Winding A to 10 V and for Winding B to -10 V.
-
After time step is completed all fields for the object with ID 88 will be exported.
begin_data
windingSrc WindingA 10
windingR WindingA 1e-6
windingL WindingA 1e-6
windingSrc WindingB -10
windingR WindingB 1e-6
windingL WindingB 1e-6
exportFieldAtMeshNodeOnObject 88
timeStep 5e-3
stop 0
end_data
Related Topics
Using a Control Program in Maxwell 2D and 3D Transient Solutions