跳转到内容

OpenVOGEL/用户指南/指南 3 第 1 部分

来自维基教科书,开放世界中的开放书籍

OpenVOGEL 控制台

[编辑 | 编辑源代码]

OpenVOGEL 提供了一个控制台应用程序,因为它可以比基于 GUI 的程序提供更多额外的功能。

  • 它可以轻松地在不同的操作系统中运行。
  • 它可用于自动分析和自定义后处理。
  • 它不在 GUI 线程下运行(它是一个独立的进程)。
  • 它可以由不同的进程驱动。
  • 它对于纯粹的数据挖掘速度更快。

此外,OpenVOGEL 控制台将允许您绑定英特尔数学内核库,该库在求解大型线性方程组时效率很高。

运行控制台

[编辑 | 编辑源代码]

在 Windows 中运行控制台非常容易,只需打开一个终端并调用其可执行文件,或双击它。您也可以将控制台与 *.ave 文件扩展名关联起来,然后只需双击 OpenVOGEL 脚本文件即可启动它们(推荐方法)。这可以在 Windows 中使用 打开方式... 工具轻松配置。

控制台可以以两种模式运行

  • 命令行模式:您输入一个命令关键字,它就会被执行。最终您需要根据需要提供更多信息,例如文件路径。控制台始终以这种模式启动。
  • 服务器模式:当您输入 server 模式时,控制台停止读取通过键盘输入的命令,并开始监听端口 11000 上的 UDP 消息。这些消息是告诉控制台该做什么的非常短的命令。此模式的目的是建立与 Tucan 的通信。

您可能想知道计算服务器有什么好处。好吧,基本上,最大的好处是您可以将它连接到 Tucan,而无需重新编译 Tucan!因此,您可以在同一模型上测试计算核心不同的版本,甚至不需要在 Tucan 中关闭模型。您在 Tucan 中唯一需要做的事情是在按下启动按钮之前告诉它您希望计算在活动服务器上运行。

安全警告:由于控制台打开了一个 UDP 套接字,请注意不要运行来自可疑发布者的版本(这适用于任何程序)。有人可能会生成一个恶意版本,在您“计算”时攻击您的计算机。通常,Windows Defender 或其他防火墙应该会意识到这一点并关闭外部世界对套接字的访问,但如果您想百分百确定,请从 Github 网站(应该非常安全)下载官方版本或编译您自己的本地版本。永远不要从提供“第三方服务”的可疑网站安装软件,除非您百分之百信任它们。

命令和语法

[编辑 | 编辑源代码]

OpenVOGEL 控制台命令是一个关键字后跟一系列参数。给定命令的所有参数都写在同一行并用分号(“;”字符)分隔。选择此分隔符只是为了允许输入包含空格的文件路径。

关键字概述

[编辑 | 编辑源代码]

以下列表提供了所有可用的命令。命令的表示法如下

keyword;<argument 1 {remark}>;<argument 2 {remark}>[;<optional argument 1 {remark}>[;<optional argument 2 {remark}>;...]]

通用实用程序命令

help
pause
readback
server
test
quit

文件 I/O

load;<native OpenVOGEL file path>
load_script;<file path>
print_report
save_report;<file path>

MKL 设置

mkl_path;<MKL directory path>
mkl_status
mkl_test
mkl_on
mkl_off

控制曲面偏转

set_delta;<lifting surface name>;<region index>;<deflection angle {degrees}>

流特性

set_alfa;<incidence angle {degrees}]>
set_altitude;<standard atmosphere altitude {m}>
set_density;<air density {kg/m³}]>
set_omega;<Omega X {rad/s}>[;<Omega Y {rad/s}>[;<Omega Z {rad/s}>]]
set_velocity;<Velocity X {m/s}>[;<Velocity Y {m/s}>[;<Velocity Z {m/s}>]]
set_viscosity;<air viscosity {kg/(m.s)}]>

模拟

alfa_delta_scan;<alfa 1 {deg}>;<alfa 2 {deg}>;<alfa step {deg}>;<surface name>;<region index>;<delta 1 {deg}>;<delta 2 {deg}>;<delta step {deg}>
alfa_scan;<alfa 1 {deg}>;<alfa 2 {deg}>;<alfa step {deg}>
delta_scan;<surface name>;<region index>;<delta 1 {deg}>;<delta 2 {deg}>;<delta step {deg}>
omega_scan;<omega max {rad/s}>;<omega steps>;<min mass {kg}>;<max mass {kg}>;<mass steps>
steady
aeroelastic
free_flight

服务器模式

steady;<VOG file path>
aeroelastic;<VOG file path>
free_flight;<VOG file path>

OpenVOGEL 控制台允许您通过输入文件一次加载一系列命令。为此,请使用 load_script 命令,并将 脚本 文件的路径作为参数传递。此功能主要用于避免必须重新输入所有命令和参数,因为在看到第一次模拟的结果后,通常需要调整参数。

在运行脚本时,控制台不会询问必要的​​数据,因此必须将这些数据作为参数传递。例如,如果您调用 load 命令,它通常会询问文件路径。但是,在脚本中,您将把它作为参数加载

load;<the file path>

激活英特尔 MKL

[编辑 | 编辑源代码]

自 2020 年以来,我们终于能够链接英特尔数学内核库 (MKL) 以获得更高的计算性能。此库目前可从 OpenVOGEL 服务器访问(显然 MKL 不喜欢驻留在 Tucan 的线程中)。您需要做的第一件事是从英特尔提供的软件包中安装英特尔 MKL。完成后,您需要搜索包含 mkl_rt.dll 文件的文件夹,该文件是一个动态库,其中包含所有 LAPACK 和 BLAS 过程的集合(事实上,我们只需要其中几个,但为了避免创建特定 dll 的繁琐工作,我们必须这样做)。然后打开控制台并键入

mkl_path;<the path to mkl_rt.dll>
mkl_test
<test report>

控制台将尝试使用该库执行一些简单的操作,如果成功,您将看到 TEST PASSED。从那时起,每次打开控制台时,MKL 将默认使用。要再次关闭它,您需要传递 mkl_off 命令。要再次打开它(不出所料),您输入 mkl_on。如果您忘记了状态,请输入 mkl_status

华夏公益教科书