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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
|
/*
COPYRIGHT
The following is a notice of limited availability of the code, and disclaimer
which must be included in the prologue of the code and in all source listings
of the code.
(C) COPYRIGHT 2008 University of Chicago
Permission is hereby granted to use, reproduce, prepare derivative works, and
to redistribute to others. This software was authored by:
D. Levine
Mathematics and Computer Science Division
Argonne National Laboratory Group
with programming assistance of participants in Argonne National
Laboratory's SERS program.
GOVERNMENT LICENSE
Portions of this material resulted from work developed under a
U.S. Government Contract and are subject to the following license: the
Government is granted for itself and others acting on its behalf a paid-up,
nonexclusive, irrevocable worldwide license in this computer software to
reproduce, prepare derivative works, and perform publicly and display
publicly.
DISCLAIMER
This computer code material was prepared, in part, as an account of work
sponsored by an agency of the United States Government. Neither the United
States, nor the University of Chicago, nor any of their employees, makes any
warranty express or implied, or assumes any legal liability or responsibility
for the accuracy, completeness, or usefulness of any information, apparatus,
product, or process disclosed, or represents that its use would not infringe
privately owned rights.
*/
/*****************************************************************************
* FILE: user.c: This file contains a function to set user functions.
*
* Authors: David M. Levine, Philip L. Hallstrom, David M. Noelle,
* Brian P. Walenz
*****************************************************************************/
#include "pgapack.h"
/*U****************************************************************************
PGASetUserFunction - specifies the name of a user-written function
call to provide a specific GA capability (e.g., crossover,
mutation, etc.). 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.
Category: Generation
Inputs:
ctx - context variable
constant - symbolic constant of the user function to set
f - name of the function to use
Outputs:
None
Example:
void MyStringInit(PGAContext *, void *);
PGAContext *ctx;
:
PGASetUserFunction(ctx, PGA_USERFUNCTION_INITSTRING, MyStringInit);
****************************************************************************U*/
void PGASetUserFunction(PGAContext *ctx, int constant, void *f)
{
PGADebugEntered("PGASetUserFunction");
if (f == NULL)
PGAError ( ctx, "PGASetUserFunction: Invalid function",
PGA_FATAL, PGA_VOID, NULL);
switch (constant) {
case PGA_USERFUNCTION_CREATESTRING:
if (ctx->sys.UserFortran)
PGAError(ctx, "PGASetUserFunction: Cannot call "
"PGA_USERFUNCTION_CREATESTRING from Fortran.",
PGA_FATAL, PGA_VOID, NULL);
else
ctx->cops.CreateString = (void(*)(PGAContext *, int, int, int))f;
break;
case PGA_USERFUNCTION_MUTATION:
if (ctx->sys.UserFortran)
ctx->fops.Mutation = (int(*)(void *, void *, void *, void *))f;
else
ctx->cops.Mutation = (int(*)(PGAContext *, int, int, double))f;
break;
case PGA_USERFUNCTION_CROSSOVER:
if (ctx->sys.UserFortran)
ctx->fops.Crossover = (void(*)(void *, void *, void *, void *, void *, void *, void *))f;
else
ctx->cops.Crossover = (void(*)(PGAContext *, int, int, int, int, int, int))f;
break;
case PGA_USERFUNCTION_PRINTSTRING:
if (ctx->sys.UserFortran)
ctx->fops.PrintString = (void(*)(void *, void *, void *, void *))f;
else
ctx->cops.PrintString = (void(*)(PGAContext *, FILE *, int, int))f;
break;
case PGA_USERFUNCTION_COPYSTRING:
if (ctx->sys.UserFortran)
PGAError(ctx, "PGASetUserFunction: Cannot call "
"PGA_USERFUNCTION_COPYSTRING from Fortran.",
PGA_FATAL, PGA_VOID, NULL);
else
ctx->cops.CopyString = (void(*)(PGAContext *, int, int, int, int))f;
break;
case PGA_USERFUNCTION_DUPLICATE:
if (ctx->sys.UserFortran)
ctx->fops.Duplicate = (int(*)(void *, void *, void *, void *, void *))f;
else
ctx->cops.Duplicate = (int(*)(PGAContext *, int, int, int, int))f;
break;
case PGA_USERFUNCTION_INITSTRING:
if (ctx->sys.UserFortran)
ctx->fops.InitString = (void(*)(void *, void *, void *))f;
else
ctx->cops.InitString = (void(*)(PGAContext *, int, int))f;
break;
case PGA_USERFUNCTION_BUILDDATATYPE:
if (ctx->sys.UserFortran)
PGAError(ctx, "PGASetUserFunction: Cannot call "
"PGA_USERFUNCTION_BUILDDATATYPE from Fortran.",
PGA_FATAL, PGA_VOID, NULL);
else
ctx->cops.BuildDatatype = (MPI_Datatype(*)(PGAContext *, int, int))f;
break;
case PGA_USERFUNCTION_STOPCOND:
if (ctx->sys.UserFortran)
ctx->fops.StopCond = (int(*)(void *))f;
else
ctx->cops.StopCond = (int(*)(PGAContext *))f;
break;
case PGA_USERFUNCTION_ENDOFGEN:
if (ctx->sys.UserFortran)
ctx->fops.EndOfGen = (void(*)(void *))f;
else
ctx->cops.EndOfGen = (void(*)(PGAContext *))f;
break;
default:
PGAError(ctx, "PGASetUserFunction: Invalid constant:",
PGA_FATAL, PGA_INT, (void *) &constant);
break;
}
PGADebugExited("PGASetUserFunction");
}
|
