Skip to main content

No project description provided

Project description

PyCSCL 0.2.0

The Cute SAT Constraint encoder Library for Python 3

PyCSCL is a collection of propositional logic constraint encoders. You can use it e.g. to reduce instances of NP-complete problems to instances of the Boolean satisifability (SAT) problem, benefitting from the availability of powerful off-the-shelf SAT solvers.

Though PyCSCL is designed not to depend on a specific SAT solver interface, it contains a simple and easy-to-use binding for SAT solvers implementing the IPASIR interface.

The versioning scheme of PyCSCL is Semantic Versioning 2.0.0.

Installing PyCSCL


PyCSCL has no dependencies beyond Python 3.7.

Release packages

PyCSCL releases are distributed on the Python Package Index. To be consistent with package naming conventions, the PyCSCL package is named pycscl. To install the latest PyCSCL release package, you can simply use pip:

python3 -m pip install pycscl

Custom packages

Alternatively, you can check out this repository and install PyCSCL by creating a package yourself. Navigate to the PyCSCL directory and issue the command

python3 sdist 

This will create a package pycscl-<Version>.tar.gz file in the directory dist. Now, you can install your custom PyCSCL package by running

python3 -m pip install <PathToPyCSCL>/dist/pycscl-<Version>.tar.gz



Cardinality (at-most-k) constraint encoders
  • Binomial encoding
  • LTSeq encoding
  • Commander encoding

Package: cscl.cardinality_constraint_encoders

Gate constraint encoders
  • AND, OR, binary XOR gates
  • Binary MUX gates
  • Half adder and full adder gates

Package: cscl.basic_gate_encoders

Bitvector constraint encoders
  • Bitvector AND, OR, XOR gates
  • Ripple-carry bitvector adder and (2's complement) subtractor gates
  • Parallel bitvector multiplier gate
  • Unsigned bitvector divider and modulo gate
  • Signed (2's complement) and unsigned bitvector comparison gates

Package: cscl.bitvector_gate_encoders


  • cscl_examples.factorization: integer factorization problem encoder
  • cscl_examples.sudoku: SAT-based Sudoku solver
  • cscl_examples.smt_qfbv_solver (under construction): simple QF_BV SMT solver

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pycscl, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size pycscl-0.2.0.tar.gz (53.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page