IModelling.X11

X11(Input: ITimeSeries;
    Period: IMsPeriod
    OutputSeries: MsOutputSeriesType;
    SeasonalEffect: SeasonalityType;
    [TradingDaysAdjustment: MsTradingDaysAdjustment = 0;]
    [LowerSigma: Double = 1.5;]
    [UpperSigma: Double = 2.5;]
    [MovingAverage: String = "";]
    [WeightCoefficients: String = "";]
    [HolidayAdjustment: MsHolidayAdjustment = 0;]
    [SSAnalysis: Boolean = False]): Variant;

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

X11(Input: Prognoz.Platform.Interop.Ms.ITimeSeries;
    Period: Prognoz.Platform.Interop.Ms.IMsPeriod;
    OutputSeries: Prognoz.Platform.Interop.Ms.MsOutputSeriesType;
    SeasonalEffect: Prognoz.Platform.Interop.Stat.SeasonalityType;
    TradingDaysAdjustment: Prognoz.Platform.Interop.Ms.MsTradingDaysAdjustment;
    LowerSigma: double;
    UpperSigma: double;
    MovingAverage: string;
    WeightCoefficients: string;
    HolidayAdjustment: Prognoz.Platform.Interop.Ms.MsHolidayAdjustment;
    SSAnalysis: boolean;
    Context: Prognoz.Platform.Interop.Fore.ForeRuntimeContext): object;

Параметры

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

OutputSeries. Тип ряда, выгружаемого в моделируемую переменную;

SSAnalysis. Признак использования в расчете скользящих интервалов;

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

Описание

X11 осуществляет сезонную декомпозицию и корректировку данных.

Комментарии

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

TradingDaysAdjustment. Необязательный параметр, по умолчанию поправки на рабочие дни не вычисляются.

LowerSigma. Необязательный параметр, значение по умолчанию: «1,5».

UpperSigma. Необязательный параметр, значение по умолчанию: «2,5».

MovingAverage, WeightCoefficients. Необязательные параметры, значение по умолчанию не задано.

HolidayAdjustment. Необязательный параметр. По умолчанию поправка на праздничные дни не производится.

SSAnalysis. Необязательный параметр, значение по умолчанию: False (скользящие интервалы не применяются в расчете).

Пример Fore

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

Добавьте ссылки на системные сборки: 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_Q", 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;Stat";
    Expr.AsString := "X11(" + TermInfo.TermInnerText + ",SetPeriod(" +
        """" + "01.01.2000" + """" + "," + """" + "01.01.2015" + """" +
        "),MsOutputSeriesType.D10, SeasonalityType.Additive, " +
        "MsTradingDaysAdjustment.No, 1.8, 2.1, """", """", MsHolidayAdjustment.None, False)";
    If Expr.Valid Then
        ModelObj.Save;
    Else
        Debug.WriteLine("Модель не сохранена: ошибка в формуле");
    End If;
End Sub UserProc;

После выполнения примера модель будет осуществлять сезонную декомпозицию и корректировку данных методом «X11» без поправки на рабочие и праздничные дни и без использования скользящих интервалов на периоде с 2000 по 2015 год.

Пример Fore.NET

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

Imports Prognoz.Platform.Interop.ForeSystem;
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;
    TermInfo.Type := MsFormulaTermType.mfttPointwise;
    Expr := Determ.Expression;
    Expr.References := "Ms;Stat";
    Expr.AsString := "X11(" + TermInfo.TermInnerText + ",SetPeriod(" +
        """" + "01.01.2000" + """" + "," + """" + "01.01.2015" + """" +
        "),MsOutputSeriesType.D10, SeasonalityType.Additive, " +
        "MsTradingDaysAdjustment.No, 1.8, 2.1, """", """", MsHolidayAdjustment.None, False)";
    If Expr.Valid Then
        ModelObj.Save();
    Else
        System.Diagnostics.Debug.WriteLine("Модель не сохранена: ошибка в формуле");
    End If;
End Sub;

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

x11({Brazil|BCA[t]}, SetPeriod("2000", "2015"), MsOutputSeriesType.D10, SeasonalityType.Additive, MsTradingDaysAdjustment.Auto)

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

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

x11(X1, Null, MsOutputSeriesType.D10, SeasonalityType.Additive, MsTradingDaysAdjustment.No, 1.8, 2.1

Результат: для фактора X1 будет выполнена сезонная декомпозиция и корректировка данных на всём периоде без поправки на рабочие и праздничные дни и без использования скользящих интервалов.

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