跳转至内容

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

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

OpenVOGEL 控制台

[编辑 | 编辑源代码]

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

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

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

运行控制台

[编辑 | 编辑源代码]

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

控制台可以运行两种模式

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

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

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

命令和语法

[编辑 | 编辑源代码]

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>

激活 Intel MKL

[编辑 | 编辑源代码]

从 2020 年开始,我们终于能够链接 Intel 数学内核库 (MKL) 以提高计算性能。此库目前可以从 OpenVOGEL 服务器访问(显然 MKL 不喜欢驻留在 Tucan 的线程中)。您需要做的第一件事是从 Intel 提供的软件包中安装 Intel 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

华夏公益教科书