Optimizer Object
With the optimizer object you may start an optimization run. For the optimization you have to define a set of parameters that will be changed by the optimizer and at least one goal function that is tried to be optimized. The kind of goal function depends on the chosen solver type.
SetSimulationType ( enum simType )
Chooses the simulation type to be used for the optimization either a solver module or the template based postprocessing.
simType can have one of the following values:
|
E-Static Solver |
Selects the electrostatics solver. |
|
M-Static Solver |
Selects the magnetostatics solver. |
|
Stationary Current Solver |
Selects the stationary current solver. |
|
LF Frequency Domain Solver |
Selects the low frequency solver. |
|
LF Time Domain Solver |
Selects the lf-time domain solver. |
|
Template Based Postprocessing |
Selects the template based postprocessing. |
Start
Starts the optimizer with the previously made settings.
InitParameterList
Initialize the optimizer's parameter list from the projects parameter list.
ResetParameterList
Deselect all parameters in the optimizer's parameter list. After calling this function no parameter is chosen to be optimized.
SelectParameter ( name paraName, bool bFlag )
Select the parameter specified by its name paraName. If bFlag is True the parameter named paraName is chosen to be optimized.
SetParameterInit ( double value )
This method initializes a previously selected parameter with the given value. The parameter is selected using the SelectParameter method.
SetParameterMin ( double value )
Set the minimum value the currently selected parameter can reach. You must select a parameter using the SelectParameter method before you can apply this method.
SetParameterMax ( double value )
Set the maximum value the currently selected parameter can reach. You must select a parameter using the SelectParameter method before you can apply this method.
SetParameterAnchors ( int number )
If you use the interpolated Quasi-Newton optimizer (see also SetOptimizerType), it is necessary to specify the number of samples per parameter used while the optimization is running. Set the number of samples for a selected parameter using this method. You must select a parameter using the SelectParameter method before you can apply this method.
SetMinMaxAuto ( double percentage )
Sets the specified percentage for the calculation of the minimum and maximum values for all parameters.
SetAndUpdateMinMaxAuto ( double percentage )
Resets the minimum and maximum values for all parameters. The new minimum and maximum values are calculated by subtracting respectively adding the specified percentage of the current parameter values to the current parameter values. If a parameter is 0 (or very close to 0), the minimum and maximum values are set to the negative respectively positive percentage value.
SetAlwaysStartFromCurrent ( bool bFlag )
Activate this method to initialize the optimizer with the current settings (bFlag = True), i.e. you can proceed optimizing your model starting each time from the previously optimized parameter results. However, if you want to restart the optimizer several times with the same initial parameter settings this method should be deactivated (bFlag = False).
SetUseDataOfPreviousCalculations ( bool bFlag )
Activate this method to trigger the import of previously calculated results for new optimizations to speed up the optimization process. If the result templates on which the optimizer goals are based were already evaluated before and the corresponding parameter combinations lie in the defined parameter space the results might be imported without the need for recalculation. For the local algorithms it's possible that the initial point is replaced if a more suitable point is found in advance. For the algorithms that use a set of initial points, multiple initial points will be replaced by points that lie close or have a better goal value than the points in the close neighbourhood. This may disturb the selected distribution type but the algorithm will find a good compromise between finding points with good goal value and a well distributed set of starting points in the parameter space. Keep in mind that this feature will make the reproducibility of optimizations more difficult because after an optimization there will be more potential imports available than before.
GetNumberOfVaryingParameters long
Returns the number of varying parameters.
GetNameOfVaryingParameter ( int index ) name
Returns the name of the parameter referenced by index between 0 and N-1, where N can be determined by GetNumberOfVaryingParameters.
GetValueOfVaryingParameter ( int index ) double
Returns the value of the parameter referenced by index between 0 and N-1, where N can be determined by GetNumberOfVaryingParameters.
Methods Concerning Goals in General
AddGoal ( enum goalType ) long
Creates a new goal and adds it to the internal list of goals. Upon creation an ID is created for each goal which is returned by this function. The newly defined goal is selected automatically for use with the currently selected optimizer. The newly defined goal is selected automatically for use with the currently selected optimizer.
goalType can have one of the following values:
|
"1D Primary Result" |
Adds a goal for 1D result data |
A goal specification can be done on some 1D result in the result tree, e.g. Time signal equal zero at t equal 3 Milliseconds. |
|
"1DC Primary Result" |
Adds a goal for complex valued 1D result data |
A goal specification can be done on some complex valued 1D result in the result tree, e.g. S-Parameter "S11" smaller -20 dB from 2-3 GHz. |
|
"0D Result" |
Adds a template based post processing goal for 0D result data |
A goal specification can be done on some template based post processing result that creates a single value, e.g. the maximum gain of a farfield monitored at a certain frequency. |
|
"1D Result" |
Adds a template based post processing goal for 1D result data |
A goal specification can be done on some template based post processing that creates1D result data. |
|
"1DC Result" |
Adds a template based post processing goal for complex valued 1D result data |
A goal specification can be done on some template based post processing that creates1DC result data. |
SelectGoal ( long id, bool bFlag )
Selects the goal specified by its ID id. The ID is returned when the goal is created using the AddGoal function. It is necessary to call this method before many other methods may be called because these other methods apply to a previously selected goal.
If bFlag is True the selected goal is used for the optimization else it is ignored.
DeleteGoal ( long id )
Deletes the specified goal. To specify the goal use the ID that is returned by the AddGoal function when the goal is created.
DeleteAllGoals
Deletes all goals that were previously created.
SetGoalSummaryType( enum {"Sum_All_Goals", "Max_All_Goals"} summaryType )
Selects a summary type of all goals. The optimizer will minimize the sum or the maximum of all goals corresponding to what is selected.
SetGoalUseFlag ( bool bFlag )
Marks a previously defined goal to be used or not to be used for the optimization. You must select a previously defined goal using the SelectGoal method before you can apply this method.
SetGoalOperator ( enum operatorType )
Almost every goal needs a goal operator that indicates how to evaluate the goal function value. The selectable operator types depend on the goal type of the currently selected goal. E.g. the operators "min", "max", "<", ">" or "=" indicate that a goal function should be minimized, maximized, lowered under or raised upon a certain value or that the goal function should reach a certain value respectively. You must select a previously defined goal using the SelectGoal method before you can apply this method.
operatorType can have one of the following values:
|
< |
lower goal function value under a given target value |
0D and 1D template based post processing goals |
|
> |
raise goal function value upon a given target value |
0D and 1D template based post processing goals
|
|
=
|
0D and 1D template based post processing goals
|
0D and 1D template based post processing goals |
|
min
|
minimize goal function
|
1D results based on the amplitude or dB entity of an S-Parameter template |
|
max
|
maximize goal function |
1D results based on the amplitude or dB entity of an S-Parameter template |
|
move min |
minimize the abscissa distance of the minimum of the 1D result to the selected target. Keep in mind that sensitivities can't be exploited if this goal is used because the min operator is not differentiable |
1D template based post processing goals |
|
move max |
minimize the distance of the maximum of the 1D result to the selected target. Keep in mind that sensitivities can't be exploited if this goal is used because the max operator is not differentiable |
1D template based post processing goals |
SetGoalTarget ( double value )
Sets a target value for a previously defined goal. You must select a previously defined goal using the SelectGoal method before you can apply this method.
SetGoalWeight ( double value )
Each goal can be weighted. Thus it is possible to distinguish between goals of greater or less importance. You must select a previously defined goal using the SelectGoal method before you can apply this method.
SetGoalScalarType( enum {"maglin", "magdb10", "magdb20", "real", "imag", "phase"} scalarType )
Defines the real scalar type of the complex valued result on which the goal operator is evaluated.
Methods Concerning Special Goal Settings
SetGoal1DResultName ( name resultName )
Set the tree name of a 1D result to the previously selected 1D goal.
SetGoal1DCResultName ( name resultName )
Set the tree name of a complex valued 1D result to the previously selected 1DC goal.
SetGoalTemplateBased0DResultName ( name resultName )
Set the name of a template based post processing 0D result. The name needs to be an absolute path containing the template based post processing path and the template name to the previously selected template based postprocessing 0D goal.
SetGoalTemplateBased1DResultName ( name resultName )
Set the name of a template based post processing 1D result. The name needs to be an absolute path containing the template based post processing path and the template name to the previously selected template based postprocessing 1D goal.
SetGoalTemplateBased1DCResultName ( name resultName )
Set the name of a complex valued template based post processing 1D result. The name needs to be an absolute path containing the template based post processing path and the template name to the previously selected template based postprocessing 1DC goal.
SetGoalRange ( double Min, double Max )
Set a range for a previously selected 1D or 1DC result goal. You must select a previously defined 1D result goal using the SelectGoal method before you can apply this method.
SetGoalRangeType ( enum {"total", "range", "single"} rangeType )
For a defined template based post processing 1D result goal, you can define the range that is being evaluated with this goal while the optimization is running. If the 1D result goal is based on an S-Parameter template then the range may cover the entire frequency range (total) of the simulation, only a part of the simulation's frequency range (range) or only one single frequency point (single). You must select a previously defined 1D result goal using the SelectGoal method before you can apply this method.
UseSlope ( bool bFlag )
Sets a previously defined goal to use a slope for the goal operator. The selected goal needs to be defined on a range and the operators have to be "<", ">" or "=". The slope will be from the target at the minimum range to the maximum target at the maximum range.
SetGoalTargetMax ( double target2 )
Sets a previously defined goal to use target2 as maximum target. This setting has only an effect if the goal is set to use a slope operator, set by the method UseSlope.
Methods Concerning Special Optimizer Settings
SetOptimizerType ( enum optimizerType )
You can choose between seven kinds of optimizer types here. If the runtime of the solver is long the Trust Region Framework is recommended, especially when the starting point of the optimization is already in the neighbourhood of the expected optimum. If the solver evaluation is quick the Covariance Matrix Adaptation Evolutionary Strategy may be superior because of it's global optimization algorithm properties. The Nelder Mead Simplex algorithm is also know to work well on multiple problems.
optimizerType can have one of the following values:
|
"Trust_Region"
|
Selects a local optimizing technique embedded in a trust region framework. The algorithm starts with building a linear model on primary data in a "trust" region around the starting point. For building this model sensitivity information of the primary data will be exploited if provided. Fast optimizations are done based on this local model to achieve a candidate for a new solver evaluation. The new point is accepted, if it is superior to the anchors of the model. If the model is not accurate enough the radius of the trust region will be decreased and a model on the new trust region will be created. The algorithm will be converged once the trust region radius or distance to the next predicted optimum becomes smaller than the specified domain accuracy. |
|
"Nelder_Mead_Simplex" |
Selects the local Simplex optimization algorithm by Nelder and Mead. This method is a local optimization technique. If N is the number of parameters, it starts with N+1 points distributed in the parameter space. |
|
"CMAES"
|
Selects the global Covariance Matrix Adaptation Evolutionary Strategy. The method follows a global optimization approach in general. An internal step size parameter introduces a convergence property to the method. |
|
"Genetic_Algorithm" |
Selects the global genetic optimizer. |
|
"Particle_Swarm" |
Selects the global particle swarm optimizer. |
|
"Interpolated_NR_VariableMetric" |
Selects the local optimizer supporting interpolation of primary data. This optimizer is fast in comparison to the Classic Powell optimizer but may be less accurate. In addition, you can set the number N of optimizer passes (1 to 10) for this optimizer type. A number N greater than 1 forces the optimizer to start over (N-1) times. Within each optimizer pass the minimum and maximum settings of the parameters are changed approaching the optimal parameter setting. Increase the number of passes to values greater than 1 (e.g., 2 or 3) to obtain more accurate results. It is recommended for the most common EM optimizations not to increase the number higher than 3 but to increase the number of samples in the parameter list, if the results are not suitable. |
|
"Classic Powell" |
Selects the local optimizer without interpolation of primary data. In addition, it is necessary to set the accuracy, which effects the accuracy of the optimal parameter settings and the time of termination of the optimization process. For optimizations with more than one parameter the Trust Region Framework, the Interpolated Quasi Newton or the Nelder Mead Simplex Algorithm should be preferred to this technique. |
SetUseInterpolation ( enum {"Second_Order"} interpolationType, enum {"Genetic_Algorithm", "Particle_Swarm" } optimizerType )
This option is only available for the Genetic Algorithm or the Particle Swarm Optimization. Check this box to activate the interpolation, and disables the sample values in the parameter list.
For both global optimizers it is possible to switch on the Interpolation of Primary Data. If the interpolation is applied the only true solver runs that will be done are the ones for the evaluation of the specified anchors and a final solver run for the estimated best parameters. All other goal function evaluations will be interpolated.
Please note that global optimization algorithms have the probability of exploring most of the parameter space. Thus it is most likely that all or nearly all anchor points will actually be evaluated. Keep in mind that the number of solver runs needed for interpolation is dependant of the number of parameters whereas the number of solver runs needed for the two global optimization algorithms are independent of the number of parameters. Because of this, the usage of the interpolation feature will only pay off if the parameter space is not too high dimensional or a large number of iterations is planned.
Since the possible goal functions that can be defined have always non negative values the optimization will automatically be stopped if one of the anchor evaluations yields a goal value equal zero.
SetGenerationSize ( double size, enum {"Genetic_Algorithm", "Particle_Swarm" } optimizerType )
It's possible to specify the population size for the Genetic Algorithm or the Particle Swarm Optimization. Keep in mind that choosing a small population size increases the risk that the genes can be depleted. If a large population size is chosen there will be more solver evaluations necessary for the calculation of each generation.
SetMaxIt ( double max_it, enum {"Genetic_Algorithm", "Particle_Swarm", "CMAES" } optimizerType )
Set the maximal number of iterations. The Genetic Algorithm or the Particle Swarm Optimization will stop after the maximal number of iterations have been done. Like this, it is possible to estimate the maximal optimization time a priori. If "n" is the population size and "m" is the maximal number of iterations "(m+1)*n/2 + 1" solver runs will be done. However this estimation is not valid if the Interpolation feature SetUseInterpolation is switched on, the optimization is aborted or the desired accuracy is reached
SetInitialDistribution ( enum {"Uniform_Random_Numbers", "Latin_Hyper_Cube", "Noisy_Latin_Hyper_Cube", "Cube_Distribution"} distributionType, enum {"Genetic_Algorithm", "Particle_Swarm", "Nelder_Mead_Simplex"} optimizerType )
For the featured global optimization techniques and the Nelder Mead Simplex Algorithm a set of initial points in the parameter space are necessary. These points will automatically be generated by a uniform random distribution generator or by the Latin Hypercube approach.
Uniform Random Numbers: For each starting point a pseudo random number generator will choose uniformly distributed points in the parameter space.
Latin Hypercube: Randomly chosen points sometimes have the disadvantage that they do not have optimal space filling properties in the parameter space. The Latin Hypercube sampling has the special property that a projection onto each parameter interval yields an equidistant sampling.
Noisy Latin Hypercube Distribution: The initial points are distributed similar to the Latin Hypercube Distribution but a perturbation is added on each point. This distribution type has similar space filling properties as the Latin Hypercube Distribution but the generated point set will be less regular. This distribution type is only available for the Nelder Mead Simplex Algorithm.
SetGoalFunctionLevel ( double level, enum {"Genetic_Algorithm", "Particle_Swarm", "Nelder_Mead_Simplex" } optimizerType )
A desired goal function level can be specified for the Genetic Algorithm or the Particle Swarm Optimization. The algorithm will be stopped if the goal function value is less than the specified level. However, if the optimization is done distributed this criterion will only be checked after the complete population was calculated. If the desired level is set to zero then the Maximal Number of Iterations is the only breaking condition. This setting is very convenient if the defined goals can't be satisfied per definition or are very unlikely to be reached exactly.
SetMutaionRate ( double rate, enum {"Genetic_Algorithm", "Particle_Swarm" } optimizerType )
If the genes of two parents are similar enough the mutation rate specifies the probability that a mutation occurs. This option is only available for the Genetic Algorithm and the Particle Swarm Optimization.
SetMinSimplexSize ( double size )
Sets the minimal simplex size for the Nelder Mead Simplex Algorithm. For optimization the parameter space is mapped onto the unit cube. The simplex is a geometrical figure that moves in this multidimensional space. The algorithm will stop as soon as the largest edge of the Simplex will be smaller than the specified size. If the optimization is defined over just one parameter in the interval [0;1] then this setting corresponds with the desired accuracy in the parameter space.
SetUseMaxEval ( bool bFlag, enum {"Nelder_Mead_Simplex", "CMAES" } optimizerType )
Set this option to enable the use of the maximal number of evaluations. This option is only available for the Nelder Mead Simplex Algorithm and CMAES.
SetMaxEval ( double number, enum {"Nelder_Mead_Simplex", "CMAES" } optimizerType )
Sets the maximal number of evaluations for the Nelder Mead Simplex Algorithm or CMAES. Depending on the optimization problem definition it is possible that the specified goal function level can't be reached. In this case it is convenient to define a maximal number of function evaluations to restrict optimization time a priory. This number has to be greater than one.
SetUsePreDefPointInInitDistribution ( bool bFlag, enum {"Nelder_Mead_Simplex", "CMAES" } optimizerType )
This option is only available for the Nelder Mead Simplex Algorithm and CMAES. If this feature is switched on then the point that is defined as anchor point in the parameter list will be included in the initial data set of the algorithm. If the current parameter settings are already quite good then it makes sense to include this point in the starting set. After the set of initial points is generated the closest point from the automatically generated set will be substituted with the predefined point. However if the current point was created by a previous optimization run of a local optimizer and a second optimization is planned on a reduced parameter space this setting should be turned off because it increases the risk that the second optimization will converge to the same local optimum as before. In this case the second optimization won't yield any improvement.
SetNumRefinements ( long number )
Sets the number of Quasi-Newton optimizer passes. With each Quasi-Newton optimizer pass past the first pass, the minimum and maximum parameter values are refined around the optimal parameter values found in the previous pass.
SetDomainAccuracy ( double accuracy, enum {"Trust_Region" } optimizerType )
Set the accuracy of the optimizer in the parameter space if all parameter ranges are mapped to the interval [0,1]. This option is only available for the Trust Region Framework.
SetSigma ( double value, enum {"CMAES" } optimizerType )
This option is only available for CMAES. It sets the sigma of the normal distribution used in the algorithm to the defined value, which must be greater zero and less or equal one.
SetAccuracy ( double accuracy )
This value defines when the Classic Powell optimizer stops. It is a norm of the difference between the actual and the previous set of parameters.
So general speaking the Powell optimizer stops, if the change of all the parameters used is smaller than the value given here.
SetDataStorageStrategy ( enum {"All", "Automatic", "None"} storageType )
Sets the storage strategy for the 1D results produced during the optimization. For optimizations which generate much results on each evaluation or are expected to run for many evaluations it's possible to save time and disc space by avoiding the storage of the signals via the option "None". This setting doesn't apply to the template based post processing results.
SetMinMaxAuto (10.0)
SetParameterAnchors (5)
SetAlwaysStartFromCurrent (True)
SetGoalUseFlag (True)
SetGoalOperator ("<")
SetGoalTarget (0.0)
SetGoalWeight (1.0)
SetOptimizerType ("Nelder_Mead_Simplex")
SetAccuracy (0.01 )
SetNumRefinements (1)
Dim goalID As Long
With Optimizer
.SetOptimizerType ("Interpolated_NR_VariableMetric")
.SetSimulationType ("Electrostatic")
.SetNumRefinements (1)
.SetMinMaxAuto (10)
.SetAlwaysStartFromCurrent (False)
.SelectParameter ("r", True)
.SetParameterInit (17)
.SetParameterMin (15.3)
.SetParameterMax (18.7)
.SetParameterAnchors (5)
.SelectParameter ("ts", False)
.SetParameterInit (0.05)
.SetParameterMin (0.045)
.SetParameterMax (0.055)
.SetParameterAnchors (5)
.SelectParameter ("ws", False)
.SetParameterInit (4)
.SetParameterMin (3.6)
.SetParameterMax (4.4)
.SetParameterAnchors (5)
.SetGoalSummaryType ("Sum_All_Goals")
.SetUseDataOfPreviousCalculations (False)
goalID = .AddGoal ("0D Result")
.SelectGoal (goalID, True)
.SetGoalOperator ("<")
.SetGoalTarget (0.0)
.SetGoalWeight (1.0)
.SetGoalTemplateBased0DResultName ("S11_fctr")
.Start
End With