result:contact status

Version: 0.0.0

Description

Read/compute element contact status by calling the readers defined by the datasources.

• The 'requested_location' and 'mesh_scoping' inputs are processed to see if they need scoping transposition or result averaging. The resulting output fields have a 'Nodal', 'ElementalNodal' or 'Elemental' location.
• Once the need for averaging has been detected, the behavior of the combined connection of the 'split_shells' and 'shell_layer' pins is:

Averaging is needed	'split_shells'	'shell_layer'	Expected output
No	Not connected/false	Not connected	Location as in the result file. Fields with all element shapes combined. All shell layers present.
No	true	Not connected	Location as in the result file. Fields split according to element shapes. All shell layers present.
No	true	Connected	Location as in the result file. Fields split according to element shapes. Only the requested shell layer present.
No	Not connected/false	Connected	Location as in the result file. Fields with all element shapes combined. Only the requested shell layer present.
Yes	Not connected/true	Not connected	Location as requested. Fields split according to element shapes. All shell layers present.
Yes	false	Not connected	Location as requested. Fields with all element shapes combined. All shell layers present.
Yes	false	Connected	Location as requested. Fields with all element shapes combined. Only the requested shell layer present.
Yes	Not connected/true	Connected	Location as requested. Fields split according to element shapes. Only the requested shell layer present.

• The available 'elshape' values are:

elshape	Related elements
1	Shell (generic)
2	Solid
3	Beam
4	Skin
5	Contact
6	Load
7	Point
8	Shell with 1 result across thickness (membrane)
9	Shell with 2 results across thickness (top/bottom)
10	Shell with 3 results across thickness (top/bottom/mid)
11	Gasket
12	Multi-Point Constraint
13	Pretension

Inputs

Input	Name	Expected type(s)	Description
Pin 0	time_scoping	scoping, int32, vector<int32>, double, field, vector<double>	time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.
Pin 1	mesh_scoping	scopings_container, scoping	nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains
Pin 2	fields_container	fields_container	Fields container already allocated modified inplace
Pin 3	streams_container	streams_container	result file container allowed to be kept open to cache data
Pin 4 Required	data_sources	data_sources	result file path container, used if no streams are set
Pin 5	bool_rotate_to_global	bool	if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.
Pin 7	mesh	abstract_meshed_region, meshes_container	mesh. If cylic expansion is to be done, mesh of the base sector
Pin 9	requested_location	string	requested location Nodal, Elemental or ElementalNodal
Pin 14	read_cyclic	enum dataProcessing::ECyclicReading, int32	if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)
Pin 15	expanded_meshed_region	abstract_meshed_region, meshes_container	mesh expanded, use if cyclic expansion is to be done.
Pin 18	sectors_to_expand	vector<int32>, scoping, scopings_container	sectors to expand (start at 0), for multistage: use scopings container with 'stage' label, use if cyclic expansion is to be done.
Pin 19	phi	double	angle phi in degrees (default value 0.0), use if cyclic expansion is to be done.
Pin 22	read_beams	bool	elemental nodal beam results are read if this pin is set to true (default is false)
Pin 26	split_shells	bool	If true, this pin forces the results to be split by element shape, indicated by the presence of the 'elshape' label in the output. If false, the results for all elements shapes are combined. Default value is false if averaging is not required and true if averaging is required.
Pin 27	shell_layer	int32	If connected, this pin allows you to extract the result only on the selected shell layer(s). The available values are: 0: Top, 1: Bottom, 2: TopBottom, 3: Mid, 4: TopBottomMid.
Pin 28	extend_to_mid_nodes	bool	Compute mid nodes (when available) by averaging the neighbour corner nodes. Default: True

Outputs

Output	Name	Expected type(s)	Description
Pin 0	fields_container	fields_container

Configurations

Name	Expected type(s)	Default value	Description
mutex	bool	false	If this option is set to true, the shared memory is prevented from being simultaneously accessed by multiple threads.
num_threads	int32	0	Number of threads to use to run in parallel
run_in_parallel	bool	true	Loops are allowed to run in parallel if the value of this config is set to true.

Scripting

Category: result

Plugin: core

Scripting name: contact_status

Full name: result.contact_status

Internal name: ECT_STAT

License: None

Changelog

• Version 0.0.0: Initial release.