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 "xbt/misc.h"
  12
  13 #define MAXMIN_PRECISION 0.00001
  14 static XBT_INLINE void double_update(double *variable, double value)
  15 {
  16   *variable -= value;
  17   if(*variable< MAXMIN_PRECISION) *variable = 0.0;
  18 }
  19
  20 static XBT_INLINE int double_positive(double value)
  21 {
  22   return (value>MAXMIN_PRECISION);
  23 }
  24
  25 typedef struct lmm_element *lmm_element_t;
  26 typedef struct lmm_variable *lmm_variable_t;
  27 typedef struct lmm_constraint *lmm_constraint_t;
  28 typedef struct lmm_system *lmm_system_t;
  29
  30 XBT_PUBLIC(lmm_system_t) lmm_system_new(void);
  31 XBT_PUBLIC(void) lmm_system_free(lmm_system_t sys);
  32 void lmm_variable_disable(lmm_system_t sys, lmm_variable_t var);
  33
  34 XBT_PUBLIC(lmm_constraint_t) lmm_constraint_new(lmm_system_t sys, void *id,
  35                                     double bound_value);
  36 void lmm_constraint_shared(lmm_constraint_t cnst);
  37
  38 void lmm_constraint_free(lmm_system_t sys, lmm_constraint_t cnst);
  39
  40 XBT_PUBLIC(lmm_variable_t) lmm_variable_new(lmm_system_t sys, void *id,
  41                                 double weight_value,
  42                                 double bound, int number_of_constraints);
  43 void lmm_variable_free(lmm_system_t sys, lmm_variable_t var);
  44 XBT_PUBLIC(double) lmm_variable_getvalue(lmm_variable_t var);
  45 XBT_PUBLIC(double) lmm_variable_getbound(lmm_variable_t var);
  46
  47 XBT_PUBLIC(void) lmm_expand(lmm_system_t sys, lmm_constraint_t cnst,
  48                 lmm_variable_t var, double value);
  49 void lmm_expand_add(lmm_system_t sys, lmm_constraint_t cnst,
  50                     lmm_variable_t var, double value);
  51 void lmm_elem_set_value(lmm_system_t sys, lmm_constraint_t cnst,
  52                         lmm_variable_t var, double value);
  53
  54 lmm_constraint_t lmm_get_cnst_from_var(lmm_system_t sys,
  55                                        lmm_variable_t var, int num);
  56 int lmm_get_number_of_cnst_from_var(lmm_system_t sys, lmm_variable_t var);
  57 lmm_variable_t lmm_get_var_from_cnst(lmm_system_t sys,
  58                                      lmm_constraint_t cnst,
  59                                      lmm_element_t * elem);
  60
  61 lmm_constraint_t lmm_get_first_active_constraint(lmm_system_t sys);
  62 lmm_constraint_t lmm_get_next_active_constraint(lmm_system_t sys, lmm_constraint_t cnst);
  63
  64 void *lmm_constraint_id(lmm_constraint_t cnst);
  65 void *lmm_variable_id(lmm_variable_t var);
  66
  67 void lmm_update(lmm_system_t sys, lmm_constraint_t cnst,
  68                 lmm_variable_t var, double value);
  69 void lmm_update_variable_bound(lmm_system_t sys, lmm_variable_t var,
  70                                double bound);
  71
  72
  73 XBT_PUBLIC(void) lmm_update_variable_latency(lmm_system_t sys, lmm_variable_t var,
  74                                  double delta);
  75
  76
  77
  78 XBT_PUBLIC(void) lmm_update_variable_weight(lmm_system_t sys, lmm_variable_t var,
  79                                 double weight);
  80 double lmm_get_variable_weight(lmm_variable_t var);
  81
  82 XBT_PUBLIC(void) lmm_update_constraint_bound(lmm_system_t sys, lmm_constraint_t cnst,
  83                                  double bound);
  84
  85 int lmm_constraint_used(lmm_system_t sys, lmm_constraint_t cnst);
  86
  87
  88 XBT_PUBLIC(void) lmm_solve(lmm_system_t sys);
  89
  90 #ifdef HAVE_SDP
  91 XBT_PUBLIC(void) sdp_solve(lmm_system_t sys);
  92 #endif /* HAVE_SDP */
  93
  94 XBT_PUBLIC(void) lagrange_solve(lmm_system_t sys);
  95 XBT_PUBLIC(void) bottleneck_solve(lmm_system_t sys);
  96
  97 /**
  98  * Default functions associated to the chosen protocol. When
  99  * using the lagrangian approach.
 100  */
 101
 102 XBT_PUBLIC(void) lmm_set_default_protocol_function(double (* func_f)  (lmm_variable_t var, double x),
 103                                        double (* func_fp) (lmm_variable_t var, double x),
 104                                        double (* func_fpi)(lmm_variable_t var, double x));
 105
 106 XBT_PUBLIC(double func_reno_f)  (lmm_variable_t var, double x);
 107 XBT_PUBLIC(double func_reno_fp) (lmm_variable_t var, double x);
 108 XBT_PUBLIC(double func_reno_fpi)(lmm_variable_t var, double x);
 109
 110 XBT_PUBLIC(double func_vegas_f)  (lmm_variable_t var, double x);
 111 XBT_PUBLIC(double func_vegas_fp) (lmm_variable_t var, double x);
 112 XBT_PUBLIC(double func_vegas_fpi)(lmm_variable_t var, double x);
 113
 114
 115 #endif                          /* _SURF_MAXMIN_H */