eoGeneralBreeder.h

// -*- mode: c++; c-indent-level: 4; c++-member-init-indent: 8; comment-column: 35; -*-

//-----------------------------------------------------------------------------
// eoGeneralBreeder.h
// (c) Maarten Keijzer and Marc Schoenauer, 2001
/*
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    Contact: mkeijzer@dhi.dk
             Marc.Schoenauer@polytechnique.fr
 */
//-----------------------------------------------------------------------------

#ifndef eoGeneralBreeder_h
#define eoGeneralBreeder_h

//-----------------------------------------------------------------------------

/*****************************************************************************
 * eoGeneralBreeder: transforms a population using the generalOp construct.
 *****************************************************************************/

#include <eoOp.h>
#include <eoGenOp.h>
#include <eoPopulator.h>
#include <eoSelectOne.h>
#include <eoBreed.h>
#include <utils/eoHowMany.h>

template<class EOT>
class eoGeneralBreeder: public eoBreed<EOT>
{
 public:
  eoGeneralBreeder(
          eoSelectOne<EOT>& _select,
          eoGenOp<EOT>& _op,
                double  _rate=1.0,
          bool _interpret_as_rate = true) :
      select( _select ), op(_op),  howMany(_rate, _interpret_as_rate) {}

  eoGeneralBreeder(
          eoSelectOne<EOT>& _select,
          eoGenOp<EOT>& _op,
          eoHowMany _howMany ) :
      select( _select ), op(_op),  howMany(_howMany) {}

  void operator()(const eoPop<EOT>& _parents, eoPop<EOT>& _offspring)
    {
      unsigned target = howMany(_parents.size());

      _offspring.clear();
      eoSelectivePopulator<EOT> it(_parents, _offspring, select);

      while (_offspring.size() < target)
            {
              op(it);
              ++it;
            }

      _offspring.resize(target);   // you might have generated a few more
    }

  virtual std::string className() const { return "eoGeneralBreeder"; }

 private:
  eoSelectOne<EOT>& select;
  eoGenOp<EOT>& op;
  eoHowMany howMany;
};

#endif