source: xssim/trunk/src/schedframe/scheduling/plugin/estimation/ExecTimeEstimationPlugin.java @ 104

package schedframe.scheduling.plugin.estimation;

import gssim.schedframe.scheduling.ExecTaskInterface;

import java.util.Map;

import schedframe.resources.units.ResourceUnit;
import schedframe.scheduling.events.SchedulingEvent;
import schedframe.scheduling.plugin.Plugin;
import schedframe.scheduling.utils.ResourceParameterName;

/**
 * This interface is responsible for estimation of task execution time. It
 * provides all necessary information to compute execution time. In general, the
 * major method allow to develop different approaches and strategies of
 * execution time computation. Ratings of processors, available memory, length
 * of task (number of CPU instructions) and task requirements are used to
 * specify duration of the task. The interface method returns an estimated
 * execution time of the task, which is then applied to simulation.
 * 
 * @author Marcin Krystek
 * 
 */
public interface ExecTimeEstimationPlugin extends Plugin {

        /**
         * 
         * @param allocatedResources resource units allocated for task execution
         * @param task which will be executed
         * @param remainingLength 
         * @return estimated execution time of a task of specified length
         */
        public double execTimeEstimation(SchedulingEvent event, Map<ResourceParameterName, ResourceUnit> allocatedResources, 
                                                                        ExecTaskInterface task, 
                                                                        double completionPercentage);
        

}