ANSYS ACT Customization Guide for

DesignModeler

ANSYS, Inc. Release 19.0

Southpointe January 2018
2600 ANSYS Drive
Canonsburg, PA 15317 ANSYS, Inc. and
[email protected] ANSYS Europe,
Ltd. are UL
http://www.ansys.com registered ISO
(T) 724-746-3304 9001: 2008
(F) 724-514-9494 companies.
Copyright and Trademark Information

© 2017 ANSYS, Inc. Unauthorized use, distribution or duplication is prohibited.

ANSYS, ANSYS Workbench, AUTODYN, CFX, FLUENT and any and all ANSYS, Inc. brand, product, service and feature
names, logos and slogans are registered trademarks or trademarks of ANSYS, Inc. or its subsidiaries located in the
United States or other countries. ICEM CFD is a trademark used by ANSYS, Inc. under license. CFX is a trademark
of Sony Corporation in Japan. All other brand, product, service and feature names or trademarks are the property
of their respective owners. FLEXlm and FLEXnet are trademarks of Flexera Software LLC.

Disclaimer Notice

THIS ANSYS SOFTWARE PRODUCT AND PROGRAM DOCUMENTATION INCLUDE TRADE SECRETS AND ARE CONFID-
ENTIAL AND PROPRIETARY PRODUCTS OF ANSYS, INC., ITS SUBSIDIARIES, OR LICENSORS. The software products
and documentation are furnished by ANSYS, Inc., its subsidiaries, or affiliates under a software license agreement
that contains provisions concerning non-disclosure, copying, length and nature of use, compliance with exporting
laws, warranties, disclaimers, limitations of liability, and remedies, and other provisions. The software products
and documentation may be used, disclosed, transferred, or copied only in accordance with the terms and conditions
of that software license agreement.

ANSYS, Inc. and ANSYS Europe, Ltd. are UL registered ISO 9001: 2008 companies.

U.S. Government Rights

For U.S. Government users, except as specifically granted by the ANSYS, Inc. software license agreement, the use,
duplication, or disclosure by the United States Government is subject to restrictions stated in the ANSYS, Inc.
software license agreement and FAR 12.212 (for non-DOD licenses).

Third-Party Software

See the legal information in the product help files for the complete Legal Notice for ANSYS proprietary software
and third-party software. If you are unable to access the Legal Notice, contact ANSYS, Inc.

Published in the U.S.A.

Table of Contents
Introduction ............................................................................................................................................... 1
Debug Mode .......................................................................................................................................... 1
DesignModeler APIs ................................................................................................................................... 3
Using the Selection Manager in DesignModeler ..................................................................................... 3
Working with the Current Selection .................................................................................................. 3
Creating a New Selection and Adding Entities ................................................................................... 4
Creating Primitives ................................................................................................................................. 4
Creating a Sheet Body ...................................................................................................................... 5
Creating a Wire Body ........................................................................................................................ 6
Creating a Solid Body ....................................................................................................................... 7
Applying Operations .............................................................................................................................. 7
Applying the Extrude Operation ....................................................................................................... 8
Applying the Transform Edges to Wire Tool ........................................................................................ 9
DesignModeler Feature Creation ............................................................................................................. 11
ACT-Based Property Parametrization in DesignModeler ......................................................................... 11
ACT-Based Geometry Creation .............................................................................................................. 13
Creating the Extension for Geometry Creation ................................................................................. 13
Defining the Functions for Geometry Creation ................................................................................ 15
Functions Associated with the Callback <ongenerate> ............................................................. 16
Functions Associated with the Callback <onaftergenereate> ..................................................... 17
DesignModeler Wizards ........................................................................................................................... 21
DesignModeler Wizard Definition ......................................................................................................... 21
DesignModeler Wizard Function Definition ........................................................................................... 23

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. iii
 Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
iv of ANSYS, Inc. and its subsidiaries and affiliates.
Introduction
This guide assumes that you are familiar with the general ACT usage information in the ANSYS ACT De-
veloper's Guide. This first section supplies ACT usage information specific to DesignModeler:
Debug Mode

Subsequent content is organized into primary sections as follows:

• DesignModeler APIs (p. 3): Describes the ACT APIs that provide for customizing the interface and
functionality of DesignModeler.

• DesignModeler Feature Creation (p. 11): Provides examples of customization capabilities available for
DesignModeler functionality and operations, such as creating specialized geometries with custom
properties and applying various operations to geometries.

• DesignModeler Wizards (p. 21): Describes DesignModeler product wizards, using a supplied extension
as an example.

Debug Mode
If DesignModeler is already started when you select the Debug Mode check box in Tools → Options
→ Extensions, you must exit DesignModeler and then restart it for debug mode to be enabled.

DesignModeler displays the ACT Development toolbar whenever debug mode is enabled.

• Clicking the first button reloads extensions.

• Clicking the second button opens the Extensions Log File.

• Clicking the third button opens the ACT Debugger.

• Clicking the fourth button opens the help panel for the ACT Start Page.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 1
 Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
