blob: 66c76dd1d30cfbef36491a914cabb68a3b15ee12 [file] [log] [blame]
Brian Silverman4770c7d2020-02-17 20:34:42 -08001#include <opencv2/calib3d.hpp>
Brian Silverman967e5df2020-02-09 16:43:34 -08002#include <opencv2/features2d.hpp>
3#include <opencv2/imgproc.hpp>
4
Brian Silverman9dd793b2020-01-31 23:52:21 -08005#include "aos/events/shm_event_loop.h"
Brian Silverman4770c7d2020-02-17 20:34:42 -08006#include "aos/flatbuffer_merge.h"
Brian Silverman9dd793b2020-01-31 23:52:21 -08007#include "aos/init.h"
Brian Silverman4770c7d2020-02-17 20:34:42 -08008#include "aos/network/team_number.h"
Brian Silverman967e5df2020-02-09 16:43:34 -08009#include "y2020/vision/sift/sift971.h"
10#include "y2020/vision/sift/sift_generated.h"
11#include "y2020/vision/sift/sift_training_generated.h"
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -080012#include "y2020/vision/tools/python_code/sift_training_data.h"
Brian Silverman9dd793b2020-01-31 23:52:21 -080013#include "y2020/vision/v4l2_reader.h"
Brian Silverman967e5df2020-02-09 16:43:34 -080014#include "y2020/vision/vision_generated.h"
Brian Silverman9dd793b2020-01-31 23:52:21 -080015
Jim Ostrowski8565b402020-02-29 20:26:53 -080016// config used to allow running camera_reader independently. E.g.,
17// bazel run //y2020/vision:camera_reader -- --config y2020/config.json
18// --override_hostname pi-7971-1 --ignore_timestamps true
19DEFINE_string(config, "config.json", "Path to the config file to use.");
Austin Schuh7256aea2020-03-28 18:06:46 -070020DEFINE_bool(skip_sift, false,
21 "If true don't run any feature extraction. Just forward images.");
Jim Ostrowski39b4f0a2021-08-28 15:43:01 -070022DEFINE_bool(ransac_pose, false,
23 "If true, do pose estimate with RANSAC; else, use ITERATIVE mode.");
Jim Ostrowski3a193482021-09-11 13:21:42 -070024DEFINE_bool(use_prev_pose, true,
25 "If true, use previous pose estimate as seed for next estimate.");
Jim Ostrowski8565b402020-02-29 20:26:53 -080026
Brian Silverman9dd793b2020-01-31 23:52:21 -080027namespace frc971 {
28namespace vision {
29namespace {
30
Brian Silverman967e5df2020-02-09 16:43:34 -080031class CameraReader {
32 public:
33 CameraReader(aos::EventLoop *event_loop,
34 const sift::TrainingData *training_data, V4L2Reader *reader,
35 cv::FlannBasedMatcher *matcher)
36 : event_loop_(event_loop),
37 training_data_(training_data),
Brian Silverman4770c7d2020-02-17 20:34:42 -080038 camera_calibration_(FindCameraCalibration()),
Brian Silverman967e5df2020-02-09 16:43:34 -080039 reader_(reader),
40 matcher_(matcher),
41 image_sender_(event_loop->MakeSender<CameraImage>("/camera")),
42 result_sender_(
43 event_loop->MakeSender<sift::ImageMatchResult>("/camera")),
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -080044 detailed_result_sender_(
45 event_loop->MakeSender<sift::ImageMatchResult>("/camera/detailed")),
Jim Ostrowski3a193482021-09-11 13:21:42 -070046 read_image_timer_(event_loop->AddTimer([this]() { ReadImage(); })),
47 prev_R_camera_field_vec_(cv::Mat::zeros(3, 1, CV_32F)),
48 prev_T_camera_field_(cv::Mat::zeros(3, 1, CV_32F)) {
Brian Silverman967e5df2020-02-09 16:43:34 -080049 CopyTrainingFeatures();
50 // Technically we don't need to do this, but doing it now avoids the first
51 // match attempt being slow.
52 matcher_->train();
53
54 event_loop->OnRun(
55 [this]() { read_image_timer_->Setup(event_loop_->monotonic_now()); });
56 }
57
58 private:
Brian Silverman4770c7d2020-02-17 20:34:42 -080059 const sift::CameraCalibration *FindCameraCalibration() const;
60
Brian Silverman967e5df2020-02-09 16:43:34 -080061 // Copies the information from training_data_ into matcher_.
62 void CopyTrainingFeatures();
63 // Processes an image (including sending the results).
64 void ProcessImage(const CameraImage &image);
65 // Reads an image, and then performs all of our processing on it.
66 void ReadImage();
67
68 flatbuffers::Offset<
69 flatbuffers::Vector<flatbuffers::Offset<sift::ImageMatch>>>
70 PackImageMatches(flatbuffers::FlatBufferBuilder *fbb,
71 const std::vector<std::vector<cv::DMatch>> &matches);
72 flatbuffers::Offset<flatbuffers::Vector<flatbuffers::Offset<sift::Feature>>>
73 PackFeatures(flatbuffers::FlatBufferBuilder *fbb,
74 const std::vector<cv::KeyPoint> &keypoints,
75 const cv::Mat &descriptors);
76
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -080077 void SendImageMatchResult(const CameraImage &image,
78 const std::vector<cv::KeyPoint> &keypoints,
79 const cv::Mat &descriptors,
80 const std::vector<std::vector<cv::DMatch>> &matches,
81 const std::vector<cv::Mat> &camera_target_list,
Jim Ostrowskie4264262020-02-29 00:27:24 -080082 const std::vector<cv::Mat> &field_camera_list,
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -080083 const std::vector<cv::Point2f> &target_point_vector,
84 const std::vector<float> &target_radius_vector,
James Kuszmaulfac4ca62021-10-02 18:02:04 -070085 const std::vector<int> &training_image_indices,
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -080086 aos::Sender<sift::ImageMatchResult> *result_sender,
87 bool send_details);
88
Jim Ostrowski1075cac2020-02-29 15:18:13 -080089 // Returns the 2D (image) location for the specified training feature.
90 cv::Point2f Training2dPoint(int training_image_index,
91 int feature_index) const {
92 const float x = training_data_->images()
93 ->Get(training_image_index)
94 ->features()
95 ->Get(feature_index)
96 ->x();
97 const float y = training_data_->images()
98 ->Get(training_image_index)
99 ->features()
100 ->Get(feature_index)
101 ->y();
102 return cv::Point2f(x, y);
103 }
104
Brian Silverman4d4a70d2020-02-17 13:03:19 -0800105 // Returns the 3D location for the specified training feature.
Brian Silverman4770c7d2020-02-17 20:34:42 -0800106 cv::Point3f Training3dPoint(int training_image_index,
107 int feature_index) const {
Brian Silverman4d4a70d2020-02-17 13:03:19 -0800108 const sift::KeypointFieldLocation *const location =
109 training_data_->images()
110 ->Get(training_image_index)
111 ->features()
112 ->Get(feature_index)
113 ->field_location();
114 return cv::Point3f(location->x(), location->y(), location->z());
115 }
116
Brian Silverman4770c7d2020-02-17 20:34:42 -0800117 const sift::TransformationMatrix *FieldToTarget(int training_image_index) {
118 return training_data_->images()
119 ->Get(training_image_index)
120 ->field_to_target();
121 }
122
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -0800123 void TargetLocation(int training_image_index, cv::Point2f &target_location,
124 float &target_radius) {
125 target_location.x =
126 training_data_->images()->Get(training_image_index)->target_point_x();
127 target_location.y =
128 training_data_->images()->Get(training_image_index)->target_point_y();
129 target_radius = training_data_->images()
130 ->Get(training_image_index)
131 ->target_point_radius();
132 }
133
Brian Silverman4d4a70d2020-02-17 13:03:19 -0800134 int number_training_images() const {
135 return training_data_->images()->size();
136 }
137
Brian Silverman4770c7d2020-02-17 20:34:42 -0800138 cv::Mat CameraIntrinsics() const {
139 const cv::Mat result(3, 3, CV_32F,
140 const_cast<void *>(static_cast<const void *>(
141 camera_calibration_->intrinsics()->data())));
142 CHECK_EQ(result.total(), camera_calibration_->intrinsics()->size());
143 return result;
144 }
145
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800146 cv::Mat CameraDistCoeffs() const {
147 const cv::Mat result(5, 1, CV_32F,
148 const_cast<void *>(static_cast<const void *>(
149 camera_calibration_->dist_coeffs()->data())));
150 CHECK_EQ(result.total(), camera_calibration_->dist_coeffs()->size());
151 return result;
152 }
153
Brian Silverman967e5df2020-02-09 16:43:34 -0800154 aos::EventLoop *const event_loop_;
155 const sift::TrainingData *const training_data_;
Brian Silverman4770c7d2020-02-17 20:34:42 -0800156 const sift::CameraCalibration *const camera_calibration_;
Brian Silverman967e5df2020-02-09 16:43:34 -0800157 V4L2Reader *const reader_;
158 cv::FlannBasedMatcher *const matcher_;
159 aos::Sender<CameraImage> image_sender_;
160 aos::Sender<sift::ImageMatchResult> result_sender_;
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800161 aos::Sender<sift::ImageMatchResult> detailed_result_sender_;
Brian Silverman967e5df2020-02-09 16:43:34 -0800162 // We schedule this immediately to read an image. Having it on a timer means
163 // other things can run on the event loop in between.
164 aos::TimerHandler *const read_image_timer_;
165
Jim Ostrowski3a193482021-09-11 13:21:42 -0700166 // Storage for when we want to use the previous estimates of pose
167 cv::Mat prev_R_camera_field_vec_;
168 cv::Mat prev_T_camera_field_;
169
Brian Silverman967e5df2020-02-09 16:43:34 -0800170 const std::unique_ptr<frc971::vision::SIFT971_Impl> sift_{
171 new frc971::vision::SIFT971_Impl()};
172};
173
Brian Silverman4770c7d2020-02-17 20:34:42 -0800174const sift::CameraCalibration *CameraReader::FindCameraCalibration() const {
175 const std::string_view node_name = event_loop_->node()->name()->string_view();
176 const int team_number = aos::network::GetTeamNumber();
177 for (const sift::CameraCalibration *candidate :
178 *training_data_->camera_calibrations()) {
179 if (candidate->node_name()->string_view() != node_name) {
180 continue;
181 }
182 if (candidate->team_number() != team_number) {
183 continue;
184 }
185 return candidate;
186 }
187 LOG(FATAL) << ": Failed to find camera calibration for " << node_name
188 << " on " << team_number;
189}
190
Brian Silverman967e5df2020-02-09 16:43:34 -0800191void CameraReader::CopyTrainingFeatures() {
192 for (const sift::TrainingImage *training_image : *training_data_->images()) {
193 cv::Mat features(training_image->features()->size(), 128, CV_32F);
Jim Ostrowski38bb70b2020-02-21 20:46:10 -0800194 for (size_t i = 0; i < training_image->features()->size(); ++i) {
Brian Silverman967e5df2020-02-09 16:43:34 -0800195 const sift::Feature *feature_table = training_image->features()->Get(i);
Brian Silverman4770c7d2020-02-17 20:34:42 -0800196
197 // We don't need this information right now, but make sure it's here to
198 // avoid crashes that only occur when specific features are matched.
199 CHECK(feature_table->has_field_location());
200
Brian Silvermanf64b9bd2020-02-29 12:51:33 -0800201 const flatbuffers::Vector<uint8_t> *const descriptor =
Brian Silverman967e5df2020-02-09 16:43:34 -0800202 feature_table->descriptor();
203 CHECK_EQ(descriptor->size(), 128u) << ": Unsupported feature size";
Brian Silvermanf64b9bd2020-02-29 12:51:33 -0800204 const auto in_mat = cv::Mat(
205 1, descriptor->size(), CV_8U,
206 const_cast<void *>(static_cast<const void *>(descriptor->data())));
207 const auto out_mat = features(cv::Range(i, i + 1), cv::Range(0, 128));
208 in_mat.convertTo(out_mat, CV_32F);
Brian Silverman967e5df2020-02-09 16:43:34 -0800209 }
210 matcher_->add(features);
211 }
212}
213
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800214void CameraReader::SendImageMatchResult(
215 const CameraImage &image, const std::vector<cv::KeyPoint> &keypoints,
216 const cv::Mat &descriptors,
217 const std::vector<std::vector<cv::DMatch>> &matches,
218 const std::vector<cv::Mat> &camera_target_list,
Jim Ostrowskie4264262020-02-29 00:27:24 -0800219 const std::vector<cv::Mat> &field_camera_list,
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -0800220 const std::vector<cv::Point2f> &target_point_vector,
221 const std::vector<float> &target_radius_vector,
James Kuszmaulfac4ca62021-10-02 18:02:04 -0700222 const std::vector<int> &training_image_indices,
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800223 aos::Sender<sift::ImageMatchResult> *result_sender, bool send_details) {
224 auto builder = result_sender->MakeBuilder();
Brian Silverman4770c7d2020-02-17 20:34:42 -0800225 const auto camera_calibration_offset =
Austin Schuhfa5ee952020-11-21 17:26:00 -0800226 aos::RecursiveCopyFlatBuffer(camera_calibration_, builder.fbb());
Brian Silverman4770c7d2020-02-17 20:34:42 -0800227
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800228 flatbuffers::Offset<flatbuffers::Vector<flatbuffers::Offset<sift::Feature>>>
229 features_offset;
Austin Schuh6f3640a2020-02-28 22:13:36 -0800230 flatbuffers::Offset<
231 flatbuffers::Vector<flatbuffers::Offset<sift::ImageMatch>>>
232 image_matches_offset;
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800233 if (send_details) {
234 features_offset = PackFeatures(builder.fbb(), keypoints, descriptors);
Austin Schuh6f3640a2020-02-28 22:13:36 -0800235 image_matches_offset = PackImageMatches(builder.fbb(), matches);
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800236 }
237
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800238 std::vector<flatbuffers::Offset<sift::CameraPose>> camera_poses;
239
Jim Ostrowskie4264262020-02-29 00:27:24 -0800240 CHECK_EQ(camera_target_list.size(), field_camera_list.size());
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800241 for (size_t i = 0; i < camera_target_list.size(); ++i) {
242 cv::Mat camera_target = camera_target_list[i];
243 CHECK(camera_target.isContinuous());
244 const auto data_offset = builder.fbb()->CreateVector<float>(
245 reinterpret_cast<float *>(camera_target.data), camera_target.total());
Austin Schuh6f3640a2020-02-28 22:13:36 -0800246 const flatbuffers::Offset<sift::TransformationMatrix> transform_offset =
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800247 sift::CreateTransformationMatrix(*builder.fbb(), data_offset);
Jim Ostrowskie4264262020-02-29 00:27:24 -0800248
249 cv::Mat field_camera = field_camera_list[i];
250 CHECK(field_camera.isContinuous());
251 const auto fc_data_offset = builder.fbb()->CreateVector<float>(
252 reinterpret_cast<float *>(field_camera.data), field_camera.total());
253 const flatbuffers::Offset<sift::TransformationMatrix> fc_transform_offset =
254 sift::CreateTransformationMatrix(*builder.fbb(), fc_data_offset);
255
Austin Schuh6f3640a2020-02-28 22:13:36 -0800256 const flatbuffers::Offset<sift::TransformationMatrix>
James Kuszmaulfac4ca62021-10-02 18:02:04 -0700257 field_to_target_offset = aos::RecursiveCopyFlatBuffer(
258 FieldToTarget(training_image_indices[i]), builder.fbb());
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800259
260 sift::CameraPose::Builder pose_builder(*builder.fbb());
261 pose_builder.add_camera_to_target(transform_offset);
Jim Ostrowskie4264262020-02-29 00:27:24 -0800262 pose_builder.add_field_to_camera(fc_transform_offset);
Austin Schuh6f3640a2020-02-28 22:13:36 -0800263 pose_builder.add_field_to_target(field_to_target_offset);
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -0800264 pose_builder.add_query_target_point_x(target_point_vector[i].x);
265 pose_builder.add_query_target_point_y(target_point_vector[i].y);
266 pose_builder.add_query_target_point_radius(target_radius_vector[i]);
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800267 camera_poses.emplace_back(pose_builder.Finish());
268 }
269 const auto camera_poses_offset = builder.fbb()->CreateVector(camera_poses);
270
271 sift::ImageMatchResult::Builder result_builder(*builder.fbb());
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800272 result_builder.add_camera_poses(camera_poses_offset);
273 if (send_details) {
Austin Schuh6f3640a2020-02-28 22:13:36 -0800274 result_builder.add_image_matches(image_matches_offset);
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800275 result_builder.add_features(features_offset);
276 }
277 result_builder.add_image_monotonic_timestamp_ns(
278 image.monotonic_timestamp_ns());
279 result_builder.add_camera_calibration(camera_calibration_offset);
280
281 // TODO<Jim>: Need to add target point computed from matches and
282 // mapped by homography
283 builder.Send(result_builder.Finish());
284}
285
286void CameraReader::ProcessImage(const CameraImage &image) {
Brian Silverman967e5df2020-02-09 16:43:34 -0800287 // First, we need to extract the brightness information. This can't really be
288 // fused into the beginning of the SIFT algorithm because the algorithm needs
289 // to look at the base image directly. It also only takes 2ms on our images.
290 // This is converting from YUYV to a grayscale image.
Jim Ostrowski38bb70b2020-02-21 20:46:10 -0800291 cv::Mat image_mat(image.rows(), image.cols(), CV_8U);
Brian Silverman967e5df2020-02-09 16:43:34 -0800292 CHECK(image_mat.isContinuous());
293 const int number_pixels = image.rows() * image.cols();
294 for (int i = 0; i < number_pixels; ++i) {
295 reinterpret_cast<uint8_t *>(image_mat.data)[i] =
296 image.data()->data()[i * 2];
297 }
298
299 // Next, grab the features from the image.
300 std::vector<cv::KeyPoint> keypoints;
Austin Schuh7256aea2020-03-28 18:06:46 -0700301
Brian Silverman967e5df2020-02-09 16:43:34 -0800302 cv::Mat descriptors;
Austin Schuh7256aea2020-03-28 18:06:46 -0700303 if (!FLAGS_skip_sift) {
304 sift_->detectAndCompute(image_mat, cv::noArray(), keypoints, descriptors);
305 }
Brian Silverman967e5df2020-02-09 16:43:34 -0800306
307 // Then, match those features against our training data.
308 std::vector<std::vector<cv::DMatch>> matches;
Austin Schuh7256aea2020-03-28 18:06:46 -0700309 if (!FLAGS_skip_sift) {
310 matcher_->knnMatch(/* queryDescriptors */ descriptors, matches, /* k */ 2);
311 }
Brian Silverman4770c7d2020-02-17 20:34:42 -0800312
313 struct PerImageMatches {
314 std::vector<const std::vector<cv::DMatch> *> matches;
315 std::vector<cv::Point3f> training_points_3d;
316 std::vector<cv::Point2f> query_points;
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800317 std::vector<cv::Point2f> training_points;
318 cv::Mat homography;
Brian Silverman4770c7d2020-02-17 20:34:42 -0800319 };
320 std::vector<PerImageMatches> per_image_matches(number_training_images());
321
322 // Pull out the good matches which we want for each image.
323 // Discard the bad matches per Lowe's ratio test.
324 // (Lowe originally proposed 0.7 ratio, but 0.75 was later proposed as a
325 // better option. We'll go with the more conservative (fewer, better matches)
326 // for now).
327 for (const std::vector<cv::DMatch> &match : matches) {
328 CHECK_EQ(2u, match.size());
329 CHECK_LE(match[0].distance, match[1].distance);
330 CHECK_LT(match[0].imgIdx, number_training_images());
331 CHECK_LT(match[1].imgIdx, number_training_images());
332 CHECK_EQ(match[0].queryIdx, match[1].queryIdx);
333 if (!(match[0].distance < 0.7 * match[1].distance)) {
334 continue;
335 }
336
337 const int training_image = match[0].imgIdx;
338 CHECK_LT(training_image, static_cast<int>(per_image_matches.size()));
339 PerImageMatches *const per_image = &per_image_matches[training_image];
340 per_image->matches.push_back(&match);
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800341 per_image->training_points.push_back(
342 Training2dPoint(training_image, match[0].trainIdx));
Brian Silverman4770c7d2020-02-17 20:34:42 -0800343 per_image->training_points_3d.push_back(
344 Training3dPoint(training_image, match[0].trainIdx));
345
346 const cv::KeyPoint &keypoint = keypoints[match[0].queryIdx];
347 per_image->query_points.push_back(keypoint.pt);
348 }
349
350 // The minimum number of matches in a training image for us to use it.
351 static constexpr int kMinimumMatchCount = 10;
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800352 std::vector<cv::Mat> camera_target_list;
Jim Ostrowskie4264262020-02-29 00:27:24 -0800353 std::vector<cv::Mat> field_camera_list;
Brian Silverman4770c7d2020-02-17 20:34:42 -0800354
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -0800355 // Rebuild the matches and store them here
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800356 std::vector<std::vector<cv::DMatch>> all_good_matches;
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -0800357 // Build list of target point and radius for each good match
358 std::vector<cv::Point2f> target_point_vector;
359 std::vector<float> target_radius_vector;
James Kuszmaulfac4ca62021-10-02 18:02:04 -0700360 std::vector<int> training_image_indices;
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -0800361
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800362 // Iterate through matches for each training image
Brian Silverman4770c7d2020-02-17 20:34:42 -0800363 for (size_t i = 0; i < per_image_matches.size(); ++i) {
364 const PerImageMatches &per_image = per_image_matches[i];
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800365
James Kuszmaulfac4ca62021-10-02 18:02:04 -0700366 VLOG(2) << "Number of matches to start: " << per_image.matches.size()
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800367 << "\n";
368 // If we don't have enough matches to start, skip this set of matches
Brian Silverman4770c7d2020-02-17 20:34:42 -0800369 if (per_image.matches.size() < kMinimumMatchCount) {
370 continue;
371 }
372
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800373 // Use homography to determine which matches make sense physically
374 cv::Mat mask;
375 cv::Mat homography =
376 cv::findHomography(per_image.training_points, per_image.query_points,
377 CV_RANSAC, 3.0, mask);
378
379 // If mask doesn't have enough leftover matches, skip these matches
380 if (cv::countNonZero(mask) < kMinimumMatchCount) {
381 continue;
382 }
383
384 VLOG(2) << "Number of matches after homography: " << cv::countNonZero(mask)
385 << "\n";
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -0800386
387 // Fill our match info for each good match based on homography result
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800388 PerImageMatches per_image_good_match;
389 CHECK_EQ(per_image.training_points.size(),
390 (unsigned long)mask.size().height);
391 for (size_t j = 0; j < per_image.matches.size(); j++) {
392 // Skip if we masked out by homography
393 if (mask.at<uchar>(0, j) != 1) {
394 continue;
395 }
396
397 // Add this to our collection of all matches that passed our criteria
398 all_good_matches.push_back(
399 static_cast<std::vector<cv::DMatch>>(*per_image.matches[j]));
400
401 // Fill out the data for matches per image that made it past
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -0800402 // homography check, for later use
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800403 per_image_good_match.matches.push_back(per_image.matches[j]);
404 per_image_good_match.training_points.push_back(
405 per_image.training_points[j]);
406 per_image_good_match.training_points_3d.push_back(
407 per_image.training_points_3d[j]);
408 per_image_good_match.query_points.push_back(per_image.query_points[j]);
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800409 }
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800410
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -0800411 // Returns from opencv are doubles (CV_64F), which don't play well
412 // with our floats
413 homography.convertTo(homography, CV_32F);
414 per_image_good_match.homography = homography;
415
416 CHECK_GT(per_image_good_match.matches.size(), 0u);
417
418 // Collect training target location, so we can map it to matched image
419 cv::Point2f target_point;
420 float target_radius;
421 TargetLocation((*(per_image_good_match.matches[0]))[0].imgIdx, target_point,
422 target_radius);
423
424 // Store target_point in vector for use by perspectiveTransform
425 std::vector<cv::Point2f> src_target_pt;
426 src_target_pt.push_back(target_point);
427 std::vector<cv::Point2f> query_target_pt;
428
429 cv::perspectiveTransform(src_target_pt, query_target_pt, homography);
430
431 float query_target_radius =
432 target_radius *
433 abs(homography.at<float>(0, 0) + homography.at<float>(1, 1)) / 2.;
434
435 CHECK_EQ(query_target_pt.size(), 1u);
436 target_point_vector.push_back(query_target_pt[0]);
437 target_radius_vector.push_back(query_target_radius);
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800438
439 // Pose transformations (rotations and translations) for various
440 // coordinate frames. R_X_Y_vec is the Rodrigues (angle-axis)
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -0800441 // representation of the 3x3 rotation R_X_Y from frame X to frame Y
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800442
Jim Ostrowskie4264262020-02-29 00:27:24 -0800443 // Tranform from camera to target frame
Jim Ostrowski295f2a12020-02-26 22:22:44 -0800444 cv::Mat R_camera_target_vec, R_camera_target, T_camera_target;
Jim Ostrowskie4264262020-02-29 00:27:24 -0800445 // Tranform from camera to field origin (global) reference frame
446 cv::Mat R_camera_field_vec, R_camera_field, T_camera_field;
447 // Inverse of camera to field-- defines location of camera in
448 // global (field) reference frame
449 cv::Mat R_field_camera_vec, R_field_camera, T_field_camera;
450
Jim Ostrowski3a193482021-09-11 13:21:42 -0700451 // Using the previous pose helps to stabilize the estimate, since
452 // it's sometimes bouncing between two possible poses. Putting it
453 // near the previous pose helps it converge to the previous pose
454 // estimate (assuming it's valid).
455 if (FLAGS_use_prev_pose) {
456 R_camera_field_vec = prev_R_camera_field_vec_;
457 T_camera_field = prev_T_camera_field_;
458 }
459
Jim Ostrowski295f2a12020-02-26 22:22:44 -0800460 // Compute the pose of the camera (global origin relative to camera)
Jim Ostrowski39b4f0a2021-08-28 15:43:01 -0700461 if (FLAGS_ransac_pose) {
462 // RANSAC computation is designed to be more robust to outliers.
463 // But, we found it bounces around a lot, even with identical points
464 cv::solvePnPRansac(per_image_good_match.training_points_3d,
465 per_image_good_match.query_points, CameraIntrinsics(),
Jim Ostrowski3a193482021-09-11 13:21:42 -0700466 CameraDistCoeffs(), R_camera_field_vec, T_camera_field,
467 FLAGS_use_prev_pose);
Jim Ostrowski39b4f0a2021-08-28 15:43:01 -0700468 } else {
469 // ITERATIVE mode is potentially less robust to outliers, but we
470 // found it to be more stable
471 //
Jim Ostrowski39b4f0a2021-08-28 15:43:01 -0700472 cv::solvePnP(per_image_good_match.training_points_3d,
473 per_image_good_match.query_points, CameraIntrinsics(),
474 CameraDistCoeffs(), R_camera_field_vec, T_camera_field,
Jim Ostrowski3a193482021-09-11 13:21:42 -0700475 FLAGS_use_prev_pose, CV_ITERATIVE);
Jim Ostrowski39b4f0a2021-08-28 15:43:01 -0700476 }
477
Jim Ostrowski3a193482021-09-11 13:21:42 -0700478 prev_R_camera_field_vec_ = R_camera_field_vec;
479 prev_T_camera_field_ = T_camera_field;
480
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800481 CHECK_EQ(cv::Size(1, 3), T_camera_field.size());
482
483 // Convert to float32's (from float64) to be compatible with the rest
484 R_camera_field_vec.convertTo(R_camera_field_vec, CV_32F);
485 T_camera_field.convertTo(T_camera_field, CV_32F);
Brian Silverman4770c7d2020-02-17 20:34:42 -0800486
Jim Ostrowskie4264262020-02-29 00:27:24 -0800487 // Get matrix version of R_camera_field
488 cv::Rodrigues(R_camera_field_vec, R_camera_field);
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800489 CHECK_EQ(cv::Size(3, 3), R_camera_field.size());
Jim Ostrowskie4264262020-02-29 00:27:24 -0800490
491 // Compute H_field_camera = H_camera_field^-1
492 R_field_camera = R_camera_field.t();
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800493 T_field_camera = -R_field_camera * (T_camera_field);
Jim Ostrowskie4264262020-02-29 00:27:24 -0800494
495 // Extract the field_target transformation
496 const cv::Mat H_field_target(4, 4, CV_32F,
497 const_cast<void *>(static_cast<const void *>(
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800498 FieldToTarget(i)->data()->data())));
499
James Kuszmaulfac4ca62021-10-02 18:02:04 -0700500 training_image_indices.push_back(i);
501
Jim Ostrowskie4264262020-02-29 00:27:24 -0800502 const cv::Mat R_field_target =
503 H_field_target(cv::Range(0, 3), cv::Range(0, 3));
504 const cv::Mat T_field_target =
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800505 H_field_target(cv::Range(0, 3), cv::Range(3, 4));
Jim Ostrowskie4264262020-02-29 00:27:24 -0800506
507 // Use it to get the relative pose from camera to target
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800508 R_camera_target = R_camera_field * (R_field_target);
509 T_camera_target = R_camera_field * (T_field_target) + T_camera_field;
Jim Ostrowskie4264262020-02-29 00:27:24 -0800510
511 // Set H_camera_target
Brian Silverman4770c7d2020-02-17 20:34:42 -0800512 {
Jim Ostrowski38bb70b2020-02-21 20:46:10 -0800513 CHECK_EQ(cv::Size(3, 3), R_camera_target.size());
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800514 CHECK_EQ(cv::Size(1, 3), T_camera_target.size());
515 cv::Mat H_camera_target = cv::Mat::zeros(4, 4, CV_32F);
516 R_camera_target.copyTo(H_camera_target(cv::Range(0, 3), cv::Range(0, 3)));
517 T_camera_target.copyTo(H_camera_target(cv::Range(0, 3), cv::Range(3, 4)));
518 H_camera_target.at<float>(3, 3) = 1;
519 CHECK(H_camera_target.isContinuous());
520 camera_target_list.push_back(H_camera_target.clone());
Jim Ostrowskie4264262020-02-29 00:27:24 -0800521 }
522
523 // Set H_field_camera
524 {
525 CHECK_EQ(cv::Size(3, 3), R_field_camera.size());
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800526 CHECK_EQ(cv::Size(1, 3), T_field_camera.size());
527 cv::Mat H_field_camera = cv::Mat::zeros(4, 4, CV_32F);
528 R_field_camera.copyTo(H_field_camera(cv::Range(0, 3), cv::Range(0, 3)));
529 T_field_camera.copyTo(H_field_camera(cv::Range(0, 3), cv::Range(3, 4)));
530 H_field_camera.at<float>(3, 3) = 1;
531 CHECK(H_field_camera.isContinuous());
532 field_camera_list.push_back(H_field_camera.clone());
Brian Silverman4770c7d2020-02-17 20:34:42 -0800533 }
Brian Silverman4770c7d2020-02-17 20:34:42 -0800534 }
Jim Ostrowskiad5d8a72020-02-28 00:15:26 -0800535 // Now, send our two messages-- one large, with details for remote
536 // debugging(features), and one smaller
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800537 SendImageMatchResult(image, keypoints, descriptors, all_good_matches,
Jim Ostrowskie4264262020-02-29 00:27:24 -0800538 camera_target_list, field_camera_list,
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -0800539 target_point_vector, target_radius_vector,
James Kuszmaulfac4ca62021-10-02 18:02:04 -0700540 training_image_indices, &detailed_result_sender_, true);
Jim Ostrowski1075cac2020-02-29 15:18:13 -0800541 SendImageMatchResult(image, keypoints, descriptors, all_good_matches,
Jim Ostrowski18f7fbf2020-03-01 13:53:22 -0800542 camera_target_list, field_camera_list,
543 target_point_vector, target_radius_vector,
James Kuszmaulfac4ca62021-10-02 18:02:04 -0700544 training_image_indices, &result_sender_, false);
Brian Silverman967e5df2020-02-09 16:43:34 -0800545}
546
547void CameraReader::ReadImage() {
548 if (!reader_->ReadLatestImage()) {
Austin Schuh7256aea2020-03-28 18:06:46 -0700549 if (!FLAGS_skip_sift) {
550 LOG(INFO) << "No image, sleeping";
551 }
552 read_image_timer_->Setup(event_loop_->monotonic_now() +
553 std::chrono::milliseconds(10));
Brian Silverman967e5df2020-02-09 16:43:34 -0800554 return;
555 }
556
557 ProcessImage(reader_->LatestImage());
558
559 reader_->SendLatestImage();
Austin Schuh7256aea2020-03-28 18:06:46 -0700560 read_image_timer_->Setup(event_loop_->monotonic_now());
Brian Silverman967e5df2020-02-09 16:43:34 -0800561}
562
563flatbuffers::Offset<flatbuffers::Vector<flatbuffers::Offset<sift::ImageMatch>>>
564CameraReader::PackImageMatches(
565 flatbuffers::FlatBufferBuilder *fbb,
566 const std::vector<std::vector<cv::DMatch>> &matches) {
567 // First, we need to pull out all the matches for each image. Might as well
568 // build up the Match tables at the same time.
Brian Silverman4d4a70d2020-02-17 13:03:19 -0800569 std::vector<std::vector<sift::Match>> per_image_matches(
570 number_training_images());
Brian Silverman967e5df2020-02-09 16:43:34 -0800571 for (const std::vector<cv::DMatch> &image_matches : matches) {
Jim Ostrowskice02ebe2020-03-07 20:39:02 -0800572 CHECK_GT(image_matches.size(), 0u);
573 // We're only using the first of the two matches
574 const cv::DMatch &image_match = image_matches[0];
575 CHECK_LT(image_match.imgIdx, number_training_images());
576 per_image_matches[image_match.imgIdx].emplace_back();
577 sift::Match *const match = &per_image_matches[image_match.imgIdx].back();
578 match->mutate_query_feature(image_match.queryIdx);
579 match->mutate_train_feature(image_match.trainIdx);
580 match->mutate_distance(image_match.distance);
Brian Silverman967e5df2020-02-09 16:43:34 -0800581 }
582
583 // Then, we need to build up each ImageMatch table.
584 std::vector<flatbuffers::Offset<sift::ImageMatch>> image_match_tables;
585 for (size_t i = 0; i < per_image_matches.size(); ++i) {
Brian Silverman4d4a70d2020-02-17 13:03:19 -0800586 const std::vector<sift::Match> &this_image_matches = per_image_matches[i];
Brian Silverman967e5df2020-02-09 16:43:34 -0800587 if (this_image_matches.empty()) {
588 continue;
589 }
Brian Silverman4d4a70d2020-02-17 13:03:19 -0800590 const auto vector_offset = fbb->CreateVectorOfStructs(this_image_matches);
Brian Silverman967e5df2020-02-09 16:43:34 -0800591 sift::ImageMatch::Builder image_builder(*fbb);
592 image_builder.add_train_image(i);
593 image_builder.add_matches(vector_offset);
594 image_match_tables.emplace_back(image_builder.Finish());
595 }
596
597 return fbb->CreateVector(image_match_tables);
598}
599
600flatbuffers::Offset<flatbuffers::Vector<flatbuffers::Offset<sift::Feature>>>
601CameraReader::PackFeatures(flatbuffers::FlatBufferBuilder *fbb,
602 const std::vector<cv::KeyPoint> &keypoints,
603 const cv::Mat &descriptors) {
604 const int number_features = keypoints.size();
605 CHECK_EQ(descriptors.rows, number_features);
Austin Schuh7256aea2020-03-28 18:06:46 -0700606 if (number_features != 0) {
607 CHECK_EQ(descriptors.cols, 128);
608 }
Brian Silverman967e5df2020-02-09 16:43:34 -0800609 std::vector<flatbuffers::Offset<sift::Feature>> features_vector(
610 number_features);
611 for (int i = 0; i < number_features; ++i) {
Brian Silvermanf64b9bd2020-02-29 12:51:33 -0800612 const auto submat =
613 descriptors(cv::Range(i, i + 1), cv::Range(0, descriptors.cols));
Brian Silverman967e5df2020-02-09 16:43:34 -0800614 CHECK(submat.isContinuous());
Brian Silvermanf64b9bd2020-02-29 12:51:33 -0800615 flatbuffers::Offset<flatbuffers::Vector<uint8_t>> descriptor_offset;
616 {
617 uint8_t *data;
618 descriptor_offset = fbb->CreateUninitializedVector(128, &data);
619 submat.convertTo(
620 cv::Mat(1, descriptors.cols, CV_8U, static_cast<void *>(data)),
621 CV_8U);
622 }
Brian Silverman967e5df2020-02-09 16:43:34 -0800623 sift::Feature::Builder feature_builder(*fbb);
624 feature_builder.add_descriptor(descriptor_offset);
625 feature_builder.add_x(keypoints[i].pt.x);
626 feature_builder.add_y(keypoints[i].pt.y);
627 feature_builder.add_size(keypoints[i].size);
628 feature_builder.add_angle(keypoints[i].angle);
629 feature_builder.add_response(keypoints[i].response);
630 feature_builder.add_octave(keypoints[i].octave);
631 CHECK_EQ(-1, keypoints[i].class_id)
632 << ": Not sure what to do with a class id";
633 features_vector[i] = feature_builder.Finish();
634 }
635 return fbb->CreateVector(features_vector);
636}
637
Brian Silverman9dd793b2020-01-31 23:52:21 -0800638void CameraReaderMain() {
639 aos::FlatbufferDetachedBuffer<aos::Configuration> config =
Jim Ostrowski8565b402020-02-29 20:26:53 -0800640 aos::configuration::ReadConfig(FLAGS_config);
Brian Silverman9dd793b2020-01-31 23:52:21 -0800641
Brian Silverman36c7f342021-06-11 15:21:41 -0700642 const aos::FlatbufferSpan<sift::TrainingData> training_data(
643 SiftTrainingData());
644 CHECK(training_data.Verify());
Brian Silverman967e5df2020-02-09 16:43:34 -0800645
646 const auto index_params = cv::makePtr<cv::flann::IndexParams>();
647 index_params->setAlgorithm(cvflann::FLANN_INDEX_KDTREE);
648 index_params->setInt("trees", 5);
649 const auto search_params =
650 cv::makePtr<cv::flann::SearchParams>(/* checks */ 50);
651 cv::FlannBasedMatcher matcher(index_params, search_params);
652
Brian Silverman9dd793b2020-01-31 23:52:21 -0800653 aos::ShmEventLoop event_loop(&config.message());
Brian Silverman62956e72020-02-26 21:04:05 -0800654
655 // First, log the data for future reference.
656 {
657 aos::Sender<sift::TrainingData> training_data_sender =
658 event_loop.MakeSender<sift::TrainingData>("/camera");
Brian Silverman36c7f342021-06-11 15:21:41 -0700659 training_data_sender.Send(training_data);
Brian Silverman62956e72020-02-26 21:04:05 -0800660 }
661
Brian Silverman9dd793b2020-01-31 23:52:21 -0800662 V4L2Reader v4l2_reader(&event_loop, "/dev/video0");
Brian Silverman36c7f342021-06-11 15:21:41 -0700663 CameraReader camera_reader(&event_loop, &training_data.message(),
664 &v4l2_reader, &matcher);
Brian Silverman9dd793b2020-01-31 23:52:21 -0800665
Brian Silverman967e5df2020-02-09 16:43:34 -0800666 event_loop.Run();
Brian Silverman9dd793b2020-01-31 23:52:21 -0800667}
668
669} // namespace
670} // namespace vision
671} // namespace frc971
672
Brian Silverman9dd793b2020-01-31 23:52:21 -0800673int main(int argc, char **argv) {
674 aos::InitGoogle(&argc, &argv);
675 frc971::vision::CameraReaderMain();
676}