IModelling.Census1

Синтаксис

Census1(Input: ITimeSeries;
    Period: IMsPeriod;
    OutputSeries: MsOutputCensus1SeriesType;
    SeasonalEffect: SeasonalityType;
    [SeasonalPeriod: Integer = 12];
    [Casewise: MsCasewise = 0]): Variant;

Census1(Input: Prognoz.Platform.Interop.Ms.ITimeSeries;
    Period: Prognoz.Platform.Interop.Ms.IMsPeriod;
    OutputSeries: Prognoz.Platform.Interop.Ms.MsOutputCensus1SeriesType;
    SeasonalEffect: Prognoz.Platform.Interop.Stat.SeasonalityType;
    SeasonalPeriod: Integer;
    Casewise: Prognoz.Platform.Interop.Ms.MsCasewise
    Context: Prognoz.Platform.Interop.Fore.ForeRuntimeContext): Object;

Параметры

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

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

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

SeasonalEffect. Модель сезонности;

SeasonalPeriod. Продолжительность сезонного периода;

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

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

Описание

Метод Census1 выделяет сезонную составляющую в соответствии с заданными параметрами.

Пример

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

Добавьте ссылки на системные сборки: Metabase, Ms, Stat. Для примера Fore.NET также подключите системную сборку ForeSystem.

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 := "Census1(" + TermInfo.TermInnerText + ", SetPeriod(" +
        
"""" + "01.01.2000" + """" + "," + """" + "01.01.2015" + """" +
        
"), MsOutputCensus1SeriesType.MovingAverage, SeasonalityType.Additive)";
    
// Проверяем корректность выражения
    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;
Imports Prognoz.Platform.Interop.Stat;

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 := "Census1(" + TermInfo.TermInnerText + ", SetPeriod(" +
        
"""" + "01.01.2000" + """" + "," + """" + "01.01.2015" + """" +
        
"), MsOutputCensus1SeriesType.MovingAverage, SeasonalityType.Additive)";
    
// Проверяем корректность выражения
    If Expr.Valid Then
        
// Если выражение задано корректно, то сохраняем модель
        ModelObj.Save();
    
Else
        
// Если выражение некорректное, то выводим сообщение в окно консоли
        System.Diagnostics.Debug.WriteLine("Модель не сохранена: ошибка в формуле");
    
End If;
End Sub;

После выполнения примера модель будет рассчитывать значения на основе первой входной переменной методом Census1 на периоде с 2000 по 2015 год. В моделируемую переменную будет выгружаться сглаженный ряд входной переменной.

См. также:

IModelling | Метод «Centus1»