Engee 文档

模型模拟的软件控制

使用模型

运行模拟

编辑模型前,请使用open 方法打开模型。编辑后,别忘了用save 保存结果。

要运行模型的模拟,请使用公共方法run

engee.run(model_name; verbose=false)
engee.run(model; verbose=false)
engee.run(; verbose=false)
  • 运行模型模拟。返回模拟结果。

  • 如果未指定模型,则运行当前模型的模拟。

  • 如果 verbose=true ,则输出模拟进度。默认为 verbose=false

示例.
m = engee.load("/user/start/examples/power_systems/power_line_apv/power_line_apv.engee") # 从指定路径加载模型并将其分配给变量m

# 另一种选择
m = "power_line_apv"
engee> engee.run(m)
Dict{String, DataFrame} with 6 entries:
    "Va" => 40001×2 DataFrame…
    "Ia" => 40001×2 DataFrame…
    "Ib" => 40001×2 DataFrame…
    "Ic" => 40001×2 DataFrame…
    "Vc" => 40001×2 DataFrame…
    "Vb" => 40001×2 DataFrame…

暂停正在运行的模拟

使用公共方法暂停

engee.pause(model_name)
engee.pause(model)
engee.pause()
  • 暂停模型的模拟运行。返回 "无"。

错误

如果模拟没有运行,则会生成错误 Engee.Exception.SimulationError("只有正在运行的模拟可以暂停")

恢复暂停的模拟

公共方法resume 用于

engee.resume(model_name)
engee.resume(model)
engee.resume()
  • 恢复模型的暂停模拟。返回模拟结果

仿真中断

使用公共方法stop

engee.stop(model_name)
engee.stop(model)
engee.stop()
  • 停止模型的模拟运行。返回 "无"。

查看模拟结果

使用公共方法get_results 查看模拟结果。

engee.get_results(model_name)
engee.get_results(model)
engee.get_results()
  • 以 Dict 字典的形式返回指定模型的模拟结果,其中键是被跟踪端口的名称。

  • 如果没有指定模型,则返回上次模拟的结果。

  • 该方法直接与存储模型仿真结果的 simout 变量相关联。有关使用 simout 变量的更多详情,请参阅Engee中仿真结果的软件处理

示例
engee.get_results("newmodel_1")

# 结论
Dict{String, DataFrames.DataFrame} with 1 entry:
"Integrator.1" => 1001×2 DataFrame…
错误
  • 如果模型未打开,则会抛出异常`Engee.Exceptions.ModelDoesntExistException`。

查看模型模拟状态

公共方法get_status 被使用

engee.get_status(model_name)
engee.get_status(model)
engee.get_status()
  • SimulationStatus 的形式返回模拟的状态。

查看模拟事件

使用公共方法get_logs 查看模拟事件。

engee.get_logs(model_name)
engee.get_logs(model)
engee.get_logs()
  • 获取与模型相关的日志信息。

  • 返回与指定模型相关的日志信息数组。

Engee 中所有可用的程序管理公共方法都在文章计划管理的公共方法 中进行了介绍。

示例

engee.run("newmodel_1") # 运行模型的模拟。 返回模拟结果
engee.pause("newmodel_1") # 停止模型的运行模拟
engee.resume("newmodel_1") # 恢复仿真过程。
engee.stop() # 停止模型的运行模拟
engee.get_results("newmodel_1") # 以Dict字典的形式返回模拟结果
engee.get_status("newmodel_1") # 将模拟状态返回为SimulationStatus
engee.get_logs("newmodel_1") # 检索与模型相关的日志消息