Contents

1 Introduction

MEIGO is an optimization suite programmed in R which implements metaheuristics for solving different nonlinear optimization problems in both continuous and integer domains arising in systems biology, bioinformatics and other areas. It consists of two main metaheuristics: the enhanced scatter search method, eSSR (Egea et al. 2009; Egea, Martí, and Banga 2010) for continuous and mixed-integer problems, and the variable neighbourhood search metaheuristic (Hansen, Mladenović, and Moreno-Pérez 2010), for integer problems.

Metaheuristics are useful for solving problems that due to its complexity cannot be solved by deterministic global optimization solvers or where the usage of a local solver systematically converges to a local solutions. Metaheuristics do not guarantee optimality but are usually efficient in locating the vicinity of the global solution in modest computational time.

Both eSS and VNS are hybrid solvers. This means that the stochastic optimization methods are combined with local solvers to improve the efficiency. They have been implemented in R and can be invoked within the MEIGO framework. This manual describes both methods, their corresponding parallelizable versions, and guides the users to implement their own optimization problems and to choose the best set of options for a particular instance.

2 Installing MEIGOR

MEIGOR can be installed from Bioconductor by typing:

if (!requireNamespace("BiocManager", quietly=TRUE))
    install.packages("BiocManager")
     BiocManager::install("CellNOptR")

3 Continuous and mixed-integer problems: Enhanced Scatter Search (eSSR)

eSSR is an R implementation of the enhanced scatter search method (Egea et al. 2009; Egea, Martí, and Banga 2010) which is part of the MEIGO toolbox for global optimization in bioinformatics. It is a metaheuristic which seeks the global minimum of mixed-integer nonlinear programming (MINLP) problems specified by

\[\begin{equation} \min\limits_{x}f(x,p_1,p_2,...,p_n) \end{equation}\]

subject to

\[\begin{aligned} c_{eq}=0 \\ c_L\leq c(x)\leq c_U\\ x_L\leq x\leq x_U \end{aligned}\]

where \(x\) is the vector of decision variables, and \(x_L\) and \(x_U\) its respective bounds. \(p_1,\ldots,p_n\) are optional extra input parameters to be passed to the objective function (see example in Section 3.3.3). \(c_{eq}\) is a set of equality constraints. \(c(x)\) is a set of inequality constraints with lower and upper bounds, \(c_L\) and \(c_U\). Finally, \(f(x,p_1,p_2,...,p_n)\) is the objective function to be minimized.

3.1 Quick start: How to carry out an optimization with SSR

library(MEIGOR)
problem<-list(f=objective, x_L=rep(-1,2), x_U=rep(1,2))
opts<-list(maxeval=500, local_solver='DHC')

