Skip to content

Latest commit

 

History

History
125 lines (83 loc) · 7.25 KB

README.md

File metadata and controls

125 lines (83 loc) · 7.25 KB

Alpha

Latest DOI Travis-CI Build Status AppVeyor Build Status codecov Code Quality Status Coverage Status

Alpha is an Answer Set Programming (ASP) system: It reads a logic program (a set of logical rules) and computes the corresponding answer sets. ASP falls into the category of declarative and logic programming. Its applications are solving combinatorial problems, but it also is a good tool for reasoning in the context of knowledge-representation and databases.

Alpha is the successor of OMiGA and currently in development. In contrast to many other ASP systems, Alpha implements a lazy-grounding approach in hopes of overcoming memory constraints when working with large input.

Alpha is not the fastest system available, since its goal is not to be the fastest system with current technology but to explore new technologies rapidly. Those technologies, like lazy-grounding, allow Alpha to succeed where other ASP systems fail completely. The project deliberately chooses to trade shorter execution times (which would be possible by using unmanaged runtimes, e.g. C/C++, and low-level optimization) for a more straight forward system design and possibilities to interface with the ecosystem built around the Java Virtual Machine.

Getting Started

Download a current version of the distribution jar (alpha-cli-app-${version}-bundled.jar) from Releases and save it as alpha.jar for convenience.

Running Alpha is as simple as running any other JAR:

$ java -jar alpha.jar

Example Usage

Solve 3-colorability for some benchmarking instance and filter for color predicates:

$ java -jar alpha.jar -i benchmarks/omiga/omiga-testcases/3col/3col-10-18.txt -fblue -fred -fgreen

Note that in this example the path to the input file is relative to the root of this repository. If you have not checked out the repository, you can just download the example file from GitHub.

A coder's guide to answer set programming provides a short and high-level tutorial on Answer Set Programming.

Building

Alpha uses the Gradle build automation system. Executing

$ ./gradlew build

will automatically fetch all dependencies (declared in build.gradle.kts) and compile the project.

Artifacts generated will be placed in the build/ subfolder of the respective module. Most notably you'll find files ready for distribution at alpha-cli-app/build/distributions/. They contain archives which in turn contain a bin/ directory with scripts to run Alpha on Linux and Windows.

If you want to generate a JAR file to be run standalone, execute

$ ./gradlew alpha-cli-app:bundledJar

and pick up alpha-cli-app/build/libs/alpha-cli-app-${version}-bundled.jar.

A Note on IDEs

We have contributors using IntelliJ IDEA as well as Eclipse IDE. However, we decided to not check in files related to project configuration. For both tools, standard features to "import" the project based on its Gradle build configuration are available, and they will infer sane defaults. If you run into trouble feel free to file an issue.

Suggested Reading

Beginners' Tutorials

Theoretical Background and Language Specification

Research Papers on Alpha

Peer-reviewed publications part of journals, conferences and workshops:

2021

2020

2019

2018

2017

Others (e.g. non-peer-reviewed publications, less formal articles, newsletters):

Similar Work

  • Smodels, a solver usually used in conjunction with lparse.
  • DLV
  • ASPeRiX, a solver that implements grounding-on-the-fly.