/*
  Copyright 2006 by Sean Luke
  Licensed under the Academic Free License version 3.0
  See the file "LICENSE" for more information
*/


package ec;

/* 
 * Initializer.java
 * 
 * Created: Tue Aug 10 21:07:42 1999
 * By: Sean Luke
 */

/**
 * The Initializer is a singleton object whose job is to initialize the
 * population at the beginning of the run.  It does this by providing
 * a population through the initialPopulation(...) method.

 
Parameters

 

 
pop

 classname, inherits or = ec.Population
 
(the class for a new population)
 

 
Parameter bases

 

 
pop
 
The base for a new population's set up parameters
 

 * @author Sean Luke
 * @version 1.0 
 */

public abstract class Initializer implements Singleton
    {
    /** parameter for a new population */
    public static final String P_POP = "pop";

    /** Creates and returns a new initial population for the evolutionary run.
        This is commonly done by setting up a Population (by calling setupPopulation below)
        then calling its populate() method.  This method
        will likely only be called once in a run. */
    public abstract Population initialPopulation(final EvolutionState state, int thread);
        
    /** Loads a Population from the parameter file, sets it up, and returns it. */
    public abstract Population setupPopulation(final EvolutionState state, int thread); 
    }