| Both sides previous revision
Previous revision
Next revision
|
Previous revision
Next revision
Both sides next revision
|
full_syntax [2020/06/05 18:25]
marijn.nijenhuis [5. Optional] |
full_syntax [2021/04/20 22:39]
marijn.nijenhuis [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="120px,240px,-"}} | {{tablelayout?colwidth="140px,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. | |
| | ''silent'' | ''true'' | Activation of 'silent' mode of SPACAR Light. In the silent mode, the input arguments (''nodes'', ''elements'', ''nprops'', ''eprops'', ''rls'') are not validated and not checked for errors (improving speed). Also, visualization after simulation is turned off. This feature can be useful when e.g. running a lot of SPACAR Light simulations in an optimization or iteration loop. | | | ''silent'' | ''true'' | Activation of 'silent' mode of SPACAR Light. In the silent mode, the input arguments (''nodes'', ''elements'', ''nprops'', ''eprops'', ''rls'') are not validated and not checked for errors (improving speed). Also, visualization after simulation is turned off. This feature can be useful when e.g. running a lot of SPACAR Light simulations in an optimization or iteration loop. | |
| | ''calcbuck'' | ''true'' | Calculation of buckling loads. Multipliers with respect to the combined applied load are returned. It is recommended to only apply a single force or moment to the system. Whenever input displacements or rotations are used, the multipliers are also with respect to the equivalent reaction loads. Note that the loads ''nprops(i).force'' and ''nprops(i).moment'' are applied in (linearly increasing) steps: they only reach the user-specified value at the last step. The multipliers are calculated with respect to the current load at each of these steps. | | | ''calcbuck'' | ''true'' | Calculation of buckling loads. Multipliers with respect to the combined applied load are returned. It is recommended to only apply a single force or moment to the system. Whenever input displacements or rotations are used, the multipliers are also with respect to the equivalent reaction loads. Note that the loads ''nprops(i).force'' and ''nprops(i).moment'' are applied in (linearly increasing) steps: they only reach the user-specified value at the last step. The multipliers are calculated with respect to the current load at each of these steps. | |
| | ''calccompl'' | ''false'' | Disable calculation of compliance matrices of the nodes.| | | ''calccompl'' | ''false'' | Disable calculation of compliance matrices of the nodes (may improve calculation time).| |
| | ''gravity'' | 1x3 vector | Loads due to gravity. Values represent the components of the gravitational acceleration in ''x''-, ''y''-, and ''z''-direction (in unit m/s<sup>2</sup>). For example: ''[0 0 -9.81]''. | | | ''gravity'' | 1x3 vector | Loads due to gravity. Values represent the components of the gravitational acceleration in ''x''-, ''y''-, and ''z''-direction (in unit m/s<sup>2</sup>). For example: ''[0 0 -9.81]''. | |
| | ''loadsteps'' | integer | Number of load steps used in the simulation and visualization. If not specified, the default number of 10 load steps is used. For creating smooth plots and visualizations, you may want to increase this number. For optimization purposes, you may want to reduce this number to increase computational speed. For well-conditioned problems, a single load step is still feasible. For ill-conditioned problems (involving large loads, large prescribed displacements, or buckling ), a larger number of load steps is required for the simulation to converge. | | | ''loadsteps'' | integer | Number of load steps used in the simulation and visualization. If not specified, the default number of 10 load steps is used. For creating smooth plots and visualizations, you may want to increase this number. For optimization purposes, you may want to reduce this number to increase computational speed. For well-conditioned problems, a single load step is still feasible. For ill-conditioned problems (involving large loads, large prescribed displacements, or buckling ), a larger number of load steps is required for the simulation to converge. | |
| 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,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). | |
