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 original MiniSat specification from:
20   * 
21   * An extensible SAT solver. Niklas Een and Niklas Sorensson. Proceedings of the
22   * Sixth International Conference on Theory and Applications of Satisfiability
23   * Testing, LNCS 2919, pp 502-518, 2003.
24   *
25   * See www.minisat.se for the original solver in C++.
26   * 
27   *******************************************************************************/
28  package org.sat4j.minisat.orders;
29  
30  /**
31   * @author leberre TODO To change the template for this generated type comment
32   *         go to Window - Preferences - Java - Code Style - Code Templates
33   */
34  public final class PureOrder extends VarOrderHeap {
35  
36  	/**
37  	 * Comment for <code>serialVersionUID</code>
38  	 */
39  	private static final long serialVersionUID = 1L;
40  
41  	private int period;
42  
43  	private int cpt;
44  
45  	public PureOrder() {
46  		this(20);
47  	}
48  
49  	public PureOrder(int p) {
50  		setPeriod(p);
51  	}
52  
53  	public final void setPeriod(int p) {
54  		period = p;
55  		cpt = period;
56  	}
57  
58  	public int getPeriod() {
59  		return period;
60  	}
61  
62  	/*
63  	 * (non-Javadoc)
64  	 * 
65  	 * @see org.sat4j.minisat.core.VarOrder#select()
66  	 */
67  	@Override
68  	public int select() {
69  		// wait period branching
70  		if (cpt < period) {
71  			cpt++;
72  		} else {
73  			// try to find a pure literal
74  			cpt = 0;
75  			int nblits = 2 * lits.nVars();
76  			for (int i = 2; i <= nblits; i++) {
77  				if (lits.isUnassigned(i) && lits.watches(i).size() > 0
78  						&& lits.watches(i ^ 1).size() == 0) {
79  					return i;
80  				}
81  			}
82  		}
83  		// not found: using normal order
84  		return super.select();
85  	}
86  
87  	@Override
88  	public String toString() {
89  		return "tries to first branch on a single phase watched unassigned variable (pure literal if using a CB data structure) else VSIDS from MiniSAT"; //$NON-NLS-1$
90  	}
91  }