2 of ANSYS, Inc. and its subsidiaries and affiliates.
DesignModeler APIs
ACT provides APIs for customizing the interface and functionality of DesignModeler. Once customizations
are in place, you can use DesignModeler APIs to create and manipulate geometries. You first use APIs
to define and generate primitives and bodies. You then use APIs to apply various operations, tools, or
automated processes to the resulting geometries.

The code for creating primitive bodies or applying operations must be integrated into the callback
<ongenerate>. The following examples address working with a selected graphic, creating different
types of primitives, and applying different operations:
Using the Selection Manager in DesignModeler
Creating Primitives
Applying Operations

For comprehensive information on all ACT APIs and their properties, refer to the ANSYS ACT API Reference
Guide.

Using the Selection Manager in DesignModeler

The DesignModeler API SelectionManager allows you to work with graphical selections. It provides
service to get information from the current selection and to clear and retrieve the current selection and
its entities. Additionally, it enables you to create a new selection and add entities.
Working with the Current Selection
Creating a New Selection and Adding Entities

Working with the Current Selection

The following Selection Manager commands allow you to perform different actions on the currently
selected graphic.

To access the Selection Manager:

selection_manager = ExtAPI.SelectionManager

To clear the current selection:

selection_manager.ClearSelection()

To retrieve the current selection:

selection = selection_manager.CurrentSelection

This command returns the object ISelectionInfo, which describes the selected entities.

To retrieve entities:
selection.Entities

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 3
DesignModeler APIs

Creating a New Selection and Adding Entities

The Selection Manager enables you to create a new selection and add entities to it. Both of these tasks
can be accomplished either by creating a new object ISelectionInfo or by directly using a list of
entities.

To create a new selection using a new object ISelectionInfo:

face = ExtAPI.DataModel.GeoData.Bodies[0].Faces[0]
selection = selection_manager.CreateSelectionInfo(SelectionTypeEnum.GeometryEntities)
selection.Entities = [face]
selection_manager.NewSelection(selection)

To create a new selection using a list of entities:

face = ExtAPI.DataModel.GeoData.Bodies[0].Faces[0]
selection_manager.NewSelection([face])

To add entities to the current selection using a new object ISelectionInfo:

face = ExtAPI.DataModel.GeoData.Bodies[0].Faces[0]
selection = selection_manager.CreateSelectionInfo(SelectionTypeEnum.GeometryEntities)
selection.Entities = [face]
selection_manager.AddSelection (selection)

To add entities to the current selection using a list of entities:

face = ExtAPI.DataModel.GeoData.Bodies[0].Faces[0]
selection_manager.AddSelection([face])

Creating Primitives
The DesignModeler API Primitives provides you with the ability to create different types of primitive
bodies: sheet bodies, wire bodies, and solid bodies. For each primitive body type, multiple shape options
are available.

The primitives variable ExtAPI.DataModel.GeometryBuilder.Primitives is the gateway for

designing a new geometric body. The code must be integrated into the callback <ongenerate>.

The script function ongenerate() can be used to create a primitive body. The API provides a variety
of queries that allow you to specify properties such as body type, dimensions, shape, point coordinates,
and material.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
4 of ANSYS, Inc. and its subsidiaries and affiliates.
 Creating Primitives

Creating a Sheet Body

When creating a sheet body, you have the option of defining it in the shape of a cone, cylinder, polygon,
or sphere. An example follows of using the function ongenerate() to define a sheet body cylinder.
def Ongenerate(feature,function):
width = 0.015
height = 0.3
sheetBodies = []
primitive = ExtAPI.DataModel.GeometryBuilder.Primitives
cylinder = primitive.Sheet.CreateCylinder([0.,0.,0.],[0.,0.,height],width)
cylinder_generated = cylinder.Generate()
sheetBodies.Add(cylinder_generated)

feature.Bodies = sheetBodies
feature.MaterialType = MaterialTypeEnum.Freeze

return True

In this example:

• The variables width and height are used to define the width and the height of the cylinder.

• The variable sheetBodies specifies the type of primitive to be created.

• The primitive variable uses the global variable ExtAPI, which serves as the ACT entry point into Design-
Modeler, to access the data model and define the geometry builder.

• The method CreateCylinder () is used to generate the new body, specifying that it is defined by the
following arguments:

– Coordinates of the center point of the cylinder’s base

– Coordinates of the center point of the upper face, which defines the direction of the cylinder

– Value of the radius, which is a float.

For example, the integer value << 3 >> is refused, while the value of << 3. >> is accepted.

• With the object cylinder_generated, you use the method Generate () to generate the cylinder.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 5
DesignModeler APIs

• With the lines sheetBodies.Add(cylinder_generated) and feature.Bodies = sheetBodies,

you add the sheet body cylinder to the list feature.bodies so that it is added to DesignModeler after
generation. Bodies not added to this list are not retained.

• With the line MaterialType, you specify a material property of Freeze.

Creating a Wire Body

