Both sides previous revision
Previous revision
Next revision
|
Previous revision
Next revision
Both sides next revision
|
full_syntax [2021/04/20 22:34] marijn.nijenhuis [5. Optional] |
full_syntax [2021/04/20 22:44] marijn.nijenhuis [Output Arguments] |
| |
**Boundary conditions:** | **Boundary conditions:** |
| {{tablelayout?colwidth="100px,100px,-"}} |
^ Field ^ Value ^ Description ^ | ^ Field ^ Value ^ Description ^ |
| ''fix'' | ''true'' | Fix both the position and orientation of the node. | | | ''fix'' | ''true'' | Fix both the position and orientation of the node. | |
| |
**Inertia:** | **Inertia:** |
| {{tablelayout?colwidth="100px,100px,-"}} |
^ Field ^ Value ^ Description ^ | ^ Field ^ Value ^ Description ^ |
| ''mass'' | double | Point mass (in unit kg) assigned to node. | | | ''mass'' | double | Point mass (in unit kg) assigned to node. | |
| |
**Prescribed input displacement:** | **Prescribed input displacement:** |
| {{tablelayout?colwidth="140px,80px,-"}} |
^ Field ^ Value ^ Description ^ | ^ Field ^ Value ^ Description ^ |
| ''displ_x'' | double | Prescribed displacement (in unit m) in ''x''-direction. Value is the target ''x''-coordinate of the node position (in global frame). | | | ''displ_x'' | double | Prescribed displacement (in unit m) in ''x''-direction. Value is the target ''x''-coordinate of the node position (in global frame). | |
| |
**Prescribed rotation:** | **Prescribed rotation:** |
| {{tablelayout?colwidth="110px,100px,-"}} |
^ Field ^ Value ^ Description ^ | ^ Field ^ Value ^ Description ^ |
| ''rot'' | 1x4 vector | Prescribed rotation. Values represent the target orientation of the node in 3-D space, according to the [[https://en.wikipedia.org/wiki/Rotation_formalisms_in_three_dimensions#Euler_axis_and_angle_.28rotation_vector.29|axis-angle notation]]. The first value represents the rotation angle (in radians) and the second to fourth values the normalized axis of rotation, all with respect to the global frame. Note that this input complete defines and constrains the orientation of the node, i.e. no other simultaneous rotations of the node are possible. | | | ''rot'' | 1x4 vector | Prescribed rotation. Values represent the target orientation of the node in 3-D space, according to the [[https://en.wikipedia.org/wiki/Rotation_formalisms_in_three_dimensions#Euler_axis_and_angle_.28rotation_vector.29|axis-angle notation]]. The first value represents the rotation angle (in radians) and the second to fourth values the normalized axis of rotation, all with respect to the global frame. Note that this input complete defines and constrains the orientation of the node, i.e. no other simultaneous rotations of the node are possible. | |
| |
**Applied loads:** | **Applied loads:** |
| {{tablelayout?colwidth="140px,100px,-"}} |
^ Field ^ Value ^ Description ^ | ^ Field ^ Value ^ Description ^ |
| ''force'' | 1x3 vector | Force applied to node. Values represent the force components (in unit N) in the ''x''-, ''y''-, and ''z''-direction. | | | ''force'' | 1x3 vector | Force applied to node. Values represent the force components (in unit N) in the ''x''-, ''y''-, and ''z''-direction. | |
| |
**State-space representation:** | **State-space representation:** |
| {{tablelayout?colwidth="120px,100px,-"}} |
^ Field ^ Value ^ Description ^ | ^ Field ^ Value ^ Description ^ |
| ''transfer_in'' | '''force_x''' | Force input in ''x''-direction on node for state-space equations. See ''opt.transfer''. | | | ''transfer_in'' | '''force_x''' | Force input in ''x''-direction on node for state-space equations. See ''opt.transfer''. | |
| |
The same holds for prescribing //standard// displacement (''displ_{x,y,z}''), //initial// displacement (''displ_initial_{x,y,z}''), //standard// rotation (''rot'') and //initial// rotation (''rot_initial''). | The same holds for prescribing //standard// displacement (''displ_{x,y,z}''), //initial// displacement (''displ_initial_{x,y,z}''), //standard// rotation (''rot'') and //initial// rotation (''rot_initial''). |
| |
==== 4. Element properties ==== | ==== 4. Element properties ==== |
| |
The usage is ''eprops(i).field = value;'' to assign property ''field'' with value ''value'' to set ''i''. The following list contains an overview of all possible fields. | The usage is ''eprops(i).field = value;'' to assign property ''field'' with value ''value'' to set ''i''. The following list contains an overview of all possible fields. |
| |
| {{tablelayout?colwidth="100px,100px,-"}} |
^ Field ^ Value ^ Description ^ | ^ Field ^ Value ^ Description ^ |
| ''elems'' (required) | 1×n vector | Numbers of elements to which the properties apply.| | | ''elems'' (required) | 1×n vector | Numbers of elements to which the properties apply.| |
| |
**Material constants**: | **Material constants**: |
| {{tablelayout?colwidth="100px,100px,-"}} |
^ Field ^ Value ^ Description ^ | ^ Field ^ Value ^ Description ^ |
| ''emod''<sup>*1</sup> | double | Young's modulus (in unit Pa). | | | ''emod''<sup>*1</sup> | double | Young's modulus (in unit Pa). | |
| |
**Geometry and dimensions**: | **Geometry and dimensions**: |
| {{tablelayout?colwidth="100px,100px,-"}} |
^ Field ^ Value ^ Description ^ | ^ Field ^ Value ^ Description ^ |
| ''cshape''<sup>*1,2</sup> | '''rect''' | Rectangular cross-sectional shape. Requires ''dim'' and ''orien'' field. | | | ''cshape''<sup>*1,2</sup> | '''rect''' | Rectangular cross-sectional shape. Requires ''dim'' and ''orien'' field. | |
| |
**Visual appearance** (these properties only affect the visualization, not the simulation): | **Visual appearance** (these properties only affect the visualization, not the simulation): |
| {{tablelayout?colwidth="100px,100px,-"}} |
^ Field ^ Value ^ Description ^ | ^ Field ^ Value ^ Description ^ |
| ''color'' | 1x3 vector| Color of element. Values represent rgb color values between 0 and 1, or between 0 and 255. If any of the values specified are larger than 1, the 0-255 map is used. Otherwise, the 0-1 map is used. | | | ''color'' | 1x3 vector| Color of element. Values represent rgb color values between 0 and 1, or between 0 and 255. If any of the values specified are larger than 1, the 0-255 map is used. Otherwise, the 0-1 map is used. | |
In the fields of the ''out'' structure (unless otherwise noted), each //column// contains data for a certain load step. The following list describes what those columns represent. (The total number of load steps is n<sub>s</sub>.) | In the fields of the ''out'' structure (unless otherwise noted), each //column// contains data for a certain load step. The following list describes what those columns represent. (The total number of load steps is n<sub>s</sub>.) |
| |
{{tablelayout?colwidth="-,-,140px,-"}} | {{tablelayout?colwidth="-,140px,140px,-"}} |
^ Field ^^ Value ^ Description of column representation ^ | ^ Field ^^ Value ^ Description of column representation ^ |
| ''stressmax'' || 1×n<sub>s</sub> vector | Maximum stress in the system (in unit Pa). | | | ''stressmax'' || 1×n<sub>s</sub> vector | Maximum stress in the system (in unit Pa). | |
| | ''.CMglob'' | 6x6×n<sub>s</sub> matrix| Compliance matrix of node ''i'' in global frame (fixed frame). This is an array of three dimensions. The load step varies along the third dimension. | | | | ''.CMglob'' | 6x6×n<sub>s</sub> matrix| Compliance matrix of node ''i'' in global frame (fixed frame). This is an array of three dimensions. The load step varies along the third dimension. | |
| | ''.CMloc'' | 6x6×n<sub>s</sub> matrix| Compliance matrix of node ''i'' in local frame (co-rotational with node). This is an array of three dimensions. The load step varies along the third dimension. | | | | ''.CMloc'' | 6x6×n<sub>s</sub> matrix| Compliance matrix of node ''i'' in local frame (co-rotational with node). This is an array of three dimensions. The load step varies along the third dimension. | |
| ''statespace'' || state-space object | State-space representation of the system. This is only calculated when ''opt.transfer'' is used. | | | ''statespace'' || state-space object | State-space representation of the system. This is only calculated when ''opt.transfer'' is used. Requires the ''ss'' command in MATLAB (see ''doc ss''), e.g. from the Control System Toolbox.| |
| ''version'' || string | SPACAR Light version number. | | | ''version'' || string | SPACAR Light version number. | |
| ''ndof'' || integer | Number of degrees of freedom. | | | ''ndof'' || integer | Number of degrees of freedom. | |