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)