View Javadoc

1   /*******************************************************************************
2    * SAT4J: a SATisfiability library for Java Copyright (C) 2004-2008 Daniel Le Berre
3    *
4    * All rights reserved. This program and the accompanying materials
5    * are made available under the terms of the Eclipse Public License v1.0
6    * which accompanies this distribution, and is available at
7    * http://www.eclipse.org/legal/epl-v10.html
8    *
9    * Alternatively, the contents of this file may be used under the terms of
10   * either the GNU Lesser General Public License Version 2.1 or later (the
11   * "LGPL"), in which case the provisions of the LGPL are applicable instead
12   * of those above. If you wish to allow use of your version of this file only
13   * under the terms of the LGPL, and not to allow others to use your version of
14   * this file under the terms of the EPL, indicate your decision by deleting
15   * the provisions above and replace them with the notice and other provisions
16   * required by the LGPL. If you do not delete the provisions above, a recipient
17   * may use your version of this file under the terms of the EPL or the LGPL.
18   * 
19   * Based on the pseudo boolean algorithms described in:
20   * A fast pseudo-Boolean constraint solver Chai, D.; Kuehlmann, A.
21   * Computer-Aided Design of Integrated Circuits and Systems, IEEE Transactions on
22   * Volume 24, Issue 3, March 2005 Page(s): 305 - 317
23   * 
24   * and 
25   * Heidi E. Dixon, 2004. Automating Pseudo-Boolean Inference within a DPLL 
26   * Framework. Ph.D. Dissertation, University of Oregon.
27   *******************************************************************************/
28  package org.sat4j.pb;
29  
30  import java.io.Serializable;
31  import java.math.BigInteger;
32  
33  import org.sat4j.core.ReadOnlyVec;
34  import org.sat4j.core.ReadOnlyVecInt;
35  import org.sat4j.specs.ISolver;
36  import org.sat4j.specs.IVec;
37  import org.sat4j.specs.IVecInt;
38  
39  /**
40   * Abstraction for an Objective Function for Pseudo Boolean Optimization.
41   * 
42   * May be generalized in the future to deal with other optimization functions.
43   * 
44   * @author leberre
45   * 
46   */
47  public class ObjectiveFunction implements Serializable {
48  
49  	/**
50       * 
51       */
52  	private static final long serialVersionUID = 1L;
53  
54  	// contains the coeffs of the objective function for each variable
55  	private final IVec<BigInteger> coeffs;
56  
57  	private final IVecInt vars;
58  
59  	private BigInteger correction = BigInteger.ZERO;
60  
61  	public ObjectiveFunction(IVecInt vars, IVec<BigInteger> coeffs) {
62  		this.vars = new ReadOnlyVecInt(vars);
63  		this.coeffs = new ReadOnlyVec<BigInteger>(coeffs);
64  	}
65  
66  	// calculate the degree of the objective function
67  	public BigInteger calculateDegree(ISolver solver) {
68  		BigInteger tempDegree = BigInteger.ZERO;
69  
70  		for (int i = 0; i < vars.size(); i++) {
71  			BigInteger coeff = coeffs.get(i);
72  			if (varInModel(vars.get(i), solver))
73  				tempDegree = tempDegree.add(coeff);
74  			else if ((coeff.signum() < 0) && !varInModel(-vars.get(i), solver)) {
75  				// the variable does not appear in the model: it can be assigned
76  				// either way
77  				tempDegree = tempDegree.add(coeff);
78  			}
79  		}
80  		return tempDegree;
81  	}
82  
83  	private boolean varInModel(int var, ISolver solver) {
84  		if (var > 0)
85  			return solver.model(var);
86  		return !solver.model(-var);
87  	}
88  
89  	public IVec<BigInteger> getCoeffs() {
90  		return coeffs;
91  	}
92  
93  	public IVecInt getVars() {
94  		return vars;
95  	}
96  
97  	public void setCorrection(BigInteger correction) {
98  		this.correction = correction;
99  	}
100 
101 	public BigInteger getCorrection() {
102 		return correction;
103 	}
104 
105 	@Override
106 	public String toString() {
107 		StringBuffer stb = new StringBuffer();
108 		IVecInt lits = getVars();
109 		IVec<BigInteger> coefs = getCoeffs();
110 		BigInteger coef;
111 		int lit;
112 		for (int i = 0; i < lits.size(); i++) {
113 			coef = coefs.get(i);
114 			lit = lits.get(i);
115 			if (lit < 0) {
116 				lit = -lit;
117 				coef = coef.negate();
118 			}
119 			stb.append((coef.signum() < 0 ? "" : "+") + coef + " x" + lit + " ");
120 		}
121 		return stb.toString();
122 	}
123 
124 	public BigInteger minValue() {
125 		BigInteger tempDegree = BigInteger.ZERO;
126 		for (int i = 0; i < vars.size(); i++) {
127 			BigInteger coeff = coeffs.get(i);
128 			if (coeff.signum() < 0) {
129 				tempDegree = tempDegree.add(coeff);
130 			}
131 		}
132 		return tempDegree;
133 	}
134 
135 }