Skip to content


Subversion checkout URL

You can clone with
Download ZIP
a collection of tools for GR(1) synthesis and related activities
C Yacc Shell Makefile Python Tcl Other

Match commands exactly at command-line, not only prefix

E.g., before this changeset, `gr1c helppy` was equivalent to `gr1c help`.
latest commit 079c8b221a
@slivingston authored
Failed to load latest commit information.
aux DOC: Prefer file name "README" instead of README.txt
contrib DOC: READMEs now use Markdown formatting
doc DOC: Beginning of a UNIX-style man page
examples EXAMPLE: Make spc generator compatible with Python 3
exp Include `--` in command-line usage summary
packaging Script for creating binary releases
src Match commands exactly at command-line, not only prefix
tests Correct identifier regex that defines input syntax
.gitignore TRIV: Ignore Python bytecode pyc files
.travis.yml BUILD: Adjust Travis CI config to use and `make cudd`
LICENSE.txt DOC: Happy new (copyright) year
Makefile Rename grpatch program; make available as `gr1c patch` DOC: Move Examples section to be near top of README BUILD: Make curl silent except upon error


Scott C. Livingston

gr1c is a collection of tools for GR(1) synthesis and related activities. Its core functionality is checking realizability of and synthesizing strategies for GR(1) specifications, though it does much more.

The citable URL is

The public Git repo can be cloned from Documentation for the latest release is at

Examples and Documentation

Many examples are provided. Begin by reading examples/

The main documentation is built from .md files under the doc directory and API comments in the source code. It is possible to read these files directly, i.e., without building and browsing HTML files.

$ make doc

will run Doxygen and place the result in doc/build.

Building and installation

We use Travis CI to build and test gr1c from the current source code in the repository. Build Status


  • CUDD, the CU Decision Diagram package by Fabio Somenzi and others.


The following are optional dependencies. Each item is followed by a summary of what is to be gained by building gr1c with it.

  • GNU Readline, for an enhanced command prompt during interactive sessions. Note that there is a built-in prompt.

Building from Source

Detailed installation instructions are in the repository at doc/ For the most recent release, a copy of these instructions is on the Web at

For Linux x86_64 and Mac OSX, try the following.

$ ./
$ make cudd
$ make all
$ make check

The last command runs a test suite. Each testing step is reported if the environment variable VERBOSE is set to 1. E.g., try VERBOSE=1 make check. Finally,

$ make install expinstall

The latter expinstall installs experimental tools, like grpatch. The default installation prefix is /usr/local. Adjust it by invoking make with something like prefix=/your/new/path.


This is free software released under the terms of the BSD 3-Clause License. There is no warranty; not even for merchantability or fitness for a particular purpose. Consult LICENSE.txt for copying conditions.

Something went wrong with that request. Please try again.