oracle.dmt.odm.task
Class RegressionTestTask

java.lang.Object
  |
  +--oracle.dmt.odm.MiningObject
        |
        +--oracle.dmt.odm.LocatableObject
              |
              +--oracle.dmt.odm.task.MiningTask
                    |
                    +--oracle.dmt.odm.task.MiningDataTask
                          |
                          +--oracle.dmt.odm.task.RegressionTestTask

All Implemented Interfaces:

java.io.Serializable

public class RegressionTestTask

extends MiningDataTask

An instance of RegressionTestTask is used for testing an Regression (regression) model on test data. Test involves computing the root mean suquare error.

RegressionTestTask's input data must have all the active attributes used in model building and target attribute of the associated supervised model. DataUsageSpecifications of the model build input data and test input data must be same. If the task input data is not compatible with the specified input model, the test task will fail with an exception.

After constructing a valid RegressionTestTask instance, it must be persisted in the data mining server using the store(dmsConn, taskName) instance method before executing. The task name must be unique in the user mining object name space.

After successful completion of the test task, the user can retrieve the results using a RegressionTestResult object. To remove the mining test task object in a data mining server, invoke the static method remove.

Since:

ODM 10.1.0

See Also:

Serialized Form

Constructor Summary

RegressionTestTask(PhysicalDataSpecification taskInputData, java.lang.String inputModelName, java.lang.String testResultName)
Creates an instance of test task from the given test data, the model to which the test data is applied, and the location of the test output.

Method Summary

java.lang.String	getTestResultName() Returns test result name used for this task.
static RegressionTestTask	restore(Connection dmsConn, java.lang.String taskName) Restores the named test task object from the DMS.

Methods inherited from class oracle.dmt.odm.task.MiningDataTask

getInputModelName, getTaskInputData

Methods inherited from class oracle.dmt.odm.task.MiningTask

execute, getActiveExecutionHandle, getCurrentStatus, getExecutionDuration, getExecutionHandle, getLatestExecutionHandle, getName, getStatusHistory, getTaskType, getType, listTasks, remove, rename, store, terminate, waitForCompletion, waitForCompletion

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RegressionTestTask

public RegressionTestTask(PhysicalDataSpecification taskInputData,
                          java.lang.String inputModelName,
                          java.lang.String testResultName)
                   throws InvalidArgumentException,
ODMException

Creates an instance of test task from the given test data, the model to which the test data is applied, and the location of the test output.

Parameters:

taskInputData - Physical data specification of the test input data

inputModelName - Name of the input mining model to be tested

testResultName - Name of the test results

Throws:

InvalidArgumentException - is thrown
- when any of the parameters are null
- when the taskInputData does not have location access details
- when the inputModelName or testResultName length >64

InvalidArgumentException

ODMException

Method Detail

getTestResultName

public java.lang.String getTestResultName()

Returns test result name used for this task.

Returns:

test result name.

restore

public static RegressionTestTask restore(Connection dmsConn,
                                         java.lang.String taskName)
                                                      throws InvalidArgumentException,
MiningTaskException,
                                                             java.sql.SQLException,
ODMException

Restores the named test task object from the DMS.

Parameters:

dmsConn - Data mining server connection.

taskName - Name of the test task.

Returns:

restored Regression test task object

Throws:

InvalidArgumentException - is thrown
- when the dmsConn/taskName are null
- when the taskName length >64 characters

MiningTaskException - is thrown
- when the restore fails

SQLException - is thrown
- when there is a failure in JDBC calls

InvalidArgumentException

MiningTaskException

java.sql.SQLException

ODMException