photonvision

PhotonVision is the free, fast, and easy-to-use computer vision solution for the FIRST Robotics Competition.

GPL-3.0 License

Stars
264
Committers
76
View Code on GitHub Visit Website
Ecosystems: Java, OpenCV, FIRST Robotics Competition

Bot releases are visible (Hide)

photonvision - v2024.1.1-beta-3.2

Published by srimanachanta 12 months ago

What's Changed

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2024.1.1-beta-3.1...v2024.1.1-beta-3.2

photonvision - v2024.1.1-beta-3.1

Published by github-actions[bot] 12 months ago

What's Changed

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2024.1.1-beta-3...v2024.1.1-beta-3.1

photonvision - v2024.1.1-beta-3

Published by github-actions[bot] 12 months ago

This is the third beta release for the 2024 FRC competition season! A lot has changed since 2023, so take a look at the PRs merged below, and changes since 2023.4.2. Our docs (still being updated for 2024) have general installation and debugging instructions.

We want to thank everyone who contributed to PhotonVision in any way. This is a volunteer-run project, and community code contributions, beta testing, and feedback have been invaluable in making PhotonVision what it is. We’re always trying to improve, so if you have any issues or questions, please let us know on Chief Delphi or our Discord. In particular, say hello to everyone who's contributed for the first time since our last release!

Known issues

  • PhotonPoseEstimator's estimated pose has different origin depending on number of tags in view #991 (fixed in latest dev)

What's Changed

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2024.1.1-beta-1...v2024.1.1-beta-3

photonvision - v2024.1.1-beta-2

Published by github-actions[bot] 12 months ago

This is the second beta release for the 2024 FRC competition season! A lot has changed since 2023, so take a look at the PRs merged below, and changes since 2023.4.2. Our docs (still being updated for 2024) have general installation and debugging instructions.

We want to thank everyone who contributed to PhotonVision in any way. This is a volunteer-run project, and community code contributions, beta testing, and feedback have been invaluable in making PhotonVision what it is. We’re always trying to improve, so if you have any issues or questions, please let us know on Chief Delphi or our Discord. In particular, say hello to everyone who's contributed for the first time since our last release!

Known issues

  • PhotonPoseEstimator's estimated pose has different origin depending on number of tags in view #991 (fixed in latest dev)

What's Changed

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2024.1.1-beta-1...v2024.1.1-beta-2

photonvision - v2024.1.1-beta-1

Published by github-actions[bot] 12 months ago

This is the first beta release for the 2024 FRC competition season! A lot has changed since 2023, so take a look at the PRs merged below. Our docs (still being updated for 2024) have general installation and debugging instructions.

We want to thank everyone who contributed to PhotonVision in any way. This is a volunteer-run project, and community code contributions, beta testing, and feedback have been invaluable in making PhotonVision what it is. We’re always trying to improve, so if you have any issues or questions, please let us know on Chief Delphi or our Discord. In particular, say hello to everyone who's contributed for the first time since our last release!

Known issues

  • Cross-compiled builds (so all aarch64/arm32 builds) have incorrect OpenCV rpaths. This breaks Photon pi image, arm32, and aarc64 builds. This is fixed in beta-2.

Major changes

Other Changes

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2023.4.2...v2024.1.1-beta-1

photonvision - v2023.4.2

Published by mdurrani808 over 1 year ago

What's Changed

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2023.4.1...v2023.4.2

photonvision - v2023.4.1

Published by github-actions[bot] over 1 year ago

What's Changed

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2023.4.0...v2023.4.1

photonvision - v2023.4.0

Published by github-actions[bot] over 1 year ago

New release, now built against wpilib 2023.3.2! If you're using 2023.3.0 no need to reflash; if you're coming from an earlier version, and on a limelight or Pi device, a reflash is probably required (depending on version).

This release brings mulit-tag PNP support! Change the estimation strategy to MULTI_TAG_PNP in your PhotonPoseEstimator to take advantage of this new feature.

Major changes

Other Changes

New Contributors

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2023.3.0...v2023.4.0

photonvision - v2023.3.0

Published by github-actions[bot] over 1 year ago

Major fixes

Fixes issue with v2023.2.2 where LimeLight cameras fail to load camera streams. New major version means you should reflash your LimeLight/Pi! The libcamera driver we built our GPU code against (0.0.3) is different from 2023.2.1 or 2023.2.2, and a reflash is required to get the new Linux libraries. Orange Pi/MiniPC/other people, reflashing is not required.

