This option transfers the BETA angles stored on the *ELEMENT SHELL BETA card to the *ELEMENT SHELL COMPOSITE (LONG) card with user-definitions. Moreover, it can be also used to map reinforcing unidirectional tailored fiber placement (TFP) patches on top of existing mesoscale or macroscale composite models. Only the LS-DYNA format is supported.
Contact your Envyo application distributor if further features are required.
This section covers:
- 4.15.1. Main Mapping Command
- 4.15.2. Input and Output Meshes for Standard BETA Angle Transfer
- 4.15.3. Input and Output Meshes for TFP Reinforcing Patch Handling
- 4.15.4. Reinforcing Patch Declarations for TFP Reinforcing Patch Handling
- 4.15.5. Target Part IDs and Source Part IDs for Standard BETA Angle Transfer
- 4.15.6. Transformation Options
- 4.15.7. Mapping Options
- 4.15.8. Specific Mapping Options for Reinforcing Patch Handling
| SourceFile = STRING | Defines the name and, if needed, the path of the source file (usually
a *.dynain file). |
| TargetFile = STRING | Defines the name and, if needed, the path of the target file. The target file must be an LS-DYNA application mesh. |
| MappingResult = STRING | Defines the result file name. The mapping result is written into this newly generated file. |
| OrientationFile = BETA |
Tells Envyo that the orientation information is stored as (BETA). |
| TransformedMeshFile = STRING | Specifies the file name where the transformed mesh is written. This option is intended solely for the transformation's postprocessing. For additional details, refer to the Transformation Options section below. |
| SourceFile = STRING | Defines the source file's name. If needed, also defines either the undeformed mesh file's path that has reinforcing patch EIDs, or the deformed target mesh file's path. Refer to the BYPASS UNFOLDED option to define the correct mesh file. If REVERSE DRAPING=NO is defined, the source and target file must be the same mesh file. |
| TargetFile = STRING |
Defines the target file's name. If needed and REVERSE DRAPING = NO is defined, also defines either the undeformed target file's path or deformed target mesh file. The mesh must be an LS-DYNA mesh. |
| MappingResult = STRING | Defines the result file's name. The mapping result is written to this generated file. |
| FoldedSourceFile = STRING | Defines the folded (deformed) mesh file's name, which is used in an optimization simulation to generate reinforcing patches. If REVERSE DRAPING = NO is defined, then the folded source file is not required. |
| TransformedMeshFile = STRING | Defines the transformed mesh's file name. This option is for the transformation's post-processing only. For further information, see the Transformation Options below. |
| NUMPATCHES = INT |
Defines the number of reinforcing patches. |
|
REINFORCEPATCH#i = STRING; INT; DOUBLE; DOUBLE |
Defines as many patches as given in NUMPATCHES. The following must be declared with this option:
|
The options below are not required for reinforcing TFP patch handling routine.
| NumTargetPIDs = INT |
Defines the number of parts in the target mesh which are considered within the mapping. This option must be followed by TargetPID#i definitions. |
| TargetPID#i = INT | Defines as many part IDs as given in NumTargetPIDs. These parts are considered for the mapping. |
| NumSourcePIDs = INT | Defines the number of parts in the source mesh which are considered within the mapping. This option must be followed by SourcePID#i definitions. |
|
SourcePID#i = INT; INT; DOUBLE; INT |
Defines as many part IDs as given in NumSourcePIDs. These parts are considered for the mapping. PID;MID;THICKNESS;PLYID PID-based ply properties of the source meshes must be defined with source PIDs from bottom to top to match the target element normal direction. Seperate the information with a semicolon. PlyID is not mandatory, and if not declared, respective source PID is used as PlyID in ... COMPOSITE LONG output. |
Note: The above options narrows the scope of the mapping process to defined part IDs. Other parts are ignored on both source and target side.
|
TRANSFORMATION = YES NO |
Turns on or off the transformation option. |
|
WriteTransformedMesh = YES NO |
Flag to output the transformed mesh to use for mapping. This enables control of the transformation's success. If this option is equal to YES, you must define a TransformedMeshFile (see Input and Output Meshes for TFP Reinforcing Patch Handling). |
There are three available methods for performing mesh transformation:
TRAFO_OPTION is required:
Iterative Closest Point (ICP)
Four-Points-Congruent Sets (4PCS)
TRAFO_OPTION is not required:
User-defined translation and rotation
Use the 4PCS method with caution, since it is fully automatic and may not accurately transform stress tensors and fiber orientations between the different coordinate systems. The ICP algorithm is the recommended approach.
The user-defined translation and rotation options are listed underneath TRAFO_OPTION.
Note: Transformation options are used to transform the source mesh.
|
TRAFO_OPTION = 4PCS ICP | Flag for choosing a transformation option. |
| NodalPair#i = INT INT |
Defines nodal pairs for initial mesh alignment for ICP algorithm. A minimum of three nodal pairs must be defined, and the maximum definition for this option is ten nodal pairs. The first integer refers to a node ID in the source mesh, and the second integer refers to a node ID in the target mesh. These intergers must be separated with spaces, and defined nodal pairs must be on seperate lines. |
| MAX_NUM_ITER = INT | Maximum number of iterations to be performed by the 4PCS algorithm. |
| GLOBAL_ERR = DOUBLE | Global error messure to accept transformation as best fit 4PCS algorithm. |
|
MATCHING_POINT_DIST = DOUBLE | Maximum distance between points so that they are accepted as matching (4PCS). |
|
PERCENTAGE_OF_MATCHING_POINTS = DOUBLE | Percentage of matching points to accept the transformation (4PCS). |
Additionally, a custom sequence of user-defined transformations can be applied. These transformations are executed in the order in which they are specified and multiple transformations may be defined.
|
RotateSRC = DOUBLE;X DOUBLE;Y DOUBLE;Z DOUBLE; DOUBLE DOUBLE DOUBLE | The source mesh rotates by a specified angle (first value, in degrees) around a defined axis. Predefined axes include X, Y, and Z. Alternatively, a custom axis can be specified by providing three space-separated floating-point values following a semicolon (; x y z). |
| MoveSRC = DOUBLE DOUBLE DOUBLE | The source mesh moves along the user-defined vector (x y z). |
| ScaleSRC = DOUBLE | The source mesh scales around the origin using the defined scale factor. |
In addition to the transformation options, you can convert the unit systems:
|
ChangeUnitSystem = YES NO | Activates or deactivates unit system conversion. |
|
SourceUnitSystem = kg − m − s ton − mm − s kg − mm − ms g − mm − ms lb − in − s | If unit system conversion is actived, provides information about the source unit system. |
|
TargetUnitSystem = kg − m − s ton − mm − s kg − mm − ms g − mm − ms lb − in − s | If unit system conversion is activated, provides information about the target unit system. |
| Algorithm = PointProjection | This is the only available option. |
| Shell_Option = Composite Composite Long | Output format for *ELEMENT SHELL ... |
|
Offset Option = FlatUpper FlatLower | Indicates the surface to align all elements of *ELEMENT SHELL ... This option uses the same syntax as LS-PrePost. |
|
Search_Radius = SrcEleLen TarEleLen DOUBLE | Declares search radius for the mapping algorithm. SrcEleLen is default, which uses average source mesh element size as the search radius. To use average target mesh element size instead, define either TarEleLen or a positive DOUBLE value. |
| Scale_SearchRadius= DOUBLE | Coefficient to scale search buckets in bucket search algorithm. |
|
Master Side = Source Target |
Defines master side for the point projection algorithm. The master side element normal is used as the projection vector. |
| Projection Tolerance = DOUBLE |
Normalized distance comparison coefficient (≥ 1) to accept the found source mesh data, if it is satisfied. |
| Overlapping Layers = YES/NO | Defines if the overlapping layers are included in the mapping process. |
| Overlap Coefficient = DOUBLE | Regularizes the coefficient for overlapping. The default value is 0.52. |
| SORT = BUCKET | Use bucket sort to significantly speed up the search algorithm. |
| REPEAT = YES | Turn on this option so that all elements and integration points receive data. This flag must be defined if bucket refinement is too small for all points to receive values due to the element size differences of the source and target meshes. |
| TargetMaterialModel= 249 |
Target mesh material model number. The fiber directions are stored according to IHIS=1 option, if the option is defined. SHELL OPTION=COMPOSITE must be defined to utilize this option in full capacity. More information about the material model can be found in [20]. |
|
REINFORCING PATCH= YES NO | Activates the reinforcing patch handling routines. |
|
REVERSE DRAPING= YES NO | Activates the reverse draping routines. If set to YES, FoldedSourceFile must be defined. |
|
BYPASS UNFOLDED= YES NO | Indicates the source file condition. If this option is YES, the deformed target mesh file. |
|
PATCHGLOBALZERODIRECTION = X Y Z x y z |
Defines the global zero direction to assign reinforcing patch directions. You can use the pre-defined X, Y, and Z vector declarations or custom vector components that start from the origin. |