asa-changes

simulated annealing code ASA

========================================================================
30 Nov 99

Makefile, readme.ms:
Use psselect to put contents after cover page in ASA-README.ps.

Makefile, asa.c, readme.ms:
Moved some OPTIONS to Printer Options section.

========================================================================
27 Nov 99

asa.c, asa_user.h, user.c:
Put array for temporary storage of exit_msg[] in asa_user.h.

========================================================================
25 Nov 99

asa.c, user.c:
Added char exit_msg[] for Exit_ASA() and Exit_USER() to avoid multiple
warnings of char* conversions under some compilers.

========================================================================
18 Nov 99

asa.c, readme.ms:
If ASA_QUEUE and ASA_PRINT_MORE are TRUE then, whenever a queued cost
function is used, this is recorded in asa_out.

========================================================================
16 Nov 99

asa.c, asa_user.h, readme.ms, user.c;
ASA_QUEUE and ASA_RESOLUTION may be used separately or together, creating
somewhat different sampling procedures.

========================================================================
14 Nov 99

asa_user.h, readme.ms:
When ASA_SAVE_BACKUP is TRUE, ASA_SAVE is automatically set to TRUE
in asa_user.h.

========================================================================
13 Nov 99

Makefile, asa_opt, asa.c, asa_user.h, readme.ms, user.c:
If ASA_SAVE is set to TRUE, when ASA_SAVE_BACKUP is set to TRUE, asa
saves enough information after each newly best accepted state to restart
from any previous best accepted state when that asa_save.{best_state}
is copied to asa_save.  The new asa_opt file (with modified first and
last lines) can be used to insert new code before restarting runs.

========================================================================
10 Nov 99

readme.ms:
Added more references to arrays to be developed under several OPTIONS,
adding more hyperlinks in ASA-README.html.

========================================================================
4 Nov 99

asa.c:
ASA_PIPE_FILE prints out first header line with a "#" as first character,
which can provide a useful comment signal to a graphics tool.

asa.h, asa_user.h:
Moved G_FIELD and G_PRECISION defines to asa_user.h.

========================================================================
21 Oct 99

asa.c:
fclose (ptr_asa_pipe).

========================================================================
19 Oct 99

Makefile, asa.c, asa_user.h, readme.ms:
When ASA_PIPE_FILE is set to TRUE, asa prints to asa_pipe lines of data
that can be used to examine run data.

========================================================================
30 Sep 99

user.c:
Added some more info around some TEMPLATEs.

Makefile, asa.c, asa_user.h, readme.ms, user.c:
Changed OPTIONAL_DATA, Asa_Data_Dim, and Asa_Data, to
OPTIONAL_DATA_DBL, Asa_Data_Dim_Dbl, and Asa_Data_Dbl.

========================================================================
29 Sep 99

Makefile, asa.c, asa_user.h, readme.ms:
Added OPTIONAL_DATA_PTR to return/pass additional array or structure
information of type OPTIONAL_PTR_TYPE to the user module from/through
the asa module.

Makefile, asa.c, asa_user.h, readme.ms:
Added ASA_PIPE to print to STDOUT lines of data after calls to the cost
function, which can be used to update databases or graphs in real time.

ASA-README.html:
Added asa_back.jpg file (asa_back.jpg.uu in the shar version).

========================================================================
21 Sep 99

asa.c, readme.ms, user.c:
Added comments re use of USER_ACCEPT_ASYMP_EXP to be used as a template
for USER_ACCEPTANCE_TEST.  Moved some declarations inside #if
statements to avoid unnecessary warnings of unused variables.

========================================================================
8 Sep 99

asa.c, asa.h, readme.ms:
Added INVALID_COST_FUNCTION_DERIV with an exit code of 9, to tell user
when an invalid cost function or parameter is developed within the
calculation of numerical derivatives, causing an asa() exit.

========================================================================
19 Aug 99

NOTES, readme.ms:
All .Z files changed to .gz files.  ASA is now available in ASA.tar.gz,
ASA.zip and ASA-shar formats.

