*compositeanalysis

Analyzes composite materials, plies, sequences, laminates, or elements.

Syntax

*compositeanalysis entity_type <select_type>=<selection> result=<value> output=<value> ?ffunc=<value>? ?loadid=<value>? ?loadcase=<value>? ?theta=<value>?

Type

HyperMesh Tcl Modify Command

Description

Analyzes composite materials, plies, sequences, laminates, or elements.

Inputs

entity_type
The type of entity to modify.
<select_type>=<selection>
The entity or entities that are to be analyzed. There are several ways to provide the entities to be modified. Only one option can be used at a time:
id=<id>
The ID of the single entity to modify.
name=<name>
The name of the single entity to modify.
mark=<mark_id>
The ID of the mark containing the entities to modify.
result=<value>
The type of result. Valid values are:
  • eng-const - For engineering constant analysis of material, ply, laminate, sequence, or element.
  • load-response - For load response/first ply failure analysis of laminate, sequence, or element.
  • strength - For strength analysis of laminate, sequence, or element.
output=<value>
Specifies where the analysis result is stored. If value begins with a double colon, the result will be stored in a Tcl variable. Otherwise, the parameter is considered as a file name.
ffuncid=<value>
The design point method ID. Selected entity must have First_Ply_Failure defined as the method. Optional argument used in strength and FPF analysis.
loadid=<value>
The list of load entity IDs. Selected load entities must have “Composite plate” defined as the engineering type. Optional argument used in load response and FPF analysis.
loadcase=<value>
The list of strings identifying imported result, subcase, and simulation used as load. Optional argument used in load response and FPF analysis when analyzing elements.
theta=<value>
Optional argument to define the angle of analysis. Value can be given as a single number, or as range defined as list with a format {<from>, <to>, <step>}. Numbers can be given as integers or reals. Default value is 0.

Examples

To analyze material with ID 1:
*compositeanalysis mats id=1 result=eng-const output=C:/temp/result.txt
To analyze material with theta range:
*compositeanalysis mats id=1 result=eng-const theta={0,90,1} output=C:/temp/result.txt

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

2020.1

2021.2 - Added new optional arguments ffunc and loadid. Changed the valid values for the result argument.

2022.1 - Added new optional argument loadcase and added new supported entity type elements.

2023.1 - Added new optional argument theta.