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)