When creating a wire body, you have the option of defining it in the shape of an arc, curve, ellipse, or
polyline. An example follows of using the function ongenerate() to define a wire body polyline.
def Ongenerate(feature,function):
points_list = [0.,0.,0., 1.,0.,0., 1.,1.,0., 1.,1.,1.]

wireBodies = []

primitive = ExtAPI.DataModel.GeometryBuilder.Primitives
polyline = primitive.Wire.CreatePolyline(points_list)
polyline_generated = polyline.Generate()
wireBodies.Add(polyline_generated)

feature.Bodies = wireBodies
feature.MaterialType = MaterialTypeEnum.Add

return True

In this example:

• The method points_list () is defined for later use in the creation of the polyline body. For arguments,
it expects as a list of coordinate points, which are defined by three float values per point.

• The primitive variable uses the global variable ExtAPI, which serves asthe ACT entry pointinto DesignModel-
er, to access the data model and define the geometry builder.

• The method CreatePolyline () is applied to the object Wire to generate the new body. As arguments,
this method expects the coordinate points defined by the method points_list.

• With the object polyline_generated, you use the method Generate () to generate the polyline.

• The new body is added to the list feature.bodies as described in Creating a Sheet Body (p. 5).

• With the line MaterialType, you specify a material property of Add.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
6 of ANSYS, Inc. and its subsidiaries and affiliates.
 Applying Operations

Creating a Solid Body

When creating a solid body, you have the option of defining it in the shape of a box, cone, cylinder, or
sphere. The following example uses the function ongenerate() to define a solid body box.
def Ongenerate(feature,function):
point1 = [0.,0.,0.]
point2 = [1.,2.,2.]
solidBodies = []

primitive = ExtAPI.DataModel.GeometryBuilder.Primitives
box1 = primitive.Solid.CreateBox(point1, point2)
box1_generated = box1.Generate()
solidBodies.Add(box1_generated)

feature.Bodies = solidBodies
feature.MaterialType = MaterialTypeEnum.Freeze

return True

In this example:

• The methods point1 () and point2 () are defined for later use in the creation of the solid body. For
arguments, they each expect a list of coordinate points, which are defined by three float values per point.

• The primitive variable uses the global variable ExtAPI, which serves as the ACT entry point into Design-
Modeler, to access the data model and define the geometry builder.

• The method CreateBox () is applied to the object Solid to generate the new body. For arguments,
this method expects the coordinate points defined by the methods point1 and point2.

• With the object box1_generated, you use the method Generate () to generate the box.

• The new body is added to the list feature.bodies as described in Creating a Sheet Body (p. 5).

• With the line MaterialType, you specify a material property of Freeze.

Applying Operations
The DesignModeler API Operations enables you to perform different operations on a geometric
body. Available operations can be divided into two different categories: Primary and Boolean Operations
and Tools Operations.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 7
DesignModeler APIs

The operations variable ExtAPI.DataModel.GeometryBuilder.Operations is the gateway for

performing operations. The code must be integrated into the callback <ongenerate>.

The script function ongenerate() can be used to perform various types of operations on a geometry
feature. The API provides primary and Boolean operations that allow you to specify properties such as
body type, dimensions, shape, point coordinates, and material. It also offers a number of tools for ma-
nipulating your geometry, including actions such as copying or deleting a body or transform operations
for creating a body based on another body or topological components.

Applying the Extrude Operation

When using the operation Extrude, you must first create the geometry to which the extrusion is to
be applied. You can create any of the sheet primitive shapes listed in Creating Primitives (p. 4). Once
the geometry is created, you can define and apply the operation Extrude to it.

In the following example, the function ongenerate() is used to create a polygon sheet body and
perform the operation Extrude.
def Ongenerate(feature,function):
length = 0.3
bodies = []

builder = ExtAPI.DataModel.GeometryBuilder
polygon=builder.Primitives.Sheet.CreatePolygon([0.,0.,3*length,0.,0.,2.*length,length,0.,2.*length])
polygon_generated = polygon.Generate()
extrude = builder.Operations.CreateExtrudeOperation([0.,1.,0.],length/2.)
bodies.Add(extrude.ApplyTo(polygon_generated)[0])

feature.Bodies = bodies
feature.MaterialType = MaterialTypeEnum.Add

return True

In this example:

• The first part of the function creates a polygon sheet body using a process similar to the one used to create
a cylinder in Creating a Sheet Body (p. 5).

• With the operation Extrude, you use the operations generator builder.Operations.CreateEx-
trudeOperation. The method CreateExtrudeOperation specifies that the operation is defined by
the following arguments:

– Vector coordinates, which defines the direction of the extrusion

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
8 of ANSYS, Inc. and its subsidiaries and affiliates.
 Applying Operations

– Length of the extrusion

Note

While the variable Length is used for both the sheet body and the extrusion definition
in this example, you could have used a different variable for each.

• The method ApplyTo specifies the geometry to which to apply the operation Extrude. The method Ap-
plyTo() returns a list of bodies to which to apply the operation.

