IModelling.MovAvg

Синтаксис Fore

MovAvg(Input: ITimeSeries;
       Period: IMsPeriod;
       [WindowSize: Integer = 5;]

       [Casewise: MsCasewise = 0]): Variant;

Синтаксис Fore.NET

MovAvg(Input: Prognoz.Platform.Interop.Ms.ITimeSeries;
       Period: Prognoz.Platform.Interop.Ms.IMsPeriod;
       WindowSize: integer;

       Casewise: Prognoz.Platform.Interop.Ms.MsCasewise;
       Context: Prognoz.Platform.Interop.Fore.ForeRuntimeContext): object;

Параметры

Input. Моделируемая переменная;

Period. Период, на котором рассчитывается метод. Если значение параметра Null, то метод рассчитывается на всём временном периоде;

WindowSize. Размер окна;

Casewise. Метод обработки пропусков;

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

Описание

Метод MovAvg осуществляет преобразование переменной методом скользящего среднего.

Комментарии

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

Пример Fore

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

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

Sub ProcAvg;
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 := "MovAvg(" + TermInfo.TermInnerText + ", SetPeriod(" +
        
"""" + "01.01.2000" + """" + "," + """" + "01.01.2015" + """" + "),  3, MsCasewise.Yes)";
    
If Expr.Valid
        
Then ModelObj.Save;
        
Else Debug.WriteLine("Модель не сохранена: ошибка в формуле");
    
End If;
End Sub ProcAvg;

После выполнения примера модель будет осуществлять преобразование первой входной переменной методом скользящего среднего на периоде с 2000 по 2015 год. Расчёт выполняется с применением обработки пропусков методом Casewise.

Пример Fore.NET

Необходимые требования и результат выполнения примера Fore.NET совпадают с примером Fore.

Imports Prognoz.Platform.Interop.Ms;
Imports Prognoz.Platform.Interop.ForeSystem;

    [STAThread]
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;
    TermInfo.Type := MsFormulaTermType.mfttPointwise;
    Expr := Determ.Expression;
    Expr.References := "Ms";
    Expr.AsString := "MovAvg(" + TermInfo.TermInnerText + ", SetPeriod(" +
        """" + "01.01.2000" + """" + "," + """" + "01.01.2015" + """" + "),  3, MsCasewise.Yes)";
    If Expr.Valid
        Then ModelObj.Save();
        Else System.Diagnostics.Debug.WriteLine("Модель не сохранена: ошибка в формуле");
    End If;
End Sub;

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

Выражение 1:

MovAvg({Brazil|BCA}, SetPeriod("01.01.2000", "01.01.2015"), 3, MsCasewise.Yes)

Результат: для показателя Brazil|BCA будет применен метод скользящего среднего с окном равным трем на периоде с 2000 по 2015 год. Расчёт выполняется с применением обработки пропусков методом Casewise.

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

Выражение 2:

MovAvg(X1, SetPeriod("01.01.1990", "01.01.2016"))

Результат: для фактора X1 будет применен метод скользящего среднего на периоде с 1990 по 2016 год.

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

См. также:

IModelling | Метод скользящего среднего | База данных временных рядов: калькулятор, Скользящее среднее | Контейнер моделирования: модель «Скользящее среднее», редактирование регрессора/формулы