Visual Servoing Platform  version 3.6.1 under development (2024-04-26)
testMatrixPseudoInverse.cpp
1 /****************************************************************************
2  *
3  * ViSP, open source Visual Servoing Platform software.
4  * Copyright (C) 2005 - 2023 by Inria. All rights reserved.
5  *
6  * This software is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  * See the file LICENSE.txt at the root directory of this source
11  * distribution for additional information about the GNU GPL.
12  *
13  * For using ViSP with software that can not be combined with the GNU
14  * GPL, please contact Inria about acquiring a ViSP Professional
15  * Edition License.
16  *
17  * See https://visp.inria.fr for more information.
18  *
19  * This software was developed at:
20  * Inria Rennes - Bretagne Atlantique
21  * Campus Universitaire de Beaulieu
22  * 35042 Rennes Cedex
23  * France
24  *
25  * If you have questions regarding the use of this file, please contact
26  * Inria at visp@inria.fr
27  *
28  * This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
29  * WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
30  *
31  * Description:
32  * Test various svd decompositions.
33  *
34 *****************************************************************************/
35 
41 #include <algorithm>
42 #include <stdio.h>
43 #include <stdlib.h>
44 #include <vector>
45 
46 #include <visp3/core/vpColVector.h>
47 #include <visp3/core/vpMatrix.h>
48 #include <visp3/core/vpTime.h>
49 #include <visp3/io/vpParseArgv.h>
50 
51 // List of allowed command line options
52 #define GETOPTARGS "cdn:i:pf:R:C:vh"
53 
62 void usage(const char *name, const char *badparam)
63 {
64  fprintf(stdout, "\n\
65 Test matrix pseudo-inverse.\n\
66 Outputs a comparison of the results obtained by supported 3rd parties.\n\
67 \n\
68 SYNOPSIS\n\
69  %s [-n <number of matrices>] [-f <plot filename>]\n\
70  [-R <number of rows>] [-C <number of columns>]\n\
71  [-i <number of iterations>] [-p] [-h]\n",
72  name);
73 
74  fprintf(stdout, "\n\
75 OPTIONS: Default\n\
76  -n <number of matrices> \n\
77  Number of matrices inverted during each test loop.\n\
78 \n\
79  -i <number of iterations> \n\
80  Number of iterations of the test.\n\
81 \n\
82  -f <plot filename> \n\
83  Set output path for plot output.\n\
84  The plot logs the times of \n\
85  the different inversion methods: \n\
86  QR,LU,Cholesky and Pseudo-inverse.\n\
87 \n\
88  -R <number of rows>\n\
89  Number of rows of the automatically generated matrices \n\
90  we test on.\n\
91 \n\
92  -C <number of columns>\n\
93  Number of colums of the automatically generated matrices \n\
94  we test on.\n\
95 \n\
96  -p \n\
97  Plot into filename in the gnuplot format. \n\
98  If this option is used, tests results will be logged \n\
99  into a filename specified with -f.\n\
100 \n\
101  -h\n\
102  Print the help.\n\n");
103 
104  if (badparam) {
105  fprintf(stderr, "ERROR: \n");
106  fprintf(stderr, "\nBad parameter [%s]\n", badparam);
107  }
108 }
109 
117 bool getOptions(int argc, const char **argv, unsigned int &nb_matrices, unsigned int &nb_iterations,
118  bool &use_plot_file, std::string &plotfile, unsigned int &nbrows, unsigned int &nbcols, bool &verbose)
119 {
120  const char *optarg_;
121  int c;
122  while ((c = vpParseArgv::parse(argc, argv, GETOPTARGS, &optarg_)) > 1) {
123 
124  switch (c) {
125  case 'h':
126  usage(argv[0], nullptr);
127  return false;
128  break;
129  case 'n':
130  nb_matrices = (unsigned int)atoi(optarg_);
131  break;
132  case 'i':
133  nb_iterations = (unsigned int)atoi(optarg_);
134  break;
135  case 'f':
136  plotfile = optarg_;
137  use_plot_file = true;
138  break;
139  case 'p':
140  use_plot_file = true;
141  break;
142  case 'R':
143  nbrows = (unsigned int)atoi(optarg_);
144  break;
145  case 'C':
146  nbcols = (unsigned int)atoi(optarg_);
147  break;
148  case 'v':
149  verbose = true;
150  break;
151  // add default options -c -d
152  case 'c':
153  break;
154  case 'd':
155  break;
156  default:
157  usage(argv[0], optarg_);
158  return false;
159  break;
160  }
161  }
162 
163  if ((c == 1) || (c == -1)) {
164  // standalone param or error
165  usage(argv[0], nullptr);
166  std::cerr << "ERROR: " << std::endl;
167  std::cerr << " Bad argument " << optarg_ << std::endl << std::endl;
168  return false;
169  }
170 
171  return true;
172 }
173 
174 vpMatrix make_random_matrix(unsigned int nbrows, unsigned int nbcols)
175 {
176  vpMatrix A;
177  A.resize(nbrows, nbcols);
178 
179  for (unsigned int i = 0; i < A.getRows(); i++) {
180  for (unsigned int j = 0; j < A.getCols(); j++) {
181  A[i][j] = (double)rand() / (double)RAND_MAX;
182  }
183  }
184 
185  return A;
186 }
187 
188 void create_bench_random_matrix(unsigned int nb_matrices, unsigned int nb_rows, unsigned int nb_cols, bool verbose,
189  std::vector<vpMatrix> &bench)
190 {
191  if (verbose)
192  std::cout << "Create a bench of " << nb_matrices << " " << nb_rows << " by " << nb_cols << " matrices" << std::endl;
193  bench.clear();
194  for (unsigned int i = 0; i < nb_matrices; i++) {
195  vpMatrix M = make_random_matrix(nb_rows, nb_cols);
196  bench.push_back(M);
197  }
198 }
199 
200 int test_pseudo_inverse(const std::vector<vpMatrix> &A, const std::vector<vpMatrix> &Api)
201 {
202  double allowed_error = 1e-3;
203  double error = 0;
204  vpMatrix A_Api, Api_A;
205 
206  for (unsigned int i = 0; i < A.size(); i++) {
207  error = (A[i] * Api[i] * A[i] - A[i]).frobeniusNorm();
208  if (error > allowed_error) {
209  std::cout << "Bad pseudo-inverse [" << i << "] test A A^+ A = A: euclidean norm: " << error << std::endl;
210  return EXIT_FAILURE;
211  }
212  error = (Api[i] * A[i] * Api[i] - Api[i]).frobeniusNorm();
213  if (error > allowed_error) {
214  std::cout << "Bad pseudo-inverse [" << i << "] test A^+ A A^+ = A^+: euclidean norm: " << error << std::endl;
215  return EXIT_FAILURE;
216  }
217  A_Api = A[i] * Api[i];
218  error = (A_Api.transpose() - A_Api).frobeniusNorm();
219  if (error > allowed_error) {
220  std::cout << "Bad pseudo-inverse [" << i << "] test (A A^+)^T = A A^+: euclidean norm: " << error << std::endl;
221  return EXIT_FAILURE;
222  }
223  Api_A = Api[i] * A[i];
224  error = (Api_A.transpose() - Api_A).frobeniusNorm();
225  if (error > allowed_error) {
226  std::cout << "Bad pseudo-inverse [" << i << "] test (A^+ A )^T = A^+ A: euclidean norm: " << error << std::endl;
227  return EXIT_FAILURE;
228  }
229  }
230 
231  return EXIT_SUCCESS;
232 }
233 
234 int test_pseudo_inverse(const std::vector<vpMatrix> &A, const std::vector<vpMatrix> &Api,
235  const std::vector<vpColVector> &sv, const std::vector<vpMatrix> &imA,
236  const std::vector<vpMatrix> &imAt, const std::vector<vpMatrix> &kerAt)
237 {
238  double allowed_error = 1e-3;
239  // test Api
240  if (test_pseudo_inverse(A, Api) == EXIT_FAILURE) {
241  return EXIT_FAILURE;
242  }
243 
244  // test kerA
245  for (unsigned int i = 0; i < kerAt.size(); i++) {
246  if (kerAt[i].size()) {
247  vpMatrix nullspace = A[i] * kerAt[i].t();
248  double error = nullspace.frobeniusNorm();
249  if (error > allowed_error) {
250  std::cout << "Bad kernel [" << i << "]: euclidean norm: " << error << std::endl;
251  return EXIT_FAILURE;
252  }
253  }
254  }
255 
256  // test sv, imA, imAt, kerA
257  for (unsigned int i = 0; i < kerAt.size(); i++) {
258  unsigned int rank = imA[i].getCols();
259  vpMatrix U, S(rank, A[i].getCols()), Vt(A[i].getCols(), A[i].getCols());
260  U = imA[i];
261 
262  for (unsigned int j = 0; j < rank; j++)
263  S[j][j] = sv[i][j];
264 
265  Vt.insert(imAt[i].t(), 0, 0);
266  Vt.insert(kerAt[i], imAt[i].getCols(), 0);
267 
268  double error = (U * S * Vt - A[i]).frobeniusNorm();
269 
270  if (error > allowed_error) {
271  std::cout << "Bad imA, imAt, sv, kerAt [" << i << "]: euclidean norm: " << error << std::endl;
272  return EXIT_FAILURE;
273  }
274  }
275 
276  return EXIT_SUCCESS;
277 }
278 
279 int test_pseudo_inverse_default(bool verbose, const std::vector<vpMatrix> &bench, std::vector<double> &time)
280 {
281  if (verbose)
282  std::cout << "Test pseudo-inverse using default 3rd party" << std::endl;
283  if (verbose)
284  std::cout << " Pseudo-inverse on a " << bench[0].getRows() << "x" << bench[0].getCols() << " matrix" << std::endl;
285 
286  size_t size = bench.size();
287  std::vector<vpMatrix> PI(size), imA(size), imAt(size), kerAt(size);
288  std::vector<vpColVector> sv(size);
289  int ret = EXIT_SUCCESS;
290  time.clear();
291 
292  // test 1
293  double t = vpTime::measureTimeMs();
294  for (unsigned int i = 0; i < bench.size(); i++) {
295  PI[i] = bench[i].pseudoInverse();
296  }
297  time.push_back(vpTime::measureTimeMs() - t);
298  for (unsigned int i = 0; i < time.size(); i++) {
299  ret += test_pseudo_inverse(bench, PI);
300  }
301 
302  // test 2
303  t = vpTime::measureTimeMs();
304  for (unsigned int i = 0; i < bench.size(); i++) {
305  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
306  unsigned int rank = bench[i].pseudoInverse(PI[i]);
307  if (rank != rank_bench) {
308  if (verbose) {
309  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
310  }
311  ret += EXIT_FAILURE;
312  }
313  }
314  time.push_back(vpTime::measureTimeMs() - t);
315  for (unsigned int i = 0; i < time.size(); i++) {
316  ret += test_pseudo_inverse(bench, PI);
317  }
318 
319  // test 3
320  t = vpTime::measureTimeMs();
321  for (unsigned int i = 0; i < bench.size(); i++) {
322  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
323  unsigned int rank = bench[i].pseudoInverse(PI[i], sv[i]);
324  if (rank != rank_bench) {
325  if (verbose) {
326  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
327  }
328  ret += EXIT_FAILURE;
329  }
330  }
331  time.push_back(vpTime::measureTimeMs() - t);
332  for (unsigned int i = 0; i < time.size(); i++) {
333  ret += test_pseudo_inverse(bench, PI);
334  }
335 
336  // test 4
337  t = vpTime::measureTimeMs();
338  for (unsigned int i = 0; i < bench.size(); i++) {
339  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
340  unsigned int rank = bench[i].pseudoInverse(PI[i], sv[i], 1e-6, imA[i], imAt[i]);
341  if (rank != rank_bench) {
342  if (verbose) {
343  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
344  }
345  ret += EXIT_FAILURE;
346  }
347  }
348  time.push_back(vpTime::measureTimeMs() - t);
349  for (unsigned int i = 0; i < time.size(); i++) {
350  ret += test_pseudo_inverse(bench, PI);
351  }
352 
353  // test 5
354  t = vpTime::measureTimeMs();
355  for (unsigned int i = 0; i < bench.size(); i++) {
356  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
357  unsigned int rank = bench[i].pseudoInverse(PI[i], sv[i], 1e-6, imA[i], imAt[i], kerAt[i]);
358  if (rank != rank_bench) {
359  if (verbose) {
360  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
361  }
362  ret += EXIT_FAILURE;
363  }
364  }
365  time.push_back(vpTime::measureTimeMs() - t);
366  for (unsigned int i = 0; i < time.size(); i++) {
367  ret += test_pseudo_inverse(bench, PI, sv, imA, imAt, kerAt);
368  }
369 
370  //-------------------
371 
372  // test 6
373  t = vpTime::measureTimeMs();
374  for (unsigned int i = 0; i < bench.size(); i++) {
375  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
376  PI[i] = bench[i].pseudoInverse(static_cast<int>(rank_bench));
377  }
378  time.push_back(vpTime::measureTimeMs() - t);
379  for (unsigned int i = 0; i < time.size(); i++) {
380  ret += test_pseudo_inverse(bench, PI);
381  }
382 
383  // test 7
384  t = vpTime::measureTimeMs();
385  for (unsigned int i = 0; i < bench.size(); i++) {
386  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
387  unsigned int rank = bench[i].pseudoInverse(PI[i], static_cast<int>(rank_bench));
388  if (rank != rank_bench) {
389  if (verbose) {
390  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
391  }
392  ret += EXIT_FAILURE;
393  }
394  }
395  time.push_back(vpTime::measureTimeMs() - t);
396  for (unsigned int i = 0; i < time.size(); i++) {
397  ret += test_pseudo_inverse(bench, PI);
398  }
399 
400  // test 8
401  t = vpTime::measureTimeMs();
402  for (unsigned int i = 0; i < bench.size(); i++) {
403  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
404  unsigned int rank = bench[i].pseudoInverse(PI[i], sv[i], static_cast<int>(rank_bench));
405  if (rank != rank_bench) {
406  if (verbose) {
407  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
408  }
409  ret += EXIT_FAILURE;
410  }
411  }
412  time.push_back(vpTime::measureTimeMs() - t);
413  for (unsigned int i = 0; i < time.size(); i++) {
414  ret += test_pseudo_inverse(bench, PI);
415  }
416 
417  // test 9
418  t = vpTime::measureTimeMs();
419  for (unsigned int i = 0; i < bench.size(); i++) {
420  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
421  unsigned int rank = bench[i].pseudoInverse(PI[i], sv[i], static_cast<int>(rank_bench), imA[i], imAt[i]);
422  if (rank != rank_bench) {
423  if (verbose) {
424  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
425  }
426  ret += EXIT_FAILURE;
427  }
428  }
429  time.push_back(vpTime::measureTimeMs() - t);
430  for (unsigned int i = 0; i < time.size(); i++) {
431  ret += test_pseudo_inverse(bench, PI);
432  }
433 
434  // test 10
435  t = vpTime::measureTimeMs();
436  for (unsigned int i = 0; i < bench.size(); i++) {
437  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
438  unsigned int rank = bench[i].pseudoInverse(PI[i], sv[i], static_cast<int>(rank_bench), imA[i], imAt[i], kerAt[i]);
439  if (rank != rank_bench) {
440  if (verbose) {
441  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
442  }
443  ret += EXIT_FAILURE;
444  }
445  }
446  time.push_back(vpTime::measureTimeMs() - t);
447  for (unsigned int i = 0; i < time.size(); i++) {
448  ret += test_pseudo_inverse(bench, PI, sv, imA, imAt, kerAt);
449  }
450 
451  return ret;
452 }
453 
454 #if defined(VISP_HAVE_EIGEN3)
455 int test_pseudo_inverse_eigen3(bool verbose, const std::vector<vpMatrix> &bench, std::vector<double> &time)
456 {
457  if (verbose)
458  std::cout << "Test pseudo-inverse using Eigen3 3rd party" << std::endl;
459  if (verbose)
460  std::cout << " Pseudo-inverse on a " << bench[0].getRows() << "x" << bench[0].getCols() << " matrix" << std::endl;
461 
462  size_t size = bench.size();
463  std::vector<vpMatrix> PI(size), imA(size), imAt(size), kerAt(size);
464  std::vector<vpColVector> sv(size);
465  int ret = EXIT_SUCCESS;
466  time.clear();
467 
468  // test 1
469  double t = vpTime::measureTimeMs();
470  for (unsigned int i = 0; i < bench.size(); i++) {
471  PI[i] = bench[i].pseudoInverseEigen3();
472  }
473  time.push_back(vpTime::measureTimeMs() - t);
474  for (unsigned int i = 0; i < time.size(); i++) {
475  ret += test_pseudo_inverse(bench, PI);
476  }
477 
478  // test 2
479  t = vpTime::measureTimeMs();
480  for (unsigned int i = 0; i < bench.size(); i++) {
481  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
482  unsigned int rank = bench[i].pseudoInverseEigen3(PI[i]);
483  if (rank != rank_bench) {
484  if (verbose) {
485  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
486  }
487  ret += EXIT_FAILURE;
488  }
489  }
490  time.push_back(vpTime::measureTimeMs() - t);
491  for (unsigned int i = 0; i < time.size(); i++) {
492  ret += test_pseudo_inverse(bench, PI);
493  }
494 
495  // test 3
496  t = vpTime::measureTimeMs();
497  for (unsigned int i = 0; i < bench.size(); i++) {
498  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
499  unsigned int rank = bench[i].pseudoInverseEigen3(PI[i], sv[i]);
500  if (rank != rank_bench) {
501  if (verbose) {
502  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
503  }
504  ret += EXIT_FAILURE;
505  }
506  }
507  time.push_back(vpTime::measureTimeMs() - t);
508  for (unsigned int i = 0; i < time.size(); i++) {
509  ret += test_pseudo_inverse(bench, PI);
510  }
511 
512  // test 4
513  t = vpTime::measureTimeMs();
514  for (unsigned int i = 0; i < bench.size(); i++) {
515  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
516  unsigned int rank = bench[i].pseudoInverseEigen3(PI[i], sv[i], 1e-6, imA[i], imAt[i], kerAt[i]);
517  if (rank != rank_bench) {
518  if (verbose) {
519  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
520  }
521  ret += EXIT_FAILURE;
522  }
523  }
524  time.push_back(vpTime::measureTimeMs() - t);
525  for (unsigned int i = 0; i < time.size(); i++) {
526  ret += test_pseudo_inverse(bench, PI, sv, imA, imAt, kerAt);
527  }
528 
529  //-------------------
530 
531  // test 5
532  t = vpTime::measureTimeMs();
533  for (unsigned int i = 0; i < bench.size(); i++) {
534  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
535  PI[i] = bench[i].pseudoInverseEigen3(static_cast<int>(rank_bench));
536  }
537  time.push_back(vpTime::measureTimeMs() - t);
538  for (unsigned int i = 0; i < time.size(); i++) {
539  ret += test_pseudo_inverse(bench, PI);
540  }
541 
542  // test 6
543  t = vpTime::measureTimeMs();
544  for (unsigned int i = 0; i < bench.size(); i++) {
545  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
546  unsigned int rank = bench[i].pseudoInverseEigen3(PI[i], static_cast<int>(rank_bench));
547  if (rank != rank_bench) {
548  if (verbose) {
549  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
550  }
551  ret += EXIT_FAILURE;
552  }
553  }
554  time.push_back(vpTime::measureTimeMs() - t);
555  for (unsigned int i = 0; i < time.size(); i++) {
556  ret += test_pseudo_inverse(bench, PI);
557  }
558 
559  // test 7
560  t = vpTime::measureTimeMs();
561  for (unsigned int i = 0; i < bench.size(); i++) {
562  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
563  unsigned int rank = bench[i].pseudoInverseEigen3(PI[i], sv[i], static_cast<int>(rank_bench));
564  if (rank != rank_bench) {
565  if (verbose) {
566  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
567  }
568  ret += EXIT_FAILURE;
569  }
570  }
571  time.push_back(vpTime::measureTimeMs() - t);
572  for (unsigned int i = 0; i < time.size(); i++) {
573  ret += test_pseudo_inverse(bench, PI);
574  }
575 
576  // test 8
577  t = vpTime::measureTimeMs();
578  for (unsigned int i = 0; i < bench.size(); i++) {
579  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
580  unsigned int rank = bench[i].pseudoInverseEigen3(PI[i], sv[i], static_cast<int>(rank_bench), imA[i], imAt[i], kerAt[i]);
581  if (rank != rank_bench) {
582  if (verbose) {
583  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
584  }
585  ret += EXIT_FAILURE;
586  }
587  }
588  time.push_back(vpTime::measureTimeMs() - t);
589 
590  for (unsigned int i = 0; i < time.size(); i++) {
591  ret += test_pseudo_inverse(bench, PI, sv, imA, imAt, kerAt);
592  }
593 
594  return ret;
595 }
596 #endif
597 
598 #if defined(VISP_HAVE_LAPACK)
599 int test_pseudo_inverse_lapack(bool verbose, const std::vector<vpMatrix> &bench, std::vector<double> &time)
600 {
601  if (verbose)
602  std::cout << "Test pseudo-inverse using Eigen3 3rd party" << std::endl;
603  if (verbose)
604  std::cout << " Pseudo-inverse on a " << bench[0].getRows() << "x" << bench[0].getCols() << " matrix" << std::endl;
605 
606  size_t size = bench.size();
607  std::vector<vpMatrix> PI(size), imA(size), imAt(size), kerAt(size);
608  std::vector<vpColVector> sv(size);
609  int ret = EXIT_SUCCESS;
610  time.clear();
611 
612  // test 1
613  double t = vpTime::measureTimeMs();
614  for (unsigned int i = 0; i < bench.size(); i++) {
615  PI[i] = bench[i].pseudoInverseLapack();
616  }
617  time.push_back(vpTime::measureTimeMs() - t);
618  for (unsigned int i = 0; i < time.size(); i++) {
619  ret += test_pseudo_inverse(bench, PI);
620  }
621 
622  // test 2
623  t = vpTime::measureTimeMs();
624  for (unsigned int i = 0; i < bench.size(); i++) {
625  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
626  unsigned int rank = bench[i].pseudoInverseLapack(PI[i]);
627  if (rank != rank_bench) {
628  if (verbose) {
629  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
630  }
631  ret += EXIT_FAILURE;
632  }
633  }
634  time.push_back(vpTime::measureTimeMs() - t);
635  for (unsigned int i = 0; i < time.size(); i++) {
636  ret += test_pseudo_inverse(bench, PI);
637  }
638 
639  // test 3
640  t = vpTime::measureTimeMs();
641  for (unsigned int i = 0; i < bench.size(); i++) {
642  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
643  unsigned int rank = bench[i].pseudoInverseLapack(PI[i], sv[i]);
644  if (rank != rank_bench) {
645  if (verbose) {
646  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
647  }
648  ret += EXIT_FAILURE;
649  }
650  }
651  time.push_back(vpTime::measureTimeMs() - t);
652  for (unsigned int i = 0; i < time.size(); i++) {
653  ret += test_pseudo_inverse(bench, PI);
654  }
655 
656  // test 4
657  t = vpTime::measureTimeMs();
658  for (unsigned int i = 0; i < bench.size(); i++) {
659  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
660  unsigned int rank = bench[i].pseudoInverseLapack(PI[i], sv[i], 1e-6, imA[i], imAt[i], kerAt[i]);
661  if (rank != rank_bench) {
662  if (verbose) {
663  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
664  }
665  ret += EXIT_FAILURE;
666  }
667  }
668  time.push_back(vpTime::measureTimeMs() - t);
669  for (unsigned int i = 0; i < time.size(); i++) {
670  ret += test_pseudo_inverse(bench, PI, sv, imA, imAt, kerAt);
671  }
672 
673  //-------------------
674 
675  // test 5
676  t = vpTime::measureTimeMs();
677  for (unsigned int i = 0; i < bench.size(); i++) {
678  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
679  PI[i] = bench[i].pseudoInverseLapack(static_cast<int>(rank_bench));
680  }
681  time.push_back(vpTime::measureTimeMs() - t);
682  for (unsigned int i = 0; i < time.size(); i++) {
683  ret += test_pseudo_inverse(bench, PI);
684  }
685 
686  // test 6
687  t = vpTime::measureTimeMs();
688  for (unsigned int i = 0; i < bench.size(); i++) {
689  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
690  unsigned int rank = bench[i].pseudoInverseLapack(PI[i], static_cast<int>(rank_bench));
691  if (rank != rank_bench) {
692  if (verbose) {
693  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
694  }
695  ret += EXIT_FAILURE;
696  }
697  }
698  time.push_back(vpTime::measureTimeMs() - t);
699  for (unsigned int i = 0; i < time.size(); i++) {
700  ret += test_pseudo_inverse(bench, PI);
701  }
702 
703  // test 7
704  t = vpTime::measureTimeMs();
705  for (unsigned int i = 0; i < bench.size(); i++) {
706  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
707  unsigned int rank = bench[i].pseudoInverseLapack(PI[i], sv[i], static_cast<int>(rank_bench));
708  if (rank != rank_bench) {
709  if (verbose) {
710  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
711  }
712  ret += EXIT_FAILURE;
713  }
714  }
715  time.push_back(vpTime::measureTimeMs() - t);
716  for (unsigned int i = 0; i < time.size(); i++) {
717  ret += test_pseudo_inverse(bench, PI);
718  }
719 
720  // test 8
721  t = vpTime::measureTimeMs();
722  for (unsigned int i = 0; i < bench.size(); i++) {
723  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
724  unsigned int rank = bench[i].pseudoInverseLapack(PI[i], sv[i], static_cast<int>(rank_bench), imA[i], imAt[i], kerAt[i]);
725  if (rank != rank_bench) {
726  if (verbose) {
727  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
728  }
729  ret += EXIT_FAILURE;
730  }
731  }
732  time.push_back(vpTime::measureTimeMs() - t);
733 
734  for (unsigned int i = 0; i < time.size(); i++) {
735  ret += test_pseudo_inverse(bench, PI, sv, imA, imAt, kerAt);
736  }
737 
738  return ret;
739 }
740 #endif
741 
742 #if defined(VISP_HAVE_OPENCV)
743 int test_pseudo_inverse_opencv(bool verbose, const std::vector<vpMatrix> &bench, std::vector<double> &time)
744 {
745  if (verbose)
746  std::cout << "Test pseudo-inverse using OpenCV 3rd party" << std::endl;
747  if (verbose)
748  std::cout << " Pseudo-inverse on a " << bench[0].getRows() << "x" << bench[0].getCols() << " matrix" << std::endl;
749 
750  size_t size = bench.size();
751  std::vector<vpMatrix> PI(size), imA(size), imAt(size), kerAt(size);
752  std::vector<vpColVector> sv(size);
753  int ret = EXIT_SUCCESS;
754  time.clear();
755 
756  // test 1
757  double t = vpTime::measureTimeMs();
758  for (unsigned int i = 0; i < bench.size(); i++) {
759  PI[i] = bench[i].pseudoInverseOpenCV();
760  }
761  time.push_back(vpTime::measureTimeMs() - t);
762  for (unsigned int i = 0; i < time.size(); i++) {
763  ret += test_pseudo_inverse(bench, PI);
764  }
765 
766  // test 2
767  t = vpTime::measureTimeMs();
768  for (unsigned int i = 0; i < bench.size(); i++) {
769  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
770  unsigned int rank = bench[i].pseudoInverseOpenCV(PI[i]);
771  if (rank != rank_bench) {
772  if (verbose) {
773  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
774  }
775  ret += EXIT_FAILURE;
776  }
777  }
778  time.push_back(vpTime::measureTimeMs() - t);
779  for (unsigned int i = 0; i < time.size(); i++) {
780  ret += test_pseudo_inverse(bench, PI);
781  }
782 
783  // test 3
784  t = vpTime::measureTimeMs();
785  for (unsigned int i = 0; i < bench.size(); i++) {
786  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
787  unsigned int rank = bench[i].pseudoInverseOpenCV(PI[i], sv[i]);
788  if (rank != rank_bench) {
789  if (verbose) {
790  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
791  }
792  ret += EXIT_FAILURE;
793  }
794  }
795  time.push_back(vpTime::measureTimeMs() - t);
796  for (unsigned int i = 0; i < time.size(); i++) {
797  ret += test_pseudo_inverse(bench, PI);
798  }
799 
800  // test 4
801  t = vpTime::measureTimeMs();
802  for (unsigned int i = 0; i < bench.size(); i++) {
803  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
804  unsigned int rank = bench[i].pseudoInverseOpenCV(PI[i], sv[i], 1e-6, imA[i], imAt[i], kerAt[i]);
805  if (rank != rank_bench) {
806  if (verbose) {
807  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
808  }
809  ret += EXIT_FAILURE;
810  }
811  }
812  time.push_back(vpTime::measureTimeMs() - t);
813  for (unsigned int i = 0; i < time.size(); i++) {
814  ret += test_pseudo_inverse(bench, PI, sv, imA, imAt, kerAt);
815  }
816  //-------------------
817 
818  // test 5
819  t = vpTime::measureTimeMs();
820  for (unsigned int i = 0; i < bench.size(); i++) {
821  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
822  PI[i] = bench[i].pseudoInverseOpenCV(static_cast<int>(rank_bench));
823  }
824  time.push_back(vpTime::measureTimeMs() - t);
825  for (unsigned int i = 0; i < time.size(); i++) {
826  ret += test_pseudo_inverse(bench, PI);
827  }
828 
829  // test 6
830  t = vpTime::measureTimeMs();
831  for (unsigned int i = 0; i < bench.size(); i++) {
832  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
833  unsigned int rank = bench[i].pseudoInverseOpenCV(PI[i], static_cast<int>(rank_bench));
834  if (rank != rank_bench) {
835  if (verbose) {
836  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
837  }
838  ret += EXIT_FAILURE;
839  }
840  }
841  time.push_back(vpTime::measureTimeMs() - t);
842  for (unsigned int i = 0; i < time.size(); i++) {
843  ret += test_pseudo_inverse(bench, PI);
844  }
845 
846  // test 7
847  t = vpTime::measureTimeMs();
848  for (unsigned int i = 0; i < bench.size(); i++) {
849  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
850  unsigned int rank = bench[i].pseudoInverseOpenCV(PI[i], sv[i], static_cast<int>(rank_bench));
851  if (rank != rank_bench) {
852  if (verbose) {
853  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
854  }
855  ret += EXIT_FAILURE;
856  }
857  }
858  time.push_back(vpTime::measureTimeMs() - t);
859  for (unsigned int i = 0; i < time.size(); i++) {
860  ret += test_pseudo_inverse(bench, PI);
861  }
862 
863  // test 8
864  t = vpTime::measureTimeMs();
865  for (unsigned int i = 0; i < bench.size(); i++) {
866  unsigned int rank_bench = std::min(bench[i].getRows(), bench[i].getCols());
867  unsigned int rank = bench[i].pseudoInverseOpenCV(PI[i], sv[i], static_cast<int>(rank_bench), imA[i], imAt[i], kerAt[i]);
868  if (rank != rank_bench) {
869  if (verbose) {
870  std::cout << " Error in the rank (" << rank << ")" << " while expected rank is " << rank_bench << std::endl;
871  }
872  ret += EXIT_FAILURE;
873  }
874  }
875  time.push_back(vpTime::measureTimeMs() - t);
876 
877  for (unsigned int i = 0; i < time.size(); i++) {
878  ret += test_pseudo_inverse(bench, PI, sv, imA, imAt, kerAt);
879  }
880 
881  return ret;
882 }
883 #endif
884 
885 void save_time(const std::string &method, unsigned int nrows, unsigned int ncols, bool verbose, bool use_plot_file,
886  std::ofstream &of, const std::vector<double> &time)
887 {
888  for (size_t i = 0; i < time.size(); i++) {
889  if (use_plot_file)
890  of << time[i] << "\t";
891  if (verbose) {
892  std::cout << " " << method << " pseudo inverse (" << nrows << "x" << ncols << ")"
893  << " time test " << i << ": " << time[i] << std::endl;
894  }
895  }
896 }
897 
898 int main(int argc, const char *argv[])
899 {
900  try {
901 #if defined(VISP_HAVE_EIGEN3) || defined(VISP_HAVE_LAPACK) || defined(VISP_HAVE_OPENCV)
902  unsigned int nb_matrices = 10;
903  unsigned int nb_iterations = 10;
904  unsigned int nb_rows = 12;
905  unsigned int nb_cols = 6;
906  bool verbose = false;
907  std::string plotfile("plot-pseudo-inv.csv");
908  bool use_plot_file = false;
909  std::ofstream of;
910 
911  unsigned int nb_svd_functions = 4; // 4 tests for each existing vpMatrix::pseudoInverse(...) functions
912  unsigned int nb_test_matrix_size = 3; // 3 tests: m > n, m = n, m < n
913  std::vector<double> time(nb_svd_functions);
914  std::vector<unsigned int> nrows(nb_test_matrix_size), ncols(nb_test_matrix_size);
915 
916  // Read the command line options
917  if (getOptions(argc, argv, nb_matrices, nb_iterations, use_plot_file, plotfile, nb_rows, nb_cols, verbose) ==
918  false) {
919  return EXIT_FAILURE;
920  }
921 
922  for (unsigned int s = 0; s < nb_test_matrix_size; s++) {
923  // consider m > n, m = n, m < n
924  if (s == 0) {
925  nrows[s] = nb_rows;
926  ncols[s] = nb_cols;
927  }
928  else if (s == 1) {
929  nrows[s] = nb_cols;
930  ncols[s] = nb_cols;
931  }
932  else {
933  nrows[s] = nb_cols;
934  ncols[s] = nb_rows;
935  }
936  }
937 
938  if (use_plot_file) {
939  of.open(plotfile.c_str());
940  of << "iter"
941  << "\t";
942 
943  for (unsigned int s = 0; s < nb_test_matrix_size; s++) {
944  for (unsigned int i = 0; i < nb_svd_functions; i++)
945  of << "\"default " << nrows[s] << "x" << ncols[s] << " test " << i << "\""
946  << "\t";
947 
948 #if defined(VISP_HAVE_LAPACK)
949  for (unsigned int i = 0; i < nb_svd_functions; i++)
950  of << "\"Lapack " << nrows[s] << "x" << ncols[s] << " test " << i << "\""
951  << "\t";
952 #endif
953 #if defined(VISP_HAVE_EIGEN3)
954  for (unsigned int i = 0; i < nb_svd_functions; i++)
955  of << "\"Eigen3 " << nrows[s] << "x" << ncols[s] << " test " << i << "\""
956  << "\t";
957 #endif
958 #if defined(VISP_HAVE_OPENCV)
959  for (unsigned int i = 0; i < nb_svd_functions; i++)
960  of << "\"OpenCV " << nrows[s] << "x" << ncols[s] << " test " << i << "\""
961  << "\t";
962 #endif
963  }
964  of << std::endl;
965  }
966 
967  int ret_default = EXIT_SUCCESS;
968  int ret_lapack = EXIT_SUCCESS;
969  int ret_eigen3 = EXIT_SUCCESS;
970  int ret_opencv = EXIT_SUCCESS;
971 
972  for (unsigned int iter = 0; iter < nb_iterations; iter++) {
973 
974  if (use_plot_file)
975  of << iter << "\t";
976 
977  for (unsigned int s = 0; s < nb_test_matrix_size; s++) {
978  std::vector<vpMatrix> bench_random_matrices;
979  create_bench_random_matrix(nb_matrices, nrows[s], ncols[s], verbose, bench_random_matrices);
980 
981  ret_default += test_pseudo_inverse_default(verbose, bench_random_matrices, time);
982  save_time("default -", nrows[s], ncols[s], verbose, use_plot_file, of, time);
983 
984 #if defined(VISP_HAVE_LAPACK)
985  ret_lapack += test_pseudo_inverse_lapack(verbose, bench_random_matrices, time);
986  save_time("Lapack -", nrows[s], ncols[s], verbose, use_plot_file, of, time);
987 #endif
988 
989 #if defined(VISP_HAVE_EIGEN3)
990  ret_eigen3 += test_pseudo_inverse_eigen3(verbose, bench_random_matrices, time);
991  save_time("Eigen3 -", nrows[s], ncols[s], verbose, use_plot_file, of, time);
992 #endif
993 
994 #if defined(VISP_HAVE_OPENCV)
995  ret_opencv += test_pseudo_inverse_opencv(verbose, bench_random_matrices, time);
996  save_time("OpenCV -", nrows[s], ncols[s], verbose, use_plot_file, of, time);
997 #endif
998  }
999  if (use_plot_file)
1000  of << std::endl;
1001  }
1002  if (use_plot_file) {
1003  of.close();
1004  std::cout << "Result saved in " << plotfile << std::endl;
1005  }
1006 
1007  std::cout << "Resume testing:" << std::endl;
1008  std::cout << " Pseudo-inverse (default): " << (ret_default ? "failed" : "success") << std::endl;
1009 #if defined(VISP_HAVE_LAPACK)
1010  std::cout << " Pseudo-inverse (lapack) : " << (ret_lapack ? "failed" : "success") << std::endl;
1011 #endif
1012 #if defined(VISP_HAVE_EIGEN3)
1013  std::cout << " Pseudo-inverse (eigen3) : " << (ret_eigen3 ? "failed" : "success") << std::endl;
1014 #endif
1015 #if defined(VISP_HAVE_OPENCV)
1016  std::cout << " Pseudo-inverse (opencv) : " << (ret_opencv ? "failed" : "success") << std::endl;
1017 #endif
1018 
1019  int ret = ret_default + ret_lapack + ret_eigen3 + ret_opencv;
1020 
1021  std::cout << " Global test : " << (ret ? "failed" : "success") << std::endl;
1022 
1023  return ret;
1024 #else
1025  (void)argc;
1026  (void)argv;
1027  std::cout << "Test does nothing since you dont't have Lapack, Eigen3 or OpenCV 3rd party" << std::endl;
1028  return EXIT_SUCCESS;
1029 #endif
1030  }
1031  catch (const vpException &e) {
1032  std::cout << "Catch an exception: " << e.getStringMessage() << std::endl;
1033  return EXIT_FAILURE;
1034  }
1035 }
unsigned int getCols() const
Definition: vpArray2D.h:327
void resize(unsigned int nrows, unsigned int ncols, bool flagNullify=true, bool recopy_=true)
Definition: vpArray2D.h:352
unsigned int getRows() const
Definition: vpArray2D.h:337
error that can be emitted by ViSP classes.
Definition: vpException.h:59
const std::string & getStringMessage() const
Definition: vpException.cpp:66
Implementation of a matrix and operations on matrices.
Definition: vpMatrix.h:146
vpMatrix t() const
Definition: vpMatrix.cpp:465
double frobeniusNorm() const
Definition: vpMatrix.cpp:6514
void insert(const vpMatrix &A, unsigned int r, unsigned int c)
Definition: vpMatrix.cpp:5781
vpMatrix transpose() const
Definition: vpMatrix.cpp:472
static bool parse(int *argcPtr, const char **argv, vpArgvInfo *argTable, int flags)
Definition: vpParseArgv.cpp:69
VISP_EXPORT double measureTimeMs()