asa-changes

simulated annealing code ASA

12 Oct 02

Updated copyright date and prepared docs on Cygwin.

========================================================================
14 Aug 02

user.c, user_cst.c:
In ASA_TEST in cost_function(), cast (LONG_INT) *parameter_dimension.

========================================================================
3 Jun 02

asa.c, asa.h, asa_user.h, Makefile, readme.ms, user.c:
Changed pre-compile OPTIONS MULTI_NUMBER to adaptive
USER_OPTIONS->Multi_Number.

========================================================================
22 Apr 02

asa.h, user.c, user.h:
To permit compilation under g++ as well as gcc, moved initializations
from user.h to user.c to avoid problems using user_cst.c, and changed
global exit_msg[] to user_exit_msg[] in user.c and to exit_msg[] in asa.h.

========================================================================
19 Apr 02

readme.ms:
The code is stable and therefore the ASA_List no longer is necessary.


========================================================================
5 Mar 02

asa.c, asa.h, readme.ms:
Print out values of parameters dropped out of sampling by setting
minimum = maximum.

========================================================================
29 Oct 01

readme.ms:
Changed ingber_fees.html to ingber_terms.html.

========================================================================
12 Oct 01

readme.ms:
Renamed ASA-README and ASA-README+ to ASA-README.txt and ASA-README+.txt.

========================================================================
11 Oct 01

NOTES, readme.ms:
Changed FILE.ps.gz references to FILE.pdf references.

Added ASA-README.pdf to source code.

========================================================================
14 Sep 01

NOTES, readme.ms:
Added info on using QUENCHing for large parameter dimensions.

========================================================================
27 Aug 01

readme.ms:
Added comment re if MULTI_NUMBER is larger than the actual number of
accepted states, then there will be a set of duplicate states returned
which likely should be filtered via a unique macro.

========================================================================
11 Aug 01

NOTES, readme.ms:
Added .txt suffix to 00index.txt, asa_contrib.txt, asa_examples.txt,
asa_new.txt, and ingber_fees.txt.

readme.ms:
Added info about ASA-README.pdf in the www.ingber.com archive.

========================================================================
1 Aug 01

asa.c, asa_user.h, Makefile, readme.ms:
When USER_ACCEPT_THRESHOLD is TRUE, a  simple alternative to the Boltzmann
function becomes available for the acceptance test, simply defining 
the probability of acceptance to be 1 if delta_cost <= cost_temp and
0 otherwise.

========================================================================
19 Jul 01

asa.c, asa.h, readme.ms, user.c, user.h, user_cst.c:
Setting the lower bound equal to the upper bound will remove a parameter
from consideration.  Whenever this occurs, within asa() the effective
dimension defining the size of the search space is reduced by the number
of parameters so removed.

========================================================================
21 Jun 01

asa.c:
Fixed bug in use of ASA_PRINT with MULTI_MIN.

========================================================================
14 Jun 01

asa.h, asa_user.h, user.h:
Added protective #define wrappers.

========================================================================
13 May 01

readme:
Changed to file utils_file_formats.txt.

========================================================================
4 May 01

readme:
Added user_cst.c to
gcc -g -DASA_TEST=TRUE -o asa_run user.c user_cst.c asa.c -lm

========================================================================
27 Mar 01

asa.c:
Put all calloc initializations before first call to cost function.
If the first call to cost function returns an invalid state, then memory
is correctly freed before exiting asa().

========================================================================
16 Mar 01

asa_user.h, user.c, user.h, readme.ms:
The default name of the cost function is cost_function.  This can be
changed in asa_user.h (or the Makefile) by defining USER_COST_FUNCTION.
When SELF_OPTIMIZE is TRUE, the default name of the recur cost function is
recur_cost_function.  This can be changed in asa_user.h (or the Makefile)
by defining RECUR_USER_COST_FUNCTION.  This of course requires compiling
in the new cost function(s) and prototype(s).

========================================================================
20 Feb 01

*.[ch]
Changed indenting to `gindent -br -brs -ce -cdw -nut -sob -pmt`.

========================================================================
25 Jan 01

readme.ms:
The background image file asa_back.jpg referenced in ASA\-README.html can
be downloaded as http://www.ingber.com/asa_back.jpg from the ASA archive.

========================================================================
24 Jan 01

readme.ms:
Added note on availability of support for ASA_PARALLEL in asa_contrib.

========================================================================
17 Jan 01

asa.c, asa.h, readme.ms:
When ASA_PARALLEL is TRUE, each block of generated states is sorted to
permit the lowest cost functions to pass first through the acceptance
test.

========================================================================
14 Jan 01

Makefile, NOTES, readme.ms, user.c, user_cst.c:
Changed user_cst.h to user_cst.c.

========================================================================
30 Dec 00

Updated copyright.

========================================================================
19 Dec 00

readme.ms, user.c, user.h:
Put SHUFFLE in user.h, and changed "256" random dimensions to SHUFFLE
in user.c.  Removed creation and freeing of memory for Random_Array as
this is pointed to static random_array.

========================================================================
18 Dec 00

asa.c:
Deleted extra fclose(ptr_save); line used when ASA_SAVE is TRUE.

asa.c, readme.ms:
When ASA_SAVE is set to TRUE, Number_Cost_Samples is set to 1 after
the initial run.

========================================================================
12 Dec 00

readme.ms:
Emphasized free use of code.

========================================================================
28 Nov 00

readme.ms:
Updated reference to utilities.

========================================================================
26 Nov 00