What's Changed

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2023.2.2...v2023.3.0

photonvision - v2023.2.2

Published by github-actions[bot] over 1 year ago

Major notes

(Breaking) Limelight users will need to offline update to the jar here to fix camera streams not appearing: https://github.com/PhotonVision/photonvision/releases/download/Dev/photonvision-dev-v2023.2.2-1-gdeb8f97e-linuxarm64.jar

Breaking C++ bug fixed, as well as changing pipelines over NT. LimeLight image now has NetworkManager, which was required, but will occasionally fail to boot on some LimeLight devices. Reflashing to older versions of Photon or reflashing LL software is sufficient to recover the device.

Note that connecting to your coprocessor without a DHCP server, and specifically the FRC radio, also connected to your network switch is not a supported (as in we-provide-troubleshooting, not as in does-it-work) configuration. Advanced users can make static IP work without a radio, though!

What's Changed

New Contributors

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2023.2.1...v2023.2.2

photonvision - v2023.2.1

Published by github-actions[bot] almost 2 years ago

2023.2.1

For Raspberry Pi & LimeLight/Gloworm devices we highly suggest reimaging to improve networking robustness. For all other devices (Orange Pi, Beelink, etc) a offline update is sufficient.

Known issues

  • LimeLight fails to boot with new image -- Ethernet lights never start blinking. Working on a fix ASAP
  • LimeLight won't take static IP -- due to NetworkManager not running by default. Working on confirming a fix, for now I've taken the LL image down from this release.
  • Sometimes, 3d mode can freeze right after calibration. Restarting photon once or changing resolutions after calibration seems to fix this -- still trying to nail down root cause.

Major changes

Other changes

New Contributors

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2023.1.2...v2023.2.1

photonvision - v2023.1.2

Published by mdurrani808 almost 2 years ago

This is the first full release for the 2023 FRC Game, Charged Up!

Users must completely reimage / reinstall PhotonVision on their coprocessors for this release due to the amount of changes from previous releases.

Minimum system requirements have changed for 2023. WPILib / PhotonVision now requires 64-bit Windows 10 or 11 or Ubuntu 22.04. We have dropped support for older platforms including Windows 7, Ubuntu 20.04, and macOS 10.15.

Known Issues:

  • Simulation support was removed for C++ and is in the process of being rewritten to support AprilTags.
  • Sometimes the camera stream will not show up when changing tabs/views. A refresh of the page can fix this.

We want to thank everyone who contributed to PhotonVision in any way. This is a volunteer-run project, and community code contributions, beta testing, and feedback have been invaluable in making PhotonVision what it is. We’re always trying to improve, so if you have any issues or questions, please let us know on Chief Delphi or our Discord.

What's Changed

New Contributors

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2022.2.0...v2023.1.2

photonvision - v2023.1.1-beta-8

Published by github-actions[bot] almost 2 years ago

v2023.1.1-beta-8

The last release prior to the 2023 kickoff! Note that this code is using built against WPILib version 2023.1.1-beta-7-15-g1e7fcd5 and uses NT4. 2022 Code using NT3 will most likely not work with this version.

Note: Minimum system requirements have changed for 2023. WPILib / PhotonVision now requires 64-bit Windows 10 or 11, Ubuntu 22.04, or macOS 11 or higher. Newly supported this year is Apple Silicon (arm64)! We have dropped support for older platforms including Windows 7, Ubuntu 20.04, and macOS 10.15.

Major Changes

Other Changes

New Contributors

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2023.1.1-beta-7...v2023.1.1-beta-8

photonvision - v2023.1.1-beta-7

Published by github-actions[bot] almost 2 years ago

Major changes since Beta 6

Other changes

New Contributors

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2023.1.1-beta-6...v2023.1.1-beta-7

photonvision - v2023.1.1-beta-6

Published by github-actions[bot] almost 2 years ago

Photonvision 2023 Beta 6

This is (expected to be) out last release built against wpilIb 2022 -- future releases will use wpilib 2023 beta artifacts as we prepare for the 2023 season.

Major changes

Full changelog

New Contributors

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2023.1.1-beta-5...v2023.1.1-beta-6

photonvision - v2023.1.1-beta-5

Published by github-actions[bot] almost 2 years ago

Photonvision 2023 Beta 5