Type Results<-MEIGO(problem,opts,algorithm="ESS" If your problem has additional constant parameters to be passed to the objective function, they are declared as input parameters after “opts”(e.g., type Results<-MEIGO(problem,opts,algorithm="ESS",p1,p2) if your model has two extra input parameters, \(p_1\) and \(p_2\)).

Regarding the objective function, the input parameter is the decision vector (with extra parameters \(p_1, p_2,\ldots, p_n\) if they were defined before calling the solver). The objective function must provide a scalar output parameter (the objective function value) and, for constrained problems, a second output parameter, which is a vector containing the values of the constraints. For problems containing equality constraints (\(=0\)), they must be defined before the inequality constraints. For a quick reference, consider the following example which will be later extended in section 3.3.3.

\[\begin{aligned} \min\limits_{x}f(x)=-x_4 \end{aligned}\]

subject to

\[\begin{aligned} x_4 - x_3 + x_2 - x_1 + k_4x_4x_6 = 0\\ x_1 - 1 + k_1x_1x_5 = 0\\ x_2 - x_1 + k_2x_2x_6 = 0\\ x_3 + x_1 - 1 + k_3x_3x_5 = 0\\ x_5^{0.5} + x_6^{0.5} \leq 4\\ 0 \leq x_1, x_2, x_3, x_4 \leq 1\\ 0 \leq x_5, x_6 \leq 16 \end{aligned}\]

with \(k_1\), \(k_2\), \(k_3\), \(k_4\) being extra parameters defined before calling the solver. The objective function for this problem would be:

ex3<-function(x,k1,k2,k3,k4){
f=-x[4]
# Equality constraints (declared before the inequality ones)
g<-rep(0,5);
g[1]=x[4]-x[3]+x[2]-x[1]+k4*x[4]*x[6]
g[2]=x[1]-1+k1*x[1]*x[5]
g[3]=x[2]-x[1]+k2*x[2]*x[6]
g[4]=x[3]+x[1]-1+k3*x[3]*x[5]

# Inequality constraint
g[5]=x[5]^0.5+x[6]^0.5
return(list(f=f,g=g))
}

This objective function can be invoked like the code below. Let us assume that \(x\) has dimension 6 and we want the value 1 for each dimension. We also define the 4 extra input parameter \(k_1\) to \(k_4\) with values 0.2, 0.5, -0.1, 0.9, respectively.

ex3(c(1,1,1,1,1,1),0.2,0.5,-0.1,0.9)

3.2 eSSR usage

3.2.1 Problem definition

To solve an optimization problem with eSSR, a list (named problem here) containing the following fields must be defined:

  • f: String containing the name of the objective function.
  • x_L: Vector containing the lower bounds of the variables.
  • x_U: Vector containing the upper bounds of the variables.

Besides, there are two optional fields

  • x_0: Vector or matrix containing the given initial point(s).
  • f_0: Function values of the initial point(s). These values MUST correspond to feasible points.
  • vtr: Objective function value to be reached.

If the problem contains additional constraints and/or integer or binary variables, the following fields should also be defined:

  • neq1 In problems with equality constraints they must be declared first before inequality constraints (See example 3.3.3): Number of equality (\(=0\)) constraints.
  • c_L: Vector defining the lower bounds of the inequality constraints.
  • c_U: Vector defining the upper bounds of the inequality constraints.
  • int_var2 For mixed integer problems, the variables must be defined in the following order: [cont., int., bin.]: Number of integer variables.
  • bin_var: Number of binary variables.

3.2.2 User options

The user may define a set of different options related to the optimization problem. They are defined in another list (named opts here) which has the following fields:

  • maxeval: Maximum number of function evaluations (default: 1000).
  • maxtime: Maximum CPU time in seconds (default: 60).
  • iterprint: Print information on the screen after each iteration. 0: Deactivated; 1: Activated (default: 1).
  • weight: Weight that multiplies the penalty term added to the objective function in constrained problems (default: \(10^6\)).
  • log_var: Indexes of the variables which will be analyzed using a logarithmic distribution instead of a uniform one3 Useful when the bounds of a decision variables have different orders of magnitude and they are both positive. (default: numeric(0)).
  • tolc: Maximum constraint violation allowed. This is also used as a tolerance for the local search (default: \(10^{-5}\)).
  • prob_bound: Probability (0-1) of biasing the search towards the bounds. 0: Never bias to bounds; 1: Always bias to bounds (default: 0.5).
  • save_results: Saves final results in . 0: deactivated; 1: activated (default: 1).
  • inter_save: Saves results of intermediate iterations in . Useful for very long runs. 0: deactivated; 1: activated (default: 0).

3.2.3 Global options

A set of options related to the global search phase of the algorithm may also be defined also within the list opts:

  • dim_refset: Number of elements \(d\) in RefSet (default: “auto”, \(\frac{d^2-d}{10\cdot nvar} \geq 0\)).
  • ndiverse: Number of solutions generated by the diversificator in the initial stage (default: “auto”, \(10\cdot nvar\)).
  • combination: Type of combination of elements. 1: Hyper-rectangles combinations; 2: Linear combinations (default: 1).

3.2.4 Local options

eSSR is a global optimization method which performs local searches from selected initial points to accelerate the convergence to optimal solutions. Some options regarding the local search can be defined in the opts list, as follows:

  • local_solver: Local solver to perform the local search. Different solvers available and their names must be introduced as strings. Please note that at the moment no local solver for mixed-integer problems is available within eSSR:

  • local_tol: Level of tolerance in local search. 1: Relaxed; 2: Medium; 3: Tight (default: 2 in intermediate searches and 3 in the final stage).

  • local_iterprint: Print each iteration of local solver on screen (only for local solvers that allow it). 0: Deactivated; 1: Activated (default: 0).

  • local_n1: Number of iterations before applying the local search for the first time (default: 1).

  • local_n2: Number of function iterations in the global phase between two consecutive local searches (default: 10).

  • local_finish: Chooses the local solver to apply a final refinement to the best solution found once the optimization is finished (default: same as local_solver).

  • local_bestx: If activated (i.e., positive value), applies the local search only when the algorithm finds a solution better than the current best solution. 0: Deactivated; 1: Activated (default: 0).

  • local_balance: Balances between quality (=0) and diversity (=1) for choosing initial points for the local search (default 0.5).

Note that, for some problems, the local search may be inefficient, spending a high computation time to provide low quality solutions. This is the case of many noisy or ill-posed problems. In these instances, the local search may be deactivated by user by defining the value of the field solver as zero (0).

3.2.5 Output

eSSR’s output is a list (called Results here) containing the following fields:

  • Results$fbest: Best objective function value found after the optimization.
  • Results$xbest: Vector providing the best function value found.
  • Results$cpu_time: CPU Time (in seconds) consumed in the optimization.
  • Results$f: Vector containing the best objective function value after each iteration.
  • Results$x: Matrix containing the best vector after each iteration.
  • Results$time: Vector containing the CPU time consumed after each iteration.
  • Results$neval: Vector containing the number of evaluations after each iteration.
  • Results$numeval: Total number of function evaluations.
  • Results$local_solutions: Matrix of local solutions found.
  • Results$local_solutions_values: Function values of the local solutions.
  • Results$Refset$x: Matrix of solutions in the final Refset after the optimization.
  • Results$Refset$f: Objetive function values of the final Refset members after the optimization.
  • Results$Refset$fpen: Penalized objetive function values of the final Refset members after the optimization. The values for feasible solutions will coincide with their corresponding Results\(Refset\)f values.
  • Results$Refset$const: Matrix containing the values of the constraints (those whose bounds are defined in problem$c_L and/or problem$c_U) for each of the solutions in the final Refset after the optimization.
  • Results$end_crit: Criterion to finish the optimization:
    • 1: Maximum number of function evaluations achieved.
    • 2: Maximum allowed CPU time achieved.
    • 3: Value to reach achieved.
    The list Results as well as problem and opts are stored and saved in a file called eSSR_report.RData.

3.2.6 Guidelines for using eSSR

Although eSSR default options have been chosen to be robust for a high number of problems, the tuning of some parameters may help increase the efficiency for a particular problem. Here is presented a list of suggestions for parameter choice depending on the type of problem the user has to face.

  • If the problem is likely to be convex, an early local search can find the optimum in short time. For that it is recommended to set the parameter opts$local_n1 = 1. Besides, setting opts$local_n2 = 1 too, the algorithm increases the local search frequency, becoming an “intelligent” multistart.
  • When the bounds differ in several orders of magnitude, the decision variables indexes may be included in log_var.
  • For problems with discontinuities and/or noise, the local search should either be deactivated or performed by a direct search method. In those cases, activating the option opts$local_bestx = 1 may help reduce the computation time wasted in useless local searches by performing a local search only when the best solution found has been improved.
  • When the function values are very high in absolute value, the weight (opts$weight) should be increased to be at least 3 orders of magnitude higher than the mean function value of the solutions found.
  • When the search space is very big compared to the area in which the global solution may be located, a first investment in diversification may be useful. For that, a high value of opts$ndiverse can help finding good initial solutions to create the initial RefSet. A preliminary run with aggressive options can locate a set of good initial solutions for a subsequent optimization with more robust settings. This aggressive search can be performed by reducing the size of the RefSet (opts$dim_refset). A more robust search is produced increasing the RefSet size.
  • If local searches are very time-consuming, their tolerance can be relaxed by reducing the value of opts$local_tol not to spend a long time in local solution refinements.
  • When there are many local solutions close to the global one, the option opts$local_balance should be set close to 0.

3.2.7 Extra tool: essR_multistart

This tool allows the user to perform a multistart optimization procedure with any of the local solvers implemented in eSSR using the same problem declaration. essR_multistart can be invoked within MEIGO using the same structure setting the parameter algorithm="MULTISTART".

Results_multistart<-MEIGO(problem,opts,algorithm="MULTISTART",p1,p2,...)

The list problem has the same fields as in essR (except problem$vtr which does not apply here).

The list opts has only a few fields compared with essR (i.e.,opts$ndiverse, opts$local_solver, opts$iterprint, opts$local_tol and opts$local_iterprint). They all work like in essR except opts$ndiverse, which indicates the number of initial points chosen for the multistart procedure. A histogram with the final solutions obtained and their frequency is presented at the end of the procedure.

The output list Results_multistart contains the following fields:

  • $fbest: Best objective function value found after the multistart optimization.
  • $xbest: Vector providing the best function value.
  • $x0: Matrix containing the vectors used for the multistart optimization.
  • $f0: Vector containing the objective function values of the vectors in Results_multistart$x0.
  • $func: Vector containing the objective function values obtained after every local search.
  • $xxx: Matrix containing the vectors provided by the local optimizations.
  • $no_conv: Matrix containing the initial points that did not converge to any solution.
  • $nfuneval: Matrix containing the number of function evaluations performed in every optimization.

The lists problem, opts and Results_multistart are saved in a file called Results_multistart.RData.

3.3 Examples

In this section we will illustrate the usage of eSSR within MEIGO for solving different instances.

3.3.1 Unconstrained problem

\[\begin{aligned} \min\limits_{x}f(x)=4x_1^2 - 2.1x_1^4 + \dfrac{1}{3}x_1^6 + x_1x_2 - 4x_2^2 + 4x_2^4 \end{aligned}\]

subject to

\[\begin{aligned} -1\leq x_1, x_2\leq 1 \end{aligned}\]

The objective function is defined in ex1.R. Note that being an unconstrained problem, there is only one output argument, \(f\).

ex1 <- function(x){
y<-4*x[1]*x[1]-2.1*x[1]^4+1/3*x[1]^6+x[1]*x[2]-4*x[2]*x[2]+4*x[2]^4;
return(y)
}

The solver is called in main_ex1.R. This problem has two known global optima in \(x^*=(0.0898, -0.7127)\) and \(x^*=(-0.0898, 0.7127)\) with \(f(x^*)= -1.03163\).

Options set:

  • Maximum number of function evaluations set to 500.
  • Maximum number of initial diverse solutions set to 40.
  • Local solver chosen: DHC.
  • Local solver for final refinement: LBFGSB.
  • Show the information provided by local solvers on screen.
#=========================
#PROBLEM SPECIFICATIONS
# ========================
problem<-list(f="ex1",x_L=rep(-1,2),x_U=rep(1,2))
opts<-list(maxeval=500, ndiverse=40, local_solver='DHC',
local_finish='LBFGSB', local_iterprint=1)
#===============================
# END OF PROBLEM SPECIFICATIONS
#===============================
Results<-MEIGO(problem,opts,algorithm="ESS")

3.3.2 Constrained problem

\[\begin{aligned} \min\limits_{x}f(x)=-x_1-x_2 \end{aligned}\]

subject to

\[\begin{aligned} x_2 \leq 2x_1^4 - 8x_1^3 + 8x_1^2 + 2\\ x_2 \leq 4x_1^4 - 32x_1^3 + 88x_1^2 - 96x_1 + 36\\ 0\leq x_1\leq 3\\ 0\leq x_2\leq 4\\ \end{aligned}\]

The objective function is defined in ex2.R. Note that being a constrained problem, there are two output arguments, \(f\) and \(g\).

ex2<-function(x){
F=-x[1]-x[2]
g<-rep(0,2)
g[1]<-x[2]-2*x[1]^4+8*x[1]^3-8*x[1]^2
g[2]<-x[2]-4*x[1]^4+32*x[1]^3-88*x[1]^2+96*x[1]
return(list(F=F,g=g))
}

The solver is called in main_ex2.R. The global optimum for this problem is located in \(x^*=[2.32952, 3.17849]\) with \(f(x^*)=-5.50801\).

Options set:

  • Maximum number of function evaluations set to 750.
  • Local solver chosen: DHC.
  • Increase frequency of local solver calls. The first time the solver is called after 2 iterations. From that moment, the local solver will be called every 3 iterations.
#=========================
#PROBLEM SPECIFICATIONS
#=========================
problem<-list(f="ex2",x_L=rep(0,2),x_U=c(3,4),
c_L=rep(-Inf,2), c_U=c(2,36))
opts<-list(maxeval=750, local_solver="DHC", local_n1=2, local_n2=3)
#=============================
#END OF PROBLEM SPECIFICATIONS
# ============================
Results<-MEIGO(problem,opts,algorithm="ESS")

3.3.3 Constrained problem with equality constraints

\[\begin{aligned} \min\limits_{x}f(x)=-x_4 \end{aligned}\]

subject to

\[\begin{aligned} x_4 - x_3 + x_2 - x_1 + k_4x_4x_6 = 0\\ x_1 - 1 + k_1x_1x_5 = 0\\ x_2 - x_1 + k_2x_2x_6 = 0\\ x_3 + x_1 - 1 + k_3x_3x_5 = 0\\ x_5^{0.5} + x_6^{0.5} \leq 4\\ 0 \leq x_1, x_2, x_3, x_4 \leq 1\\ 0 \leq x_5, x_6 \leq 16 \end{aligned}\]

with \(k_1 = 0.09755988\), \(k_3 = 0.0391908\) \(k_2 = 0.99k_1\) and \(k_4 = 0.9k_3\). The objective function is defined in ex3.R. Note that equality constraints must be declared before inequality constraints. Parameters \(k_1,\ldots, k_4\) are passed to the objective function through the main script, therefore they do not have to be calculated in every function evaluation. See the input arguments below.

ex3<-function(x,k1,k2,k3,k4){
f=-x[4]
#Equality constraints
    g<-rep(0,5)
    g[1]=x[4]-x[3]+x[2]-x[1]+k4*x[4]*x[6]
    g[2]=x[1]-1+k1*x[1]*x[5]
    g[3]=x[2]-x[1]+k2*x[2]*x[6]
    g[4]=x[3]+x[1]-1+k3*x[3]*x[5]

#Inequality constraint
    g[5]=x[5]^0.5+x[6]^0.5
    return(list(f=f,g=g))
}

The solver is called in main_ex3.R. The global optimum for this problem is located in \(x^*=[0.77152, 0.516994, 0.204189, 0.388811, 3.0355, 5.0973]\) with \(f(x^*)= -0.388811\).

Options set:

  • Number of equality constraints set to 4 in problem$neq..
  • Fields problem$c_L and problem$c_U only contain bounds for inequality constraints.
  • Maximum computation time set to 5 seconds.
  • Local solver chosen: solnp. It requires the R packages Rsonlp and truncnorm.
  • Parameters \(k_1,\ldots, k_4\) are passed to the main routine as input arguments.
#=========================
#PROBLEM SPECIFICATIONS
#=========================
problem<-list(f="ex3",x_L=rep(0,6),x_U=c(rep(1,4),16,16),
neq=4, c_L=-Inf, c_U=4)
opts<-list(maxtime=5, local_solver='solnp')
#=============================
#END OF PROBLEM SPECIFICATIONS
#=============================
k1=0.09755988
k3=0.0391908
k2=0.99*k1
k4=0.9*k3
Results<-MEIGO(problem,opts,algorithm="ESS",k1,k2,k3,k4)

3.3.4 Mixed integer problem

\[\begin{aligned} \min\limits_{x}f(x)=x_2^2 + x_3^2 + 2x_1^2 + x_4^2 - 5x_2 - 5x_3 - 21x_1 + 7x_4 \end{aligned}\]

subject to

\[\begin{aligned} x_2^2 + x_3^2 + x_1^2 + x_4^2 + x_2 - x_3 + x_1 - x_4 \leq 8\\ x_2^2 + 2x_3^2 + x_1^2 + 2x_4^2 - x_2 - x_4 \leq 10\\ 2x_2^2 + x_3^2 + x_1^2 + 2x_2 - x_3 - x_4 \leq 5\\ 0 \leq x_i \leq 10 \quad \forall i \in [1,\ldots, 4] \end{aligned}\]

Integer variables: \(x_2\), \(x_3\) and \(x_4\). In the function declaration ex4.R they must have the last indexes.

    ex4<-function(x){
        F = x[2]^2 + x[3]^2 + 2.0*x[1]^2 + x[4]^2 - 5.0*x[2] - 5.0*x[3] - 21.0*x[1] + 7.0*x[4]
        g<-rep(0,3)
        g[1] = x[2]^2 + x[3]^2 + x[1]^2 + x[4]^2 + x[2] - x[3] + x[1] - x[4]
        g[2] = x[2]^2 + 2.0*x[3]^2 + x[1]^2 + 2.0*x[4]^2 - x[2] - x[4]
        g[3] = 2.0*x[2]^2 + x[3]^2 + x[1]^2 + 2.0*x[2] - x[3] - x[4]
        return(list(F=F, g=g))
    }

The solver is called in main_ex4.R. The global optimum for this problem is located in \(x^*=[2.23607, 0, 1, 0]\) with \(f(x^*)=-40.9575\).

Options set:

  • An initial point is specified.
  • The number of integer variables is specified (mandatory).
  • No local solver is available for mixed-integer problems at the moment.
  • Stop criterion determined by the CPU time (2 seconds).
#========================= PROBLEM SPECIFICATIONS ===========================
problem<-list(f="ex4", x_L=rep(0,4), x_U=rep(10,4), x_0=c(3,4,5,1),
int_var=3, c_L=rep(-Inf,3), c_U=c(8,10,5))
opts<-list(maxtime=2)
#========================= END OF PROBLEM SPECIFICATIONS =====================
Results<-MEIGO(problem,opts,algorithm="ESS")

3.3.5 essR_multistart application

An application of essR_multistart within MEIGO on the problem ex3 using solnp as local solver is presented in the script main_multistart_ex3.R. The number of initial points chosen is 10.

#=========================
#PROBLEM SPECIFICATIONS
#=========================
problem<-list(f="ex3",x_L=rep(0,6),x_U=c(rep(1,4),16,16),
neq=4, c_L=-Inf, c_U=4)
opts<-list(ndiverse=10, local_solver='SOLNP', local_tol=3)
#=============================
#END OF PROBLEM SPECIFICATIONS
 #============================
k1=0.09755988
k3=0.0391908
k2=0.99*k1
k4=0.9*k3
Results<-MEIGO(problem,opts,algorithm="multistart",k1,k2,k3,k4)

4 Integer optimization: Variable Neighbourhood Search (VNSR)

VNSR is an R implementation of the Variable Neighbourhood Search (VNS) metaheuristic which is part of the MEIGO toolbox for global optimization in bioinformatics. VNS was first proposed by (Mladenović and Hansen 1997) for solving combinatorial and/or global optimization problems. The method guides a trial solution to search for an optimum in a certain area. After this optimum is located, the trial solution is perturbed to start searching in a new area (or neighbourhood). New neighbourhoods are defined following a distance criterion in order to achieve a good diversity in the search. Different variants of the method have been published in recent years in order to adapt it to different types of problems (Hansen, Mladenović, and Moreno-Pérez 2010). VNSR implements some of this variants by means of different tunning parameters. VNSR seeks the global minimum of integer programming (IP) problems specified by

\[\begin{aligned} \min\limits_{x}f(x,p_1,p_2,...,p_n) \end{aligned}\]

subject to

\[\begin{aligned} x_L\leq x\leq x_U \\ \end{aligned}\]

where \(x\) is the vector of (integer) decision variables, and \(x_L\) and \(x_U\) its respective bounds. \(p_1,\ldots,p_n\) are optional extra input parameters to be passed to the objective function, \(f\), to be minimized. The current VNSR version does not handle constraints apart from bound constrained, so that the user should formulate his/her own method (i.e., a penalty function) to solve constrained problems.

4.1 Quick start: How to carry out an optimization with VNSR

  • Define your problem and options (see the following sections)
  • Type Results<-MEIGO(problem,opts, algorithm="VNS"). If your problem has additional constant parameters to be passed to the objective function, they are declared as input parameters after “opts” (e.g., type Results<-MEIGO(problem,opts,algortim="VNS",p1,p2) if your model has two extra input parameters, \(p_1\) and \(p_2\)).

Regarding the objective function, the input parameter is the decision vector (with extra parameters \(p_1, p_2,\ldots, p_n\) if they were defined before calling the solver). The objective function must provide a scalar output parameter (the objective function value).

4.2 VNSR usage

4.2.1 Problem definition

A list named problem containing the following fields must be defined for running VNSR:

  • f: String containing the name of the objective function.
  • x_L: Vector containing the lower bounds of the variables.
  • x_U: Vector containing the upper bounds of the variables.
  • x_0: Vector containing the initial solution to start the search. If this field is not defined then the algorithm will choose an initial point randomly chosen within the bounds.

4.2.2 VNSR options

The user may define a set of different options related to the integer optimization problem. They are defined in another list (named opts here) which has the following fields.

  • maxeval: Maximum number of function evaluations (default: 1000).
  • maxtime: Maximum CPU time in seconds (default: 60).
  • iterprint: Print information on the screen after each iteration. 0: Deactivated; 1: Activated (default: 1).
  • maxdist: Percentage of the problem dimension which will be perturbed in the furthest neighborhood (vary between 0-1, default: 0.5).
  • use_local: Uses local search (1) or not (0). Default:1.

The following options only apply when the local search is activated (i.e., opts$use_local=1)

  • aggr: Aggressive search. The local search is only applied when the best solution has been improved (1=aggressive search, 0=non-aggressive search, default:0).
  • local_search_type: Applies a first (=1) or a best (=2) improvement scheme for the local search (Default: 1).
  • decomp: Decompose the local search (=1) using only the variables perturbed in the global phase. Default: 1.

4.2.3 Output

VNSR output is a list (called Results here) containing the following fields:

  • Results$fbest: Best objective function value found after the optimization.
  • Results$xbest: Vector providing the best function value found.
  • Results$cpu_time: CPU Time (in seconds) consumed in the optimization.
  • Results$func: Vector containing the best objective function value after each improvement
  • Results$x: Matrix containing the best vector after each improvement (in rows).
  • Results$time: Vector containing the CPU time consumed after each improvement.
  • Results$neval: Vector containing the number of evaluations after each improvement.
  • Results$numeval: Total number of function evaluations.

The list Results as well as problem and opts are stored and saved in a file called VNSR_report.RData.

4.3 Guidelines for using VNSR

Parameter tuning in VNSR may help increase the efficiency for a particular problem. Here is presented an explanation of the influence of each parameter and suggestions for tuning.

  • opts$use_local: It is activated (=1) by default but it might be deactivated for a first quick run in which a feasible or a good solution is required in a short computation time, or when the problem dimension is so high that local searches involve high computational times.

  • opts$aggr: This option uses the aggressive scheme in which the local searh is only applied when the best solution has been improved within the local search. The activation of this options makes the method visit many different neighborhoods but without refining the solutions unless a very good one is found. It might be a good option to locate promising areas or to discard poor areas and constraint the search space later.

  • opts$local_search_type: There are two types of local searches implemented in the method. One is the first improvement, which perturbs all the decision variables in a random order, changing one unit per dimension and stopping when the intial solution has been outperformed even if there are variables still not perturbed. The second option is a best improvement, which perturbs all the decision variables and then chooses the best solution among the perturbed solution to replace (or not) the initial solution. The best improvement produces a more exhaustive search than the first improvement, but it may be highly time consuming for large-scale problems. The first improvement scheme allows a more dynamic search but can miss refined high quality solutions. In both cases the principle is applied: If a solution has been improved by perturbing one dimension, we repeat the perturbation following the same direction since it is considered as a promising search direction.

  • opts$decomp: Performing a local search over all the decision variables might be computationally inefficient in the case of large-scale problems. The Variable Neighbourhood Decomposition Search (VNDS, (Hansen, Mladenović, and Pérez-Brito 2001)) decomposes the problem into a smaller sized one by just performing the local search over the perturbed decision variables instead of all of them. The number of perturbed decision variables is determined by the problem dimension and by the options opts$maxdist (see below).

  • opts$maxdist: This option chooses the percentage (between 0 and 1), of decision variables which are perturbed simultaneously in the search. In other words, it controls the distance between the current solution and the furthest neighborhood to explore. A high percentage (e.g., 100% of the variables) produces a more exhaustive search but is more time consuming. It has been empirically proven that for many instances a low percentage of perturbed variables is efficient to locate global solutions.

4.4 Application example

To illustrate the use of VNSR we choose the 10 dimensional Rosenbrock function with integer decision variables as an example. The code of the Rosenbrock function is available inside the installation directory of the MEIGO package, under the benchmarks folder. Source the objective function and assign it to the problem list.

rosen10<-function(x){
        f<-0
        n=length(x)
        for (i in 1:(n-1)){
            f <- f + 100*(x[i]^2 - x[i+1])^2 + (x[i]-1)^2
        }
        return(f)
    }

nvar<-10

Define the problem settings:

problem<-list(f="rosen10", x_L=rep(-5,nvar), x_U=rep(1,nvar))

Define the algorithm to be used:

algorithm="VNS"

Define the options for VNSR:

opts<-list(maxeval=2000, maxtime=3600*69, use_local=1,
     aggr=0, local_search_type=1, decomp=1, maxdist=0.5)

Call MEIGO:

Results<-MEIGO(problem,opts,algorithm)

5 Parallel computation in MEIGO

MEIGO allows the user to exploit multi core computation with either of the implemented methods by means of their corresponding parallelizable versions: CeSSR and CeVNS. The following sections include and introduction to the parallel computing packages needed to exploit this features as well as application examples to implement the methods.

5.1 Quick notes about the parallel computing packages

In order to launch multiple threads of eSSR and/or VNSR we use the snow package, available in the CRAN repository. Installing and using this package in a cluster might not be entirely trivial and therefore we will start by adding a few notes about this.

5.1.1 Snowfall

The snowfall package is based in the snow package to ease cluster programming. Detailed information can be found at https://cran.r-project.org/web/packages/snowfall/index.html. In MEIGO we allow the use of two mechanisms:

  • Socket-connection: Socket-connection is the simplest option and is what we recommend for a quick-start. Socket connections are made over TCP/IP and do not require the installation of any additional software. If working in a cluster you will have to specify the address of the machines you want connect to. If you are running in a local machine (preferentially but no necessarily with multiple cores) the R instances will be launched in your machine. More details on how to configure this options will be provided further ahead in this manual.
  • MPI: The Message Parsing Interface option depends on your ability to install and use the package Rmpi in your cluster. Detailed information on how to this can be found at http://www.stats.uwo.ca/faculty/yu/Rmpi/.

5.2 Usage

5.2.1 Options

The corresponding cooperative method for either of the algorithms included in MEIGO (i.e., CeSSR and CeVNSR), is invoked using the same problem declaration and options (see sections 3.2 and 4.2). To select the cooperative version of each method, the field algorithm must contain either CeSSR or CeVNSR. The list opts must now be a vector for each field instead of a scalar. For example, if we want to use CeSSR with 3 different threads, we would define the options of maximum number of evaluations as

opts=list();
opts[[1]]$maxeval<-value1
opts[[2]]$maxeval<-value2
opts[[3]]$maxeval<-value3

The first n fields should contain the options for the n threads that are going to be used. The field n+1 should be named hosts. opts$hosts should be a vector containing as many elements as threads you want to launch in parallel. In case you are using the ‘SOCKS’ mechanism from snowfall each element of this vector should be a string with the address of the machines where you want to launch the optimization. For instance, opts$hosts('node1','node1','node2','node2','node5','localhost','127.0.0.1') will use 7 threads for each iteration; two at ‘node1’, two at ‘node2’, one in ‘node5’ and two in your local machine (‘localhost’ and ‘127.0.0.1’).

Additionally, a set of extra options must be defined in the list opts. These extra options are the following:

  • ce_maxeval: The maximum number of evaluations. By default this is set to infinity leaving the stopping criterion to the number of iterations.

  • ce_maxtime: The maximum time to be spent in the cooperative search. By default this is set to infinity leaving the stopping criterion to the number of cooperative iterations. Notice that although you can specify its value, this stopping criterion will only be checked at the end of each iteration. Therefore if a cooperative iteration takes long it is expected that the cooperative method takes a bit longer to finish than what you have specified.

  • ce_niter: The number of times the threads will stop to exchange information. The default is 1, meaning that there will be an initial iteration (iteration 0) where the threads will stop to exchange the best solutions found and start a new optimization round. This value can also be set to 0 meaning that you will run multiple or runs in parallel without any exchange of information from the threads.

  • ce_isparallel: By default this is set to true. Otherwise each thread will be executed sequentially.

  • ce_type: The type of mechanism used for parallelization. The ‘SOCKS’ mechanism is incorporated through the snowfall package), In this case, it is important to define the addresses of opts$hosts properly. Additionally, the ‘MPI’ (from snowfall) is also available.

          <!-- \item \textbf{global\_save\_list}: This field should contain the names of the global variables to be exported. -->

