src/include/surf/maxmin.h

   1 /*      $Id$     */
   2
   3 /* Copyright (c) 2004 Arnaud Legrand. All rights reserved.                  */
   4
   5 /* This program is free software; you can redistribute it and/or modify it
   6  * under the terms of the license (GNU LGPL) which comes with this package. */
   7
   8 #ifndef _SURF_MAXMIN_H
   9 #define _SURF_MAXMIN_H
  10
  11 #include "portable.h"
  12 #include "xbt/misc.h"
  13
  14 #define MAXMIN_PRECISION 0.00001
  15 static XBT_INLINE void double_update(double *variable, double value)
  16 {
  17   *variable -= value;
  18   if (*variable < MAXMIN_PRECISION)
  19     *variable = 0.0;
  20 }
  21
  22 static XBT_INLINE int double_positive(double value)
  23 {
  24   return (value > MAXMIN_PRECISION);
  25 }
  26
  27 typedef struct lmm_element *lmm_element_t;
  28 typedef struct lmm_variable *lmm_variable_t;
  29 typedef struct lmm_constraint *lmm_constraint_t;
  30 typedef struct lmm_system *lmm_system_t;
  31
  32 XBT_PUBLIC(lmm_system_t) lmm_system_new(void);
  33 XBT_PUBLIC(void) lmm_system_free(lmm_system_t sys);
  34      void lmm_variable_disable(lmm_system_t sys, lmm_variable_t var);
  35
  36 XBT_PUBLIC(lmm_constraint_t) lmm_constraint_new(lmm_system_t sys, void *id,
  37                                                 double bound_value);
  38      void lmm_constraint_shared(lmm_constraint_t cnst);
  39      int lmm_constraint_is_shared(lmm_constraint_t cnst);
  40
  41      void lmm_constraint_free(lmm_system_t sys, lmm_constraint_t cnst);
  42
  43 XBT_PUBLIC(lmm_variable_t) lmm_variable_new(lmm_system_t sys, void *id,
  44                                             double weight_value,
  45                                             double bound,
  46                                             int number_of_constraints);
  47      void lmm_variable_free(lmm_system_t sys, lmm_variable_t var);
  48 XBT_PUBLIC(double) lmm_variable_getvalue(lmm_variable_t var);
  49 XBT_PUBLIC(double) lmm_variable_getbound(lmm_variable_t var);
  50
  51 XBT_PUBLIC(void) lmm_expand(lmm_system_t sys, lmm_constraint_t cnst,
  52                             lmm_variable_t var, double value);
  53      void lmm_expand_add(lmm_system_t sys, lmm_constraint_t cnst,
  54                          lmm_variable_t var, double value);
  55      void lmm_elem_set_value(lmm_system_t sys, lmm_constraint_t cnst,
  56                              lmm_variable_t var, double value);
  57
  58      lmm_constraint_t lmm_get_cnst_from_var(lmm_system_t sys,
  59                                             lmm_variable_t var, int num);
  60      int lmm_get_number_of_cnst_from_var(lmm_system_t sys,
  61                                          lmm_variable_t var);
  62      lmm_variable_t lmm_get_var_from_cnst(lmm_system_t sys,
  63                                           lmm_constraint_t cnst,
  64                                           lmm_element_t * elem);
  65
  66      lmm_constraint_t lmm_get_first_active_constraint(lmm_system_t sys);
  67      lmm_constraint_t lmm_get_next_active_constraint(lmm_system_t sys,
  68                                                      lmm_constraint_t cnst);
  69
  70      void *lmm_constraint_id(lmm_constraint_t cnst);
  71      void *lmm_variable_id(lmm_variable_t var);
  72
  73      void lmm_update(lmm_system_t sys, lmm_constraint_t cnst,
  74                      lmm_variable_t var, double value);
  75      void lmm_update_variable_bound(lmm_system_t sys, lmm_variable_t var,
  76                                     double bound);
  77
  78
  79 XBT_PUBLIC(void) lmm_update_variable_weight(lmm_system_t sys,
  80                                             lmm_variable_t var,
  81                                             double weight);
  82      double lmm_get_variable_weight(lmm_variable_t var);
  83
  84 XBT_PUBLIC(void) lmm_update_constraint_bound(lmm_system_t sys,
  85                                              lmm_constraint_t cnst,
  86                                              double bound);
  87
  88      int lmm_constraint_used(lmm_system_t sys, lmm_constraint_t cnst);
  89
  90
  91 XBT_PUBLIC(void) lmm_solve(lmm_system_t sys);
  92
  93 #ifdef HAVE_SDP
  94 XBT_PUBLIC(void) sdp_solve(lmm_system_t sys);
  95 #endif /* HAVE_SDP */
  96
  97 XBT_PUBLIC(void) lagrange_solve(lmm_system_t sys);
  98 XBT_PUBLIC(void) bottleneck_solve(lmm_system_t sys);
  99
 100 /**
 101  * Default functions associated to the chosen protocol. When
 102  * using the lagrangian approach.
 103  */
 104
 105 XBT_PUBLIC(void) lmm_set_default_protocol_function(double (*func_f)
 106
 107
 108
 109                                                    (lmm_variable_t var,
 110                                                     double x),
 111                                                    double (*func_fp)
 112
 113
 114                                                    (lmm_variable_t var,
 115                                                     double x),
 116                                                    double (*func_fpi)
 117
 118
 119                                                    (lmm_variable_t var,
 120                                                     double x));
 121
 122 XBT_PUBLIC(double func_reno_f) (lmm_variable_t var, double x);
 123 XBT_PUBLIC(double func_reno_fp) (lmm_variable_t var, double x);
 124 XBT_PUBLIC(double func_reno_fpi) (lmm_variable_t var, double x);
 125
 126 XBT_PUBLIC(double func_reno2_f) (lmm_variable_t var, double x);
 127 XBT_PUBLIC(double func_reno2_fp) (lmm_variable_t var, double x);
 128 XBT_PUBLIC(double func_reno2_fpi) (lmm_variable_t var, double x);
 129
 130 XBT_PUBLIC(double func_vegas_f) (lmm_variable_t var, double x);
 131 XBT_PUBLIC(double func_vegas_fp) (lmm_variable_t var, double x);
 132 XBT_PUBLIC(double func_vegas_fpi) (lmm_variable_t var, double x);
 133
 134
 135 #endif /* _SURF_MAXMIN_H */