IModelling.DiffX

Синтаксис

DiffX(Input: ITimeSeries; [Lag: Integer = 1]): Variant;

DiffX(Input: Prognoz.Platform.Interop.Ms.TimeSeries; Lag: integer; Context: Prognoz.Platform.Interop.Fore.ForeRuntimeContext): object;

Параметры

Input. Переменная;

Lag. Параметр задает сдвиг (лаг) точек переменной во временном периоде;

Context. Контекст. Параметр используется только в Fore.NET.

Описание

Метод DiffX осуществляет расчёт прироста точек переменной к указанному периоду.

Комментарии

Параметр Lag может принимать только положительные значения; необязательный параметр, значение по умолчанию: «1» - предыдущий период.

Расчёт прироста точек переменной осуществляется по следующей формуле: X[t]-X[t-Lag].

Пример

Для выполнения примера в репозитории предполагается наличие контейнера моделирования с идентификатором MS. В данном контейнере содержится модель с идентификатором MODEL_D, рассчитываемая методом детерминированного уравнения и содержащая хотя бы одну входную переменную.

Добавьте ссылки на системные сборки:

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;
    Expr := Determ.Expression;
    Expr.References := "Ms";
    Expr.AsString := "DiffX(" + TermInfo.TermInnerText + ", 3)";
    If Expr.Valid
    Then ModelObj.Save;
    Else Debug.WriteLine("Модель не сохранена: ошибка в формуле");
    End If;
End Sub UserProc;

Imports Prognoz.Platform.Interop.ForeSystem;
Imports Prognoz.Platform.Interop.Metabase;
Imports Prognoz.Platform.Interop.Ms;
…
Public Shared Sub Main(Params: StartParams);
Var
    Mb: IMetabase;
    ModelSpace, ModelObj: IMetabaseObject;
    Transf: IMsFormulaTransform;
    Formula: IMsFormula;
    Model: IMsModel;
    Determ: IMsDeterministicTransform;
    TransVar: IMsFormulaTransformVariable;
    Slice: IMsFormulaTransformSlice;
    TermInfo: IMsFormulaTermInfo;
    Expr: IExpression;
Begin
    Mb := Params.Metabase;
    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;
    Expr := Determ.Expression;
    Expr.References := "Ms";
    Expr.AsString := "DiffX(" + TermInfo.TermInnerText + ", 3)";
    If Expr.Valid
    Then ModelObj.Save();
    Else System.Diagnostics.Debug.WriteLine("Модель не сохранена: ошибка в формуле");
    End If;
End Sub Main;

В результате выполнения примера модель будет рассчитывать прирост точек первой входной переменной к периоду, сдвинутому от текущего на три точки назад.

Пример использования в выражениях

Выражение 1:

DiffX({Brazil|BCA}, 2)

Результат: рассчитан прирост наблюдений временного ряда «Brazil|BCA» к периоду, сдвинутому от текущего на две точки назад.

Применение: можно использовать в формулах вычисляемых рядов базы данных временных рядов и в формулах моделей контейнера моделирования, являющегося дочерним по отношению к базе данных временных рядов.

Выражение 2:

DiffX(X1, 3)

Результат: рассчитан прирост значения точек фактора «X1» к предыдущему периоду, сдвинутому от текущего на три точки назад.

Применение: можно использовать в формулах моделей контейнера моделирования.

См. также:

IModelling