5.2.2 Output

The CeSSR / CeVNSR output is a list containing the following fields:

  • f_mean: Contains the mean value of the objective function at each iteration.

  • fbest: Contains the lowest value found by the objective function at each iteration.

  • iteration_res: Contains the results returned by each CeSSR / CeVNSR thread at the end of an iteration. Check sections 3.2.5 and 4.2.3 for more information.

  • numeval: The number of evaluations at the end of each iteration.

  • time: The computation time at the end of each iteration.

5.3 CeSSR application example

CeSSR is an R implementation of the Cooperative enhanced Scatter Search method which is part of the MEIGO toolbox for global optimization in bioinformatics. The CeSS strategy (Villaverde, Egea, and Banga 2012) is a general purpose technique for global optimization, suited for a computing environment with several processors. Its key feature is the cooperation between the different programs (“threads”) that run in parallel in different processors. Each thread implements the enhanced Scatter Search metaheuristic (eSS) (Egea et al. 2009; Egea, Martí, and Banga 2010), which is also available in MEIGO.

To illustrate the use of CeSSR we choose the D/2m-group Shifted and m-rotated Rastrigin’s function (f10) from the LSGO benchmarks (Tang, Yang, and Weise 2012) as an example. The code of f10 is available inside the installation directory of the MEIGO package, under the benchmarks folder. Source the objective function and assign it to the problem list, defining the bounds for the decision variables:

