autolib's Introduction

autolib

AutoLib is a Pros C++ Library based off of OkapiLib for Advanced Vex Autonomous Programming

Summary

AutoLib is a Pros C++ Library for Advanced Vex Autonomous Programming

Note: AutoLib v1.0.0 is coming out soon! And we would love your contributions! Click to contact us.

Why AutoLib?

Features:

PathGenerator: A simplified easy class for generating a path
PurePursuit: A robust path following algorithm for controlling your robot's chassis
Versatile: You can use your own custom library or you can use OkapiLib to handle the motor control and odometry
Documentation: Great Documentation for Expert to Newbie Vex Team Programmers
Open Source: You can and should contribute to this project

Docs

Head over to the documentation website:

https://github.com/team914/autolib/wiki

Note: The docs are currently in progress, so if you can't find something please contact us!

Contributing

AutoLib isn't perfect; and it never will be, but we can get it pretty close. However, without your contributions and community involvment it may never get to it's full potential. So help make AutoLib by submitting a PR.

Contributions are accepted using GitHub pull requests; for more information, see GitHub documentation - Creating a pull request. In addition, dealing with git branches and forks can be tricky if you don't already know how to use them; see Editing and Creating a new branch with git and manage branches

For a good pull request, we ask you provide the following:

Include a clear description of your pull request in the description with the basic "what" and "why"s for the request.
If the pull request is a new feature, please include appropriate documentation in the wiki.
Keep a consistent coding style.

Implimentation

Robot

We suggest that you use a robot similair to the one described in the 5225A Pilons Position Tracking Document, however we support basically any configuration of a Skid Steer or X Drive.

Note: Before you begin to use AutoLib we suggest that you read up on the algorithms that we use.

Contact

To contact us:

Ping @potatehoes#7782 on the Unofficial Vex Discord Server
Email [email protected]
PM us on the Vex Forum

Mailing List

If you would like to join the mailing list, please email [email protected] that you would like to do so.

License

AutoLib is licensed under the MIT License.

Thank You!

Huge Thanks to the following. AutoLib wouldn't be AutoLib without these wonderful people.

Theo Lemay, 7842F - theol0403
Ryan Benasutti, WPI - Octogonapus
Alex Brooke, PROS - hotelcalifornia
Nick Mertin, QUEEN - nickmertin
Dysproh, 2158A - dysproh
Benjamin Gubler - nebrelbug
David Jones - jonesde

autolib's People

Contributors

Stargazers

Watchers

autolib's Issues

Feature Request: Auto Selector

Please Describe The Problem To Be Solved
Many people make their own auto selector. It would be very nice to create a GUI for the brain that would allow for a dynamic auto selector that would be game independent.

(Optional): Suggest A Solution

Similair to this.
Making it game independent would be difficult unless it had a config file that contains where the possible places where the robot starts is and the amount of different autons.

Bug Report: autolib::Point and okapi::Point

opcontrol.txt

Description

Whenever using autolib it is necessary to put a autolib:: before accessing autolib's Point object. This is because okapi also has a Point object(but it isn't actually a point it's a x,y,yaw coordinate which is a pose) in PathFinder.

Steps to Reproduce

Follow this guide.
Replace opcontrol.cpp with file linked below.
Make the code and see no errors.
Delete autolib:: on lines 25-28
Make the code and see all sorts of errors.

Expected behavior: No errors on step 5.

Actual behavior: A ton of errors on step 5.

Versions

Name Version Origin

kernel 3.1.6 pros-mainline
okapilib 4.0.0-beta8 local
autolib 0.9.0 local

Additional Information

N/A

Bug Report: PathGenerator

Describe the bug
When constructing PathFinder's first field initializer_list of autolib::Points,

To Reproduce
Steps to reproduce the behavior:

Follow the Getting Started with AutoLib Guide
Replace the opcontrol file with attached file.
prosv5 mut --execute
See error. It will print.

findCurvature
        iyaw(0.000000), idistance(inf)

Expected behavior
Replace line 28 with autolib::Point( 1_in, -1_in ) //Then ( 1 inch, -1 inch ) and run it again. It will print.

findCurvature
        iyaw(-51.425299), idistance(-0.019446)

Screenshots
N/A

Desktop (please complete the following information):

OS: pop!_os