• With the lines bodies.Add(extrude.ApplyTo(polygon_generated)[0]) and feature.Bodies

= bodies, you add the extruded sheet body polygon to the list feature.bodies so that it is added to
DesignModeler after generation. Bodies not added to this list are not retained.

Applying the Transform Edges to Wire Tool

When using the Transform Edges to Wire operation tool, you must first create a geometry that
has some edges. You can create any of the sheet body or solid body shapes listed in Creating Primit-
ives (p. 4). Once the primitive is created, you can obtain a wire body from its edges by defining and
applying the Transform Edges to Wire tool.

In the following example, the function ongenerate() creates a polygon sheet body and applies the
Transform Edges to Wire tool.
def Ongenerate(feature,function):
length = 0.3
bodies = []

builder = ExtAPI.DataModel.GeometryBuilder
polygon = builder.Primitives.Sheet.CreatePolygon([0.,0.,2.*length,0.,0.,1.*length,length,0.,0.7])
polygon_generated = polygon.Generate()
body = builder.Operations.Tools.EdgesToWireBody(polygon_generated.Edges);
bodies.Add(body)

feature.Bodies = bodies
feature.MaterialType = MaterialTypeEnum.Add

return True

In this example:

• The first part of the function creates a polygon sheet body using a process similar to the one used to create
a cylinder in Creating a Sheet Body (p. 5).

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 9
DesignModeler APIs

• With the body function, you use the operations generator builder.Operations.Tools.EdgesToWire-
Body. The method EdgesToWireBody specifies that the operation tool is to transform the edges of the
sheet body polygon into a wire body.

Note

While the variable Length is used for both the sheet body and the extrusion definition
in this example, you could have used a different variable for each.

• The new wire body is added to the list feature.bodies as described in Applying the Extrude Opera-
tion (p. 8).

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
10 of ANSYS, Inc. and its subsidiaries and affiliates.
DesignModeler Feature Creation
In addition to supporting the common feature creation capabilities described in the ANSYS ACT Developer's
Guide, DesignModeler supports the use of ACT for the creation of specialized geometries with custom
properties and the application of various operations to the geometries:
ACT-Based Property Parametrization in DesignModeler
ACT-Based Geometry Creation

Note

The package ACT Templates for DesignModeler provides extensions that show additional
ways that you can use ACT to customize DesignModeler. For more information, see ACT
Templates for DesignModeler. For download information, see Extension and Template Ex-
amples.

ACT-Based Property Parametrization in DesignModeler

In DesignModeler, it is possible to define ACT-based property values only as input parameters. This
topic describes how to implement an input parameter on an ACT object in DesignModeler.

As with any other input parameter, to add an input to DesignModeler you must add the parameter
isparameter to the XML file and set it to true. However, you are not able to add output parameters.
The attribute readonly is not available for DesignModeler.

For example, in an ACT feature that generates a cylinder, you can add length as a parameter. The fol-
lowing excerpt from the XML file defines the parameter Length.
<geometry name="MyFeatureWithParameters" caption="MyFeatureWithParameters"
icon="Construction" version="1">
<callbacks>
<ongenerate>generateMyFeature</ongenerate>
</callbacks>
<property name="Length" caption="Length" control="float" isparameter="true"></property>
</geometry>

In DesignModeler, the check box next to the property Length allows you to parameterize it as an input
parameter.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 11
DesignModeler Feature Creation

You could add a static structural analysis based on the previous Geometry template by adding an
output parameter in the Static Structural analysis. This results in the following Project Schematic:

The input parameter defined in DesignModeler is managed in exactly the same way as other any other
input parameter. In the Outline view for the Parameter Set bar, the geometry input parameter is placed
under the Geometry system.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
12 of ANSYS, Inc. and its subsidiaries and affiliates.
 ACT-Based Geometry Creation

Note

The process of defining parameters under a load in a third-party solver for DesignModeler
is identical to the process for defining input parameters in Mechanical. For more information,
see ACT-Based Property Parametrization in Mechanical in the ACT Customization Guide for
Mechanical.

ACT-Based Geometry Creation

The extension GeometryFeature is a theoretical example. It is not supplied. This example shows
how to create a geometry in DesignModeler based on an existing part. As part of this process, the ex-
tension draws a circle, defines a disc based on the circle, and extrudes the disc into a cylinder.

Creating the Extension for Geometry Creation

The file GeometryFeature.xml follows. DesignModeler requires PNG files for the images to display
as toolbar buttons.
<extension version="1" name="GeometryFeature">
<script src="main.py" />
<interface context="DesignModeler">
<images>images</images>
<toolbar name="ACTtoolbar" caption="ACTtoolbar">
<entry name="MyFeature" icon="construction">
<callbacks>
<onclick>createMyFeature</onclick>
</callbacks>
</entry>
</toolbar>
</interface>
<simdata context="DesignModeler">
<geometry name="MyFeature" caption="MyFeature" icon="construction" version="1">
<callbacks>
<ongenerate>generateMyFeature</ongenerate>
<onaftergenerate>afterGenerateMyFeature</onaftergenerate>
</callbacks>
<property name="Face" caption="Face" control="scoping">
<attibutes selection_filter="face"/>
</property>
<property name="Length" caption="Length" control="float" unit="Length" default="1.2 [m]"></property>
<property name="Minimum Volume" caption="Minimum Volume" control="float" unit="Volume" >
<attributes readonlyaftergenerate="true" />
</property>
</geometry>
</simdata>
</extension>

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 13
DesignModeler Feature Creation

