sco_py is a lightweight Sequential Convex Optimization library for solving non-convex optimization problems. sco_py is intended for use with the OpenTAMP planning system. Currently, the library supports both Gurobi (license required) and OSQP (open-source, no license required!) as backend QP solvers.
Simply run: pip install sco-py
Simply run: pip install git+https://github.com/Algorithmic-Alignment-Lab/sco_py.git
- Clone this repository from GitHub
- Install Poetry by following the instructions from here
- Install all dependencies with
poetry install
.
sco is an open-source repository and as such, we welcome contributions from interested members of the community! If you have a new idea for a feature/contribution, do post in the 'Discussions' tab of the GitHub repository to get some feedback from the maintainers before starting development. In general, we recommend that you fork the main repository, create a new branch with your proposed change, then open a pull-request into the main repository. The main requirement for a new feature is that it cannot break the current test cases (see below for how to run our tests) unless this is unavoidable, and in this case, it should modify/introduce new tests as necessary. In particular, we welcome updates to documentation (docstrings, comments, etc. that make the codem more approachable for new users) and test cases!
If you do not have a license for Gurobi, then you can only run the OSQP tests. To do so, run:
pytest tests/sco_osqp/
If you do have a license for Gurobi, then you can run all tests with the pytest
command.
Note that our Contrinuous Integration (CI) setup only checks and reports status for OSQP tests. In general, if you are contributing a new feature, it must pass the existing OSQP tests and contribute new tests that test the new feature at least with OSQP (and preferably with Gurobi as well).