iterativeminingalgorithm.java

一个数据挖掘软件ALPHAMINERR的整个过程的JAVA版源代码

/*
 *    This program is free software; you can redistribute it and/or modify
 *    it under the terms of the GNU General Public License as published by
 *    the Free Software Foundation; either version 2 of the License, or
 *    (at your option) any later version.
 *
 *    This program 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 General Public License for more details.
 *
 *    You should have received a copy of the GNU General Public License
 *    along with this program; if not, write to the Free Software
 *    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

 /**
  * Title: XELOPES Data Mining Library
  * Description: The XELOPES library is an open platform-independent and data-source-independent library for Embedded Data Mining.
  * Copyright: Copyright (c) 2002 Prudential Systems Software GmbH
  * Company: ZSoft (www.zsoft.ru), Prudsys (www.prudsys.com)
  * @author Michael Thess
  * @version 1.1
  */

package com.prudsys.pdm.Core;

/**
  * Interface for a mining algorithm that builds the model
  * iteratively. <p>
  *
  * For doing this, the mining algorithm must be switched in
  * the iterative mode using the method setIterativeMode.
  * Then every time the buildModel method of the mining algorithm
  * is called, it runs just one iteration and creates the next
  * model. The restIterations method resets iteration process.
  * The isIterationImprovement method tells whether it is useful
  * to continue the iteration process. When the iterative mode
  * is switched off, the buildModel method again runs the whole
  * mining algorithm until the end. <p>
  *
  * From PDM CWM extension.
  *
  * @see MiningAlgorithm
  */
public interface IterativeMiningAlgorithm
{
    /**
     * Is iterative mode sitched on?
     *
     * @return true if iterative mode is switched on, otherwise false
     */
    public boolean isIterativeMode();

    /**
     * Set iterative mode.
     *
     * @param iterativeMode new iterative mode
     */
    public void setIterativeMode( boolean iterativeMode );

    /**
     * Resets iteration process before first iteration step.
     *
     * @exception MiningException cannot reset iteration process
     */
    public void resetIterations() throws MiningException;

    /**
     * Will further iterations improve the results? If false,
     * you can finish the iteration process.
     *
     * @return true if improvement expected, otherwise false
     */
    public boolean isIterationImprovement();
}