The element <script> defines the path to the IronPython script main.py. The element <interface>
has the attribute context set to DesignModeler. The element toolbar defines the custom toolbar
for creating a geometry. The callback function createMyFeature creates the geometry and adds it
to DesignModeler.

The element <simdata> defines the geometry. The attributes in the child element <geometry>
provide the name, caption, icon, and version that apply to the geometry.

The child element <callbacks> has two callbacks: <ongenerate> and <onaftergenerate>.

• The callback <ongenerate> specifies the function to invoke when the geometry is generated by the
product. The product provides the geometry type (type IDesignModelerGeoFeature) as the callback
argument.

This callback must return a Boolean value to indicate whether the generation has been successful. It
returns true if the generation succeeds and false if it fails.

• The callback <onaftergenerate> specifies the function to invoke after the geometry is generated by
the product. The product provides the geometry type (type IDesignModelerGeoFeature) as the callback
argument.

To specify additional details about the geometry, you can include additional callbacks, such as <canadd>,
<onadd>, <oninit>, and <onmigragte>.

In the callback definition, you define the properties to apply to the definition of the geometry. In this
example, the properties Face and Length are applied. The Details View pane of DesignModeler displays
these properties so that the necessary values to complete the geometry definition can be supplied. The
next section describes how geometry properties are retrieved and modified.

The following figure shows that each defined property appears in the Details View pane with the cor-
responding names and types of interface control.

The two geometry properties, Face and Length, use different control types.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
14 of ANSYS, Inc. and its subsidiaries and affiliates.
 ACT-Based Geometry Creation

• For the property Face, the attribute control is set to scoping. The attribute selection_filter
is set to face. This specifies that the value for this property is one or more faces. The faces defined in
the script main.py and used to generate the geometry.

• For the property Length, the attribute control is set to float. It does not require the definition of
one specific callback. The attribute unit is set to length, which introduces a physical quantity de-
pendency. The attribute default specifies 1.2[m] as the default value. This default value is exposed
in the Details View pane each time a new load is created.

Defining the Functions for Geometry Creation

The IronPython script for the extension GeometryFeature is named main.py. This section describes
the functions associated with the callbacks <ongenerate> and <onaftergenerate>.
import units
import math

def createMyFeature(feature):
ExtAPI.CreateFeature("MyFeature")

def vectorProduct(v1, v2):

return [v1[1]*v2[2]-v1[2]*v2[1], -v1[0]*v2[2]+v1[2]*v2[0], v1[0]*v2[1]-v1[1]*v2[0]]

def scalarProduct(v1, v2):

return v1[0]*v2[0]+v1[1]*v2[1]+v1[2]*v2[2]

def norm(v):
return math.sqrt(scalarProduct(v,v))

def generateMyFeature(feature,function):

length = feature.Properties["Length"].Value
length = units.ConvertUnit(length, ExtAPI.DataModel.CurrentUnitFromQuantityName("Length"), "m")
faces = feature.Properties["Face"].Value.Entities
bodies = []
builder = ExtAPI.DataModel.GeometryBuilder

for face in faces:

centroid = face.Centroid
uv = face.ParamAtPoint(centroid)
normal = face.NormalAtParam(uv[0], uv[1])
radius = math.sqrt(face.Area/(math.pi*2))

xdir = [1., 0., 0.]

vector = vectorProduct(xdir, normal)
if norm(vector)<1.e-12:
xdir = [0., 1., 1.]
s = scalarProduct(xdir, normal)
xdir = [xdir[0]-s*normal[0],xdir[1]-s*normal[1],xdir[2]-s*normal[2]]
n = norm(xdir)
xdir[0] /= n
xdir[1] /= n
xdir[2] /= n

arc_generator = builder.Primitives.Wire.CreateArc(radius, centroid, xdir, normal)

arc_generated = arc_generator.Generate()

disc_generator = builder.Operations.Tools.WireToSheetBody(arc_generated)

normal[0] *= -1
normal[1] *= -1
normal[2] *= -1
extrude = builder.Operations.CreateExtrudeOperation(normal,length)
cylinder_generator = extrude.ApplyTo(disc_generator)[0]

bodies.Add(cylinder_generator)

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 15
DesignModeler Feature Creation

feature.Bodies = bodies
feature.MaterialType = MaterialTypeEnum.Add
return True

def afterGenerateMyFeature(feature):
edges = []
minimum_volume = System.Double.MaxValue
for body in feature.Bodies:
body_volume = 0
if str(body.BodyType) == "GeoBodySolid":
body_volume = body.Volume
if body_volume <= minimum_volume:
minimum_volume = body_volume

for edge in body.Edges:

edges.Add(edge)
else:
ExtAPI.Log.WriteMessage("Part: "+body.Name)

feature.Properties["Minimum Volume"].Value = minimum_volume

ExtAPI.SelectionManager.NewSelection(edges)
named_selection = ExtAPI.DataModel.FeatureManager.CreateNamedSelection()
ExtAPI.SelectionManager.ClearSelection()

Functions Associated with the Callback <ongenerate>

Descriptions follow of the functions associated with the callback <ongenerate>.

• The function createMyFeature(feature) creates the geometry in the DesignModeler. It is dis-

played as My Feature in the Tree Outline pane.

• The mathematical functions vectorProduct and scalarProduct are used later in the function
generateMyFeature.

The first several functions configure information that is used later in the creation of the geometry.

In this example, the function generateMyFeature is referenced in GeometryFeature.xml by

the callback <ongenerate>. When invoked, it generates the geometry feature. Within this function,
the following information about the geometry is defined:

• The property length, which is used later to create the primitive. The conversion of the length unit ensures
that you are working with the expected metric unit.

• The scoped property face, which in this example is three faces.

• The list bodies, where the geometric features to create are added.

• The builder, which serves as the ACT gateway in DesignModeler. All features and operations are accessed
from here.

• The variable faces, which is used as the argument to create the circle. Under faces:

– Define the centroid of the scoped face.

– Evaluate the normal to this face.

– Evaluate the radius that is to be used for the arc wire.

• Calculate the xdir, which is the principle direction of the arc wire that is defined later and that is required
to draw the arc.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
16 of ANSYS, Inc. and its subsidiaries and affiliates.
 ACT-Based Geometry Creation

• The objects vectorProduct and scalarProduct, which specify the location of the geometry’s primitives
and operations.

• The next several objects generate an arc wire.

– With the object arc_generator, the extension uses the primitive generator builder.Primit-
ives.Wire.CreateArc. The method CreateArc() uses arguments from faces to draw the circle.
This generator can be used one or more times to build the primitive body.

– With the object arc_generated, the extension uses the method Generate() to generate the prim-
itive body.

– With the object disc_generator, the extension uses the operations generator builder.Opera-
tions.Tools.WireToSheetBody to define a disc based on the circle.

• The next several lines extrude the disc into a cylinder.

– With the object extrude, the extension uses the operations generator builder.Operations.Cre-
ateExtrudeOperation to specify that the resulting extrusion is equal to the value of the property
Length.

– With the object cylinder_generator, the extension uses the method ApplyTo to define the geometry
to which the extrude operation is applied. This method returns a list of bodies to which the operation is
applied.

• Bodies added to the list feature.Bodies are added to DesignModeler after the generation. All other
bodies used in the generation process are lost.

The list feature.Bodies can contain both bodies and parts. You can create a part with the com-
mand builder.Operations.Tools.CreatePart(list_of_bodies).

• The list material.Type allows you to enter different properties such as Freeze, Cut, and Add. The
following figure illustrates the resulting geometry given selection of the different properties. You can see
the effect of different material type properties on the geometry.

Functions Associated with the Callback <onaftergenereate>

A description follows of the IronPython function associated with the callback <onaftergenerate>.
This callback specifies the function that is invoked when the callback <ongenerate> is complete.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 17
DesignModeler Feature Creation

• The callback <onaftergenerate> allows you to access and work with the part or bodies created
previously by the callback <ongenerate>.

For example, you can use it rename a part or body, suppress it, create a named selection, create
a new selection via the Selection Manager, or access one or more of the geometric features of
a body as its area.

• Unlike the callback <ongenerate>, which expects a return value of True or False, the callback
<onaftergenerate> does not expect a return value.

• The callback <onaftergenerate> allows you to define properties for the feature to be created.

In this example, the function afterGenerateMyFeature is referenced in GeometryFeature.xml

by the callback <ongenerate>. It accepts only the feature itself as an argument. When called, it specifies
the properties and attributes of the feature and selects edges of the bodies created: Within this function,
the following information is defined:

• The list edges, where you add all edges of the bodies to create for the feature.

• The property Minimum Volume, which in this example is the volume of the body with the smallest
volume of all the bodies created for the feature. The attribute control is set to float. The attribute
unit is set to Volume. Because this property has the special attribute readonlyaftergenerate
set to true, the value becomes non-editable after generation of the feature.

• The variable edge, which is used to find the edges of all the bodies created for the feature.

