EBSILON®Professional Online Documentation
EbsScript 脚本 / 接口单元 / 系统
本主题中
    系统
    本主题中

    接口单元 - 系统

    也可以在 EbsScript 编辑器中打开接口单元本身（EbsScript-->打开接口单元-->系统）以获得更多信息

    名称

    目的

    参数

    返回值

    例子

    debugBreak

    在脚本中设置一个"断点"。这使得中断脚本的执行成为可能。

    -

    -

     

    diagramAsRasterGraphic

    将具有指定 ID 的图表作为光栅图形导出到具有指定路径和扩展名的外部文件中（指定光栅图形格式：BMP、PNG、JPG 等）。

    		 1: INTEGER: 图表配置 ID

    2: STRING: 栅格图形文件名，包括路径

    3: INTEGER: 最大的时间延迟。以秒为单位，允许等待直到执行完成。必须是 >= 1。如果为零或为负数，则忽略该值，不应用时间限制。

    		 BOOLEAN:

    如果执行成功则为 true

    		 var

    ID, maxTimeInSeconds : integer;
    path : string;
    bOK : boolean;

    begin

    ID:=0;

    path:="Picture.png";

    maxTimeInSeconds:=0;//no time restriction

    bOK:=diagramAsRasterGraphic(ID,path,maxTimeInSeconds);

    end;

     

    diagramDataAsText

    将具有指定 ID 的图表数据作为纯文本导出到具有指定路径的外部文件中

    		 1: INTEGER: 图表配置 ID

    2: STRING: 栅格图形文件名，包括路径

    3: INTEGER: 最大的时间延迟。以秒为单位，允许等待直到执行完成。必须是 >= 1。如果为零或为负数，则忽略该值，不应用时间限制。

     

    		 BOOLEAN:

    如果执行成功则为 true

    var

    ID, maxTimeInSeconds : integer;
    path : string;
    bOK : boolean;

    begin

    ID:=0;

    path:="Data.csv";

    maxTimeInSeconds:=0;//no time restriction

    bOK:=diagramDataAsText(ID,path,maxTimeInSeconds);

    end;

     

    ebsHTML

    创建一个显示模型（或分配给当前上下文的宏）的 HTML 文件

    1: STRING: HTML 文件名称包括路径

    可选参数，初始化为默认值：

    2:BOOLEAN: 如果为true，将递归导出宏

    3: INTEGER 数组  *:

    包含要导出的工况 ID 的数组

    4: PictureTypeEnum: 指定图形文件格式（默认 = PictureTypePNG）

    5:BOOLEAN: 如果为 true，则为每个工况导出单独的图像（默认 = true）

    6:BOOLEAN: 如果为 true，所有的值都包括在内（默认 = false）

    7:BOOLEAN:如果为 true，将显示表达式（默认 = false）                               

    BOOLEAN:
    true: 正常
    false: 错误

     ebsHTML ("C:\\Temp\\Test.htm");

    ebsilonComputationModes

    返回 EBSILON 计算核的当前计算模式（模拟、验证校核、优化、时间序列），例如，在 KernelScripting 中被调用。

    无参数

     

                     

     

    EbsilonComputationModeEnum
    （见接口单元系统）

     

    var iret:integer;

    begin

                iret := ebsilonComputationModes;

                println("iret: ",iret);

                case iret of                        EbsilonComputationModeNone :

                            begin

                                        println("EbsilonComputationModeNone");

                            end;                        EbsilonComputationModeSimulation :

                            begin

                                        println("EbsilonComputationModeSimulation");

                            end;                        EbsilonComputationModeValidation:

                            begin

                                        println("EbsilonComputationModeValidation");

                            end;                        EbsilonComputationModeTimeSeries:

                            begin

                                        println("EbsilonComputationModeTimeSeries");

                            end;                        EbsilonComputationModeOptimization:

                            begin

                                        println("EbsilonComputationModeOptimization");

                            end

                            otherwise

                            begin

                                       println("unknown ebsilonComputationMode");

                            end

                end;                

    end;

     

    ebsScriptMode

    返回当前 EbsScript 的执行模式

    		 无参数

     

     

    EbsScriptModeEnum （见接口单元系统）

     

    ebsXML

    将模型的数据写入一个 XML 文件中

    1: STRING: XML 文件名，包括路径

    可选参数，以默认值初始化：                

    2:BOOLEAN: 如果为true，将递归导出宏

    3: INTEGER 数组  *:

    包含要导出的工况 ID 的数组

    4:BOOLEAN: 如果为 true，所有的值都包括在内（默认 = false）

    5:BOOLEAN:如果为 true，将显示表达式（默认 = false）           

    BOOLEAN:
    true: 正常
    false: 错误

     ebsXML("D:\\temp\\model.xml");

    enableActiveFilter

    开启或关闭激活的过滤器。激活的过滤器是通过 setActiveFilter 函数来设置的

    1: Boolean, 如果为 true - 激活过滤器必须被打开，如果为 false - 关闭

     

                     

     

    Boolean: 如果成功打开/关闭激活的过滤器，则为 true，否则为 false

     

    eval

    这个函数允许对一个以字符串形式给出的 EbsScript 表达式进行评估

    1: STRING: 要被评估的表达式

    variant: 评估的结果

    或，如果 v.vt=varerror:

    v.error =

    errorGeneral  或

    errorEvaluatingExpression

    var

        str:string;

        v:variant;

    begin

        inputBox("What shall be calculated?",

                      str);

        v:=eval(str);

        str:=printToString ("The result is: ",
                                     v.rVal);

        messagebox (str);

    end.

    evaluateKernelExpression

    确定内核表达式在 KernelScriptings 中的值

    		 1: CONST EBSVAR: 值

    2: REAL: var 结果

    BOOLEAN:
    true: 正常
    false: 错误

     

    evaluateKernelExpressionWithEnvironment

    在内核脚本中也确定内核表达式的数字值：

    在第三个参数 - ARRAY* NAMEDVALUE 中 - 临时结果（对于当前迭代步骤）被存储，反过来，这些结果被用作内核表达式的规格。例如，这允许开发一个组件 93（内核-脚本），其中内核表达式被存储为规格值。在组件 93（内核-脚本）的脚本中，这些内核表达式被评估。反过来，内核表达式可能需要一些临时结果（例如，换热器的当前平均对数温度差）。这些临时结果作为参数 3 被传递到函数

    		 1: CONST EBSVAR: 值

    2: REAL: var 结果

    3: ARRAY* NAMEDVALUE:
        const environment
        (由 STRING (name)
     和 REAL (value)组成的对)

    BOOLEAN:
    true: 正常
    false: 错误

     
    getActiveFilterName 返回激活的过滤器的名称 无参数 String: 返回激活的过滤器的名称

    getActiveObjectDisplay

    返回时提供指定对象的显示风格（外观细节）

    1: const ebsobject - 搜索其显示风格的对象
    2: objectdisplay (见接口单元系统) - 返回时存储显示其细节的结构

    Boolean: true, 如果执行成功，否则为 false

     

    getActiveViewDisplay

    返回所有对象，包括其显示风格

    无参数

    VIEWDISPLAY: （结构中包含所有对象及其显示风格的数组（表示细节），见接口单元系统） 

     

    getEbsObjValueAlternatives

    该函数返回数组，其中包括组合框条目的数字值

     

     

     

    		 1: EBSVAR: 要分析的变量 VALUEWITHTEXT 数组

    var alternatives:array of VALUEWITHTEXT;
        evar: ebsvar;
        i:integer;
    begin
        getebsvar(evar,"Turbine.FCHR");
        alternatives:=getEbsObjValueAlternatives( evar );
        for i:=0 to length(alternatives)-1 do begin
            print(alternatives[i].value,": ");
            print(alternatives[i].text,"\n");
        end;
    end.
                   

    printModelEx

     

                                        

    1: PRINTCONTROL 数组:

    2: STRING: 打印机名称

    3: STRING: 输出文件名

    BOOLEAN:
    true = 打印成功
    false = 打印不成功

     

    printModelEx2

    		 可进一步设置打印：过滤、隐藏对象

    1: PRINTCONTROL2 数组:

    2: STRING: 打印机名称

    3: STRING: 输出文件名

    BOOLEAN:
    true = 打印成功
    false = 打印不成功

    setActiveFilter

    设置激活过滤器

    		 1: STRING: 过滤器的名称（区分大小写）。 

    BOOLEAN:
    true = 执行成功
    false = 执行不成功

     

     

    		                

     

     

     

     

     

    版权声明 Iqony Solutions GmbH 2024 创建于 16.01.2024

    Impressum Disclaimer