*SetField() - asymmetric field pair with user subroutine
Sets the properties of an asymmetric field pair with a user subroutine.
Syntax
*SetField(field_name, , USER,
`solver_expression_1`
`solver_expression_2`)
*Set(field_name.l.use_local_dll, TRUE|FALSE)
*Set(field_name.r.use_local_dll, TRUE|FALSE)
*Set(field.l.local_dll, "string")
*Set(field.r.local_dll, "string")
Arguments
- field_name
- The variable name of an existing field pair.
- USER
- Set to USER for the field pair to be represented by a user subroutine.
- solver_expression_1
- A solver expression enclosed in back quotes to specify arguments for the user subroutine for the left field.
- solver_expression_2
- A solver expression enclosed in back quotes to specify arguments for the user subroutine for the right field.
- field_name.l.use_local_dll field_name.r.use_local_dll
- Specifies if a user subroutine DLL specific to the instance of one field pair entity is to be used.
- field_name.l.local_dll field_name.r.local_dll
- The path and filename for the user subroutine DLL to be used with an instance of the user defined field pair.
Example
*BeginMDL(model, "Field Model")
*Body(b_0, "Body 0")
*Body(b_1, "Body 1")
*Point(p_0, "Point 0")
*Point(p_1, "Point 1")
*Point(p_2, "Point 2")
*Vector(v_1, "Vector 1")
*Vector(v_2, "Vector 2")
*Field(fi_0, "Field 0 - Single", b_0, b_1, p_0)
*SetField(fi_0, USER, `USER(300, 1, 2)`)
*SetOrientation(fi_0, TWOAXES, XY, v_1, v_2)
*SetOrientation(fi_0, TWOAXES, XY, p_1, p_2)
*SetOrientation(fi_0, ONEAXIS, X, p_1)
*SetOrientation(fi_0, ONEAXIS, X, v_1)
*Set(fi_0.use_local_dll, TRUE)
*Set(fi_0.local_dll, "c:/mypath/my_field_dll")
*EndMDL()