========================================================================
28 Jul 99

Makefile:
Modified CC to use profile.

========================================================================
15 Feb 99

ASA-README.html:
Changed color of background for easier viewing.

========================================================================
7 Feb 99

Makefile, asa_user.h, readme.ms, user.c:
Added USER_OUT to permit naming of user output file, defaults to "user_out."

========================================================================
4 Feb 99

readme.ms, user.c:
If FITLOC is TRUE, a value of Fit_Local set >= 1 is required to enter
the local code.  If Fit_Local is set to 2, any better fit found by the
local code better than asa() is ignored if that local fit is achieved
by violating the ranges of the parameters.

========================================================================
27 Jan 99

asa.c:
Corrected a few casts used when ASA_SAVE is TRUE.

========================================================================
15 Jan 99

asa.c, asa.h, readme.ms:
Generalized the macro COST_FUNCTION_TEST to the function
cost_function_test() to return exit_code INVALID_COST_FUNCTION if the
user returns either an invalid cost function value or a parameter that
lies outside the proper range.

========================================================================
26 Sep 98

asa.c, asa.h, readme.ms, user.c, user.h:
CALLOC_FAILED = -1.  Calloc memory allocation has failed in asa.c.
This error will call Exit_ASA(), the location will be printed to
stdout, and asa() will return  the double -1 to the calling program.
In user.c, if asa() returns this *exit_code a warning will be printed
both to stdout and to user_out.

asa_main() now returns an integer.  main() or asa_main() returns 0 for
a normal run, -1 if any calloc allocation has failed in asa.c, or -2 if
any calloc allocation has failed in user.c.

initialize_parameters() and recur_initialize_parameters() also now
return integers, 0 for a normal run or -2 if any calloc allocation has
failed.

asa.c:
print_string() and print_string_index() return errors in user input
both to stdout and, if ASA_PRINT is TRUE, to ASA_OUT.

========================================================================
25 Sep 98

ASA-README.html:
Added links to parameters left out by previous macros.

========================================================================
24 Sep 98

ASA-README.html:
Added color to text and background.

========================================================================
12 Jul 98

asa.c:
More print statements added when MULTI_MIN is set to TRUE.

asa.c, asa_user.c, readme.ms, user.c:
If Multi_Specify is set to 0, the selection of best-generated states
includes all sampled instances of the cost functions.  If Multi_Specify
is set to 1, the selection of best-generated states is constrained to
include only those with different values of the cost function.

========================================================================
9 Jul 98

asa.c, readme.ms:
Included some commented alternative code under "cost-value-distinct
best-generated states" which can alter the default selection of all
best-generated states to including only those with different values of
the cost function.

asa.c, readme.ms:
Modified MULTI_MIN algorithm.  Added tests to ensure that Multi_Grid is
greater than EPS_DOUBLE, greater than Coarse_Resolution if
ASA_RESOLUTION is TRUE, and greater than Queue_Size if ASA_QUEUE is
TRUE.

========================================================================
8 Jul 98

asa.c, user.c:
Added print statements to user.c and corrected some code in asa.c when
MULTI_MIN is set to TRUE.

asa.c:
Modified parameters in multi_compare() for non-ANSI compilers.

asa.c, readme.ms:
If MULTI_MIN is TRUE and Curvature_0 is FALSE, all MULTI_NUMBER
curvatures are calculated.

asa.c, readme.ms:
Clarified calculation of the MULTI_NUMBER lowest best-generated sampled
values of the cost function.  Enhanced MULTI_MIN algorithm to include
Multi_Grid.

========================================================================
7 Jul 98

Makefile, asa.c, asa.h, asa_user.h, readme.ms, user.c:
When MULTI_MIN is set to TRUE, the lowest MULTI_NUMBER values of the
cost function and their parameters are saved.

========================================================================
18 Jun 98

readme.ms:
Deleted ftp.alumni.caltech.edu as only www.alumni.caltech.edu is up
most of the time.

