OpenCV and OpenNI gamepiece detection code to be used on the 2022 robot.
Features NetworkTables integration to send various datapoints to driver's station and robot.
Won Innovation in Control Award at the FIRST Indiana District Kokomo Event.
Won Autonomous Award at the FIRST Indiana District Tippecanoe Event.
Dependencies are in requirements.txt.
Commands to install these:
Windows: py -3 -m pip install -r requirements.txt (while working directory is set to project directory)
macOS/Linux: pip3 install -r requirements.txt (while working directory is set to project directory)
It is highly recommended to install dependencies in a virtual environment. If you need help creating this, refer to the Python documentation.
On macOS, make sure you install Python 3 separately and do not use the system install (package installation will fail when not run as root).
In order to use this project with an Astra camera, you must have Orbbec's flavor of OpenNI installed. See Orbbec's develop page and move all the way to the bottom to install their Orbbec OpenNI SDK. Follow the instructions in the README for your system.
Do not commit changes to the constants.json file. These values have been calibrated for individual cameras and game pieces and need not be changed. You may, however, change the command-line args that you use to change the project's function (i.e. switching to your computer's webcam instead of using the Astra, disabling NetworkTables when not connected to a robot/testbench, or enabling a video feed).
Refer to the TechHOUNDS coding style guide. Although this is for Java, there is still valuable information for other languages. If your question is not answered by that, use the Google style guide for Python. Documentation is expected for all modules, classes, and functions, and all functions should be type-hinted. For all difficult to understand code, either simplify it or add comments.
Note: for consistency's sake, whenever using both blue and red detection in the same function the order for params and return vars should be blue, red.
If setting this repository up on any new Raspberry Pi, copy the contents of the scripts folder to /home/pi. This is necessary because static IP addressing based on SSID doesn't work when connected via Ethernet, so we have to manually enable and disable static IP addressing when we want to connect to a different network like CCS. Run sudo ./enable_static.sh to enable static IP addressing (on the robot network, usually), and run sudo ./disable_static.sh to disable static IP addressing (on CCS, or any Internet-connected network).