OptimT_Siman_Mutate_Proc
Abstract
Callback: Creates a new mutated solution for evaluation.
Syntax
<mutate_proc_name> (optim_handle, mutation_rate_factor)
| Argument | Type | Description |
|---|---|---|
optim_handle |
OptimT_Siman_Handle |
The optimization engine instance whose current solution state should be mutated. |
mutation_rate_factor |
double |
Indicates how far the annealing procedure has progressed as a fraction of the initial temperature. |
Return Type
void*
A new, mutated solution state (based on the optim_handle’s current solution state) or PRGC_NIL.
Header
optim_siman.h
Details
Callbacks of this type are the “workhorse” of the optimization engine. A siman_mutate_proc should use the ssptr from the optimization engine handle and create a new mutated or “candidate” solution for evaluation. It should return the mutated solution, and it should not modify the current ssptr. Most likely, the mutated solution will be evaluated immediately using a siman_mutate_proc, and might replace the current ssptr. The mutation_rate_factor serves to let the mutation procedure know how far along in the optimization process the engine has gotten and therefore allows it to mutate solutions more or less depending on this factor. If, for some reason, a siman_mutate_proc cannot create a new solution, it should return PRGC_NIL.