https://github.com/sisl/adaptivestresstestingtoolbox
A toolbox for worst-case validation of autonomous policies
https://github.com/sisl/adaptivestresstestingtoolbox
Last synced: 9 months ago
JSON representation
A toolbox for worst-case validation of autonomous policies
- Host: GitHub
- URL: https://github.com/sisl/adaptivestresstestingtoolbox
- Owner: sisl
- License: mit
- Created: 2018-09-27T22:49:27.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T10:56:13.000Z (over 3 years ago)
- Last Synced: 2025-08-24T23:04:30.272Z (10 months ago)
- Language: Python
- Homepage:
- Size: 79 MB
- Stars: 35
- Watchers: 6
- Forks: 11
- Open Issues: 22
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.rst
- Contributing: CONTRIBUTING.rst
- License: LICENSE
Awesome Lists containing this project
README
===============================
Adaptive Stress Testing Toolbox
===============================
v2020.09.01.7.
|build-status| |docs| |coverage| |license|
========
Overview
========
A toolbox for worst-case validation of autonomous policies.
Adaptive Stress Testing is a worst-case validation method for autonomous policies. This toolbox is being actively developed by the Stanford Intelligent Systems Lab.
See https://ast-toolbox.readthedocs.io/en/latest/ for documentation.
Maintained by the `Stanford Intelligent Systems Lab (SISL) `_
* Free software: MIT license
Installation
============
Pip Installation Method
-----------------------
UPDATE:
For now, please only use the following Docker install. We are working on an update to fix dependency conflicts caused by an update in some underlying packages.
Docker Method::
git clone https://github.com/sisl/AdaptiveStressTestingToolbox.git
cd AdaptiveStressTestingToolbox
git submodule update --init --recursive
docker build -t ast-toolbox . -f ./docker/Dockerfile
docker container run -it ast-toolbox:latest
You can install the latest stable release from pypi::
pip install ast-toolbox
You can also install the latest version with::
pip install git+https://github.com/sisl/AdaptiveStressTestingToolbox.git@master
Using the Go-Explore work requires having a Berkely DB installation findable on your system. If you are on Linux::
sudo apt-get update
sudo apt install libdb-dev python3-bsddb3
If you are on OSX::
brew install berkeley-db
export BERKELEYDB_DIR=$(brew --cellar)/berkeley-db/5.3
export YES_I_HAVE_THE_RIGHT_TO_USE_THIS_BERKELEY_DB_VERSION=1
Once you have the Berkeley DB system dependency met, you can install the toolbox::
pip install ast-toolbox[ge]
Git Installation Method
-----------------------
If you are interested in development, you should clone the repo. You can use https::
git clone https://github.com/sisl/AdaptiveStressTestingToolbox.git
You can also use ssh::
git clone git@github.com:sisl/AdaptiveStressTestingToolbox.git
If you are on Linux, use the following commands to setup the Toolbox::
cd AdaptiveStressTestingToolbox
git submodule update --init --recursive
sudo chmod a+x scripts/install_all.sh
sudo scripts/install_all.sh
source scripts/setup.sh
Documentation
=============
You can find our `documentation `_ on readthedocs.
Development
===========
Please see our `Contributions Guide `_.
Acknowledgements
================
Built using the `cookiecutter-pylibrary `_ by Ionel Cristian Mărieș
.. |build-status| image:: https://api.travis-ci.org/sisl/AdaptiveStressTestingToolbox.svg
:alt: Build Status
:scale: 100%
:target: https://travis-ci.org/sisl/AdaptiveStressTestingToolbox
.. |docs| image:: https://readthedocs.org/projects/ast-toolbox/badge/?version=latest
:alt: Documentation Status
:scale: 100%
:target: https://ast-toolbox.readthedocs.io/en/latest/?badge=latest
.. |coverage| image:: https://codecov.io/gh/sisl/AdaptiveStressTestingToolbox/branch/master/graph/badge.svg
:alt: Code Coverage
:scale: 100%
:target: https://app.codecov.io/gh/sisl/AdaptiveStressTestingToolbox
.. |license| image:: https://img.shields.io/badge/license-MIT-yellow.svg
:alt: License
:scale: 100%
:target: https://github.com/sisl/AdaptiveStressTestingToolbox/blob/master/LICENSE