Engee 文档

命令行

命令行 img 41 1 2 - 是一款适用于各种任务的工具,从代码执行到在 Engee 中创建复杂模型。命令行支持流行的文本编辑器、Git集成和各种操作模式,以及大量程序控制命令,可集成到*Engee*的所有应用场景中。

文章内容包括

热键

Engee 命令行中提供了各种热键,以简化导航和编辑。热键列表见Engee 热键 一文。

由于元字符的特殊性、浏览器设置或与系统热键冲突,Linux 和 macOS 操作系统的某些热键可能无法正常工作。 Engee 中的命令需要初始化后才能显示,因此Tab 第二次才会起作用;之后,数据会被缓存,Tab 第一次就会起作用。输入新命令需要重新初始化并双击Tab
输入的拉丁字符串与按键Tab ,将显示从输入字符串开始的可用 Engee 命令列表。空字符串上的Tab 将显示所有可用 Engee 命令列表。

要覆盖或创建新热键,可使用 REPL.setup_interface 字典(更多详情此处)。

命令行模式

不同的 Engee 命令行模式为执行不同任务提供了专门的环境。这些模式可帮助您在任务间切换,而无需离开命令行。在 Engee 中可用的模式有

  1. 普通模式

  2. *帮助模式

  3. *外壳模式

  4. *批量管理器模式

  5. *搜索模式

  6. *文本编辑器模式

正常模式

正常模式是主要的命令行界面,它允许你交互式输入命令,执行命令并立即得到结果。*Engee*的核心是Julia语言,因此该语言的全部功能都可以在命令行中使用,包括其优势、特性语法等。

command line 1 cn

有关 Julia 语言功能的更多信息,请访问编程

帮助模式

使用问号? 可以调用帮助模式。该模式提供有关 Engee 中可用命令及其使用方法的信息。例如,要获取有关 engee.save 模型保存功能的信息,请键入功能名称并按 Enter 键:

command line 2 cn

要退出该模式,请按退格键或键盘快捷键Ctrl+C

外壳模式

使用; 可调用 Shell 模式。该模式允许执行标准的 Unix/Linux 命令。这包括浏览文件系统、管理进程、处理文件和其他任务。

例如,在 new_directory 目录Engee 文件浏览器file browser 7 中有一个模型文件 newmodel_1.engee

command line 3 cn

使用 shell 模式和 ls 命令,可以在不离开命令行的情况下查看目录内容:

command line 4 cn

shell 模式下的主要命令包括

命令^h 说明

移动或重命名文件和目录

rmdir
删除文件和目录

创建目录

ls

列出目录内容

cd

更改当前目录

显示当前目录

cp

复制文件和目录

cat

查看文件内容

要退出,请按退格键或键盘快捷键Ctrl+C

批处理管理器模式

通过]调用 Pkg 软件包管理器模式。在该模式下,您可以根据需要安装、更新和管理 Julia 软件包,以扩展功能和安装其他库。例如,添加 Pluto 库:

command line 5 cn

有关在 Engee 中使用 Julia 库的更多信息,请参见使用 Julia 软件包

搜索模式

使用组合键Ctrl+R (反向)和Ctrl+S (正向)可分别进入搜索模式:

搜索模式.h 说明

Reverse Search

允许以相反顺序搜索命令历史。输入命令的一部分或单词,命令行将从最后输入的命令开始按相反顺序搜索历史记录。再次按Ctrl+R 键将继续按相反顺序搜索历史记录。

Direct Search

可以按直接顺序搜索历史命令。输入命令的一部分或单词,命令行将从输入的第一条命令开始按直接顺序搜索历史记录。再次按Ctrl+S 键将继续按直接顺序搜索历史记录。

command line 6 cn

如果搜索失败,"failed"(失败)将被分配给模式。

切换搜索模式时无需退出主模式。

要退出模式,请按 Backspace 或 Home 键或键盘快捷键Ctrl+C

文本编辑器模式

Engee 命令行上使用 vi、vim 和 nano 文本编辑器之前,建议先熟悉它们的功能。如果遇到困难,请查阅相关编辑器的资料或其他来源。

文本编辑器模式vivimnano,分别用`vi`、`vim`和`nano`命令从 shell 模式调用,允许您不离开命令行编辑文件。

vi/vim 界面:

git vi 1 cn

nano 界面

git nano s cn

