IModelling.Level

Syntax

Level(Input: ITimeSeries; Method: MsLvlMethod;[ StartValue: Integer = 100]): Variant;

Parameters

Input. Variable.

Method. Transformation method.

StartValue. Initial value. Optional parameter.The default value is 100.

Description

The Level method applies the Level function to the specified variable.

Fore Example

Executing the example requires that the repository contains a modeling container with the MS identifier. A model with the MODEL_D identifier calculated by the method of determinate equation and containing at least one input variable must be available in this container.

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";

Expr.AsString := "Level(" + TermInfo.TermInnerText + ", MsLvlMethod.Diff, 200)";

If Expr.Valid

Then ModelObj.Save;

Else Debug.WriteLine(The model is not saved: error in the formula);

End If;

End Sub UserProc;

After executing the example the model transforms the first input variable using the Level function.

Example of Use in Expressions

Expression 1:

Level({Brazil|BCA},MsLvlMethod.Log)

Result: Brazil|BCA factor is transformed using the Level function.

Use: it can be used in formulas of calculated series of time series database and model formulas of modeling container that is a child of the time series database.

Expression 2:

Level(X1,MsLvlMethod.PchA)

Result: the X1 factor is transformed using the Level function.

Use: it can be used in model formulas of modeling container.