Road Runner
Search…
Road Runner
Initial page
KDoc
Javadoc
Tour
Introduction
PID Control
Feedforward Control
Motion Profiling
Coordinate Frames
Parametric Paths
Trajectories
Kinematics
Quickstart
Introduction
Tuning
FAQ
Advanced
Resources
Powered By GitBook
Initial page
A little motion planning library designed for FTC. Check out the source on GitHub.

Check out the quickstart for an example of Road Runner in practice.

  1. 1.
    Open build.dependencies.gradle and add maven { url = 'https://maven.brott.dev/' } to the end of the repositories block.
  2. 2.
    Open TeamCode/build.gradle and add implementation 'com.acmerobotics.roadrunner:core:0.5.5' to the end of the dependencies block.
  3. 3.
    Sync the project (Android Studio should prompt you to do this).
Adding Road Runner and its dependencies may put your install package over the method reference limit imposed by some versions of Android. This restriction can be circumvented by one of the following methods:
  • If you do not need to target API level 19 (i.e., you don't need to use ZTE Speeds), add multiDexEnabled true to the defaultConfig closure in build.common.gradle.
  • Otherwise, the next best solution is to enable Proguard which culls unnecessary methods. Begin by downloading the proguard-rules.pro file from the quickstart and save it to the TeamCode directory. Then add following lines to the debug and release closures inside buildTypes in build.common.gradle:
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'),
'proguard-rules.pro'
For more information, see this article.

Road Runner includes a simple GUI for generating trajectories from pose waypoints and constraints. You can download the latest version from the Releases tab (or build it with ./gradlew shadowJar).

Road Runner also includes a simple IDEA/Android Studio plugin based upon the GUI. Here are some instructions for building and loading the plugin:
  1. 1.
    Download the latest plugin zip from the Release assets or build it with ./gradlew buildPlugin.
  2. 2.
    In Android Studio, navigate to Settings > Plugins.
  3. 3.
    Click the gear icon and select Install Plugin from Disk....
  4. 4.
    Select the zip archive from your downloads or plugin/build/distributions.
  5. 5.
    Restart Android Studio to activate plugin changes.
  6. 6.
    Click on "Road Runner" on the right side of the editor and the tool window should appear.
Next - Tour
Introduction
Last modified 7mo ago
Copy link
On this page
Quickstart
Installation
Core (FTC)
GUI
Plugin