Code Monkey home page Code Monkey logo

robocup-software's Introduction

GT RoboJackets RoboCup SSL

16.04 Build Status 14.04 Build Status OSX Build Status Coverage Status

Join the chat at https://gitter.im/RoboJackets/robocup-software

The Georgia Tech RoboJackets team competes in the annual RoboCup Small Size League (SSL) competition. This repository contains all of the software that we run on the main field laptop and on our robots. More information on how our software works can be found on our documentation page, our wiki or on our website. Also, check out our 2014 qualification video to see our robots in action!

Here is a screenshot of our 'soccer' program: Screenshot of the 'soccer' program

The Competition

The soccer game is played between two teams of six robots each on a field with overhead cameras. The field vision computer processes images from the cameras and sends out (x,y) coordinates of the ball and the robots. Each team has a laptop that accepts the data from the vision computer and uses it to strategize, then send commands to robots on the field.

The official RoboCup site has more information on the competition.

Project Layout

robocup-software is split into 3 parts, software, firmware, and a common part, used by both software and firmware. This repository contains the software portion of our codebase, the part that runs on our laptops, running high level plays.

soccer/

The soccer folder contains the code to build the 'soccer' program, which is the main program in control when running our robots.

simulator/

Code for the RoboCup simulator is located here. This allows us to quickly test our soccer strategy on the computer. Keep in mind though that just because something works well in the simulator doesn't mean it'll be the same in real life.

common/

Code that's shared between the software and firmware sections of our codebase is stored here, as a git submodule. See RoboJackets/robocup-common.

external/

External dependencies that our code relys on, stored as git submodules. To initialize these, please run git submodule update --init --recursive.

run/

Compiled programs and some configuration files are stored here.

Setup

Here's a quick guide to getting this RoboCup project setup on your computer. We recommend and only provide directions for installing on Ubuntu Linux, Arch Linux, and Mac OS X, although it shouldn't be too difficult to port to other operating systems.

  1. Clone the repository
git clone git://github.com/RoboJackets/robocup-software
  1. Install the necessary software

There are a few setup scripts in the util directory for installing required packages, setting up udev rules, etc. See ubuntu-setup, arch-setup, and osx-setup for more info.

$ cd robocup-software
$ util/<SYSTEM>-setup
  1. Build the project
$ make

We use CMake as our build system and have a simple makefile setup that invokes CMake.

After running make, several programs will be placed in the run folder. See the soccer docs for instructions on running the soccer program.

Documentation

We use Doxygen for documentation. This allows us to convert specially-formatted comments within code files into a nifty website that lets us easily see how things are laid out. Our compiled doxygen documentation for software can be found here:

http://robojackets.github.io/robocup-software/

Note: The doxygen documentation site above is updated automacally using circle-ci. See our autoupdate-docs.sh file for more info.

Testing

We use gtest for unit-testing our software, which can be run by running make tests. To add a test to be run with the rest of the bunch, add a new file in soccer/tests.

The soccer tests can be run using make test-soccer or firmware tests with make test-firmware. The TESTS name filter to run only certain tests. For example make test-soccer TESTS=Point* runs only the tests for the Point class.

License

This project is licensed under the Apache License v2.0. See the LICENSE file for more information.

robocup-software's People

Contributors

abranch6364 avatar ashaw596 avatar barulicm avatar blueintegral avatar chachmu avatar chrisdoho avatar cktben avatar ehuang3 avatar guyfleeman avatar hchittanuru3 avatar imtn avatar jason27chan avatar jcarn avatar jedyang97 avatar jgkamat avatar jjones646 avatar jneiger avatar joshhting avatar jpfeltracco avatar justbuchanan avatar kevinatorchen avatar krispreza avatar mmurley3 avatar mosdragon avatar petschekr avatar ra4king avatar rachitk avatar rmkeezer avatar ryanstrat avatar xxia34 avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.