rosen10<-function(x){
    f<-0
    n=length(x)
    for (i in 1:(n-1)){
         f <- f + 100*(x[i]^2 - x[i+1])^2 + (x[i]-1)^2
    }
    return(f)
}

nvar=20
problem<-list(f=rosen10, x_L=rep(-1000,nvar), x_U=rep(1000,nvar))

#Set 1 nodes and 2 cpu's per node
n_nodes=1
n_cpus_per_node=3

#Set different values for dim_refset, bal and n2
#for each of the 10 cpu's to be used
dim1 = 23;     bal1 = 0;     n2_1 = 0;
dim2 = 33;     bal2 = 0;     n2_2 = 0;
dim3 = 46;     bal3 = 0;     n2_3 = 2;
dim4 = 56;     bal4 = 0;     n2_4 = 4;
dim5 = 72;     bal5 = 0.25;  n2_5 = 7;
dim6 = 72;     bal6 = 0.25;  n2_6 = 10;
dim7 = 88;     bal7 = 0.25;  n2_7 = 15;
dim8 = 101;    bal8 = 0.5;   n2_8 = 20;
dim9 = 111;    bal9 = 0.25;  n2_9 = 50;
dim10 = 123;   bal10 = 0.25; n2_10 = 100;

opts_dim=c(dim1,dim2,dim3,dim4,dim5,dim6,dim7,dim8,dim9,dim10)
opts_bal=c(bal1,bal2,bal3,bal4,bal5,bal6,bal7,bal8,bal9,bal10)
opts_n2=c(n2_1,n2_2,n2_3,n2_4,n2_5,n2_6,n2_7,n2_8,n2_9,n2_10)
D=10

