Professional Documents
Culture Documents
Custom Tools
Version 11.1.1
Siemens PLM
Web:
http://www.femap.com
Customer Support
Phone:
Web:
The following copyright refers only to the bmp2raster.exe executable distributed with FEMAP:
NeuQuant Neural-Net Quantization Algorithm
Copyright (c) 1994 Anthony Dekker
NEUQUANT Neural-Net quantization algorithm by Anthony Dekker, 1994.
See "Kohonen neural networks for optimal colour quantization" in "Network: Computation in Neural Systems"
Vol. 5 (1994) pp 351-367 for a discussion of the algorithm.
See also http://members.ozemail.com.au/~dekker/NEUQUANT.HTML
Any party obtaining a copy of these files from the author, directly or indirectly, is granted, free of charge, a full and
unrestricted irrevocable, world-wide, paid up, royalty-free, nonexclusive right and license to deal in this software
and documentation files (the "Software"), including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons who receive copies from any
such party to do so, with the only requirement being that this copyright notice remain intact.
Conventions
This manual uses different fonts to highlight command names or input that you must type.
a:setup
OK, Cancel
Throughout this manual, you will see references to Windows. Windows refers to Microsoft Windows XP, Windows Vista, Windows 7, Windows 8, and Windows 8.1 (32-bit and 64-bit versions). You will need one of these
operating environments to run FEMAP for the PC. This manual assumes that you are familiar with the general use
of the operating environment. If you are not, you can refer to the Windows Users Guide for additional assistance.
Similarly, throughout the manual all references to FEMAP, refer to the latest version of our software.
Table of Contents
Proprietary and Restricted Rights Notice
Table of Contents
1. Introduction
1.2 Accessing the Custom Tools Menu .
.
.
.
.
.
.
1.3 Setting the Location of the Custom Tools Application Files .
.
1.3.1 FEMAP Preference for the Custom Tools Path .
.
.
1.4 Customizing the Custom Tools Toolbar Menu.
.
.
.
.
1.4.1 Example of Adding a Program File to the Custom Tools menu
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
1-2
1-4
1-4
1-5
1-5
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-1
2-2
2-2
2-2
2-2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3-2
3-2
3-2
3-3
3-3
3-3
3-3
3-3
3-3
3-3
3-4
3-5
3-5
3-5
3-5
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 4-1
. 4-2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 5-2
. 5-2
. 6-1
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 8-1
. 8-1
.
.
.
.
.
.
7-1
7-1
7-2
7-2
7-3
7-3
7-3
7-3
7-3
.
.
TOC-2
Table of Contents
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
8-2
8-2
8-2
8-2
8-2
8-2
8-2
8-2
8-2
8-2
8-2
9-2
. 10-1
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
11-2
11-2
11-2
11-2
11-2
11-2
12.1 Auto Boundary Faces With Poles, Auto Boundary Faces With Poles
.
.
12.2 Auto Boundary Faces With Poles, Select Auto Boundary Faces With Poles .
12.3 Combine and Mesh Surface with One Curve .
.
.
.
.
.
.
12.4 Combine and Mesh Surfaces .
.
.
.
.
.
.
.
.
.
12.5 Compression Only Gaps .
.
.
.
.
.
.
.
.
.
.
12.6 Connect Nodes on Surfaces with Rigid Elements .
.
.
.
.
.
12.7 Copy Nodes with Increment
.
.
.
.
.
.
.
.
.
.
12.8 Create Grounded CBUSH Elements .
.
.
.
.
.
.
.
.
12.9 Hole to Hole Fastener .
.
.
.
.
.
.
.
.
.
.
.
12.10 Merge All Nodes
.
.
.
.
.
.
.
.
.
.
.
.
12.11 Move Merge Nodes .
.
.
.
.
.
.
.
.
.
.
.
12.12 Multi DOF Springs from single DOF Spring .
.
.
.
.
.
.
12.13 Multi Mass Elements
.
.
.
.
.
.
.
.
.
.
.
12.14 ShowBadTetras .
.
.
.
.
.
.
.
.
.
.
.
.
12.15 Show Worst Element
.
.
.
.
.
.
.
.
.
.
.
12.16 Spider Curves .
.
.
.
.
.
.
.
.
.
.
.
.
12.17 Spider Nodes .
.
.
.
.
.
.
.
.
.
.
.
.
12.18 Spider Surfaces .
.
.
.
.
.
.
.
.
.
.
.
.
12.19 Spider
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
12-1
12-2
12-2
12-2
12-2
12-2
12-3
12-3
12-3
12-3
12-4
12-4
12-4
12-5
12-5
12-5
12-5
12-5
12-5
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
13-1
13-2
13-2
13-2
13-2
13-2
13-2
13-2
13-2
13-3
13-3
13-3
13-4
13-4
13-4
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
TOC-3
Table of Contents
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.14-1
.14-1
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.15-1
.15-2
.15-2
.15-2
.15-2
.15-2
.15-2
.15-2
.15-2
.15-2
.15-3
.15-3
.15-3
.15-3
.15-3
.15-3
.15-3
.15-3
.15-3
.15-4
.15-4
.15-4
.15-4
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.16-2
.16-2
.16-2
.16-2
.16-2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.17-2
.17-2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.18-1
.18-2
.18-2
.18-2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.19-2
.19-2
.19-2
.
.
.
.
.
TOC-4
Table of Contents
1.
Introduction
This section introduces the API scripts contained within the API folder in FEMAP.
1-2
Introduction
Introduction
1-3
The Custom Tools toolbar can also be activated or deactivated through the Tools, Toolbars command. When the Customize
dialog box is activated, click the Toolbars tab, then click the check box for the Custom Tools menu.
1-4
Introduction
Modify FEMAPs preference for the location of the Custom Tools files.
From the Custom Tools toolbar menu, select the Tools Directory command where you specify a folder where automation
files are located. Using this method will
Introduction
1-5
Select the file to copy in the Select File to Copy to Custom Tools Directory dialog box. In this case, the file is located in
the C:\Femap\Automation\Program Files folder and is titled Create Load and Constraint Set.pro. The Open button is
clicked to confirm the selection.
1-6
Introduction
When the Custom Tools menu is selected, the newly added program file has been added to this menu. Note that all files
added to the Custom Tools menu are arranged by alphabetically.
2.
2-2
2.2 AddNodesandDisplacementstoDataTable
This API .bas script populates the Data Table with the X, Y, and Z coordinates and displacements of selected nodes.
3.
3-2
3.1 AlignSolidElemCsysToSurfaceTangents
This FEMAP API .bas script creates a Csys at the centroid of the selected element(s) aligned with the selected surface U and V tangent directions at the projected element centroid. The Csys is used to create a Solid property with
its material angle aligned with the Csys.
3-3
3-4
RenumberNodesAndElements
3-5
3.12 RenumberNodesAndElements
This API .bas script renumbers all nodes and elements in the active model by the selected order and coordinate system.
3-6
4.
4.1 callback
This API .bas script checks for existence of variables (ITER, K, K1, K2, and PID) in the active FEMAP model file.
If these variables exist, an IF statement is run against K1 <= K <= K2. If the test passes and an active Analysis Set
exists in the FEMAP model, then the API script renames the active Analysis Set to the value of the callback
returned with the method App.feAppEventCallback (FEVENT_RESULTSEND, ).
4-2
4.2 Startloop
This API .bas script checks for Shell properties in the active FEMAP model file, then prompts the user to enter a
starting value for the thickness of a selected Shell property, the ending value of the thickness and the number of
iterations from the stating to the ending value.
The API uses the App.feAppEventCallback (FEVENT_RESULTSEND,path) call modifies the name of the analysis set and result set as it iterates from the Starting Thickness to the Ending Thickness.
5.
5-2
6.
6-2
7.
7-2
Resulting model with red surfaces indicating surfaces continuously tangent to the selected surface.
7-3
7.8 SliceSolidsUpdateLayersAndGroups
This FEMAP API .bas script slices a selected solid with a user-specified plane, and assigns the resulting solids to
the selected solids layer and group(s)
7-4
After selecting the from and to coordinate systems are selected and the bracket is selected, the from and the
bracket are transformed as shown below.
8.
8-2
8.9 GroupRigidIndependentNodes
This FEMAP API .bas script appends to the active group, or creates a new group of independent node(s) on rigid
element(s) in the active FEMAP model file.
8.10 GroupSurfacesWithSelectedRadius
This FEMAP API .bas script creates a group of cylindrical surfaces with a user-specified radius.
9.
9-2
Property Title
Total Face Sheet Thickness (assumes that both the top and bottom sheets are the same thickness)
Face Sheet Material - selected from a list of materials in the active FEMAP model
Core Thickness
Core Material - selected from a list of materials in the active FEMAP model
9-3
The resulting PSHELL property results as follows given the data entries in the snapshot of the dialog box:
9-4
10.
10-2
11.
11-2
12.
12.1 Auto Boundary Faces With Poles, Auto Boundary Faces With
Poles
This FEMAP API .bas script finds all surfaces with poles and applies the feBoundaryFromSurfaces method to
those surfaces.
12-2
12.2 Auto Boundary Faces With Poles, Select Auto Boundary Faces
With Poles
This FEMAP API .bas script is similar to Custom Tools, Auto Boundary Faces With Poles, Auto Boundary Faces
With Poles, except that the user selects the surfaces to check for poles.
12-3
12-4
ShowBadTetras
12-5
12.14 ShowBadTetras
This FEMAP API .bas script checks for element distortion using the API feCheckElemDistortion function for any
elements with a Jacobian at or above a value of 0.7. Any elements exceeding this limit are placed into a distorted
element group and the distorted element group is highlighted in the graphics pane.
12.19 Spider
This FEMAP API .bas script operates identically to the API script, Spider Nodes.
12-6
13.
13-2
GroupShowAllConnectedElements
13-3
13.10 GroupShowAllConnectedElements
This FEMAP API .bas script prompts the user to select a single element. All elements sharing nodes with the
selected element and adjacent elements are placed into a new group, All Mesh Connected to Elem nnn, where nnn is
the ID of the selected element. Connected elements are highlighted using the feViewShow function.
13.12 LSDyna_Time_Step_Calculator
This FEMAP API .bas script calculates the minimum time step required for a LS Dyna analysis.
13-4
13.15 ShowConnectedElems
This FEMAP API .bas script is similar to the API script, GroupShowAllConnectedElements, except it only highlights the adjacent elements, and not all the elements connected. It also does not create a group of connected elements.
14.
14-2
15.
15-2
15.6 GROUP_POST_FNO
This API .BAS script allows selection of a particular group for post-processing, then creates a new model file with
only the entities in the group (along with any entities needed to make a valid model in a new model) and attaches a
FEMAP Neutral File Output (FNO) file with the selected output.
After the group is selected, a copy of that group is made for temporary use and the Group, Operations, Add
Related Entities is run on that group (this group is later deleted by the script). This group is used to create a valid
model in the new FEMAP model. A FEMAP Neutral Output (FNO) File is then created containing the output sets
and output vectors selected using the Select Output to Export dialog box. From there, the script creates a new
model file in FEMAP with only the entities from the selected group and then attaches the FNO file to allow for
post-processing on those entities in the group.
15-3
15.18 Sum Contact Grid Point Forces, Sum AdvNonlin Contact Force
This API .bas script list the sum of contact forces on selected surfaces for the active Advanced Nonlinear Output
Set.
15.19 Sum Contact Grid Point Forces, Sum AdvNonlin Contact GPF
15-4
On Connector
This API .bas script lists the sum of contact force on selected connectors for the active Advanced Nonlinear Output
Set.
15.20 Sum Contact Grid Point Forces, Sum Contact GPF On Connector
This API .bas script lists the sum of Grid Point Forces for the nodes on selected connectors for the active Advanced
Nonlinear Output Set. Force Balance must be part of the Output Requests for the Advanced Nonlinear Analysis
Set.
Screen snapshots of the deformed model with contour plots of Solid Von Mises stress and Total Deformation for the
active Output Set.
Geometry Import Information: Solid ID, number of faces, total volume, and number of nodes and elements and the
Material ID of the mesh.
Material Information: Listing of materials used in the model organized by ID. Each materials E, , nu, and limit stress
values are also listed.
Analysis Results Information all Elements/Materials: Node ID, value of maximum deformation in the model; Node ID
and value of the maximum nodal stress in the model; and, Element ID and value of the maximum Solid Von Mises.
Analysis Results For Each Solids: Sorted by Solid ID, the Node ID and value of maximum deformation at that Node;
Node ID and the value of the maximum nodal stress at that node; and coordinates of the maximum Solid Von Mises
stress and Factor of Safety at that location.
Analysis Results For Each Solid Material: Sorted by Material ID, the Node ID and value of the maximum nodal stress at
that node; the coordinates of the maximum Von Mises stress and the value at the location; and, the minimum Factor of
Safety for the material.
16.
16-2
17.
17-2
18.
18-2
19.
19-2