Both sides previous revision
Previous revision
Next revision
|
Previous revision
|
full_syntax [2021/04/20 22:42] marijn.nijenhuis [3. Node properties] |
full_syntax [2023/11/09 22:27] (current) marijn.nijenhuis [5. Optional] |
''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. | |