========================================================================
29 May 98

readme.ms:
Fixed bug in numbering Contents pages in ASA-README.ps.

========================================================================
26 Apr 98

readme.ms:
Updated references.

========================================================================
9 Jan 98

asa.c, asa_user.h, readme.ms, user.c, user.c:
When FITLOC is TRUE, OPTIONS->Iter_Max determines the maximum
iterations of the cost_function () by simplex ().  This replaces
intermax.

========================================================================
8 Jan 98

user.c:
Added some declarations in calcf() when ASA_RESOLUTION set to TRUE.

========================================================================
28 Dec 97

user.c:
Added reference to simplex code.

========================================================================
18 Dec 97

Makefile, asa.c, asa_user.h, readme.ms, user.c:
When FITLOC is set to TRUE, FITLOC_PRINT controls printing in fitloc ()
and simplex () in the user module.

========================================================================
7 Dec 97

Makefile, asa.c, asa_user.h, readme.ms, user.c:
If FITLOC is set to TRUE and FITLOC_ROUND is TRUE, then each time
parameters are passed to or between the local routines, simplex (),
calcf (), and fitloc (), they are first processed by rounding integers
or respecting rounding according to ASA_RESOLUTION constraints prior to
any further calculations.

========================================================================
5 Dec 97

user.c:
Fixed return of information from fitloc().

========================================================================
1 Dec 97

asa.c:
Fixed bug in test for FITLOC OPTIONS settings.

========================================================================
30 Nov 97

asa.c, asa_user.h, readme.ms, user.c, user.h: 
When FITLOC is TRUE, OPTIONS->Penalty provides adaptive control of
weights for violations of constraints, exceeding boundaries, etc.
Some typos were corrected in the sections added for FITLOC.

Changed name of README's to ASA-README's.

========================================================================
29 Nov 97

Makefile, NOTES, asa.c, asa_user.h, readme.ms, user.c, user.h:
When FITLOC is set to TRUE, three subroutines become active to perform
a local fit after leaving asa ().  This can be useful to shunt asa ()
to a local code after the region of the global fit is known with some
confidence, which many times is an efficient procedure.

Changed the default of IO_PROTOTYPES to FALSE since newer operating
systems require this.

README.html is now bundled together with the ASA code.

========================================================================
7 Nov 97

asa.c, asa.h:
Removed ASA_PRINT constraints around TIME_CALC so time routines
can be used by the user module even when ASA_PRINT is FALSE.

========================================================================
27 Oct 97

readme.ms:
Updated ICONIP'96 reference.

========================================================================
28 Aug 97

asa.h:
Added NaN test to COST_FUNCTION_TEST(x).

asa.c:
Corrected test on Curvature_0.

========================================================================
26 Aug 97

asa.c, asa.h, readme.ms:
The exit flag INVALID_COST_FUNCTION is set to 8 when the user returns a
value of the cost function to asa () which is not a valid number, e.g.,
not between -MAX_DOUBLE and MAX_DOUBLE.

Updated Locate_Cost.  The value is printed out when exiting asa().

========================================================================
23 Aug 97

asa.c, readme.ms:
ASA_RESOLUTION acts at max and min boundaries similar to how integers
are treated.  ASA_RESOLUTION takes precedence over parameter_type []
when parameter_type [] is integral when calculating new generated
parameters.

========================================================================
6 Aug 97

NOTES:
Some exception fault "errors" on some PC compilers that have problems
handling too large and/or too small exponentials  can be circumvented
by setting CHECK_EXPONENT set to TRUE.

asa.c, asa.h, readme.ms:
An additional module for using TIME_CALC set to TRUE, setting
TIME_GETRUSAGE to FALSE, is more portable to compile across some
platforms, but it can require different parameters for timing results.

========================================================================
15 Jul 97

readme.ms:
Changed to Chicago address.

========================================================================
25 Jun 97

user.c:
Added alternative RNG.

========================================================================
20 Jun 97