NOTES, readme.ms:
Merged all files under MISC.DIR into main ingber.com directory.

========================================================================
17 Nov 00

Changed indenting to version GNU indent 2.2.6.

========================================================================
24 Oct 00

readme.ms, user.h, user.c:
randflt() calls resetable_randflt() each time to implement the RNG.
This is to provide the capability of getting the same runs if the same
multiple calls to asa() are made, e.g., when using ASA_LIB set to TRUE.

========================================================================
19 Sep 00

user.c:
Changed initialization of random generator to enforce consistent
first random number generated upon multiple calls to asa_main() when
ASA_TEMPLATE_LIB is set to TRUE.  This changes test_asa and test_usr.

========================================================================
7 Sep 00

Makefile, asa_user.h, readme.ms, user.c:
Changed cast on Asa_Data_Ptr to OPTIONAL_PTR_TYPE.
========================================================================
21 Aug 00

NOTES, readme.ms:
Only RATFOR version of VFSR is included in asa_contrib.

========================================================================
2 Aug 00

NOTES:
Included reference to old 1987 RATFOR and FORTRAN VFSR code contained
in asa_contrib.

Makefile:
Added zip: target.

readme.ms:
ASA-shar is dropped from the archive, as ASA.tar.gz and ASA.zip are now
sufficient for practically all users.

========================================================================
29 Jul 00

readme.ms:
Included reference to old 1987 RATFOR and FORTRAN VFSR code contained
in asa_contrib.

========================================================================
21 Jul 00

readme.ms:
Changed reference to ASA code to Caltech Alumni Association, properly
given to the internet archive that first published the code and maintains
email addresses for the ASA_list

========================================================================
26 May 00

asa.c, user.c:
Fixed 2 leaks when MULTI_MIN is TRUE.

========================================================================
19 May 00

user.c:
Fixed OPTIONAL_DATA_PTR wrapper around data_ptr_flg.

========================================================================
13 May 00

user.c:
Fixed free() bug if data_ptr_flg is 0 in SELF_OPTIMIZE section.

========================================================================
10 May 00

user.c:
Updated SELF_OPTIMIZE section to be able to use asa_opt_recur file.

user.c, user.h:
Pass name of cost function to fitloc() so it can be used recursively.

asa.c, asa_user.c, readme.ms, user.c:
Modified ASA_SAVE to be effective at highest level of recursion.

========================================================================
9 May 00

asa_user.c, readme.ms, user.c:
Modified OPTIONAL_PTR_TYPE for multiple names at general levels of
recursion.

asa.c, asa_user.c, readme.ms, user.c:
Added OPTIONS->Asa_Recursive_Level.

========================================================================
8 May 00

user.c:
Added MULTI_MIN capability to SELF_OPTIMIZE section.

asa_user.c, readme.ms, user.c:
Modified OPTIONAL_PTR_TYPE for general levels of recursion.

========================================================================
5 May 00

user.c, readme.ms:
If OPTIONAL_DATA_PTR is being used for RECUR_USER_OPTIONS as well
as for USER_OPTIONS, do not create (or free) additional memory in
recur_cost_function() for Asa_Data_Dim_Ptr and Asa_Data_Ptr to be
passed to the inner cost_function(), but rather link pointers to those
in RECUR_USER_OPTIONS.  Typically, define separate structures within the
structure defined by Asa_Data_Ptr to access info depending on whether the
run in a particular level of cost function in this recursive operation.
In user.c, there are guidelines to set "#if TRUE" to "#if FALSE"
at these points of the code.

========================================================================
3 May 00

asa.c:
Updated changes to Asa_Data_Dbl when ASA_TEMPLATE_SELFOPT is TRUE.

========================================================================
4 Apr 00

asa.c:
Fixed bug in freeing multi_params when MULTI_MIN is TRUE.

========================================================================
15 Mar 00

asa.c:
Corrected reference to last_generated_state to last_saved_state.

========================================================================
28 Feb 00

user.c:
Sharpened accuracy of bound testing when FITLOC is TRUE.

========================================================================
25 Feb 00

asa.c, asa_user.c, readme.ms:
Changed from use of system() to popen() when ASA_SAVE or ASA_SAVE_BACKUP
is TRUE.

========================================================================
21 Jan 00

NOTES, readme.ms:
Added a section in NOTES, Some Tuning Guidelines.

asa.c:
Added the last_saved_state cost function to output from ASA_PIPE
and ASA_PIPE_FILE.

========================================================================
18 Jan 00

readme.ms:
Added short abstract to first page.

========================================================================
29 Dec 99

asa.c:
Corrected some pointer bugs when ASA_SAVE and MULTI_MIN are both TRUE.

========================================================================
28 Dec 99

asa.c, readme.ms, user.c:
Deleted Cauchy and Gaussian examples under USER_GENERATED_FUNCTION, as
extra care usually is needed by user the to handle parameter ranges.

========================================================================
26 Dec 99

asa.c:
Set default size of arrays created under ASA_QUEUE to 1 if Queue_Size
is initially zero, to permit proper freeing of memory when leaving asa()
in case Queue_Size is set to zero adaptively.

========================================================================
8 Dec 99

Makefile, asa.c, asa_user.h, readme.ms:
If ASA_SAVE_OPT is set to TRUE, when asa is restarted, if the file
asa_opt_save is present in the same directory as asa_opt, then new values
of ASA parameters and OPTIONS are read in after initializing to the
point of the last writing of asa_save, without requiring recompilation.

readme.ms:
Added note on availability of MATLAB interface in asa_contrib.