#Initialize counter and options
counter=0
opts=list()
hosts=c()

for(i in 1:n_nodes){
  for(j in 1:n_cpus_per_node){

    counter=counter+1

    #Set the name of every thread
    if(i<10)hosts=c(hosts,paste('node0',i,sep=""))
    if(i>=10 && i<100)hosts=c(hosts,paste('node',i,sep=""))

    opts[[counter]]=list()

    #Set specific options for each thread
    opts[[counter]]$local_balance   =   opts_bal[counter]
    opts[[counter]]$dim_refset      =   opts_dim[counter]
    opts[[counter]]$local_n2        =   opts_n2[counter]

    #Set common options for each thread

    opts[[counter]]$maxeval         =   10000
    opts[[counter]]$local_solver    =   "dhc"

    #Options not set will take default values for every thread

  }
}

#Set the address of each machine, defined inside the 'for' loop
opts$hosts=c('localhost','localhost','localhost')

#Do not define the additional options for cooperative methods (e.g., ce_maxtime, ce_isparallel, etc..)
#They will take their default values
opts$ce_niter=5
opts$ce_type="SOCKS"
opts$ce_isparallel=TRUE

#Call the solver
Results<-MEIGO(problem,opts,algorithm="CeSSR")

6 CeVNSR application example

CeVNSR is an extension of VNSR which makes use of parallel computation packages available in R to reduce the time needed to solve a given integer programming problem (IP). This implementation builds on the ideas explored by (Villaverde, Egea, and Banga 2012) which showed (in a nonlinear programming context) that, at least for a set of benchmarks, cooperative instances of an optimization algorithm exchanging information from time to time produced better results than running same instances in an independent fashion with an equivalent computational cost.

