api/general.c

   1 /* Copyright (c) 2007-2014 Massachusetts Institute of Technology
   2  *
   3  * Permission is hereby granted, free of charge, to any person obtaining
   4  * a copy of this software and associated documentation files (the
   5  * "Software"), to deal in the Software without restriction, including
   6  * without limitation the rights to use, copy, modify, merge, publish,
   7  * distribute, sublicense, and/or sell copies of the Software, and to
   8  * permit persons to whom the Software is furnished to do so, subject to
   9  * the following conditions:
  10  *
  11  * The above copyright notice and this permission notice shall be
  12  * included in all copies or substantial portions of the Software.
  13  *
  14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  15  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  16  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  17  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  18  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  19  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  20  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  21  */
  22
  23 #include <math.h>
  24 #include <float.h>
  25
  26 #include "nlopt-internal.h"
  27
  28 /*************************************************************************/
  29
  30 int nlopt_isinf(double x) {
  31      return fabs(x) >= HUGE_VAL * 0.99
  32 #ifdef HAVE_ISINF
  33           || isinf(x)
  34 #endif
  35           ;
  36 }
  37 /*************************************************************************/
  38
  39 void NLOPT_STDCALL nlopt_version(int *major, int *minor, int *bugfix)
  40 {
  41      *major = MAJOR_VERSION;
  42      *minor = MINOR_VERSION;
  43      *bugfix = BUGFIX_VERSION;
  44 }
  45
  46 /*************************************************************************/
  47
  48 static const char nlopt_algorithm_names[NLOPT_NUM_ALGORITHMS][256] = {
  49      "DIRECT (global, no-derivative)",
  50      "DIRECT-L (global, no-derivative)",
  51      "Randomized DIRECT-L (global, no-derivative)",
  52      "Unscaled DIRECT (global, no-derivative)",
  53      "Unscaled DIRECT-L (global, no-derivative)",
  54      "Unscaled Randomized DIRECT-L (global, no-derivative)",
  55      "Original DIRECT version (global, no-derivative)",
  56      "Original DIRECT-L version (global, no-derivative)",
  57 #ifdef WITH_CXX
  58      "StoGO (global, derivative-based)",
  59      "StoGO with randomized search (global, derivative-based)",
  60 #else
  61      "StoGO (NOT COMPILED)",
  62      "StoGO randomized (NOT COMPILED)",
  63 #endif
  64      "original L-BFGS code by Nocedal et al. (NOT COMPILED)",
  65      "Limited-memory BFGS (L-BFGS) (local, derivative-based)",
  66      "Principal-axis, praxis (local, no-derivative)",
  67      "Limited-memory variable-metric, rank 1 (local, derivative-based)",
  68      "Limited-memory variable-metric, rank 2 (local, derivative-based)",
  69      "Truncated Newton (local, derivative-based)",
  70      "Truncated Newton with restarting (local, derivative-based)",
  71      "Preconditioned truncated Newton (local, derivative-based)",
  72      "Preconditioned truncated Newton with restarting (local, derivative-based)",
  73      "Controlled random search (CRS2) with local mutation (global, no-derivative)",
  74      "Multi-level single-linkage (MLSL), random (global, no-derivative)",
  75      "Multi-level single-linkage (MLSL), random (global, derivative)",
  76      "Multi-level single-linkage (MLSL), quasi-random (global, no-derivative)",
  77      "Multi-level single-linkage (MLSL), quasi-random (global, derivative)",
  78      "Method of Moving Asymptotes (MMA) (local, derivative)",
  79      "COBYLA (Constrained Optimization BY Linear Approximations) (local, no-derivative)",
  80      "NEWUOA unconstrained optimization via quadratic models (local, no-derivative)",
  81      "Bound-constrained optimization via NEWUOA-based quadratic models (local, no-derivative)",
  82      "Nelder-Mead simplex algorithm (local, no-derivative)",
  83      "Sbplx variant of Nelder-Mead (re-implementation of Rowan's Subplex) (local, no-derivative)",
  84      "Augmented Lagrangian method (local, no-derivative)",
  85      "Augmented Lagrangian method (local, derivative)",
  86      "Augmented Lagrangian method for equality constraints (local, no-derivative)",
  87      "Augmented Lagrangian method for equality constraints (local, derivative)",
  88      "BOBYQA bound-constrained optimization via quadratic models (local, no-derivative)",
  89      "ISRES evolutionary constrained optimization (global, no-derivative)",
  90      "Augmented Lagrangian method (needs sub-algorithm)",
  91      "Augmented Lagrangian method for equality constraints (needs sub-algorithm)",
  92      "Multi-level single-linkage (MLSL), random (global, needs sub-algorithm)",
  93      "Multi-level single-linkage (MLSL), quasi-random (global, needs sub-algorithm)",
  94      "Sequential Quadratic Programming (SQP) (local, derivative)",
  95      "CCSA (Conservative Convex Separable Approximations) with simple quadratic approximations (local, derivative)",
  96      "ESCH evolutionary strategy"
  97 };
  98
  99 const char * NLOPT_STDCALL nlopt_algorithm_name(nlopt_algorithm a)
 100 {
 101      if (((int) a) < 0 || a >= NLOPT_NUM_ALGORITHMS) return "UNKNOWN";
 102      return nlopt_algorithm_names[a];
 103 }
 104
 105 /*************************************************************************/
 106 /* get thread id, if possible, for use in nlopt_srand_time to ensure that
 107    different threads have a different default seed even if they are called
 108    simultaneously */
 109
 110 #if defined(_WIN32) || defined(__WIN32__)
 111 #  include <windows.h>
 112 #  define my_gettid GetCurrentThreadId
 113 #elif defined(HAVE_GETTID_SYSCALL)
 114 #  include <unistd.h>
 115 #  include <sys/syscall.h>
 116 #  define my_gettid() syscall(SYS_gettid)
 117 #elif defined(HAVE_GETPID)
 118 #  include <sys/types.h>
 119 #  include <unistd.h>
 120 #  define my_gettid getpid
 121 #else
 122 #  define my_gettid() (0)
 123 #endif
 124
 125 /*************************************************************************/
 126
 127 static THREADLOCAL int nlopt_srand_called = 0;
 128 void NLOPT_STDCALL nlopt_srand(unsigned long seed) {
 129      nlopt_srand_called = 1;
 130      nlopt_init_genrand(seed);
 131 }
 132
 133 void NLOPT_STDCALL nlopt_srand_time(void) {
 134      nlopt_srand(nlopt_time_seed() + my_gettid() * 314159);
 135 }
 136
 137 void nlopt_srand_time_default(void) {
 138      if (!nlopt_srand_called) nlopt_srand_time();
 139 }
 140
 141 /*************************************************************************/