Logo
Distributed Genetic Programming Framework
print print

File org.dgpf.gp.regression.base.IExpressionHandler.java

Here you can find all the information about the file org.dgpf.gp.regression.base.IExpressionHandler.java. You may explore it here or download it onto your local disk.
/*
 * Copyright (c) 2006 Thomas Weise
 * 
 * E-Mail           : tweise@gmx.de
 * Creation Date    : 2006-07-25 10:41:13
 * Original Filename: org.dgpf.gp.regression.IExpressionHandler.java
 * Version          : 1.0.0
 * Last modification: 2006-07-25 
 *                by: Thomas Weise
 * 
 * License          : GNU LESSER GENERAL PUBLIC LICENSE
 *                    Version 2.1, February 1999
 *                    You should have received a copy of this license along
 *                    with this library; if not, write to the Free Software
 *                    Foundation, Inc., 59 Temple Place, Suite 330, Boston,
 *                    MA 02111-1307, USA or download the license under
 *                    http://www.gnu.org/copyleft/lesser.html.
 *                    
 * Warranty         : This software is provided "as is" 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.
 */

 
package org.dgpf.gp.regression.base;

import org.dgpf.gp.regression.search.MutationInfo;
import org.dgpf.search.api.utils.IMutator;

/**
 * This is the class that handles expression creation and mutation.
 *
 * @author Thomas Weise
 */

public interface  IExpressionHandler
       extends    IMutator<Expression, AggregationContext, MutationInfo>  
  {
/**
 * Create a new randomized instance of the expression handled by this
 * handler.
 * @param p_context The regression context to be used.
 * @param p_info    The information record holding the infos on the
 *                  expression to be created.
 * @return  The new expression instance.
 */

  public  abstract  Expression  create  (final AggregationContext p_context,
                                         final MutationInfo      p_info);
  
/**
 * Replace a sub-expression by the expression passed in.
 * @param p_source  The source expression.
 * @param p_context The regression context to be used.
 * @param p_old     The old expression that should be replaced, or
 *                  <code>null</code> if a randomly chosen one will be
 *                  replaced.
 * @param p_repl    A replacement expression for a randomly chose
 *                  sub-expression of the source expression.
 * @return  <code>p_source</code> with one of its sub-expressions replaced
 *          by <code>p_repl</code>, or <code>p_repl</code> if no
 *          sub-expression can be replaced.
 */

  public  abstract  Expression  replace_sub_expression
                                        (final AggregationContext p_context,
                                         final Expression        p_source,
                                         final Expression        p_old,
                                         final Expression        p_repl)  ;
  
/**
 * Obtain a randomly chosen sub-expression.
 * @param p_context The regression context to be used.
 * @param p_source  The source expression.
 * @return  A randomly chosen sub-expression of <code>p_source</code> or
 *          <code>p_source</code> itself.
 */

  public  abstract  Expression  get_sub_expression 
                                        (final AggregationContext p_context,
                                         final Expression        p_source);

/**
 * Check whether the expressions created by this handler are terminal
 * expressions or not.
 * @return  <code>true</code> if and only if the expressions created by
 *          this handler are terminal.
 */

  public  abstract  boolean     is_terminal ();
  

/**
 * Perform the mutation.
 * @param p_source  The source object to create a randomizedly altered
 *                  copy of.
 * @param p_context The context hosting the operation.
 * @param p_info    The information record.
 * @return  The new, randomizedly altered copy of the object
 *          <code>p_source</code> or <code>p_source</code> itself if no
 *          mutation was possible.
 */

  public        Expression mutate  (final Expression        p_source,
                                    final AggregationContext p_context,
                                    final MutationInfo      p_info);
  
/**
 * Optimize an expression.
 * @param p_source  The source expression to be optimized.
 * @return  The optimized version of the source expression, or the source
 *          expression itsef.
 */

  public        Expression  optimize  (final Expression p_source);
  
/**
 * Replace a variable in all sub expressions.
 * @param p_source  The source expression to replace the variable in.
 * @param p_old_var The old variable to be replaced.
 * @param p_new_var The new replacement.
 * @return  The expression <code>p_source</code>, where all occurences of
 *          <code>p_old_var</code> have been replaced by
 *          <code>p_new_var</code>.
 */

  public        Expression  replace_var(final Expression p_source,
                                        final int        p_old_var,
                                        final int        p_new_var);
  }

File Information:

file name:IExpressionHandler.java
package:org.dgpf.gp.regression.base
qualified name:org.dgpf.gp.regression.base.IExpressionHandler.java
file type:Java Source File
download location:download http://dgpf.sourceforge.net/source/org/dgpf/gp/regression/base/IExpressionHandler.java
size:5.118 KB (5241 B)
uploaded: 2015-07-22 04:10:56 GMT+0000
last update: 2006-08-10 11:00:54 GMT+0000
last access: 2017-11-18 23:16:23 GMT+0000

statistics online since 2006-01-02.   RSS Feed
Contact us by sending an email to tweise@gmx.de to receive further information, to report errors, or to join our project.
All content on this site (http://dgpf.sourceforge.net/) is LGPL-licensed.
http://dgpf.sourceforge.net/scripts/source/source.php last modified at 2015-07-22 04:10:53 GMT+0000 served at 2017-11-18 23:16:23 GMT+0000.
Valid CSS Valid XHTML 1.1
Valid RSS SourceForge.net Logo