跳转到主要内容

一个可扩展的Python框架,用于模拟和与机器人交互

项目描述

pypi docs license

Soar

Soar(机器蛇)是一个用于模拟和与机器人交互的Python框架。

该软件旨在以下方面

  • 无痛苦:使用Soar实现预期目的应该是 微不足道 的。使用Soar作为入门级机器人课程的一部分的学生,在理想情况下,只需要查看 入门 并无需其他操作。

  • 可扩展:只要用户提供合适的接口,Soar就可以支持几乎所有类型的机器人和任何类型的连接。可以通过串行端口、WiFi、蓝牙等方式连接到机器人。Soar不依赖于接口。尽管Soar提供了2D碰撞检测和移动的基本物理特性,但模拟世界和对象的物理特性可以被完全覆盖。

  • 模拟驱动:Soar最典型的用法将是在特定类型的机器人上运行一些逐步模拟,并使用某些 大脑 控制它。它主要不是为了设计持续在线的机器人或在不适合逐步交互的情况下使用。

  • 多平台:Soar不使用特定平台的特性,并且使用Python的标准GUI包Tkinter为其GUI。因此,Soar应在任何具有3.5或更高版本标准Python解释器的平台上运行。Soar已在Fedora 25 GNU/Linux和Windows 8上进行测试。如果在您的平台上运行Soar出现问题时,请打开GitHub上的问题

  • 开源:Soar遵循LGPLv3许可协议,并可以被具有其他许可证的项目用作库。

要开始使用Soar,请参阅入门指南文档

安装

安装Soar应该是(希望是)无痛苦的,主要通过以下三种方式完成,按难易程度递减排序

从PyPI

您可以通过运行pip install soarPython包索引(PyPI)安装Soar。

这将安装最新的稳定版本(非开发版本)。

从版本发布

可以从github发布版安装任意稳定(非开发)的Soar版本,通过下载.zip存档并运行pip install <path-to-zip>

从最新源码

克隆或下载git仓库,导航到目录,然后运行

python3 setup.py sdist
cd dist
pip install Soar-<version>.tar.gz

开发

只有Soar的稳定版本会被发布到PyPIgithub发布版。开发版本将仅存在于GitHub仓库中,并且会带有.dev<N>后缀。

典型的版本号将如下所示:<MAJOR>.<MINOR>.<PATCH>。主版本号破坏了向后兼容性,次版本号添加了功能但保持了向后兼容性,而补丁版本号解决错误或修复小问题。

如果您希望在Soar中看到特定的功能,或者希望将特定的机器人类型捆绑到基本软件中,或者只是想要做出贡献,请考虑提出一个pull request。

构建文档

构建本地文档副本需要Sphinx

导航到docs/目录,并运行sphinx-build -b html source/ <BUILD_DIR>

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分布

Soar-1.5.2.tar.gz (61.3 kB 查看哈希值)

上传时间

由以下支持