退出

  • vi, vim - 按Esc 键,确保编辑器处于命令模式(正常模式)。然后键入 :q!,并按Enter 退出,不保存更改。如果需要保存更改,则使用 `:wq`命令。

  • nano - 按组合键Ctrl+X 退出。如果所做更改需要保存,请按Y ,然后按Enter 。要退出而不保存,请按N ,然后按Enter

    • 如果保存更改,编辑器会提示输入要保存的文件名。输入文件名,然后按Enter

    • 如果不保存更改,编辑器将在不保存更改的情况下关闭。

退出文本编辑器后,命令行仍处于 shell 模式。要退出 shell 模式,请按 Backspace 键或键盘快捷键Ctrl+C

软件控制建模

对于 Engee 中模型的软件控制,公共方法。所有可用的公共方法都可以通过命令 engee. 和在命令行按Tab 调用:

example prog modeling 2 cn

您可以通过命令行帮助模式获得每个公共方法的帮助:

command line 2 cn

例如,您可以创建一个模型,添加带连接线的块,设置它们的参数,并在不离开命令行的情况下对模型进行仿真:

engee.create("newmodel_1") #создается модель newmodel_1

engee.add_block("/Basic/Sources/Sine Wave", "newmodel_1/") #добавляет блок Sine Wave

engee.add_block("/Basic/Sinks/Terminator", "newmodel_1/") # добавляет блок Terminator

engee.add_line("Sine Wave/1", "Terminator/1")  #устанавливает сигнал между выходным портом №1 у блока Sin Wave и входным портом №1 блока Terminator

engee.get_param("newmodel_1") #получение параметров моделирования

engee.set_param!("newmodel_1", "StopTime" => 15, "FixedStep" => 0.05) # меняем фиксированный размер шага и время окончания симуляции

engee.run("newmodel_1"; verbose=false) #запуск симуляции без вывода прогресса симуляции (verbose=false)

使用命令行 中的 Plots 绘制的图形将在graphs icon 1 EngeeGraphs 窗口中以单独的图形选项卡显示:

plots graph 1 cn-> plots graph cn

了解更多关于建模管理的信息,请访问软件控制建模

输入/输出功能

Engee*支持多种文件格式,可使用命令行I/O功能对其数据进行操作。例如,*Engee 文件浏览器支持 .json 文件格式:

command line read 1 cn read 函数用于读取命令行上的数据:

engee> read("test.json")

#вывод результата в виде массива байт
69-element Vector{UInt8}:
 0x7b
 0x0d
 0x0a
    ⋮
 0x0a
 0x7d

read 函数可以接受一个表示参数。在本例中为 String(字符串),因此函数的输出将转换为字符串:

engee> read("test.json", String) #считывает содержимое файла и возвращает его в виде строки

#вывод результата
"{\n    \"fruit\": \"Apple\",\n    \"size\": \"Large\",\n    \"color\": \"Red\"\n}"

Git 整合

命令行提供完整的版本控制功能,让您无需离开 Engee 工作区即可管理项目和资源库。

建议在开始使用 Git 命令行之前阅读使用 Git

xref:getting-started-git/git-remote-repository.adoc#git-nano[举例说明如何通过命令行上的 nano 编辑器指定 SSH 密钥和主机。

终端

终端*是一个带有系统外壳(bash)的独立标签页,允许你直接在*Engee*环境中执行标准的 Linux 命令。与命令行不同,终端不是为执行 Julia 语言命令而设计的,也不支持命令行模式(helppackage managershell 等)。

终端界面类似于普通的 Linux 终端,以 engee:~$ 提示符开始。通过它,你可以

  • 管理文件和目录(ls, cd, rm, `mkdir`等)、

  • 运行脚本

  • 使用 Git 系统和其他实用工具、

  • 使用文本编辑器,如 vimnano

终端无法使用 Engee 命令行模式。所有特殊功能,如 Engee 命令自动完成、帮助模式、批处理管理器等,都只能在命令行下使用。

右键单击标题 命令行 ,选择菜单项 Open Terminal 即可打开终端:

terminal cn

每个终端都会以*终端 1*、*终端 2*的名称在新标签页中打开,然后按升序打开。可以用这种方式打开任意数量的终端。按 × 按钮可分别关闭标签页,通过+ 可打开新标签页:

terminal 1 cn

命令行 始终是第一个标签页,以单个实例存在,不能关闭。

重启 Engee 环境后,终端不会保存。如有必要,必须重新打开。