WPIRoboticsProjects / GRIP

Program for rapidly developing computer vision applications
http://wpiroboticsprojects.github.io/GRIP
Other
379 stars 107 forks source link
camera computer-vision first-frc first-robotics-competition firstrobotics opencv robotics vision wpi

logo

Join the chat at https://gitter.im/WPIRoboticsProjects/GRIP Build Status codecov.io Github Releases

GRIP Computer Vision Engine

GRIP (the Graphically Represented Image Processing engine) is an application for rapidly prototyping and deploying computer vision algorithms, primarily for robotics applications. Developing a vision program can be difficult because it is hard to visualize the intermediate results. GRIP simplifies and accelerates the creation of vision systems for experienced users and reduces the barrier to entry for inexperienced users. As a result, many teams with minimal computer vision knowledge have successfully used GRIP since the 2016 FIRST Robotics Competition game.

Features

Getting Started

  1. Download the newest release for your operating system.
  2. Run the included installer.
  3. Open GRIP

Check out the release notes and the wiki for more information.

Note for Linux users: GRIP requires GTK2 to be installed. Most Ubuntu-based distributions include it, but some other distros such as Arch may require it to be manually installed. GRIP also requires libc version 2.27 or higher; for Ubuntu-based distributions, this requires Ubuntu 18.04 or newer.

Building GRIP From Source

To build and run, use the included Gradle wrapper script on a Unix System:

./gradlew :ui:run

On Windows:

gradlew :ui:run

If you don't have an internet connection you can build using the --offline flag if you have built GRIP once before.

Running Tests

To do a complete check of functionality of GRIP, use the included Gradle wrapper script on a Unix System:

./gradlew check

On Windows:

gradlew check

CUDA Support

To enable CUDA acceleration, CUDA 10.0 needs to be installed on your computer. CUDA 10.1 may work on Linux systems, but Windows must use 10.0.

When running or building from source, add the Gradle flag -Pcuda to enable CUDA acceleration (eg ./gradlew :ui:run -Pcuda)

Note that CUDA acceleration is not available for all operations.

Code generation does not support CUDA - it is only used for operations running in GRIP.

Contributing

See the guide on setting up build tools in the wiki.