Frobby  0.9.0
OptimizeStrategy.h
Go to the documentation of this file.
1 /* Frobby: Software for monomial ideal computations.
2  Copyright (C) 2007 Bjarke Hammersholt Roune (www.broune.com)
3 
4  This program is free software; you can redistribute it and/or modify
5  it under the terms of the GNU General Public License as published by
6  the Free Software Foundation; either version 2 of the License, or
7  (at your option) any later version.
8 
9  This program is distributed in the hope that it will be useful,
10  but WITHOUT ANY WARRANTY; without even the implied warranty of
11  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  GNU General Public License for more details.
13 
14  You should have received a copy of the GNU General Public License
15  along with this program. If not, see http://www.gnu.org/licenses/.
16 */
17 #ifndef OPTIMIZE_STRATEGY_GUARD
18 #define OPTIMIZE_STRATEGY_GUARD
19 
20 #include "MsmStrategy.h"
21 #include "Term.h"
22 #include "TermConsumer.h"
23 #include "tests.h"
24 
25 class Slice;
26 class TermGrader;
27 
43 class OptimizeStrategy : public MsmStrategy, public TermConsumer {
44 public:
46  enum BoundSetting {
49 
53 
58  };
59 
72  const SplitStrategy* splitStrategy,
73  bool reportAllSolutions,
74  BoundSetting boundSetting);
75 
80  const Ideal& getMaximalSolutions();
81 
86  const mpz_class& getMaximalValue();
87 
91  virtual void setUseIndependence(bool use);
92 
93  virtual void getPivot(Term& pivot, Slice& slice);
94 
104  virtual bool simplify(Slice& slice);
105 
106  virtual void beginConsuming();
107  virtual void consume(const Term& term);
108  virtual void doneConsuming();
109 
110  private:
131  (const Term& oldDivisor, const Term& oldDominator,
132  const Term& newDivisor, const Term& newDominator) const;
133 
210  bool boundSimplify
211  (Slice& slice,
212  const Term& dominator,
213  const mpz_class& upperBound);
214 
265  bool getInnerSimplify
266  (const Term& divisor,
267  const Term& dominator,
268  const mpz_class& upperBound,
269  Term& pivot);
270 
324  bool getOuterSimplify
325  (const Term& divisor,
326  const Term& dominator,
327  const mpz_class& upperBound,
328  Term& pivot);
329 
336  bool getDominator(Slice& slice, Term& dominator);
337 
339  size_t getVarCount() const;
340 
343 
347  mpz_class _maxValue;
348 
361  mpz_class _maxValueToBeat;
362 
367 
372 
375 
380 
385 
390 
395 
400 
405  mpz_class _tmpC;
406 
411 
412 
413  FRIEND_TEST(OptimizeStrategy, ChangedInWayRelevantToBound);
414  FRIEND_TEST(OptimizeStrategy, SimplifyPositiveGrading);
415  FRIEND_TEST(OptimizeStrategy, SimplifyNegativeGrading);
416 };
417 
418 #endif
OptimizeStrategy::_grader
const TermGrader & _grader
We use _grader to assign values to solutions.
Definition: OptimizeStrategy.h:342
OptimizeStrategy::_boundSetting
BoundSetting _boundSetting
Indicates how to use the bound.
Definition: OptimizeStrategy.h:374
OptimizeStrategy::getOuterSimplify
bool getOuterSimplify(const Term &divisor, const Term &dominator, const mpz_class &upperBound, Term &pivot)
Find an inner slice that is non-improving, allowing us to replace the current slice with the outer sl...
Definition: OptimizeStrategy.cpp:278
OptimizeStrategy
OptimizeStrategy optimizes a function on the maximal standard monomials of a monomial ideal using bra...
Definition: OptimizeStrategy.h:43
OptimizeStrategy::doneConsuming
virtual void doneConsuming()
Must be called once after each time beginConsuming has been called.
Definition: OptimizeStrategy.cpp:74
MsmStrategy
Definition: MsmStrategy.h:37
OptimizeStrategy::_maxValue
mpz_class _maxValue
The best value of any solution found so far.
Definition: OptimizeStrategy.h:347
OptimizeStrategy::_maxValueToBeat
mpz_class _maxValueToBeat
Is equal to _maxValue minus _reportAllSolutions, except when no solution has been found so far,...
Definition: OptimizeStrategy.h:361
OptimizeStrategy::_simplify_tmpDominator
Term _simplify_tmpDominator
Temporary variable used in simplify.
Definition: OptimizeStrategy.h:389
OptimizeStrategy::_tmpC
mpz_class _tmpC
Temporary variable used in getInnerSimplify and getOuterSimplify.
Definition: OptimizeStrategy.h:405
SplitStrategy
A SplitStrategy is an implementation of a split selection strategy for the Slice Algorithm.
Definition: SplitStrategy.h:30
OptimizeStrategy::FRIEND_TEST
FRIEND_TEST(OptimizeStrategy, ChangedInWayRelevantToBound)
OptimizeStrategy::BoundSetting
BoundSetting
The values of BoundSetting indicate how to use the bound.
Definition: OptimizeStrategy.h:46
Term.h
OptimizeStrategy::_reportAllSolutions
bool _reportAllSolutions
Indicates whether to compute all optimal solutions, as opposed to computing just one (when there are ...
Definition: OptimizeStrategy.h:371
OptimizeStrategy::getVarCount
size_t getVarCount() const
The number of varibles this object was initialized with.
Definition: OptimizeStrategy.cpp:350
OptimizeStrategy::getDominator
bool getDominator(Slice &slice, Term &dominator)
Sets dominator to be a term dominating every element of the content of slice.
Definition: OptimizeStrategy.cpp:329
OptimizeStrategy::_simplify_tmpOldDominator
Term _simplify_tmpOldDominator
Temporary variable used in simplify.
Definition: OptimizeStrategy.h:394
Slice
This class represents a slice, which is the central data structure of the Slice Algorithm.
Definition: Slice.h:77
OptimizeStrategy::_simplify_tmpOldDivisor
Term _simplify_tmpOldDivisor
Temporary variable used in simplify.
Definition: OptimizeStrategy.h:399
TermConsumer
This class is used to transfer terms one at a time from one part of the program to another,...
Definition: TermConsumer.h:36
OptimizeStrategy::DoNotUseBound
@ DoNotUseBound
Make no use of the bound.
Definition: OptimizeStrategy.h:48
Term
Term represents a product of variables which does not include a coefficient.
Definition: Term.h:49
OptimizeStrategy::setUseIndependence
virtual void setUseIndependence(bool use)
Independence splits are not supported, so calling this method does nothing.
Definition: OptimizeStrategy.cpp:50
MsmStrategy.h
OptimizeStrategy::changedInWayRelevantToBound
bool changedInWayRelevantToBound(const Term &oldDivisor, const Term &oldDominator, const Term &newDivisor, const Term &newDominator) const
Returns true if iterating bound-based simplification might do something.
Definition: OptimizeStrategy.cpp:160
OptimizeStrategy::getPivot
virtual void getPivot(Term &pivot, Slice &slice)
Used by pivotSplit to obtain a pivot.
Definition: OptimizeStrategy.cpp:77
OptimizeStrategy::getMaximalSolutions
const Ideal & getMaximalSolutions()
Returns one of or all of the msm's with optimal value found so far, depending on the value of reportA...
Definition: OptimizeStrategy.cpp:41
OptimizeStrategy::UseBoundToEliminateAndSimplify
@ UseBoundToEliminateAndSimplify
Eliminate non-improving slices and simplify slices by trying to generate non-improving slices that ar...
Definition: OptimizeStrategy.h:57
OptimizeStrategy::_consume_tmpDegree
mpz_class _consume_tmpDegree
Temporary variable used in consume.
Definition: OptimizeStrategy.h:379
OptimizeStrategy::_boundSimplify_tmpPivot
Term _boundSimplify_tmpPivot
Temporary variable used in simplify.
Definition: OptimizeStrategy.h:410
OptimizeStrategy::consume
virtual void consume(const Term &term)
Consume a term.
Definition: OptimizeStrategy.cpp:58
OptimizeStrategy::UseBoundToEliminate
@ UseBoundToEliminate
Eliminate non-improving slices, achieving a branch-and-bound algorithm in place of the usual backtrac...
Definition: OptimizeStrategy.h:52
Ideal
Represents a monomial ideal with int exponents.
Definition: Ideal.h:27
OptimizeStrategy::beginConsuming
virtual void beginConsuming()
Tell the consumer to begin consuming an ideal.
Definition: OptimizeStrategy.cpp:54
OptimizeStrategy::boundSimplify
bool boundSimplify(Slice &slice, const Term &dominator, const mpz_class &upperBound)
This method simplifies a slice based on generating non-improving outer and inner slices.
Definition: OptimizeStrategy.cpp:204
OptimizeStrategy::getMaximalValue
const mpz_class & getMaximalValue()
The optimal value associated to all entries from getMaximalSolutions().
Definition: OptimizeStrategy.cpp:45
tests.h
OptimizeStrategy::_maxSolutions
Ideal _maxSolutions
Stores the optimal solutions found so far, according to the best value found so far.
Definition: OptimizeStrategy.h:366
TermGrader
A TermGrader assigns a value, the degree, to each monomial.
Definition: TermGrader.h:27
OptimizeStrategy::getInnerSimplify
bool getInnerSimplify(const Term &divisor, const Term &dominator, const mpz_class &upperBound, Term &pivot)
Find an outer slice that is non-improving, allowing us to replace the current slice with the inner sl...
Definition: OptimizeStrategy.cpp:221
OptimizeStrategy::simplify
virtual bool simplify(Slice &slice)
This method calls MsmStrategy::simplify to perform the usual simplification of slice,...
Definition: OptimizeStrategy.cpp:81
OptimizeStrategy::OptimizeStrategy
OptimizeStrategy(TermGrader &grader, const SplitStrategy *splitStrategy, bool reportAllSolutions, BoundSetting boundSetting)
Construct an OptimizeStrategy.
Definition: OptimizeStrategy.cpp:23
OptimizeStrategy::_simplify_tmpUpperBound
mpz_class _simplify_tmpUpperBound
Temporary variable used in simplify.
Definition: OptimizeStrategy.h:384
TermConsumer.h