| Name | soar-sml JSON |
| Version |
9.6.2
JSON |
| download |
| home_page | None |
| Summary | Raw SML Bindings to the Soar Cognitive Architecture |
| upload_time | 2024-05-09 20:44:21 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | BSD |
| keywords |
soar
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Soar
[](https://github.com/SoarGroup/Soar/actions/workflows/build.yml)
This is the code base for Soar, a cognitive architecture for developing systems that exhibit intelligent behavior. For more information about this project, please visit:
* [The Soar home page](http://soar.eecs.umich.edu/)
* [The GitHub project page](https://github.com/SoarGroup/Soar)
Note that the readme included with the Soar distribution for end-users is in the [Release-Support](https://github.com/SoarGroup/Release-Support/blob/master/txt/README) repository.
# Soar Builds
For binary builds of Soar you can get them in two places:
* [Official Releases](http://soar.eecs.umich.edu/articles/downloads/soar-suite)
* [Latest Successful Development Build](https://github.com/SoarGroup/Soar/actions/workflows/build.yml?query=branch%3Adevelopment): click the latest run and scroll down to "Artifacts".
- If the download for your platform isn't there, the build failed. You'll need to download the result of an earlier build.
- GitHub cannot build for ARM64 (M-series Macs), so you'll need to build from source or use the release version instead.
# Soar Performance
Some performance statistics are calculated automatically using the Factorization Stress Tests. You can see performance on a commit-by-commit basis either in [Performance.md](https://github.com/SoarGroup/Soar/blob/development/Performance.md) or [here](http://soar-jenkins.eecs.umich.edu/Performance/). The raw data used to generate the graphs for each build can be found [here](http://soar-jenkins.eecs.umich.edu/Performance/).
Disclaimer: These are worst case tests. Average performance is probably much higher. In addition, these show that even in worst case, Soar beats its goal of 50 msec reactivity (in these tests, the max is ~30msec per decision).
# Development
## Prerequisites
The instructions below are cursory and may be out of date; the most up-to-date instructions for compiling Soar from source will always be the CI build scripts. You can find them [here](.github/workflows/build.yml).
To compile Soar, you will need the dependencies listed below. Note that the installation commands are not complete, e.g. missing instructions for Mac do not mean that the dependency is not needed on Mac, etc.:
* C/C++ compiler
- Mac: `xcode-select --install`
- Linux: `sudo apt-get install build-essential`
* Python
- Mac: `brew install python`
* Java
- We recommend using [SDKMan](https://sdkman.io/). The debugger, etc. require Java 11 at a minimum, but it's best to install the latest LTS. Temurin is recommended.
To compile the extra SML wrapper libs, you will need the following:
* pkg-config
- Mac: `brew install pkg-config`
- Linux: `sudo apt install pkgconf`
* SWIG
- Mac: `brew install swig`
- Linux: `sudo apt install swig`
* Python development headers (only needed for Python wrapper)
- Linux: `sudo apt install python3-dev`
* C# compiler (`csc`) (only needed for C# wrapper)
- Mac: `brew install mono`
* Tcl (only needed for Tcl wrapper and TclSoarlib)
- Mac: `brew install tcl-tk`
The project supports generating compile_commands.json, which can be used by e.g. VSCode with the C/C++ plugin to provide IntelliSense. To generate this file, run scons with the `cdb` target:
python3 scons/scons.py --scu --opt --verbose cdb
Note for M-series Mac users: you'll want to make sure you're compiling for ARM64, not x86_64. Sometimes users have Python installed in compatibility mode, leading to compiles for the wrong architecture. You can check which architecture your Python is built for using this:
```python
import sysconfig
>>> print(sysconfig.get_config_vars())
```
You can also check your `clang`'s default compile target using `clang --version`.
# License
Soar is available under the following [LICENSE](https://github.com/SoarGroup/Soar/blob/development/LICENSE.md). This license is [BSD](http://opensource.org/licenses/BSD-2-Clause)
Raw data
{
"_id": null,
"home_page": null,
"name": "soar-sml",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "soar",
"author": null,
"author_email": null,
"download_url": null,
"platform": null,
"description": "\n# Soar\n\n[](https://github.com/SoarGroup/Soar/actions/workflows/build.yml)\n\nThis is the code base for Soar, a cognitive architecture for developing systems that exhibit intelligent behavior. For more information about this project, please visit:\n\n* [The Soar home page](http://soar.eecs.umich.edu/)\n* [The GitHub project page](https://github.com/SoarGroup/Soar)\n\nNote that the readme included with the Soar distribution for end-users is in the [Release-Support](https://github.com/SoarGroup/Release-Support/blob/master/txt/README) repository.\n\n# Soar Builds\n\nFor binary builds of Soar you can get them in two places:\n\n* [Official Releases](http://soar.eecs.umich.edu/articles/downloads/soar-suite)\n* [Latest Successful Development Build](https://github.com/SoarGroup/Soar/actions/workflows/build.yml?query=branch%3Adevelopment): click the latest run and scroll down to \"Artifacts\".\n - If the download for your platform isn't there, the build failed. You'll need to download the result of an earlier build.\n - GitHub cannot build for ARM64 (M-series Macs), so you'll need to build from source or use the release version instead.\n\n# Soar Performance\n\nSome performance statistics are calculated automatically using the Factorization Stress Tests. You can see performance on a commit-by-commit basis either in [Performance.md](https://github.com/SoarGroup/Soar/blob/development/Performance.md) or [here](http://soar-jenkins.eecs.umich.edu/Performance/). The raw data used to generate the graphs for each build can be found [here](http://soar-jenkins.eecs.umich.edu/Performance/).\n\nDisclaimer: These are worst case tests. Average performance is probably much higher. In addition, these show that even in worst case, Soar beats its goal of 50 msec reactivity (in these tests, the max is ~30msec per decision).\n\n# Development\n\n## Prerequisites\n\nThe instructions below are cursory and may be out of date; the most up-to-date instructions for compiling Soar from source will always be the CI build scripts. You can find them [here](.github/workflows/build.yml).\n\nTo compile Soar, you will need the dependencies listed below. Note that the installation commands are not complete, e.g. missing instructions for Mac do not mean that the dependency is not needed on Mac, etc.:\n\n* C/C++ compiler\n - Mac: `xcode-select --install`\n - Linux: `sudo apt-get install build-essential`\n* Python\n - Mac: `brew install python`\n* Java\n - We recommend using [SDKMan](https://sdkman.io/). The debugger, etc. require Java 11 at a minimum, but it's best to install the latest LTS. Temurin is recommended.\n\nTo compile the extra SML wrapper libs, you will need the following:\n\n* pkg-config\n - Mac: `brew install pkg-config`\n - Linux: `sudo apt install pkgconf`\n* SWIG\n - Mac: `brew install swig`\n - Linux: `sudo apt install swig`\n* Python development headers (only needed for Python wrapper)\n - Linux: `sudo apt install python3-dev`\n* C# compiler (`csc`) (only needed for C# wrapper)\n - Mac: `brew install mono`\n* Tcl (only needed for Tcl wrapper and TclSoarlib)\n - Mac: `brew install tcl-tk`\n\nThe project supports generating compile_commands.json, which can be used by e.g. VSCode with the C/C++ plugin to provide IntelliSense. To generate this file, run scons with the `cdb` target:\n\n python3 scons/scons.py --scu --opt --verbose cdb\n\nNote for M-series Mac users: you'll want to make sure you're compiling for ARM64, not x86_64. Sometimes users have Python installed in compatibility mode, leading to compiles for the wrong architecture. You can check which architecture your Python is built for using this:\n\n```python\nimport sysconfig\n>>> print(sysconfig.get_config_vars())\n```\n\nYou can also check your `clang`'s default compile target using `clang --version`.\n\n# License\n\nSoar is available under the following [LICENSE](https://github.com/SoarGroup/Soar/blob/development/LICENSE.md). This license is [BSD](http://opensource.org/licenses/BSD-2-Clause)\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "Raw SML Bindings to the Soar Cognitive Architecture",
"version": "9.6.2",
"project_urls": null,
"split_keywords": [
"soar"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "529b0305bead2f5321ec1aaaf55e04b9cb9084034bc9027370eff340f96f0bb7",
"md5": "917f54286ba42baf1b803d96554aed01",
"sha256": "b0cb96f553a61824b3eab902c20de1f7754dcd330e5e14d7d6cbb391d80d6768"
},
"downloads": -1,
"filename": "soar_sml-9.6.2-cp310-cp310-macosx_12_0_x86_64.whl",
"has_sig": false,
"md5_digest": "917f54286ba42baf1b803d96554aed01",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.8",
"size": 4026609,
"upload_time": "2024-05-09T20:44:21",
"upload_time_iso_8601": "2024-05-09T20:44:21.077302Z",
"url": "https://files.pythonhosted.org/packages/52/9b/0305bead2f5321ec1aaaf55e04b9cb9084034bc9027370eff340f96f0bb7/soar_sml-9.6.2-cp310-cp310-macosx_12_0_x86_64.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-09 20:44:21",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "soar-sml"
}
