pgaevaluate(1) [debian man page]

PGAEvaluate(1)							      PGAPack							    PGAEvaluate(1)

NAME

       PGAEvaluate - Calls a user-specified function to return an evaluation of each string in the population.

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 sig-
       naled the string's evaluation is out-of-date by a call to PGASetEvaluationUpToDateFlag().

INPUT PARAMETERS

       ctx    - context variable
       pop    - symbolic constant of the population to be evaluated
       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);
       comm   - an MPI communicator

OUTPUT PARAMETERS

       none

SYNOPSIS

       #include "pgapack.h"
       void  PGAEvaluate(ctx, pop, , comm)
       PGAContext *ctx
       int pop
       double (*f)(PGAContext *, int, int)
       MPI_Comm comm

LOCATION

       parallel.c

EXAMPLE

       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);

								     05/01/95							    PGAEvaluate(1)

PGASetUserFunction(8)						      PGAPack						     PGASetUserFunction(8)

NAME

       PGASetUserFunction  -  specifies  the  name of a user-written function call to provide a specific GA capability (e.g., crossover, mutation,
       etc.).

DESCRIPTION

       This function MUST be used when using a non-native datatype and must be called once for each of:
	 PGA_USERFUNCTION_CREATESTRING	   -- String creation
	 PGA_USERFUNCTION_MUTATION	   -- Mutation
	 PGA_USERFUNCTION_CROSSOVER	   -- Crossover
	 PGA_USERFUNCTION_PRINTSTRING	   -- String Output
	 PGA_USERFUNCTION_COPYSTRING	   -- Duplication
	 PGA_USERFUNCTION_DUPLICATE	   -- Duplicate Checking
	 PGA_USERFUNCTION_INITSTRING	   -- Initialization
	 PGA_USERFUNCTION_BUILDDATATYPE    -- MPI Datatype creation
	 PGA_USERFUNCTION_STOPCOND	   -- Stopping conditions
	 PGA_USERFUNCTION_ENDOFGEN	   -- Auxiliary functions at the end of each generation

       It MAY be called when using a native datatype to replace the built-in functions PGAPack has for that datatype (For example, if the  Integer
       data  type  is  used  for a traveling salesperson problem, the user may want to provide their own custom crossover operator).  See the user
       guide and the examples in the examples directory for more details.

INPUT PARAMETERS

       ctx    - context variable
       constant
	      - symbolic constant of the user function to set
       f      - name of the function to use

OUTPUT PARAMETERS

       none

SYNOPSIS

       #include "pgapack.h"
       void  PGASetUserFunction(ctx, constant, f)
       PGAContext *ctx
       int constant
       void *f

LOCATION

       user.c

EXAMPLE

       Example:
       void MyStringInit(PGAContext *, void *);
       PGAContext *ctx;
       :
       PGASetUserFunction(ctx, PGA_USERFUNCTION_INITSTRING, MyStringInit);

								     05/01/95						     PGASetUserFunction(8)