Coverage Report

Coverage Report - org.dishevelled.evolve.Selection

Classes in this File

 /*
 
     dsh-evolve  Framework for evolutionary algorithms.
     Copyright (c) 2005-2013 held jointly by the individual authors.
 
     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 3 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; with out 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.
 
     > http://www.fsf.org/licensing/licenses/lgpl.html
     > http://www.opensource.org/licenses/lgpl-license.php
 
 */
 package org.dishevelled.evolve;
 
 import java.util.Collection;
 
 import org.dishevelled.weighted.WeightedMap;
 
 /**
  * A selection function.
  *
  * @param <I> individual type
  * @author  Michael Heuer
  */
 public interface Selection<I>
 {
 
     /**
      * Select individuals from the specified population of individuals based on
      * the specified fitness scores.
      *
      * @param population population of individuals
      * @param scores fitness scores
      * @return a collection of individuals selected from the specified population
      *    of individuals
      * @throws IllegalStateException if the total weight of the scores is zero
      */
     Collection<I> select(Collection<I> population, WeightedMap<I> scores);
 }

1		/*
2
3		dsh-evolve Framework for evolutionary algorithms.
4		Copyright (c) 2005-2013 held jointly by the individual authors.
5
6		This library is free software; you can redistribute it and/or modify it
7		under the terms of the GNU Lesser General Public License as published
8		by the Free Software Foundation; either version 3 of the License, or (at
9		your option) any later version.
10
11		This library is distributed in the hope that it will be useful, but WITHOUT
12		ANY WARRANTY; with out even the implied warranty of MERCHANTABILITY or
13		FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
14		License for more details.
15
16		You should have received a copy of the GNU Lesser General Public License
17		along with this library; if not, write to the Free Software Foundation,
18		Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
19
20		> http://www.fsf.org/licensing/licenses/lgpl.html
21		> http://www.opensource.org/licenses/lgpl-license.php
22
23		*/
24		package org.dishevelled.evolve;
25
26		import java.util.Collection;
27
28		import org.dishevelled.weighted.WeightedMap;
29
30		/**
31		* A selection function.
32		*
33		* @param <I> individual type
34		* @author Michael Heuer
35		*/
36		public interface Selection<I>
37		{
38
39		/**
40		* Select individuals from the specified population of individuals based on
41		* the specified fitness scores.
42		*
43		* @param population population of individuals
44		* @param scores fitness scores
45		* @return a collection of individuals selected from the specified population
46		* of individuals
47		* @throws IllegalStateException if the total weight of the scores is zero
48		*/
49		Collection<I> select(Collection<I> population, WeightedMap<I> scores);
50		}