This section discusses the APIs provided by ACT to customize DesignXplorer DOE functionality.
The object PSMtrxGenerator is responsible
for the execution of the DOE. Regardless of whether the sampling is
built-in or external, it executes the same process via the sampling
API.
The following figure shows the DesignXplorer sampling architecture.
The main elements of the API are:
ISamplingMethod: The main interface between DX and the external
sampling, which is required to implement it
IServices: The interface for the external sampling to access DX
services, such as the calculation of one or more points
DXPoint: The class that describes and stores the point data, such as
variable values, calculation state, and so on.
For more information, see the "API Description" section for DesignXplorer in the ANSYS ACT API Reference Guide.
The PSMtrxGenerator object drives the sampling process as shown in the
following sequence diagram.
First, the sampling process retrieves an instance of the sampling through the callback
declared in the extension. It provides the Services
object and transfers the complete sampling definition: all variables, parameter
and settings.
The object PSMtrxGenerator retrieves an instance of the sampling each
time the sampling process is started by invoking the callback
OnCreate. The PSMtrxGenerator
object releases the instance on completion by invoking the callback
OnRelease.
After a final check CanRun, the sampling's method
Run is invoked. From this point in the sequence, the
external sampling triggers the calculation of points as needed and pushes
progress messages and log messages, depending on its capabilities.