• The entry feature.Properties[Minimum Volume"].Value sets the property Minimum

Volume in DesignModeler to the value minimum_volume.

• The command ExtAPI.SelectionManager.NewSelection(edges) creates a new selection,

which includes all edges previously selected.

• The command named_selection = ExtAPI.DataModel.FeatureManager.CreateNamedSe-

lection() creates a named selection that is defined by the current selection containing all edges
previously selected.

The following figures shows the feature, named selection, and properties in DesignModeler.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
18 of ANSYS, Inc. and its subsidiaries and affiliates.
 ACT-Based Geometry Creation

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 19
 Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
20 of ANSYS, Inc. and its subsidiaries and affiliates.
DesignModeler Wizards
You can use ACT to create target product wizards for DesignModeler. The supplied extension Wizard-
Demos contains a project wizard, multiple target product wizards, and a mixed wizard. This section
describes the target product wizard for DesignModeler. Named CreateBridge, this two-step wizard
is for building a bridge.

Note

• You use the Extension Manager to install and load extensions and the Wizards launcher to start
a target product wizard.

• The extension WizardDemos contains two wizards named CreateBridge. The first one is for
DesignModeler, and the second one is for SpaceClaim. This topic describes the DesignModeler
wizard. For a descriptoin of the SpaceClaim wizard, see SpaceClaim Wizard for Building a Bridge
in the ACT Customization Guide for SpaceClaim.

Tip

Included in the supplied package ACT Wizard Templates is the extension Template-
DesignModelerWizard. It contains a target product wizard for DesignModeler that creates
a geometry. For download information, see Extension and Template Examples.

DesignModeler Wizard Definition

An excerpt from the file WizardDemos.xml follows. Code is omitted for the element <uidefini-
tion> and all wizards other than the DesignModeler wizard CreateBridge.
<extension version="2" minorversion="1" name="WizardDemos">
<guid shortid="WizardDemos">7fdb141e-3383-433a-a5af-32cb19971771</guid>
<author>ANSYS Inc.</author>
<description>Simple extension to test wizards in different contexts.</description>

<script src="main.py" />

<script src="ds.py" />
<script src="dm.py" />
<script src="sc.py" />

<interface context="Project|Mechanical|SpaceClaim">
<images>images</images>
</interface>

<interface context="DesignModeler">
<images>images</images>

<toolbar name="Deck" caption="Deck">

<entry name="Deck" icon="deck">
<callbacks>
<onclick>CreateDeck</onclick>
</callbacks>
</entry>

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 21
DesignModeler Wizards

<entry name="Support" icon="Support">

<callbacks>
<onclick>CreateSupport</onclick>
</callbacks>
</entry>
</toolbar>

</interface>

<simdata context="DesignModeler">
<geometry name="Deck" caption="Deck" icon="deck" version="1">
<callbacks>
<ongenerate>GenerateDeck</ongenerate>
</callbacks>
<property name="Length" caption="Length" control="float" unit="Length" default="300 [m]" />
<property name="Width" caption="Width" control="float" unit="Length" default="20 [m]" />
<property name="Beams" caption="Beams" control="integer" default="31" />
</geometry>
</simdata>

<simdata context="DesignModeler">
<geometry name="Support" caption="Support" icon="support" version="1">
<callbacks>
<ongenerate>GenerateSupport</ongenerate>
</callbacks>
<property name="Length" caption="Length" control="float" unit="Length" default="300 [m]" />
<property name="Height" caption="Height" control="float" unit="Length" default="100 [m]" />
<property name="Width" caption="Width" control="float" unit="Length" default="20 [m]" />
<property name="Number" caption="Number" control="integer" default="3" />
</geometry>
</simdata>

...

<wizard name="CreateBridge" version="1" context="DesignModeler" icon="wizard_icon">

<description>Simple wizard for demonstration in DesignModeler.</description>

<step name="Deck" caption="Deck" version="1" HelpFile="help/dm1.html">

<description>Create the deck.</description>

<callbacks>
<onupdate>UpdateDeck</onupdate>
</callbacks>

<propertygroup display="caption" name="Deck" caption="Deck Definition" >

<property name="Length" caption="Length" control="float" unit="Length" default="300 [m]" />
<property name="Width" caption="Width" control="float" unit="Length" default="20 [m]" />
<property name="Beams" caption="Beams" control="integer" default="31" />
</propertygroup>

</step>

<step name="Supports" caption="Supports" enabled="true" version="1" HelpFile="help/dm2.html">

<description>Create supports.</description>

<callbacks>
<onupdate>UpdateSupports</onupdate>
</callbacks>

<propertygroup display="caption" name="Supports" caption="Supports Definition" >

<property name="Height" caption="Height" control="float" unit="Length" default="100 [m]" />
<property name="Number" caption="Number" control="integer" default="3" />
</propertygroup>

</step>

</wizard>

...

</extension>

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
22 of ANSYS, Inc. and its subsidiaries and affiliates.
 DesignModeler Wizard Function Definition

Understanding the elements <interface> and <simdata> is necessary to understanding the

DesignModeler wizard CreateBridge.

Wizard Interface Definition

The element <interface> defines two user interfaces for the extension WizardDemos. The second
element <interface> is used by the DesignModeler wizard CreateBridge. This element <inter-
face> has a child element <toolbar> that defines two toolbar buttons for exposure in DesignModeler.
When the buttons are clicked, the callback <onclick> executes the functions CreateDeck and Cre-
ateSupport, creating a deck geometry with supports.

Simdata Definition
The element <simdata> provides data. This extension has two such elements to provide data for creating
the geometries Deck and Support. The second element <simdata> is used by this wizard as it has the
attribute context set to DesignModeler.

Wizard Definition
The element <wizard> named CreateBridge in the XML code excerpt has the attribute context
set to DesignModeler to indicate that this is the product in which the wizard executes.

Step Definition
The element <step> defines a step in the wizard. This wizard has two steps: Deck and Supports.

• For the step Deck, the callback <onupdate> executes the function UpdateDeck, creating the deck
using the geometry Deck.

• For the step Supports, the callback <onupdate> executes the function UpdateSupports, creating
the bridge supports using the geometry Support.

DesignModeler Wizard Function Definition

The IronPython script dm.py follows. This script defines all functions executed by the callbacks in the
steps for the DesignModeler wizard CreateBridge.
import units

def CreateDeck(ag):
ExtAPI.CreateFeature("Deck")

def CreateSupport(ag):
ExtAPI.CreateFeature("Support")

def GenerateDeck(feature,fct):
length = feature.Properties["Length"].Value
length = units.ConvertUnit(length, ExtAPI.DataModel.CurrentUnitFromQuantityName("Length"), "m")
width = feature.Properties["Width"].Value
width = units.ConvertUnit(width, ExtAPI.DataModel.CurrentUnitFromQuantityName("Length"), "m")
num = feature.Properties["Beams"].Value

builder = ExtAPI.DataModel.GeometryBuilder

bodies = []

boxGen = builder.Primitives.Solid.CreateBox([0.,-width/2.,-0.3],[length,width/2.,0.])
bodies.Add(boxGen.Generate())

w = (length-0.1*num)/(num-1.)+0.1
for i in range(num-1):
beamGen = builder.Primitives.Solid.CreateBox([i*w,-width/2.,-0.6],[i*w+0.1,width/2.,-0.3])
bodies.Add(beamGen.Generate())

beamGen = builder.Primitives.Solid.CreateBox([length-0.1,-width/2.,-0.6],[length,width/2.,-0.3])

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 23
DesignModeler Wizards

bodies.Add(beamGen.Generate())

beamGen = builder.Primitives.Solid.CreateBox([0.,-width/2.,-1.],[length,-width/2.+0.2,-0.6])
bodies.Add(beamGen.Generate())
beamGen = builder.Primitives.Solid.CreateBox([0.,width/2.-0.2,-1.],[length,width/2.,-0.6])
bodies.Add(beamGen.Generate())

feature.Bodies = bodies
feature.MaterialType = MaterialTypeEnum.Add

return True

def GenerateSupport(feature,fct):
length = feature.Properties["Length"].Value
length = units.ConvertUnit(length, ExtAPI.DataModel.CurrentUnitFromQuantityName("Length"), "m")
height = feature.Properties["Height"].Value
height = units.ConvertUnit(height, ExtAPI.DataModel.CurrentUnitFromQuantityName("Length"), "m")
width = feature.Properties["Width"].Value
width = units.ConvertUnit(width, ExtAPI.DataModel.CurrentUnitFromQuantityName("Length"), "m")
num = feature.Properties["Number"].Value

builder = ExtAPI.DataModel.GeometryBuilder

bodies = []

w = (length-2.*num)/(num+1.)+2.
for i in range(num):
beamGen = builder.Primitives.Solid.CreateBox([(i+1)*w,-width/2.,-1.-height],
[(i+1)*w+2.,width/2.,-1.])
bodies.Add(beamGen.Generate())

beamGen = builder.Primitives.Solid.CreateBox([0.,-width/2.,-5.],[2.,width/2.,-1.])
bodies.Add(beamGen.Generate())

beamGen = builder.Primitives.Solid.CreateBox([length-2.,-width/2.,-5.],[length,width/2.,-1.])
bodies.Add(beamGen.Generate())

feature.Bodies = bodies
feature.MaterialType = MaterialTypeEnum.Freeze

return True

def UpdateDeck(step):
deck = ExtAPI.CreateFeature("Deck")
deck.Properties["Length"].Value = step.Properties["Deck/Length"].Value
deck.Properties["Width"].Value = step.Properties["Deck/Width"].Value
deck.Properties["Beams"].Value = step.Properties["Deck/Beams"].Value
ExtAPI.DataModel.FeatureManager.Generate()

def UpdateSupports(step):
supports = ExtAPI.CreateFeature("Support")
supports.Properties["Length"].Value = step.PreviousStep.Properties["Deck/Length"].Value
supports.Properties["Width"].Value = step.PreviousStep.Properties["Deck/Width"].Value+6
supports.Properties["Height"].Value = step.Properties["Supports/Height"].Value
supports.Properties["Number"].Value = step.Properties["Supports/Number"].Value
ExtAPI.DataModel.FeatureManager.Generate()

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
24 of ANSYS, Inc. and its subsidiaries and affiliates.