(Now with 100% less jcenter!)

And a huge shoutout to all of our new contributers! Nothing would get done here if it weren't for people jumping in and contributing to make PhotonVision better. If you're interested in helping out (which you should!), feel free to join our discord or take a stab at some open issues.

Major changes

Full changelog

New Contributors

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2023.1.1-beta-3...v2023.1.1-beta-4

photonvision - v2023.1.1-beta-4

Published by github-actions[bot] almost 2 years ago

Use v2023.1.1-beta-5 (above), this one has a known issue with camera streaming in its own tab (#558)

photonvision - v2023.1.1-beta-3

Published by github-actions[bot] about 2 years ago

Bugfixes

  • AprilTag pipeline now shows unprocessed image in the "Normal" (renamed to "Raw") stream, and target overlay on grayscale image in the "Thresholded" (renamed to "Processed") stream.
  • Fixed an NPE crashloop caused by switching to an uncalibrated resolution while in 3D mode.
  • Fixed a pose reporting bug in AprilTags that reversed one of the rotation axes.
  • Disabled USB camera autofocus

Enhancements

  • Exposed an "Auto Exposure" switch in the "Input" settings.
  • The 3D calibrator will now calculate the FOV of the camera at calibrated resolutions.
  • The Web UI and PhotonLib now expose the pose ambiguity, allowing teams to throw out ambiguous estimations.
  • The 3D viewer now has a First Person (camera) view and a Third Person view.
  • Fixed some data mismatch in the targets table.
photonvision - v2023.1.1-beta-1

Published by github-actions[bot] about 2 years ago

AprilTag support

This release adds tracking support for AprilTags. PhotonVision can identify these square visual markers and produce a three-dimensional estimate of the transform between the camera and the marker. This new functionality will enable pose estimation out of the box as the 2023 game will feature the addition of AprilTags around the field.

This release is for use with 2022 WPILib, NOT the 2023 beta.

Note:

This is a beta release, so the docs are currently under development. The installation instructions are the same as usual and can be found here. For Pi 4 users, see the Known Issues section.

The Tags:

Per FIRST's announcement, the 2023 tags will be from the 36h11 family and will be 8.125 inches square, which means the black square is 6.5 inches across. The 200mm tags provided as PDFs here, when printed at 103% scale, match the dimensions nearly perfectly. These can be printed on a regular printer, but need to remain flat on a surface to be detected, with nothing inside the thin black border surrounding the tag. Clipboards work well for this.

Tips:

  • AprilTag detection is generally impervious to lighting conditions. A reasonably well lit environment can be helpful so the tags are visible. Hard-edge shadows falling partially across the tag are known to cause issues, however.
  • Increasing resolution on the "input" panel will increase detection distance, but decrease FPS. That's often a good tradeoff with these tags.
  • Calibrating your camera at your desired resolution is REQUIRED for the 3D pose estimation.

PhotonLib:

PhotonLib's API includes a way to get the 3D transform information of the tags. To do this, we have to bundle some features that will be part of 2023 WPILib. Those features are not quite finalized, so PhotonLib functionality and documentation is still somewhat unfinished.

Known issues:

  • GPU acceleration has been temporarily disabled to improve auto exposure performance -- a driver fix is expected before the 2023 season starts.
  • SimVisionSystem is not functional at all and might be replaced for 2023.
  • Some Pi4s will not run this Pi image. We're working on a fix to our image generator.
  • There is an issue with the Y rotation of the 3D transforms from pose estimation.

Community:

Join us on Discord for questions, feedback, suggestions, et cetera.

photonvision - v2022.2.0

Published by github-actions[bot] over 2 years ago

CRITICAL RELEASE!

Update your devices immediately!
This release includes potential fixes for two critical bugs:

  • Loss of pipeline/camera settings on power cycle.
  • Loss of connection after autonomous in competition environments

If you ARE having network issues

  • Try setting the RoboRIO to the static IP of 10.TE.AM.2 with a 255.255.255.0 subnet, and static IP via PhotonVision UI

What's Changed

Full Changelog: https://github.com/PhotonVision/photonvision/compare/v2022.1.6...v2022.2.0

Badges
Extracted from project README
CI codecov Discord
Related Projects
ChargedUp2023

Code for FRC Team 687's 2023 robot.

08 Jan 2023 10
Robot_Framework

03 Oct 2016 9