Skip to content
a collection of tools for GR(1) synthesis and related activities
C Yacc PLSQL Shell Makefile Python Other
Branch: master
Clone or download
Latest commit 043e72e Apr 1, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
aux Include versions used by other commands: rg, patch, autman Oct 5, 2016
contrib CONTRIB DOC Jan 29, 2018
doc DOC: prefer HTTPS Apr 1, 2019
examples Use filename in perror() calls instead of fcn name May 28, 2017
exp Include versions used by other commands: rg, patch, autman Oct 5, 2016
include DOC: bump copyright year Mar 8, 2018
packaging Bump CUDD version used in build-bdist.sh Aug 30, 2016
src
tests TEST: more verbose messages of testing progress Mar 16, 2018
vm
.gitignore TRIV: Git-ignore more GCC gcov files Jan 29, 2018
.travis.yml TEST: remove OSX from Travis CI config Oct 4, 2017
CHANGELOG DOC: Update CHANGELOG for v0.12.0 Jan 27, 2018
CMakeLists.txt BUILD: Remove -DBSD flag from default; organize with CFLAGS_BASE Dec 2, 2013
LICENSE.txt DOC: happy new year! Apr 1, 2019
Makefile move all header files into dedicated directory Feb 4, 2018
README.md DOC: prefer HTTPS Apr 1, 2019
build-deps.sh Include check for and building of Spin in build-deps.sh Aug 6, 2016
get-deps.sh BUILD: improve generality of get-deps.sh Feb 23, 2018
get-extra-deps.sh Only fetch dependency tar file if one not found May 1, 2017

README.md

Introduction

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

The public Git repo can be cloned from https://github.com/tulip-control/gr1c.git Documentation for the latest release is at https://tulip-control.github.io/gr1c Bug reports, feature requests, and substantial comments can be submitted via the project issue tracker or via email to the authors.

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.

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 For the most recent release, a copy of these instructions is on the Web at https://tulip-control.github.io/gr1c/md_installation.html

For Linux x86_64 and Mac OSX, try the following.

./get-deps.sh
./build-deps.sh
make
make check

Consider using make -j N where N is the number of jobs to run simultaneously. 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

The default installation prefix is /usr/local. Adjust it by invoking make with something like prefix=/your/new/path.

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

You can’t perform that action at this time.