IModelling.Fill

Синтаксис Fore

Fill(Input: ITimeSeries;

Method: MsFillMethod;

[NumberOfPoints: Integer = 1;]

[SpecifiedValue: Double = 0;]

[AdditionalSeries: ITimeSeries = Null;]

[FillBound: MsFillBoundType = 2]): Variant;

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

Fill(Input: Prognoz.Platform.Interop.Ms.ITimeSeries;

Method: Prognoz.Platform.Interop.Ms.MsFillMethod;

NumberOfPoints: integer;

SpecifiedValue: double;

AdditionalSeries: Prognoz.Platform.Interop.Ms.ITimeSeries);

FillBound: Prognoz.Platform.Interop.Ms.MsFillBoundType;

Context: Prognoz.Platform.Interop.Fore.ForeRuntimeContext): object;

Параметры

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

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

NumberOfPoints. Дополнительный параметр для метода обработки пропусков, определяющий число точек или периодов (в зависимости от используемого метода). В Fore: необязательный параметр, значение по умолчанию - «1»;

SpecifiedValue. Значение для заполнения пропусков. Параметр используется для метода «Указанное значение». В Fore: необязательный параметр, значение по умолчанию - «0»;

AdditionalSeries. Переменная, значения которой будут использоваться для обработки пропусков. Параметр предназначен для методов «По шаблону» и «Значениями заданного ряда». В Fore: необязательный параметр, по умолчанию переменная не задана;

FillBound. Период заполнения пропусков. В Fore: необязательный параметр, по умолчанию пропуски заполняются до конца периода прогнозирования;

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

Описание

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

NPointsAverage. Среднее по N соседним точкам. InterpolateParam определяет N - количество соседних точек;
PreviousGrowthRate. SucceedingGrowthRate. Темп роста к предыдущему/следующему периоду. InterpolateParam определяет число периодов.

Пример Fore

Для выполнения примера предполагается наличие в репозитории контейнера моделирования с идентификатором «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;Stat";
    Expr.AsString := "Fill(" + TermInfo.TermInnerText +
        ", MsFillMethod.NPointAverage, 4, 0, Null, MsFillBoundType.EndIdentify)";
    If Expr.Valid
        Then ModelObj.Save;
        Else Debug.WriteLine("Модель не сохранена: ошибка в формуле");
    End If;
End Sub UserProc;

После выполнения примера модель будет осуществлять преобразование первой входной переменной с использованием метода обработки пропусков «Среднее по четырем соседним точкам».

Пример Fore.NET

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

Imports Prognoz.Platform.Interop.ForeSystem;
Imports Prognoz.Platform.Interop.Ms;
…
[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;Stat";
    Expr.AsString := "Fill(" + TermInfo.TermInnerText +
        ", MsFillMethod.NPointAverage, 4, 0, Null, MsFillBoundType.EndIdentify)";
    If Expr.Valid
        Then ModelObj.Save();
        Else System.Diagnostics.Debug.WriteLine("Модель не сохранена: ошибка в формуле");
    End If;
End Sub;

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

Выражение 1:

Fill({Brazil|BCA}, MsFillMethod.Pattern, 0, 0, {China|BCA}, MsFillBoundType.EndIdentify)

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

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

Выражение 2:

Fill(X1,MsFillMethod.Value)

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

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

См. также:

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