View Javadoc

1   /*******************************************************************************
2    * SAT4J: a SATisfiability library for Java Copyright (C) 2004, 2012 Artois University and CNRS
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   * Contributors:
28   *   CRIL - initial API and implementation
29   *******************************************************************************/
30  package org.sat4j;
31  
32  import org.sat4j.core.ASolverFactory;
33  import org.sat4j.minisat.constraints.MixedDataStructureDanielWL;
34  import org.sat4j.minisat.core.DataStructureFactory;
35  import org.sat4j.minisat.core.SearchParams;
36  import org.sat4j.minisat.core.Solver;
37  import org.sat4j.minisat.learning.MiniSATLearning;
38  import org.sat4j.minisat.orders.RSATPhaseSelectionStrategy;
39  import org.sat4j.minisat.orders.VarOrderHeap;
40  import org.sat4j.minisat.restarts.ArminRestarts;
41  import org.sat4j.specs.ISolver;
42  
43  /**
44   * That class is the entry point to the default, best performing configuration
45   * of SAT4J. Since there is only one concrete reference per strategy used inside
46   * the solver, it is a good start for people willing to reduce the library to
47   * the minimal number of classes needed to run a SAT solver. The main method
48   * allow to run the solver from the command line.
49   * 
50   * @author leberre
51   * @since 2.2
52   */
53  public class LightFactory extends ASolverFactory<ISolver> {
54      private static final long serialVersionUID = 1460304168178023681L;
55      private static LightFactory instance;
56  
57      private static synchronized void createInstance() {
58          if (instance == null) {
59              instance = new LightFactory();
60          }
61      }
62  
63      /**
64       * Access to the single instance of the factory.
65       * 
66       * @return the singleton of that class.
67       */
68      public static LightFactory instance() {
69          if (instance == null) {
70              createInstance();
71          }
72          return instance;
73      }
74  
75      @Override
76      public ISolver defaultSolver() {
77          MiniSATLearning<DataStructureFactory> learning = new MiniSATLearning<DataStructureFactory>();
78          Solver<DataStructureFactory> solver = new Solver<DataStructureFactory>(
79                  learning, new MixedDataStructureDanielWL(), new VarOrderHeap(
80                          new RSATPhaseSelectionStrategy()), new ArminRestarts());
81          learning.setSolver(solver);
82          solver.setSimplifier(solver.EXPENSIVE_SIMPLIFICATION);
83          solver.setSearchParams(new SearchParams(1.1, 100));
84          return solver;
85      }
86  
87      @Override
88      public ISolver lightSolver() {
89          return defaultSolver();
90      }
91  
92      public static void main(final String[] args) {
93          AbstractLauncher lanceur = new BasicLauncher<ISolver>(
94                  LightFactory.instance());
95          if (args.length != 1) {
96              lanceur.usage();
97              return;
98          }
99          lanceur.run(args);
100         System.exit(lanceur.getExitCode().value());
101     }
102 
103 }