Next we show an example function that illustrates how to configure the list of options used by CeVNSR. This example calls two cpu’s of our local machine to solve the integer Rosenbrock problem. It can be found in the script main_CeVNSR_example.R in the benchmarks folder.

rosen10<-function(x){
        f<-0
        n=length(x)
        for (i in 1:(n-1)){
            f <- f + 100*(x[i]^2 - x[i+1])^2 + (x[i]-1)^2
        }
        return(f)
    }

nvar=20

problem<-list(f=rosen10, x_L=rep(-1000,nvar), x_U=rep(1000,nvar))

opts=list()
opts[[1]]=list(use_local=1,aggr=1,local_search=1,decomp=1,maxdist=0.8,maxeval=2000)
opts[[2]]=list(use_local=1,aggr=0,local_search=2,decomp=0,maxdist=0.5,maxeval=2000)
opts[[3]]=list(use_local=1,aggr=0,local_search=2,decomp=0,maxdist=0.5,maxeval=2000)
opts[[4]]=list(use_local=1,aggr=0,local_search=2,decomp=0,maxdist=0.5,maxeval=2000)

opts$hosts=c('localhost','localhost','localhost','localhost')

opts$ce_niter=10
opts$ce_type="SOCKS"
opts$ce_isparallel= TRUE

