Changes between Version 3 and Version 4 of OptimizationTclApi

Timestamp:

Jun 10, 2008 11:09:28 AM (16 years ago)

Author:

mmc

Comment:

added the "samples" method

OptimizationTclApi

@@ -32 +32 @@
 
 Used to query the value of one or more optimization parameters.  With no arguments, this command returns a list of all optimization parameters and their current settings in the form:  ''{name type -option1 value1 -option2 value2 ...} {name type -option1 value1 -option2 value2 ...}''.  If the ''namePattern'' is specified, it is treated as a glob-style pattern and returns a list of parameters with matching names.  If there is more than one matching parameter, the result has the form shown earlier.  If there is a single matching parameter, then the result has the form:  ''type -option1 value1 -option2 value2 ...''.  If the ''-option'' is also specified, then it returns the value for the specified option across all matching parameters.  If two or more parameters match the ''namePattern'', then the result will have the form:  ''{name value} {name value} ...''.  If a single parameter matches and the ''-option'' is specified, then the result is a single value.
+
+----
+
+''name'' '''samples''' ''?number?''
+
+Used to query information about the samples involved in an optimization.  This can be called during the optimization (as part of the -updatecommand) or after the optimization is done.  With no extra arguments, it returns the number of samples evaluated so far.  Given a specific sample number (starting from 0), this returns a list of the form {{{f p1 p2 p3 ...}}}, where {{{f}}} is the value of the fitness function for that sample, and {{{p1}}}, {{{p2}}}, {{{p3}}}, ..., are the values of the input parameters.
 
 ----