| Both sides previous revision
Previous revision
Next revision
|
Previous revision
|
full_syntax [2021/04/20 22:37]
marijn.nijenhuis [Output Arguments] |
full_syntax [2023/11/09 22:27] (current)
marijn.nijenhuis [5. Optional] |
| |
| **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. | |
| ''opt'' is a structure array for //specifying optional input//. The usage is ''opt.field = value;'' to assign value ''value'' to property ''field'' . The following list contains an overview of all possible fields. | ''opt'' is a structure array for //specifying optional input//. The usage is ''opt.field = value;'' to assign value ''value'' to property ''field'' . The following list contains an overview of all possible fields. |
| |
| {{tablelayout?colwidth="140px,240px,-"}} | {{tablelayout?colwidth="160px,240px,-"}} |
| ^ Field ^ Value ^ Description ^ | ^ Field ^ Value ^ Description ^ |
| | ''filename'' | string | Filename of the data files involved in the SPACAR simulation. If omitted, filenname 'spacar_file' is used. | | | ''filename'' | string | Filename of the data files involved in the SPACAR simulation. If omitted, filenname 'spacar_file' is used. | |
| | ''transfer'' | ''true'' | Calculation of state-space equations. Requires specification of at least one input and one output, by means of ''nprops(i).transfer_in'' and ''nprops(i).transfer_out''. Cannot be used with applied forces, applied moments, prescribed displacements, and buckling load multipliers. | | | ''transfer'' | ''true'' | Calculation of state-space equations. Requires specification of at least one input and one output, by means of ''nprops(i).transfer_in'' and ''nprops(i).transfer_out''. Cannot be used with applied forces, applied moments, prescribed displacements, and buckling load multipliers. | |
| | ::: | 1×2 cell | Calculation of state-space equations that include relative damping for all modes of the system. (This value only affects the output in ''out.statespace''; the eigenfrequency output in ''out.freq'' and Spavisual remain undamped.) For example: ''opt.transfer = {true 0.01}'' calculates state-space equations with relative damping 0.01. | | | ::: | 1×2 cell | Calculation of state-space equations that include relative damping for all modes of the system. (This value only affects the output in ''out.statespace''; the eigenfrequency output in ''out.freq'' and Spavisual remain undamped.) For example: ''opt.transfer = {true 0.01}'' calculates state-space equations with relative damping 0.01. | |
| |''customvis''| ''{'modeshape','maximum 20'}'' | The maximum number of mode shapes, in this case 20, that are shown in the Spavisual window. If omitted, the default value of 10 is used. | | | ''customvis'' | ''{'modeshape','maximum 20'}'' | The maximum number of mode shapes, in this case 20, that are shown in the Spavisual window. If omitted, the default value of 10 is used. | |
| | | ''spavisual'' | ''false'' | Do not show the Spavisual window after a simulation. | |
| | | ''rigidstress'' | ''true'' | Consider the stress in rigid elements when computing the maximum Von Mises stress in ''opt.stressmax''. By default, this option is false and stress in rigid elements is ignored. | |
| | | ''stressperelement'' | ''true'' | Compute the maximum Von Mises stress per element, stored in ''out.step(i).element(j).stressmax'' for element ''j'' at step ''i''. | |
| ===== Output Arguments ===== | ===== Output Arguments ===== |
| |
| {{tablelayout?colwidth="-,140px,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). By default, only nonrigid elements are considered. See ''opt.rigidstress''. | |
| | ''freq'' || n<sub>ndof</sub>×n<sub>s</sub> matrix| Natural frequencies of the system (in unit Hz). Values are sorted from low to high. | | | ''freq'' || n<sub>ndof</sub>×n<sub>s</sub> matrix| Natural frequencies of the system (in unit Hz). Values are sorted from low to high. | |
| | ''buck'' || n<sub>ndof</sub>×n<sub>s</sub> matrix| Buckling load multipliers of the system. Values are sorted from low to high. Note: load multipliers are only calculated if ''opt.calcbuck = true''.| | | ''buck'' || n<sub>ndof</sub>×n<sub>s</sub> matrix| Buckling load multipliers of the system. Values are sorted from low to high. Note: load multipliers are only calculated if ''opt.calcbuck = true''.| |
| | | ''.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. | |
