CumulativeYTD(Input: ITimeSeries;
[Method: MsCumulativeMethodType = 5;]
[Period: IMsPeriod = Null;]
[IgnoreMissing: Boolean = False;]): Variant;
Input. Моделируемая переменная;
Method. Метод накопления;
Period. Период, на котором рассчитывается метод;
IgnoreMissing. Признак того, что пустые значения будут игнорироваться.
Метод CumulativeYTD осуществляет преобразование переменной с применением указанного метода накопления к началу года.
Особенности задания параметров:
Period. Если параметр принимает значение Null, то метод рассчитывается на всём временном периоде;
IgnoreMissing. Возможные значения параметра:
True. Расчет ведется без учета пустых значений;
False. Расчет ведется с учетом пустых значений.
Для выполнения примера в репозитории предполагается наличие контейнера моделирования с идентификатором MS. В данном контейнере содержится модель с идентификатором MODEL_D, рассчитываемая методом детерминированного уравнения и содержащая хотя бы один фактор.
Добавьте ссылки на системные сборки: Metabase, Ms.
Sub UserProc;
Var
Mb: IMetabase;
ModelSpace, ModelObj: IMetabaseObject;
Transf: IMsFormulaTransform;
Formula: IMsFormula;
Model: IMsModel;
Determ: IMsDeterministicTransform;
TransVar: IMsFormulaTransformVariable;
Slice: IMsFormulaTransformSlice;
TermInfo: IMsFormulaTermInfo;
Expr: IExpression;
Begin
// Получаем репозиторий
Mb := MetabaseClass.Active;
// Получаем контейнер моделирования
ModelSpace := Mb.ItemById("MS").Bind;
// Получаем модель
ModelObj := Mb.ItemByIdNamespace("MODEL_D", ModelSpace.Key).Edit;
Model := ModelObj As IMsModel;
// Получаем параметры расчета модели
Transf := Model.Transform;
Formula := Transf.FormulaItem(0);
Determ := Formula.Method As IMsDeterministicTransform;
// Получаем первую входную переменную
TransVar := Transf.Inputs.Item(0);
Slice := TransVar.Slices.Item(0);
TermInfo := Transf.CreateTermInfo;
TermInfo.Slice := Slice;
// Задаем режим передачи переменной в расчет
TermInfo.Type := MsFormulaTermType.Pointwise;
// Получаем выражение расчета модели
Expr := Determ.Expression;
Expr.References := "Ms";
// Задаем выражение расчета модели
Expr.AsString := "CumulativeYTD(" + TermInfo.TermInnerText + ", MsCumulativeMethodType.Max, SetPeriod(" +
"""" + "01.01.2000" + """" + "," + """" + "01.01.2015" + """" +
"), True)";
// Проверяем корректность выражения
If Expr.Valid
// Если выражение задано корректно, то сохраняем модель
Then ModelObj.Save;
// Если выражение некорректное, то выводим сообщение в окно консоли
Else Debug.WriteLine("Модель не сохранена: ошибка в формуле");
End If;
End Sub UserProc;
В результате выполнения примера модель будет осуществлять преобразование переменной с применением метода накопления «Максимум» к началу года без учёта пропущенных значений на периоде с 2000 по 2015 год.
Выражение 1:
CumulativeYTD({Brazil|BCA[t]},MsCumulativeMethodType.Average, SetPeriod("01.01.2000", "01.01.2015"))
Результат: для показателя «Brazil|BCA» будет рассчитано накопленное среднее к началу года на периоде с 2000 по 2015 год.
Применение: можно использовать в формулах универсального редактора выражения в любом инструменте платформы, где он доступен.
Выражение 2:
CumulativeYTD(X1,MsCumulativeMethodType.Sum)
Результат: для фактора «X1» будет рассчитана накопленная сумма к началу года на всем временном периоде.
Применение: можно использовать в формулах моделей контейнера моделирования, основанных на переменных.
См. также:
IModelling | База данных временных рядов: Калькулятор, Методы накопления | Контейнер моделирования: Спецификация модели «Методы накопления», Редактирование регрессоара/формулы