OpenSees

OpenSees是Sublime Text的一个简单插件，它为OpenSees扩展语言（.tcl）添加了语法高亮、代码完成、构建命令等功能，兼容Tcl语法（使用默认的Tcl包）。

跳转到部分

• 功能
• 需求
• 安装
• 更新
• 使用
• 支持
• 许可

功能

• 支持OpenSees语法，同时支持Tcl语法（使用默认Tcl包）
• 自动完成部分Tcl命令（使用默认Tcl包片段）
• 自动完成许多OpenSees命令
• 在Sublime Text中运行OpenSees脚本（.tcl），使用顺序解释器而无需离开Sublime Text
• 在Sublime Text中运行OpenSees脚本（.tcl），使用并行解释器而无需离开Sublime Text

需求

如果是首次下载OpenSees，您需要注册到论坛。

Windows

• Tcl [必需]
  1. 从OpenSees下载网站下载Tcl，以确保与OpenSees兼容（可能需要卸载先前版本）
  2. 安装Tcl（需要将安装路径从C:/Tcl更改为C:/Program Files/Tcl）
  3. 如果安装Tcl时Sublime Text正在运行，则需要重启Sublime Text以使插件正常工作
• OpenSees [必需]
  1. 从OpenSees下载网站下载OpenSees
  2. 在方便的目录中找到OpenSees.exe（如果使用不同的位置，将默认的%userprofile%/OpenSees/、opensees_dir或opensees设置更改）
• MPICH2 [可选，仅当使用OpenSeesParallel时]
  1. 从OpenSees并行下载网站下载MPICH2，以便具有与OpenSeesParallel兼容的版本（可能需要卸载旧版本）
  2. 安装MPICH2
     • 如果您收到错误消息，您可能需要首先安装.NET Framework 3.5（截至2015年3月11日，需要2.0，但3.5也兼容，因为它包括2.0）
     • 您必须具有管理员权限才能安装它
     • 请确保安装目录为%programfiles%/MPICH2/，如果位置不同，则需要更改mpiexec设置更改配置
     • 有关更多信息，请参阅此教程
• OpenSeesParallel (OpenSeesSP, OpenSeesMP) [可选]
  1. 从OpenSees并行下载网站下载OpenSeesParallel
  2. 将OpenSeesSP.exe和OpenSeesMP.exe放在方便的目录中（如果使用与默认目录%userprofile%/OpenSees/、opensees_dir或opensees_sp/opensees_mp不同的位置，应更改配置）

Mac OS X

• Tcl [必需]
  1. Tcl可能已经安装，检查当前版本以确认其与OpenSees兼容（在Terminal中打开，输入tclsh然后输入puts $tcl_version）
  2. 从OpenSees下载网站下载Tcl，以确保与OpenSees兼容（可能需要卸载先前版本）
  3. 安装Tcl
  4. 如果安装Tcl时Sublime Text正在运行，则需要重启Sublime Text以使插件正常工作
• OpenSees [必需]
  1. 从OpenSees下载网站下载OpenSees
  2. 将OpenSees可执行文件放在方便的目录中（如果使用与默认目录~/OpenSees/、opensees_dir或opensees不同的位置，应更改配置）
• OpenMPI [可选，仅当使用OpenSeesParallel时]
  1. 除非从源代码编译OpenSeesParallel的二进制文件，否则不需要它，下面提供更多信息
  2. 如果从源代码编译，从OpenMPI下载并安装
• OpenSeesParallel (OpenSeesSP, OpenSeesMP) [可选]
  1. 截至2015年3月11日，由于内置OpenMPI的移除，OpenSees并行下载网站不提供OS X的二进制文件，因此用户将需要从源代码编译二进制文件以使用OpenSeesSP和OpenSeesMP
  2. 编译完成后，将OpenSeesSP和OpenSeesMP执行文件放在方便的目录中（如果使用与默认目录~/OpenSees/、opensees_dir或opensees_sp/opensees_mp不同的位置，应更改配置）
  3. OpenSeesParallel尚未在OS X中测试，如果您发现任何问题，请使用问题门户

Linux

Linux平台尚未测试，如果您发现任何问题，请使用问题门户。

OpenSees下载网站和OpenSees并行下载网站不提供Linux的二进制文件，因此需要从源代码编译二进制文件以使用OpenSees、OpenSeesSP和OpenSeesMP。

如果从源代码编译，所有解释器都需要Tcl，而OpenSeesSP和OpenSeesMP需要OpenMPI。编译后，将OpenSees、OpenSeesSP和OpenSeesMP执行文件放在方便的目录中（如果使用与默认目录~/OpenSees/、opensees_dir或opensees/opensees_sp/opensees_mp不同的位置，则应更改配置）

仅需要Tcl和OpenSees即可运行脚本，OpenSeesParallel是可选的。

安装

使用Package Control（推荐）

所有Sublime Text用户建议通过Package Control安装。

1. 如果您尚未安装，请安装Package Control。
2. 使用ctrl+shift+P（Win, Linux）或cmd+shift+P（OS X），然后选择Package Control: Install Package
3. 查找OpenSees并安装它。

手动安装

1. 点击首选项 > 浏览包...菜单
2. 浏览到相应的文件夹，然后进入Installed Packages/文件夹
3. 下载zip包，将其重命名为OpenSees.sublime-package并将其复制到Installed Packages/目录
4. 重新启动Sublime Text

更新

• 如果您正在使用Package Control，更新将自动进行，您无需担心。
• 如果您使用手动安装，请重复上述步骤，并用新下载的OpenSees.sublime-package替换旧的。

使用

首先，请确保针对您的操作系统完成了安装步骤。

运行脚本

• 打开.tcl脚本后，按ctrl+b（Win, Linux）或cmd+b（OS X）以运行先前运行的解释器（默认为顺序模式）
• 要更改解释器，打开.tcl脚本后，按ctrl+shift+b（Win, Linux）或cmd+shift+b（OS X），将出现一个弹出窗口，显示所有选项
• 这些选项也可通过菜单栏：工具 > 构建工具和工具 > 使用...构建工具进行访问

配置

以下优先级解析配置文件

1. 项目设置（.sublime-project，需要使用项目 > 保存项目为...和项目 > 打开项目创建/打开）
2. 用户设置（见下文）
3. 默认设置（见下文）

用户和默认设置可以使用Sublime Text菜单：偏好设置 > 插件设置 > OpenSees找到

• 设置 - 用户是您更改OpenSees设置的地方（请确保更改此文件以使配置在插件更新后持续存在）。
• 设置 - 默认是每个设置的良好参考，其中包含了详细描述（不要修改此文件，使用用户设置进行覆盖）。

关于此插件设置的一些重要功能

• 任何包含${<var>}的字符串都将展开为操作系统的环境变量（如果存在）
• ${<var>}还可以引用在任何一个设置文件中定义的任何设置，使用.分隔符访问嵌套设置（例如，${test.setting}）
• 设置可以是平台特定的。而不是指定一个字符串路径来使用，一个字典被指定。这个字典可以包含以下键：windows、linux和osx

支持

• 任何错误或特性请求应在此处报告这里。
• 欢迎使用fork和提交pull请求。

许可

所有源代码都可在github上以MIT许可证找到项目。

Copyright (c) 2016 Borja Zarco <[email protected]>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.