What's new in BlackStar APS Solver 1.3

namespace BlackStar.Model.Interfaces
{
    //
    // Summary:
    //     Action interface for custom situations
    public interface IAction
    {
        // Summary:
        //     unchangeable settings during Action arrangements
        Dictionary<string, object> Settings { get; set; }
        //
        // Summary:
        //     changeable variables of SampleCase during Action arrangements
        Dictionary<string, object> Variables { get; set; }


        //
        // Summary:
        //     arrange the custom IAction using its own logic
        //
        // Parameters:
        //   caseLogOP:
        //     the logger of current samplecase
        //
        //   dsSampleCase:
        //     the DataSetSampleCase the IAction takes affect
        //
        //   settings:
        //     the settings of the IAction
        //
        //   variables:
        //     the variables of the IAction
        //
        //   startDt:
        //     start DateTime to arrange the IAction
        void Arrange(SampleCaseLogOP caseLogOP, DataSetSampleCase dsSampleCase, Dictionary<string, object> settings, Dictionary<string, object> variables, DateTime startDt, string actionId, Guid guid);
    }
}
复制

                                // Summary:
//     set a resource's variable to certain value
//
// Parameters:
//   resource:
//     resource code
//
//   variable:
//     variable name
//
//   startDt:
//     start time
//
//   endDt:
//     end time (later than start time)
public void SetVariable(string resource, string variable, string value, DateTime startDt, DateTime endDt);


//
// Summary:
//     get the variable state of a resource
//
// Parameters:
//   resource:
//     resource code
//
//   variable:
//     variable name
//
//   dt:
//     desired DateTime
//
// Returns:
//     Item1: the variable value Item2: the end time that it would last Item3: time
//     point with next FactDataRow
public Tuple<string, DateTime, DateTime>? GetVariable(string resource, string variable, DateTime dt);
复制

//
// Summary:
//     try to arrange a list of DecomposeConsume, requiring that a list of desired resource
//     variable fulfilled 安排一组消耗（DecomposeConsume），并且同时满足一组资源变量符合要求
//
// Parameters:
//   dsSampleCase:
//     target dsSampleCase 目标的算例数据集
//
//   deConsumes:
//     list of required consume 消耗的集合
//
//   desireVariables:
//     list of desired variable 变量的集合
//
//   dtBase:
//     start DateTime for searching 搜索的开始时间
//
//   postponeOption:
//     search direction on time line: forward or backward时间顺移的方向：前向或后向
//
//   maxPostpone:
//     max postpone time duration最大顺移时间范围
//
//   allowSwitch:
//     all switch resource允许更换资源
//
//   desireResource:
//     a list of desired variable state 一组目标变量的描述：item1: resource code 资源代号 item2: variable
//     name 变量名 item3: desired variable value 所需的变量值 item4: desired time duration for
//     the variable remains desired value 所需变量的持续时间
//
//   desireTarget:
//     desired target code, "" if not specified 指定的目标，如果不指定请用""
//
// Returns:
//     true if success, false if not 成功返回true，未成功返回false
public static bool TryConsumes(DataSetSampleCase dsSampleCase, List<DecomposeConsume> deConsumes, List<Tuple<string, string, string, TimeSpan>> desireVariables, ref DateTime dtBase, PostponeOption postponeOption, TimeSpan maxPostpone, bool allowSwitch, string desireResource, string desireTarget);
复制