Twin Builder Getting Started Guide 2023
Twin Builder Getting Started Guide 2023
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. 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
ANSYS, Inc. and ANSYS Europe, Ltd. are UL registered ISO 9001: 2015 companies.
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 pro-
prietary software and third-party software. If you are unable to access the Legal Notice, please
contact ANSYS, Inc.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Table of Contents
Table of Contents Contents-1
1 - Introduction 1-1
Contents-1
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Placing and Arranging the New VHDL-AMS Components on the Sheet 6-3
Contents-2
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Index Index-1
Contents-3
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Contents-4
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
1 - Introduction
This Getting Started guide is written for Twin Builder beginners as well as experienced users
who are using Twin Builder for the first time.
Twin Builder is a simulation package for multi-domain designs that are commonly found in auto-
motive, aerospace, power electronics, and electric drive systems.
Twin Builder provides an approach for the virtual prototyping of large-scale systems by letting
you to develop a design that combines predefined basic and industry-specific components with
user-defined models. You can create models in common programming languages or standard
modeling languages such as VHDL-AMS. The basic and industry-specific model libraries avail-
able for Twin Builder provide ready-to-use parameterized components, making Twin Builder
accurate, and flexible.
l Chapter 2 of this guide shows you how to create and save a new Twin Builder project.
l Chapter 3 leads you step-by-step through creating, solving, and analyzing the results of
a Three-Phase Rectifier.
l Chapter 4 modifies the example of Chapter 3 by replacing the resistive/inductive load
with a real machine model. The example is then expanded to include a control circuit
modeled first using discrete components, then using state graph components.
l In Chapter 5 the state graph controller is replaced with a PI (proportional-integral) con-
troller implemented using block components.
l Chapter 6 substitutes the use of VHDL-AMS opponents for modeling the DC motor.
l Chapter 7 explores several different methods for modeling a PWM Controller to demon-
strate Twin Builder’s versatile modeling capabilities.
l Chapter 8 leads you through the process of importing a legacy Simplorer 7 Three-
Phase Rectifier schematic into Simplorer Release 16.2, saving it, migrating it into Twin
Builder 2018.2, then solving and analyzing the translated model.
Introduction 1-1
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Project Man- The Project Manager pane shows all the components, models, and other ele-
ager pane ments of each design in the project. Each project has its own expandable Pro-
and Project ject tree. You can perform many operations on the design elements directly from
tree the Project Manager pane.
Message Displays error, informational, and warning messages for the active project.
Manager
pane
Progress Displays solution progress information.
window
Introduction 1-2
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Properties Displays the attributes of a selected object in the active model, such as the
window object’s name, electrical or other associated physical quantities, orientation, and
color.
Also displays information about a selected command that has been carried out.
For example, if a circle was drawn, its command information would include the
command’s name, the circle’s center position coordinates, and the size of its
radius.
Design area Displays one or more editor windows such as the Schematic Editor, model edit-
window ors, and symbol editor. It also displays various report windows.
Component Displays, on the Components tab, the component categories, including Favor-
Libraries ites, Most Recently Used, Simplorer Elements, and Project Components. You
window can pin the window to make it remain visible or make it visible only when it is
being used.
The Project Components section lists the elements that are active in your pro-
jects.
If you have created any personal libraries, a Personal Libraries section displays
them.
Introduction 1-3
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
This example describes a three-phase power supply and a rectifier bridge with res-
istive/inductive load. For the input signals, time-controlled voltage sources are used. The diodes,
the capacitor, and the resistor are ideal components; the diodes are determined by an expo-
nential function (their characteristic).
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Expected Results
After the simulation is run, the results are displayed in Report windows. For example, the first
simulation variation demonstrates these results:
l Voltages of the sources ET1.V, ET2.V, and ET3.V
l Voltage of the smoothing capacitor CD.V
l Current of the load resistor R_LOAD.I
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
As you step through this Getting Started Guide, we introduce you to several key concepts:
l There are numerous ways to perform most tasks.
For example, there are several methods to select and assign design parameter values.
l There is no required sequence of events when creating a design. —
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
We'll demonstrate a convenient method for creating the three-phase rectifier, but you can
complete the design setup steps in any logical order.
l You can quickly modify design properties at any time.
For example, you can draw a box freehand, then specify its exact dimensions in the Prop-
erties window.
l You can easily manage your design in the Project tree.
The branches of the Project tree in the Project Manager pane provide access to set up
dialog boxes, where you can modify design properties.
l You can modify the model view at any time.
You will learn shortcut keys like Ctrl+D, which fits the model in the view window.
l You can save time by parameterizing design properties.
This enables you to quickly modify design properties and generate new results.
l You can use Twin Builder’s extensive post-processing features to evaluate solution res-
ults.
The first step in using Twin Builder to solve a problem is to create a project in which to save all of
the data associated with the problem. A project is a collection of one or more designs saved in a
single *.aedt file. By default, opening Twin Builder creates a new project named Projectn and
inserts a new design named TwinBuildern, where n is the order in which each was added to the
current session.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
A new project named Projectn containing a new design named Twin Buildern is added in
the Project tree in the Project Manager pane.
Hint l If the Project Manager pane does not appear, select View > Project Manager.
l If a new design does not appear, select Tools > Options > General Options.
Under Project Options, select Insert a design of type.
l To expand the Project tree when an item is added to the project, select
Tools > Options > General Options. Under Project Options, select Expand
Project Tree on Insert.
The new project contains a file structure that organizes design elements such as: Ports,
Analysis, Optimetrics, and Results. Project Definitions such as Components, Symbols,
Models, Packages, Materials, and Scripts also appear.
1. In the Project tree, right-click TwinBuildern and select Rename, or select a name and
press F2.
2. Type Rectifier (or some other name of your choosing) and press Enter to complete the
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
change.
1. Select Twin Builder > Edit Notes. The Design Notes dialog box appears.
2. Click in the window and type your notes.
3. Click OK to save the notes in the Project tree under the current design.
Note:
To edit existing design notes, double-click Notes in the Project tree to open the
Design Notes dialog box.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Note:
For further information on any Twin Builder topic, schematic editor commands or
windows, you can view Twin Builder’s context-sensitive help in one of these
ways:
l Click Help in a dialog box.
l Press Shift+F1. The cursor changes to ?. Click an item for which you need
help.
l Press F1 to open the Help window. If you have a dialog box open, the
Help window opens to a page that describes that dialog box.
l Access the Help menu.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
This example contains a three-phase power supply and a rectifier bridge with resistive/inductive
load. For the input signals, time controlled voltage sources are used. The diodes, the capacitor,
and the resistor are ideal components; the output characteristics of the diodes are determined by
an exponential function.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Note:
If you make a mistake, click Rectifier in the Project tree, then select Undo > Edit to
undo design operations. Twin Builder lets you undo every command performed since
the last save.
First, locate and choose the components to use in the simulation model, then place and arrange
the components on the schematic sheet.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
1. In the Component Libraries window, select the R: Resistor element. The R: Resistor
element appears under Favorites by default.
Note:
An alternative path is to click + to expand the Simplorer Elements tree, then con-
tinue to click + symbols next to the Basic Elements folder, the Circuit folder,
and the Passive Elements. The R: Resistor element appears under Passive
Elements.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
2. To place the resistor onto the sheet, select R: Resistor, then click and drag the selection
onto the sheet.
3. As you drag a library component over the Schematic Editor window, the symbol for that
component appears. Press R to rotate the component before placing it on the sheet. The
component rotates 90 degrees counter-clockwise each time you press R.
After placing one resistor, notice that the cursor retains a selected resistor symbol.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
This feature permits you to place several instances of a component by clicking without hav-
ing to reselect the component from the library.
4. Right-click a component and select Finish to exit the “place” mode without placing a com-
ponent. Alternatively, select Place and Finish to place an additional component before
exiting “place” mode.
Note:
5. To continue the design, repeat the process outlined above and place these components
from the Basic Elements library onto the Schematic Editor sheet.
6. When you have placed the elements, use the three-phase rectifier schematic at the start
of this chapter as a guide to arrange the components.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Note:
Once components are placed, you can select, move, copy, delete, rotate, or flip them. To
select elements:
l Click an element.
l Drag and draw a selection rectangle around multiple instances.
l Press Ctrl+click multiple instances.
Access commands for flipping and rotating selected elements in the ribbon, or by right-
clicking a component.
7. To align specific components, select a component, and drag to specify a selection area.
Selected elements are highlighted.
Use Draw > Align Horizontal to horizontally align the components, and Draw > Align
Vertical to vertically align components.
8. A ground node is necessary for each separate circuit on a sheet. To place a ground node,
selectDraw > Ground or press Ctrl+G.
Hint l Zoom in and out with the View menu, the Zoom icon functions in the Twin
Builder Schematic ribbon, or Ctrl+E (Zoom In) and Ctrl+F (Zoom Out).
Ctrl+D (Fit Drawing) scales the drawing to include all of its components in
the current window.
l To move the sheet and its contents around within the window, press Shift,
select a sheet, and drag it to the desired position.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
9. Position the terminal of the ground node over the terminal of the device you are grounding
and click to place the ground node and connect it to the device. You can rotate the ground
node to the desired position if necessary.
All of the components required for the Three-Phase Rectifier simulation model should now be on
the sheet and placed in the appropriate positions. In the next section, you will connect the com-
ponents.
When you have arranged all of the components, you are now ready to connect them as required
for this example.
1. To connect components, activate wire drawing mode by choosing Draw > Wire. The
cursor changes to crossed wires.
Note:
The components that you have placed and connected still have their default parameter values,
as defined in the Basic Elements model library. You will now assign values to these com-
ponents to match the schematic at the beginning of this chapter by performing these steps:
1. First, define the parameters of the three voltage sources. All sources are time-controlled
sine function generators with a phase shift of 120 degrees with respect to each other.
a. Double-click the first Voltage Source symbol to open the component’s Parameters
dialog box.
b. Change the Name parameter to ET1.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
c. Select the Time Controlled option button and select Sine from the drop-down
menu. Keep the Phase value as-is at 0 (zero) degrees. Keep all other values at their
default values.
d. Click OK to apply the changes.
2. Double-click the second voltage source symbol to open its Parameters dialog box.
a. Change the Name parameter to ET2.
b. Select the Time Controlled option button.
c. Set the Phase value to 120 degrees. Keep all other values at their default values.
d. Click OK to apply the changes.
3. Double-click the third voltage source symbol to open its Parameters dialog box.
a. Change the Name parameter to ET3.
b. Select the Time Controlled option button.
c. Set the Phase value to 240 degrees. Keep all other values at their default values.
d. Click OK to apply the changes.
Note:
l Properties of the currently selected element are also displayed in the Prop-
erties window similar to the one shown below.
l You can modify many component properties in this window. Refer to the
Twin Builder help for details.
l Click Info to open detailed help for the current component.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Note:
a. Double-click the upper-left diode symbol to open its Parameters dialog box.
b. Change the Name to D1.
c. Change the Type by selecting the Type option button, then choosing Exponential
Function from the drop-down menu.
d. Keep all other values as they are and click OK to apply the changes.
e. Repeat steps a through d for the remaining diodes D2 through D6.
7. Define the parameters of the smoothing capacitor.
a. Double-click a capacitor symbol to open its Parameters dialog box.
b. Change the Name to CD and change the Capacitance from 1e-006 F to 1 mF.
c. Click OK to apply the changes.
8. Define the parameters of the load resistor.
a. Double-click a resistor symbol to open its Parameters dialog box.
b. Change the Name to R_LOAD.
c. change the Resistance from 1000 ohm to 1.2 ohm.
d. Click OK to apply the changes.
9. Define the parameters of the load inductor.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
All components of the simulation model should now have their correct values. This table lists the
components of the simulation model and their parameter values.
R_B (Linear)
R_C
L_A L Inductance [mH]=0.3;
L_B
(Linear) Initial Current [A]=0
L_C
D1…D6 DEXP Saturation Current [pA]=1;
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Next you will define the component properties that will appear on the schematic sheet.
While most component properties are accessible in the Propertieswindow, you control the dis-
play of component properties via the Property Displays tab in the Propertiesdialog boxes.
1. For example, select Voltage Source 1 (ET1) and open its Properties dialog box. (Right-
click a component and select Properties.)
2. On the Property Displays tab, click Add.
This adds a line with three fields: Name, Visibility, and Location. Each of these fields con-
tains drop-down menus.
The drop-down menu for the Name field includes all available property names for
the selected instance. For each kind of component in the schematic, you will select
another property value. For now, start with the name.
l Use the Visibility field to specify the information to display about the selected Label
ID on the schematic, for example, None, the property Name, the property’s Value,
the Evaluated Value, Both (the name and value) or Evaluated Both. Select Value
from the menu.
l Use the Location field to select initial locations relative to the default orientation of
the component instance.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
3. For this example, OK the dialog box, and locate and click to select the ET1 label in its ini-
tial placement.
4. Drag the label to a position above the component instance.
5. With the label highlighted, click on the Twin Builder Schematic ribbon, or use
Draw > Rotate to rotate the label as needed.
6. Open the Properties dialog box again, and select the Property Displays tab again.
Note that the Location field for the Name property now shows Custom.
10. Drag the PHASE=0 label to a position to the left of the component as shown in the figure.
11. Use the foregoing techniques to activate labels for the rest of the components to match
the schematic figure.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Note:
Set the visibility and initial location for properties to display by double-clicking a
component to open its Parameters dialog box. The Output/Display tab has
drop-down menus for setting the Visibility and Location for each property.
During a simulation, data is generated based on outputs that you specify. These can include
quantities such as voltage, current, frequency, phase angle, torque, and displacement.
Using the outputs you define, you can create reports of simulation results, or plot output quant-
ities specified by probes that you place in the schematic.
1. Select Twin Builder > Output Dialog. The Output dialog box appears. The Add/Re-
move list shows all of the schematic elements. Check boxes control which quantities
appear in the selection window.
2. Type ET in the Find field.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
This moves the displayed list to the ET elements, and opens a list of check boxes that
show available outputs.
Similarly, select the V check boxes for ET2 and ET3 to add ET2.V and ET3.V to the
Defined Output list.
4. Use the Find field to locate the R_LOAD item and select the I check box.
5. Use the Find field to locate the CD element, and select the V check box.
When you have finished, the Defined Output field will list the items you selected.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Next, you will define the Solution Options and Analysis Parameters to be used when analyzing
the circuit.
Simulation parameters control the simulation process. The choice of simulation parameters is
important for a successful simulation. There are general and circuit simulator parameters. The
values obtained during a simulation provide valuable information about the quality of a sim-
ulation result.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
1. Right-click Analysis in the Project Manager pane, and select Add Solution Options.
2. On the TR tab, change the Integration formula to Euler, the Maximum number of iter-
ations from 40 to 20 and the Local truncation error from 1 to 0.1. Change the Name to
ThreePhaseOptions. Leave all other settings unchanged.
3. Click OK to apply the changes.
An icon for the new options named ThreePhaseOptions appears under Analysis in the
Project Manager pane.
4. Right-click Analysis in the Project Manager pane, and select Solution Setup > Add
Transient.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
5. Change simulation End Time from 40ms to 0.1s; Min Time Step from 10us to 1us, and
Max Time Step from 1ms to 0.5ms.
6. Click Analysis Options and select ThreePhaseOptions from the Select Solution
Options dialog box.
7. Click OK to close the Select Solution Options dialog box. Click OK again to close the
Transient Analysis Setup dialog box.
Now that you have set up the necessary conditions for finding solutions for the example circuit,
the next step is to start an analysis.
Starting an Analysis
To start an analysis:
You can also right-click Analysis in the Project Manager pane and select Analyze, click
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
The simulation model is compiled and outputs are calculated. During the simulation run,
the name of the model is visible in the Progress window, and a button to stop the sim-
ulation is available.
2. After the simulation, the output quantities are displayed in the plots on the sheet or in the
report windows. Output data is also saved in an SBD (Twin Builder Database) file.
In this section, you will create reports that graph these outputs:
l Voltages of the sources ET1.V, ET2.V, and ET3.V
l Voltage of the smoothing capacitor CD.V
l Current of the load resistor R_LOAD.I
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Begin by creating a 2D rectangular report that plots the three-phase voltage source outputs.
1. Right-click Results in the Project tree and select Create Standard Report > Rect-
angular Plot.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
2. Under Category, select Voltage. Select ET1.V, ET2.V, and ET3.V in the Quantity list with
Ctrl+click. Keep all other settings unchanged.
3. Click New Report to create a report similar to this image:
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
4. Without closing the New Report dialog box, select CD.V in the Quantity list.
5. Click New Report to create a report showing the smoothing capacitor voltage similar to
this image:
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
6. Without closing the New Report dialog box, select Current in the Category list; then select
R_LOAD.I in the Quantity list.
7. Click New Report to create a report showing the load resistor current similar to this image:
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
You can customize reports such as the one you created in this example in many ways. For
example, to rename plots, right-click a plot name in the Project Manager pane and select
Rename. You can also adjust the background color, grid scale and color, text font, size, and
color, trace color, line style, and thickness, legend text, add various data markers, and so on.
Use the tools in Twin Builder’s Draw menu to add your own custom elements and text to your
reports. Detailed information on generating and modifying reports is available in the help.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
This figure shows a Schematic sheet of the simulation model you will design in this section. The
model consists of a three phase power supply, a rectifier bridge with static diodes and their char-
acteristics, a smoothing capacitor, a DC machine model, Chopper transistor, and freewheeling
diode.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
First, you need to delete the components which are not used in the modified simulation model. In
place of the resistive/inductive load, you will add a DC machine model, a freewheeling diode,
and a chopper transistor.
You can select them one at a time (selected elements turn red); or draw a box around
them to select both elements.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Click a property name and press Ctrl+R to rotate it. Hover the mouse over a property
name until the cursor changes into a pointer with a four-headed arrow, then click and drag
the name to the new position.
You can set the mechanical load of the machine model in many ways. The variant used in this
example is based on an initial value (ICA) component. This component is useful when you use
initial values for different models on the sheet. In this example, the equation defined within the
ICA component is used to “connect” an initial value, 0, to the load torque parameter of the
machine component. Values in the ICA component are set only once at the simulation start.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
e. To display the LOAD parameter name and value, select the LOAD parameter’s Show
check box.
f. Click OK to apply the changes. The new parameter is now defined and is available for
connecting with a quantity.
2. Connect the ICA initial value to the LOAD property of the DC machine.
a. Double-click a DC machine symbol to open its Parameters dialog box.
b. On the Parameters tab, type LOAD in the Value cell for the LOAD property, and click
OK. This “connects” the DC machine LOAD property to the LOAD value specified in
the ICA component.
Freewheeling Diode
Define the parameters of the diode.
Chopper Transistor
The transistor turns on and off depending on the machine current, IA. Initially, the transistor is
set “on” to start the process.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
All parameters of the modified simulation model should now have the correct values. This
table lists all new components of the simulation model and their parameter values.
LA (Armature Inductance)=9.5 mH
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
VT (Thermal Voltage)=0.035 V
Y0 (Initial Value)=1
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
To view the area of interest on the characteristic curve, you need to manually edit the X- and Y-
axes properties.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
1. Select Twin Builder > Add Solution Setup > Transient to define the simulation para-
meters.
2. Change the default values for simulation End Time from 40ms to 100ms, for Min Time
Step from 10us to 1ns, and for Max Time Step from 1ms to 1us. Click OK to apply the
changes.
The Speed and Current plots display the simulation results for the machine armature current
(DCM.IA) and speed (DCM.N). Depending on the armature current, the two-point element with
hysteresis controls the switching behavior of the chopper transistor. The speed for the DC motor
no-load starting torque approaches 2613 rpm.
The Characteristic plot displays diode D1’s current as a function of its voltage and should look
similar to the image below.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder’s state graph module, which is based on the Petri Net theory, lets you model event-
driven, discontinuous processes. The theoretical basis of the modeling divides a system into sig-
nificant states and events, and transitions from one state to the other. The procedure below
explains the modeling of the two-point hysteresis controller with state graph components.
First, place and arrange the state graph components used in the modified simulation model. Any
unused area of the sheet may be used.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
5. When all of the required components for the state graph are now on the sheet, connect the
components, by placing them in appropriate positions as shown in the figure below. Note
in particular the directions of the arrows on the Transition components and rotate or flip
components as needed.
1. Activate the wire mode. Select Draw > Wire or press Ctrl+W. The cursor changes to
cross wires.
2. Connect the components as required for the circuit. Place the cursor on the element
pins and set the beginning, the corners, and the end of a wire. Press Esc to finish and exit
the wire mode.
CS (control signal) is set to 1 if the state is active. Click to open the Calculator
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
dialog box and confirm the expression CS:=1 is present. (Click OK or Cancel to close
the window.)
e. Select the Activate State check box to set the state active at the beginning of the sim-
ulation.
f. Select the TR option button.
g. Click OK to apply the changes.
The blue circle in the symbol indicates the state is active. During a simulation, the state
markers “run” through the state graph, depending on the active states in the simulation pro-
cess.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
c. Click in the Equation field and type the name:=value corresponding to the picture.
You can also enter a description of each equation in the Information field and display
the descriptions on the schematic by selecting a Show check box.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Note:
Using the “=” operator type forces the simulator to synchronize on the con-
dition with the minimum time step. Because of this, the state graph works
more precisely than the two-point hysteresis component, but the processing
time of the simulation is longer.
1. Double-click the transistor symbol to open the Parameters dialog box to define the control
parameter.
2. Clear the Use Pin check box, and enter the control variable CS in the Control Signal
field.
3. Click OK to apply the changes.
Select the hysteresis block CONTR_OUT and choose Edit > Deactivate (Open). The wires,
connected with the machine model and transistor, remain on the sheet.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
All parameters in the modified simulation model now have the correct values. This table lists all
new components of the simulation model and their parameter values.
Thermal Voltage[V]=0.035
Reverse Resistance[Ω]=100k
Control Signal=CS
CONTR_OUT Deactivated Threshold T1=17.5
Value A1=1
Value A2=0
Initial Value=1
Input=DCM.IA
TRANS1 DCM.IA>=IUPR
TRANS2 DCM.IA<=ILWR
ON SET: CS:=1
OFF SET: CS:=0
FML_INIT2 IREF:=20
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
IUPR:=IREF+DELTA
ILWR:=IREF-DELTA
Select Twin Builder > Analyze to start the simulation, or right-click in the Project win-
dow and select Analyze. The simulation model is compiled and calculated.
The Speed and Current plots display the simulation results for the machine armature current
(DCM.IA) and speed (DCM.N). Depending on the armature current (DCM.IA) the state graph
controls the switching behavior of the chopper transistor. The speed for the DC motor no-load
starting condition approaches 2550 rpm.
The tolerance band of the state graph controller is more precise than for the hysteresis con-
troller, because the = operator type in the state graph forces the simulator to synchronize on the
condition with the minimum time step. To force any of the block models to calculate more pre-
cisely, define a special sample time in the model’s property dialog box.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
In addition to basic functions (selecting, placing, arranging, and connecting components), this
chapter introduces these Twin Builder features:
l Modeling with block components
l Examining Block Sequence
l Using Pins for parameter transfer
l Using Characteristic components
The figure below shows the Schematic sheet of the simulation model with the corresponding val-
ues of components: three phase power supply, the rectifier bridge, smoothing capacitor, motor,
and the PI controller.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
First, you need to delete the components that are not used in the modified simulation model.
Instead of the state graph or simple hysteresis controller, you will use a PI controller consisting of
block diagram components.
1. Select the components to delete. Ctrl+click the state graph components: FML_INIT1, and
FML_INIT2, STATE_11 (both ON and OFF), and the two Transition components.
2. Delete the components. Select Edit > Cut, or press Ctrl+X or Del to remove the com-
ponents from the sheet.
3. Delete the remaining wires. Ctrl+click to select any remaining unused wires. Press Ctrl+X
to remove the wires.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
First, place and arrange the new components needed for the PI Controller in the extended sim-
ulation model. The Component Libraries provide access to the library containing the Twin
Builder basic components, which are used for this example.
INTG: Integrator 1
Sources Blocks CONST: Constant Value 1
Signal Processing Blocks LIMIT: Limiter 1
SUM: Summation 3
Tools Time Functions DATAPAIRS: 2D Look-up Table 1
1. Open the Basic Elements model library folder; click + next to the folder, or double-click
Basic Elements.
2. Place the component onto the sheet. Select the Blocks folder, then the Continuous
Blocks folder. Select the component Gain and drag the component onto the sheet.
3. Arrange the component on the sheet. To connect the components, you must place
them in appropriate positions. See the simulation model figure on Current and Speed
Controlled DC Motor. Orient each component as needed so you can easily connect
them with other components.
4. Repeat steps 2 and 3 until all new components used in this example are placed on the
sheet.
When all the components are arranged, you can connect them as required for this example.
Connect the components as required for the controller. Using the simulation model shown
on Current and Speed Controlled DC Motor as a guide, place the cursor on the element pins
and set the beginning, the corners, and the end of a wire. Press Esc to exit the wire mode.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Note:
Connections to the motor’s LOAD (load torque), IA (armature current), and N (rotor
speed) parameters are not visible on the schematic. These connections are added
later.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
h. Click OK to save the dataset. The Add Dataset dialog box closes, returning you
to the main Datasets dialog box.
i. Click Done to close the Datasets dialog box. The Characteristic dialog box
should now show the name of the dataset you created in its Dataset field.
j. Click OK to close this dialog box.
k. On the 2D Look-up Table Parameters tab, select the Value check box in the
Outputs section.
l. Click OK to close the 2D Look-up Table Parameters dialog box.
2. Connect the output parameter value of the LOAD characteristic with the load of
the DC machine.
a. Open the LOAD characteristic Parameters dialog box.
b. On the Output/Display tab, clear the Show Pin check box for the VAL parameter,
and click OK to close the dialog box.
c. On the Parameters tab of the DC machine Parameters dialog box, type LOAD.VAL
in the Value field for the LOAD parameter. This connects the LOAD element char-
acteristic output to the machine’s LOAD input parameter.
d. In the Default Outputs section, select the N and IA check boxes for use later when
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
creating reports.
e. Click OK to close the dialog box.
The components that have been placed and connected still have their default parameter values.
You will now assign proper values for the components that comprise the PI Controller. Use the
simulation model figure "Current and Speed Controlled DC Motor " on page 5-1 as a guide.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
a. Double-click a summation symbol to the right of the P_GAIN block to open its Para-
meters dialog box.
b. Select the Use System Sample Time check box and clear the Block Output Signal
check box.
c. Click OK to apply the changes.
7. Define the parameters of the limiter block.
a. Double-click a limiter symbol to open its Parameters dialog box.
b. Change the Name to LIMITER and the Upper Limit of Output Signal (UL) to 20.
c. Click OK to apply the changes.
8. Define the parameters of the summation of machine current and limiter value.
a. Double-click a summation symbol to the right of the LIMITER block to open its Para-
meters dialog box.
b. For INPUT[1], clear the Use Pin check box.
c. Enter DCM.IA in the Input Signal field to link the DC machine armature current to
INPUT[1].
d. Click in the Sign column and select “–” from the list. The sign is applied to the DCM.IA
input signal.
e. Select the Use System Sample Time check box and clear the Block Output Signal
check box.
f. Click OK to apply the changes.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
l Y0 (Initial Value):1
l TS (Sample Time):5 with units us
d. Click OK to apply the changes.
10. Modify the parameters of transistor TR1.
a. Right-click a TR1 symbol to open its Parameters dialog box.
b. On the Parameters tab, clear the Control Signal field, then select the Use Pin check
box to reconnect the transistor's control pin to the output of the hysteresis block.
c. Click OK to close the dialog box.
All parameters of the PI controller should now have the correct values. This table lists all com-
ponents of the PI controller and their parameter values.
Sample Time=System
SUM1 P_GAIN Sample Time=System
I_GAIN Input[0]=N.VAL
INPUT[1]=N_REF.VAL
P_GAIN SUM2 KP (Proportional Gain)=50
Y0 (Initial Value)=0
UL (Upper Limit)=0
LL (Lower Limit)=0
Input[0]=P_GAIN.VAL
INPUT[1]=I_GAIN.VAL
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
LL (Lower Limit)=0
Input[0]=LIMITER.VAL
INPUT[1]=-DCM.IA
CONTR_OUT TR1.CTRL THRES1 (Threshold T1)=-2.5
Y0 (Initial Value)=1
TS (Sample Time)=5us
PHASE (Phase)= 0
Starting Simulation
Select Twin Builder > Analyze to start the simulation, or right-click Analysis in the Project
Manager pane and select Analyze. The simulation model is compiled and calculated.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
e. Click Add Trace to add the new scaled trace to the report.
f. Next select LOAD.VAL and apply a scale factor of 0.1k to it. The finished Y expres-
sion should be 0.1k*LOAD.VAL.
g. Click Add Trace to add the trace to the report.
h. Click Close to close the report dialog box. The plot should look similar to the this
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
image:
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
h. For 10*DCM.IA Y-axis, first clear the Auto Units check box and set Units to A, then
repeat steps a through f.
2. Change the X-axis Properties.
a. Select the X-axis for editing.
b. On the Scaling tab, clear the Auto Units check box and select a Units setting of s
(seconds).
c. Set Min value to 0, Max value to 0.1, Spacing to 0.01, and Minor Tick Divs to 1.
The sequence of block computation can significantly influence the simulation result. Select
Schematic > Sort Components to change the block sequence.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
You can also click Interactive, which closes the dialog box and displays the current sequence in
digits next to the blocks. To change the sequence, click the blocks in the desired sequence on
the sheet, or arrange the block list in a new sequence in the dialog box.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
VHDL-AMS Components
The Basic Elements VHDLAMS library provides the most common basic functionality, circuit
components and block elements as VHDL-AMS models developed according to IEEE 1076.1
(VHDL Analog and Mixed Signal Extensions Standard).
The functionality of the VHDL-AMS models is a subset of that available in the equivalent Twin
Builder SML (Twin Builder Modeling Language) models provided in the Basic Elements library.
You can use VHDL-AMS models in parallel with SML models. VHDL-AMS block and circuit mod-
els are simulated by the analog solver; while SML block elements are solved by a separate block
diagram simulator. Consequently, unlike SML models. VHDL-AMS models will not display step
delays along the simulator backplane. Numerical values of the VHDL-AMS data type generic are
defined at t = 0 and remain unchanged for the remainder of the simulation.
View the inputs and outputs of a VHDL-AMS model with the appropriate analog or digital report.
You can also view internal values used within the architecture of a model on reports and use
them as variables between models. However, if you must export the VHDL-AMS design to other
simulators, then internal values of the model should not be used outside the model.
The figure below shows the Schematic sheet of the simulation model and corresponding values
of the three-phase power supply, the rectifier bridge with static diodes and their characteristics,
the smoothing capacitor, and the VHDL-AMS machine component, DCM.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Some pins are not available yet. Leave these connections out in this step. The connections are
created later.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
4. On the Property Displays tab add this property and visibility settings:
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
3. Connect the input pin of the SUM3 with the current pin of the ammeter.
1. Select Twin Builder > Add Solution Setup > Transient to define the simulation para-
meters.
2. Change the default values for simulation End Time from 40ms to 100ms, for Min Time
Step from 10us to 1ns, and for Max Time Step from 1ms to 1us. Click OK to apply the
changes.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
6. Double-click XY Plotn to display the plot which should look similar to the one below.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder offers several ways to generate a model of this kind of device. In addition to the
implementation of the internal circuit structure, behavioral models are increasingly important
because they provide high simulation speed combined with sufficient accuracy.
This example contains PWM controllers designed using several distinct Twin Builder modeling
methods. All methods are included in one sheet so that you can easily compare the differences
between them.
The figure below shows the Schematic sheet of the PWM controllers with the corresponding val-
ues of components. The sheet contains these modeling variants:
l Equation
l Equation and Time Function
l State Graph
l Block Diagram
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Create a new Project and Schematic sheet for the Pulse-Width Modulation models that you are
designing. See Creating a New Project for details.
1. In the Basic Elements > Tools > Equations model library in the Component Libraries win-
dow, select the component Initial Values and drag it onto the sheet.
2. Double-click an ICA symbol to open the FML_INIT parameters dialog box. Click Add
to create a new entry. Click in the Equation field and enter FREQU:=10k.
3. Repeat step 2 to define the remaining initial values:
l HI:=5
l LO:=0
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
l DUTY:=0.8
4. Click OK to apply the changes.
As you build this model, note that Time and PI are used in the expressions describing the sim-
ulation model.
l The Twin Builder simulator uses intrinsic variables for internal computation. One of these
intrinsic variables is the simulation time: Time. You can use this read-only variable in
expressions.
l The simulator also provides some natural and mathematical constants used in math-
ematical expressions within component dialog boxes. One such constant is PI.
l In addition, some standard mathematical functions, such as cos, are used in the expres-
sions. Refer to the help for information on Twin Builder’s standard functions.
1. Select the Basic Elements > Tools > Equations library in the Component Libraries win-
dow. Select the FML:Equation component and drag it onto the sheet.
2. Double-click an EQU symbol to open the FML dialog box. Click Add to create a new Equa-
tion entry. Click in the Equation field and enter:
TRIANG1:=1/PI*acos(cos(2*PI*FREQU*Time))
3. Repeat step 2 and enter these equations:
l EPWM1:=HI*(TRIANG1<DUTY)+LO*(TRIANG1>DUTY)
l EPWM1_NORM:=TRIANG1<DUTY
4. Ensure that the Calculation Sequence for all equations remains at the default Before
Analog Solver setting. Click OK to apply the changes.
1. Select Twin Builder > Add Solution Setup > Transient to define the simulation para-
meters.
2. Change the default values for simulation End Time from 40ms to 100ms, for Min Time
Step from 10us to 1ns, and for Max Time Step from 1ms to 1us. Click OK to apply the
changes.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
1. To add an on-sheet plot, select Draw > Report > Rectangular Plot. A hollow rectangular
box appears with the cursor at its center. Move the rectangle and click in the schematic
window to place the plot center. The cursor moves to the lower-right corner of the rect-
angle. Drag the cursor to resize the rectangle as needed, then click again to finish placing
the plot.
2. Select Twin Builder > Output Dialog to open the Output dialog box. Define outputs for
TRIANG1, EPWM1, and EPWM1_NORM by selecting the output boxes of these quant-
ities. Click OK to apply the changes.
3. Double-click the on-sheet report to open the Report dialog box. Ensure that the Solution
is TR, the Domain and Primary Sweep are Time, and that the X channel is set to Default
via the check box.
4. Click All in the Category list. In the Quantity list Ctrl+click TRIANG1, EPWM1, and
EPWM1_NORM. Click Add Trace to add the traces to the plot, then Close to exit the dia-
log box.
5. Name the plot Equation Models. Right-click its current name under Results in the Pro-
ject Manager pane and select Rename. Press Enter to apply the change.
6. Save the project by choosing File > Save As and entering a name.
7. Select Twin Builder > Analyze to start the simulation. The simulation model is compiled
and calculated.
Simulation Results
The plot displays the simulation results for the triangle function (TRIANG1), actual PWM signal
(EPWM1) and normalized PWM signal (PWM1_NORM). The value of DUTY determines the
pulse width.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
1. In the Basic Elements > Tools > Time Functions library folder, select the TRIANG:Tri-
angular Wave component and drag it onto the sheet. Select the Equations folder and
drag an FML:Equation component onto the sheet.
2. Right-click a TRIANG symbol to open the Parameters dialog box. On the Parameters
tab, change the Name to TRIANG2. Set the Amplitude (AMPL) to 0.5, Frequency (FREQ)
to FREQU, and Offset (OFF) to 0.5.
3. Select Value (VAL) and clear the Show Pin box. Click OK to apply the changes.
Note:
You can leave the Value (VAL) output pin visible; note that the pin is not used in
this example.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
4. Double-click an EQU symbol to open the FML Parameters dialog box. Click Add to create
a new Equation entry. In the Equation field enter: EPWM2:=HI*(TRIANG2<DUTY)+LO*
(TRIANG2>DUTY).
5. Repeat the above step to add this equation: EPWM2_NORM:=TRIANG2<DUTY
6. Add an on-sheet Rectangular Plot as in the first example. However, for this plot, define out-
puts and add traces for the TRIANG2.VAL, EPWM2, and EPWM2_NORM signals.
7. Name the plot Equation and Time Function Model; and save the project using
File > Save As.
8. Select Twin Builder > Analyze to start the simulation. The simulation model is compiled
and calculated.
The resulting plot should be identical to the one plotted in the first example.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
1. Double-click an OFF state symbol to open its Parameters dialog box. Click Add to create
a new SET Action type entry. Enter EPWM3 in the Name field and LO in the Value field.
This entry means that the variable EPWM3 is set to the value LO if the state is active.
Create another SET entry and enter EPWM3_NORM in the Name field and 0 in the Value
field. Select the Activate State check box to set the state active at the beginning of sim-
ulation. Click OK to apply the changes. A blue circle in the symbol indicates the state is act-
ive.
2. Similarly define the parameters of the state ON component in its Parameters dialog box.
Create a new SET entry and enter EPWM3 in the Name field and HI in the Value field.
Create another SET entry and enter EPWM3_NORM in the Name field and 1 in the Value
field. Do not select the Activate State check box. Click OK to apply the changes.
3. Double-click TRANS1 and enter TRIANG3<DUTY in the Condition for transition field.
This entry means that the condition becomes true if the value of the triangular function,
TRIANG3, is lower than the DUTY value as defined in the initial value condition. Click OK
to apply the changes. Similarly, for TRANS2, enter TRIANG3>DUTY in the Condition for
transition field. In this case, the condition becomes true if the value of the triangular func-
tion is lower than the DUTY value. Click OK to apply the changes.
4. Double-click TRIANG3 to open its Parameters dialog box. On the Parameters tab, set
the Amplitude (AMPL) to 0.5, Frequency (FREQ) to FREQU, and Offset (OFF) to 0.5. On
the Output/Display tab, clear the Show Pin check box for Value (VAL) as the pin is not
used in this model. Click OK to apply the changes.
5. Add an on-sheet Rectangular Plot as in the previous examples. However, for this plot,
define outputs and add traces for the TRIANG3.VAL, EPWM3, and EPWM3_NORM sig-
nals.
6. Name the plot State Graph Model; and save the project using File > Save As.
7. Select Twin Builder > Analyze to start the simulation.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
The resulting plot should be identical to the one plotted in the first example.
This example models the PWM controller using block diagram components. The PWM is a com-
parator with two input signals: One input is the triangular wave and the other is the modulation
signal. The comparator compares the signals and provides an output signal proportional to the
modulation signal.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
7. Double-click a SUM symbol to open its Parameters dialog box. Click in the Sign column
of the triangular wave Input SignalTRIANG4.VAL and select the minus sign (–) from the
list. Click OK to apply the changes.
8. Double-click the uppermost comparator symbol to open its Parameters dialog box.
Change its Name to EPWM4. On the Parameters tab, set Val1 to LO. and Val2 to HI. On
the Output/Display tab, clear the Show Pin box for the output VAL. Click OK to apply the
changes.
9. For the remaining comparator, change its Name to EPWM4_NORM, Val1 to 0. and Val2
to 1. Clear the Show Pin box for the output VAL. Click OK to apply the changes.
10. Add an on-sheet rectangular plot as in the previous examples. However, for this plot,
define outputs and add traces for the TRIANG4.VAL, EPWM4.VAL, and EPWM4_
NORM.VAL signals.
11. Name the plot Block Diagram Model; and save the project using File > Save As.
12. Select Twin Builder > Analyze to start the simulation.
The resulting plot should be identical to the one plotted in the first three examples.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
In this example, you will import a Three-Phase Rectifier SSH file created in Simplorer version 7.
The legacy file’s component parameters, simulation setup parameters, and outputs translate
into a Simplorer Release 16.2 project, which you can then bring into Twin Builder Release 2018
or later for analysis and reports.
Hint You can also drag the file directly onto the open Simplorer window.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
l Use the Text Language panel to choose the Target language into which the pro-
ject’s text strings are translated. If the target language has no equivalent text for a
given element, configure the translation tool either to Ignore elements for which
there are no target language strings; or to use Substitute strings.
l Use the Symbol panel to select whether the symbols in the translated schematic
is Normal size or five times (5x) normal size. You can also select the symbol
Type and associated Symbol Language available for display on the translated
schematic.
4. For this example, we will use the default values, so leave the settings unchanged and click
OK to begin translation.
The Message Manager pane informs you of the progress of the translation.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Note:
l Virtually all of the project’s preprocessing data is translated.
l Optimetrics setup information, including design variables, is not translated.
However, the nominal model is translated.
l Solution data is not translated. Therefore, you must solve legacy Simplorer
projects again after translation. To import existing solution data, right-click
Analysis in the Project tree and select Import SDB File, or select Twin
Builder > Import SDB File on the main menu bar.
5. When translation is complete, choose File > Save As and save the translated project with
a name of your choosing before proceeding.
6. In the Project Manager pane, browse the Project tree.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
8. Select Simplorer > Output Dialog to open the Outputs dialog box and observe that the
defined outputs have been translated.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Now that you have confirmed that the necessary conditions for finding solutions for the trans-
lated circuit have been correctly set up, the next step is to open the translated schematic in Twin
Builder.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Starting an Analysis
To start an analysis:
You can also right-click Analysis in the Project Manager pane and select Analyze, or
press F12 to start the analysis.
The simulation model is compiled and outputs are calculated. During the simulation run,
the name of the model is visible in the Progress window, and a button to stop the sim-
ulation is available.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
At the end of the simulation, the simulator program remains open so you can run the sim-
ulation again if any model parameters changed.
2. After the simulation, the output quantities display in plots on the sheet or in report win-
dows. Output data is also saved in an SDB (Twin Builder Database) file.
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
. Components
B PI controller 5-6
Block diagram
D
Hysteresis controller 4-4
DC machine component 4-2
Modeling PI controller 5-4
DC machine component (VHDL-
Modeling PWM controller 7-7 AMS) 6-3
Block sample time 4-6 Deactivating components on the
sheet 4-15
Block sequence 5-12
Deleting, Components 4-1, 5-1
C design
Capacitor 3-1 adding a solution setup 4-1
Characteristic component 5-4 adding to project 2-5
Index-1
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
H
O
Hysteresis block 4-6, 5-7
Optimetrics, capabilities 2-2
I
P
Inductor 3-7
PI (predefined constant) 7-3
Initial conditions, setting 7-2
PI controller 5-6
Initial value component 4-2, 4-13,
7-2 Pins, Displaying 6-4
Index-2
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
project
S
creating 8-1
Setting initial conditions 7-2
saving 2-2, 8-1
Sign (signal processing block com-
Project Manager 2-4, 8-1 ponents) 7-9
State graph components 4-12 Starting, Simulation 3-1, 7-3, 7-5, 7-7,
7-9, 8-2
Time functions 7-5
State component 4-12
Property Names
State graph properties 4-12
Displaying 4-2
Summation 5-6
Moving 4-3
PWM Modeling T
Index-3
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential
Index-4
Twin Builder 2023 R2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential