1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63
|
.TH PGAEvaluate 1 "05/01/95" " " "PGAPack"
.SH NAME
PGAEvaluate \- Calls a user-specified function to return an evaluation of
each string in the population.
.SH DESCRIPTION
The user-specified function is only called
if the string has been changed (e.g., by crossover or mutation) or the user
has explicitly signaled the string's evaluation is out-of-date by a call
to PGASetEvaluationUpToDateFlag().
.SH INPUT PARAMETERS
.PD 0
.TP
ctx
- context variable
.PD 0
.TP
pop
- symbolic constant of the population to be evaluated
.PD 0
.TP
f
- a pointer to a function to evaluate a string. This function will
be called once for each string in population pop that requires
evaluation. This function must return a double (the evaluation
function value) and must fit the prototype
double f(PGAContext *c, int p, int pop);
.PD 0
.TP
comm
- an MPI communicator
.PD 1
.SH OUTPUT PARAMETERS
.PD 0
.TP
none
.PD 1
.SH SYNOPSIS
.nf
#include "pgapack.h"
void PGAEvaluate(ctx, pop, , comm)
PGAContext *ctx
int pop
double (*f)(PGAContext *, int, int)
MPI_Comm comm
.fi
.SH LOCATION
parallel.c
.SH EXAMPLE
.nf
Example:
Evaluate all strings in population PGA_NEWPOP using the user-defined
evaluation function Energy.
double Energy(PGAContext *ctx, int p, int pop) {
:
};
PGAContext *ctx;
:
PGAEvaluate(ctx, PGA_NEWPOP, Energy, MPI_COMM_WORLD);
.fi
|