filter.hpp

Go to the documentation of this file.

/* -*- mode: C++; c-basic-offset: 2; indent-tabs-mode: nil -*- */
/*
 *  Main authors:
 *     Christian Schulte <schulte@gecode.org>
 *
 *  Copyright:
 *     Christian Schulte, 2016
 *
 *  This file is part of Gecode, the generic constraint
 *  development environment:
 *     http://www.gecode.org
 *
 *  Permission is hereby granted, free of charge, to any person obtaining
 *  a copy of this software and associated documentation files (the
 *  "Software"), to deal in the Software without restriction, including
 *  without limitation the rights to use, copy, modify, merge, publish,
 *  distribute, sublicense, and/or sell copies of the Software, and to
 *  permit persons to whom the Software is furnished to do so, subject to
 *  the following conditions:
 *
 *  The above copyright notice and this permission notice shall be
 *  included in all copies or substantial portions of the Software.
 *
 *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 *  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 *  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 *  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 *  OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 *  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 *
 */

namespace Gecode {

  class TraceFilter;

  class TFE {
    friend GECODE_KERNEL_EXPORT TFE operator -(const TFE& r);
    friend GECODE_KERNEL_EXPORT TFE propagator(PropagatorGroup g);
    friend GECODE_KERNEL_EXPORT TFE post(PropagatorGroup g);
    friend class TraceFilter;
  protected:
    enum NodeType {
      NT_GROUP,    
      NT_NEGATE,   
      NT_ADD       
    };
    class Node : public HeapAllocated {
    public:
      unsigned int use;
      NodeType t;
      int n;
      Group g;
      char w;
      Node *l, *r;
      Node(void);
      GECODE_KERNEL_EXPORT
      bool decrement(void);
    };
    Node* n;
    TFE(void);
    TFE(Node* n);
    void init(Group g, char what);
    TFE negate(void) const;
  public:
    GECODE_KERNEL_EXPORT
    TFE(PropagatorGroup g);
    GECODE_KERNEL_EXPORT
    TFE(BrancherGroup g);
    GECODE_KERNEL_EXPORT
    static TFE other(void);
    GECODE_KERNEL_EXPORT
    TFE(const TFE& e);
    GECODE_KERNEL_EXPORT
    TFE& operator =(const TFE& e);
    GECODE_KERNEL_EXPORT
    TFE& operator +=(const TFE& e);
    GECODE_KERNEL_EXPORT
    TFE& operator -=(const TFE& e);
    GECODE_KERNEL_EXPORT
    ~TFE(void);
  };

  TFE operator +(TFE l, const TFE& r);
  TFE operator +(const TFE& e);
  TFE operator -(TFE l, const TFE& r);
  GECODE_KERNEL_EXPORT
  TFE operator -(const TFE& e);
  GECODE_KERNEL_EXPORT
  TFE propagator(PropagatorGroup g);
  GECODE_KERNEL_EXPORT
  TFE post(PropagatorGroup g);


  class TraceFilter : public SharedHandle {
  protected:
    class TFO : public SharedHandle::Object {
    public:
      struct Filter {
        Group g;
        bool neg;
        char what;
      };
      class StackFrame {
      public:
        TFE::Node* n;
        bool neg;
        StackFrame(void);
        StackFrame(TFE::Node* n, bool neg);
      };
      int n;
      Filter* f;
      GECODE_KERNEL_EXPORT
      void fill(TFE::Node* n);
      TFO(void);
      TFO(const TFE& e);
      TFO(PropagatorGroup g);
      TFO(BrancherGroup g);
      bool operator ()(const ViewTraceInfo& vti) const;
      bool operator ()(PropagatorGroup pg) const;
      bool operator ()(BrancherGroup bg) const;
      GECODE_KERNEL_EXPORT
      virtual ~TFO(void);
    };
  public:
    GECODE_KERNEL_EXPORT
    TraceFilter(void);
    GECODE_KERNEL_EXPORT
    TraceFilter(const TFE& e);
    GECODE_KERNEL_EXPORT
    TraceFilter(PropagatorGroup g);
    GECODE_KERNEL_EXPORT
    TraceFilter(BrancherGroup g);
    GECODE_KERNEL_EXPORT
    TraceFilter(const TraceFilter& tf);
    GECODE_KERNEL_EXPORT
    TraceFilter& operator =(const TraceFilter& tf);
    bool operator ()(const ViewTraceInfo& vti) const;
    bool operator ()(PropagatorGroup pg) const;
    bool operator ()(BrancherGroup bg) const;
    GECODE_KERNEL_EXPORT
    static TraceFilter all;
  };



