readcae3d
Reads data from a given file using the 3D CAE Readers. readcae3d uses the CAE readers provided with Compose that require access to model information, such as corner data, averaging method, layer and coordinate system.
Syntax
readcae3d(filename, datatype, request, component, time, cornerdata, coordsys, averaging, layer)
readcae3d(filename, subcase, datatype, request, component, time, cornerdata, coordsys, averaging, layer)
readcae3d(filename, datatype, request, component, time, [], [], [], [])
readcae3d(filename, subcase, datatype, request, component, time, [], [], [], [])
R = readcae3d(filename, subcase, datatype, request, component, time, outputType)
Inputs
- filename
- Path of the file.
- subcase
- Subcase name or index in the file.
- datatype
- Type name or index in the file.
- request
- Request name or index, list of indices, list of names, or range of indices.
- component
- Component name or index, list of indices, list of names, or range of indices.
- time
- Time name or index, list of indices, list of names, or range of indices.
- cornerdata
- Flag to enable corner data or not, with values true or false (default). [] uses the default value.
- coordsys
- Coordinate system from where the results will be extracted, with values 'global' (default), 'analysis' or 'elemental'. [] uses the default value.
- averaging
- Averaging method, with values 'none' (default), 'simple', 'maximum', 'minimum', 'summation' and 'extreme'. [] uses the default value.
- layer
- Layer of the result (if applicable), with values 'max' (default), 'min', 'extreme', 'sum', 'average', 'range', 'count', 'maxlayer', 'minlayer', 'top' and 'bottom'. [] uses the default value.
Outputs
- R
- Output in matrix format. The first dimension of the matrix stores the requests, the second dimension stores the different components and the third dimension stores the different time steps.
Example 1
Example with default arguments to query all components from all requests from the 1st subcase and the 1st type:
readcae3d('tutorials/Comp-plate-1LC.h3d',1,1,[],[],[],[],[],[],[])
ans =
slice(:, :, 1) =
1.41119 -29.42254 63.96678 70.42319
1.40949 -19.27447 42.20516 46.41947
1.40967 -19.24108 42.13372 46.34066
1.40985 -19.20770 42.06228 46.26185
1.41003 -19.17431 41.99084 46.18304
1.41021 -19.14092 41.91941 46.10423
1.41040 -19.10754 41.84797 46.02542
1.41059 -19.07415 41.77653 45.94662
1.41076 -19.04077 41.70510 45.86782
1.41095 -19.00738 41.63366 45.78901
(...)
Example with default arguments to query component 'X' from all requests from the the subcase 'Subcase 1 (LC-Tens)', type 'Displacement', using the analysis coordinate system:
readcae3d('tutorials/Comp-plate-1LC.h3d','Subcase 1 (LC-Tens)','Displacement',[],'X',[],[],'analysis',[],[])
ans =
slice(:, :, 1) =
1.41119
1.40949
1.40967
1.40985
1.41003
1.41021
1.41040
(...)
Example with default arguments to query component all components from the 1st request from the the subcase 'Subcase 1 (LC-Tens)', type 'Displacement', using simple averaging method:
readcae3d('tutorials/Comp-plate-1LC.h3d','Subcase 1 (LC-Tens)','Displacement',1,[],[],[],[],'simple',[])
ans =
slice(:, :, 1) =
1.41119 -29.42254 63.96678 70.42319
Example with default arguments to query component all components from the 1st request from the the subcase 'Subcase 1 (LC-Tens)', type 'Displacement', enabling corner data, which is not applicable for scalars:
readcae3d('tutorials/Comp-plate-1LC.h3d','Subcase 1 (LC-Tens)','Displacement',1,[],[],true,[],[],[])
Warning: corner data is not applicable for vectors and scalars and will be ignored
ans =
slice(:, :, 1) =
1.41119 -29.42254 63.96678 70.42319
Comments
The result files coming from the following simulations are not supported yet: - Multibody Simulation - RADIOSS - abstat
Coordinate system is not applicable for scalars and is ignored with a user warning.
Averaging method is not applicable for vectors and is ignored with a user warning.
Layer is not applicable for vectors and is ignored with a user warning.
Corner data is not applicable for scalars.