oracle.dmt.odm.model
Class ModelTimingRecord
java.lang.Object
|
+--oracle.dmt.odm.MiningObject
|
+--oracle.dmt.odm.model.ModelTimingRecord
- All Implemented Interfaces:
- java.io.Serializable
- public class ModelTimingRecord
- extends MiningObject
An instance of ModelTimingRecord provides build statistics resulting from user-specified limits placed on maximum build
time using function settings. This enables a user to enable to estimate the time required to complete a more thorough build,
to possibly obtain a more accurate model. Each ModelTimingRecord contains information pertinent to a specific build
milestone. The first milestone is the building of a Naive Bayes Model subset to all target-correlated predictor columns.
Relevant statistics at this juncture include: segment build time only, i.e., the time to get reach this milestone. Subsequent, milestones
attempt to extend an individual feature and to test whether the feature should be included in the model. The relevant statistics of these
milestones include:
- the feature identifier of the feature being extended
- the depth
- the segment build time (time spent in searching for the best candidate predictor column to extend the current feature)
- the feature scoring time (feature testing time)
- whether the feature has been accepted, i.e., will be included in the model
- whether the feature extension process has terminated, i.e., there are no acceptable extension candidates
- if a feature has been completely constructed, then the algorithm bases its estimate of the time to construct another feature on this historical record. Otherwise, based upon the number of columns, number of rows and target distribution, the current feature depth and the time to achieve it, the algorithm estimates the time to build a complete feature.
The estimated featureScoringTime can be used to re-build the model, trading off a desired number of constructed features with build
time. For example, to have a build that attempts to construct 5 extended features, the MaximumBuildTime could be set to 5 *
estimated featureScoringTime. Note that the other build time control parameter MaximumConsecutivePrunedNetworkFeatures is still in
effect. The first termination criteria to be met causes the build to terminate. Also, note that the estimated featureScoringTime is only an
estimate, build time is data-dependent. The build terminates, in accordance with the MaximumBuildTime, when the estimated time to the
next build milestone exceeds the MaximumBuildTime.
- Since:
- 9.2.0
- See Also:
- Serialized Form
Type | Method |
int |
getDepth()
Returns the depth of this NetworkFeature. |
int |
getEstimatedFeatureScoringTime()
Returns an estimate of the time required to score the NetworkFeature if the NetworkFeature was not scored, otherwise it returns the actual scoring time. |
int |
getFeatureNumber()
Returns the NetworkFeature number. |
int |
getFeatureScoringTime()
Returns the NetworkFeature scoring time. |
int |
getSegmentBuildTime()
Returns the segment build time. |
boolean |
isAccepted()
Returns a boolean indicating whether the NetworkFeature was accepted or rejected by the MDL pruning criteria. |
boolean |
isTerminated()
Returns a boolean indicating whether the NetworkFeature met termination criteria or whether the NetworkFeature extension process was prematurely halted. |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
getFeatureNumber
public int getFeatureNumber()
- Returns the NetworkFeature number.
- Returns:
- int - the NetworkFeature number.
getDepth
public int getDepth()
- Returns the depth of this NetworkFeature.
- Returns:
- int - the NetworkFeature depth.
getSegmentBuildTime
public int getSegmentBuildTime()
- Returns the segment build time.
- Returns:
- int - the segment build time.
getFeatureScoringTime
public int getFeatureScoringTime()
- Returns the NetworkFeature scoring time.
- Returns:
- int - the NetworkFeature scoring time.
getEstimatedFeatureScoringTime
public int getEstimatedFeatureScoringTime()
- Returns an estimate of the time required to score the NetworkFeature if the NetworkFeature was not scored, otherwise it returns the actual scoring time.
- Returns:
- int - the estimated NetworkFeature scoring time.
isTerminated
public boolean isTerminated()
- Returns a boolean indicating whether the NetworkFeature met termination criteria or whether the NetworkFeature extension process was prematurely halted.
- Returns:
- boolean - true if the NetworkFeature is terminated, false otherwise.
isAccepted
public boolean isAccepted()
- Returns a boolean indicating whether the NetworkFeature was accepted or rejected by the MDL pruning criteria.
- Returns:
- boolean - true if the NetworkFeature is accepted, false otherwise.