  /*
   * Trace expression filters
   *
   */

  forceinline
  TFE::Node::Node(void)
    : use(1), l(NULL), r(NULL) {}
  forceinline
  TFE::TFE(void) : n(NULL) {}
  forceinline
  TFE::TFE(TFE::Node* n0) : n(n0) {}

  forceinline TFE
  operator +(TFE l, const TFE& r) {
    l += r; return l;
  }
  forceinline TFE
  operator +(const TFE& e) {
    return e;
  }
  forceinline TFE
  operator -(TFE l, const TFE& r) {
    l -= r; return l;
  }


  /*
   * Trace filters
   *
   */
  forceinline
  TraceFilter::TFO::TFO(void) : n(0), f(NULL) {}
  forceinline
  TraceFilter::TFO::TFO(const TFE& e)
    : n(e.n->n),
      f((n == 0) ? NULL : heap.alloc<Filter>(n)) {
    if (n > 0)
      fill(e.n);
  }
  forceinline
  TraceFilter::TFO::TFO(PropagatorGroup g) : n(1) {
    f = heap.alloc<Filter>(1);
    f[0].g = g; f[0].neg = false;
    f[0].what = 1 << ViewTraceInfo::PROPAGATOR;

  }
  forceinline
  TraceFilter::TFO::TFO(BrancherGroup g) : n(1) {
    f = heap.alloc<Filter>(1);
    f[0].g = g; f[0].neg = false;
    f[0].what = 1 << ViewTraceInfo::BRANCHER;

  }
  forceinline bool
  TraceFilter::TFO::operator ()(const ViewTraceInfo& vti) const {
    if (n == 0)
      return true;
    for (int i=0; i<n; i++)
      if (f[i].what & (1 << vti.what())) {
        // Group is of the right type
        switch (vti.what()) {
        case ViewTraceInfo::PROPAGATOR:
          if (f[i].g.in(vti.propagator().group()) != f[i].neg)
            return true;
          break;
        case ViewTraceInfo::BRANCHER:
          if (f[i].g.in(vti.brancher().group()) != f[i].neg)
            return true;
          break;
        case ViewTraceInfo::POST:
          if (f[i].g.in(vti.post()) != f[i].neg)
            return true;
          break;
        case ViewTraceInfo::OTHER:
          return true;
        default:
          GECODE_NEVER;
        }
      }
    return false;
  }

  forceinline bool
  TraceFilter::operator ()(const ViewTraceInfo& vti) const {
    return static_cast<TFO*>(object())->operator ()(vti);
  }

  forceinline bool
  TraceFilter::TFO::operator ()(PropagatorGroup pg) const {
    if (n == 0)
      return true;
    for (int i=0; i<n; i++)
      if ((f[i].what & (1 << ViewTraceInfo::PROPAGATOR)) &&
          (f[i].g.in(pg) != f[i].neg))
        return true;
    return false;
  }

  forceinline bool
  TraceFilter::operator ()(PropagatorGroup pg) const {
    return static_cast<TFO*>(object())->operator ()(pg);
  }

  forceinline bool
  TraceFilter::TFO::operator ()(BrancherGroup bg) const {
    if (n == 0)
      return true;
    for (int i=0; i<n; i++)
      if ((f[i].what & (1 << ViewTraceInfo::BRANCHER)) &&
          (f[i].g.in(bg) != f[i].neg))
        return true;
    return false;
  }

  forceinline bool
  TraceFilter::operator ()(BrancherGroup bg) const {
    return static_cast<TFO*>(object())->operator ()(bg);
  }

}

// STATISTICS: kernel-trace