Logo
Distributed Genetic Programming Framework
print print

File org.dgpf.gp.vm.base.InstructionSet.java

Here you can find all the information about the file org.dgpf.gp.vm.base.InstructionSet.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-03 06:06:51
 * Original Filename: org.dgpf.gp.vm.base.InstructionSet.java
 * Version          : 1.0.0
 * Last modification: 2006-07-03
 *                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.vm.base;

import org.dgpf.gp.vm.mutation.MutationInfo;
import org.dgpf.search.api.utils.WeightedSet;
import org.dgpf.search.api.utils.WeightedSetBuilder;
import org.sfc.math.stochastic.Randomizer;

/**
 * This class represents the instructions available for a virtual
 * machine.
 *
 * @author Thomas Weise
 */

public class InstructionSet extends     WeightedSet<IInstructionHandler>  
                            implements  IInstructionHandler
  {
/**
 * The serial version uid.
 */

  private static final long serialVersionUID = 1;
  
/**
 * Create a new instruction set. Instruction sets are fixed and cannot be
 * modified.
 * @param p_wsb The weighted set builder to use. 
 */

  public  InstructionSet(final WeightedSetBuilder<IInstructionHandler> p_wsb)
    {
    super(p_wsb);
    }
  

/**
 * Create a new randomized instance of this instruction.
 * @param p_context The vm context to be used.
 * @param p_info    The information record holding the infos on the
 *                  instruction to be created.
 * @return  The new instruction instance.
 */

  public  final Instruction create      (final VMContext    p_context,
                                         final MutationInfo p_info)
    {
    Randomizer  l_r;
    Instruction l_c;
    
    l_r = p_context.get_randomizer();
    
    for(;;)
      {
      l_c = this.get(l_r).create(p_context, p_info);
      if(l_c != null) return l_c;      
      }
    }
  
/**
 * Replace a memory access address by another one.
 * @param p_instruction The instruction to replace the address.
 * @param p_old         The old address.
 * @param p_new         The new address.
 * @return  The new instruction where the address relacement has been
 *          performed, or the old one if no replacement was needed.  
 */

  public final  Instruction swap_address(final Instruction p_instruction,
                                         final int         p_old,
                                         final int         p_new)
    {
    return p_instruction.get_handler().swap_address(p_instruction,
                                                    p_old, p_new);
    }
  
/**
 * 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  final Instruction mutate  (final Instruction    p_source,
                                     final VMContext      p_context,
                                     final MutationInfo   p_info)
    {
    return p_source.get_handler().mutate(p_source, p_context, p_info);
    }
  

  
/**
 * Returns always <code>true</code>.
 * @return Returns always <code>true</code>.
 */

  public final  boolean is_useful_at_end()
    {
    return true;
    }
  
/**
 * Returns always <code>true</code>.
 * @return Returns always <code>true</code>.
 */

  public final  boolean is_useful_at_begin()
    {    
    return true;
    }
  
/**
 * Get an instruction that better represents the passed in instruction.
 * @param p_i   The instruction to replace.
 * @return  An instruction that better represents <code>p_i</code>, or
 *          <code>p_i</code> if it is already perfect, or <code>null</code>
 *          if <code>p_i</code> itself is totally useless.
 */

  public final  Instruction get_replacement (final Instruction p_i)
    {
    return p_i.get_handler().get_replacement(p_i);
    }
  

  
/**
 * Try to melt two instructions together. The second instruction is of
 * the type this instruction handler handles.
 * @param p_first   The first instruction.
 * @param p_second  The second instruction.
 * @return  An instruction able to replace the sequence of these both
 *          instructions, or <code>null</code> if no valid replacement
 *          coult be found.
 */
  
  public  Instruction try_melt  (final Instruction p_first,
                                 final Instruction p_second)
    {
    return p_second.get_handler().try_melt(p_first, p_second);
    }
  }

File Information:

file name:InstructionSet.java
package:org.dgpf.gp.vm.base
qualified name:org.dgpf.gp.vm.base.InstructionSet.java
file type:Java Source File
download location:download http://dgpf.sourceforge.net/source/org/dgpf/gp/vm/base/InstructionSet.java
size:5.355 KB (5484 B)
uploaded: 2015-07-22 04:10:56 GMT+0000
last update: 2006-07-10 08:08:02 GMT+0000
last access: 2017-11-23 05:30:11 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-23 05:30:11 GMT+0000.
Valid CSS Valid XHTML 1.1
Valid RSS SourceForge.net Logo