Results=MEIGO(problem,opts, algorithm="CeVNSR")

7 Applications from Systems Biology

In this section we provide examples for two systems biology problems related with the use and calibration of logic models for modeling cell signaling pathways.

7.1 Using eSS to fit a dynamic model

In this section we use eSS to calibrate a model of ordinary differential equations. Here the dynamics are simulated with the CNORode package CNORode (Henriques and Cokelaer 2012) which is part of the CellNOptR package (T.Cokelaer et al. 2012; Terfve et al. 2012).

The model shown here is toy pathway for illustrative purposes. A detailed description on the biological problem and published case studies can be found in http://www.cellnopt.org/. Briefly, CNORode uses a technique called multivariate polynomial interpolation (Krumsiek et al. 2010) in order to transform a logic model into a system of ordinary differential equations. The final goal of the package is to calibrate such model (its parameters) by means of optimization strategies where the objective is to minimize the squared difference between the model predictions and the experimental data.

In this example, we start by loading the package and the necessary model and experimental data:

library(MEIGOR)
library(CNORode)
data("CNORodeExample",package="MEIGOR")
plotCNOlist(cnolist)
Plot of the experimental data for the CNORode example.

Figure 1: Plot of the experimental data for the CNORode example

This data was generated in silico and added \(5\%\) of Gaussian noise to simulate the experimental error. Figure 1 shows the plot of the experimental data.

In order to visualize the logic model we can use the CellNOptR package (see Figure 2)