kernel/SingletonPredicate.h

Go to the documentation of this file.

/**
 *  \file IMP/kernel/SingletonPredicate.h
 *  \brief Define SingletonPredicate.
 *
 *  WARNING This file was generated from SingletonPredicate.h
 *  in /tmp/nightly-build-90783/imp-2.1.0/tools/build/container_templates/kernel
 *  by tools/maintenance/setup_containers.py.
 *
 *  Copyright 2007-2013 IMP Inventors. All rights reserved.
 */

#ifndef IMPKERNEL_SINGLETON_PREDICATE_H
#define IMPKERNEL_SINGLETON_PREDICATE_H

#include <IMP/kernel/kernel_config.h>
#include "base_types.h"
#include "ParticleTuple.h"
#include "DerivativeAccumulator.h"
#include "internal/container_helpers.h"
#include "model_object_helpers.h"

IMPKERNEL_BEGIN_NAMESPACE

//! Abstract predicate function
/** A predicate is a function which returns one of a discrete set of
    values (eg -1, 0, 1 depending on whether a value is negative, zero
    or positive). SingletonPredicates will evaluate the predicate for the passed
    particles.

    Implementers should check out IMP_SINGLETON_PREDICATE().
*/
class IMPKERNELEXPORT SingletonPredicate : public ParticleInputs,
                                           public base::Object {
 public:
  typedef Particle* Argument;
  typedef ParticleIndex IndexArgument;
  SingletonPredicate(std::string name = "SingletonPredicate %1%");
  /** \deprecated_at{2.1} Use the index based version.*/
  IMPKERNEL_DEPRECATED_METHOD_DECL(2.1)
    virtual int get_value(Particle* vt) const;

  /** \deprecated_at{2.1} Use the index based version.*/
  IMPKERNEL_DEPRECATED_METHOD_DECL(2.1)
      virtual Ints get_value(const ParticlesTemp &o) const;

#if !defined(IMP_DOXYGEN) && !defined(SWIG)
  virtual void remove_if_equal(kernel::Model *m, ParticleIndexes &ps, int v) const;
  virtual void remove_if_not_equal(kernel::Model *m, ParticleIndexes &ps, int v) const;
#endif

  //! Compute the predicate and the derivative if needed.
  virtual int get_value_index(kernel::Model *m, ParticleIndex vt) const;

  //! Enable them to be use as functors
  /** But beware of slicing.
   */
  int operator()(kernel::Model *m, ParticleIndex vt) const {
    return get_value_index(m, vt);
  }

  virtual Ints get_value_index(kernel::Model *m, const ParticleIndexes &o) const {
    Ints ret(o.size());
    for (unsigned int i = 0; i < o.size(); ++i) {
      ret[i] += get_value_index(m, o[i]);
    }
    return ret;
  }

  IMP_REF_COUNTED_DESTRUCTOR(SingletonPredicate);
};

IMPKERNEL_END_NAMESPACE

#endif /* IMPKERNEL_SINGLETON_PREDICATE_H */