Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
a collection of tools for GR(1) synthesis and related activities
Failed to load latest commit information.
aux
contrib
doc
examples
exp
packaging
src
tests
.gitignore
.travis.yml
CHANGELOG
CMakeLists.txt
LICENSE.txt
Makefile
README.md
get-deps.sh

README.md

Introduction

Scott C. Livingston slivingston@cds.caltech.edu

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 http://scottman.net/2012/gr1c

The public Git repo can be cloned from https://github.com/slivingston/gr1c.git Documentation for the latest release is at http://slivingston.github.io/gr1c

Building and installation

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

Dependencies

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

Optional

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/installation.md This section provides an outline.

For building entirely from source code, CUDD (cf. "Depedencies" section above) should be placed in a directory called "extern". The variable CUDD_ROOT in Makefile should indicate this directory and may need to be adjusted. Be sure that similar flags are used for compiling both gr1c and CUDD. In particular, SIZEOF_VOID_P and SIZEOF_LONG need to be set to the sizes (in bytes) of void pointer (void *) and long int on your system. gr1c ships with a Makefile that has these set for Intel x86 64-bit, which will likely succeed for Linux x86_64 and Mac OS X. More generally, it should suffice to copy your setting of XCFLAGS in the Makefile of CUDD to the variable CUDD_XCFLAGS in the Makefile of gr1c.

Once CUDD is built, all gr1c programs may be built and installed

$ make all
$ 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.

A test suite is available. To run it, after building gr1c,

$ make check

Each testing step is reported if the environment variable VERBOSE is set to 1. E.g., try VERBOSE=1 make check.

Examples and Documentation

Many examples are provided. Begin by reading examples/README.md.

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.

License

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. See LICENSE.txt for copying conditions.

Something went wrong with that request. Please try again.