From 1a5e49bbfeebbee772794b896f89cb59eaee228b Mon Sep 17 00:00:00 2001 From: yuntang <123@qq.com> Date: Wed, 4 Jun 2025 17:29:37 +0800 Subject: [PATCH] 2025-06-04T17:29:35 --- experiment_data/analysis_state/03-111.xlsx | Bin 0 -> 345416 bytes experiment_data/sample_data/03-111.xlsx | Bin 0 -> 345343 bytes .../sample_data/03-sampleName.xlsx | Bin 0 -> 345129 bytes src/DSCAnalysisTool.pro | 7 +- src/data/lowesssmoother.cpp | 119 + src/data/lowesssmoother.h | 38 + src/data/pointcalculate.cpp | 31 +- src/mainwindow.ui | 66 + src/thirdparty/eigen-3.4.0/Eigen/Cholesky | 45 + .../eigen-3.4.0/Eigen/CholmodSupport | 48 + src/thirdparty/eigen-3.4.0/Eigen/Core | 384 + src/thirdparty/eigen-3.4.0/Eigen/Dense | 7 + src/thirdparty/eigen-3.4.0/Eigen/Eigen | 2 + src/thirdparty/eigen-3.4.0/Eigen/Eigenvalues | 60 + src/thirdparty/eigen-3.4.0/Eigen/Geometry | 59 + src/thirdparty/eigen-3.4.0/Eigen/Householder | 29 + .../eigen-3.4.0/Eigen/IterativeLinearSolvers | 48 + src/thirdparty/eigen-3.4.0/Eigen/Jacobi | 32 + src/thirdparty/eigen-3.4.0/Eigen/KLUSupport | 41 + src/thirdparty/eigen-3.4.0/Eigen/LU | 47 + src/thirdparty/eigen-3.4.0/Eigen/MetisSupport | 35 + .../eigen-3.4.0/Eigen/OrderingMethods | 70 + .../eigen-3.4.0/Eigen/PaStiXSupport | 49 + .../eigen-3.4.0/Eigen/PardisoSupport | 35 + src/thirdparty/eigen-3.4.0/Eigen/QR | 50 + .../eigen-3.4.0/Eigen/QtAlignedMalloc | 39 + src/thirdparty/eigen-3.4.0/Eigen/SPQRSupport | 34 + src/thirdparty/eigen-3.4.0/Eigen/SVD | 50 + src/thirdparty/eigen-3.4.0/Eigen/Sparse | 34 + .../eigen-3.4.0/Eigen/SparseCholesky | 37 + src/thirdparty/eigen-3.4.0/Eigen/SparseCore | 69 + src/thirdparty/eigen-3.4.0/Eigen/SparseLU | 50 + src/thirdparty/eigen-3.4.0/Eigen/SparseQR | 36 + src/thirdparty/eigen-3.4.0/Eigen/StdDeque | 27 + src/thirdparty/eigen-3.4.0/Eigen/StdList | 26 + src/thirdparty/eigen-3.4.0/Eigen/StdVector | 27 + .../eigen-3.4.0/Eigen/SuperLUSupport | 64 + .../eigen-3.4.0/Eigen/UmfPackSupport | 40 + .../eigen-3.4.0/Eigen/src/Cholesky/LDLT.h | 688 + .../eigen-3.4.0/Eigen/src/Cholesky/LLT.h | 558 + .../Eigen/src/Cholesky/LLT_LAPACKE.h | 99 + .../Eigen/src/CholmodSupport/CholmodSupport.h | 682 + .../Eigen/src/Core/ArithmeticSequence.h | 413 + .../eigen-3.4.0/Eigen/src/Core/Array.h | 417 + .../eigen-3.4.0/Eigen/src/Core/ArrayBase.h | 226 + .../eigen-3.4.0/Eigen/src/Core/ArrayWrapper.h | 209 + .../eigen-3.4.0/Eigen/src/Core/Assign.h | 90 + .../Eigen/src/Core/AssignEvaluator.h | 1010 + .../eigen-3.4.0/Eigen/src/Core/Assign_MKL.h | 178 + .../eigen-3.4.0/Eigen/src/Core/BandMatrix.h | 353 + .../eigen-3.4.0/Eigen/src/Core/Block.h | 448 + .../eigen-3.4.0/Eigen/src/Core/BooleanRedux.h | 162 + .../Eigen/src/Core/CommaInitializer.h | 164 + .../Eigen/src/Core/ConditionEstimator.h | 175 + .../Eigen/src/Core/CoreEvaluators.h | 1741 ++ .../Eigen/src/Core/CoreIterators.h | 132 + .../Eigen/src/Core/CwiseBinaryOp.h | 183 + .../Eigen/src/Core/CwiseNullaryOp.h | 1001 + .../Eigen/src/Core/CwiseTernaryOp.h | 197 + .../eigen-3.4.0/Eigen/src/Core/CwiseUnaryOp.h | 103 + .../Eigen/src/Core/CwiseUnaryView.h | 132 + .../eigen-3.4.0/Eigen/src/Core/DenseBase.h | 701 + .../Eigen/src/Core/DenseCoeffsBase.h | 685 + .../eigen-3.4.0/Eigen/src/Core/DenseStorage.h | 652 + .../eigen-3.4.0/Eigen/src/Core/Diagonal.h | 258 + .../Eigen/src/Core/DiagonalMatrix.h | 391 + .../Eigen/src/Core/DiagonalProduct.h | 28 + .../eigen-3.4.0/Eigen/src/Core/Dot.h | 318 + .../eigen-3.4.0/Eigen/src/Core/EigenBase.h | 160 + .../Eigen/src/Core/ForceAlignedAccess.h | 150 + .../eigen-3.4.0/Eigen/src/Core/Fuzzy.h | 155 + .../Eigen/src/Core/GeneralProduct.h | 465 + .../Eigen/src/Core/GenericPacketMath.h | 1040 + .../Eigen/src/Core/GlobalFunctions.h | 194 + .../eigen-3.4.0/Eigen/src/Core/IO.h | 258 + .../eigen-3.4.0/Eigen/src/Core/IndexedView.h | 237 + .../eigen-3.4.0/Eigen/src/Core/Inverse.h | 117 + .../eigen-3.4.0/Eigen/src/Core/Map.h | 171 + .../eigen-3.4.0/Eigen/src/Core/MapBase.h | 310 + .../Eigen/src/Core/MathFunctions.h | 2057 ++ .../Eigen/src/Core/MathFunctionsImpl.h | 200 + .../eigen-3.4.0/Eigen/src/Core/Matrix.h | 565 + .../eigen-3.4.0/Eigen/src/Core/MatrixBase.h | 547 + .../eigen-3.4.0/Eigen/src/Core/NestByValue.h | 85 + .../eigen-3.4.0/Eigen/src/Core/NoAlias.h | 109 + .../eigen-3.4.0/Eigen/src/Core/NumTraits.h | 335 + .../Eigen/src/Core/PartialReduxEvaluator.h | 232 + .../Eigen/src/Core/PermutationMatrix.h | 605 + .../Eigen/src/Core/PlainObjectBase.h | 1128 ++ .../eigen-3.4.0/Eigen/src/Core/Product.h | 191 + .../Eigen/src/Core/ProductEvaluators.h | 1179 ++ .../eigen-3.4.0/Eigen/src/Core/Random.h | 218 + .../eigen-3.4.0/Eigen/src/Core/Redux.h | 515 + .../eigen-3.4.0/Eigen/src/Core/Ref.h | 381 + .../eigen-3.4.0/Eigen/src/Core/Replicate.h | 142 + .../eigen-3.4.0/Eigen/src/Core/Reshaped.h | 454 + .../Eigen/src/Core/ReturnByValue.h | 119 + .../eigen-3.4.0/Eigen/src/Core/Reverse.h | 217 + .../eigen-3.4.0/Eigen/src/Core/Select.h | 164 + .../Eigen/src/Core/SelfAdjointView.h | 365 + .../Eigen/src/Core/SelfCwiseBinaryOp.h | 47 + .../eigen-3.4.0/Eigen/src/Core/Solve.h | 188 + .../Eigen/src/Core/SolveTriangular.h | 235 + .../eigen-3.4.0/Eigen/src/Core/SolverBase.h | 168 + .../eigen-3.4.0/Eigen/src/Core/StableNorm.h | 251 + .../eigen-3.4.0/Eigen/src/Core/StlIterators.h | 463 + .../eigen-3.4.0/Eigen/src/Core/Stride.h | 116 + .../eigen-3.4.0/Eigen/src/Core/Swap.h | 68 + .../eigen-3.4.0/Eigen/src/Core/Transpose.h | 464 + .../Eigen/src/Core/Transpositions.h | 386 + .../Eigen/src/Core/TriangularMatrix.h | 1001 + .../eigen-3.4.0/Eigen/src/Core/VectorBlock.h | 96 + .../eigen-3.4.0/Eigen/src/Core/VectorwiseOp.h | 784 + .../eigen-3.4.0/Eigen/src/Core/Visitor.h | 381 + .../Eigen/src/Core/arch/AVX/Complex.h | 372 + .../Eigen/src/Core/arch/AVX/MathFunctions.h | 228 + .../Eigen/src/Core/arch/AVX/PacketMath.h | 1574 ++ .../Eigen/src/Core/arch/AVX/TypeCasting.h | 115 + .../Eigen/src/Core/arch/AVX512/Complex.h | 422 + .../src/Core/arch/AVX512/MathFunctions.h | 362 + .../Eigen/src/Core/arch/AVX512/PacketMath.h | 2303 +++ .../Eigen/src/Core/arch/AVX512/TypeCasting.h | 89 + .../Eigen/src/Core/arch/AltiVec/Complex.h | 417 + .../src/Core/arch/AltiVec/MathFunctions.h | 90 + .../src/Core/arch/AltiVec/MatrixProduct.h | 2937 +++ .../Core/arch/AltiVec/MatrixProductCommon.h | 221 + .../src/Core/arch/AltiVec/MatrixProductMMA.h | 629 + .../Eigen/src/Core/arch/AltiVec/PacketMath.h | 2711 +++ .../Eigen/src/Core/arch/CUDA/Complex.h | 258 + .../Eigen/src/Core/arch/Default/BFloat16.h | 700 + .../Eigen/src/Core/arch/Default/ConjHelper.h | 117 + .../arch/Default/GenericPacketMathFunctions.h | 1649 ++ .../Default/GenericPacketMathFunctionsFwd.h | 110 + .../Eigen/src/Core/arch/Default/Half.h | 942 + .../Eigen/src/Core/arch/Default/Settings.h | 49 + .../Eigen/src/Core/arch/Default/TypeCasting.h | 120 + .../Eigen/src/Core/arch/GPU/MathFunctions.h | 103 + .../Eigen/src/Core/arch/GPU/PacketMath.h | 1685 ++ .../Eigen/src/Core/arch/GPU/TypeCasting.h | 80 + .../src/Core/arch/HIP/hcc/math_constants.h | 23 + .../Eigen/src/Core/arch/MSA/Complex.h | 648 + .../Eigen/src/Core/arch/MSA/MathFunctions.h | 387 + .../Eigen/src/Core/arch/MSA/PacketMath.h | 1233 ++ .../Eigen/src/Core/arch/NEON/Complex.h | 584 + .../Core/arch/NEON/GeneralBlockPanelKernel.h | 183 + .../Eigen/src/Core/arch/NEON/MathFunctions.h | 75 + .../Eigen/src/Core/arch/NEON/PacketMath.h | 4587 +++++ .../Eigen/src/Core/arch/NEON/TypeCasting.h | 1419 ++ .../Eigen/src/Core/arch/SSE/Complex.h | 351 + .../Eigen/src/Core/arch/SSE/MathFunctions.h | 199 + .../Eigen/src/Core/arch/SSE/PacketMath.h | 1505 ++ .../Eigen/src/Core/arch/SSE/TypeCasting.h | 142 + .../Eigen/src/Core/arch/SVE/MathFunctions.h | 44 + .../Eigen/src/Core/arch/SVE/PacketMath.h | 752 + .../Eigen/src/Core/arch/SVE/TypeCasting.h | 49 + .../Eigen/src/Core/arch/SYCL/InteropHeaders.h | 232 + .../Eigen/src/Core/arch/SYCL/MathFunctions.h | 301 + .../Eigen/src/Core/arch/SYCL/PacketMath.h | 670 + .../src/Core/arch/SYCL/SyclMemoryModel.h | 694 + .../Eigen/src/Core/arch/SYCL/TypeCasting.h | 85 + .../Eigen/src/Core/arch/ZVector/Complex.h | 426 + .../src/Core/arch/ZVector/MathFunctions.h | 233 + .../Eigen/src/Core/arch/ZVector/PacketMath.h | 1060 + .../src/Core/functors/AssignmentFunctors.h | 177 + .../Eigen/src/Core/functors/BinaryFunctors.h | 541 + .../Eigen/src/Core/functors/NullaryFunctors.h | 189 + .../Eigen/src/Core/functors/StlFunctors.h | 166 + .../Eigen/src/Core/functors/TernaryFunctors.h | 25 + .../Eigen/src/Core/functors/UnaryFunctors.h | 1131 ++ .../Core/products/GeneralBlockPanelKernel.h | 2645 +++ .../src/Core/products/GeneralMatrixMatrix.h | 517 + .../products/GeneralMatrixMatrixTriangular.h | 317 + .../GeneralMatrixMatrixTriangular_BLAS.h | 145 + .../Core/products/GeneralMatrixMatrix_BLAS.h | 124 + .../src/Core/products/GeneralMatrixVector.h | 518 + .../Core/products/GeneralMatrixVector_BLAS.h | 136 + .../Eigen/src/Core/products/Parallelizer.h | 180 + .../Core/products/SelfadjointMatrixMatrix.h | 544 + .../products/SelfadjointMatrixMatrix_BLAS.h | 295 + .../Core/products/SelfadjointMatrixVector.h | 262 + .../products/SelfadjointMatrixVector_BLAS.h | 118 + .../src/Core/products/SelfadjointProduct.h | 133 + .../Core/products/SelfadjointRank2Update.h | 94 + .../Core/products/TriangularMatrixMatrix.h | 472 + .../products/TriangularMatrixMatrix_BLAS.h | 317 + .../Core/products/TriangularMatrixVector.h | 350 + .../products/TriangularMatrixVector_BLAS.h | 255 + .../Core/products/TriangularSolverMatrix.h | 337 + .../products/TriangularSolverMatrix_BLAS.h | 167 + .../Core/products/TriangularSolverVector.h | 148 + .../Eigen/src/Core/util/BlasUtil.h | 583 + .../src/Core/util/ConfigureVectorization.h | 512 + .../Eigen/src/Core/util/Constants.h | 563 + .../src/Core/util/DisableStupidWarnings.h | 106 + .../Eigen/src/Core/util/ForwardDeclarations.h | 322 + .../Eigen/src/Core/util/IndexedViewHelper.h | 186 + .../Eigen/src/Core/util/IntegralConstant.h | 272 + .../Eigen/src/Core/util/MKL_support.h | 137 + .../eigen-3.4.0/Eigen/src/Core/util/Macros.h | 1464 ++ .../eigen-3.4.0/Eigen/src/Core/util/Memory.h | 1163 ++ .../eigen-3.4.0/Eigen/src/Core/util/Meta.h | 812 + .../eigen-3.4.0/Eigen/src/Core/util/NonMPL2.h | 3 + .../src/Core/util/ReenableStupidWarnings.h | 31 + .../Eigen/src/Core/util/ReshapedHelper.h | 51 + .../Eigen/src/Core/util/StaticAssert.h | 221 + .../Eigen/src/Core/util/SymbolicIndex.h | 293 + .../Eigen/src/Core/util/XprHelper.h | 856 + .../src/Eigenvalues/ComplexEigenSolver.h | 346 + .../Eigen/src/Eigenvalues/ComplexSchur.h | 462 + .../src/Eigenvalues/ComplexSchur_LAPACKE.h | 91 + .../Eigen/src/Eigenvalues/EigenSolver.h | 622 + .../src/Eigenvalues/GeneralizedEigenSolver.h | 418 + .../GeneralizedSelfAdjointEigenSolver.h | 226 + .../src/Eigenvalues/HessenbergDecomposition.h | 374 + .../src/Eigenvalues/MatrixBaseEigenvalues.h | 158 + .../Eigen/src/Eigenvalues/RealQZ.h | 657 + .../Eigen/src/Eigenvalues/RealSchur.h | 558 + .../Eigen/src/Eigenvalues/RealSchur_LAPACKE.h | 77 + .../src/Eigenvalues/SelfAdjointEigenSolver.h | 904 + .../SelfAdjointEigenSolver_LAPACKE.h | 87 + .../src/Eigenvalues/Tridiagonalization.h | 561 + .../Eigen/src/Geometry/AlignedBox.h | 486 + .../Eigen/src/Geometry/AngleAxis.h | 247 + .../Eigen/src/Geometry/EulerAngles.h | 114 + .../Eigen/src/Geometry/Homogeneous.h | 501 + .../Eigen/src/Geometry/Hyperplane.h | 282 + .../Eigen/src/Geometry/OrthoMethods.h | 235 + .../Eigen/src/Geometry/ParametrizedLine.h | 232 + .../Eigen/src/Geometry/Quaternion.h | 870 + .../Eigen/src/Geometry/Rotation2D.h | 199 + .../Eigen/src/Geometry/RotationBase.h | 206 + .../eigen-3.4.0/Eigen/src/Geometry/Scaling.h | 188 + .../Eigen/src/Geometry/Transform.h | 1563 ++ .../Eigen/src/Geometry/Translation.h | 202 + .../eigen-3.4.0/Eigen/src/Geometry/Umeyama.h | 166 + .../Eigen/src/Geometry/arch/Geometry_SIMD.h | 168 + .../Eigen/src/Householder/BlockHouseholder.h | 110 + .../Eigen/src/Householder/Householder.h | 176 + .../src/Householder/HouseholderSequence.h | 545 + .../BasicPreconditioners.h | 226 + .../src/IterativeLinearSolvers/BiCGSTAB.h | 212 + .../ConjugateGradient.h | 229 + .../IncompleteCholesky.h | 394 + .../IterativeLinearSolvers/IncompleteLUT.h | 453 + .../IterativeSolverBase.h | 444 + .../LeastSquareConjugateGradient.h | 198 + .../IterativeLinearSolvers/SolveWithGuess.h | 117 + .../eigen-3.4.0/Eigen/src/Jacobi/Jacobi.h | 483 + .../Eigen/src/KLUSupport/KLUSupport.h | 358 + .../eigen-3.4.0/Eigen/src/LU/Determinant.h | 117 + .../eigen-3.4.0/Eigen/src/LU/FullPivLU.h | 877 + .../eigen-3.4.0/Eigen/src/LU/InverseImpl.h | 432 + .../eigen-3.4.0/Eigen/src/LU/PartialPivLU.h | 624 + .../Eigen/src/LU/PartialPivLU_LAPACKE.h | 83 + .../Eigen/src/LU/arch/InverseSize4.h | 351 + .../Eigen/src/MetisSupport/MetisSupport.h | 137 + .../Eigen/src/OrderingMethods/Amd.h | 435 + .../Eigen/src/OrderingMethods/Eigen_Colamd.h | 1863 ++ .../Eigen/src/OrderingMethods/Ordering.h | 153 + .../Eigen/src/PaStiXSupport/PaStiXSupport.h | 678 + .../Eigen/src/PardisoSupport/PardisoSupport.h | 545 + .../Eigen/src/QR/ColPivHouseholderQR.h | 674 + .../src/QR/ColPivHouseholderQR_LAPACKE.h | 97 + .../src/QR/CompleteOrthogonalDecomposition.h | 635 + .../Eigen/src/QR/FullPivHouseholderQR.h | 713 + .../eigen-3.4.0/Eigen/src/QR/HouseholderQR.h | 434 + .../Eigen/src/QR/HouseholderQR_LAPACKE.h | 68 + .../src/SPQRSupport/SuiteSparseQRSupport.h | 335 + .../eigen-3.4.0/Eigen/src/SVD/BDCSVD.h | 1366 ++ .../eigen-3.4.0/Eigen/src/SVD/JacobiSVD.h | 812 + .../Eigen/src/SVD/JacobiSVD_LAPACKE.h | 91 + .../eigen-3.4.0/Eigen/src/SVD/SVDBase.h | 376 + .../Eigen/src/SVD/UpperBidiagonalization.h | 414 + .../src/SparseCholesky/SimplicialCholesky.h | 697 + .../SparseCholesky/SimplicialCholesky_impl.h | 174 + .../Eigen/src/SparseCore/AmbiVector.h | 378 + .../Eigen/src/SparseCore/CompressedStorage.h | 274 + .../ConservativeSparseSparseProduct.h | 352 + .../Eigen/src/SparseCore/MappedSparseMatrix.h | 67 + .../Eigen/src/SparseCore/SparseAssign.h | 270 + .../Eigen/src/SparseCore/SparseBlock.h | 571 + .../Eigen/src/SparseCore/SparseColEtree.h | 206 + .../src/SparseCore/SparseCompressedBase.h | 370 + .../src/SparseCore/SparseCwiseBinaryOp.h | 722 + .../Eigen/src/SparseCore/SparseCwiseUnaryOp.h | 150 + .../Eigen/src/SparseCore/SparseDenseProduct.h | 342 + .../src/SparseCore/SparseDiagonalProduct.h | 138 + .../Eigen/src/SparseCore/SparseDot.h | 98 + .../Eigen/src/SparseCore/SparseFuzzy.h | 29 + .../Eigen/src/SparseCore/SparseMap.h | 305 + .../Eigen/src/SparseCore/SparseMatrix.h | 1518 ++ .../Eigen/src/SparseCore/SparseMatrixBase.h | 398 + .../Eigen/src/SparseCore/SparsePermutation.h | 178 + .../Eigen/src/SparseCore/SparseProduct.h | 181 + .../Eigen/src/SparseCore/SparseRedux.h | 49 + .../Eigen/src/SparseCore/SparseRef.h | 397 + .../src/SparseCore/SparseSelfAdjointView.h | 659 + .../Eigen/src/SparseCore/SparseSolverBase.h | 124 + .../SparseSparseProductWithPruning.h | 198 + .../Eigen/src/SparseCore/SparseTranspose.h | 92 + .../src/SparseCore/SparseTriangularView.h | 189 + .../Eigen/src/SparseCore/SparseUtil.h | 186 + .../Eigen/src/SparseCore/SparseVector.h | 478 + .../Eigen/src/SparseCore/SparseView.h | 254 + .../Eigen/src/SparseCore/TriangularSolver.h | 315 + .../eigen-3.4.0/Eigen/src/SparseLU/SparseLU.h | 923 + .../Eigen/src/SparseLU/SparseLUImpl.h | 66 + .../Eigen/src/SparseLU/SparseLU_Memory.h | 226 + .../Eigen/src/SparseLU/SparseLU_Structs.h | 110 + .../src/SparseLU/SparseLU_SupernodalMatrix.h | 375 + .../Eigen/src/SparseLU/SparseLU_Utils.h | 80 + .../Eigen/src/SparseLU/SparseLU_column_bmod.h | 181 + .../Eigen/src/SparseLU/SparseLU_column_dfs.h | 179 + .../src/SparseLU/SparseLU_copy_to_ucol.h | 107 + .../Eigen/src/SparseLU/SparseLU_gemm_kernel.h | 280 + .../src/SparseLU/SparseLU_heap_relax_snode.h | 126 + .../Eigen/src/SparseLU/SparseLU_kernel_bmod.h | 130 + .../Eigen/src/SparseLU/SparseLU_panel_bmod.h | 223 + .../Eigen/src/SparseLU/SparseLU_panel_dfs.h | 258 + .../Eigen/src/SparseLU/SparseLU_pivotL.h | 137 + .../Eigen/src/SparseLU/SparseLU_pruneL.h | 136 + .../Eigen/src/SparseLU/SparseLU_relax_snode.h | 83 + .../eigen-3.4.0/Eigen/src/SparseQR/SparseQR.h | 758 + .../Eigen/src/StlSupport/StdDeque.h | 116 + .../Eigen/src/StlSupport/StdList.h | 106 + .../Eigen/src/StlSupport/StdVector.h | 131 + .../Eigen/src/StlSupport/details.h | 84 + .../Eigen/src/SuperLUSupport/SuperLUSupport.h | 1025 + .../Eigen/src/UmfPackSupport/UmfPackSupport.h | 642 + .../eigen-3.4.0/Eigen/src/misc/Image.h | 82 + .../eigen-3.4.0/Eigen/src/misc/Kernel.h | 79 + .../eigen-3.4.0/Eigen/src/misc/RealSvd2x2.h | 55 + .../eigen-3.4.0/Eigen/src/misc/blas.h | 440 + .../eigen-3.4.0/Eigen/src/misc/lapack.h | 152 + .../eigen-3.4.0/Eigen/src/misc/lapacke.h | 16292 ++++++++++++++++ .../Eigen/src/misc/lapacke_mangling.h | 17 + .../Eigen/src/plugins/ArrayCwiseBinaryOps.h | 358 + .../Eigen/src/plugins/ArrayCwiseUnaryOps.h | 696 + .../Eigen/src/plugins/BlockMethods.h | 1442 ++ .../Eigen/src/plugins/CommonCwiseBinaryOps.h | 115 + .../Eigen/src/plugins/CommonCwiseUnaryOps.h | 177 + .../Eigen/src/plugins/IndexedViewMethods.h | 262 + .../Eigen/src/plugins/MatrixCwiseBinaryOps.h | 152 + .../Eigen/src/plugins/MatrixCwiseUnaryOps.h | 95 + .../Eigen/src/plugins/ReshapedMethods.h | 149 + src/ui/centralwidget.cpp | 4 +- src/ui/itemmanager.cpp | 1 - 347 files changed, 148837 insertions(+), 12 deletions(-) create mode 100644 experiment_data/analysis_state/03-111.xlsx create mode 100644 experiment_data/sample_data/03-111.xlsx create mode 100644 experiment_data/sample_data/03-sampleName.xlsx create mode 100644 src/data/lowesssmoother.cpp create mode 100644 src/data/lowesssmoother.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/Cholesky create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/CholmodSupport create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/Core create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/Dense create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/Eigen create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/Eigenvalues create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/Geometry create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/Householder create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/IterativeLinearSolvers create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/Jacobi create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/KLUSupport create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/LU create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/MetisSupport create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/OrderingMethods create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/PaStiXSupport create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/PardisoSupport create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/QR create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/QtAlignedMalloc create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/SPQRSupport create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/SVD create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/Sparse create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/SparseCholesky create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/SparseCore create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/SparseLU create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/SparseQR create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/StdDeque create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/StdList create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/StdVector create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/SuperLUSupport create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/UmfPackSupport create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Cholesky/LDLT.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Cholesky/LLT.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Cholesky/LLT_LAPACKE.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/CholmodSupport/CholmodSupport.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/ArithmeticSequence.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Array.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/ArrayBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/ArrayWrapper.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Assign.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/AssignEvaluator.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Assign_MKL.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/BandMatrix.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Block.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/BooleanRedux.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/CommaInitializer.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/ConditionEstimator.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/CoreEvaluators.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/CoreIterators.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseBinaryOp.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseNullaryOp.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseTernaryOp.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseUnaryOp.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseUnaryView.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/DenseBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/DenseCoeffsBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/DenseStorage.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Diagonal.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/DiagonalMatrix.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/DiagonalProduct.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Dot.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/EigenBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/ForceAlignedAccess.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Fuzzy.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/GeneralProduct.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/GenericPacketMath.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/GlobalFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/IO.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/IndexedView.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Inverse.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Map.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/MapBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/MathFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/MathFunctionsImpl.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Matrix.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/MatrixBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/NestByValue.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/NoAlias.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/NumTraits.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/PartialReduxEvaluator.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/PermutationMatrix.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/PlainObjectBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Product.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/ProductEvaluators.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Random.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Redux.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Ref.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Replicate.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Reshaped.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/ReturnByValue.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Reverse.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Select.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/SelfAdjointView.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/SelfCwiseBinaryOp.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Solve.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/SolveTriangular.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/SolverBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/StableNorm.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/StlIterators.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Stride.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Swap.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Transpose.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Transpositions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/TriangularMatrix.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/VectorBlock.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/VectorwiseOp.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/Visitor.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AVX/Complex.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AVX/MathFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AVX/PacketMath.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AVX/TypeCasting.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AVX512/Complex.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AVX512/MathFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AVX512/PacketMath.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AVX512/TypeCasting.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AltiVec/Complex.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AltiVec/MathFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AltiVec/MatrixProduct.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AltiVec/MatrixProductCommon.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AltiVec/MatrixProductMMA.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/AltiVec/PacketMath.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/CUDA/Complex.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/Default/BFloat16.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/Default/ConjHelper.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/Default/GenericPacketMathFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/Default/GenericPacketMathFunctionsFwd.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/Default/Half.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/Default/Settings.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/Default/TypeCasting.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/GPU/MathFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/GPU/PacketMath.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/GPU/TypeCasting.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/HIP/hcc/math_constants.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/MSA/Complex.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/MSA/MathFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/MSA/PacketMath.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/NEON/Complex.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/NEON/GeneralBlockPanelKernel.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/NEON/MathFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/NEON/PacketMath.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/NEON/TypeCasting.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/SSE/Complex.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/SSE/MathFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/SSE/PacketMath.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/SSE/TypeCasting.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/SVE/MathFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/SVE/PacketMath.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/SVE/TypeCasting.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/SYCL/InteropHeaders.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/SYCL/MathFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/SYCL/PacketMath.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/SYCL/SyclMemoryModel.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/SYCL/TypeCasting.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/ZVector/Complex.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/ZVector/MathFunctions.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/arch/ZVector/PacketMath.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/functors/AssignmentFunctors.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/functors/BinaryFunctors.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/functors/NullaryFunctors.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/functors/StlFunctors.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/functors/TernaryFunctors.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/functors/UnaryFunctors.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/GeneralBlockPanelKernel.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/GeneralMatrixMatrix.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/GeneralMatrixMatrixTriangular.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/GeneralMatrixMatrixTriangular_BLAS.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/GeneralMatrixMatrix_BLAS.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/GeneralMatrixVector.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/GeneralMatrixVector_BLAS.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/Parallelizer.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/SelfadjointMatrixMatrix.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/SelfadjointMatrixMatrix_BLAS.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/SelfadjointMatrixVector.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/SelfadjointMatrixVector_BLAS.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/SelfadjointProduct.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/SelfadjointRank2Update.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/TriangularMatrixMatrix.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/TriangularMatrixMatrix_BLAS.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/TriangularMatrixVector.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/TriangularMatrixVector_BLAS.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/TriangularSolverMatrix.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/TriangularSolverMatrix_BLAS.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/products/TriangularSolverVector.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/BlasUtil.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/ConfigureVectorization.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/Constants.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/DisableStupidWarnings.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/ForwardDeclarations.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/IndexedViewHelper.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/IntegralConstant.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/MKL_support.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/Macros.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/Memory.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/Meta.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/NonMPL2.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/ReenableStupidWarnings.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/ReshapedHelper.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/StaticAssert.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/SymbolicIndex.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Core/util/XprHelper.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/ComplexEigenSolver.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/ComplexSchur.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/ComplexSchur_LAPACKE.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/EigenSolver.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/GeneralizedEigenSolver.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/GeneralizedSelfAdjointEigenSolver.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/HessenbergDecomposition.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/MatrixBaseEigenvalues.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/RealQZ.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/RealSchur.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/RealSchur_LAPACKE.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/SelfAdjointEigenSolver.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/SelfAdjointEigenSolver_LAPACKE.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Eigenvalues/Tridiagonalization.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/AlignedBox.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/AngleAxis.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/EulerAngles.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/Homogeneous.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/Hyperplane.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/OrthoMethods.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/ParametrizedLine.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/Quaternion.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/Rotation2D.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/RotationBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/Scaling.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/Transform.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/Translation.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/Umeyama.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Geometry/arch/Geometry_SIMD.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Householder/BlockHouseholder.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Householder/Householder.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Householder/HouseholderSequence.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/IterativeLinearSolvers/BasicPreconditioners.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/IterativeLinearSolvers/BiCGSTAB.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/IterativeLinearSolvers/ConjugateGradient.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/IterativeLinearSolvers/IncompleteCholesky.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/IterativeLinearSolvers/IncompleteLUT.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/IterativeLinearSolvers/IterativeSolverBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/IterativeLinearSolvers/LeastSquareConjugateGradient.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/IterativeLinearSolvers/SolveWithGuess.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/Jacobi/Jacobi.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/KLUSupport/KLUSupport.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/LU/Determinant.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/LU/FullPivLU.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/LU/InverseImpl.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/LU/PartialPivLU.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/LU/PartialPivLU_LAPACKE.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/LU/arch/InverseSize4.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/MetisSupport/MetisSupport.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/OrderingMethods/Amd.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/OrderingMethods/Eigen_Colamd.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/OrderingMethods/Ordering.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/PaStiXSupport/PaStiXSupport.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/PardisoSupport/PardisoSupport.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/QR/ColPivHouseholderQR.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/QR/ColPivHouseholderQR_LAPACKE.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/QR/CompleteOrthogonalDecomposition.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/QR/FullPivHouseholderQR.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/QR/HouseholderQR.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/QR/HouseholderQR_LAPACKE.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SPQRSupport/SuiteSparseQRSupport.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SVD/BDCSVD.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SVD/JacobiSVD.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SVD/JacobiSVD_LAPACKE.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SVD/SVDBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SVD/UpperBidiagonalization.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCholesky/SimplicialCholesky.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCholesky/SimplicialCholesky_impl.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/AmbiVector.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/CompressedStorage.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/ConservativeSparseSparseProduct.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/MappedSparseMatrix.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseAssign.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseBlock.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseColEtree.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseCompressedBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseCwiseBinaryOp.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseCwiseUnaryOp.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseDenseProduct.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseDiagonalProduct.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseDot.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseFuzzy.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseMap.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseMatrix.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseMatrixBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparsePermutation.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseProduct.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseRedux.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseRef.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseSelfAdjointView.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseSolverBase.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseSparseProductWithPruning.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseTranspose.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseTriangularView.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseUtil.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseVector.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/SparseView.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseCore/TriangularSolver.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLUImpl.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_Memory.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_Structs.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_SupernodalMatrix.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_Utils.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_column_bmod.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_column_dfs.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_copy_to_ucol.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_gemm_kernel.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_heap_relax_snode.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_kernel_bmod.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_panel_bmod.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_panel_dfs.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_pivotL.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_pruneL.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseLU/SparseLU_relax_snode.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SparseQR/SparseQR.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/StlSupport/StdDeque.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/StlSupport/StdList.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/StlSupport/StdVector.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/StlSupport/details.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/SuperLUSupport/SuperLUSupport.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/UmfPackSupport/UmfPackSupport.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/misc/Image.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/misc/Kernel.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/misc/RealSvd2x2.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/misc/blas.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/misc/lapack.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/misc/lapacke.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/misc/lapacke_mangling.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/plugins/ArrayCwiseBinaryOps.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/plugins/ArrayCwiseUnaryOps.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/plugins/BlockMethods.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/plugins/CommonCwiseBinaryOps.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/plugins/CommonCwiseUnaryOps.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/plugins/IndexedViewMethods.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/plugins/MatrixCwiseBinaryOps.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/plugins/MatrixCwiseUnaryOps.h create mode 100644 src/thirdparty/eigen-3.4.0/Eigen/src/plugins/ReshapedMethods.h diff --git a/experiment_data/analysis_state/03-111.xlsx b/experiment_data/analysis_state/03-111.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..d28dda0d4ed1791b87d7db1b430152c6003b6dac GIT binary patch literal 345416 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�weAU7!gwXN}mP|NOhlX`^r!T|WZu$P4TlHe)ypLRy=;TLkGLng6Mi)Ytrq0T6q#OsPPJlf9O>bC{k=x)@Ps>ZtWl3#82h9V2Nr99rt z3ml(gB3Bd#|HF8iAlHc-u+Jf@sIm1rQ09Y&)mR}Gi7%Z~!z#I=&ipH3ev6)YTq6QK z?mG-cYU1lG!|>Ngiu7cd|F)nyPR5SB#lT;Vrs$e`7N zn}smej;K<hME+8zW2~kU7eL-p+)0z%Ln2v=(kjmw`mLv{mEBV z%#`wF@ck9!mXbtdrgWP0rj1nA|V|;4IqJ0rs?ivw{LXtca_oD{SU6Q z#}2VY;d3J%NNyc}`fzEXE$xXUiVz_lk8KP6BicjF6+md*JlW39#C zna^5{Z^>ei2~!g+UEFGM{iP*VHT1V>&d%-R5=S|!s~y^R6>Nl>zNA!=*2c+01Ox1D zn8Cv6AiPY}djD)Z;v&=~%}2c-YPfw-lIs;y62{{utw!Uzhti>x^OsFr$cdAiDrwG( zDqyAu`7DPef5+MH$-cSjn71|kv3D50Z?-B~PU>nG{7nV>_+LXTE*Qu4jYqPOk8kJ1 zg67av!}M89NQ0V$&7!xd*;5>8e{u7saRmhXMBlgm@V{>zK!2M`BT9MgpSHk7`OtFa-xHN5+i z{99zjkpt{Ew&z(B(H`q;XGgYKEbIeNoBy)M(ypX_YvD`QF@Kx-zF9pxrbBnzn%~T> zay#`eLdWIYkfkey>@;XTf)=Qmm#{M#u28k8e(HXS zj?0PRTB3g!lhLu~zFlmN3i*K{-LzQuXsm`URuKCE)fkXgprDC1qaW(liZ1!Qe-y$? zewU$du_0l^0F=#pvorYyhU@C&OQw4<))S|(!{|p>u|uE>Y#KXJ8_l)=l5Go~f;5n4V^KGv$DMs|eE{KtV=5vR-sZPbSd2s~s97jzs3<6mya}nox{7zhc+nQk z_7s=SZrHAKb$+wr=xa7FHAzPmxx}YzczSwu>ItqMfDn+KfYc#Wa2g>&BFVwSl80h# zI`SFqzAp2bxK3OS5&h69PAV0RfxgAoBnEdH7KM71%SLh+1+_?t(g6+2&nOw$yY)i? z-#OkT@n`B^E#7>D=4RUI&Vi(WYtC;G?$RF$H z;veHm4i1icYgB&z@G24h08k5bv0Gcicp)nDoz|!2W#rsmOT3I<@a4?B_AQE7M5v?& zQQonFmae=}6%~?c28wXi0EAT8uYsjlwszF%}LWPTm>gzIkuOrwTaF~kcq_F8t@^dtf`ccopP8bl!x( z9r=+^+C<9oEBu*7aEFdd^)afXOXQ`v6w!)uulo|M4?EX$RiL|JX4S?dODC=*GQ~Ut z`sKKO$<7Rw2*~be0V9-@d^(H)9ms-{ei7b}A`Urwky(w^UxX_LAUwzl+<gI z?z7anB7JynoU`?@*({Q_Vom(WmG8$rhg$8b9bv2rxve4HZ_yxFtOi=8&YuoNS*gw9 zCC)%voOe}_qeGisQn0n*{FiQoYQyC7joX~r;U*z7SW%EKx%EFFois7Wn^(@02;TCu z9bt<&NP@m}9}FXJulf*rH?z-`2)_cTC4lWvRxxP*!N?7pp%%5^+yj~WSk65pPD|QV z&pBZbRl+~+M?Y#-{C!PtOpZX7TTQ^12 zYWpmyKx#jTt=Nr3tB@NT($$H=`~F4kQt>j9-CHT|9fS27Z|@Zijk-2&aRAW}_y6JQ z%LAeOzW?p}E@VyC!q|;n$W}s1$k>-bW*8}iWJ~r?*0D>3$ubPt_a(*}8T(L{vSugx zJ*xNn_kDl<=^yvpd(J(t^E$74pJ$%X^%58>)+>?hZj9MO3nR9Tlpp{`GT-QGrc3(7D+~x00gxsUP}7D5G}!Mh@$4Thj*Nvqm*aHUu>E zHKik;qLBCn=_ut836VEyk<~#)S3F%MXTzAz1EqL9q4u`2COs8TQ)7WJM1|6N_Tlb zm=u$aaxkO_1=Y%Kxf4ZjW|L%9x%W@GiRGj)Ok1{mIJhv5Bt7yg`w~!l`#xz@5vid? zl6`AcS9<{^k2q~Davt9$YD`c*kewwlH=Bg8g@&+;n%roeLBbKsYs{bEBoyYH*I+6pLH#c7L? zwtz#yEE+0>!EfxImavP@^@s7ltGxGWU$M6WaVv;^=yvT#K|S)Qs<(gzi#Y9DoKlmv#$63@lzDe>%{ z&!6=5)=|?n*M~xuEzyxIacmOqcUbog-2^PtdGR9zb(Bm%O*ZXk)gw4X?miSG8x+UW z=-kwoYzwnbcz}=-Z^Za-8@-OFom9wl;@Gn(xFc( zXB(6l;tH;&E!c|@B`G*yL-mRI1K_=DTW&DpxG8^wle4m)0w8ma! z;yK`8Wxc#TV3gM+M=NgNf^aRL4kMFS3uag3HQ~1fyBJ*s3OMzi>Gc-<&rgf%SQ04a zsOY81Ry{JuuhhzFv=(SQWWI3jP>Vz7uQa`w&oA&)v)gZ-c^*6VZu<%9wswNhnVBp(xa2RN`$QI^@H2cXRA6siF&sxeV(H7+i-bz$*RyMhFhg~Z6S<5~ ziU`-XVExbqAufRG`g!}_mWSlHu{B8b?^kM@-kdf)7Vd5tPM|W0xftbY+Llg~B6Oiv z_M*FH@VPn&y=GPWnTmcMm|ZxH+4$-kHJd>LfT$5tyvK3Vp4%$2X};JXeP%LC4ib60 zmfySdH1t}f%xp)DLcgtUKf{Bn`jY_X7CWn*D|GIC2Cd70ctp5{1nCpc3sC@dXbsiq{$ zmI*ixnLRw7D$Mh4U#gLF71=U$JA|aS%#EnmQ2vAmFzuVu#$7%m{VDkLVkb68pxvRj zMjk&97`;Z>wRp)p(WDs>8>r8`3*ndtYcvD#hT~6K>G8(7YO&v-<+;MiS1xPYKX+5W z5W+5qjTYY@=JT%O@Hrj;`5T0zADr71Yh+6Xkuh5Xbul5N+T}9d-JtbBM zayk7dS*X88HUi!jaK1mHrPP`ia!+jlacKwp(PMrnj(iO+8+0i-y{7i^ee)fLi4=eX#60SoXF|h;3%7bb_KZ~8&k+6egGL(U@ z$KtCk?HJQ=f`^=S*0O5dlIeu^bl3-hjlc>?(ww)7!k|UIOB36 zQDF_H7_9ObRmxV!F-z@_UFototTIZ>v(Q=%wJHqL7T@% zS~rn<{e9Glp<4$eop&~ocv7ovYRR;v@wv#(gX_f2OH2ba<#m^cXDwHh@gR;6nx2mv zm#n>F0A1j#&)fpx@C6e#02tD-clVkr5iCfVxd_b;XYXfq@P02wyIik5`;?behj-R- z%D+%<7G$vH?%IMQ*#raquQV9D#>$^0063*)3)fWLa8Kag(0LKh2;;4_D0wyxtC6*< zFVKK8W6m*M)$+|aoZKRH+Om~1UxcXJ-G!=m*j=in0&lj3qPye1QWLYCy1Z#VI4rw>V z&8oGxlqFcf4BI5FobmCnz6`GKT@jJa;aU;1j%KCr++8&v>(eiY`OJ+mx}V#i|3RU6rP^qZSR z%f6_~hnWPYd{45q!+(AwHwZHDb?vPivYj;5vw2A$*udD2VrsgI!63N!&yJIdKL= zik@dmC`PUqWT5BXs|d@(&&V~bIr(cTQxNPa0^`$fToVvklT_@9RipU%?xUrV;Kf3@ zZjgb3d+${k-@=S`gJyf0VGD_6q|Hk^9dhZm$4<>`tKCO8<2)B1v-AtTmDbCSs0yzw zpzHuChWrkoU9qg**{Yyo=KKd`u+Rzc!qr`uZgzLZkBML&CiW*)z~ioVVTzhB1OWaw zI0oKC_H40uueA5L>x72OT&;!qsVojx z14}}sO~Ku6OR5?Zq>HJUxFBlTek0e2MhLy?bjUHAEVPA@9daY`0I)-~b}cREK+J$J z+ua^T>2HzGLTeoXR&?{@nzql{&91%HagJd-_j-Fq4@DChT|`VNAo z+6|tMhvBg>G-V~03}FxtEYa{|?bu1+XX>sRfH=v}q)vGAuWyOuP(#=vw=ZA)>q7H~ zosMp{NP{3a7~w_)JFhRYvWA2=W+KqqKxbGsp81QWlM)!7ZW<|i-RDwdF#-z~6+sx^>=gL&OTT!9FTsA8u~7Kn!n@q7ap zLyrU;U9HOG`me$(F4q<4w$yKZ?;M{Rj|U^wCt;G~BqQf5G<*yd{`iUiDTnxi826y+ z^ZKnZu8}S}hA$32r7?k>dJS-_3z{+?OJ-+q5y(P%a7rY$;#Qeemczw<7Zo$QRpt{b zEJBO3-!|J!DEjr40#A%k6)tQDN?a}!h5>}xe6K1W2}YVVejMm}u$K&*ekN(elis{+ zSGjhZ-v{?ijR$~{TR7OzSlA%o5X;0eWs~@aKEU#-{Vg|f9f{Jsh(qklf1@5MR zG?<5hCms+v%e+7f{%j1ZR!+KAeA+(b{z z)n=#A#R8+nRNg>%z+DcAXos6=e;?NXYi}-mI?Zd;+71(r#*qv_?JS|u5y}~{PV2B4 zO~W@C=p&K@)i}OUF9=J{*tx;|3er$w&sfc$Xt@lm5CTlSC=Jn?#={WYISpd0!GSBI zF77(~Ty^Mhe7gC*bRl{;hC9xvA-Z<;AE&G^E`U?M#vcRn%6&4JM32iuVufxHPUeE_ zJKy2skAmh%I0QfevwuDE1Uw2?&HypaKJQF5FY{An-KMk+uV|QvnEJru)6l;PGye>$ zXYjJON>d1TQ$iZ7z*xJTfHg*O4CZLQj0X4M3g9xPhh_%ktWqzOyV{pAKqkY$58c1M zPDJNF#W4tFRzY@prh)i2e8JZJCS-<)r1uA8M%lc9+|l06nF%Q$w_&Bba;91F%HoP8 zm@Z(W2BDtQ=NpwpD^47!aivV|gVB>?63KRknB6;3j`PicSN#bc?e{_B-5 zojISpF;8MN%aW;Nefh@O=e@~!Cqw7!>eWta=*B1Sn(n&MW)I=S;`(62h(h#wN(?vN z!fqrpHQ@z230!-m247ypj>GnZm7%*OROBeZ3_B6;-fq#1CRhjx5bd__QBRRCKaiT+QYUz}^LOza2+Fn8ua*Up=skRcFN;PEPR zM;Vh;kZMdFZ;#E=Bk;(T3V1vFOZoJQKPBecF~m1d=j==h1#cyMzBEHnG$_M zf-nqcfY_ow1Pa)7rHle7FN){|SLX*7?~hf44>c_>rgq+`R;^M*#&&+??kjw%*Ja;n z(JTxD|DHS(+eI9rPLyBq7E+2heJ>DvS)`Fa8i~gFV)~eiW3^B36x+Fhkp>g6iKpRKr*dezc@@j^9rrls;*Z(Xrg}D;KILj1pboK6@U9uj^e}9HmD>77Y@*0p zFCy=#ZbRe^`PVQu^xf8Nf7@%~kDF;&WX7q~G|*|Zgsh}KvYZLa7l^#yB?am%li0vu z*yN|iS1wC&hroV+t1HWZy786P;?(k%9y;s7F5Kyu5<0{<#z#FEb@=*!PL zkH3%-I;1jZ*m*H*Br{Jbo2XyU^|%pk0Mt_^mX0G`GM{JZ5r*EGpv())QFojz%o#b^ zMs|P1q@8OZx#v4vYkhi_w+s&h2cvO>*JXmyKu61gDvJd_AxXzBF$Zk>rjr{n5I1Ug zD{y`{T^NWQkh6&-@qo1BU_{Pn;&ABi-gud7f`O`HFmX5Y9BJAVUV?oq;VZ6m&iZ17 z;a$uDkI+V_f7W=#Dn{?6z$t*+7nf4J7mUtiE+_E3=4r2Q_>`kC#MwHP^Vg{CnA4wL z3Pdpff(K}(4L_0!MqtCd2#gmI^k(-!)ta_O#VUsKmII!HKSdNx;_w`3fw=qT}}+b==GTZIp=2ZX1H8E_U29hf5-QA ze5%PjuAzi>3+vf9poIn=#OJau&X<9sVq7k{$A=cnQq_eo)M$jWeRpT{qwQ4%ylT?&>9o zDY7Un?m`Wn^*cgGuD?Kqkoivi;S$=~^dTJ3K-ill+7+X6Od!W3t0nI2M2%%MSUn#V zPRcXi>@C?l-$kDNX>;I}2O-Wf-RQ49d@gGr#=x{4(Ivi4-^E9sPGPIV7jYB`{VE~u z2DQ)sn*&H(hX=SVsPY0ZzhvGIUb|}_7(WFi-EF^`@UF7D)`Y0(f8=Dc;p4Wmdgz48 z(~#XUqWY_CoUR{vFn$kwoqG8R;!NL+6J5%E>U}O#s7C#0sbR4uVGE(bliGQ?4MH>t78aD@KYKmmVPsG<* zzmVpI4TY-*dTJIm!;pjmffV(WMWqy*nVA#94%OT+&|oX zHdFOE9n}g06QXhR#gwU7uKr{kb1cgfMBwggR9&DCe;hJaC`9Qw9W<2vmIw`OE2&KB z7e+1>D`X4iw3Q=7r-kCm+dZysX%Fe(&z9{-y|421tb1G41}r)_Fdu_NpA3&%f{_Ru z3^5kg2OV&7@Ou2CFs&`m73M&6V&BNF`C=drS||R|Rr>|(MQqYydV3=o(2V+_p(Vf) zUXq+{!Z?P)`GU_X7^&cjcMslzXO&jypzY(Y{cy}_?rkx0DOe#(FsHd3zB0`VXYSh8 zu-4fA&SH3)is!=HMycu`HtYvLB+XOR-civvlNtY^im$}A6jP>PGy0NcD$FcXj1Oas zvRftuu6(Kd>}BZ{Z?j|z-pAM$Q!68`SPzWb0*AJ9_W_^ip!{mcG=a-r5y;%p z;jOH%wty|zg0t-8#?!*Y;&4-c!?pbrZXZpM_kdaa&O)J)t+GyLEaAnpkKnJCV9Z?W zRAh7f7SXob=Rf=N*I??Df0oM_v1g|xpYPzRyQq<~ahDFNzq`$e7ipX}xm@<&WPP9Y zDtg^z?=IyKwiQM+GV^_{tz`4lyZPsqq(oL>XMhg-&-VDLm4A*B3fHuM{(liJ*hgofA^} zAT9xN<|WSg0k`Gm-&WUPeO(oJ+7`@BCFR=eI_VB9K!&->&d!=%RM%CBBk6;N77Lk! zy~H@j-QIq)xF>P~2yzx!Ers)&X@;uOOsZKQu`AS=H?d<={j3^0mwa#$1~ zL4GKIsB~Zh2n-Am~3U^!dwk@hRyK-NI}z84m1ay$B4QmhZ0I2HyHnOubbe zUs&B!z1+)Wy3&;tXvJkW&72%{^W@`svxGc?}u%u*xlUs#bcnr0SXHxMhU^dUSLRTyYBR7d96XSl&`DI6KvK@N(mI*Nlx$qsD8s& z$^d(Re`+ZQ)B>P}X{*x9as4>hMB$1hdas1%nh%@je&i3KO#A223Lh3JWaq_ekdr}j zNRZJ4>`Bg87&bW*8{W)VMqPjD%lD+#(O)X1wmSw5$bRky;DT#?3T=DP_mQqNq;kMb z7Lt{N`@vg6nGRA;r`1oU1XtVxjRS|$eeLBMbZ3XbrM8Alj)5k4%)<|&HiNhy9N1)G z7mP~JgAiz695j?XWs3zQuv8Sm{vHoY$1aEvrM+KvZbDU=Kwy3-u33#@4D|G1DNh~G*m;%MU*bKfmhrs4@vkHP@6D^$7ksy9iel*``1o@hGt5f=-YVAf19jh|4J z?cRyUIfcNh3+Avk&d(r9PX)lD{nz>g8YiVq6x;B&^6UR`YGOAl?FUlhWY;xDf42-& zt{l4Fc=D)B^(*q7d1=P?$-s@w&n6g^+{&+n_n1W>-Xf6Jyem_I-lCt-g+}qcIxl57 zd}a-gHpCWN4Al>AeeSx`v;#O#Zemab!@YwEzIxFgxGeA~ihTy_0_%47d6!exka;|V z(@I@eLqF1gvi#qW!;3C4-i}Cn-t)P9P`JlN<#80uGNC#F;Vm*X@M1OTOA9Xn(#QHP z?#KUG1LjI_WA^4$x?|-LN!pFQel)s%BxubXY|p>XbE{mdj-_FTqc2(59HUb7AjGLJ z&PlX@`N~-OD&gd)a1YG1Ck`oRFK9&^3z+b9vE;qkF77J1emdYL2FbF;{m3b%Oa>_@ z$Flf8Z8m-`51i_z-!R|0Zd8CzVTIoH7K4cRv!fU{1@u~ctQ~MaNcxh=?-`WCa22rr z$hN>fQ5#Bm;3+qhKke3ZJNG>mV5UMhtZy_;q5e1P|MjaQrgEHwGf8%3mr^>iZDNEk zPcc~Cxv&y%SKfUE0$~uiYFert0OXsT6hxf_Qcj9JRlkq7?@wsddFpVn)Yb)(_S|zc zOcMCRriq~PXNtA4f(qcSC<%1wLY3HWgq#wkS$W+_dLKL}6$72uc0F+yO=&M%GXXc; z&3)ctZ+n? zy$WDwgEjhor{j8tsV2x#yBEx2)rK|q?+JW=r}NiG;n%c0gb*paJ%QHejXNA4lZ9_% z0@R1T1mY98KVlXU6UC%m5k8z&tv*kt?Ojs!-)uToCiQE#o^noQcW}4~L9!%qKU&rM z+8p}^97_Ty!WJC;)a}DXeW59zVij9I77q%)iru)+Uz4M?T|fH->)6LE1X1I4xt|Kd zrNLk;nUP+XuN|d-mku9}(Yi>;ZaX#B8}OC+W0xc3qcya*z_-Tj3M5M%_k&QQkI1Qy z&Z)$%{aWe6h{QMhz;!#>(Zq@B(kxAVs-P@4Ytl6yHwKm!FD%8RQ>Cp(;Z?ooF{PGq755eA318z&V1;*(P9npp0hM^-tZcuLBtW zm`qP&!FmPaeFYM0$$GnZ(t|E1UsQp86M;xW38fGoy{VKE6k1r-B>w90bXhJLWK<42 zYRPeGt#s(FmA+2sI@EK&(%%`(2%zZjRdX$gMSB7n{=6?$5d=W7S zP+~K$lpfgGH)d4{vUzF=%-+4eKgHY^uG@FE+93IzBfP8v_5?r@IXQ^>yi`#?$Ypj*iEzZfQ+rcn@_nu;} z-}z%R-WCvo=1B@aG=tBY+CT4A|M;6tE9<`|4Cz&AzK+Y472QfAKHieFu>IkD2*b#586Cv7(9IcT^S=jXvl<4&H+@~r1d1_6|DiM`z zK!D2I(yOZ{Rxv1+^#W85?IWiIQKx~F(`fU$zL9F$*Z&SWi*O-HWQukfob3osOpWwe zpk2T+*+d_P^(WI`NH-Byt$c->k7C*+^$@03_zHj{CX1<|Z5>Q^Z5Sr7uda^E4MuNX)SZ6ebhxmYx<%>}e^p0-(bGXjL$D*; zT&Len@*X(f@eZeP;=>HdA(&)7n)IUVFX(e15a?n-=Dj3Yed)4cAb&vQR3Pf}&W&RA zrh19+%ng0esrTTQ{rEFlyUlcd(Vtpq7NP0NsH+smYnh)NF)EkQUqi!^pZ6zc_J><# zrR=>?l)XU$Jj5Xl172tBmv_2_YvL~OXpo|R;xT#|S}GTCzPnTgaSlAVUKq=)QS{cn z`5GrHYhmdL=(y`*%I;A zc2w7M)Cdf@+)slfRCMKlm*QYg+JH3x10+ZpiDIh4egdr}FtyOhLhK3`p}{kcFU-6) zlI3)KO-ar&!Qo&Op61=*2RH2^2c>ABl0H$A44SSuk4pHJ%w({a7l1tc<%K!lv zXh%W0lx1rP+ymizz_dKBW!q4AZ5aRS(B1V&i95ZojT9i^2$}X&>-W6IKR5=Gg%Oy5 zp`pqaTxB~>WV;;RK6k&Er`jn65uH#AiM#M6aA1yUGGc9=6OwBEEXl`u6!+to(ZmOF ztAT}{<2aERMZM#Cx`Su>s4t|r#*r<9?*1$s!@Zel!b-KhJajJlLksQfs03A@zXHUn1@|o|7x@1FSP&ZjS@n)0 z-J1_TCHcaMEu+G}x>p*Ay!XQ_M1zVyywq_y^O$MJeIpt$C8t3#WuVA14D31zUS!pp z=hDJrFVgupgb3lf)Iim<4@N4CJtpVLjo8O{229xy7$sYmN0Eocgw8wMhTscroE$Va zbUF~bzj6kMbV)C?e@6*%7xIxSMe{^4?;|jELBGQwaV{ZrzH8asE?AsrnCPg*P$v2O zlcUk}3%_9;;%f?G$45mW~Wl5I}W2>MY8 z70zS1`MxD(?*|+|$5pdX;#ac2|jXPy*m)OtE3+e@34B01GPn*-nO0yg$p zd1Ey~KcavAugUF;rIZjkBke<1ErxFV=;{eCL)PI`ZHNL5ZSa#23Enc36W*p4^jPrq z{J<15S{3BJT8w}sXg(jqp8R%A*ccYmN=#-cVL-Q zd)2(*Zx~8LxWEu2CgeIsJs6J4C6FUGv$Q}Q_+sjQJ5>_qToUZOLo(1lyLxS2J{auBNq`l5N$(4>UWxkxD&32og)#varuCaBchE+`OiWGVxb|SpD|t zUK@I>1)UpJaM9f+=1^}_kyct-5_5K^`h~*^^`L2s;+|uNjrxW%ZWQ+|1b{1Tto4W) ztrBt}gicWJW@FZ-A~m1DQHgW(*Zpvxt5?{z;d}#=dYx+F67%QKpb*|Zhbr6Q?q~Mr z6JIR1vqqy@4#t|JwMj=vokefdohq0o27IsiH)~dpn*l5#yxv@CQ2l~G!Q2jxUwhc; z!)zk@a2QABw}^PKe2MD`<>$Xx9r}yaPc`g~e(bTFyOKhgSSJGaNEoF_mJK^wCW@;T zrZZRMA%8`G?r#Y6u{Texe&Y!CxYfBN^o42UplRsf+j-p(o8Y3ZLB0i_t^|;^ zPm92fE>bhlx>ny;N?rA+0Dm=z)fVpCeD3i3-Fu;fOIJS;W}7G);@xN?31(kTJw3<~ z&YrgR1^YH<7pSJc9{V3onwP+H(ijh2TDk8Mw)v2kzO|Q+r6S;)w)0MWFf~^d?xzs( zTwNhR0huT|4humg2mn?5mm>mmsuy40@U{7@Dt^C@cyj}Pl81J(afQsi@q&D+*;s`= z)&OD%H;o)H4IO~$D)!5#H`%B~4uA_a!nd3mzb1hoL)z-OD#y^5cYU$NMsxLU<*eh1Y#FJ zm>j%{p_pg6ePMUP#CsmamQ8C!EX8w*?N~$oyRr8c&|~xHqq>Czsu|TYo~_Xc0&CS% zmn*Ud5k?w|3+UF$3&LVAj+T<#KmLnZ{)yfavTUrO?=Op+O=9`atunDHtmW)plJxkd( zS6TmOktg2YgSp%zb9?p>3MF=6HksMPDsSm}Tz{{=_3A{EA2t0G4ox|I>=={4W_&*4?;;nt&ctTUv4P41veZ*9S9M zKkL{(`PB6IrE>|j3WQss>ZUISc=HlALgmd>;CZ!1n?l~wHHSW{m`!aj1pTCzV2Azy z`$+m2^;Zw&^Ah+IX<$xXxOB;|N7Gne28-qmvZq`!6rO+z%fDKfSnhQaVwRcmOKXt}s)xLm(& zSlx1zl8&1NF?jq+EF%)d=+{%g33{nusg`12F>oUnH)>4?r&iU?Fbr!L*m4J-DjiyQ z>fic_XnTKfhrZ>Kz_r`{Q`#=dsy_*e(|*pJs74-PRC7@v3i!ESjFT1&lS6dh{1tcY zud<-AuJQP5f^<%HGaYkXSP)mxJrm(454$ABz#%oHxhPsb3qef?wI;H4^aIhuc$wb@ zgs;ecJ)~tV5m=0xcgg(jt8Q+P7y~Eq_`iM`ldD1f)f3~0d zl@f0J6Taqf7&0_Y#)x9dMUm#xp1j!5D7sOU3J1j3o~6-LJK<2FRS@`>Uy%6Px_Ps6 z4Sdkqjam)DsZw<_0HgTuOj&83paU}TEIuLvPs&+vwl5`@BC9=`Y^NepLmi-9vY`bVlr_d_9~kd;OLmzP!=w!>15JKWYvZ9}|Jsj&Am%rFCc~4bAr6#s#GPSpLqA(BvoVo#@^o%|_AkSO}_3ae1;| zA>5T$XBO|%)9KhsckE?$1-M#bO#O}gKoP*Yn0a*dZ>50bk2kiZqcWs0cAE9#aQw70 z$N|naA(|0a=QIr23zBfGn0s?PwI77R5L5vcZX_;%1>s@LuZQK*ONES54GTGw#Pd(K zo~zdrz-x!pOXABoZ<4OU=>b5gLparCLu#9sBKj1JC9_pKhqMkjywdx&*z)|yHs)UZ zWOWOeBy|au5S#RUIyk&yoxe^9hZDNE5l85R%atF5mjLsd$wM-G2i)BFybL}kTuFnEU4QAFQ#8NUni<+ zy}GC6@c6<0RQV44uaWv6qm7{vtAXZ}W z+r9ptNrdcM&Phl9nEJOySE}}a;n(}=q+nw%)vEkqZe{!3oJI=WMnLA?dHoug?A@!n z^=}5oDTcthmf8l2i)sz5$G!T!y|u=Fti zSL563Av`|$ei%T@N3}30PF>Hp2iBl0tZAxI!d@3};`?jB`!{hz#1WHXX|Squ1g=oN zMtM}=-WON}VIC3G&Gxlkocr`Io#j^+eg?p;7SWNr^lCQbAj7n@u(e6Fb%ybtA0~Pz zyf0>!xwNAbpr#xYhyV^J7>+<4rt{y%Be4&8nwrH;h5$vSJv_jEg}nOWGXQ+b0mI@e zAX4f>v(A5uF7^=SMItg3z4jr)!{A*GzywsC1~@x~qc;+OeBquEM(0Xq;KcubVe0@y zupsTX{IQGPR@y`u$;NG|cW6N4!DGAEM#<@J2!*rvo0Rc_R#UaPp06^){ zEn{tdi4U;@uD6XZkXdIbRkl0TZ^6zUaJ1;HEEFKO{xz`RS2;&h{8PmB00xWmT=qES^i6pRLe8M{U7!hX`3&ydGisWMEw}Oo8x0Q8 zd73JSj+i>U1lUgn!l_WD-o8@#nj*{WB-h}%2a}pxuxx|#7mCn z!fSAxj1I+^1&_<9O$r^novhH^J!vR}>(evQ;_=z!es% zz7S?18%KGiLJiUeX%*qH?<`N}HJq>K${x%1JKV~yM|^RuZe>^Lh712%Vwoq&0D$O%|#Mo8o}@u9;h=C>RVEQ?cEhDBIl;Ai=98Hjpo zX~m4de@tv$NW7l{wAZ3GdXGyFxP>9v^2@#KTS2S9$yY?qf(SDHsw=%u81P$dj8hDN zf$H}(^=e5@yrp!WU@=m~J4;O`M!+5}8{QCR%GpVGTq8at8W<;|iOq1e@#=8OXe7`w zZtBhU>F^lr2|$q^1>blAntlaQVp=ckGZ7`%LlqXGx)XORazQ#qoURv9?Piwr#) zFZKv|?ejDk8cHQMy-PV)_;iW~*dG@R__j;z5U@Y@9DSo)g;Q@oJIh#-7RY@rt$P1D z#;z*!&^maC zVg{O{{yv~Md(=}^ZrLWQi{7ixtGy;U=!y`r3kYpkuB;|aLDAB2u(O}RzEQ?XJP4oOri?M?}qW>K|Ok#&uc) zHE(|Ki~B7?z@aW_A&PUHrAg@88knfxJ1>asFy+T>;C>SbH~Bo=J>WNT6j~;-kz6^L zt*ek|hS}VArc(})dI;Q*20`DQM+WhPn*VrD_Q(6@$8{^iM`2}0WmJ(AacwLYM|olq z=xkPVuvr4>;3u}`E^a!1F$l!=ybR>pDzOPWb596f-{zPeK8!cu3n6|sf6}fy0DmPK zBHFKGT)il&0K)uRH^#2h0F21i^ic`dQ#%sGZpin33ngCZbjTvY zE>*3Xf&%@^ED_NPcG&x;j~V@5&3UDlY&k!VmhCfAjpCDM&-&t?K}~? zT>j$&UrFyQbWWT6Q&YKIo7dO7Kz{xqkz~~!4Q-f0AiqgKel7S#0Lek|Tx0Kv+L6+r z>+ReZ?|&|&TjHl!GKBL;>u0M~lTo1Z-wbC5$c>Vo<>1&7Vbtpm;GWp*a@HpvOi{)N z0s5%wgi-V(a_p`>(F;xnX4-xUmr-}UBp`h(ew^S<;aCpVi{A6JxjjUt6s^Sa){kp zcMIBl7u4*KqdzJd7~LFTn>ardW)FN1Yn=5q2F&a7=_(*u;|ZsU_eoYXgxDFIX$w@c zy7N0zv%6TDJNKaRv-8#3()-)~zunQ{_CMcE9xq*`Q{-6#KvP43t*2()I@0e6;)IRq z<|t1%2B^o>LL_ovaP=XIj-ToL;`w{Z?9cAMUQ3$wvM^Y2P`UFSF|g!r+{mZ!PezPJuCbE9P)X{MQ4g85sQI8R0^{dmnX~UyU!g#$Fu3H< zO69H`(7t%JjmQy80WIKM_f?ylBL-B1y6k2&x=)F{YY8lGThuxO(0qlWC9~icI#HLa|`SG)|`^rq6{YTvHq{y zvV^5NA=%u$wIRNtq_&2gGLNOHJp4r`>1L#7INPg$C@?n1VDCwgxxaJJgMG9dmdlk&-*~e_C8HGeGh@fzzwIz4` z9Uy%GF%Y8DnS73jAk%pXq2}p>3{sYec--vDJ>{Dwo87;sUpVkkPRFe!?O~C9It8`3&OOHJ6 z*11J=5Mt}ZssH}_wwf3B;>29+j%S)adTJwV!)#?=iKeAKbuw~#MVe%Ao`IzE&h_46 zYduRivjVssBD5)5;xymrPg&$?ski=gFJ8ZPEf-c9RN4EdU=q*=%tEQU0^hWK2k$fF z@?Z>K>oA&r+tBviAD2mWe4RP7=PptcZ0w%qL3b zusf0u=mYM|ZDLOs#dEIhxCW!Z?L`N)()mLvXd zmPYE^+oU88;L&*11OrwrFgr<=j@J1(2XU-kyT=ypq_z9LiPdcW{U!I7ueA#`h1)#4 z@z*%klO2s5Uy&vlkP)I76M&OWs02l5wb-XRS>Pz>-KIz;rv1?CxW}{8<55)J95GvR z^OPWt8Rw|s_)0_FO$*3yJRu3QQsKoLC+AXZ!R6W|Bi9J7n!~5|+&hCO{mqXJZT=n4 z?-mXyTbl2}X-3I6&d*(lCwHI9^HpKv7g?K)g-w;ZLg{dh^ngF{24qAi#(2P=t?eu2 zP3p^+xht`*@7rvAm48{zC+qPa8ORFls%E_Lte`3YUd1?V94T%N60FopTbfP?ubNK<{kh%;I(DUnM z-88=*MoZqd9ARl2uE5Q!x;$6c{nw>&ie8~$$G$CoO?`s--t$}glOO!1cdy^r@`w^& zWo^elGA;Q9{(9hX`jH2~#Q8EDGl>lX@vw3oc&+MwN_qzU5M8f4!F9ps&B8T_fLlf?CecWfIz zyW^-^$=7zQ{}Df^PIxD`l2y+csR!A21JX+Qv|+ZEg35D7F;b0y&8zdDaa_$H#6<(q zL4yCY^QMD}Lq0BDr+$F#bX)g}cQ>RH;+-~=ihph8Rj7{E|1&%!=+8mTJCWb^^Ye0X z&mQJupx3W1mUg|Jmt{mOl*`JH5|wx|{_mc3{%|jtbCina#y58mYdAP-ZNJ6cx~q&= z3d zllQ-$u9cS#Emy4tAu1u2U2M5SW+w@dN^3b|`C|jM!yf6fd|b|l9Z7tGw>8`30(o*D z>rGyduCK%cBHqaj3*^SON(93_B#=R0jb2ZCfK=>=f6cOe9?!1bXCC^4TOK-NF?6I( z7r|;ELKI@xI_0YgL80XdUWM7uhD-pRGZ!MX0;Q4kMv&)qOE1344>(`3`G+1zE&&#b zD-a=dGmJ_!f5cfBT(Nz0CU0|Jn=4(@=$}xl6{7CE>oTrp94!~8L!$^lMx3236Fcsz zu>#kUF9(Kc4rK8K9ue%LZl)BUy_=zASI(0Tb07U>ax}bE2*|}ovCIPfNBxO!nB;_Gvwi_nin^Y#Ek>-P?N# z+fSBD)S=Oa(-Vucb7x{Fl2ohVWrX=SQ+9=un>JYl`+dYy91mOM4-IJ|M(6XhJ3U)V zM^u_ucA4i6eLYApuf!U`Zd``Jc|25;Im23BL(A-amJq36iLy;HtOMM^5UaJ2!{9FN zkRWyI86g7h%*Hjms8HQnVW2&{q@Fa|k_>}OTysxSHtP8V&}h}2;j!!6IEgyAFrDx& z?j|dh&(9h)y`%B*#R!YcHDLZ4`7_q` zw<&#FF0KyOqpz`rmJZqAtFia1AmgXzbyOf3%__IBn?sPk*VDD}hBI)I*HWdW&%|0++O8D;1|t)3(Tsxh@>x z(9rm7NASTXKkEU@M4VV1+;i>l4(=vP{%p;bTzckm!*+Oa9j>mCzH0hIi*^pDx9C!i zlS3jkonSN6&X`q`Wnz;8)$DuCt+A8ModEXN$eW^@81By8D`@mMeHFL=PLhRDMpsOO zGy1{e-!&jQf7bYt-;#VtlSw+Jh3!00O&qoAG^@<#^b&1H-4S0Pgnja0t>7TIgF7TZ zy=7EQGSP}TVsG>cF_S~3lZmb z5wk+#^@AzS+9AZ#>qloDEY46tw#eiMJSz0NakLve-GRLlNMyXoOu_f_n=^9_-A``}0AdI1;V%s`-W~Nbn zHhP=d)pWR2lnEQ?Pwc+=KQC7l(p=k(8ZTPp>vo|{x zZp=GW)95o@-V30SBAZ{LP3)6tA3E6CH;ifcy99TuRib(2ZQ=PhNWbhDQA~ga*}qaE z>A6HwD}vH93}5Kujv`3-cNc%KIuCi@drcnbj$li`&tL~wtcVHj6U)k`g!kwt?bAx2 z((Ere;DY;dlT{f(gB`)1ErK57Z>zcS~tDI zgp$9tii5kUeBay8=EWNgYhKni7Tmuf&*kb+`y5#0Zf;mGH@03SAc=xWoXP5^39bh%zAl-9i%Idp` zPhw|k4Utzynr?IW@Ma3+B1C!Zl=a{Qyo@HMnIq#RV!z~g>cW1I7=7i~oho^K_VCzU zt*pI;=p%4yFCq|EJu|>9!)wsc+%MVdMq#Sh2f~{~xA|i`2;3skV8)<3|3)ks zq~D;9bwGcHWS4KWvbD^ZDDx3q&PbWtU>E{y^)E;Le4}`f?tgs8?Q8f)ouS zMp$NYt1!F+PTKfBy~*MwtfXm$b$%bVOab8F;M@KDg7KiR8eBbCV?$1%3*seuhfkW9 zwdzb3IV$O60%UoxZT^pI%BbNu=J>7Ol7pV&OW!RbX$d*@H}f2oLE14_1qlm} zqQ~(zFM<#q{7!BxtFnrK))AMdU2N18pGh3wpWS|)5YGQ3r=fsvsaK&ha^ZhIZmhP0 zf2TcEhS7lH{lq06Qar_>(3<2(urX!>`YdYw#3`eFRX8T30||uYgUd=*WoLq=dE)ci z$1F|tNL8lK63b;*y9Or?qAfhk1dA}va^w~L-p{l78kQ1d}TU}YZGy&WtAp=-Fk_HlV73YT6@H7?Gv0s#$sNomTj z=eJxq{zpEQl&FF$H5E}O*V~)!y>k)FFBZu|%(D`U8mLUrFdFpWSc^fH%x71H_*qxi zN)eU0m0ieOebnBK;O;y6THnwrP#7NOTFF=Ce$0uXe!xSN%P0r4vzH`2lRcODT?Rws7V{kYhQ3c%T`7IfvZFT-fz+gI1VO>qKPb(XSk`9d?oSt0V zt-}|vdfZIyx{?qhYsEd)EhskgN~B+@1wF{O*a;mxrYM#Xuw-qby%^5Un+bNooPBed z;CI?DtV}iR=hK9G-m$24AQeoHkMInm*FQE?{)I;MDH$OEM6Zj!o!ft*j?Gb5b@7!^ z%vPWe?!>Wfp(Pc?_TB8nH`v#M-%~_cDGrvjpIiocL0;=tEiB~oNWYKM zHfgaYdhojj_9{iDOYOkO{((BSf1u911==$1q37Zc%mM7_89k}s8PtHoO$p_lo%M5I zC|ET9pB>YQUu=OSl2`VsTY*wo zT6fA{dwj$M)h&(q5bjg!hf;lN);o7!qqm>xNf&bX@MQ{=AVh`jlnvnoe8xQ;FF3Wf z_p%KuNHQt-a z`pF^lU9|XFIDhcm+7KsRL~)6t!GRw9fg;L7Z!lb7|7&1nknQ43@6L`oo)*Td&?{VV zHI3VjkIIymBD9e`(=*yP0@n3`Fv{b?Try}^k2Zb!qIgZeW+@AoqCo|Zn(}yeIy{dy zsgJgp>XLAPQt8#>GQcyzT!akRv>u!Um?t+yM~6MDogGrbU@oPKZ_ z3A+GszPRldW~vR}(Z+caZ@X|UyBs)n zpUf+l&2tGvP~vHbx5pjFEGGJQbwxQmIqAPOUJ8YHd5fSbwu7teeld4#HlL0FkAhYk z&U_L5;U>Nf!h4}IPnaa#MK@G`cFiF8J>;{vXLQ0u3#7Zny(1B+X*R`)@(8jT4pIbB zf;}55gD3y1Zt|&p1tAG_VJ_pOZ1tdYu&D-IMWuUrfcgn_qjk%t>y^vUuA+;~!?0qd zL{<(@Y?%x8p-v%SUEsO5?mc>nSG0*FauV4S&5H55V;%!m!@#%0!$g2ZARlelYh-dr z}JL8QsKB5%Hv`@XKHpTIH#khKIoWZ)pY!>&Rgy2ddE?sB2F)c!3+Vd z{@^)khne&LVcw|T{7=WX&T53o0U&)EWcp<>Me0i&B5aD%u1fIv_X)WK9a;@IGrl-G zS0-)(iLFea*?pm9HfjmOL&1g=57`+)i7AWPfXV9{jI=k4K?>^u8_I)iFewhfpi%wf z=9$Qm!U5EO%z=;4y zu#eMf4tDQYc7t<$7kPkPDdVb3@7VP%;9B58bO<_&u&k)QMHw+gZO?xN$!_ZKr5WUI z8HXpL?v{(L`EhjZBeSWUF^?w8;UrI^a;+ntU*Rg-V% z_j#mEsRRMd4HIlV^8d`iQY;uA19NmpgJvFF8+?D0kHg=mC<2GKMp`*vr;4@Z$p z?oixnz;YNwz<5|XFFJ~vEUC?RTISO2o8PFLb(yjb1+`K2!6)sb&}s zY8``&(Q%w=`H(M^qrF{g4Ke`d;f7dg|lJ<)$MjaC6#tNf{vFDRT3BXD4g^q< zce)yQnWDVrh;XLXOKmP|)4XIwX{5o&?7X)Nsp1K&97|?zUN6QnC?37O zb2YRq@4UUm%I^@q&+e;)LG4={l^C|kcESV~mvg%#fN5K}6fiH1FcFcpY_bz3&*MEB z`3H=M#Xn8^1B}-bTcdYs(&1!(18$cpe!BT_-+!vvel^_4oR>z9AD!9QWZ-x=@vQ55;WK-RC^2xym=b}E0+UvuPC9w1gTARE&M26 z%=pZnil5VnU(Z%@-I%Y|@cKWAu;o8{_qFEzb6|Ba{z4J9^>AS2L){f2_Ylg4(KNm4 zeX=!=+_QdlodedZMwbS7Rd9a~O0Ivf9lwS0P_iDzQZDcgPsL5v`9ModQyBbP8jr#E z>dmR=nJdd5!Ihe`3!}zY^%2ice-?oKvj739ten1ruWm;&HC6Yhp5RiZi!xz8IkqPjE)~yz*iy(R&(Qh9&lmI~z89gwyFW-vZP)H**{86_N zguti|TdqFOj~lSg1xKC?jZ~*>A337Y|L@#MTDe8jgiQM*J_??>PtA*aroLwZ{f*+gC z5mv~>>d?x9(GwZ$=*Th&dJYf6uH)R4%HG<&?~L{N@o$2=R}3A?{%3)J z@dl$iYYodbJD8%+RVUmAEQfD=uRl(iy}qSH)}>l{yz+nXr3nAd7+#Z4I*1guaA(6B zJ;%y-YFyQ}pf=tix7xa%ru@$Wv$#kXs;Y~L(wurZ&?xUt(fn4+IU(MK#g;@=WAQn@qQWF zQ3MN6=Y5xo8>17%-ZmY5m0T{0Muh2mvM^USviz*uu7=Lv(=^gAnUeXi%!esc&;=p0 zWve9xCt)%c@{yeEW-<)<4d5|sF=grXcHcn@?GGmr*@NHm=V83Tn-3A60^ctO=3HqS z6E{bgzqvBr0J%SBOF=PdX{x??jlpcW$L^fAX`m`Rz$u-KVqX~k06FG?97r-pFbKl~ zrUKpHi-kxkiE@N;zB;=0o#lq?#QDp-gD`rt{aOZRGGLOUbns5J3EGRWEN_Wd(4P>0 z*p60@BzJ14*O8L;sh}Boa!qBE*@~Wr;M-`i4_&69IYI_)t0fF4q06+*D$Sg_ZQVZv za;JR< zK0XkUO}=Te`#JY41sU)-7VJ3&qh)ut0MFjGY{IQ4j>^U8&`M#{z=6lt9zAvva7{n$t527P8X+~bbMK)Ge(`no8fCa{AJ+R6 zRqfgG4Ohe`B*vM#GBYObg0OodP`esZ&-?PSHdE$Fi_&!mVV#1oud&_hkW-Bd z`C~Qz5Eb}`sH0!6!Z-(3>Pcj7q$$Ev;~x%5Ox^>R(#@`Pcm%V$q1GVT0eq>Dz#>(v zVYbTB^1RMc-S4*G zaxETvmO=7vT;b;57%$%O_YDvg){2}E8)%U|o}^@-tZ~cmqwqvGzaBd!dVWe8{xEB5 zBOdWdv2s~4_X;}-xP(j2(ylLsO7(P)fxl*Ovgb%5EqK+?J9g%6E^Dpp`LfZ$-_W9@ z_oOh$N(GB9AwI#6Ux`eGGyM3eW8KRDBPiD#O>2Cg?e1p6_V9lb!ZUZiDpu03`RW}y zBU9s|@MlNNxFJ#5cWqwRxa|_Nh6ju3ibf3o8|kc!dI9I+B(sxOI>AD#C<~~=?rUYU zp6m??@#%(WTtQxQIo0v+|2iX=F_BT9Z-+1b7TebJWqOL%AhwDf)VS&%P3z@7LjKs| zpHGYbbwxZje|2QN&CQnt3{E(xtCHch z)4B-A5qR%Eqaj&BaPeSINK~!Det{$}qxsmvHPxMOVL6z=B^QGY;Us*Sjl2e}HD_nm zCxS|tgg4TKc6x9}>#-wmPYH?Qb=6ZjHxLE>O+iSb8$b%;i8n;3VqE2zqAQ&32ho9z z5q;NSJ+TSPzMa;LbFB3+PKpj5ZnW$TQ--_n79}Xc$bj3w4|6>%V)n-2y7{jgk0WRC zh?}n+WZ!x%m!d;^7tTy4epw(BH-#iuRS`89*MI#HxN10*u2?IhpxZ5YqUIVaXxn(y z@_n1%^6&R`2zrWwtX25^Zk}=47Qo9evW#QnTYJwM@?o61jcgLR&{8Z}c{=nzE4Yx@ z*Fk>i4i*9JdUfRuy~~NBYm1ZqiFnqXoZR!TQ}Zl6MId2BN}NHNq66!(setMT%N$(g zd#Qg<)m8WYrK>!=uV#x~Cn8wQ?*-YODl&{&f?R_2aF9}gz+7RFwb*p2gqr+gx3)+% zay$t^nCer#vr~O=8GzhH=PWMsmW|us&%P zAPe+JbNYUh>AT$Bz7K;(OGXEV@CSOBlul9!g250Dsw;yAyk>_d2&`{G^a+V&PW=`M z?dsvPc8Xylrqj-G5q`vG7b&2mTm*w2yeuLZHkmP0j=4UEi3hjIPdc$P`7uQFlsrF9 z2iY``5M(A7zs#G7n*`od4SVSBPi}Jz%=|Ox5-}%SKDa>yMck+7mO_<0^U4B*W+2f* zF5ay61*B$1=}BtygGi`KD@vPdxMDkt7-PZD?{o+in4i2DmW%D9k%cp!h+SsM#EB)b z$!$UVM)V?yvz^*lJmYe*ak6 zqRDLI=*MOVrhr7!_sgm<)vrBENe<)2^`44&jwfHggWS6@ISK)wCmaDPr39|AG?K7N zVG4`{=d=k<@_!)_m5gyDgS5JR*0V)l2|^j`}fS zzUN!}t%5O$WRgUe;B;>$ba3Ag4$AQm7wiJnYQq*9UotCob}+9Z&M`YGjm>D>KW{6qov53hg@_T^$YNfDd|Eb1ot47Hd)_Q%^;AiaaPmTIXA!FIy zHXwyaLYP6B+!x%vuub#8=`6@Iqg9tP|7l}xN4knlq#>B#TeuX*rn#p12xK)u5h5sJ z)iQ*GiRm^UDyS!u-bdk2H>4|%M!V^~epkVmOrln<=tVdF{-W>pVmNkzZy&{B1<#2~ zK(<2TB0c~^I~wslHrhO)6Lsqrx!Zd=?MXymAL)WEB!ewPM<7hyu|@e_-`*Qr z@pM$u?spQE8muP;l}9&Ows7`#vz%avzY}y`V5(jVCX#b0e}s2~9jmt~?NxcjPn94V zTtmszD2Hvj{{QoL=dz>?b^49%OY4QXE}02BBR3mV4B)1hw56K1`-xoy)hB8I#m1=M zZW~xgkt(Lv9?K#O>wQl)7Py&SX^c>p13kS8~2=l?D z3QWI}p5&zJAa|cGXRv3>jmIB0Dq2O~vBkVJ*t`5ab>exd18W;VIMD6DDS&B-G{?3t zuY5R*@yrN^2a|SSS?yn`+nVSVIfsX-6G6>(HM$Z7$s4LU#x$`FVc(BQBrN#ho>B%0 z?hlx4`EG47eD_muZE>u*rV0st-&l5!4Uu3b2|2?(K}W4hQbA#3H@ zr0Di+muXt%r1IqSF?+WyTyo4roEv~FwoKL0tuYKl_Lbfid*863dJ!-Syl@#}bI}+P1lJo}TB@S{~6_Q?fkr8ICLihece_FzUCo)bO@|z35E-T02vI28brs%n=Fzid! zj;VeLvaSkJ5(9k&6rGA?eCXkH9T-R=L&QlJnRTxfAuC_$!0L|2}4Nv>LA z*|^hBJ!+U1-l7;`>9rve&LpACxadD3*4(Pz#((?blRBnkH>)){gO&U}=w%wtQB!U! zY`pivCA*rZ3Ka|rMJYs~eKIHhiTx=_EO!0dutiJM$3< zyK?D$G*)m%E^$s#OnvoTeYzOR@GuaFv9$zPn?1@oC|3gXlxTEN$)k4q_pRW@ap1k* z!6iY^?IZebJ4UQ#r?df6suUKWOlUc#{_!g-k!WU*luPzYm(Cl^BmWX)qiO@xJt&kR zFlP?^a+<3OrBM5@Fl=h0t4^aKxc0iim@zu#1)18vOGIJXvqVp*w?6)mL?m}30n?Ba zyC|0RE&(%rS(rk$t9sL&&j0&;!4?TP6Plx-Kqa0@e^N!=kw7G@TyTfF)lcZFj~Nxa z&;Lj?IaZXscD=9UO`jqrk9WcV zLnCGEfBJ*lWAz|0jUW|R#}=sldebq==s(fI{}Dva03QA*qajgvGD`oA!kh0Yy%xePjA!U$hi$+hwNX6tc;`KZ2QOKkp~Zu;7- zZ41`B8usIBh%@%TD@4_T9trR#n=fah$AXJbZ~emL!S&;fSSchxXUb0lTNPJ1(&{VJ z;QshRiIod76EHGlzM-8wd#R;dRXt~^F=11{b8eb4Mj_xi7B5)%VqV^xWF03#W|$_KvVP7 z>Oik`YLjBDS8hL*^uvdC!Jr+}`jrR%yOv?ix1FGY6BXQV6Y|_f)fNcQj1bj0%8mQx zkF0q<$Za{~7ysPP#z@r7rq5sb>q__69DQUnK|?I)qrYfYrH<&|4-<1~80DpC!Qo+M zx#DQCm5-CNeo45VNLylXR6}%M#J36jxj;p17N}$@7E<>PBD0jquRoaZ)vcF`dvPzY zv)7XdR~v9IaqlVnK8m%i!pZK#C5`s}1&k@5EE5wo{Be4@ghQx{TAnO|@^o5R6gu!k zOT<%<@ZG-G9C&321s$+~J+}$Pke|2pNx2yJs1)<&h27TMKz_t!{0}(UBq{fBrM?nm zF~0nOg(xfG8d5xP-sjL&% zx1}nPl=Z)-r2iPS5!Mou-D&t4!;P1a#}0Ec2w`j&1=q})!uL-cU?H&}0eKia03=9# zDI2rnZ)w%~8=9g3qsQW!XUD#?owag?wm89{>%RxS|f1PP}RQFFyj6Ylnls(Y%gYBhe*uq-@G$&Xo|$CW z1b+%_;F`+7odm5yY+(2lGeK)RJkU-(5Yw5EZRzRngX~IURVSq%!Ird{pQ#l-MDR2` z`Zn$3ozms?W8W8UyoEw+4Mu^!cCMCQ>QwEk5_B?g5tMxBW)gNDqaWa%rShc18>z2t zC77BI{vLf4rX`$@&pRMa+OT1iZrDUkUjOrtPtFj`)d)#{)YkX-1b?%i<^LQ%@h@Xr~WsKTN-Bf}3LKt6|gtt&mIV|9FTYexSPZl&(NfaS5nr85Y>uR zDDyn}Jb?Y;hTn8N6?@j0go{C87^~r{aoFSOpAkQ5--(OA|G8_dclwtc0dc-rOqcf7 z$6|-}_jD+Cka)*3@$4ap=1B_0&g}ax3}Hp~_gQ_}{%?kxkbhtN0?oKq z6#DTfi@K;AU9ZmR(jdJ-JD?rhI2VP;9gG6a)Bv#Z1a0}Ga`WYKR1ekZ!7tOG{e+rr z)D1(+*iJ$W>xV?s&o^;0`fv&R@Bx;a;6{1-QhhUEzchf!D4aKFtKRS`iAw?mnf#p7 zXpmhK-Tyz|7nSw&i4n}!Jq=62WXJVhEtIyo%1?dirfyW?{Z1u`m43hZQ7kYQ|1QDS zqT(j)8mPnq!(`x23RkXF4Avir)ImMN9#Py)IFt3v8wdBkU_8+ulEQet)@ED_ltLF% zP?-2Sp4RYK4?h9Tq2K#;yKCjRD2@-muvMYh^7I?efqe{pF1B{h57xh)!mvGImIyoT zj^)^`^+OZj5Ql{jc+>cZW?luaf@|1)TRZ}&6Xb22G@0%3b`K+Jn_qTs*H;0F(&AkYZ+t`EBGaXZFvmVd8f~x7dIG-_f{iR(0s^U`Ld=a_!6p z(WK+_`(YZBa`G5{7pan#;?(LJ|I*?yvV-aG`@NySd{p9M!UL{i}(>o?ri0q7CLs>)750vy3IxZ2^aY%L8$v= z{&s5bewG3aOY5Tnzf)ine;w%!#I52@n^74qKVAYmd&@Mow1+?&-r4n|vU`fwoKML?|1#pgprJ(Zb`i_+dkH7)5W)`@ zNBh5D*xEcHnyH9YJ58k^IQcIoX&uAp{L=dKQrU0mn0FH)Vc+LaiASGN)Xj`YazYi_ zjUrI-giyl7Bb__x|{9Qyk7z>4oSCFPxe0&M836c z#!JjxdlE((+PL|wEMNwdzacT9xWGjy-t`i1(OCW@xMS0Q0|RajLBqV(oS>KHU~xnb z?E;m)AzFaqM-!lKn14U`g>6$v)4*sT^gk zF%x=!@EKCV^~!>D%t4TXNMn#}7+cYiSSf^NsB%BXi#$>8S*Wdh5%mn!P8b~;7p<+K z@z!zHpx0e$6Bc0MKj%fPM7$w6_{fBay1Gp^e4Fj*tRDVN8G!}DWnNyajjrLg>8Zto zjM_^(Oy7=?Icd`+EGqPCLW+!fw{O-|Z>Hgi@ItqGyTmT9q(pi>h_Zdu5Xxk?Y;|>_ zb7O8G?+e+9{ZaI~2=>(mf*{@RDujD6UhfKLa&O8WUXt-RYyI44d@s#;M4?(T64m~c z>HVA5D16s$)Q=_V$=zZ!e*sSSW{^EwnfPN#{$%`YB zV-akT(ceurVSQ4OFOaeR`5A#0R{l1T>qb=xCF{A0h*7yuy&h3JWWdn!`& zxj?xVoGE?%>9@A3w8)Lo56vn9O-ey=M3~Rth6)Edc&MC5u!oCG&fkE!?JH?>L9*lb z2A0kBnveKeU+VY_9*t(F^RZ$83HR)_xWx_T$lEhdFgcI3PPED$0Uk*X$$+( za~~W_Q`*Fca&KYDR~fyVK!|LTA;h&A6l+(34CNi(j`5D;U%s}Wq>XiaOTSRp)>LG( zoP)?OX{nWs=lP%USj4Rv6u-du_NO;-?Cwbi2+2%~kXe|AF6*niK-(?e5krhxmk5$W z`fj}g=UGN<9yr=LwMMNXhRgruA1`>@K?@eNikNG-Z08;CX zp#)2nNkqA2cDk2opK5*D{!{-TkD?EFFz{}V>lJJ2GrT~OYxpUY+pNzESWc};4fkxLGvO&eWIc6d$bzBu(i_VqBkyj}0pr61 z^W_&%4MDQ$-fSv7pTy)e**2FGvO7%U8xBg;Lz?DIPkTcczSSS+ui7&md9;0QY^N|R zf;RZ*`AtcgsS_}{w7zy;+&|Q=*G$>T+J$Ager9heN z^J1`Z`hp}Zy4-5j;-qrAkc>Mw8sBReKK>Qsr8mbI$eEf{ySGTS^ScU59H*}?I*#+t z1RN<_LPba&T?oVZrHG)(+3~PLWgDsfwRwj(MN>aMgcTf6#Z^zk&M#KLld>gM zWU8ZcmuRpQ+`>MnIhnb%6~zR}z5^b9^YRuqI$*RbLMmu*uXRZ{ms%%7v&3-N(oCY1 zZm1ZoA3c@rz0W}aff2Dn-|!uhZ_RcE5nau_29aqyUXau4?=ZTDl&*qUbhpucqx-b2 z|I@g1L}EcHI#47bP}!f{{bN-D2^BqqRu_wW#<>QR#-vVOxYdP{+)n!ZjZy|AEPIN~ zB0F+>46B^@{CWaW6VJk4ton=ul>gFY^&glcO~(6~jz?}T*q)1P1qt=!H@r-_lZ$(M zuQpn?ljk?p&e^w1xhHZHT=+*oCJd{(VZVA|;bOFwdN8~p*g=IM!wxvkf-TxN**LDn z{=KVR?$9XMRF7|nmyXHndzYbJ+|ba>$oIq@VOi!>d>>`ku-&+z4|n$l)2VmPZbJD< zUkNN zC*gyf7dV?2irFt9O^X)2BUyOikz=bV(-Wx}36dLpx+Y>;;>5miT9}1zGX8SRQ)dFU zE^wgX^RfrWq6C4WX|JPDabE1P@gFN|0aMQ9i_b?cWdq5<9bp>h0yXi7G75Hn(`|s5yt~oItM9geBK8^L_Cv6Ke@`g zFti*>-rlA8IGu9>&axphY=DRxX}Ii;`FOeIsSbDQ6w~V<+bb5t4sJoL&l>4|yKvp*pjC9N?%1};tWRV$G#_S4prl3bE%k&lp_8rhh6EZ?97 z>(+*an*m7+aT=zo@0wmbh_NTh79sJcG0)dGa{vsWP%H`BqoFSJ!x+Xgf!tn!K;b7M zxFTb3&9B`0MeE-oTT&`DvHQj3a`Ct>7(d-RZn>bzlnSsD2tH0yIu3cCV7rOVfxB`U zb{^TZ2#JOGT#H-ZH{MG*Z{O!8yfxyqblYfj&Sum8)lhza*K)- z(5_xGT0%9(SV%oNrRMThO(cuU;l{iVVQ6IF#{`STwuD zUJ7>Lz=MbCPxOorF6h4)zJd|uYgo6|bI8gxZ}q*fd|*FdD?z(PDrry6@;YU#6OAz| z-B>HVSoof_mgK{qr13Vm{G|mkeiHSm{MRyFmT!~&FyC0*8$F3+k1;+&#%&rsTN=g5 zdH`u9zxK@J=EQ>w`qJ=kWn`~a}kM7ipN z$0esM&l)UERg}KXkdd`ZdHg&B$C;xO6b*YP-DUCr%?QD8_fWWg`mT-@v{PKJaiAlF z;$H7@;PL3^x0+~5A-&uYyf=?a$aoi`3G=9&c6n#e)ZV&1JKMMU25tBhk)MG98tjy{ zwO6m%#Ozk0Wr{R|rFGH(>zfRe%M3-ZdEqbMjBDeBXVO|8wweP>j{r1JiK#r&=rq+H6&wV1Tv_sqv(_W?vGifwgbe}nnum{!y(G;I70+)5oqX6&>q^mQ52FPihe>Xi`PEmwCm2C4u3EI7Fb9FsTpr zk!|6W`umJ;L7v{$!4ewmHsW3(mgq1&qSp43M-?{(aQLbjgF7sWi(W(p(EfFRu7KIF=CcHpFLF~a39lZqr z^gVn;aRAD~gxYh}kfeNPy5FAPQhFhP9L(^aCA&dp6hixg%vAQQ!f!f;pYhHP>pf&} z+jqP$hJGlt126lT^WJKX2!9!vKy}GP;b4E~xve`tdC6DO-P)B~w2LfVcy8TVeZA1| zZdyw@o;&DJ(sMeNn>akF}Z7iin< z?M}m;Jl;Je9U=*8O~RGc61i1i*nWJt=@y63rG4q6$hziw$H9h1F{%N;%~q_ihdr&= zl2&GtywMzE&Pq>UV=UP{7ZknqZhEw6;6--G1+2DVDHnyrwwU#?`R zl>22swb2*7@R3PJoIdw8(|PqbITv=2A`Te+_kbF8UzkwwqQI{~>uc$L?{MRcripj+ zsqeUVEEJ#JjY-^C0`Qldfm2&fMl6wqk6lkDXT)8?_1vDaG<{3n2=;V=6IH7FOhVF| zb(CPh{Jplqr1JWi#*~^P_WhRQYf{J$=0d|=DE?h$? z{+1*5>yR}{oY^V7ZdTx>Gi)sA(i~BEXaQb4q-?yvdcj=aBz!W9Qi^W0I)j&;Cy~)g zGSopB?z-G}OwSUK7jd?MFHU2T^T2(Y!ND6~y##7?X3^W`LG;dIRMT95+aQRTr7>WX z?Yg{xeT^a8i~V1`oSd)zh%w<3z^6SR#+E01wWCIV)3QBZh zhJj)#e5g6>7Navc-=`y{J`SoaJA6{!81nD{#vS#Rm*w+qiEbzH3d#PJTH7PasLu z>ll+I_-A+$5~x(RKK+k;Rk>fAX}BU`-4aTgu+4m-n`|-eNX{+n zyJH@u6nQ>~clTtkX5$z0unAFGo*h(;h{Un(D(wythNlTcYZ!+E(Kr<#f%XjUGI!sRJ z?3II(CCuS8VxL#j)`ZZ?x?Fnogl%P*aEsLo31uC_pc5>Z4Zr4^TC8dailXd=EQG|X zg=EWU52O@cDoBppUHdZYk)cSFd=7JOggUcbzz+A71X7E1-MolEmgokbbP$rVm_Oywe`aObSUjH z7X{nI8|xhGSJdjl%wh!QG3JCZY)rJiI~z01Ptk8KgPs8O3H=;0oZ&W#&|~|sEBJhZ zSEjVjn<%vTW6Wi2D3NSUm)M#Xu63nU&}*j4x?7r-xn#-_cH6Q>J-0A5n#-Za_k7E1 zrd)UqAt<8O0E>{ACzul^upRE>IV{#+7b&yPYp4AsR{Z-XHPy~11~VPmM`3f6RM}qx z;;@G!xWF#(g|&onv?_wkag)+Eu{(9HfZ(&(wYFGmz!8~@pG(bPTYu=XguZf$rzQMW z4;<7BNEP<23T*u|n)Utl5%5C7j)mo51;k{@_=mGmFm^(87)!E6O0v{Y*=g(w50l8g?@Gv$EnBvderG&SeV^y^`_Iek z-1mLXeXi?$y|4Fmow;ZK&RHq@Iw+3{rND$n8dAzrRk{=W<$azOkZ5B)?s%VHw3o9G zOh6ZYm$BRH{Qfup6-;mtY)~b!siN~L3QJh z{mjCg=3u&Px@b1nu_WXNE(J;Ubnu=cD-z#wO-*gcUsgwB-W^AdINLB1Q-8I<&DBW{ z9V8pHNNidp#-gp=_-HEf6@=`qVqEF|F2*+3$ zio7=W?DCOo(J?akayl^+FY?hCx+Hc-j)|V>89CP#%f+S|lHM7T*bLDrf|c>?nwL2X z?wJz4ZTBO18QiP1IV=pLc_6p=9c2EJ{7G#gT~v*C@`khez)d{iUS+Z0brUaf4Un_r z%`KQ-g+bg7ctR+>=H2sZ-OqXP^W;YqV^eKN?`%kHHfSbK%&mjJXjps>?i0&8lV3C? zev98wyaGE2QeO_yImKTbZlM*lu#orlnD3eXw;xH6g+%4hW-87+O2(txMPAJPI1#sf zzbDEQ-SKo4>YAtqeD-)p(Y2nw_Yvi>mU`w>I-mI>5ymosfva5>n-DtuE~6_$DPv(u z7*kX=Ub`CK>J3lwhL_mciC(X9l5ssnZxwL8-gxUZ-pL2967+b(nKGc_nlmGqtQS1V z6P`4S5S&G9z#6T3lIxDrztj1QVd(yt`(@XEyu`VZVe$!2&Wc5`e4Na2B3|SzLXdmswoqPK_4JQs-l%bMe}__*P?h zk}+IGS%CR#vPp$0`d%2PzoY87ZJ3SRI2>mYT9q6vQoFm{V5m0(3m0|lDsw*`mU<3* z@|77Ab}*N2Qo*tK_Q|Kz++Z{|5&d?psXcphl-maN4ypSVDJv9L6<@-+OwqH(#NapMAOGB5EJfTxTEv2QtxkPM?p4N{=91L)x`x<^ z@)cN=1;0OC-0=jscMb(cS_4ZGz@jhg{pCmRybGUR%_NzQ-Y^-UB4qI_CtrUSm&(8n zIz9bmXrIqP*maL!q-inImPD*Ek*~{~=3@obD%(n#$RfqA90d;x!$5i?7{BZ|;kDj2 z(7XB}U+HKljd%*BxTESp5#T5yp{H#wdbztrD?{&yhO{!aPUOA><444!}1y#4e!!5CE33gdFe2uon5BE_Aj4X`R|Od^Ur>8 zwpjRE6}xcvo`2Z)oPqPJ%8J)_3h}6GsiCGnoR5w@JAO3(UM&s>PlD44!s)Ui%nGiV zzS?}#jMi&i^6sgt(c==|HIt!+wm1!^{eC+ndlFuogm<0T`)o@eKg~^tz$6Sd9KCX^ zZrasBZwyO{|9*C&kn6yzwaX~Ke z2=ng=#W%BlaR{@~pC7e1yATo=m|mDuo`|K^M~uDV)I=(iU`}2nshrC zWH+vhzIW~PtlGkS1Jx+rsE>;7lH9GT{PQZ3Y^^I(Z_zbolfA~Nd$?!ua8)ht zcM#7Ay^P@uF*hP#GN&oW?H?bkm(jt~bew~u_Pu)Lk=ex4=8Bjw^#QR%kilinu zZx#&=?<-$_h_ej3tc-)3P_pa7*mc>(Q`p2?LUvG>S;v{Zi(T`-LwYEPr8!Q0ou4?X z-VqG*ru$A?hPx>zz)jTIb=BB)lf_dWijVZdlIM-n(UzMwgH)!RNzW0tZr@0&B;msV z;k$!-eYEn^4eCg{le~ObbeVRoU*Y}*v&KPB1OLS9e_i4(m=bo4?M-h~yV6fZx4|1F zw&LfuS#tw`ik9BLrWM6mKPRtz%ZaTVlB9az?ivd|aXeFGb2)=G^m~;~CsZuuWFeNN z5L=2Ny}+QKCbKeYR$nivNzE371m7&Kcq04wl1JQ+Xl*TDNX_C7|2_Z}U3(ZM02Om- z5pz$%Zu$-kdHtOKuMY#1%vMppYoB6@ObxiiM(T@_Bxh~~-JhF;9X^3@qU9smgj$}* zBOHW`hFm!>tBwk*UN7f$YO_q)43(;FUn+>B=MfG3;|^S`|P!RZ=2 zkhiM~R(GaGMC$t?j8agFIY!Y}#iJSO+2D{b?qBO|IjQA7F-qOJP+eYv7wd-l&`Fhd z^#wK{vT4Lpz-Un?kK@vr0kJrhA?aj359-04@@sYA~IYUSPg7f4*3 z0zU(NZ#4T9aDxH93#Hcw6jk!@Tw*jZ{m*r91IL*U7kGb1zEs9Za@-(7CGAlPIdNI< zN;qv$nd1pNgRc2}PwBtw7(BMm_!IT?tN`rx^hshTHrmRntOjUt3?E0XWm>hnD=V0J z7FLGTL0@h!y+7PCC1@r>PzR}d3HfeCv+=1u<|$XjLyI4IF2}}V`nPvqdJX)#?C90bqq6HfKubR%Fm>r$O;d?8 zqds32Lh$zkxQn1_n=c8<-Pw7Z+m2dK4JMf^<=hIUcGx@5ds(e?K&ge852JR{ON8J{ zM3x;*29r?gIpyw1Q-<&6*LYsprvA)E#D~XJLFr~bUf|8ei~RfU!p88o>~TyPH~KXg z2poN-ogH5j;XL6d_25)I}iGJs$VIdJwo|x5vl=6kgxA9?z|B zT)K4>n!d0h8pGpb-a(>P|F?OLzQwJt$84va-R@J2TBsc=)a03P$MI0ZT39cI8D=}5 z9s934l0pk}3OeTeBOfc8Z#q)Xb3b=0=6jW@)Kb}Js9 zgopR`NB5}px-m+58HU+)DxtN!^9k}8Pn<>U*&E&%1E% z#{J7#eDIr@suwTw+~jx5pG5sMvfOc+d$S8di$o&b@6duS*K^q~P8>gOJB?vziE*zk0VIF~PEPGRgz$I|TmhLQA$h+EySpWsz9>*k_D!g6Y!&}=)GITk1x{luZTSLg{9;n~ zUY)dZU(m|bsrV*ldaIO{x8s#)YD(-6kTy__Hx2_$y(94 zPcgOKjP!#bO-RAFo`ENwfg53yjG#@wFhYs9a*v>9MYyH|U%&MKe3g<4(KMx;7GaT1 zVIr-eOA^o}*+0Q+Kf(KKWlL$*$e(?21;B9z1H&X2qlt9f-6LNVQ+^dVRoO9W^4TE- zuOd=o2!Ms@hF(Z#H3>a6a)~l*mtw<_a0$ObxALD(ciwP ziGB6(PBwe4k2U4H)f@5=R^1n1OSeYfRTf;F-Pn4ATGQ_23oOeEY^fIMg%[=iL% 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

{5 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≺;UgD9$>Gy3o1jl-{YN*;#fcp9_9u zXFtp_Gf>xLr4nxZ@$nbH(Uxjx&9c|_$IDt0@a2@vrH0r;uW02mbrUqN4ywf&#ZA~L zyB9#Go%y(0LUa?f&YOjemMy{)OvL!1bSFn2K}R1&$DS660?~>m3$c&@jqL?!lkgjx zBhwgx%w0Q^Cdt{bW|zO`;iKq8qm=NI=ksKybzyFGHI5u{pIajpV#NZDC+3WHclZEg zG;n7K=EBP13K*0^|Geu~n9L1O03(5XILf?qNry_o2sp z!9=EmU0F+xuXu#xS1+icP{}EXm=r|uLz*+cn;JaDl-~Okc;?vACo0G`CO}lMxeI9T zMHzo~P|re3J>nNJ0j{v}4nB{GQ9lhKJ!~Mw*+#$^pt0&`@$i zy6y<^{?)Hfp!QJ-=;sydjCR<~#{%yjmk0ki(nM>>c#R&(FTw_PQl$CpMeqJ%j#t*8 zgfP+}<4j`Fs}OL8%h~X#U>1MI-z`Gvqxq#8Xq^m5bK|8)`KK-Pj_M{Dpt2`qcO&=> zBH1!;E|h&8BmMDn*g~p6?)~w&+6w&Kx*E6?yuUZj-y;_#vsvGi^D99hZYKSg|jK3 z1r;Ev=Cg16Law2Qe7Weahz-i@Ma}9MQO-&nN~7-6Xj|?BV%6U}xiV56 zJ)mj}%DYrT;7^6YWQI!!x14*HH7$P$Wdipc2>gyv;+(C_oMeqf1rUPfr^-nRqkv{v z>qZ0Cw{=0e+Mle39>T{D5C~a|(X-hJV>Frv4W#t>5viUG*|qoj%t=cMRkqv~taaV$B4u2FhdK-h3N10!8479_##% zNub}w(-W87hi@72j_jm>*GHuX$sd!RW|!#q;== z5YE_dE(}0!|0~sqhU}eDAzj)<5YtQQU7x6m3z3Qc8g2ng7>==^II1iDtB>1Fphib3 zNwyoWb9a&B-8=TS1N``+!}E$~nq#W3y57aZ$1 z7K-WJtEWZ(`2%ZLP2j3%dHuio9)%brK$Ts+2_m>QgwZAN#_>Kyz06m$pDb3hy)yN{ z!oSxBE@}6^vPF@OGCRNsUDT`B`oDsn%=Oec{oY5$p=T6xyg>MmUj&SJu#?#Nn%!4& z{8y^f-X`c_0u4fwPc1$JTX`Q56J%RU@3~DSA&maBxZ(Kc;YQx+V*?YuT_61_P{G`5kj zLRBN0$v*q*-uvV%0B&z}`Wm=~W6kw>XcT)A>Wu~Ndn3<@YRQ3oC~U>*)hf zyI}UKzj~A&YOg{_XEIZKzpjVk2FRkj3&V2Njl3^TKbpbr=tC0!rlE#Hq6m_!4 zL6j;)CB83>xvRJH`U06H9X9-evD?)Jp$r)$6Sz8vtesxgj~X$9$s&}-!*lQK@|p@6 zok+zR%jh5hli}UpP#Z87&Hn*g>GYQvY3Lr?2j#&uw2C@JFgkGw1=Z~|zm;t|)e;Q^ z$bVM$7&Eoov;M6n;AgdB)no=pN2|{WdF3hapfu^PO-v@!Y-sGj_4o6hcIMaAUgT}5 z?z^2J<3v&wQC5G^6Ja{?*N_u|jKtVlw@b4*VhJ>qYA!RN056N>hBP$v*Z(E=i1 z#DjjG#RZZ|`i4CwUQrmcd-@NWNV^k3J&4}=`n?B^7g>TdTNNdm0ZKEtB#>?=+0AYi z8Fm7w_nnZP?AfYONQK6}L?$~~BTJGoTI>)$#6+RZULxstKhsmc=li@~&tK2$`gG>pbKd8DmU}PMG_JSMZ+T7q zGOGQd|2plZ5g@bwm4boIS3<@#e>0HurEM?=XK^xeY|vPt)C|n~nmyXKIVbb_1-h=1 z>EpqGVlGc`Z6~9mCissR;_oM9K0ZnAtvog@eAn6U&AU$}90z(3>eoAuaLM^RHJcg; zYW))hM57Nv;poH9hiKVG^G{0%T+yC81G#F}>nrepxzedUj04nsmFXX|)?=JR-p1<8 zfHS+HpgE8?=gq&n$p+r^Smq=|j3C@ZjQNEBhgWKhQ8IU)CGzK%gl@t;_g#{zz6&6) zaOweKm!6lq0?3`HpqZ#(q^<@fh{2DdhuYnB9jJIK@Fs=he~jR_drmVG~mfa znP^$)@Mp15hK25G2)=zWAIGhK*Y5e&m27h=5%~j956 z|4&Po+6ptg13uNSXP1EmIohbtQIu-xvS zJ4eY4^_G7BE28rE9h1mEmcn%7(~`f)32?Cx$*FNQw{n!I^<^Re#yXF=cX&QN=|7O8 zoxGN?Jx$U#m;%>6MJ4{o-M=3MM=gS@m~Q7ex*r4ovm6ZdSt?o{Ui9HgFO59~=Q=QW zRK;6QQ#gR!Q}N+v{>56Qhq zP_LtcGSrmGgH%sD^fpj*pMta*-x4wyUbZffP_82qOrB(Mm?V5gGr|P zgJvd`vBtkhImlBFIMf%KY1GfIjVn75OdB97*dVr%A5V@9m4J42;=c(A>Z=#xd?-01 z8;o~iPgZZgjrit?mEPXDa8$-0S6KT$pU1^aeF|D5$H=LJ$64N33vS*se><`PLext{ zH~h`isL{Vz1Np6w-W1lVp1UIIVI1T?o(~F7h>4DoFMnHs@3&7QBu1bZ2LE!0_Vx(q zy#9cT#+^OTlsErRj!(sxX|=pg){D{?iOun=YhK*mZ(l9QU?0G|Q@-^H0Xl2xb&FjJ z1h!v!`A`TjBy&|0aOzt3U|8nb5m!X5QQUPGMm z#4ke*sSR)xW6=W=R2sJWscK5k9JayifrYN;gv{D81V8&?hbeg(n2AY38DTgm_}PzCz>h|2at$~7xkcFGVc34xK%MfPoIC#SsnmV)h8Nv+l8K% z+iwBcRIXvmM6@{X@<)R%1--rOCt2LD={+FoI};Xc)X9O{;4#ogQkYMgv4%TP`3(92 zHcSP`SKz_U?Z-vQS$(6r%-+@eeQ#;2KU=G6+&6ss=L;>Y!tUcFY8cm`38L8aJBe3= z0F##&Xng5hRyN=(Zzx?GO9!QjTl<~CFoEDbdEYE*+u&ZSu%f&TmLBc`8*~QF+hFkBwWd0hpt8v(vU+; z4-4Z)jsdwrE3EHO^yk^<*<73b218D$hhaSDGpQ3}b#N57AT758xJ+qU#L^%rH5<%+ zOe)TXeJnZkm20!IQJ~e~<`3=Nd8t1qJTc~Pz?;!}Oif2#(qywaR)BGG_#*-O$D%`* zIwEf~iF(<#$PO7C07qc92u`sgAsqKQBVn?{4X4xmJZ0gahUew@D*lJ5*KqI)T(;i> za4XR&oWTxqjWZ$?S3RHOf#O3~Dxi(u4jgD>YF@AnbW+zohTg4=y4!ud>khajW97uE z+~p8ZtLBPv!kD~WB3%dD&O7wz0b$-~Ob5KxnX^&+W0*O4XlCTbKYx+1+U8E|VC1og ze#xFUws^1~Tp8up*p#W5)S-)|ks8Pi{;1>UtvL&hd0$r0q`Nd$%@)vrhp&GzM0M$H zdVwLprmkkg+Hr?pHtK|YZkmVfL9HzlM9+eZGA$D(0k{X|=EO8}S@C|MI}r{?`erL$ zh6`ek=E^Od(!Y0#ggG>{wV(WpTCJwvIk$smbATEIWzuVACUnqW{2J4{5{4(R_T!xRKTfIiLKkZAtiqkDRKp~E+;hSvI zzP*b6Jz5m)lIeX+LZwP`|3wtvjx zBylcD${u$&wkWoVa6C>Ox>hH#)y^MUUR$gI8X+P2SsXU4QJ~8BnSDcn*6c=iCt2AcSpMn8to2s|~c4I4!t6 zQQvac7eZUx#>WPLrtTkGycX!V?y4B}VwZ`#{miA3P6t>t1Z}VZ+njnsnO*?QwE_;EqaU<~y3hEXdqh$45j zl?W!kCmF_j;$);VX{S(>Lxek}voS~4pR=@Td?^0%qN~VUCX24IAHix3ew+-Khs*gX zebtBv!D15Q)+^n*^sdTQ2DzAgktF_*3s4sj_Angw3|$3glTz|4HC77IRzMAwck?%| z2%NWG2jk*IAFiK)e&tP@0OQ?h{8ZtWxg1;;cEpeV^j&3t?%_uxi+%W=U-Q0SM`RtM z^+n61`f*C$uOu!@ksFT)&WeO;u+0EY{U$Ku^2H^Mn9^>Kp-0NyT&DwP>XH!BYY{gJ zkM+0IKu}3=*7&`g4Q~Q}&$Kig{{v>pY23S4VGqECQ`t1kThZCN&2!)PTj9D?1#r(% ztX9B2!Kg-!6FG?yOfn6oU6%>1)+ z9JM1LTRNA;RO*iStqb)*M|A5C=n`f^Anc7!r)VE|0HK7RurK)F2!oQ*^!9#B*5KR5 z;Qe+Y)%21|6enI8AVq)+W}g$k{+4+^f~8cn>U_!^`m^(j4`^Bzpa-Iz)O~1kWo=Jx zguwWdOvRz$?#P1MG5h#xRAh{FKkIJ z+B3t3G}@eDzd@w{;<$c#$nH$kyC<=|R!oW`+*aU3!0qwl*OgAn`GLE6`Sj$jC&bc2 zcg!bZ)y1)vWY7&=mpHt+U+O&fB@lD9D%rI)BfvCogZkY8j%`>E0l+_3nq9QFHGu@d zVi{@3alwn^nZi>T`4T)F>t(qm7H-%7!P~TcwRF39 zS=3}@##m42#oy&)&p+>)*<(zHc`R^a!K^s98(Vh$;E{xjE<-xZ0$$djtHfYI6A=s=7wD(H?>^&H2m$4a>acGIBNI!kVHrOBZ>Py&QO%N!h zbWCs297!6m0zWdo=OR{B1ZxELN7=V3gegi^XJGyyiFAxb+we+S>l*x)Un(v@t~Cv5 z0iO8yN0LY&$ylG-*R9faW@hLD?!t5P+x$X@bSzj|Yb=~p9VM1UyLN$2Hi~;jGucE- zAS|KPdZCSRxE!&eS^A+{{i%5MA~={dDiJLlxBUXo4myvQW&R;9CHOCz&RQ)NV5(6Z z$MOy~lh)Y-N~Mdpg63qI{3S&uc7e0~ic%3D1ZGHePNRH(qcySVqOPCUtLq#uNOWYZ z2$^ustUUCY`K3_F-a@j!JF4$voa-1|qT^_lLfD}9zVS-n%hNfMWVf?|#wnk>=V3qn zOGQt+pX{%tq2-zaB?zCjYmNM}tKnX}?e&YJJk6nk?cLfIX7cL9jIZDQOGt?krX&R^ zU>*lh%0hARMn~TZd-F?q6L@(=Wk<4xBf8@FTf>H$jY^JxYFG!l;M>f_o-!q55+gwU z^;MJEwIO{I@GjN2?-NV#nz@qf%Mre=pXp|Gy};AoK{UQv@Iv$w7$qicvxnd6OtQC- z!s$hSaQ{&(M5n&q-B7qzF7QbDR|&eeae;R79F0DZ87H205?g|oD1LilPT%CnE&mBz zw$``fT#Ta6kW=sa`rM6a=;SDPU>`P2XONrVk*PHM)HhsBQq}wqXuc$v)hCZ|$?^u= zOC7vbI#@Pv6yd0l&*s?&>G-;d0;0a0we0=J6K$e*xU%y5ncH>z;`OZiu55|%y&C-G z4he#oT!XiBPPxEsG6~Iv>?*%bi#My8j&7W-k8P1cG=@xBa;Ugp_-;Cfr2vK8Ysk-j zkBF6N>?+A7s`5_p@GW?nL}IUzh0~C3rF`XvAzXD@L-_bu)CF(B5)ck7+74o~h*pJ!w# z3vRDUWi4?pPrQ4jF?g#?t{Bzitt&owiw#6b;T-RG9VvO)7g=?6LchWhKa2Fv)te$S zWO&huM9mS&h;#Y0yZxN$fiLJbe*aQYNt*d=*Q$b#g||A#)@G0)4~<{AU#e6=x;$3( zY4)aSlK;sel}(g3KGF-Ev)O;@c`sL@v!@%HSS=P(_k4$bu1-r64lUmut>(a$h%(2^ z258CfXUOEp*zRK12JZTM*t!s{<&=6du>RdVofAar&UzrXYiXdJwJ=F7v)TQA`1Q!G zPB3I2awgw@1%6EhsVB`@5f|yG=56_l`g_qEZph#AxXRwLd+d5~|BX_XOK3>HRRNeGm-3*hSQTc<$oDehY}g)X98Kp ztLASoIU1sM4rND)BWo(Yj><~`&^iE4;-_{*_iXs2m-v+6^$yW&v8Eu}RkOvAh-597 zqepXGDMGtR&<@Ziy3x`@wwB38cjI$F?=$DZcs+&_29A{FeY?|v>q8R3Un`_v+|hVQ zwT4z(LqZBMg3&vmevgQs+v!EfrO<3895-()zzoo{FZHK;7(LD?(e5&Ffv+qH7WX!`b9*?{1nfWBBCquP)_vWcEy3T3zMDzK2&L3_~6bEd>DQk>b6dADOWyJ!Pd&uIW=yp zw8ss7NhT~zz|6JP8$6+U2GEK_fL5f-#9q}9eWI^s?yBxhJD+t9E2iUgSjK`?(@d}+ zZvDhnmhby5SSvLSDEHB^S_E9zGfw;IZp=o@6Owx*5=-v5anWVW-lu`75$7BeY43Y0 zRVo;ZMzP57R=r2?%J6c^*t$7NKP}+cUS=CRF(+!sJz$LvbKLMGiXn%RO`bR$-luzT zmXWR)zmh_HYk!cCO4Lgwc8fkm4`;|=R_=hVU9iR0V|ytY@V|q~_)4=sw+OUc?|kGe zD8dT@XAx=1nKMK#$A@__X; zywbd!(y_IBwwO|jHX=>|F!AiE4Y|0C@^a$fl$PG7PFZ2+FJ(%H{s9iwDmR);Dc*Fc zSU*p#qAwBK{W0NQg6(Rf-qvzaa?&T2jM+JHky$?+&XVLhS7C4Mg$dzAy>O!DwR98v zebE|>`;s`6RTh5kEncgVls?HSC0aXT=)XvoQh(dZ!3f^Gb?Bp2I;kXm5_fY~^tJQW z`Vaq)9|8Or=2MU=H&Sgl(xs$l3_8!8`k2I@7pXRAHJ3>UP~d3QC6jdZYMx1NcwOEX z?!{TJCIKs2XMQz_e9sV{Bgj<{$g2Abpb2*u&E>Opuz3d5dxi!~*FMo232(isz(SP$ z?$St-)W~@hEYM2q2#Z4=H#3$@fg{@<=)w@l7#iejD+K$3!0RgD>?Vo_3UNg9m1&)& zA3n$BJs0ds89x+7=kv2j^FC97Gjak&`!q6Ri^T1o^bCClLB5VOB5Tg__AUJ5-V-_9 zj}rCC0Tc$*bt&FwYp~}WjJ+KCopr{DwKGBGE6f}UhzFB13$ zH4uW7^XcgO5K5*>(x$AZt`qXF$poPnk^xC}gpU~*D%#_6MJ24bX{(0(875c{8IIN7F%8N?@gUTxo!yQThUc`oib_N+s&2u`Riu#k4yWF7;Yt* zlvHt0zix_$BN5bn8oGDNSfcSzXZlMkV;P3TFkVmYB13$)>&&|(!8q;tOKO8$b9~WA z&f;dpP2n78!w#9|K-X0uHreESP3q1b-9*Ap*kY0VG|}RA8(f-KmxQ;)>S>!dZ-RXP zhWN;fF=?+acYwv%@m0RK+vW{ihkucnc;>rALoOW&zd|6M`6G%MmQI*sI6aJg9II!R zcC_om+YVpL&?y@e!;U=7b05<;p)K-2a^sYga7xm+YVy;Vo1t8$CuV?N?$f+6nsrsb zj(~4DR9k(T@-&)rP|oN0tCjThU7?W`t?gtEWri9UKyVZBGFK z8NzbhGvdIjf21A$$jTP=>&CLsrlStrrOns=$AP|G2vvh<5~O*5&vUHH@r*i{9>R>9Uw<fc+CjwJg6u^2{D2 zLL3<*hV;1Kwr80YUU!;b(iumqxKCi)M!+JwgwA2*7*Fl++_K%vqlg2_!sbfy#dv%% z9#@P%TN`6It?tD0R1I9vdAP7TkacZ3Fo%>{cltjVq^ij29&$%v8Rr2==X-$(I= z)A}4y>c^5`nt8QPvKgyVgkRAt-boC3pLD$EH+^b#MzjCen0CRfe_eX{4B)Am#oW}M zoOhcfaMi!)V+~|VV`AQ9v<$Cq3EtLN&pCS`3ne8BC20#*w{ZrZx1J)c-lGhJ3(`MOs#{vc*Er}kFCNBt(SYf+ z-&@Mb_?(lmms6kY-*#W7`AVdTxzwO@sm5VZX>(Ra_11I_^3oyxdD&HmRvI)4g+?LK zy-udqzII36-Tv%#qls|7BP;1bGzqJ>RXVTyQoTaU7JBj8m|UGnjLstJWf5x|&r7(f zPrT+`&uSt_o|LfSEDe0>3)ob-@ZjK+!s7T2L1V(d6ga+b3!idu_pcjO%%@0&-5FA367C{)n#erJZgJl28~0q$WHv}fP(5culmr)|hR)?t6#L)z)vChfPv zoHYylkR8S!uN!<5^7OQfSte)GtY9^ZW|LAs<-^$Ud-F@agje&kzp*APvToocEOP%UhavHd%4cx`RE`=>#ZykZp(2C_^;L03BjC z+kWOh8y z=he%%E&%!fLtY~~$aaK-F*CoZ%{B-JfoMW8gqmMDa59C$CIbV|y zEFxnyS&=bEIT`Tz532Uvyx$k~{jt`6{vt=# zL9jJBAo61}hkEU^hVb1pd+F0XvPnQhoL7GLJFe_feU1MfCLydbJw)*5&eKJX(oIE=o=jGSJL1jNX@$@a{ejU()6dJ0U z@(j7LzAU^*O^?v>g?M}+9#@FJ&rtSL%hAwl63D}+Nz?O&xH_Y5mx{BoQdjSrG(`{wMioKCe@3>u{F@BfRfWyqDM zT_n_+#oQ{M$VALiwip>Wto`sDtpKd*ZzIug|F_Duoo>PD6 zW@gTCfOwzxD2C*Zeac=nljyPD$dhtRa9#X+tdBN}5&5?TnV%Vf;?5*T`MZ6!LHm+o z_>G@<3Uu{%5>=20?P_(kRU^aA)c`yibzO${F9K#HseBlC%?l>1?BVI>m>homYCgCu z^zG@Q;No%4h}!0Cgt=0f5xF{rn2x%*TqA=@`aq{0!*|QeDi7wDapSwudPNzF6l}?W zL*~IwKII?C{3AVWhEt-^jfsh{{!x0%iJ+SUKu+{U)2vLqmRn!AC=gtlm)lH9$xKPwj5REV-|W*# zWH4aD>ZH|(D}O;Cqm|!&)vM@A$h=hWEOo4u%~PG|1=nl=`4qi= z)@pTg?MI08>xuviyWG{XX$zwjsx%uCOx%9)M2*?`>bQ&vA=#aVW9+3a5M=>oJ_`C(t0<u@5sYIpltjFTJonn(zE&vx) zEHRj7(1I-rj!u$U)tU$ksQ>daW0jV#VrDaCfuwv1H>MJmGukoS4OUHH} z?34%*h-3u%DxiC#w`vOqw{h@AhFOu`Qhh$5ly}D_Qn%!d)k)6zX6+3$Y-+EB)4jkNt$Fh^Wh^l*Zc%a z{Byx0k8d^yQ9-tM1z1R=i)Ts+*!+~hzz7(~8iC>9QZ5i?07W>qSaQDK0cAa6Y0{g} z+~JYSQb>6+5D(+#5r6s(3j{Y)k}nj6b1#8pT2x5rzy*4ZAHZ3?j3k0pZj0!X>3I+F z_r-ltohQVw{l)Z|n|A^S&E3wXsW86@GmKcFeLLhH`9OEit~awTnX*dTHp_sbre(x!W*hcMLQPHMXwdBVk5ELwtkv|=M*bA$gczUe%{w0K&H|WX81P`qFd7LFv@;28Y(zyDS@6yN^gsilGc&IRYjQ4 z3jO$9yhxBT;zMr=$MCPh8xP!cnwCEK$(y!US1Z%1{A%_!HrD;u9GwoQ9<0#fg@bJJ zkK+Z9&bq~%s_q?W;)hSr>EAzdIBbR1tq!N-9ePfsLE}GCA3ZzX*>~S7<1UjrO|2La zYk$w3`|U3R5uS|t>{c|s^uI1aS>(xXHQrTzon2rJyXa{b@ce8t9S&ELOB}v$y8azd z6i_L()zvF6Y1ssi<)~iFLSD7X(*PwJR*74=#tI)1VuNnoI?|&9%OHI5zMzxO#p84F zAa}h`%B^Al(df`g=n3@3kzx3H$(hCrJm{Ze#zr51%Y<{AehMv9kLikDMLI!ZAa z;pXqgb(iTYJS9(?iWa1oz-FXX1CYt)#%rry9h(B`ndY5id7W=o=qQyC07%O!Cyj`!SLr>SxHk- zp$aqc!9Z+&Q>4A>?y^3qN1WD|@^A_iHj=X!*^qN$Xm)=P*l{tRZ)X2TMje1@lr< zn>plcA^L`66DY-}dCWDm;)aBf3KWHyB=_9n4mwNRH#O%GbZ>=LmX0uqI242KL~<4T zNrMdDp5NYZAODMgg+XR3gh~I2upz8v(e8hE1{ONr5CP-`3B&4yp!&EbU#3SN5~UcxXc z+yd$})r|(inv=bQ!+b23&Tp=1&f(Bzi@cR*YTXg_;NjFS$(adicLBa9dVGBMx zADXS=>!8}NTaI_IB)5X5A;9$4KMucCaw-GC?pWpCEw>wI&K5c&j~I$K=60M?GqmkO zSSwwyB{za=zIfh2Sa-yQb!$$>WE&J(#JOAUI)AH;WvRmNh6o91Ntzx{qN~DhG!g>? zkqmo6p={{>p+btt2x~>$DHF8K=h>u$As5kujYR1^dVOPu)%``1f;vDM=L{0z0(!=r zX%F6`63j$WTwN}75a+FTCUmQbe34Zh7zZrAIy;7CrJ5Lc2I+MLz<}k*V14c0im1ut z7=AmaU(A|es~7P|vl~*@411@aSR~Nh!*5VmLto|{wFH+InPmspOK(b2(i|tFWqA)k3fH5#IUT|1 z?CMKra0vgf+j*1$KmXYM<%oY-dqh|Ni;|vv|KMDfbM6;(@yMcUT!|Ptqv!V`uA8Xy z{m`eVd_V3B?p1r@RlPo5TMg#;S#MuGT&#KZ!K7d=fx4KNPY!|rL5D)kE3fZ*w=s8D6Vm1qn`ELcbGD<6724t+T;TegZbt3z`EREMf! zq^Ghz5R>+4&;Aje488+w<@s?DyANopt&rcL-ARG@!Wpu>gqnR}McP6}|CD^La22By zA+cu>AG_C1Hk-c&l_&djE-&E#Nbbe%kd#UfrQ7{vhA^sG(FQbuDj1>fHmC=$W2rq=5LH0lL* zQWvDxtb+gQ?;n*|zDY2_Wb7LY5ggr!6&CI^m<9TN?@nSCYyGHlSx&f`IMfD^h^zSC zc*ONM{?VYGsHD2DIu&M8gMoz(ZzUfsX&kI3mc|{q0ykwHza#W#ePSX|q6L$7F_G*t zS_&LU1}{8582`N$J>c$RTSK?`Fp;htzfnpIG($2po&)KE;k0s%*8_faZyjdm?XL%s_wWw3B=vqtr`fIWUJB(Vy-FetGtD;DTCb zotZenu+ioVHlEi8@joI1lpW%;3L=C#spx0O-P7J9*mUhR~^j4J8_*%GAiaVWLZCIaplDi>V;~U<@Up;l|Ya zTt=tUcll>b-gpOmvcVm|7YFF?#Sn4yr=l0Sceh~NiNdx@iq)cbgr_2W;(H$Tol`B? zmM#%JCkb%1NjV6$xJkbHvkZz;mt?Yx+05a^E)gs~{u9NF6T#@%cBizSYKgBO4`Mw!EP&idAqLwALlK7%xU;2O0pw=Cxz}!WxXX9NU7<+!f5hsSk<`>>z z4a+XDWK2d;{hTklgS$BBJxG5{m}=e~!>B60tmB7|#&Xw3G$k0Jojd<5aXiUM?g|WSKOdnW?NtR8amPfVa>IJt;ixeoC{KJIk|UY=7aiSHnO@6Zv_v*V*?2GGgE`KZ(r z&o?3SU1J2Fs9tG=0qbw-MqM6HO?}jSB*}H|pXWe0NRGK-`@A0;{++;?YP#jdoRW<= zrF6lE+&E55odDBw-mWtl<~?NZ!UoXNOd_34a-M&c;n6@T#ossV760X#E7w^E$0+df zDS)4t>7d8I&qkwaEMXFc&1-q%-1u4J<~632>msl3B#eKjhDSv_I3|0n6G)wTsUyC# z`W-iv`wHFK?U*jf__Yp~zM7qQW^PFEBH<`^VuHL8Q_0c+a5qAhy0cf6^HeF1`E<3tn5&pK zfvza*9@@v*2s@<=C z7q(MUti`*68AT3tHikj22-zYdD9kY9y1%c1X`LAP%)uk8y=l9>-pr=0;+ReY?&9(* zP}rzNl2OfOEECiQIK#|<#?@?(WwP!mkC=p>vkTGkya)c}xxwGd#8|pCP4<1Hy~(5$ zG?F1t-|m>_r)Ucf8r9-Ax`~0QNbxl4#JHx=2hUqI56Zl02Q>|J4eq1(_sZJgLJq3L z^l6;h%`>jQ{y%>)&M98?G226~)9ZqjIN{u}tewwo{05lWp~SP_vOcvWto~D3^CWkB zLKqUvc`HWN)u*sRJ9_BoC7oOo&>3$}J`wZ~ic|CwZ{|IrrPeluOB1@}C^G z;p+si>YjyP+(qFcC7NcSsR`^29v{DZjEnzcQvga#Vl&%E6IC97{XxF5XuoHBjHZ`c z|F97aNr(BYP5>TbNVRSyl~d5%m}7`~ZSeJ-$G%};PNBP`q+=QMx+bi#2l?y{xbX-j zUFZ(OVhmY;f!iyoKohu(**1p7<7O&LpiE+nwfQP`C}QU)KWIkExj&zNv$mK2kvd%i zeq)>%Sc4R=gU0*BgO(brFR89Wv_wAlm6L_0bdIYZ>^e{=_rYvD*_JsFM*h11HKmpw)c8>T8jr6 z7_MC`LXoJ04JG-$ybe=T8ry((@X_;jjs*B7+4n>~>e5}W9Y9O#GJhDJ`daEk#;D^+ z&q%5gEnfeTeZ)X9+nbk;2He>=$WwXpFng3*JU49wE)l%Ist$75di=&9F|YtBUIYbV zQiR3#Hd1YN9Na9Fi9G`G_!IUQe{Y6h6%;ZNG9j{uB27 zPlM1Wf4^PEG6Tw`C566+d%9JXn+3kYCl=xj+%RJID=ljVkVswmc@Wbeg^;^_fIW8L z(_&9^8VUe=QI^K@RU&krd5_YOel!_-*X6J!XpR5Yb&4Mm6m~kgrv%;OX-=4Nr2Klo zfvcwMbxL@`pmcCz+a0uU5tvRScX3V{!1@!I^9?$()>rH;1aM-yHrWcown>vPR(7{j zF^0!G4Hn?QJFD>ycyc%O00XCldvf%1JL@71m}^e<%1?m^QzWL>RB+38?OUOTNChN? zJTH%}k_t3at?t;6%k!LO|H%n(&r*ArOT_W_W6+M1Qr}*g$0ilful@( z(PIqu3QqY2nqi3iPpt2CU$=m|M|V)N&`LpSlz%9dHeLi_js40N#L~$T+#Tm?XFhu) zWI>)E_jGZ1`RQEqKK^1x?3qM{FIW)0|H4*|vvzG}^M^zC41Hm_$A316stYGg5->To zQ)0B`9zUTJ-mecedAYnDePK-*o8csvC!T$%%W%ufVelc-d-)&}an=>6ZY8FYp-IgTMmEjw z9^h9#CC6k&Gx|P$WMx@Pk}ktXCR7v%OjFYqk!tW_s?^tMmqJO$0w&ijG2hIwQV#6H zHTrYfk*9$YZ}(rBxnEHFGn8ZPpPrvxia88o9h|NyUo}c!^+3H)rBB-X3dRHcYVo{A zleg?hE-}5Y2LGaBk0{hq{7^gU&@H}SakNPrKEe6w!h~b@oFoQ?t)uz~qKB4R!t#iHNz^29=y@ z_|MZI-kSu1r+oZ0>{&za)@6xlXm-*@{z1BwkFrora)U-~uV>TF8^#ATv&UU-Yet+f zu~fIY?U+>?sPz})QnaH1b+Z>6*4W;w!~G2|ch6u2FDdvEJPrYV>&)xh(XM)PQy>0g z0P#<_OHnG+7+1#NM&|Mjw==m^`hlb3qT@@2jlTewT?)w&>=4<*G7b_c$koiY|FVm z#QcZ(4s-QET*a=2kl+HUOyDFN<@|K`7o2!NlH9;$*4)_IY*2Om6Xl9-AURkY6vXzg zhsv!%R2C7-{iQCuz!1-Ukz{hFzN+Bgl-h7Fro?MSpnNp3Zi7q8d+>_p#ZwXd-lO!b z5uQYu!XIz&>31AvxHUk?#^-Z+r$f4J^Lmd9LXF!CZuJDu*_6Lv+3y z>Ru$X7-8gj`Q$S>*9Ver}#wPtaR}H%Y<+KQYpGsczXwOw*$G@L60ywG+C~p zJq}Iob$bxD{fZLoC-Hhy^u(&Q31d2%( z&B>u@p7T_e^22s8DpzGhb|F^VMPF>dooLK$e4JbVwS|Oh_pLU{D-fR_MBlWR6KZb` zo!Xp$dEK5Y9krSL?|PncoEYnZ0|{`%BxAVqiO12OE-W{eNrH>(JQ_qNvV%o2lGo)k zx$Trx?385eSm}sd6(JhvQINyN{yLU?>_m=yth1t^8)&k20-6hvkz_U_fJZ-tAZz5r zy>>$@QI}h8RX@&n_-z_w;ke6|3-vD;+JK=O1Ef=c2pZnJ7Ei+DQUf}z_x5uB-zQi~Z{%K?V`LXS0GrX_`T15z`#hX&CJ@Z}`n{acgA8Qzdb)R1= zp<283Z);BjHmR+XzOOQWp`K(7j#qZ}b#B#?1xr9Wv zL?c1QS#IO3{9@1?$3t*FMVd(!J(g4dce#>^rIL)LQW8<({aITDNR9PR2YHqFti|wKL~SKoo!5XD9S_9}IZ}w0EI~`&LHFva_x+6jEy#AU4nvttIVOecZsE}0 za-DEf9XvAa8kaFBFYPyk^6=y2`q#hn&J<7PUoKC*%p9?YzifUcS${V_0E!(wZRnCK zT*ir9#_?SG^NUvS-1i_$y?5squFUZQ3-=>Mg9kKa2*$WC=5BZsZ5%S~D3>uv@?oF| zq{ry@wD8FhYYvFEYQ@^|Vn3~DD3o&<)e2q->*2Y{mz2(INq+Y)(Z$Z3C&+uMLuuIv zcVn`JxrL=%%D&>5$nakm*MdoC$?IVAt(26llw_<}7m&{TgQzK=83%<1$LuQcvbfY5 zJOAEV);m>uQ`i`kC)P@dUS>!R3uKx(a#faP!osa04kYB+5*45Jf9VMu8AW%ebMG51 zL&>sH+aqvy)QI_g-8CZxZC%r1-iFyLqJs1nccB?&VqN7|_^THhFCRtRXiDIT8&ly&P|Esn?_q0%JQY zOEl`z`<>??&oNefb<3qcYf7e^1M4Sn;ae|FudnYgTrN}h9^T%T+-^%Qwk6w*;V837 z+x0+`l?JPmWN+P@H?-lw{U%1o7o5weG(ZYeFXL*6$7+bBQL#4Jp_!kDt#eC{1stkd z=DihEyb(ZC`y~FW-brc2PsX55yVgkb3Pf@QA=Azw&0b05bFiYDf#c!C{q4Vo?Ei2E ziJt6il}I)jWOQoH0|=mOpQ9!=>O*OMl8ys^FZqx9`W6@iK1Z)b8DKy9k02wn2W z(x0mrIu}q%(md*m4Y8eWKc(y9*ek;M;dob)6ORaGRb7oXK6xyO zaM2Og(tGh{)ZJ#P8pZ#r@lipdX>O}%Q#&-{W|LKjz56czh)fxqk$SUb=s=)_`=Q#T&*6ehb4IGNUo^wuT^ZcI z!Yd0_Rl=OF&OARULeODLKViScOjn9uBN4sykQ_&lX@`-jlgn>wiU%yyg`~VMU~|yn z;!Jpx-mk0qaZKH{Eu|Z!hoC9)i>*YonFFjau%1q6Jj~O zpj6N?-~Z!CdZXC4v)sO?#>ZU0!k_ldoQsuF?A!{vBuGywq}SyAYz`)<=s;<@{*N!c zKg?ey9|~a@U`bV>H;w7$t|}c`Lh&~TzpLix`%E3umCNL|R#LWBlCfspdt&@rFcoC@ z)n>>KjOQCP%5;}d_TX{)wdMEd*x*(W!v24KHR;AZ*NUt2P(Q`rUZHNayudJzkZA&= zTTAhZX~{v@D1|$a>l=xd<{= zS~S~9^n{8)An1}mwMg*XdmWY3a!iS80jKfN$bZ(yuQyunhRtb4#vt{?d4fKtN1p?kdkmd-3hAhizVLLRkv1^d0*k)r%Dk{hnt*^ z4N=~sAk<3iL10Rd+{TRD#%OMNFN!z&)msA6Um8*A*`Eop6O!+~f+k{1PV}%IOuo{N zLP6?Q-b$# zA4i;NINETa0-Qm)4h+mjN!dn8#)efUw=svF?3r6V$8Ub1Gv!fvh}^G72mR>U``%)i zGSx!7{u2w_+9o=u⁢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 literal 0 HcmV?d00001 diff --git a/experiment_data/sample_data/03-111.xlsx b/experiment_data/sample_data/03-111.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..91e6be3cfc91343d05c95d88f9ae2700830f02a8 GIT binary patch literal 345343 zcmZ5`WmH>X(`|8gcZcF$f>X43X-l!--XOt)yIYZBMT@nC;u0K!yB2qMcfINRz4yCo z-9KSPhCTDl>^(E*ocF3o$i%N+p`*Xzwe8eDek(Fj&xi8r*oE{J`Kwp2Aa=YSj?N$# z8%s-97vBH;;pc(a+r_jjO$awQWqESONaduW(4Q6OZk|3nK}J}qH$->7awnK3{xSKO zxN~g%XFjyF9z;T4#~!^Oi?=djh*GLXf6>44nELXxBmK0$;{SLs>i@XM`*JIHJMVY< zH{SnlNwe)`!}xiN&i^*&<;MR(dLFOs{?4)OY4F7Vp*ZLHd_(&A^yTUH0`Fxj$M1qp z`svF5=`ozn|8b%Gbm!�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

1q~Gpgs|iwS^7hwG@@CI@_4!l-Q)<(YZFMt5 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

hQ>RE7| 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%0DFPli@oc($14M3?JR~-T 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 &^I}|S$dhErE@r$kgyc&J-YE} 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 z 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%0DRxvx-Ey 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�$yz+m8pLdQGee;r7ME(h4S}F3w@%Rwug~K# zE0~!;UJ&bJ)bwCD*KkOt;ZWA$yEkL7QCd%f%}Q^w_}&<@A*>p86s@BN-v`zQ^-OIm zt$yvi7&=^nWU_6Ryjw4Mw=~@Prb|BctQy79YRRQ)fZ*0F)ww$OgtcxpB6{qM>xGeY z5#GDv_8dH5IB@Vdau>fC|kYoUq|P(+$uXZ1@nLBIJp<^UlHycg00H zc)&Qq!6U(8aOPALG>%uy!*>Ikf9;Ps7Ex9a#0Q2FNCrrwhJ%w+!l-D}k~k;0lu_01$p-j2_XSG1^j5jK`m{JK!56zV?D; z*6i)zvls$b)Z^5-PGJg3`~w@$2eu0rduTWGz3@s}P~CgB{N%{t?H@Z+8%!y7s9PJzK@YV@Xhh0`gl@U0;xWMRK-b!^5@RVT(3;L7~5#0CFAA{J;zwYh1e|oNu|G5 zNwuq_zOST?Rbr{S)p?J!{kSibc#v2F3`_nPm^r8nBFIi0red)$|69QrkkGDV$)cpE zWb~Ck#m-~nMG2%YS;oOnzKlOP)p2rE7Q(kMm4s|zIhBmuPt~r+kixK}dMv5xa%RB| zGx!oDZuco;OP`v@bWF_d9hbY%Jto*DmO|5kk7hgTJYO` zxo7)pQ?co(_fjCM+5IMC1yN$3A?%4DE0#XWg#PIC6yX0xy0;(HxE^a7wob%eBo*L> z$OhhNT7&cq$twAQ=3hBbFElaq=ji!lz+mB%VdI+T`!`T0OAw5O-;<``bZ$pjZZ z02zFmJ3j3E5UsxyDsQRKfR}H;+cw}m8_*AacIUKazQ!MLI>)+o++C?zN5~DPt`OVa z+wn_!(@od~)4(eOMk}vOJMY}qHHV>)m=;9%0HMU!x{;^-a?q>FSNuB%aV^K14&1@) z=V^mf?fpFMzKwoXOD4ZDe;^qlKa{;Md<$v&99ZABNG~p!JJ#{iTMl~)p2YW^ympW0TKj*SrLUBdn0O4?9<0Q1PSN?TGo7 z{l^FXrfdx=XQ^0+SE@q`eYkRy#n~8ji|nXc&3hbx5KTO^YP>Fd46NUMsjT6Vr+#(? z>KHTvuA zuF*8^iP-yo@0;4S-q*>&rlt@Xcx~k8o3k(*P_v!t?2VOr`3}g6u11*;nk3OsZlscj z(>BlgW_}9jkT5h|*JJFlY$h^7{O8*|;mqdun0*I-%x^_4zJEfJ22~H^ztMy3BoD>Z zVcu4=zESTcPK@uj9Obo&zszt2uv{piAmb%R&etNB!MbZN+r1w*sUUa&wuc_rK1> zyPw;yeu<+jwerLPm!L~AR-v&Oiiy04H$FZIh>J$h8q+72XAZ6YqP0GOM@#FKjnR09 zl*3TJUy?*9NR8MWy?&v4^EO46GE%gFbmO|udB@#KghEvMz-0b`iKl_dyphRwbv<2m z{vnoIn$3>CDlhGqa|wmGRXt@Fcbwjcm!!Lbr=@%;{Z08|KoYlCN#AU1HH#RMqjELo z5ABx87NHFga+gjBM(h=z)7r0}O0Y#p+ao}dXabxBI>vPu^Lr{enbZWS$rbAC^pB*? zYqZw6U#IS~X)d{Z{PldiPd;9EJDioZT78m6EJ^iV{6gf;nGB|x1EiwxoGnM^7kjj= zI>4ikS|%N}OgkDORJzcu?bkpJRDR6U5nCKQ;d2PldA^){9=+u+|ENNX1Eg@G3c)Z$ z6&j;<4nS1$4Ap2{AeGA`#zE*EpQSccsGbgO#VA|muM-FX`KpqZtdf>|l9ob}eLd=n zTd&UEJEVU5GJwUVwBPXDUaTSzw_Dl1qsIKOiXZ?E~BDfoo&4ktF`1&Q`+=GS%oL=pCruM*4ZY zaZh0L7p>YiELz+$N!&6`JU43e`_DlEi<`ByLizmhVlTdaaK)&V->-17ich>E;sHpE z(Hx8hM)O9-SRpP&XL`EtvyrAsTk@%drLcwHl>?9;w=!RP;TUa1`~fhY(R`foLQV(G zOmfckPXFdy7ia@uUw2j*16g{3kl${7HnjvZWnHD1MRRvwyFFsQ5!;b z_YX0*L4MDas~c0Gm+mo_t&rJ_|5Y>miHV**FJI?52o|f9)ko{v*m8*8Di=L+vUkN- zP%ewCcd_=>$m;J<2}{Lvyiz*;dOF@GeWca9;|8nEhdz&VH&}=C#$s^1QCmO>6xlZ< z70CWYWd?Sh;-E=&)}*#*QfD-&&jXvn6>W?=f&oRMY_z%!bzHgfSKvN6u;jwLwdbbs z`!g&yExnb*3Oc{__!G_aZ@rX{fKF-K#8eT6B{r8;xx1)BC&O3K zwdLyPaXIcjl?a*E;cZe}<8?bwC_pI{o$!OEo=jb>^-){B+LE3Plz*jI@ly|Z8yV>& zg4=x=SHB0-S{J^7d|*7#^c%nQ-ag`wtG{@MFM+bW$mtIlCRHMNTrtr7UmaIQiyqPYrVx!`txTypKiW!658 zle1^fXc{kY{JLU$_3b5oDL0?SHX--f|3i=z%Xl^m6@xPW0PE?glpVic!h)c_Gfsr{ zsn1Jh<&we)D&pGz=$CqE21-z!I_3domgxJ_#`AcX^+X{5B;$;j+%`K|MR%k__`k;_ z{F|nnJP%n@RbO18X(y6!by(|KU|7(iYWZ>Rc!io%!cUx=tqGlQ=`MId7kteMlky41 z*!ND~>I9W7_U7+f3nVXz97g5Rq*P3>ao8^4F~FCo!>g;W| zvmVdtf_Y=ZJQdEKlH3^)0*>C$2(Y8S97#|Jo+-qNr4ykz5%YBpa_&}5yhi7FCZpeZ znW#B6Q$^ZfMihq=ROb`amJ`$&P#NRU-uOwR7QPd{T?-2vPWgEJa&;O#%QcVBt^ppg zdjzgRP^W|6n4(}zQ8)IuApH6H!^_Nf>fSTv^ZV2^R!oTEyjGy0rhl$vsu@-!O<9M;P@49 zKED(*0NKs%RAwOj!ZTG~M@~(a&8wd1Bd)X|lksg%#2zQ&qZ>qJ+UJvK>fHp zH`tM6U6J!Rx{I@I2-MK8={v6+qJKfxphqkfpW>CC;;%miwMAJ3S(hE+(%yc5rOHj( z`!EBiuQ2lm`fqZPJMR|~o149fh!asMlhHhr@k{j=8X3H~Wq*9xs(u|92YFSagB8bS zvM$fgpCCudUX?HoskCqmA~W_zAF+%%qNkTlW5TeVC)6t&z?+d7XgXy4IG3vTvcd}5 z;VO{JlSsD#F4vHrs}Kwp&~+i=_lF>c$OwHSF9Cc#A+YXy{=BasA%&m%+krJUP5AFp zF1*~NEyXtjM)cV20S}}hei8c}!U}X(o6+N@SSrD*9E2qM56fc!P^Lnu0t~)e( zE2p*vVRp;UrW(y#whbXikni841d*D5UtX5RePAfFNR9+13He@%8h{91&PvZ7l10$R zp6lFup|JEus{?-XpX+(D0j{TYzLya} z1_>iqC~rWq74;v<_nM*e!QzC0->$@>-^wSIbeS;rhL?;L8 zL}d_&yPyjW9;T3tSE5lkAdr~g-M4$puf-W0K$D9p;^6_#Cof7<*i{9j=yh;(mqaXy zO7@KAU^swQ3*B^I`m85{SMCEQag6m+x}+Uz`()*2vBs(VT%cPu>T-l91A#q5BgYD5Wu^8ipX`CjqYTe zzSP!+B=?UzcNb4c0_-Xh6vNqPSFSFRd{t}T)^B;cdDo7i9inf|oRR6=Eg5_OPsmW| zkbjE|Z2$i~GJ2(|_MjvI?=Kt6l?vT*POYKaeIu%Mp2Yb=hP+DnURuz{(PW& zgQea~Ano|Rn~SEf0=4g3pBW7Pifr^@v1SH{+ljks^FsZtnlIK;I3a3?iX#%Q5APp% zDq&w8b~WsQY!nKVNUDc_WeM8`GAVWRcPE3U!>P?dqn91MEUB)}}Q z$j0WEFPyvz3_8~#S){X@E}i2CS5bwzkdX9!y-8wUZ=$vP7^+@${&F{^vKH8iD9XpZ z+pDjW2NLS;f6r=!d`u1ko@$B%hU!dHv#;s&iG!CA|*~lrZwKk9d!N<7{c${i79|@JTRLsCD zW#F%8(B9-_j#Y1thC!OeYE~u{cv9*~NUg=7AxgV#H`w6fDAjKTk5I_QD`n%aXVYH% z46Nf21zt$oVGcq6Al=p3%B!roC3SfQF}Ko%$-rV|G6y4^b{t*su%p<`5L+j?$Zsb_9^|AuAdO&;&uaP~b73!Ohjtpap zmhCGDO-3G%H$fDb&@yHKA$2}6Jhf1TpwQMp?pU3V;Q#Pd;3DqS!T2n{EQ6KxiO~Hr zFG@56j<#f0wKmK-IWZrQjFCDJ>t<40y9wOA^7vPaA-m$2T1nhZWMU7Q*nN2NvOR~X z^3>?u>nFN-DCpG+`uT|O(sRt((^H#oL;~;T`J+Km1WC&nNy{WjKzB^&hr`ik-+kFO zpclGZgMj<2qE+p5)keRHjYGWMXXFibZE7+nqJR@2%|%-{6jGh>iBF}JX1O8!&IMZb z21$VawYR=D4(Y_#tzm%SWWIFznKe5f9_$UB$ zvydkWES(uX?4195xw7ie^`B;5mk;MVy@eqXy6FB?EgHVO3HJJ!6OrFd+wg}>*`!rqSgm+%(%Q1tu;70Q;9e89d zPFHA{cs#2}Gnz!X^$Z9{fOIk@Wl<*cBTS&J)2flhhH_v=Le3@6d_qRb27@)+GcJ-w2^u*P8_J@c()BaBt7Ds~S1Ig}{9}rBvFsaHDX- z0nQdbyunp|++Uep2MuFVhA~}G7%XcrW33V=f7CfBWL$jJGoN0in82>%Gc*tGJY$%( z@W!dlA9*JsAY0}?8pxYKxo9w7n7+y7~#=d^={mbIxzL0ph)?_#<%kG5b5-bUI-V;;|2m%D|7X9Q^Y2(FqjR;Tevr z3h)Y}&bH4_=(sd_E1*rh1D;;*^`GzCzshz0&?3-M9$dNV?NVn6&rSSb3z84@N`sp@eCJ}=bTA8w16 zB2)37Jcw-`#28N+F{TFT#zE79`k&7)z-A8LM+}tiPQb$5-1s*GC7$*CZ+4|L-wUovc6XWnu5<;;n#6p`OF`y`ypC7dfu>Kjerm4i;5`5GKF4fIm_`Ww!M zap*TiLKWi#`XX4YvjKVH@2R8L&d_2{idHxBP7Z{8&7!efH|K6SLHj>J?!(gURpKsH z9`lfdl4Rt;_)&PuC|qEirUtc`7s&QgXZDs=FJ@+_h$(32NzQ{rZ z4{jAWLGD%93%kKVl#L-jyrtrtNP(LBXZpdE*hG#6&B6cQx%Zig;!hGAnptYVo5rlC zdmi)FaGQkcjcMPm(-G<0*CRRQ$msd#S4uz)%IOT^PmZM58SxM$d=wGWU^o;wEWI#r z96MZgOR#KX7&h{+_|&F0Xz$BI&%Nj60dLd>8NFNIG;+SbnZkwWd}#mh_MIE~z&>TX zrcHJDJGZ0Q>Xdt#GBtI=m@HaRp6T>pwtK+Sk8V2{bUOaH=(+x{$1ekKPm_s8DU2PG z+dofibLTiWXw6)8xGl##XbkTVrAzYP`bctI89{*3kU)siW*aF@Vy5kM|A?87U%~s{ z{=Rnfz^Uo#v6{~gdkUB$g)`)nXpoPEaseY6RSL+(;vveA(nSk@lx-X*^_@z8X)gM~s;7Dv z>)v3<6IAAFdQ=BJYJ(o_P?)}K8R#m=6{uMo)lZ8T&s7?hr8Nfe+J& z^KopXBP50)!l6XWnIDMNf zk^3m|t>Bs3(+vz|Kx6*oL4;1r zm>T)#3Eajm`;BX3)7rY%Qk^HK+IIb|0o(#YkIFh?M{}DKTCk=c(Lpx>prut_Lwv+S zWs=c+HEB^}3)N+_2FO-E2`QJ3?s<0gCX3xVt8`oMl!T9$Z97 zeQ_sLFe}pmh5Yd^c*-yMePeIHxv~isDj207kFqO~lJko{)TV9?1C}1^kXSPNt!&=f zXBcR=$NrHoq#rbHl<`N)B~W(+8W{))67qpQri_(8N1AMlx8(_NyZC(O+-x0Vg9zzM2QM|HsTp`&L9mz&xDC9T zi$gj%DdB*A;LBXAAPh7$4S}=Uo{x5&sECY{L;_On?fd zl=|N&K?$C=vOfw!TXfUQ)fwxxkQsghE?a1COHZl zjuFVEKR*ThINNmzc&XM|gLRtj?<)$IAoh&P4vfl7x(~A`2Y`X|9WuV z$y)CZ@EKuCAl~`gW%`TU%Jqb>tn<2lm|6+42z%?tYjRZJ8fcKCPRLQc99DzgdKYtn zUXOKW)Z&GNhTK#QagHaf5vV~e`Jos89Zif*DFQt*HH1 zYMr1qoS;sepmO!J4A+zo`roO)m{`2XmCZTPT{>V}7aB)_%^ozQ1J?WFed)~j#0Rkd z>FwZ=-Wxg2(@z?EE?th`YX45h<9D+{3~Qs<(~G{R=-(*}>Ri**1(#?pmsl=Mjr>RI z>Tvq&f}l|%{uE2uL+H7}vVlvGBDPMk5?#cZ{}_P43Or>69;&IGW8ghx`{{-!H(zC$ zo4!|QubU$@C6TrM`Ia}G61b^--l#mms65F?r&sW2QFzri5IBdXq@5HznnRj7 z#mDsky38ZAi`#cPHCuzp?CdQyN)aH)TJRt66qiK0(#*B z&Uj#3!~_uA0*HDnm@CT5*ZUYPtUk{-;W&w|NAXIWm3P6@kCf{yEZaXmA zxo3t*o^b`vfk<%sP{a*vO)u|9vQX)sfXbmSKY)5Rfm(_+&^ByHUI{e?qpmVM;*g;2@9|7V}*rpBu3 zyt5UuRIw3rjLnaY{N$7)N^jIcGyPICSf#3W{H^oF73si{w{p3(b9HkYhy3EA*HSI! zR-wx`zn%Aj-uvT`3TJ3{kTK6`_I3maXdU~1Zj+}@sfXAa$pvZxLy{D>tdB%J>1p~? zfUSaE(FZ3ES0LjR$>=igO0aHGr}mZV*z2IUIX~|cpPQrHrGwEBx2cU?ZPpN=f-qeB zmz7f|KsZP@y~}ZtYXRN`xjipiVO-T{vHcj$@dLdOjkl$&c~pV9@FP%^3rLMSqcxNCO6t#r6tz%b-;0in`IHXZMePnoWPrE?1A zNF40kHJ9#KV?To&7bPHpH~1fJ?!v<5!p0?oj}(1j!FmVX;0pN`;I3FbzQI{zG5F+S zPleG{eQs3ZssHh~=ybs2SY;sUtezK!0om%ryq9T=@{nZX>eeN-OL@>~h<^VDJge9L z$3d|u1(y+ra(c;uIyot^@&)yMlRIDn#Qk~bkv@f|cn~?Te~R~ditp6-<4Idatbo;I z6I$h^pZ|W#=O;jbOUaD|#$VciaJldqQoxWmq^KEErnJZ-n|XcPxUQm)e zuFNcmKG?H@)@s<-b@z(rN@uEqLng1WI`CLXfjY2Y`afrm_Ehoq z%)b7E2C?L;^z{h!Bn_^iGko!%--Dxp4)U(h53i=!5G1rX~F zWGHZ3^^=!JLxJ_2jt5a&`*gflIzH*=$;?BiG@img_P|9xwLub}GgI7TTK3)s(867Z z6d^jCE{2>g#+)*n1D=V|&bN9yY)E_U)#27T0%tfZmUHGRyZ4UuZiC6Ql7S5uGAZ1d6h4S1QZlzjg9J8r@)MAe2 zt9$1YAv4b1q?3ffqr}YT-1nOLDl2t_C5aDA;PsNk?r*<9xFco()8VtjQY8kQ&0e1@ zbADcRLt#5^jOc1S6sHMU{l_8yeRwRqB;&E>)C0;G`G{<^|10w1P2VZ468r5BHgA4F z4@vT!#<3jIyBG;H<_l8A2fdHH5QczjuYO^J~ugGo&_tNf-hOH^b{8 zMDO@JKvQ|~Y|2C;H_Y}}&FWVn!EZ^Ic_Q8%-`$3$R~r9JH9gJ_!8SvPb`WX<1nWs4 zU&eMLQ?asJkwl)f)-j7;z|7MqA=XH%K8;Lo4LQE^&zIrOfK7F0tXT5tU9po{jwB_2 z57Z_GzskK~=lyuf@zghLbqNq8&iX6_Uak1#aezp5p1wZ7G?O0kN#}}i&gF0Nmv$dU zwmQE9Wkf-Ce{wwC^r*Sh@jD}t#ea6F{!DPnNsY`=C+sd2Hrotnk52&#E zk<+KW}>*EU!7%c8(fg=H*i4=}MmT8p zZd<~?P?WcbDWpLX{@jhIqsHtmxhoCVHI|+HwF1dV108l$CQ>;Y8QBFZNQR)8re|7z z3INw;T{8Bx{tsxXa9>9h`#r*Iq<<-Vw$`M4~m*13Cx zylt}N^3BHRpv@@(k%WKYw;zySt}pL1w(JQ)0poW?6=-f#U+rDi@6Xgu;#30lgw;E? z9&21`ft|!D+$Qs$#61<3G-iiiFyGJ|Ue_&baIJH~N3Hd@r1T6{F|k^gEtW_NM+JC5 z`Lu8>B6^f^pf1UC5Bo}oNwv`+#zOOB<1)Jai^`a9_rIr+BCWvn`+=yjYWIE zHR!Cja;KbwAQsE+a<6^$qJ*B=cnSOeIhM+rufrEYmSaAt08=HpRxyVB&Ny~_uYbx* zRxfG9_`@=RJ@FrEEL)%j-M?C7_KZAU1bl^lyD2Ex=1%F+SoXV~y%nsi`Wgo{oBm!Y zj#or7mc848h3Be8#6Mr}4&OaZNdZ=~tMcoCK&-8l0(@UR{NHvd8R8$zYb16Gv#XMy zKRfkJonDFVR`<4Frl~>WdU)sC{}zL4Kt_(k)`Faxew(H=>8D5=_YmM3e9GI4$(w+a z_oL?2UZc9+jQ;EGxr0{v@~)S+n?=mF)psqm^bNqTg!~E>)*ghKrwZq?vlT`$-kq>k z5BN)8OkJ@0>Cl@w&8;Gc7qHk@`*KjRg%`@v86h5PijPAUN2vmK(vEnZHZ)6EQiX28EuFg>z%r3ElfqquIBkA9n!(J7{VTa^}N@Ycyj6! z42x4Bl6kSXr)WuI4((}%g-+bf2AvUaQ8In8{QgSp}QilU| zgdvg(K5)Na^+=3>%R3NZW4N53m+-@D1{nRH>CM=74lWS&+WxL5e)$v40P&u4t09Ym z8qbjVd%iYmw(gc~!GT?|_R0_Eu!>dz7zTrI4%8V2CQ*1jC-J3V(<67%`NuRQ4Z6VY zFgl|Lc*368zV~J9PuX$mw!>e>x zM^aZpf$Tkli#{aT%7JoZ$QU|@70TON#PfJacMQBc7I(WQLKME%DOj0Spy&3pe&w&I zmW<{==`zr*J=Z9U^k(iIGbXcB$n1p8fO&5s{>&x#LZMIok8tZ{3`gSrL1t+w(41jg z9Y3pyNuQ6rtmGnG#3uXQKX5lyELQ`1jk6$;)Kc`XX`TQN(XYwfe*Ex=P}Po;gtrt_Nl ztzH3nGh^O0M>?3)+iDj0bx!{RoUewX+B5BllOl?mea!t ziuFM-b^OCbWkDJ+_$>Lc14sWzHR#=h9*qn?Tg5l>u=MYIv<aY_lHG?%%EA97|bO^GduvcXQLrZ)HrELseida6z$Lk)sA( zo?{m?_R+iXWL`ZSub3p;0hhjWhr?EO(l)PvLgMPPuIijFSSm?Xm*ZMsQrs&Bi>zjt zE>0nq%&QyUyFn9`5S2fVpvB2G-Gthg-zBb9MR>tOL+7~o55t?bXmQ0AXagr|f+5li z-gC&!X`!%Os#2s7Kweh{x{qaK(hf3hKEXKayP~RoAcWC?{s0Qb$V7tIV~JHVi5LE$ z7qYV7aMr0^Zfw3@de1kWEW0)(C06xXjo4NP)59tJZ{?_Xg*Ct7_d^&j30(XRNy@c> z4Ax>o&D(zFn%%#g88E_N0G2Y&z~lw5S0mER2y=vQ75)0sKgf{CrQ;SCL-2xMWIceF z8#T2V-j_<8aA%?q&NTSD;_CDrjc>){E(`G0$zE=;H`5-m4X9m9=!;>7ApjrEr4C`Dv|iC1 zx#~s68eifseF7p$l4ys*+S2SI9AW5#?CS>`AV%P9!c}qWrsbzLBzj07Y5EaiXrB#f z)kzXR+WzAUVLt->PN0Q{jPG3bWO{N2Zt^(4M71g(eoug%1>4L^v}3{AhLcs#;OZXq zv3qdB4x$(6yko!Bs#H)V#*aWIPXxK=<}e)S5;(HFPX9OAT1Lymq5&9W8 z=}q|pnm($HV>v9z!il=aV6aOJIbX`*ptL|29xP{r z+o8r>{dkCYIF}?lKgcYO-uFMhfshz3q`abeP1{X^$WyiSH%^bq;u$6+)BIqo*{a$& z`Y*BH7>m2yUw+)DSZ28hvYa+f@NllF>9A>p|CM9U3~+^xY!@y*|eM4m*^Kkh}Zew|D1(WN~(Q@wldA zZG(@7f|(n+J5GM*@y7xj+BcrLtL#c0Rvw>!VK@_`4@>HBqOutxP2sOSL_&s0maWrv z9r8aglb^_%FNW_Bw%|%$Qfd5303%QH6=gDfc{2?X2UJNP3?RfkJt+>JY4((L*(CI*vv4+n&Uh_Oa$1%FUABbl#D*wF@8$}V?9f-f9sn2 znk}8?a{b>!#eJ>XGvdj9yG#od=WmX6zIjCe&z+v>jKjtNdT101UY-t)MN~4H6V=Gj zf)lUenhG7Z=Af=G4sNU;J0EqWB!!iia&qRNx@`u{m<13xEIjNGaf}1IJK#BR1e`8vLN7&K7Xgm{tU7bpAOer^Lpotqi}-oR${RDiU|D{+etZFY!GK z)-xP`4>qmNxJo_*&mqDAw|--J{s z7d8adK}MiQs&tU&**UPyXrdhl);5Bys!b7T+zkG9*PZ5UAF-Z$>L>WFgil3;z{l^y zfmHfT%d7x$j-FHO;4NAtPiPlXCPk=z1yX%HY=Z9?0q?5_IlVMf!NPckW$Q0mPBNMc z)yO!uJk2|dYNKgs>Uuu=KXrU;ONhWX}_f(=UO(HjHy*%zqC`1AY^qYwR%{Oq~_61dJ5LaU> zV^7G&q9+ZYDu17A3Lq#x?$VS6XQvMAB#Xx)h>1=ej-og5GO!1!Ez?1*L6`ge%ccQp zDV-DXmJ@MQX_e-cy1lV{&%+iJDEIibQ60Qx^dtbpb1l4x{Fl7P>x>R;!AvQRhEz90 ztZg>lFB{$B;*o%CVV+mF0Chdqj*^!WeuGSp#Uih{T^X)JXVXhg$sqz8P;(6^lmnBm zBh%QX3n^^zj(N#@GnR$?gcc5NFYkLy>q)aX^(`H*D@Gv%rgcz9m{m%Wg?o;Td(L_B zVw`ccng2dSS|U5DgJE^v7u_-W{=VYFk>;HW_9@Wa4Pf7%O7*2l$FGlkz21oGv|;+6i)!*1(v&*^ZZvYC8yn0!mC&x+q~hyCa@w|*2d z;K_C~r_Omn3qLl$I{U4^XBAn5|6EBNsw9Fgrwi89*q-Xlsr13mH2OuH_!%)d34k%T zVV5jVrMGk2?1oDBfxcrZMPxY(iiQQ{Guwhy;%AzGoUT4xU5=Q3A5_Z+bqO(BgB(fg zp=EkV_r*v{wsOz4bHkTle&;69J;&ormA19i^TkD{y!?vrU+-m1ls(s)_j~_`M)1J> z%99m2Op7ix=?eYqR(oWTg5WVz;!ZoRlB)F!K99%lu0iMM?7WwZU!EcWLgSeOzu0*U zB$N^IPtH_2`Oks`%~tBN)72LSfTUUhnfU9c!=}Du|2G{)&+Ln2&UY_D8q1!m3%cql zr6XEy-#xOm3*3FC{FG{q%ggX1^H7;SMG9Vpf_J3g{U~I9ZJQrVT1>_Vf$nAM`C8ar zV>{T3PI5-@tT+9R(ZTJk1ID{b0&txwDav7V$p<9ga!%mmV^j>aysXOl=m7f zyz{%fR_px`frP*&yv#M>E(>xYi_{TM!kB$w%m+e%iHa+EHd5)6793JL4@48|_ol7- zQzgkMoOM@NC!vx;c1kqJ8*R4l{xyxgJC|eQ(=RSZcTXVnHvZ~P8p0CP#fHst#y%Sm zZgpbEQ`18cZ~rc3ZM-q$zMEBW6bp?A6va8( zBRY3)z+_Had>&~Au#{-2z8ERJw?G#&l9$}w6XyN}_WUMrBhWrNfak z5&CVgixfvQs+$?L-Hf_mMs1drwB&AFWL^cglQ;Ze`?Sz?5W%i-ay(0)zNb#D`VHZp z<1?cOm{AnXC>mxQR*pj=y$9l@%y~<5EhI~rT~@CR!V~YK20g6mOZxw^M{2tvb-@t3 zd*GU{PlRxk1|;azx^m5PnR+3J=0vu%2mT`<66aWILUo8Pdi>R8$tlGzX_Bg@ zmpcSa8#o7Foa8_R>Y(PpFhtE6qu?P>x%SuYsYl-dBf7PPPC?JZa9o=jVEFdgW)Q>p zFPc1^fJRI9B}w*y&rqHvH~Q^=yO0<+mD?Li3_3DvKD0WW$@WpxpN1G>mF(k_>=Tky z4RkAW)le_%4i2!M|KnhF(C4-ihS?9vG?NKsht`*StI(2IjP~VYRub?s;6(Av&p1Wr zfbx>*-tm-gno2E!Av~cc@bL0uk_V?ijrMdX;w==R0Yd;V?ma@Bq*VCwC=GSvtHdn2 z;>d>jD1K2lV`NUL#aY-Iv;XBe7StRYN_(w!>S~khc{*mvzR>T`0=l*h{{tRmbYIz9 zH(-uEmm1#pV2I!`SanEEZ=Zaiy9lD$BU=B8Nk>M?sFyDv<74AS#u=B4w@Dc*_N;R2 zy8w*{0H7+VXqz9jpaylVW%#Ug!O?Ru!B*9o30Fspjt+SeH%WD9^JhjvxAwhF(S%XB z#yI@#I6Tzgc-_KC6ke&PC-qjggi|}$oD<^_0jB6#ccK1&?cH>|V>;e19X(_8mchZX zof|M)5;405*=9#WT~MtG6kFyVHSUM?Xe!1(8x_nA&(nzHA>GMApv;soho*Y{;|!Bw z2n{*Ay2Gwce?I-6`Q6ubhM9&+64$qNX!Zd9*-5X83?uLZpSO7;2b0hBklDRMAV5yj z?p04L|7MKPWUcG^L0*M4ZqQ_t{4AzM3+?Jr4v^%CEu&IMdA0 z4aGT+A)%wW&iJ3@ba#%4^k||Hf&Wc^oi}lpJ?T$722{+i66z@qy9EA-J+Nk^lIzT{ z`8EIpwt2LV^=Kd8QGj=kk^R0EFdH5_N?V8bfev>U^WfK@WeDb$NQyDv5--4A(%^`0 zden9RM(TQ69|8aGdQBiMSdx#;1mJR_0rAxXQrA0y-5h(!?kq!YFh7>6U zr5hzgTBIZ;q+6N+q+1ZA-!pTs_kZuZ*60V<@vQUPd!L=p-e(g>uf$fn$x$25Jzoog z^_4X2T+u zT99Q>BC{sX|D~AGICpn$ zeLu_GjUaSe)Gj3hhyaOos~|ppPo#(&<6QpNJsWwa$M&mV<>EmCFnXYZ2JgdaNe?zItNau_>;*J{6XUeC?Oe{UQ?P5v{ncDC>{-R zJu+y^oK=evn3{qSo3{DNim(t#=xf_Tm_%vDMDPrM;TM?qVT|F|$7m3Z>pV+879pVx zRyj6Kt<+BR=bh`F`N#!r`P_>a&wkA^hGNtfk2%`Fp)s*;I z!-2~@VaUw-1RNl*Fl&reR>uW+o?+Ea0`#1!F!Kp&?KZVY@R)RlJx>jiP3fupm!Nr4OwAgr$JF^JOE zadDN%rAptR#t#1Ys;s{p(Mcw@8o>_n#gq{}LsyU57cjZxWXiGr?|6}TVYf~(rVSUk zo{79@4ChPr5t9+bMLn>CYCX0tAD66~O4n~>Prm#TM{@^_Q z`Zo7ZG%ja8@9CvX>^?3}4#ZE9kqXM#MNDms5X_GdHpYku-!KJrZrBL|3?lIGeNk7q zxP()(OqrugYjgE~aYt%3QtZ8nM=F+EuE%ifOgcJUfglee`n~e4imb7dur58LGJHe^ z%t=AV5@U%xKug_eD)#G^)5>{YOQwDMROJ)Fu!NyDE#v6&kV&&n>90;39p7h{%dlc9Y z_vYoS|B0AHwGLZLbGJ8JmpBN8KYq1f6LEPan;-z{p?1C#VeOx&~ zc*7JfvO4K(7rvisuIvL^VU0={jY@=#Km!b(l99QKYX}B};1up&Dfq2-0J$Q->LqCZ zCgFUFr5`DK3mul+Jpy^K_YA2yq-VBS*IxsuXVql|{Bnde*8P_}CU)yf+lRIo3yE0` zf*2r9IAY@cym9pCs6pqJ>4o{#9Gj^Wg@GQ#dA?LW^br}ET~k^nv^EpEdT9eVN>=Qz z7$7Kg7@m{LK^PN7!?cnS=e{*fYhMA2HFuKqfu!w{H3bcN*e^Ie@9E2#9m z&5h4n-;t{uVDJ-K-!=6bVN_#0UeFdi9wiX{cvAihf9n%-Y*CB7j0z-L8&@KohV?OX z2~rlsH<%CyeZxHnK0@?a^5~232pFbSSO%!$tf0TX3m|*P8KXWJ_xMjDURgjxEuhj? zXlj@n97k0mD;$di!**|xOOeru7ntMkQCv=RyPhj)E~5=qQKn{6rp^&V=U^?h)8G5= z(x7J1{RMCbg@q23f!|aK@+zl34$Z@5?D<^;H50vo6P-a!*#Ww^9tL?^&>M2U5#VbE zhtsh7oA&mqoS_2)>J2wF`WvW!qBHC4{N{9qF*`b-oh~WLv6n;r`53gYN-RHf??_3_ zbfJw}(NHi4l_$A)f7uHKi;Ccp0D9yvCBhX#c$KzfUN5r7CpE>LlFAew$!O?Q*`&B2 zUn7ly=?h`Clps?}!KG;p^Swt3Wx3H+C-d+59|()ZYZ(JBYUt_23sHp1TCGjozc~Kccq4)u^xEKs z&XjLNV?L2;x+Ja&XBQlzFQnYztW8iCGnvF08u~}KyQS*BoVC3I+PnpJrn{7c5hsXS zBy%sM&V@5}BJtm&IuejA3CO@i!0$Iy`(-QT0`iA!w)&6#p+@)nOW%$O)d-!_xK*5==nXiQH7OldqL1Nse2{2trlbsF>QQa^Ci# zrIhmf(VYGf8VboWYa=vA?37Konq0{ieed}POH7%-0dWP2&jx(paIVe9;+Y@cRnaa8 zfy7DTTpgG*^jiP(I}Rzcy|g_nE{PjCD8U@oT?6!W>FB?ov_*NX1S@nB0$)$2yq>(B z(Vhw(BYe#basK&sF90lmj}m;3G6!wGaAFrkll|<94Db)hv&;ES##G)eg-{Kv(aV0< z5$vT;S@>u7#dx4o!?_UMJ-P`B5y^jplvj!8}VBL1*uHKgdr%O)VBV+{T;@sHdV+Ng$$Z!3gCHKnxCGb8^; zkjQ6mo(vsoptlZW&~vz6lIv^*bEMAIJ=su0_cX|{2Es_e57YOIGr^{M9qZJu_0!pG z$WKX!$n02-Tv!&I?B}|eNE!jC#ZZ9sPD>s#FduDlGuW64)G#|IjVBA*ZS0s?=o0_b z=dPKnoK^e);tk6i1t`G+)=%#n0O*{6wA~HBT8b8poXLmUQEpO!db}A*ZNo8ivNmn9FomlNe*ydIY7>P8S!kk6ow=73+GoCm zhzGVbA**H-Ia-Ql>2jY$;Fq8}8j&rH$iOBvJ=}ah-?A?mHUh1i%f*b}*gA_@dZ~vw z0*A%idpTY;0v@6#E;vK+(LR}__Qmgqa;|uwqc%ydp3gBmx-FS>ZCIxEefJTvRi+Ao z(P0vFXwOh1@!M67_hvL~w<8>BJ9TWokw2BZ%)|L^+Z~}$*k!YmCj0kt)yp23UV!RX zB}%}h&>Mzmw0!fyT86Dz3zP?3g^?pAQD6iP`Wu^?OyP{Wq8ufmUVUVpJLoxHE8laK zuQ?2ertsv=65De-->eh%x0P`M7oD03{D6B8RFgxcv7(9z=mW!c7^(clx#_G9?YP-2`&Ud?J`_q-4yYDk0QNKvRnmpp8J`1K4E~bYl;<`6Qp>canBk z!MlO>>5<`-{XGok5R9jRk+z|mw3$|p`8muFHgLjE5K?aTqmj>X7g?gHhpVfz-eSLS z2eq_DSk%9mb7#QQAzg3BT-}wWzjw27(VxVAD8vdnGF(CVJw-Y%9C&5~zH(0Vik;b2v?59BCIIe&87LUQd#c&)xr-Id zy(_Pxuq&v%Sfngt5XZi=9IK{fk-q?g1E;?ZGJlFGOxLyuFd%FL)(jx|GsZprdEz`7QIt~!<+^=Sm{?T6 z+^DI^sAU846OL)@{oqY((+0kbzIN6--WJl@$=~pIch>=T@*D3e!YB9@sG9)%tW?i zA`xPc7l<4lk4H4Q_6~AH;MvVhJ&4zCDNBvuuKgYaIIDV2bb3yLdQK90J5Wnvv;r5hg)!xJ!%;t>oh)F zsV_s?aCDulHJU6m;5VM5oo!UTTSFO?1UP?RSC))^85G(0gR-TwRM{W}V`9a>y`7ds zq{Iu^#k@DM2y`BA1u{3z6&&AKs=2vrH8VhW+kp)5l? z+BLo_r*)g~K(x=g!g!6+uk9YA3M`x|Rg08q`mV~_-+(^VrY6;yZ^j$!DmX?~42{}=}zPwok1nzD;tED9jNxt3Na55x7yMt_2sHUlM?fillPIc1n* z-8U7#lA!O6x8jJiM0!!2%>82ZkO}L4x#IMPEe0=AF9NBaj?9%=b|bxU&p8M z_8UwlIaj}VBh67g<+-tTivS<;$r{~F?smrmSj>0X<@fQo+56|OLwh%dWi@7t&$I)R_ zHoJI@mTLy%U@QH*c)W{?zlR$N#!lux?(l)#ut6ItTLFI` ztV+>d%D8M|FNe5Y{P;l7(E4f@H}ubHo%4*ziW;)cF!TU3^C6@FZ>OhI8Y><1nj|#R z9ND@Tz#(xX4Fx*p^^HKsy!~+Xy01wMuH78AB=A&C4sIlH@<*A@#|#K_9MOFjXTJGo2Wi3&l-(0B4PFbZ7HYa7%PTqnls z{a!pDF07IyVtoahnn^A2LbLV7mqw=Fx_j$T;Jpd&H@L$J;>?!82vf`9<=N?;@Z@M^ zdEL~j?sqLrgF&0UC66Hf`PWmE08u<4R=k&vjh$*fqS24F`OK9Rr$Y>;Ja=)wXD!qR zCb^>Xot4q$aMqz*(|Jz*Kl}Um5SJWs# zZhcgkbR(+$wQN_3Wf=NRW>I*eRL#>4a%hhPYs-g)z8OUGL#S*t5~D+U*_K@xU5MP zHpFNX(E&B|RSdKE6V_v56GW1}d~ob%yGDRfI;F#a7l!5Re>o2h&EP=b}(3{0FU1IQ|RUp zV2W@?7scu0E9NtpG&`B#dsZDkv}S|g)EJs;J^!2v?y-`SA@$|&g;m?-tJIO^{WjOo zvG%3+C?Fgya*c^deNX!}XuksA4p!|6g4FBg>@_=^()srcDfrCPk&!QqF{T8cPS=TC z*9oZmR_LCB6wWngFoFaApqakY5#jFl>U*TX=tjgGs$llcGCFS~ zFAlj_*IU@blu2;TAc|Ds1e6z3e^@P2{@!~YzYQcv3Fp`e;wvk??Bas~I{D+uZ-Bv< z(gDRRHta}zIIK!FRPl0$;nagS_T&4x`GKVRfOBepaSn#z9FuZNZjItr_Z;8{>89dO z8OlqBQ{um>SC{5_t9E~Ip&Gzj_G#k?c?3%(7_$5XqP}>+IVuC?&C4j@vg1#q>s@%u zmFH7!)xFnm&a*SC2fy6s(8$uLMW6{lDET(#vcuICm;Bp7ZYo{EsU?_q8ya=*8|3)9 zK2wlWpCjfK3{*5KbQ2dqGZB|Y%I93t3nW1W9YPsmVkP$kSa`x`H_J`W>bT?EF-akC z79>k0B{+-1)8y`u3P$}I9}sO%yGL!`!T(VGhB!l{mbntYse=Idfh33jI{v85J-1sHWEmj5{DnFaL*F5IU>Nz zO>gA9r!*<_?pt>$;V>v01#wH@pAVOiITe^+CduEs@9$l(4xTB>SG{qI-wB12!Y%Qr z*oQK8hj16;8!h3G?qMlXqa~@gN=e=^H7`)D(GMZHjLKQ+r7DyVb~wIJG42E*$R}%l zlpw8wMw6%q%1*;}Y2kMoPdSY^Hk8T5tuZ3XeoMQl=9l+}PXhy>9Zgu2P|u0^ zr46s6ULp6OY3@ajH;B0slS&|^U$U-#-@+_e^S4aqnYcdrX`MzSJysT4z1YNEiEUAN zh`v={YFYFSbzY?4Nu^a;6L%)NPz}I!c6rza6RppGV8;6q%2jc6GTF-Wan+}FTIU9<%{&xsNaEP8CiJ!O? z#7jWv&3$sOn<7<4(x{|Q&imv=)SZ9?(5c`AU2ZfaM(<2DM9S(Fz9r{91Ga}4%KsNI=o4U4Z27gA3NIBQaIqH@QjT# zlbDOE_UXRc)+G!}s;K?H@DfRLg>{tR>E)2?m3qr_t{VqNRSphjM=Y zRR+~`#r}$6wx--B=bKdYm=qX@=;b5Shm*mT3O z;k#Yc`qNHU+wGQMG$%Gq3XZ?!7`}v&_Jg$d+Y>@f<-BcvkS&Yb9%lC(~NxRX$c4SvTSMW3<2*7I+21; zwTFcZPOM8(uqu6g9jbP-)ekZ_+I&Ch7W8D)J$NA6saTH<9Sf@2V239{kZ4J=Hb0ng zJ7h{g%wIQ05nCsdh1@~hf|eF@sTL1?7OJ8@eVWI5gIHM92AhBzZBH^?!+f8DXC0~$ z$4`^-<7L+*tLE!v@eXb+F9p0#HplaF!utE7&;tBM$o7Ln-n@52Hi#|zn_*|LBRQJX z7_ywIG+f%lMm<#D;e5#IQNfms8Q2_FZ2;#uV5fu2W44+ckM0o7i>UYmrPw&U- zR@NoIF0?9u=GkBoa8?1o6zlrC^It)J2ZCYrevd_Qr3S zBO{;}r|fJeFFeca6)&5B0yf1r*@yR}UUx)O5L>j7Jcpc2l;PXR2TmcjW#IIErj7ah zjk~zZW7@joxKVoVSH=^FV$KA48nF2%h<%)c#x(qFxlVH1{Y=2<1!1h*BuFS_iq$O* z4mKz2hew-BkFKLuPCv#{ZN1@8eNN6zCc(rsfDJyBQeuQqA`QhvDe5MpAw(p`L-vwV zbVIC@MikDtNPqbLyN3|9dETMutT%E>n%%xY3acHxFNrwz7s2Jh7x^~0o#V=Q@PtpL zDBOpAtsjYKA?z)^^4_y#$aptZk~hlUy3C7B=hU(sg-aCBr_sct z|6)K^G+wI&9Ka*&XqhXXN-~ngRvmZYH?6bseR0 za4sZL^v@xA`xdE+2<@(GNT!3gpm4rW@(dom=v=PVg4B z!5wo7mHps1wN0P9`s>||S&NIQU$T4{ybYY_aZ0r3ElG@>z~3^e==d6?ZElEf<2&Gv=?HyATZc;JfJQbZG z1T)j_OEQQXe3U?aXw~UaU}D#ufL)S0nqUqld0&^n$QA>Ewm0635C;=newef?E-tOA zk-f}L&}2O)YFi)XRcHzv!=2a|67BLe!FW{hQdsy@fXzM5CH|AE($4a{n!_Cj`|fiz z)9?5cnzAWhn+O<3%WG+*(V#~>HNMkq#Dbz_Gm&JrjVsO2N;BizY*nP}t(ce^2$alu z-iIsbjT8a_1@FIcIOS71DKtqci{=)(_*nSgZ(ywICg7YG^l z?pn?Y^*k7yH1b8DlJ=zUYPShv&a8@I;fU-BG#w6KR)mc{xDk2iIS?aXWE_LMRJzAf zsvE`UfMKHP8ZOgarzjH9!Wfodt{DQ2Ec0t|{*3NQbGGFuoUpmLc8-hUrtu-qEY=s7 z6X`@TEawb4nVzukcV4h?&cd5e9KkWOnffqla2~H<*0U>lBEu)B8!L$BW27f`8&#d^ z87jYZYfzt=MnzQeg=^cFwe*$8V|QhfG8%-T4`p1j@1!EEV7;Z8A#a?2xqsOhX&fHz zd`9VU_g7a>GnI_$GJO=kl=?|875fOUZnkEl5MZF3y6D68>Mu0j#Wv~oGe_{bYE&nc z^^;dskWn|h=%qFSc5Mt#A`x(C;`jr5dXigT)RMK~6fJUNpFX)j@tKJ9VvbN6%C}w& z;?&>zbBsXrG2T}`?|5c3ePsj)e@KOjsq>dcY-*XR_4RCu+k)@>LSda=OSnlu@TgO) z^jgd+yq?4as-aTsqc(5Dma#!8C{NdSb!jZ^FaBi!A<{-OM9|j2W~SxyQi(*tmDQXW zPZm>mUTwI}6{5QWU#Y=R=@bR5iW*O}R-Kg^OT^&C`kihJyYQC%>%PuQf~ z673;Lfy=rg_3%n3aUO;0ciTd=j{;yfvE5BNQ^uuG{PZ4x%8TF%1DDAb)|`O!t?lZS!;cqOPjS8)B73#05T92A zE*93H>~}sV&p0Ir1!#uSe99dSIGt`xLTsGjByrLf4TgW%AI4~UPPjFRVxq-~i-I-bkdU-^opisJ~q++u(7j#69|ZmkM; zu*a3TOAdyk{Ia4tIY0;)J?pn6E2cYf|K=OJ~OBK z_>Orw{c6c1s|)^vC-W~ zJ9l)Z(p7cSTv~>5S5fA5C)KXm)1;$~nlI$fQvTx@_ynnMV-U=&WvTp1ionc~?7~d+ zdt~Cq^dcot%fNAftBm*Au?5Y*g8Qp)}jm#m5B@wmf?xe4+p zG26#{I=}C5K35wi0}R_&i|lQ7c0fIB+8OT$bwaKZMvi~)Zt}NK>E~H`86Pg+nXrbL z;qGleDJ*%O9umyWNvdWxIe2?lnsG`23h-8$+VH=qay(FLL*y-FgS#@&m?)EBU=aXg z)_Bif##fw+{{r>bQG#L3x1azsp}hC0^kQ``HUtQ4Nvpb7=#EcYB;(B&s5iL|nzARC z#kJwq+Hg+2{wvYXmlE!jr2vV=He$*E`%lUT$B$Ha&!P zM=7-PSY`Cc@u=g(O`q??Ub_)MfuP4ag7Kfv>y*hF6rrvx8QYwyTSgnYE`V3fSmSsI z`ly4Pp(kwu0q%=E@gBVr1=VZ8!o3U4&0r4)axlfobQZHUrFIdkj3GI|3|rQd-bFrx z_@_H(g{b9MJh*1^Q@-!UMdehzkZ0d}(*xnl|kfH?Yz?i$$hz0g*jJFjfL z*q0fJ3`;sZJMWquxg$rGLU_U=cnB6@&8|=YZ;*32o$<9OZcAz8iv3OF8J6yR>kjqp zmaCs=P{GbE)QWA?K`zj_Y9t!2Na^O>=AgECAE;}Eh#ZGw>r4{I%n~PP-%IG#RKl?O z*L32haBEXIr(yrmVLDLmVJEM@beQh~mlWEe>fkIsLN7jCfn6DCKQDAzjUq83r#B*p z(FEZWH8&!EAnLIm)z`bW=|sA-k__{H!a1`HynW=3ok!=`hy?f%?UIbzOXrDJdTa+T z{eR4L?lIF`x3uVHH%FQkDm;8by=M@GGT-_0g*8uiZKFtppziHWmeuB$1bG?_ zI2Ye^(aR*g5$M)rNsaXP{YK*0f$Zo&YL{iO;hlGvW-7mxrjahI>jGMswY;j3<=(K9 zU0Wo!mWSC}GM)Db^9Ao)G>XbJL9d~6-;jc3=C_?7HJ%C;HXU(@W8?v-Yi(n7vGbfyoq_UP|1L%;XgINKyPmNCFYF=JYA6#k z(@Sbrr(O2p1y`Pv3e3ZPRJ;UaG(iE-@$C{tjJ-Zp7 z%vi>Hql`6u<1R+41q9thqvAFp(e7AnOys-PRt zxkMz$8S^ljJo-|JIG0<>KPb9^^ z*2WpmTatYBmMB;SuCX%l_i-~WY%`Fx9F$Od#x*%N*@*gc34xk%cMxa@6BtwVp9yrR zu#`ijcb^0eJspVP<9y0XPgM7q0G8$4LZjG56I2GB8%IiseccHw4#$_27p_OkXc=K% zU_Aw&_!5q_xU0)v`L<3{Kgm6E`g`P^G(omRYrrMDDtbiptUtx7O^2jZ#esz}N7mAU z2pQAWxj_;d;)4zl%dtCY+`bN`gBb4Xjc@qyt0jkaxyAuQ27L-W6CO_S?LEc0cs>=3 zm8>@^S>yN!`e=rM{~yuyZL5zDeF)oYzYC8h*Jg#cWC`7jEf-H*#)mO(y@A3wGHU-! zxIKiS=tcV#e|XFn=OpSF6+_a4{Rq+lno3sXHMYl%S<{XGJ~Q3OhPlP+%aVnW1nRsK zB0}m<>tCB`;`BefjjdMkar*B4A9@V$Xu8l+8u&d~j>t}mrJl^b)Y;chWJ-SZw^R}T zK{Lnu1w8&RVt#^PqUIJr?Y!!-fsjpIIlm6TocEvhRLu{JP{=Z`SHsR7xqIGxN0eb{CQkLdG;G@Mc>v7>O>AKqG`MI+3{q(;#)#>5# zk-WkC5bMw&BZ;~Mxw3NSM7NB!%Q!J%>9f7K8yrK0{!cSUi6BWem%7U-y&J0_%F(aY zL$*_=$LrRVeZRtGip;Bo&T$3Vv4YgDVU@YB4PuKnxfH|M`=7IcL5_6H$|ii4N%S_> zyNV;%XSS5`&&C+?>gm3)sm8l#d8xzJ@4t(C;L9damv9Y^ni?OtZ8mj~IQbK>4m?Im z#ZN#6zU|6;y`z!hFAv~K?LkE045hEPQ-)DW_oT?lHW=@`mi~&7d|_-DZBQusn%tr~ zK50RFrK=Ou{7E=(y8@KO2*#E_jTXQIQld@>;|m5{?PfJ`bvVbjV)*OanMHH}W2bpu_4 zLTXoKBqN_M(Y2P)B=<}9jd+2q(ktlm_`}@M6{UM9bo+CFu2_F|-H?8q93L1vGY+{%)EoMf>{A&o07+MqIe&#eD5{qm@>SVD|#hXnNE6Ls3mP@X9!}HT@6Bg}rFqbJTTsiW6j{dga2j<*xXRO3+z4)M1m`p$XXXKVCh|Ac z5%t4BIt|+%UP$z#!@Y0;eA+^k+I8&jS(hXbj0LPW3RvT~3ACt(g~G>I!w&5p`WvN$ z%^fA42HWCNG~J|TPt`sj*IIH0c@k3AY}n0wI(s*k6QFh9 zP4kd%$VD$HYWsfh`RB-91!z4JnM{5lN6amm|{UeLE`pzS8Lb#Z;_31XhV9+P=AMcjqn zkL*L=0@(Im@rSsK*V&0gRrYOaO7~h_lQ0t8OQFY zPOfdTpDaNPSMg6|rhi%oCJmejxdv;dMBiIU@gr)UOyv2vn=qEld~uz4821oO7Au+j zq^gSN=1LFRs7>3;bAnCtD~H0lqVgll|ft)ZmkIC z)FDsf%(J3u(N9j!XS3@ST2LhZkkdg_k2LUGdHfC{UR36L#J`0xoMH+ukWn8Gf#FPw zRe8(d`?(+JM-rvamuyG*6q`UF)@qd|k)!0(FeGU8*Un;<(IF?@5WhG*tnq)+y>7|F zJ|2pf??!ZUCobkHO>|K=V>e?E>y023-R}kei=W%yXDMZ3ya>`gFql&4g#J}T^?IL zefpT+>xo08PM2njAbH&$_2|qaX7#Hkq921G14K8oDr_mAGJJ@-JWl%PBF()(``JQ; z@H%+T_*u2wr*OY)_raA*uZ@X`-5&-GhhCEVEO1EHn6hl*^ibrjlQRDLh>PIC?}y#5 z25LO6iOhJuwvtv_bP1>eE(zkpag%`+uJ0x!NF(IA^DGu z=VJ4ZX+AZC8R<>MdVlZeZL&AM9b9{xxvh39^7D`590b?aX?YB@5+S{gFzQar!L*ft zKC5@iEjN-Q$Hc~@!_KGQCUP{ttCx%LHCrc4s4-2sb7^}_+~(`nzL_*&(MNgP#k?i# z@b2#r1|^w`%`aIpBK1MuI$z;3$Juf-PYX1n=j5<8SCVf|$M`pUTp=8bR8yxGs9nWe&F)Z!Sz4X=12d_$Jb5vfaHqX zXRy*k6Au%0P8}Dn0Mq1soS=$I4F@$l@h7K;)P#2~6I{Vh{~9rth+q41q;&hM_;ve0 zLv8A71pC*=M#W+E9_!1J1eTj0w~#7OoJ)moUutcLEK|5VVSgno!{yYydtdzqsm~py zu$4Wn%Xf<E%J2aKQQ+mJ4`B=wIc3FC2sDYm;TKiK=0?uW#4(T9cdZ|`9{j~=c);P~h% zl{xLw*)H~;Zqi@y=i2;Rt^X&6tvBDpJ%JdKvfx zx*)mIp|8>pS@*kF_Vpx{^AJWmitlKQ7;OiQBq|r_v)&fBtBu59^OV&HySn?`sH~d! zB(~0)wOeG}%4(p>%NlX06Ou7mZRh|0Zze7kMnJ6pQ z7~O5XWFlkY5O&Q-UtG0gDrc(>Y`IY$>Q&l#OLZB+62b+LS9`v5S?l=im;EQ&{CqLd zYfV++zA#4rY=WqDnJ3}y*;n;e@!H&@Nu1NGvNq4Ul&kslRQmeh{zrYGhkP%Oc(rDo zmfO=%51tyQ`C>z-r!Eiw;!>AmGnz|h;TU3*_7xNT=d?YG zpRJ0%?HZ3xms-m4P6QTT3tL`dXi)yylH@}YmiJNRu!||Scw^CB^44NlM4IJ|D78ur z;bVzRu2q<6M7r)y~4@p|!4? z%OgiyS2Ts)WAA8D!s*(#pNIE2y&ZRiW{%&t)R1Y0?#nz1^@vR!cel0wVS}TlR?_*> z2&o?Yl{U%f@m+2%_UE)ii8UMzNStd|#^q*g&M%h5`))5e)25a8KU1cpP@K9|{fN;x zjyC&lV;8fD@pCs%QsbMK%&uB|%?};TQy{A6392Ce797fbw+$MhRC<%1Vn|1$+SwpG zh~iO^8vRR&%p7*^ICUD!_DWkJHY^nbp#qoH%(}orZn89k)s|9JH(Tu0o%^fnpMT9M zJ=pei&lWy)FMK?EpVyD}LA5vqi+{nFqzT7}dbbNRW}7E)Bc?&6W=`VsRlhsy#aKIL z2Ih-}S#l`_qjUZbv{SPy&Ritu@=|dc#bVXNA}-Ml^=KXY5j8SRCN|jwdCYV!5>;0t zUH!Al%lUK%R@#H5Ca}%u#MAVL0_(R@64hFIG#&;oB6Pa3#x4dRj|+5C`+u z435b3n#vCPJr=1}Wr-_~a5Q+Vp3{@6U1`0)?pEcW!w&h3d~ACyJC)ci{T-GRU-X+e z1#)woY-)wG6!t5{Idc|^_K$>gC7w#4M&s4;zWliQ^?G*f=Cd!ii4EV{JeuRheO=pz z{frLB*uMJJk7m(q0n-oVh9chvtvi0*Zd8BwYq;j!E!NwQNm;+hqCz5$heuXs=eh7S z9vrH;uX=wTmzxsVC+d}z7T6heyhE1BJ5mO5*eNIkI8sf^OO5nYH+Kh(i`afn2*JKC z-Ceh;o7}c+awM{3bQRp;rfU@s&uvf_5$VJdcDQ=+R;=VA^4gQqA6hHV`;l@=YQAd9 z^7FR+!pIcHckuBC#B911<=^FqP9yvsg`o5|Y3c@?l3qvj9^Z$JB;@9=>E36G&@X@f zQsC40FVdyx)af(Gf7xOdQg~7cg+O!}fkX5cTiom(K6xmB`CABm0XL2BL=P#`)gKy0 z_~N&#F_rO@*~Q+;2o4@`%$S!b$cRcUOyz z)s^zUK3G|gW?$&>8V~+B0drB6Sy(dc+K1#X0;2}%bOqHELSVBR@$O_(gZUzs* zshVsyWs@Czg*fRkZ6(d=y5xnvX~XRHuT*FQF+!G%*WI9`2R^yl>usNL>hi|3cxg20 zVO?88De}R(N9~pg;jGboGS6?1k0Vos@jE@&X6}zP)Q+!zQup$F@$@4KpLW!w=Y||k za70@ywHrg9k~K|?kgZ|Fj#%U59g+23ApM z_NxpDYQ%TK(XAi%(oDzIA6{7{Ov;P;rGw05e;Z?{k?>1cgUM-)k7sPo(>U%ztEuSXy?0l!3 zc2-`nQ5?#=x^pEmOc8WsO)OH3*^nzJ&%05zkPlsgl43oA9OxTio26UWG`p*fdw<3i zfl%)J+}Bk5{zY4ZS`<Z!kYc4jH4N3=Hs+)vdl}*4qCf!eZ8@JTHPOTvMataf0jR>Q;^~ACGrh9PFppU1behdlOf4#WI>;)*q5900JG|)rS_4I7^y9XOo8r%BBbImWc!?yc z&)X3dHJ_0&ZquZ-N#nYl`OW&xdd{}i-_!5n*sScrd%W)I+$K=K^twH+R94jLM^d** zIqthNEC-vH5q3hc99K+f=GChdP#X+{MRM=Cr-+=fEmJgZvJ#C3C=$jyT`J-Bwry8~ zwb}Y?oe~q+6;@WKKNa6EpF`fMgyrz(y}BWhU(y!*nR4kzBc-~lX}QRu(WARc zYFqMm6Y6mrBQDm?-oc~_JfF8rI$G4)8Cuw(@jBS2))NRpqWP%B{N}jtGn6s0QiXGYXN^_jr81#%{Luz%x0YrMC@oOI#|ECbDu*z}|v|gpWS@MJ~6;+pc-$ zbndGMH!mQOV|p8w{k4g<@mkkpgxB_h5wIsTFAR%LvtUv6SzHA;-ZkYH-FYD?B+ zvIPxGAG&P(S2Bm$tM*x(`WEGHOTu%j7k~C=lQF(}PV$8Hc9yO7D!W?F#y;1*ySbKE z-3G0p3*boS+ajXu7y zcFn_2GYkD*{IZ|!yg8uc$vN#ruXwj#FWAh&cMm z;zKG6Qj23j)!y1Eh?f0rEyI$)P|-$L`O{)6zc9yCJL$;W{=_5lZ{Oq(6IN&h96UD7 zxcuEtxk$;LX}zb#CR|{P@2a~fELkDj^YwC2jbGen_KAv``BS*%yf!k4EPj}uZa9omssb;8#n}Q!dFd@a;@ax?dZnu4;R8u6)AA{M zb$))fa%XB+s*d804$}|!Rl&TgmvC0iadJ8N>(P$WjWZUmTEq5jhWVW!2k8?HCzYd}l(=`FaldJ$^25Hy zdhxd3K94SWt_fxO?ASS-9P7^ z<$O@?v3b2fTKIgk_pXcA*f-zr3@p3-bo)L2O`q>Sn{fAkO2ud90B=Sn24=(f|7$kt{5e6C>K`iKqOmRkPYDqD$M*yV2EfI86&_{9*rU)9a!c2jU>!52! zAD%#Ht~3N|#xYodZVq}s9%0T5BUX%FJ-Tl64kkjktqGEDSa%a$J9-BSp?!`i*b^At zDRdLi+vNxo+RY&*z+36)TG88%2(5CKV6EsaNpu6yOC^K>toE$PWfZzb^z4h!DC)q< afF&~rc(byB6mbDz1F#I7> + +namespace Lowess { + +void validateConfig(const Config& config) { + if (config.smoothingFactor <= 0 || config.smoothingFactor > 1) { + throw std::invalid_argument("Smoothing factor must be between 0 and 1"); + } + if (config.robustnessIterations < 1) { + throw std::invalid_argument("Robustness iterations must be at least 1"); + } +} + +double weightFunction(double x) { + if (x < 0 || x > 1) return 0; + return std::pow(1 - std::pow(x, 3), 3); +} + +double medianAbsoluteDeviation(const std::vector& residuals) { + if (residuals.empty()) return 0; + + std::vector absResiduals(residuals.size()); + for (size_t i = 0; i < residuals.size(); ++i) { + absResiduals[i] = std::abs(residuals[i]); + } + + std::sort(absResiduals.begin(), absResiduals.end()); + return absResiduals[absResiduals.size() / 2]; +} + +std::vector computeBandwidths(const std::vector& x, double smoothingFactor) { + size_t n = x.size(); + size_t r = static_cast(std::ceil(smoothingFactor * n)); + std::vector h(n); + + for (size_t i = 0; i < n; ++i) { + std::vector distances(n); + for (size_t j = 0; j < n; ++j) { + distances[j] = std::abs(x[i] - x[j]); + } + std::sort(distances.begin(), distances.end()); + h[i] = distances[r]; + } + + return h; +} + +std::vector smooth( + const std::vector& x, + const std::vector& y, + const Config& config +) { + validateConfig(config); + + if (x.size() != y.size()) { + throw std::invalid_argument("x and y must have the same size"); + } + if (x.size() < 2) { + throw std::invalid_argument("At least 2 data points required"); + } + + size_t n = x.size(); + std::vector yest(n, 0); + std::vector delta(n, 1); + std::vector residuals(n); + + // 计算带宽 + std::vector h = computeBandwidths(x, config.smoothingFactor); + + for (int iteration = 0; iteration < config.robustnessIterations; ++iteration) { + for (size_t i = 0; i < n; ++i) { + // 计算权重 + std::vector weights(n); + for (size_t j = 0; j < n; ++j) { + double u = std::abs(x[j] - x[i]) / h[i]; + weights[j] = delta[j] * weightFunction(u); + } + + // 加权最小二乘 + double sumW = 0, sumWx = 0, sumWx2 = 0, sumWy = 0, sumWxy = 0; + for (size_t j = 0; j < n; ++j) { + sumW += weights[j]; + sumWx += weights[j] * x[j]; + sumWx2 += weights[j] * x[j] * x[j]; + sumWy += weights[j] * y[j]; + sumWxy += weights[j] * x[j] * y[j]; + } + + double det = sumW * sumWx2 - sumWx * sumWx; + if (std::abs(det) < 1e-10) { // 防止奇异矩阵 + yest[i] = sumWy / sumW; // 退化为加权平均 + } else { + double a = (sumWx2 * sumWy - sumWx * sumWxy) / det; + double b = (sumW * sumWxy - sumWx * sumWy) / det; + yest[i] = a + b * x[i]; + } + } + + // 计算残差和鲁棒权重 + for (size_t i = 0; i < n; ++i) { + residuals[i] = y[i] - yest[i]; + } + + double s = medianAbsoluteDeviation(residuals); + if (std::abs(s) < 1e-10) s = 1; // 防止除以0 + + for (size_t i = 0; i < n; ++i) { + double u = residuals[i] / (6.0 * s); + if (u < -1) u = -1; + if (u > 1) u = 1; + delta[i] = std::pow(1 - u * u, 2); + } + } + + return yest; +} + +} // namespace Lowess diff --git a/src/data/lowesssmoother.h b/src/data/lowesssmoother.h new file mode 100644 index 0000000..853a0b6 --- /dev/null +++ b/src/data/lowesssmoother.h @@ -0,0 +1,38 @@ +#ifndef LOWESS_SMOOTHER_H +#define LOWESS_SMOOTHER_H + +#include +#include +#include +#include + +namespace Lowess { + +// 配置参数结构体 +struct Config { + double smoothingFactor = 0.25; + int robustnessIterations = 3; +}; + +// 验证参数有效性 +void validateConfig(const Config& config); + +// 三次权重函数 +double weightFunction(double x); + +// 计算中位数绝对偏差 +double medianAbsoluteDeviation(const std::vector& residuals); + +// 计算带宽 +std::vector computeBandwidths(const std::vector& x, double smoothingFactor); + +// 核心平滑函数 +std::vector smooth( + const std::vector& x, + const std::vector& y, + const Config& config = Config() +); + +} // namespace Lowess + +#endif // LOWESS_SMOOTHER_H diff --git a/src/data/pointcalculate.cpp b/src/data/pointcalculate.cpp index db79d50..9f8d293 100644 --- a/src/data/pointcalculate.cpp +++ b/src/data/pointcalculate.cpp @@ -213,6 +213,7 @@ QVector PointCalculate::getPeakPointGroup() float PointCalculate::calculateArea() { //getPoint group QVector points = getPeakPointGroup(); + logde<<"points size:"< PointCalculate::calculateStartAndEndPoint() return qMakePair(startPoint,endPoint); } + void PointCalculate::updateStartEndPoint() { //需要在a1和a2之间查询是否有高于a1和a2之间的点，若存在，则重新给a1、a2赋值 - for(Global::ExperimentData& ed:_dataVtr){ if(ed.sampleTemp > _leftSelectedPoint.x() && ed.sampleTemp < _peakPoint.x()){ - if(ed.dsc > _leftSelectedPoint.y()){ - _leftSelectedPoint.setX(ed.sampleTemp); - _leftSelectedPoint.setY(ed.dsc); + if(_leftSelectedPoint.y() < _peakPoint.y()){ + if(ed.dsc < _leftSelectedPoint.y()){ + _leftSelectedPoint.setX(ed.sampleTemp); + _leftSelectedPoint.setY(ed.dsc); + } + }else{ + if(ed.dsc > _leftSelectedPoint.y()){ + _leftSelectedPoint.setX(ed.sampleTemp); + _leftSelectedPoint.setY(ed.dsc); + } } } if(ed.sampleTemp < _rightSelectedPoint.x() && ed.sampleTemp > _peakPoint.x()){ - if(ed.dsc > _rightSelectedPoint.y()){ - _rightSelectedPoint.setX(ed.sampleTemp); - _rightSelectedPoint.setY(ed.dsc); + if(_leftSelectedPoint.y() < _peakPoint.y()){ + if(ed.dsc < _rightSelectedPoint.y()){ + _rightSelectedPoint.setX(ed.sampleTemp); + _rightSelectedPoint.setY(ed.dsc); + } + }else{ + if(ed.dsc > _rightSelectedPoint.y()){ + _rightSelectedPoint.setX(ed.sampleTemp); + _rightSelectedPoint.setY(ed.dsc); + } } } } } + QString PointCalculate::textFormatPeakPoint(const float enthalpyValue, const float peakValue, const float startPoint, @@ -394,6 +410,7 @@ QPair PointCalculate::getCurveInflectionPointTangent(const float x1 return qMakePair(maxSlope,b); } + QPointF PointCalculate::getIntersection(const Line& line1, const Line& line2) { float x = (line2.intercept - line1.intercept) / (line1.slope - line2.slope); float y = line1.slope * x + line1.intercept; diff --git a/src/mainwindow.ui b/src/mainwindow.ui index 76604d5..7fe8411 100644 --- a/src/mainwindow.ui +++ b/src/mainwindow.ui @@ -71,8 +71,24 @@ 工具 + + + 平滑 + + + + + + + + + + + + + @@ -344,6 +360,56 @@ language + + + 1级 + + + + + 2级 + + + + + 3级 + + + + + 4级 + + + + + 5级 + + + + + 6级 + + + + + 7级 + + + + + 8级 + + + + + 9级 + + + + + 10级 + + diff --git a/src/thirdparty/eigen-3.4.0/Eigen/Cholesky b/src/thirdparty/eigen-3.4.0/Eigen/Cholesky new file mode 100644 index 0000000..a318ceb --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/Cholesky @@ -0,0 +1,45 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CHOLESKY_MODULE_H +#define EIGEN_CHOLESKY_MODULE_H + +#include "Core" +#include "Jacobi" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Cholesky_Module Cholesky module + * + * + * + * This module provides two variants of the Cholesky decomposition for selfadjoint (hermitian) matrices. + * Those decompositions are also accessible via the following methods: + * - MatrixBase::llt() + * - MatrixBase::ldlt() + * - SelfAdjointView::llt() + * - SelfAdjointView::ldlt() + * + * \code + * #include + * \endcode + */ + +#include "src/Cholesky/LLT.h" +#include "src/Cholesky/LDLT.h" +#ifdef EIGEN_USE_LAPACKE +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#include "src/Cholesky/LLT_LAPACKE.h" +#endif + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_CHOLESKY_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/CholmodSupport b/src/thirdparty/eigen-3.4.0/Eigen/CholmodSupport new file mode 100644 index 0000000..bed8924 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/CholmodSupport @@ -0,0 +1,48 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CHOLMODSUPPORT_MODULE_H +#define EIGEN_CHOLMODSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +extern "C" { + #include +} + +/** \ingroup Support_modules + * \defgroup CholmodSupport_Module CholmodSupport module + * + * This module provides an interface to the Cholmod library which is part of the suitesparse package. + * It provides the two following main factorization classes: + * - class CholmodSupernodalLLT: a supernodal LLT Cholesky factorization. + * - class CholmodDecomposiiton: a general L(D)LT Cholesky factorization with automatic or explicit runtime selection of the underlying factorization method (supernodal or simplicial). + * + * For the sake of completeness, this module also propose the two following classes: + * - class CholmodSimplicialLLT + * - class CholmodSimplicialLDLT + * Note that these classes does not bring any particular advantage compared to the built-in + * SimplicialLLT and SimplicialLDLT factorization classes. + * + * \code + * #include + * \endcode + * + * In order to use this module, the cholmod headers must be accessible from the include paths, and your binary must be linked to the cholmod library and its dependencies. + * The dependencies depend on how cholmod has been compiled. + * For a cmake based project, you can use our FindCholmod.cmake module to help you in this task. + * + */ + +#include "src/CholmodSupport/CholmodSupport.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_CHOLMODSUPPORT_MODULE_H + diff --git a/src/thirdparty/eigen-3.4.0/Eigen/Core b/src/thirdparty/eigen-3.4.0/Eigen/Core new file mode 100644 index 0000000..5921e15 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/Core @@ -0,0 +1,384 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2007-2011 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CORE_H +#define EIGEN_CORE_H + +// first thing Eigen does: stop the compiler from reporting useless warnings. +#include "src/Core/util/DisableStupidWarnings.h" + +// then include this file where all our macros are defined. It's really important to do it first because +// it's where we do all the compiler/OS/arch detections and define most defaults. +#include "src/Core/util/Macros.h" + +// This detects SSE/AVX/NEON/etc. and configure alignment settings +#include "src/Core/util/ConfigureVectorization.h" + +// We need cuda_runtime.h/hip_runtime.h to ensure that +// the EIGEN_USING_STD macro works properly on the device side +#if defined(EIGEN_CUDACC) + #include +#elif defined(EIGEN_HIPCC) + #include +#endif + + +#ifdef EIGEN_EXCEPTIONS + #include +#endif + +// Disable the ipa-cp-clone optimization flag with MinGW 6.x or newer (enabled by default with -O3) +// See http://eigen.tuxfamily.org/bz/show_bug.cgi?id=556 for details. +#if EIGEN_COMP_MINGW && EIGEN_GNUC_AT_LEAST(4,6) && EIGEN_GNUC_AT_MOST(5,5) + #pragma GCC optimize ("-fno-ipa-cp-clone") +#endif + +// Prevent ICC from specializing std::complex operators that silently fail +// on device. This allows us to use our own device-compatible specializations +// instead. +#if defined(EIGEN_COMP_ICC) && defined(EIGEN_GPU_COMPILE_PHASE) \ + && !defined(_OVERRIDE_COMPLEX_SPECIALIZATION_) +#define _OVERRIDE_COMPLEX_SPECIALIZATION_ 1 +#endif +#include + +// this include file manages BLAS and MKL related macros +// and inclusion of their respective header files +#include "src/Core/util/MKL_support.h" + + +#if defined(EIGEN_HAS_CUDA_FP16) || defined(EIGEN_HAS_HIP_FP16) + #define EIGEN_HAS_GPU_FP16 +#endif + +#if defined(EIGEN_HAS_CUDA_BF16) || defined(EIGEN_HAS_HIP_BF16) + #define EIGEN_HAS_GPU_BF16 +#endif + +#if (defined _OPENMP) && (!defined EIGEN_DONT_PARALLELIZE) + #define EIGEN_HAS_OPENMP +#endif + +#ifdef EIGEN_HAS_OPENMP +#include +#endif + +// MSVC for windows mobile does not have the errno.h file +#if !(EIGEN_COMP_MSVC && EIGEN_OS_WINCE) && !EIGEN_COMP_ARM +#define EIGEN_HAS_ERRNO +#endif + +#ifdef EIGEN_HAS_ERRNO +#include +#endif +#include +#include +#include +#include +#include +#include +#ifndef EIGEN_NO_IO + #include +#endif +#include +#include +#include +#include // for CHAR_BIT +// for min/max: +#include + +#if EIGEN_HAS_CXX11 +#include +#endif + +// for std::is_nothrow_move_assignable +#ifdef EIGEN_INCLUDE_TYPE_TRAITS +#include +#endif + +// for outputting debug info +#ifdef EIGEN_DEBUG_ASSIGN +#include +#endif + +// required for __cpuid, needs to be included after cmath +#if EIGEN_COMP_MSVC && EIGEN_ARCH_i386_OR_x86_64 && !EIGEN_OS_WINCE + #include +#endif + +#if defined(EIGEN_USE_SYCL) + #undef min + #undef max + #undef isnan + #undef isinf + #undef isfinite + #include + #include + #include + #include + #include + #ifndef EIGEN_SYCL_LOCAL_THREAD_DIM0 + #define EIGEN_SYCL_LOCAL_THREAD_DIM0 16 + #endif + #ifndef EIGEN_SYCL_LOCAL_THREAD_DIM1 + #define EIGEN_SYCL_LOCAL_THREAD_DIM1 16 + #endif +#endif + + +#if defined EIGEN2_SUPPORT_STAGE40_FULL_EIGEN3_STRICTNESS || defined EIGEN2_SUPPORT_STAGE30_FULL_EIGEN3_API || defined EIGEN2_SUPPORT_STAGE20_RESOLVE_API_CONFLICTS || defined EIGEN2_SUPPORT_STAGE10_FULL_EIGEN2_API || defined EIGEN2_SUPPORT +// This will generate an error message: +#error Eigen2-support is only available up to version 3.2. Please go to "http://eigen.tuxfamily.org/index.php?title=Eigen2" for further information +#endif + +namespace Eigen { + +// we use size_t frequently and we'll never remember to prepend it with std:: every time just to +// ensure QNX/QCC support +using std::size_t; +// gcc 4.6.0 wants std:: for ptrdiff_t +using std::ptrdiff_t; + +} + +/** \defgroup Core_Module Core module + * This is the main module of Eigen providing dense matrix and vector support + * (both fixed and dynamic size) with all the features corresponding to a BLAS library + * and much more... + * + * \code + * #include + * \endcode + */ + +#include "src/Core/util/Constants.h" +#include "src/Core/util/Meta.h" +#include "src/Core/util/ForwardDeclarations.h" +#include "src/Core/util/StaticAssert.h" +#include "src/Core/util/XprHelper.h" +#include "src/Core/util/Memory.h" +#include "src/Core/util/IntegralConstant.h" +#include "src/Core/util/SymbolicIndex.h" + +#include "src/Core/NumTraits.h" +#include "src/Core/MathFunctions.h" +#include "src/Core/GenericPacketMath.h" +#include "src/Core/MathFunctionsImpl.h" +#include "src/Core/arch/Default/ConjHelper.h" +// Generic half float support +#include "src/Core/arch/Default/Half.h" +#include "src/Core/arch/Default/BFloat16.h" +#include "src/Core/arch/Default/TypeCasting.h" +#include "src/Core/arch/Default/GenericPacketMathFunctionsFwd.h" + +#if defined EIGEN_VECTORIZE_AVX512 + #include "src/Core/arch/SSE/PacketMath.h" + #include "src/Core/arch/SSE/TypeCasting.h" + #include "src/Core/arch/SSE/Complex.h" + #include "src/Core/arch/AVX/PacketMath.h" + #include "src/Core/arch/AVX/TypeCasting.h" + #include "src/Core/arch/AVX/Complex.h" + #include "src/Core/arch/AVX512/PacketMath.h" + #include "src/Core/arch/AVX512/TypeCasting.h" + #include "src/Core/arch/AVX512/Complex.h" + #include "src/Core/arch/SSE/MathFunctions.h" + #include "src/Core/arch/AVX/MathFunctions.h" + #include "src/Core/arch/AVX512/MathFunctions.h" +#elif defined EIGEN_VECTORIZE_AVX + // Use AVX for floats and doubles, SSE for integers + #include "src/Core/arch/SSE/PacketMath.h" + #include "src/Core/arch/SSE/TypeCasting.h" + #include "src/Core/arch/SSE/Complex.h" + #include "src/Core/arch/AVX/PacketMath.h" + #include "src/Core/arch/AVX/TypeCasting.h" + #include "src/Core/arch/AVX/Complex.h" + #include "src/Core/arch/SSE/MathFunctions.h" + #include "src/Core/arch/AVX/MathFunctions.h" +#elif defined EIGEN_VECTORIZE_SSE + #include "src/Core/arch/SSE/PacketMath.h" + #include "src/Core/arch/SSE/TypeCasting.h" + #include "src/Core/arch/SSE/MathFunctions.h" + #include "src/Core/arch/SSE/Complex.h" +#elif defined(EIGEN_VECTORIZE_ALTIVEC) || defined(EIGEN_VECTORIZE_VSX) + #include "src/Core/arch/AltiVec/PacketMath.h" + #include "src/Core/arch/AltiVec/MathFunctions.h" + #include "src/Core/arch/AltiVec/Complex.h" +#elif defined EIGEN_VECTORIZE_NEON + #include "src/Core/arch/NEON/PacketMath.h" + #include "src/Core/arch/NEON/TypeCasting.h" + #include "src/Core/arch/NEON/MathFunctions.h" + #include "src/Core/arch/NEON/Complex.h" +#elif defined EIGEN_VECTORIZE_SVE + #include "src/Core/arch/SVE/PacketMath.h" + #include "src/Core/arch/SVE/TypeCasting.h" + #include "src/Core/arch/SVE/MathFunctions.h" +#elif defined EIGEN_VECTORIZE_ZVECTOR + #include "src/Core/arch/ZVector/PacketMath.h" + #include "src/Core/arch/ZVector/MathFunctions.h" + #include "src/Core/arch/ZVector/Complex.h" +#elif defined EIGEN_VECTORIZE_MSA + #include "src/Core/arch/MSA/PacketMath.h" + #include "src/Core/arch/MSA/MathFunctions.h" + #include "src/Core/arch/MSA/Complex.h" +#endif + +#if defined EIGEN_VECTORIZE_GPU + #include "src/Core/arch/GPU/PacketMath.h" + #include "src/Core/arch/GPU/MathFunctions.h" + #include "src/Core/arch/GPU/TypeCasting.h" +#endif + +#if defined(EIGEN_USE_SYCL) + #include "src/Core/arch/SYCL/SyclMemoryModel.h" + #include "src/Core/arch/SYCL/InteropHeaders.h" +#if !defined(EIGEN_DONT_VECTORIZE_SYCL) + #include "src/Core/arch/SYCL/PacketMath.h" + #include "src/Core/arch/SYCL/MathFunctions.h" + #include "src/Core/arch/SYCL/TypeCasting.h" +#endif +#endif + +#include "src/Core/arch/Default/Settings.h" +// This file provides generic implementations valid for scalar as well +#include "src/Core/arch/Default/GenericPacketMathFunctions.h" + +#include "src/Core/functors/TernaryFunctors.h" +#include "src/Core/functors/BinaryFunctors.h" +#include "src/Core/functors/UnaryFunctors.h" +#include "src/Core/functors/NullaryFunctors.h" +#include "src/Core/functors/StlFunctors.h" +#include "src/Core/functors/AssignmentFunctors.h" + +// Specialized functors to enable the processing of complex numbers +// on CUDA devices +#ifdef EIGEN_CUDACC +#include "src/Core/arch/CUDA/Complex.h" +#endif + +#include "src/Core/util/IndexedViewHelper.h" +#include "src/Core/util/ReshapedHelper.h" +#include "src/Core/ArithmeticSequence.h" +#ifndef EIGEN_NO_IO + #include "src/Core/IO.h" +#endif +#include "src/Core/DenseCoeffsBase.h" +#include "src/Core/DenseBase.h" +#include "src/Core/MatrixBase.h" +#include "src/Core/EigenBase.h" + +#include "src/Core/Product.h" +#include "src/Core/CoreEvaluators.h" +#include "src/Core/AssignEvaluator.h" + +#ifndef EIGEN_PARSED_BY_DOXYGEN // work around Doxygen bug triggered by Assign.h r814874 + // at least confirmed with Doxygen 1.5.5 and 1.5.6 + #include "src/Core/Assign.h" +#endif + +#include "src/Core/ArrayBase.h" +#include "src/Core/util/BlasUtil.h" +#include "src/Core/DenseStorage.h" +#include "src/Core/NestByValue.h" + +// #include "src/Core/ForceAlignedAccess.h" + +#include "src/Core/ReturnByValue.h" +#include "src/Core/NoAlias.h" +#include "src/Core/PlainObjectBase.h" +#include "src/Core/Matrix.h" +#include "src/Core/Array.h" +#include "src/Core/CwiseTernaryOp.h" +#include "src/Core/CwiseBinaryOp.h" +#include "src/Core/CwiseUnaryOp.h" +#include "src/Core/CwiseNullaryOp.h" +#include "src/Core/CwiseUnaryView.h" +#include "src/Core/SelfCwiseBinaryOp.h" +#include "src/Core/Dot.h" +#include "src/Core/StableNorm.h" +#include "src/Core/Stride.h" +#include "src/Core/MapBase.h" +#include "src/Core/Map.h" +#include "src/Core/Ref.h" +#include "src/Core/Block.h" +#include "src/Core/VectorBlock.h" +#include "src/Core/IndexedView.h" +#include "src/Core/Reshaped.h" +#include "src/Core/Transpose.h" +#include "src/Core/DiagonalMatrix.h" +#include "src/Core/Diagonal.h" +#include "src/Core/DiagonalProduct.h" +#include "src/Core/Redux.h" +#include "src/Core/Visitor.h" +#include "src/Core/Fuzzy.h" +#include "src/Core/Swap.h" +#include "src/Core/CommaInitializer.h" +#include "src/Core/GeneralProduct.h" +#include "src/Core/Solve.h" +#include "src/Core/Inverse.h" +#include "src/Core/SolverBase.h" +#include "src/Core/PermutationMatrix.h" +#include "src/Core/Transpositions.h" +#include "src/Core/TriangularMatrix.h" +#include "src/Core/SelfAdjointView.h" +#include "src/Core/products/GeneralBlockPanelKernel.h" +#include "src/Core/products/Parallelizer.h" +#include "src/Core/ProductEvaluators.h" +#include "src/Core/products/GeneralMatrixVector.h" +#include "src/Core/products/GeneralMatrixMatrix.h" +#include "src/Core/SolveTriangular.h" +#include "src/Core/products/GeneralMatrixMatrixTriangular.h" +#include "src/Core/products/SelfadjointMatrixVector.h" +#include "src/Core/products/SelfadjointMatrixMatrix.h" +#include "src/Core/products/SelfadjointProduct.h" +#include "src/Core/products/SelfadjointRank2Update.h" +#include "src/Core/products/TriangularMatrixVector.h" +#include "src/Core/products/TriangularMatrixMatrix.h" +#include "src/Core/products/TriangularSolverMatrix.h" +#include "src/Core/products/TriangularSolverVector.h" +#include "src/Core/BandMatrix.h" +#include "src/Core/CoreIterators.h" +#include "src/Core/ConditionEstimator.h" + +#if defined(EIGEN_VECTORIZE_ALTIVEC) || defined(EIGEN_VECTORIZE_VSX) + #include "src/Core/arch/AltiVec/MatrixProduct.h" +#elif defined EIGEN_VECTORIZE_NEON + #include "src/Core/arch/NEON/GeneralBlockPanelKernel.h" +#endif + +#include "src/Core/BooleanRedux.h" +#include "src/Core/Select.h" +#include "src/Core/VectorwiseOp.h" +#include "src/Core/PartialReduxEvaluator.h" +#include "src/Core/Random.h" +#include "src/Core/Replicate.h" +#include "src/Core/Reverse.h" +#include "src/Core/ArrayWrapper.h" +#include "src/Core/StlIterators.h" + +#ifdef EIGEN_USE_BLAS +#include "src/Core/products/GeneralMatrixMatrix_BLAS.h" +#include "src/Core/products/GeneralMatrixVector_BLAS.h" +#include "src/Core/products/GeneralMatrixMatrixTriangular_BLAS.h" +#include "src/Core/products/SelfadjointMatrixMatrix_BLAS.h" +#include "src/Core/products/SelfadjointMatrixVector_BLAS.h" +#include "src/Core/products/TriangularMatrixMatrix_BLAS.h" +#include "src/Core/products/TriangularMatrixVector_BLAS.h" +#include "src/Core/products/TriangularSolverMatrix_BLAS.h" +#endif // EIGEN_USE_BLAS + +#ifdef EIGEN_USE_MKL_VML +#include "src/Core/Assign_MKL.h" +#endif + +#include "src/Core/GlobalFunctions.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_CORE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/Dense b/src/thirdparty/eigen-3.4.0/Eigen/Dense new file mode 100644 index 0000000..5768910 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/Dense @@ -0,0 +1,7 @@ +#include "Core" +#include "LU" +#include "Cholesky" +#include "QR" +#include "SVD" +#include "Geometry" +#include "Eigenvalues" diff --git a/src/thirdparty/eigen-3.4.0/Eigen/Eigen b/src/thirdparty/eigen-3.4.0/Eigen/Eigen new file mode 100644 index 0000000..654c8dc --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/Eigen @@ -0,0 +1,2 @@ +#include "Dense" +#include "Sparse" diff --git a/src/thirdparty/eigen-3.4.0/Eigen/Eigenvalues b/src/thirdparty/eigen-3.4.0/Eigen/Eigenvalues new file mode 100644 index 0000000..5467a2e --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/Eigenvalues @@ -0,0 +1,60 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_EIGENVALUES_MODULE_H +#define EIGEN_EIGENVALUES_MODULE_H + +#include "Core" + +#include "Cholesky" +#include "Jacobi" +#include "Householder" +#include "LU" +#include "Geometry" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Eigenvalues_Module Eigenvalues module + * + * + * + * This module mainly provides various eigenvalue solvers. + * This module also provides some MatrixBase methods, including: + * - MatrixBase::eigenvalues(), + * - MatrixBase::operatorNorm() + * + * \code + * #include + * \endcode + */ + +#include "src/misc/RealSvd2x2.h" +#include "src/Eigenvalues/Tridiagonalization.h" +#include "src/Eigenvalues/RealSchur.h" +#include "src/Eigenvalues/EigenSolver.h" +#include "src/Eigenvalues/SelfAdjointEigenSolver.h" +#include "src/Eigenvalues/GeneralizedSelfAdjointEigenSolver.h" +#include "src/Eigenvalues/HessenbergDecomposition.h" +#include "src/Eigenvalues/ComplexSchur.h" +#include "src/Eigenvalues/ComplexEigenSolver.h" +#include "src/Eigenvalues/RealQZ.h" +#include "src/Eigenvalues/GeneralizedEigenSolver.h" +#include "src/Eigenvalues/MatrixBaseEigenvalues.h" +#ifdef EIGEN_USE_LAPACKE +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#include "src/Eigenvalues/RealSchur_LAPACKE.h" +#include "src/Eigenvalues/ComplexSchur_LAPACKE.h" +#include "src/Eigenvalues/SelfAdjointEigenSolver_LAPACKE.h" +#endif + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_EIGENVALUES_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/Geometry b/src/thirdparty/eigen-3.4.0/Eigen/Geometry new file mode 100644 index 0000000..bc78110 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/Geometry @@ -0,0 +1,59 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_GEOMETRY_MODULE_H +#define EIGEN_GEOMETRY_MODULE_H + +#include "Core" + +#include "SVD" +#include "LU" +#include + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Geometry_Module Geometry module + * + * This module provides support for: + * - fixed-size homogeneous transformations + * - translation, scaling, 2D and 3D rotations + * - \link Quaternion quaternions \endlink + * - cross products (\ref MatrixBase::cross, \ref MatrixBase::cross3) + * - orthognal vector generation (\ref MatrixBase::unitOrthogonal) + * - some linear components: \link ParametrizedLine parametrized-lines \endlink and \link Hyperplane hyperplanes \endlink + * - \link AlignedBox axis aligned bounding boxes \endlink + * - \link umeyama least-square transformation fitting \endlink + * + * \code + * #include + * \endcode + */ + +#include "src/Geometry/OrthoMethods.h" +#include "src/Geometry/EulerAngles.h" + +#include "src/Geometry/Homogeneous.h" +#include "src/Geometry/RotationBase.h" +#include "src/Geometry/Rotation2D.h" +#include "src/Geometry/Quaternion.h" +#include "src/Geometry/AngleAxis.h" +#include "src/Geometry/Transform.h" +#include "src/Geometry/Translation.h" +#include "src/Geometry/Scaling.h" +#include "src/Geometry/Hyperplane.h" +#include "src/Geometry/ParametrizedLine.h" +#include "src/Geometry/AlignedBox.h" +#include "src/Geometry/Umeyama.h" + +// Use the SSE optimized version whenever possible. +#if (defined EIGEN_VECTORIZE_SSE) || (defined EIGEN_VECTORIZE_NEON) +#include "src/Geometry/arch/Geometry_SIMD.h" +#endif + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_GEOMETRY_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/Householder b/src/thirdparty/eigen-3.4.0/Eigen/Householder new file mode 100644 index 0000000..f2fa799 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/Householder @@ -0,0 +1,29 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_HOUSEHOLDER_MODULE_H +#define EIGEN_HOUSEHOLDER_MODULE_H + +#include "Core" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Householder_Module Householder module + * This module provides Householder transformations. + * + * \code + * #include + * \endcode + */ + +#include "src/Householder/Householder.h" +#include "src/Householder/HouseholderSequence.h" +#include "src/Householder/BlockHouseholder.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_HOUSEHOLDER_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/IterativeLinearSolvers b/src/thirdparty/eigen-3.4.0/Eigen/IterativeLinearSolvers new file mode 100644 index 0000000..957d575 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/IterativeLinearSolvers @@ -0,0 +1,48 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ITERATIVELINEARSOLVERS_MODULE_H +#define EIGEN_ITERATIVELINEARSOLVERS_MODULE_H + +#include "SparseCore" +#include "OrderingMethods" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** + * \defgroup IterativeLinearSolvers_Module IterativeLinearSolvers module + * + * This module currently provides iterative methods to solve problems of the form \c A \c x = \c b, where \c A is a squared matrix, usually very large and sparse. + * Those solvers are accessible via the following classes: + * - ConjugateGradient for selfadjoint (hermitian) matrices, + * - LeastSquaresConjugateGradient for rectangular least-square problems, + * - BiCGSTAB for general square matrices. + * + * These iterative solvers are associated with some preconditioners: + * - IdentityPreconditioner - not really useful + * - DiagonalPreconditioner - also called Jacobi preconditioner, work very well on diagonal dominant matrices. + * - IncompleteLUT - incomplete LU factorization with dual thresholding + * + * Such problems can also be solved using the direct sparse decomposition modules: SparseCholesky, CholmodSupport, UmfPackSupport, SuperLUSupport. + * + \code + #include + \endcode + */ + +#include "src/IterativeLinearSolvers/SolveWithGuess.h" +#include "src/IterativeLinearSolvers/IterativeSolverBase.h" +#include "src/IterativeLinearSolvers/BasicPreconditioners.h" +#include "src/IterativeLinearSolvers/ConjugateGradient.h" +#include "src/IterativeLinearSolvers/LeastSquareConjugateGradient.h" +#include "src/IterativeLinearSolvers/BiCGSTAB.h" +#include "src/IterativeLinearSolvers/IncompleteLUT.h" +#include "src/IterativeLinearSolvers/IncompleteCholesky.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_ITERATIVELINEARSOLVERS_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/Jacobi b/src/thirdparty/eigen-3.4.0/Eigen/Jacobi new file mode 100644 index 0000000..43edc7a --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/Jacobi @@ -0,0 +1,32 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_JACOBI_MODULE_H +#define EIGEN_JACOBI_MODULE_H + +#include "Core" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Jacobi_Module Jacobi module + * This module provides Jacobi and Givens rotations. + * + * \code + * #include + * \endcode + * + * In addition to listed classes, it defines the two following MatrixBase methods to apply a Jacobi or Givens rotation: + * - MatrixBase::applyOnTheLeft() + * - MatrixBase::applyOnTheRight(). + */ + +#include "src/Jacobi/Jacobi.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_JACOBI_MODULE_H + diff --git a/src/thirdparty/eigen-3.4.0/Eigen/KLUSupport b/src/thirdparty/eigen-3.4.0/Eigen/KLUSupport new file mode 100644 index 0000000..b23d905 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/KLUSupport @@ -0,0 +1,41 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_KLUSUPPORT_MODULE_H +#define EIGEN_KLUSUPPORT_MODULE_H + +#include + +#include + +extern "C" { +#include +#include + } + +/** \ingroup Support_modules + * \defgroup KLUSupport_Module KLUSupport module + * + * This module provides an interface to the KLU library which is part of the suitesparse package. + * It provides the following factorization class: + * - class KLU: a sparse LU factorization, well-suited for circuit simulation. + * + * \code + * #include + * \endcode + * + * In order to use this module, the klu and btf headers must be accessible from the include paths, and your binary must be linked to the klu library and its dependencies. + * The dependencies depend on how umfpack has been compiled. + * For a cmake based project, you can use our FindKLU.cmake module to help you in this task. + * + */ + +#include "src/KLUSupport/KLUSupport.h" + +#include + +#endif // EIGEN_KLUSUPPORT_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/LU b/src/thirdparty/eigen-3.4.0/Eigen/LU new file mode 100644 index 0000000..1236ceb --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/LU @@ -0,0 +1,47 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_LU_MODULE_H +#define EIGEN_LU_MODULE_H + +#include "Core" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup LU_Module LU module + * This module includes %LU decomposition and related notions such as matrix inversion and determinant. + * This module defines the following MatrixBase methods: + * - MatrixBase::inverse() + * - MatrixBase::determinant() + * + * \code + * #include + * \endcode + */ + +#include "src/misc/Kernel.h" +#include "src/misc/Image.h" +#include "src/LU/FullPivLU.h" +#include "src/LU/PartialPivLU.h" +#ifdef EIGEN_USE_LAPACKE +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#include "src/LU/PartialPivLU_LAPACKE.h" +#endif +#include "src/LU/Determinant.h" +#include "src/LU/InverseImpl.h" + +#if defined EIGEN_VECTORIZE_SSE || defined EIGEN_VECTORIZE_NEON + #include "src/LU/arch/InverseSize4.h" +#endif + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_LU_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/MetisSupport b/src/thirdparty/eigen-3.4.0/Eigen/MetisSupport new file mode 100644 index 0000000..85c41bf --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/MetisSupport @@ -0,0 +1,35 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_METISSUPPORT_MODULE_H +#define EIGEN_METISSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +extern "C" { +#include +} + + +/** \ingroup Support_modules + * \defgroup MetisSupport_Module MetisSupport module + * + * \code + * #include + * \endcode + * This module defines an interface to the METIS reordering package (http://glaros.dtc.umn.edu/gkhome/views/metis). + * It can be used just as any other built-in method as explained in \link OrderingMethods_Module here. \endlink + */ + + +#include "src/MetisSupport/MetisSupport.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_METISSUPPORT_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/OrderingMethods b/src/thirdparty/eigen-3.4.0/Eigen/OrderingMethods new file mode 100644 index 0000000..29691a6 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/OrderingMethods @@ -0,0 +1,70 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ORDERINGMETHODS_MODULE_H +#define EIGEN_ORDERINGMETHODS_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** + * \defgroup OrderingMethods_Module OrderingMethods module + * + * This module is currently for internal use only + * + * It defines various built-in and external ordering methods for sparse matrices. + * They are typically used to reduce the number of elements during + * the sparse matrix decomposition (LLT, LU, QR). + * Precisely, in a preprocessing step, a permutation matrix P is computed using + * those ordering methods and applied to the columns of the matrix. + * Using for instance the sparse Cholesky decomposition, it is expected that + * the nonzeros elements in LLT(A*P) will be much smaller than that in LLT(A). + * + * + * Usage : + * \code + * #include + * \endcode + * + * A simple usage is as a template parameter in the sparse decomposition classes : + * + * \code + * SparseLU > solver; + * \endcode + * + * \code + * SparseQR > solver; + * \endcode + * + * It is possible as well to call directly a particular ordering method for your own purpose, + * \code + * AMDOrdering ordering; + * PermutationMatrix perm; + * SparseMatrix A; + * //Fill the matrix ... + * + * ordering(A, perm); // Call AMD + * \endcode + * + * \note Some of these methods (like AMD or METIS), need the sparsity pattern + * of the input matrix to be symmetric. When the matrix is structurally unsymmetric, + * Eigen computes internally the pattern of \f$A^T*A\f$ before calling the method. + * If your matrix is already symmetric (at leat in structure), you can avoid that + * by calling the method with a SelfAdjointView type. + * + * \code + * // Call the ordering on the pattern of the lower triangular matrix A + * ordering(A.selfadjointView(), perm); + * \endcode + */ + +#include "src/OrderingMethods/Amd.h" +#include "src/OrderingMethods/Ordering.h" +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_ORDERINGMETHODS_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/PaStiXSupport b/src/thirdparty/eigen-3.4.0/Eigen/PaStiXSupport new file mode 100644 index 0000000..234619a --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/PaStiXSupport @@ -0,0 +1,49 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PASTIXSUPPORT_MODULE_H +#define EIGEN_PASTIXSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +extern "C" { +#include +#include +} + +#ifdef complex +#undef complex +#endif + +/** \ingroup Support_modules + * \defgroup PaStiXSupport_Module PaStiXSupport module + * + * This module provides an interface to the PaSTiX library. + * PaSTiX is a general \b supernodal, \b parallel and \b opensource sparse solver. + * It provides the two following main factorization classes: + * - class PastixLLT : a supernodal, parallel LLt Cholesky factorization. + * - class PastixLDLT: a supernodal, parallel LDLt Cholesky factorization. + * - class PastixLU : a supernodal, parallel LU factorization (optimized for a symmetric pattern). + * + * \code + * #include + * \endcode + * + * In order to use this module, the PaSTiX headers must be accessible from the include paths, and your binary must be linked to the PaSTiX library and its dependencies. + * This wrapper resuires PaStiX version 5.x compiled without MPI support. + * The dependencies depend on how PaSTiX has been compiled. + * For a cmake based project, you can use our FindPaSTiX.cmake module to help you in this task. + * + */ + +#include "src/PaStiXSupport/PaStiXSupport.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_PASTIXSUPPORT_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/PardisoSupport b/src/thirdparty/eigen-3.4.0/Eigen/PardisoSupport new file mode 100644 index 0000000..340edf5 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/PardisoSupport @@ -0,0 +1,35 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PARDISOSUPPORT_MODULE_H +#define EIGEN_PARDISOSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +#include + +/** \ingroup Support_modules + * \defgroup PardisoSupport_Module PardisoSupport module + * + * This module brings support for the Intel(R) MKL PARDISO direct sparse solvers. + * + * \code + * #include + * \endcode + * + * In order to use this module, the MKL headers must be accessible from the include paths, and your binary must be linked to the MKL library and its dependencies. + * See this \ref TopicUsingIntelMKL "page" for more information on MKL-Eigen integration. + * + */ + +#include "src/PardisoSupport/PardisoSupport.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_PARDISOSUPPORT_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/QR b/src/thirdparty/eigen-3.4.0/Eigen/QR new file mode 100644 index 0000000..8465b62 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/QR @@ -0,0 +1,50 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_QR_MODULE_H +#define EIGEN_QR_MODULE_H + +#include "Core" + +#include "Cholesky" +#include "Jacobi" +#include "Householder" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup QR_Module QR module + * + * + * + * This module provides various QR decompositions + * This module also provides some MatrixBase methods, including: + * - MatrixBase::householderQr() + * - MatrixBase::colPivHouseholderQr() + * - MatrixBase::fullPivHouseholderQr() + * + * \code + * #include + * \endcode + */ + +#include "src/QR/HouseholderQR.h" +#include "src/QR/FullPivHouseholderQR.h" +#include "src/QR/ColPivHouseholderQR.h" +#include "src/QR/CompleteOrthogonalDecomposition.h" +#ifdef EIGEN_USE_LAPACKE +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#include "src/QR/HouseholderQR_LAPACKE.h" +#include "src/QR/ColPivHouseholderQR_LAPACKE.h" +#endif + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_QR_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/QtAlignedMalloc b/src/thirdparty/eigen-3.4.0/Eigen/QtAlignedMalloc new file mode 100644 index 0000000..6fe8237 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/QtAlignedMalloc @@ -0,0 +1,39 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_QTMALLOC_MODULE_H +#define EIGEN_QTMALLOC_MODULE_H + +#include "Core" + +#if (!EIGEN_MALLOC_ALREADY_ALIGNED) + +#include "src/Core/util/DisableStupidWarnings.h" + +void *qMalloc(std::size_t size) +{ + return Eigen::internal::aligned_malloc(size); +} + +void qFree(void *ptr) +{ + Eigen::internal::aligned_free(ptr); +} + +void *qRealloc(void *ptr, std::size_t size) +{ + void* newPtr = Eigen::internal::aligned_malloc(size); + std::memcpy(newPtr, ptr, size); + Eigen::internal::aligned_free(ptr); + return newPtr; +} + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif + +#endif // EIGEN_QTMALLOC_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/SPQRSupport b/src/thirdparty/eigen-3.4.0/Eigen/SPQRSupport new file mode 100644 index 0000000..f70390c --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/SPQRSupport @@ -0,0 +1,34 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SPQRSUPPORT_MODULE_H +#define EIGEN_SPQRSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +#include "SuiteSparseQR.hpp" + +/** \ingroup Support_modules + * \defgroup SPQRSupport_Module SuiteSparseQR module + * + * This module provides an interface to the SPQR library, which is part of the suitesparse package. + * + * \code + * #include + * \endcode + * + * In order to use this module, the SPQR headers must be accessible from the include paths, and your binary must be linked to the SPQR library and its dependencies (Cholmod, AMD, COLAMD,...). + * For a cmake based project, you can use our FindSPQR.cmake and FindCholmod.Cmake modules + * + */ + +#include "src/CholmodSupport/CholmodSupport.h" +#include "src/SPQRSupport/SuiteSparseQRSupport.h" + +#endif diff --git a/src/thirdparty/eigen-3.4.0/Eigen/SVD b/src/thirdparty/eigen-3.4.0/Eigen/SVD new file mode 100644 index 0000000..3451794 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/SVD @@ -0,0 +1,50 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SVD_MODULE_H +#define EIGEN_SVD_MODULE_H + +#include "QR" +#include "Householder" +#include "Jacobi" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup SVD_Module SVD module + * + * + * + * This module provides SVD decomposition for matrices (both real and complex). + * Two decomposition algorithms are provided: + * - JacobiSVD implementing two-sided Jacobi iterations is numerically very accurate, fast for small matrices, but very slow for larger ones. + * - BDCSVD implementing a recursive divide & conquer strategy on top of an upper-bidiagonalization which remains fast for large problems. + * These decompositions are accessible via the respective classes and following MatrixBase methods: + * - MatrixBase::jacobiSvd() + * - MatrixBase::bdcSvd() + * + * \code + * #include + * \endcode + */ + +#include "src/misc/RealSvd2x2.h" +#include "src/SVD/UpperBidiagonalization.h" +#include "src/SVD/SVDBase.h" +#include "src/SVD/JacobiSVD.h" +#include "src/SVD/BDCSVD.h" +#if defined(EIGEN_USE_LAPACKE) && !defined(EIGEN_USE_LAPACKE_STRICT) +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#include "src/SVD/JacobiSVD_LAPACKE.h" +#endif + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_SVD_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/Sparse b/src/thirdparty/eigen-3.4.0/Eigen/Sparse new file mode 100644 index 0000000..a2ef7a6 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/Sparse @@ -0,0 +1,34 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SPARSE_MODULE_H +#define EIGEN_SPARSE_MODULE_H + +/** \defgroup Sparse_Module Sparse meta-module + * + * Meta-module including all related modules: + * - \ref SparseCore_Module + * - \ref OrderingMethods_Module + * - \ref SparseCholesky_Module + * - \ref SparseLU_Module + * - \ref SparseQR_Module + * - \ref IterativeLinearSolvers_Module + * + \code + #include + \endcode + */ + +#include "SparseCore" +#include "OrderingMethods" +#include "SparseCholesky" +#include "SparseLU" +#include "SparseQR" +#include "IterativeLinearSolvers" + +#endif // EIGEN_SPARSE_MODULE_H + diff --git a/src/thirdparty/eigen-3.4.0/Eigen/SparseCholesky b/src/thirdparty/eigen-3.4.0/Eigen/SparseCholesky new file mode 100644 index 0000000..d2b1f12 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/SparseCholesky @@ -0,0 +1,37 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2013 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SPARSECHOLESKY_MODULE_H +#define EIGEN_SPARSECHOLESKY_MODULE_H + +#include "SparseCore" +#include "OrderingMethods" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** + * \defgroup SparseCholesky_Module SparseCholesky module + * + * This module currently provides two variants of the direct sparse Cholesky decomposition for selfadjoint (hermitian) matrices. + * Those decompositions are accessible via the following classes: + * - SimplicialLLt, + * - SimplicialLDLt + * + * Such problems can also be solved using the ConjugateGradient solver from the IterativeLinearSolvers module. + * + * \code + * #include + * \endcode + */ + +#include "src/SparseCholesky/SimplicialCholesky.h" +#include "src/SparseCholesky/SimplicialCholesky_impl.h" +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_SPARSECHOLESKY_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/SparseCore b/src/thirdparty/eigen-3.4.0/Eigen/SparseCore new file mode 100644 index 0000000..76966c4 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/SparseCore @@ -0,0 +1,69 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SPARSECORE_MODULE_H +#define EIGEN_SPARSECORE_MODULE_H + +#include "Core" + +#include "src/Core/util/DisableStupidWarnings.h" + +#include +#include +#include +#include +#include + +/** + * \defgroup SparseCore_Module SparseCore module + * + * This module provides a sparse matrix representation, and basic associated matrix manipulations + * and operations. + * + * See the \ref TutorialSparse "Sparse tutorial" + * + * \code + * #include + * \endcode + * + * This module depends on: Core. + */ + +#include "src/SparseCore/SparseUtil.h" +#include "src/SparseCore/SparseMatrixBase.h" +#include "src/SparseCore/SparseAssign.h" +#include "src/SparseCore/CompressedStorage.h" +#include "src/SparseCore/AmbiVector.h" +#include "src/SparseCore/SparseCompressedBase.h" +#include "src/SparseCore/SparseMatrix.h" +#include "src/SparseCore/SparseMap.h" +#include "src/SparseCore/MappedSparseMatrix.h" +#include "src/SparseCore/SparseVector.h" +#include "src/SparseCore/SparseRef.h" +#include "src/SparseCore/SparseCwiseUnaryOp.h" +#include "src/SparseCore/SparseCwiseBinaryOp.h" +#include "src/SparseCore/SparseTranspose.h" +#include "src/SparseCore/SparseBlock.h" +#include "src/SparseCore/SparseDot.h" +#include "src/SparseCore/SparseRedux.h" +#include "src/SparseCore/SparseView.h" +#include "src/SparseCore/SparseDiagonalProduct.h" +#include "src/SparseCore/ConservativeSparseSparseProduct.h" +#include "src/SparseCore/SparseSparseProductWithPruning.h" +#include "src/SparseCore/SparseProduct.h" +#include "src/SparseCore/SparseDenseProduct.h" +#include "src/SparseCore/SparseSelfAdjointView.h" +#include "src/SparseCore/SparseTriangularView.h" +#include "src/SparseCore/TriangularSolver.h" +#include "src/SparseCore/SparsePermutation.h" +#include "src/SparseCore/SparseFuzzy.h" +#include "src/SparseCore/SparseSolverBase.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_SPARSECORE_MODULE_H + diff --git a/src/thirdparty/eigen-3.4.0/Eigen/SparseLU b/src/thirdparty/eigen-3.4.0/Eigen/SparseLU new file mode 100644 index 0000000..37c4a5c --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/SparseLU @@ -0,0 +1,50 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2012 Désiré Nuentsa-Wakam +// Copyright (C) 2012 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SPARSELU_MODULE_H +#define EIGEN_SPARSELU_MODULE_H + +#include "SparseCore" + +/** + * \defgroup SparseLU_Module SparseLU module + * This module defines a supernodal factorization of general sparse matrices. + * The code is fully optimized for supernode-panel updates with specialized kernels. + * Please, see the documentation of the SparseLU class for more details. + */ + +// Ordering interface +#include "OrderingMethods" + +#include "src/Core/util/DisableStupidWarnings.h" + +#include "src/SparseLU/SparseLU_gemm_kernel.h" + +#include "src/SparseLU/SparseLU_Structs.h" +#include "src/SparseLU/SparseLU_SupernodalMatrix.h" +#include "src/SparseLU/SparseLUImpl.h" +#include "src/SparseCore/SparseColEtree.h" +#include "src/SparseLU/SparseLU_Memory.h" +#include "src/SparseLU/SparseLU_heap_relax_snode.h" +#include "src/SparseLU/SparseLU_relax_snode.h" +#include "src/SparseLU/SparseLU_pivotL.h" +#include "src/SparseLU/SparseLU_panel_dfs.h" +#include "src/SparseLU/SparseLU_kernel_bmod.h" +#include "src/SparseLU/SparseLU_panel_bmod.h" +#include "src/SparseLU/SparseLU_column_dfs.h" +#include "src/SparseLU/SparseLU_column_bmod.h" +#include "src/SparseLU/SparseLU_copy_to_ucol.h" +#include "src/SparseLU/SparseLU_pruneL.h" +#include "src/SparseLU/SparseLU_Utils.h" +#include "src/SparseLU/SparseLU.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_SPARSELU_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/SparseQR b/src/thirdparty/eigen-3.4.0/Eigen/SparseQR new file mode 100644 index 0000000..f5fc5fa --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/SparseQR @@ -0,0 +1,36 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SPARSEQR_MODULE_H +#define EIGEN_SPARSEQR_MODULE_H + +#include "SparseCore" +#include "OrderingMethods" +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup SparseQR_Module SparseQR module + * \brief Provides QR decomposition for sparse matrices + * + * This module provides a simplicial version of the left-looking Sparse QR decomposition. + * The columns of the input matrix should be reordered to limit the fill-in during the + * decomposition. Built-in methods (COLAMD, AMD) or external methods (METIS) can be used to this end. + * See the \link OrderingMethods_Module OrderingMethods\endlink module for the list + * of built-in and external ordering methods. + * + * \code + * #include + * \endcode + * + * + */ + +#include "src/SparseCore/SparseColEtree.h" +#include "src/SparseQR/SparseQR.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif diff --git a/src/thirdparty/eigen-3.4.0/Eigen/StdDeque b/src/thirdparty/eigen-3.4.0/Eigen/StdDeque new file mode 100644 index 0000000..bc68397 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/StdDeque @@ -0,0 +1,27 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// Copyright (C) 2009 Hauke Heibel +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_STDDEQUE_MODULE_H +#define EIGEN_STDDEQUE_MODULE_H + +#include "Core" +#include + +#if EIGEN_COMP_MSVC && EIGEN_OS_WIN64 && (EIGEN_MAX_STATIC_ALIGN_BYTES<=16) /* MSVC auto aligns up to 16 bytes in 64 bit builds */ + +#define EIGEN_DEFINE_STL_DEQUE_SPECIALIZATION(...) + +#else + +#include "src/StlSupport/StdDeque.h" + +#endif + +#endif // EIGEN_STDDEQUE_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/StdList b/src/thirdparty/eigen-3.4.0/Eigen/StdList new file mode 100644 index 0000000..4c6262c --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/StdList @@ -0,0 +1,26 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Hauke Heibel +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_STDLIST_MODULE_H +#define EIGEN_STDLIST_MODULE_H + +#include "Core" +#include + +#if EIGEN_COMP_MSVC && EIGEN_OS_WIN64 && (EIGEN_MAX_STATIC_ALIGN_BYTES<=16) /* MSVC auto aligns up to 16 bytes in 64 bit builds */ + +#define EIGEN_DEFINE_STL_LIST_SPECIALIZATION(...) + +#else + +#include "src/StlSupport/StdList.h" + +#endif + +#endif // EIGEN_STDLIST_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/StdVector b/src/thirdparty/eigen-3.4.0/Eigen/StdVector new file mode 100644 index 0000000..0c4697a --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/StdVector @@ -0,0 +1,27 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// Copyright (C) 2009 Hauke Heibel +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_STDVECTOR_MODULE_H +#define EIGEN_STDVECTOR_MODULE_H + +#include "Core" +#include + +#if EIGEN_COMP_MSVC && EIGEN_OS_WIN64 && (EIGEN_MAX_STATIC_ALIGN_BYTES<=16) /* MSVC auto aligns up to 16 bytes in 64 bit builds */ + +#define EIGEN_DEFINE_STL_VECTOR_SPECIALIZATION(...) + +#else + +#include "src/StlSupport/StdVector.h" + +#endif + +#endif // EIGEN_STDVECTOR_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/SuperLUSupport b/src/thirdparty/eigen-3.4.0/Eigen/SuperLUSupport new file mode 100644 index 0000000..59312a8 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/SuperLUSupport @@ -0,0 +1,64 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SUPERLUSUPPORT_MODULE_H +#define EIGEN_SUPERLUSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +#ifdef EMPTY +#define EIGEN_EMPTY_WAS_ALREADY_DEFINED +#endif + +typedef int int_t; +#include +#include +#include + +// slu_util.h defines a preprocessor token named EMPTY which is really polluting, +// so we remove it in favor of a SUPERLU_EMPTY token. +// If EMPTY was already defined then we don't undef it. + +#if defined(EIGEN_EMPTY_WAS_ALREADY_DEFINED) +# undef EIGEN_EMPTY_WAS_ALREADY_DEFINED +#elif defined(EMPTY) +# undef EMPTY +#endif + +#define SUPERLU_EMPTY (-1) + +namespace Eigen { struct SluMatrix; } + +/** \ingroup Support_modules + * \defgroup SuperLUSupport_Module SuperLUSupport module + * + * This module provides an interface to the SuperLU library. + * It provides the following factorization class: + * - class SuperLU: a supernodal sequential LU factorization. + * - class SuperILU: a supernodal sequential incomplete LU factorization (to be used as a preconditioner for iterative methods). + * + * \warning This wrapper requires at least versions 4.0 of SuperLU. The 3.x versions are not supported. + * + * \warning When including this module, you have to use SUPERLU_EMPTY instead of EMPTY which is no longer defined because it is too polluting. + * + * \code + * #include + * \endcode + * + * In order to use this module, the superlu headers must be accessible from the include paths, and your binary must be linked to the superlu library and its dependencies. + * The dependencies depend on how superlu has been compiled. + * For a cmake based project, you can use our FindSuperLU.cmake module to help you in this task. + * + */ + +#include "src/SuperLUSupport/SuperLUSupport.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_SUPERLUSUPPORT_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/UmfPackSupport b/src/thirdparty/eigen-3.4.0/Eigen/UmfPackSupport new file mode 100644 index 0000000..00eec80 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/UmfPackSupport @@ -0,0 +1,40 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_UMFPACKSUPPORT_MODULE_H +#define EIGEN_UMFPACKSUPPORT_MODULE_H + +#include "SparseCore" + +#include "src/Core/util/DisableStupidWarnings.h" + +extern "C" { +#include +} + +/** \ingroup Support_modules + * \defgroup UmfPackSupport_Module UmfPackSupport module + * + * This module provides an interface to the UmfPack library which is part of the suitesparse package. + * It provides the following factorization class: + * - class UmfPackLU: a multifrontal sequential LU factorization. + * + * \code + * #include + * \endcode + * + * In order to use this module, the umfpack headers must be accessible from the include paths, and your binary must be linked to the umfpack library and its dependencies. + * The dependencies depend on how umfpack has been compiled. + * For a cmake based project, you can use our FindUmfPack.cmake module to help you in this task. + * + */ + +#include "src/UmfPackSupport/UmfPackSupport.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_UMFPACKSUPPORT_MODULE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Cholesky/LDLT.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Cholesky/LDLT.h new file mode 100644 index 0000000..1013ca0 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Cholesky/LDLT.h @@ -0,0 +1,688 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2011 Gael Guennebaud +// Copyright (C) 2009 Keir Mierle +// Copyright (C) 2009 Benoit Jacob +// Copyright (C) 2011 Timothy E. Holy +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_LDLT_H +#define EIGEN_LDLT_H + +namespace Eigen { + +namespace internal { + template struct traits > + : traits<_MatrixType> + { + typedef MatrixXpr XprKind; + typedef SolverStorage StorageKind; + typedef int StorageIndex; + enum { Flags = 0 }; + }; + + template struct LDLT_Traits; + + // PositiveSemiDef means positive semi-definite and non-zero; same for NegativeSemiDef + enum SignMatrix { PositiveSemiDef, NegativeSemiDef, ZeroSign, Indefinite }; +} + +/** \ingroup Cholesky_Module + * + * \class LDLT + * + * \brief Robust Cholesky decomposition of a matrix with pivoting + * + * \tparam _MatrixType the type of the matrix of which to compute the LDL^T Cholesky decomposition + * \tparam _UpLo the triangular part that will be used for the decompositon: Lower (default) or Upper. + * The other triangular part won't be read. + * + * Perform a robust Cholesky decomposition of a positive semidefinite or negative semidefinite + * matrix \f$ A \f$ such that \f$ A = P^TLDL^*P \f$, where P is a permutation matrix, L + * is lower triangular with a unit diagonal and D is a diagonal matrix. + * + * The decomposition uses pivoting to ensure stability, so that D will have + * zeros in the bottom right rank(A) - n submatrix. Avoiding the square root + * on D also stabilizes the computation. + * + * Remember that Cholesky decompositions are not rank-revealing. Also, do not use a Cholesky + * decomposition to determine whether a system of equations has a solution. + * + * This class supports the \link InplaceDecomposition inplace decomposition \endlink mechanism. + * + * \sa MatrixBase::ldlt(), SelfAdjointView::ldlt(), class LLT + */ +template class LDLT + : public SolverBase > +{ + public: + typedef _MatrixType MatrixType; + typedef SolverBase Base; + friend class SolverBase; + + EIGEN_GENERIC_PUBLIC_INTERFACE(LDLT) + enum { + MaxRowsAtCompileTime = MatrixType::MaxRowsAtCompileTime, + MaxColsAtCompileTime = MatrixType::MaxColsAtCompileTime, + UpLo = _UpLo + }; + typedef Matrix TmpMatrixType; + + typedef Transpositions TranspositionType; + typedef PermutationMatrix PermutationType; + + typedef internal::LDLT_Traits Traits; + + /** \brief Default Constructor. + * + * The default constructor is useful in cases in which the user intends to + * perform decompositions via LDLT::compute(const MatrixType&). + */ + LDLT() + : m_matrix(), + m_transpositions(), + m_sign(internal::ZeroSign), + m_isInitialized(false) + {} + + /** \brief Default Constructor with memory preallocation + * + * Like the default constructor but with preallocation of the internal data + * according to the specified problem \a size. + * \sa LDLT() + */ + explicit LDLT(Index size) + : m_matrix(size, size), + m_transpositions(size), + m_temporary(size), + m_sign(internal::ZeroSign), + m_isInitialized(false) + {} + + /** \brief Constructor with decomposition + * + * This calculates the decomposition for the input \a matrix. + * + * \sa LDLT(Index size) + */ + template + explicit LDLT(const EigenBase& matrix) + : m_matrix(matrix.rows(), matrix.cols()), + m_transpositions(matrix.rows()), + m_temporary(matrix.rows()), + m_sign(internal::ZeroSign), + m_isInitialized(false) + { + compute(matrix.derived()); + } + + /** \brief Constructs a LDLT factorization from a given matrix + * + * This overloaded constructor is provided for \link InplaceDecomposition inplace decomposition \endlink when \c MatrixType is a Eigen::Ref. + * + * \sa LDLT(const EigenBase&) + */ + template + explicit LDLT(EigenBase& matrix) + : m_matrix(matrix.derived()), + m_transpositions(matrix.rows()), + m_temporary(matrix.rows()), + m_sign(internal::ZeroSign), + m_isInitialized(false) + { + compute(matrix.derived()); + } + + /** Clear any existing decomposition + * \sa rankUpdate(w,sigma) + */ + void setZero() + { + m_isInitialized = false; + } + + /** \returns a view of the upper triangular matrix U */ + inline typename Traits::MatrixU matrixU() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return Traits::getU(m_matrix); + } + + /** \returns a view of the lower triangular matrix L */ + inline typename Traits::MatrixL matrixL() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return Traits::getL(m_matrix); + } + + /** \returns the permutation matrix P as a transposition sequence. + */ + inline const TranspositionType& transpositionsP() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_transpositions; + } + + /** \returns the coefficients of the diagonal matrix D */ + inline Diagonal vectorD() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_matrix.diagonal(); + } + + /** \returns true if the matrix is positive (semidefinite) */ + inline bool isPositive() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_sign == internal::PositiveSemiDef || m_sign == internal::ZeroSign; + } + + /** \returns true if the matrix is negative (semidefinite) */ + inline bool isNegative(void) const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_sign == internal::NegativeSemiDef || m_sign == internal::ZeroSign; + } + + #ifdef EIGEN_PARSED_BY_DOXYGEN + /** \returns a solution x of \f$ A x = b \f$ using the current decomposition of A. + * + * This function also supports in-place solves using the syntax x = decompositionObject.solve(x) . + * + * \note_about_checking_solutions + * + * More precisely, this method solves \f$ A x = b \f$ using the decomposition \f$ A = P^T L D L^* P \f$ + * by solving the systems \f$ P^T y_1 = b \f$, \f$ L y_2 = y_1 \f$, \f$ D y_3 = y_2 \f$, + * \f$ L^* y_4 = y_3 \f$ and \f$ P x = y_4 \f$ in succession. If the matrix \f$ A \f$ is singular, then + * \f$ D \f$ will also be singular (all the other matrices are invertible). In that case, the + * least-square solution of \f$ D y_3 = y_2 \f$ is computed. This does not mean that this function + * computes the least-square solution of \f$ A x = b \f$ if \f$ A \f$ is singular. + * + * \sa MatrixBase::ldlt(), SelfAdjointView::ldlt() + */ + template + inline const Solve + solve(const MatrixBase& b) const; + #endif + + template + bool solveInPlace(MatrixBase &bAndX) const; + + template + LDLT& compute(const EigenBase& matrix); + + /** \returns an estimate of the reciprocal condition number of the matrix of + * which \c *this is the LDLT decomposition. + */ + RealScalar rcond() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return internal::rcond_estimate_helper(m_l1_norm, *this); + } + + template + LDLT& rankUpdate(const MatrixBase& w, const RealScalar& alpha=1); + + /** \returns the internal LDLT decomposition matrix + * + * TODO: document the storage layout + */ + inline const MatrixType& matrixLDLT() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_matrix; + } + + MatrixType reconstructedMatrix() const; + + /** \returns the adjoint of \c *this, that is, a const reference to the decomposition itself as the underlying matrix is self-adjoint. + * + * This method is provided for compatibility with other matrix decompositions, thus enabling generic code such as: + * \code x = decomposition.adjoint().solve(b) \endcode + */ + const LDLT& adjoint() const { return *this; }; + + EIGEN_DEVICE_FUNC inline EIGEN_CONSTEXPR Index rows() const EIGEN_NOEXCEPT { return m_matrix.rows(); } + EIGEN_DEVICE_FUNC inline EIGEN_CONSTEXPR Index cols() const EIGEN_NOEXCEPT { return m_matrix.cols(); } + + /** \brief Reports whether previous computation was successful. + * + * \returns \c Success if computation was successful, + * \c NumericalIssue if the factorization failed because of a zero pivot. + */ + ComputationInfo info() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_info; + } + + #ifndef EIGEN_PARSED_BY_DOXYGEN + template + void _solve_impl(const RhsType &rhs, DstType &dst) const; + + template + void _solve_impl_transposed(const RhsType &rhs, DstType &dst) const; + #endif + + protected: + + static void check_template_parameters() + { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar); + } + + /** \internal + * Used to compute and store the Cholesky decomposition A = L D L^* = U^* D U. + * The strict upper part is used during the decomposition, the strict lower + * part correspond to the coefficients of L (its diagonal is equal to 1 and + * is not stored), and the diagonal entries correspond to D. + */ + MatrixType m_matrix; + RealScalar m_l1_norm; + TranspositionType m_transpositions; + TmpMatrixType m_temporary; + internal::SignMatrix m_sign; + bool m_isInitialized; + ComputationInfo m_info; +}; + +namespace internal { + +template struct ldlt_inplace; + +template<> struct ldlt_inplace +{ + template + static bool unblocked(MatrixType& mat, TranspositionType& transpositions, Workspace& temp, SignMatrix& sign) + { + using std::abs; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + typedef typename TranspositionType::StorageIndex IndexType; + eigen_assert(mat.rows()==mat.cols()); + const Index size = mat.rows(); + bool found_zero_pivot = false; + bool ret = true; + + if (size <= 1) + { + transpositions.setIdentity(); + if(size==0) sign = ZeroSign; + else if (numext::real(mat.coeff(0,0)) > static_cast(0) ) sign = PositiveSemiDef; + else if (numext::real(mat.coeff(0,0)) < static_cast(0)) sign = NegativeSemiDef; + else sign = ZeroSign; + return true; + } + + for (Index k = 0; k < size; ++k) + { + // Find largest diagonal element + Index index_of_biggest_in_corner; + mat.diagonal().tail(size-k).cwiseAbs().maxCoeff(&index_of_biggest_in_corner); + index_of_biggest_in_corner += k; + + transpositions.coeffRef(k) = IndexType(index_of_biggest_in_corner); + if(k != index_of_biggest_in_corner) + { + // apply the transposition while taking care to consider only + // the lower triangular part + Index s = size-index_of_biggest_in_corner-1; // trailing size after the biggest element + mat.row(k).head(k).swap(mat.row(index_of_biggest_in_corner).head(k)); + mat.col(k).tail(s).swap(mat.col(index_of_biggest_in_corner).tail(s)); + std::swap(mat.coeffRef(k,k),mat.coeffRef(index_of_biggest_in_corner,index_of_biggest_in_corner)); + for(Index i=k+1;i::IsComplex) + mat.coeffRef(index_of_biggest_in_corner,k) = numext::conj(mat.coeff(index_of_biggest_in_corner,k)); + } + + // partition the matrix: + // A00 | - | - + // lu = A10 | A11 | - + // A20 | A21 | A22 + Index rs = size - k - 1; + Block A21(mat,k+1,k,rs,1); + Block A10(mat,k,0,1,k); + Block A20(mat,k+1,0,rs,k); + + if(k>0) + { + temp.head(k) = mat.diagonal().real().head(k).asDiagonal() * A10.adjoint(); + mat.coeffRef(k,k) -= (A10 * temp.head(k)).value(); + if(rs>0) + A21.noalias() -= A20 * temp.head(k); + } + + // In some previous versions of Eigen (e.g., 3.2.1), the scaling was omitted if the pivot + // was smaller than the cutoff value. However, since LDLT is not rank-revealing + // we should only make sure that we do not introduce INF or NaN values. + // Remark that LAPACK also uses 0 as the cutoff value. + RealScalar realAkk = numext::real(mat.coeffRef(k,k)); + bool pivot_is_valid = (abs(realAkk) > RealScalar(0)); + + if(k==0 && !pivot_is_valid) + { + // The entire diagonal is zero, there is nothing more to do + // except filling the transpositions, and checking whether the matrix is zero. + sign = ZeroSign; + for(Index j = 0; j0) && pivot_is_valid) + A21 /= realAkk; + else if(rs>0) + ret = ret && (A21.array()==Scalar(0)).all(); + + if(found_zero_pivot && pivot_is_valid) ret = false; // factorization failed + else if(!pivot_is_valid) found_zero_pivot = true; + + if (sign == PositiveSemiDef) { + if (realAkk < static_cast(0)) sign = Indefinite; + } else if (sign == NegativeSemiDef) { + if (realAkk > static_cast(0)) sign = Indefinite; + } else if (sign == ZeroSign) { + if (realAkk > static_cast(0)) sign = PositiveSemiDef; + else if (realAkk < static_cast(0)) sign = NegativeSemiDef; + } + } + + return ret; + } + + // Reference for the algorithm: Davis and Hager, "Multiple Rank + // Modifications of a Sparse Cholesky Factorization" (Algorithm 1) + // Trivial rearrangements of their computations (Timothy E. Holy) + // allow their algorithm to work for rank-1 updates even if the + // original matrix is not of full rank. + // Here only rank-1 updates are implemented, to reduce the + // requirement for intermediate storage and improve accuracy + template + static bool updateInPlace(MatrixType& mat, MatrixBase& w, const typename MatrixType::RealScalar& sigma=1) + { + using numext::isfinite; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + + const Index size = mat.rows(); + eigen_assert(mat.cols() == size && w.size()==size); + + RealScalar alpha = 1; + + // Apply the update + for (Index j = 0; j < size; j++) + { + // Check for termination due to an original decomposition of low-rank + if (!(isfinite)(alpha)) + break; + + // Update the diagonal terms + RealScalar dj = numext::real(mat.coeff(j,j)); + Scalar wj = w.coeff(j); + RealScalar swj2 = sigma*numext::abs2(wj); + RealScalar gamma = dj*alpha + swj2; + + mat.coeffRef(j,j) += swj2/alpha; + alpha += swj2/dj; + + + // Update the terms of L + Index rs = size-j-1; + w.tail(rs) -= wj * mat.col(j).tail(rs); + if(gamma != 0) + mat.col(j).tail(rs) += (sigma*numext::conj(wj)/gamma)*w.tail(rs); + } + return true; + } + + template + static bool update(MatrixType& mat, const TranspositionType& transpositions, Workspace& tmp, const WType& w, const typename MatrixType::RealScalar& sigma=1) + { + // Apply the permutation to the input w + tmp = transpositions * w; + + return ldlt_inplace::updateInPlace(mat,tmp,sigma); + } +}; + +template<> struct ldlt_inplace +{ + template + static EIGEN_STRONG_INLINE bool unblocked(MatrixType& mat, TranspositionType& transpositions, Workspace& temp, SignMatrix& sign) + { + Transpose matt(mat); + return ldlt_inplace::unblocked(matt, transpositions, temp, sign); + } + + template + static EIGEN_STRONG_INLINE bool update(MatrixType& mat, TranspositionType& transpositions, Workspace& tmp, WType& w, const typename MatrixType::RealScalar& sigma=1) + { + Transpose matt(mat); + return ldlt_inplace::update(matt, transpositions, tmp, w.conjugate(), sigma); + } +}; + +template struct LDLT_Traits +{ + typedef const TriangularView MatrixL; + typedef const TriangularView MatrixU; + static inline MatrixL getL(const MatrixType& m) { return MatrixL(m); } + static inline MatrixU getU(const MatrixType& m) { return MatrixU(m.adjoint()); } +}; + +template struct LDLT_Traits +{ + typedef const TriangularView MatrixL; + typedef const TriangularView MatrixU; + static inline MatrixL getL(const MatrixType& m) { return MatrixL(m.adjoint()); } + static inline MatrixU getU(const MatrixType& m) { return MatrixU(m); } +}; + +} // end namespace internal + +/** Compute / recompute the LDLT decomposition A = L D L^* = U^* D U of \a matrix + */ +template +template +LDLT& LDLT::compute(const EigenBase& a) +{ + check_template_parameters(); + + eigen_assert(a.rows()==a.cols()); + const Index size = a.rows(); + + m_matrix = a.derived(); + + // Compute matrix L1 norm = max abs column sum. + m_l1_norm = RealScalar(0); + // TODO move this code to SelfAdjointView + for (Index col = 0; col < size; ++col) { + RealScalar abs_col_sum; + if (_UpLo == Lower) + abs_col_sum = m_matrix.col(col).tail(size - col).template lpNorm<1>() + m_matrix.row(col).head(col).template lpNorm<1>(); + else + abs_col_sum = m_matrix.col(col).head(col).template lpNorm<1>() + m_matrix.row(col).tail(size - col).template lpNorm<1>(); + if (abs_col_sum > m_l1_norm) + m_l1_norm = abs_col_sum; + } + + m_transpositions.resize(size); + m_isInitialized = false; + m_temporary.resize(size); + m_sign = internal::ZeroSign; + + m_info = internal::ldlt_inplace::unblocked(m_matrix, m_transpositions, m_temporary, m_sign) ? Success : NumericalIssue; + + m_isInitialized = true; + return *this; +} + +/** Update the LDLT decomposition: given A = L D L^T, efficiently compute the decomposition of A + sigma w w^T. + * \param w a vector to be incorporated into the decomposition. + * \param sigma a scalar, +1 for updates and -1 for "downdates," which correspond to removing previously-added column vectors. Optional; default value is +1. + * \sa setZero() + */ +template +template +LDLT& LDLT::rankUpdate(const MatrixBase& w, const typename LDLT::RealScalar& sigma) +{ + typedef typename TranspositionType::StorageIndex IndexType; + const Index size = w.rows(); + if (m_isInitialized) + { + eigen_assert(m_matrix.rows()==size); + } + else + { + m_matrix.resize(size,size); + m_matrix.setZero(); + m_transpositions.resize(size); + for (Index i = 0; i < size; i++) + m_transpositions.coeffRef(i) = IndexType(i); + m_temporary.resize(size); + m_sign = sigma>=0 ? internal::PositiveSemiDef : internal::NegativeSemiDef; + m_isInitialized = true; + } + + internal::ldlt_inplace::update(m_matrix, m_transpositions, m_temporary, w, sigma); + + return *this; +} + +#ifndef EIGEN_PARSED_BY_DOXYGEN +template +template +void LDLT<_MatrixType,_UpLo>::_solve_impl(const RhsType &rhs, DstType &dst) const +{ + _solve_impl_transposed(rhs, dst); +} + +template +template +void LDLT<_MatrixType,_UpLo>::_solve_impl_transposed(const RhsType &rhs, DstType &dst) const +{ + // dst = P b + dst = m_transpositions * rhs; + + // dst = L^-1 (P b) + // dst = L^-*T (P b) + matrixL().template conjugateIf().solveInPlace(dst); + + // dst = D^-* (L^-1 P b) + // dst = D^-1 (L^-*T P b) + // more precisely, use pseudo-inverse of D (see bug 241) + using std::abs; + const typename Diagonal::RealReturnType vecD(vectorD()); + // In some previous versions, tolerance was set to the max of 1/highest (or rather numeric_limits::min()) + // and the maximal diagonal entry * epsilon as motivated by LAPACK's xGELSS: + // RealScalar tolerance = numext::maxi(vecD.array().abs().maxCoeff() * NumTraits::epsilon(),RealScalar(1) / NumTraits::highest()); + // However, LDLT is not rank revealing, and so adjusting the tolerance wrt to the highest + // diagonal element is not well justified and leads to numerical issues in some cases. + // Moreover, Lapack's xSYTRS routines use 0 for the tolerance. + // Using numeric_limits::min() gives us more robustness to denormals. + RealScalar tolerance = (std::numeric_limits::min)(); + for (Index i = 0; i < vecD.size(); ++i) + { + if(abs(vecD(i)) > tolerance) + dst.row(i) /= vecD(i); + else + dst.row(i).setZero(); + } + + // dst = L^-* (D^-* L^-1 P b) + // dst = L^-T (D^-1 L^-*T P b) + matrixL().transpose().template conjugateIf().solveInPlace(dst); + + // dst = P^T (L^-* D^-* L^-1 P b) = A^-1 b + // dst = P^-T (L^-T D^-1 L^-*T P b) = A^-1 b + dst = m_transpositions.transpose() * dst; +} +#endif + +/** \internal use x = ldlt_object.solve(x); + * + * This is the \em in-place version of solve(). + * + * \param bAndX represents both the right-hand side matrix b and result x. + * + * \returns true always! If you need to check for existence of solutions, use another decomposition like LU, QR, or SVD. + * + * This version avoids a copy when the right hand side matrix b is not + * needed anymore. + * + * \sa LDLT::solve(), MatrixBase::ldlt() + */ +template +template +bool LDLT::solveInPlace(MatrixBase &bAndX) const +{ + eigen_assert(m_isInitialized && "LDLT is not initialized."); + eigen_assert(m_matrix.rows() == bAndX.rows()); + + bAndX = this->solve(bAndX); + + return true; +} + +/** \returns the matrix represented by the decomposition, + * i.e., it returns the product: P^T L D L^* P. + * This function is provided for debug purpose. */ +template +MatrixType LDLT::reconstructedMatrix() const +{ + eigen_assert(m_isInitialized && "LDLT is not initialized."); + const Index size = m_matrix.rows(); + MatrixType res(size,size); + + // P + res.setIdentity(); + res = transpositionsP() * res; + // L^* P + res = matrixU() * res; + // D(L^*P) + res = vectorD().real().asDiagonal() * res; + // L(DL^*P) + res = matrixL() * res; + // P^T (LDL^*P) + res = transpositionsP().transpose() * res; + + return res; +} + +/** \cholesky_module + * \returns the Cholesky decomposition with full pivoting without square root of \c *this + * \sa MatrixBase::ldlt() + */ +template +inline const LDLT::PlainObject, UpLo> +SelfAdjointView::ldlt() const +{ + return LDLT(m_matrix); +} + +/** \cholesky_module + * \returns the Cholesky decomposition with full pivoting without square root of \c *this + * \sa SelfAdjointView::ldlt() + */ +template +inline const LDLT::PlainObject> +MatrixBase::ldlt() const +{ + return LDLT(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_LDLT_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Cholesky/LLT.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Cholesky/LLT.h new file mode 100644 index 0000000..8c9b2b3 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Cholesky/LLT.h @@ -0,0 +1,558 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_LLT_H +#define EIGEN_LLT_H + +namespace Eigen { + +namespace internal{ + +template struct traits > + : traits<_MatrixType> +{ + typedef MatrixXpr XprKind; + typedef SolverStorage StorageKind; + typedef int StorageIndex; + enum { Flags = 0 }; +}; + +template struct LLT_Traits; +} + +/** \ingroup Cholesky_Module + * + * \class LLT + * + * \brief Standard Cholesky decomposition (LL^T) of a matrix and associated features + * + * \tparam _MatrixType the type of the matrix of which we are computing the LL^T Cholesky decomposition + * \tparam _UpLo the triangular part that will be used for the decompositon: Lower (default) or Upper. + * The other triangular part won't be read. + * + * This class performs a LL^T Cholesky decomposition of a symmetric, positive definite + * matrix A such that A = LL^* = U^*U, where L is lower triangular. + * + * While the Cholesky decomposition is particularly useful to solve selfadjoint problems like D^*D x = b, + * for that purpose, we recommend the Cholesky decomposition without square root which is more stable + * and even faster. Nevertheless, this standard Cholesky decomposition remains useful in many other + * situations like generalised eigen problems with hermitian matrices. + * + * Remember that Cholesky decompositions are not rank-revealing. This LLT decomposition is only stable on positive definite matrices, + * use LDLT instead for the semidefinite case. Also, do not use a Cholesky decomposition to determine whether a system of equations + * has a solution. + * + * Example: \include LLT_example.cpp + * Output: \verbinclude LLT_example.out + * + * \b Performance: for best performance, it is recommended to use a column-major storage format + * with the Lower triangular part (the default), or, equivalently, a row-major storage format + * with the Upper triangular part. Otherwise, you might get a 20% slowdown for the full factorization + * step, and rank-updates can be up to 3 times slower. + * + * This class supports the \link InplaceDecomposition inplace decomposition \endlink mechanism. + * + * Note that during the decomposition, only the lower (or upper, as defined by _UpLo) triangular part of A is considered. + * Therefore, the strict lower part does not have to store correct values. + * + * \sa MatrixBase::llt(), SelfAdjointView::llt(), class LDLT + */ +template class LLT + : public SolverBase > +{ + public: + typedef _MatrixType MatrixType; + typedef SolverBase Base; + friend class SolverBase; + + EIGEN_GENERIC_PUBLIC_INTERFACE(LLT) + enum { + MaxColsAtCompileTime = MatrixType::MaxColsAtCompileTime + }; + + enum { + PacketSize = internal::packet_traits::size, + AlignmentMask = int(PacketSize)-1, + UpLo = _UpLo + }; + + typedef internal::LLT_Traits Traits; + + /** + * \brief Default Constructor. + * + * The default constructor is useful in cases in which the user intends to + * perform decompositions via LLT::compute(const MatrixType&). + */ + LLT() : m_matrix(), m_isInitialized(false) {} + + /** \brief Default Constructor with memory preallocation + * + * Like the default constructor but with preallocation of the internal data + * according to the specified problem \a size. + * \sa LLT() + */ + explicit LLT(Index size) : m_matrix(size, size), + m_isInitialized(false) {} + + template + explicit LLT(const EigenBase& matrix) + : m_matrix(matrix.rows(), matrix.cols()), + m_isInitialized(false) + { + compute(matrix.derived()); + } + + /** \brief Constructs a LLT factorization from a given matrix + * + * This overloaded constructor is provided for \link InplaceDecomposition inplace decomposition \endlink when + * \c MatrixType is a Eigen::Ref. + * + * \sa LLT(const EigenBase&) + */ + template + explicit LLT(EigenBase& matrix) + : m_matrix(matrix.derived()), + m_isInitialized(false) + { + compute(matrix.derived()); + } + + /** \returns a view of the upper triangular matrix U */ + inline typename Traits::MatrixU matrixU() const + { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return Traits::getU(m_matrix); + } + + /** \returns a view of the lower triangular matrix L */ + inline typename Traits::MatrixL matrixL() const + { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return Traits::getL(m_matrix); + } + + #ifdef EIGEN_PARSED_BY_DOXYGEN + /** \returns the solution x of \f$ A x = b \f$ using the current decomposition of A. + * + * Since this LLT class assumes anyway that the matrix A is invertible, the solution + * theoretically exists and is unique regardless of b. + * + * Example: \include LLT_solve.cpp + * Output: \verbinclude LLT_solve.out + * + * \sa solveInPlace(), MatrixBase::llt(), SelfAdjointView::llt() + */ + template + inline const Solve + solve(const MatrixBase& b) const; + #endif + + template + void solveInPlace(const MatrixBase &bAndX) const; + + template + LLT& compute(const EigenBase& matrix); + + /** \returns an estimate of the reciprocal condition number of the matrix of + * which \c *this is the Cholesky decomposition. + */ + RealScalar rcond() const + { + eigen_assert(m_isInitialized && "LLT is not initialized."); + eigen_assert(m_info == Success && "LLT failed because matrix appears to be negative"); + return internal::rcond_estimate_helper(m_l1_norm, *this); + } + + /** \returns the LLT decomposition matrix + * + * TODO: document the storage layout + */ + inline const MatrixType& matrixLLT() const + { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return m_matrix; + } + + MatrixType reconstructedMatrix() const; + + + /** \brief Reports whether previous computation was successful. + * + * \returns \c Success if computation was successful, + * \c NumericalIssue if the matrix.appears not to be positive definite. + */ + ComputationInfo info() const + { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return m_info; + } + + /** \returns the adjoint of \c *this, that is, a const reference to the decomposition itself as the underlying matrix is self-adjoint. + * + * This method is provided for compatibility with other matrix decompositions, thus enabling generic code such as: + * \code x = decomposition.adjoint().solve(b) \endcode + */ + const LLT& adjoint() const EIGEN_NOEXCEPT { return *this; }; + + inline EIGEN_CONSTEXPR Index rows() const EIGEN_NOEXCEPT { return m_matrix.rows(); } + inline EIGEN_CONSTEXPR Index cols() const EIGEN_NOEXCEPT { return m_matrix.cols(); } + + template + LLT & rankUpdate(const VectorType& vec, const RealScalar& sigma = 1); + + #ifndef EIGEN_PARSED_BY_DOXYGEN + template + void _solve_impl(const RhsType &rhs, DstType &dst) const; + + template + void _solve_impl_transposed(const RhsType &rhs, DstType &dst) const; + #endif + + protected: + + static void check_template_parameters() + { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar); + } + + /** \internal + * Used to compute and store L + * The strict upper part is not used and even not initialized. + */ + MatrixType m_matrix; + RealScalar m_l1_norm; + bool m_isInitialized; + ComputationInfo m_info; +}; + +namespace internal { + +template struct llt_inplace; + +template +static Index llt_rank_update_lower(MatrixType& mat, const VectorType& vec, const typename MatrixType::RealScalar& sigma) +{ + using std::sqrt; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + typedef typename MatrixType::ColXpr ColXpr; + typedef typename internal::remove_all::type ColXprCleaned; + typedef typename ColXprCleaned::SegmentReturnType ColXprSegment; + typedef Matrix TempVectorType; + typedef typename TempVectorType::SegmentReturnType TempVecSegment; + + Index n = mat.cols(); + eigen_assert(mat.rows()==n && vec.size()==n); + + TempVectorType temp; + + if(sigma>0) + { + // This version is based on Givens rotations. + // It is faster than the other one below, but only works for updates, + // i.e., for sigma > 0 + temp = sqrt(sigma) * vec; + + for(Index i=0; i g; + g.makeGivens(mat(i,i), -temp(i), &mat(i,i)); + + Index rs = n-i-1; + if(rs>0) + { + ColXprSegment x(mat.col(i).tail(rs)); + TempVecSegment y(temp.tail(rs)); + apply_rotation_in_the_plane(x, y, g); + } + } + } + else + { + temp = vec; + RealScalar beta = 1; + for(Index j=0; j struct llt_inplace +{ + typedef typename NumTraits::Real RealScalar; + template + static Index unblocked(MatrixType& mat) + { + using std::sqrt; + + eigen_assert(mat.rows()==mat.cols()); + const Index size = mat.rows(); + for(Index k = 0; k < size; ++k) + { + Index rs = size-k-1; // remaining size + + Block A21(mat,k+1,k,rs,1); + Block A10(mat,k,0,1,k); + Block A20(mat,k+1,0,rs,k); + + RealScalar x = numext::real(mat.coeff(k,k)); + if (k>0) x -= A10.squaredNorm(); + if (x<=RealScalar(0)) + return k; + mat.coeffRef(k,k) = x = sqrt(x); + if (k>0 && rs>0) A21.noalias() -= A20 * A10.adjoint(); + if (rs>0) A21 /= x; + } + return -1; + } + + template + static Index blocked(MatrixType& m) + { + eigen_assert(m.rows()==m.cols()); + Index size = m.rows(); + if(size<32) + return unblocked(m); + + Index blockSize = size/8; + blockSize = (blockSize/16)*16; + blockSize = (std::min)((std::max)(blockSize,Index(8)), Index(128)); + + for (Index k=0; k A11(m,k, k, bs,bs); + Block A21(m,k+bs,k, rs,bs); + Block A22(m,k+bs,k+bs,rs,rs); + + Index ret; + if((ret=unblocked(A11))>=0) return k+ret; + if(rs>0) A11.adjoint().template triangularView().template solveInPlace(A21); + if(rs>0) A22.template selfadjointView().rankUpdate(A21,typename NumTraits::Literal(-1)); // bottleneck + } + return -1; + } + + template + static Index rankUpdate(MatrixType& mat, const VectorType& vec, const RealScalar& sigma) + { + return Eigen::internal::llt_rank_update_lower(mat, vec, sigma); + } +}; + +template struct llt_inplace +{ + typedef typename NumTraits::Real RealScalar; + + template + static EIGEN_STRONG_INLINE Index unblocked(MatrixType& mat) + { + Transpose matt(mat); + return llt_inplace::unblocked(matt); + } + template + static EIGEN_STRONG_INLINE Index blocked(MatrixType& mat) + { + Transpose matt(mat); + return llt_inplace::blocked(matt); + } + template + static Index rankUpdate(MatrixType& mat, const VectorType& vec, const RealScalar& sigma) + { + Transpose matt(mat); + return llt_inplace::rankUpdate(matt, vec.conjugate(), sigma); + } +}; + +template struct LLT_Traits +{ + typedef const TriangularView MatrixL; + typedef const TriangularView MatrixU; + static inline MatrixL getL(const MatrixType& m) { return MatrixL(m); } + static inline MatrixU getU(const MatrixType& m) { return MatrixU(m.adjoint()); } + static bool inplace_decomposition(MatrixType& m) + { return llt_inplace::blocked(m)==-1; } +}; + +template struct LLT_Traits +{ + typedef const TriangularView MatrixL; + typedef const TriangularView MatrixU; + static inline MatrixL getL(const MatrixType& m) { return MatrixL(m.adjoint()); } + static inline MatrixU getU(const MatrixType& m) { return MatrixU(m); } + static bool inplace_decomposition(MatrixType& m) + { return llt_inplace::blocked(m)==-1; } +}; + +} // end namespace internal + +/** Computes / recomputes the Cholesky decomposition A = LL^* = U^*U of \a matrix + * + * \returns a reference to *this + * + * Example: \include TutorialLinAlgComputeTwice.cpp + * Output: \verbinclude TutorialLinAlgComputeTwice.out + */ +template +template +LLT& LLT::compute(const EigenBase& a) +{ + check_template_parameters(); + + eigen_assert(a.rows()==a.cols()); + const Index size = a.rows(); + m_matrix.resize(size, size); + if (!internal::is_same_dense(m_matrix, a.derived())) + m_matrix = a.derived(); + + // Compute matrix L1 norm = max abs column sum. + m_l1_norm = RealScalar(0); + // TODO move this code to SelfAdjointView + for (Index col = 0; col < size; ++col) { + RealScalar abs_col_sum; + if (_UpLo == Lower) + abs_col_sum = m_matrix.col(col).tail(size - col).template lpNorm<1>() + m_matrix.row(col).head(col).template lpNorm<1>(); + else + abs_col_sum = m_matrix.col(col).head(col).template lpNorm<1>() + m_matrix.row(col).tail(size - col).template lpNorm<1>(); + if (abs_col_sum > m_l1_norm) + m_l1_norm = abs_col_sum; + } + + m_isInitialized = true; + bool ok = Traits::inplace_decomposition(m_matrix); + m_info = ok ? Success : NumericalIssue; + + return *this; +} + +/** Performs a rank one update (or dowdate) of the current decomposition. + * If A = LL^* before the rank one update, + * then after it we have LL^* = A + sigma * v v^* where \a v must be a vector + * of same dimension. + */ +template +template +LLT<_MatrixType,_UpLo> & LLT<_MatrixType,_UpLo>::rankUpdate(const VectorType& v, const RealScalar& sigma) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(VectorType); + eigen_assert(v.size()==m_matrix.cols()); + eigen_assert(m_isInitialized); + if(internal::llt_inplace::rankUpdate(m_matrix,v,sigma)>=0) + m_info = NumericalIssue; + else + m_info = Success; + + return *this; +} + +#ifndef EIGEN_PARSED_BY_DOXYGEN +template +template +void LLT<_MatrixType,_UpLo>::_solve_impl(const RhsType &rhs, DstType &dst) const +{ + _solve_impl_transposed(rhs, dst); +} + +template +template +void LLT<_MatrixType,_UpLo>::_solve_impl_transposed(const RhsType &rhs, DstType &dst) const +{ + dst = rhs; + + matrixL().template conjugateIf().solveInPlace(dst); + matrixU().template conjugateIf().solveInPlace(dst); +} +#endif + +/** \internal use x = llt_object.solve(x); + * + * This is the \em in-place version of solve(). + * + * \param bAndX represents both the right-hand side matrix b and result x. + * + * This version avoids a copy when the right hand side matrix b is not needed anymore. + * + * \warning The parameter is only marked 'const' to make the C++ compiler accept a temporary expression here. + * This function will const_cast it, so constness isn't honored here. + * + * \sa LLT::solve(), MatrixBase::llt() + */ +template +template +void LLT::solveInPlace(const MatrixBase &bAndX) const +{ + eigen_assert(m_isInitialized && "LLT is not initialized."); + eigen_assert(m_matrix.rows()==bAndX.rows()); + matrixL().solveInPlace(bAndX); + matrixU().solveInPlace(bAndX); +} + +/** \returns the matrix represented by the decomposition, + * i.e., it returns the product: L L^*. + * This function is provided for debug purpose. */ +template +MatrixType LLT::reconstructedMatrix() const +{ + eigen_assert(m_isInitialized && "LLT is not initialized."); + return matrixL() * matrixL().adjoint().toDenseMatrix(); +} + +/** \cholesky_module + * \returns the LLT decomposition of \c *this + * \sa SelfAdjointView::llt() + */ +template +inline const LLT::PlainObject> +MatrixBase::llt() const +{ + return LLT(derived()); +} + +/** \cholesky_module + * \returns the LLT decomposition of \c *this + * \sa SelfAdjointView::llt() + */ +template +inline const LLT::PlainObject, UpLo> +SelfAdjointView::llt() const +{ + return LLT(m_matrix); +} + +} // end namespace Eigen + +#endif // EIGEN_LLT_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Cholesky/LLT_LAPACKE.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Cholesky/LLT_LAPACKE.h new file mode 100644 index 0000000..bc6489e --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Cholesky/LLT_LAPACKE.h @@ -0,0 +1,99 @@ +/* + Copyright (c) 2011, Intel Corporation. All rights reserved. + + Redistribution and use in source and binary forms, with or without modification, + are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + * Neither the name of Intel Corporation nor the names of its contributors may + be used to endorse or promote products derived from this software without + specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR + ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + ******************************************************************************** + * Content : Eigen bindings to LAPACKe + * LLt decomposition based on LAPACKE_?potrf function. + ******************************************************************************** +*/ + +#ifndef EIGEN_LLT_LAPACKE_H +#define EIGEN_LLT_LAPACKE_H + +namespace Eigen { + +namespace internal { + +template struct lapacke_llt; + +#define EIGEN_LAPACKE_LLT(EIGTYPE, BLASTYPE, LAPACKE_PREFIX) \ +template<> struct lapacke_llt \ +{ \ + template \ + static inline Index potrf(MatrixType& m, char uplo) \ + { \ + lapack_int matrix_order; \ + lapack_int size, lda, info, StorageOrder; \ + EIGTYPE* a; \ + eigen_assert(m.rows()==m.cols()); \ + /* Set up parameters for ?potrf */ \ + size = convert_index(m.rows()); \ + StorageOrder = MatrixType::Flags&RowMajorBit?RowMajor:ColMajor; \ + matrix_order = StorageOrder==RowMajor ? LAPACK_ROW_MAJOR : LAPACK_COL_MAJOR; \ + a = &(m.coeffRef(0,0)); \ + lda = convert_index(m.outerStride()); \ +\ + info = LAPACKE_##LAPACKE_PREFIX##potrf( matrix_order, uplo, size, (BLASTYPE*)a, lda ); \ + info = (info==0) ? -1 : info>0 ? info-1 : size; \ + return info; \ + } \ +}; \ +template<> struct llt_inplace \ +{ \ + template \ + static Index blocked(MatrixType& m) \ + { \ + return lapacke_llt::potrf(m, 'L'); \ + } \ + template \ + static Index rankUpdate(MatrixType& mat, const VectorType& vec, const typename MatrixType::RealScalar& sigma) \ + { return Eigen::internal::llt_rank_update_lower(mat, vec, sigma); } \ +}; \ +template<> struct llt_inplace \ +{ \ + template \ + static Index blocked(MatrixType& m) \ + { \ + return lapacke_llt::potrf(m, 'U'); \ + } \ + template \ + static Index rankUpdate(MatrixType& mat, const VectorType& vec, const typename MatrixType::RealScalar& sigma) \ + { \ + Transpose matt(mat); \ + return llt_inplace::rankUpdate(matt, vec.conjugate(), sigma); \ + } \ +}; + +EIGEN_LAPACKE_LLT(double, double, d) +EIGEN_LAPACKE_LLT(float, float, s) +EIGEN_LAPACKE_LLT(dcomplex, lapack_complex_double, z) +EIGEN_LAPACKE_LLT(scomplex, lapack_complex_float, c) + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_LLT_LAPACKE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/CholmodSupport/CholmodSupport.h b/src/thirdparty/eigen-3.4.0/Eigen/src/CholmodSupport/CholmodSupport.h new file mode 100644 index 0000000..adaf528 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/CholmodSupport/CholmodSupport.h @@ -0,0 +1,682 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CHOLMODSUPPORT_H +#define EIGEN_CHOLMODSUPPORT_H + +namespace Eigen { + +namespace internal { + +template struct cholmod_configure_matrix; + +template<> struct cholmod_configure_matrix { + template + static void run(CholmodType& mat) { + mat.xtype = CHOLMOD_REAL; + mat.dtype = CHOLMOD_DOUBLE; + } +}; + +template<> struct cholmod_configure_matrix > { + template + static void run(CholmodType& mat) { + mat.xtype = CHOLMOD_COMPLEX; + mat.dtype = CHOLMOD_DOUBLE; + } +}; + +// Other scalar types are not yet supported by Cholmod +// template<> struct cholmod_configure_matrix { +// template +// static void run(CholmodType& mat) { +// mat.xtype = CHOLMOD_REAL; +// mat.dtype = CHOLMOD_SINGLE; +// } +// }; +// +// template<> struct cholmod_configure_matrix > { +// template +// static void run(CholmodType& mat) { +// mat.xtype = CHOLMOD_COMPLEX; +// mat.dtype = CHOLMOD_SINGLE; +// } +// }; + +} // namespace internal + +/** Wraps the Eigen sparse matrix \a mat into a Cholmod sparse matrix object. + * Note that the data are shared. + */ +template +cholmod_sparse viewAsCholmod(Ref > mat) +{ + cholmod_sparse res; + res.nzmax = mat.nonZeros(); + res.nrow = mat.rows(); + res.ncol = mat.cols(); + res.p = mat.outerIndexPtr(); + res.i = mat.innerIndexPtr(); + res.x = mat.valuePtr(); + res.z = 0; + res.sorted = 1; + if(mat.isCompressed()) + { + res.packed = 1; + res.nz = 0; + } + else + { + res.packed = 0; + res.nz = mat.innerNonZeroPtr(); + } + + res.dtype = 0; + res.stype = -1; + + if (internal::is_same<_StorageIndex,int>::value) + { + res.itype = CHOLMOD_INT; + } + else if (internal::is_same<_StorageIndex,SuiteSparse_long>::value) + { + res.itype = CHOLMOD_LONG; + } + else + { + eigen_assert(false && "Index type not supported yet"); + } + + // setup res.xtype + internal::cholmod_configure_matrix<_Scalar>::run(res); + + res.stype = 0; + + return res; +} + +template +const cholmod_sparse viewAsCholmod(const SparseMatrix<_Scalar,_Options,_Index>& mat) +{ + cholmod_sparse res = viewAsCholmod(Ref >(mat.const_cast_derived())); + return res; +} + +template +const cholmod_sparse viewAsCholmod(const SparseVector<_Scalar,_Options,_Index>& mat) +{ + cholmod_sparse res = viewAsCholmod(Ref >(mat.const_cast_derived())); + return res; +} + +/** Returns a view of the Eigen sparse matrix \a mat as Cholmod sparse matrix. + * The data are not copied but shared. */ +template +cholmod_sparse viewAsCholmod(const SparseSelfAdjointView, UpLo>& mat) +{ + cholmod_sparse res = viewAsCholmod(Ref >(mat.matrix().const_cast_derived())); + + if(UpLo==Upper) res.stype = 1; + if(UpLo==Lower) res.stype = -1; + // swap stype for rowmajor matrices (only works for real matrices) + EIGEN_STATIC_ASSERT((_Options & RowMajorBit) == 0 || NumTraits<_Scalar>::IsComplex == 0, THIS_METHOD_IS_ONLY_FOR_COLUMN_MAJOR_MATRICES); + if(_Options & RowMajorBit) res.stype *=-1; + + return res; +} + +/** Returns a view of the Eigen \b dense matrix \a mat as Cholmod dense matrix. + * The data are not copied but shared. */ +template +cholmod_dense viewAsCholmod(MatrixBase& mat) +{ + EIGEN_STATIC_ASSERT((internal::traits::Flags&RowMajorBit)==0,THIS_METHOD_IS_ONLY_FOR_COLUMN_MAJOR_MATRICES); + typedef typename Derived::Scalar Scalar; + + cholmod_dense res; + res.nrow = mat.rows(); + res.ncol = mat.cols(); + res.nzmax = res.nrow * res.ncol; + res.d = Derived::IsVectorAtCompileTime ? mat.derived().size() : mat.derived().outerStride(); + res.x = (void*)(mat.derived().data()); + res.z = 0; + + internal::cholmod_configure_matrix::run(res); + + return res; +} + +/** Returns a view of the Cholmod sparse matrix \a cm as an Eigen sparse matrix. + * The data are not copied but shared. */ +template +MappedSparseMatrix viewAsEigen(cholmod_sparse& cm) +{ + return MappedSparseMatrix + (cm.nrow, cm.ncol, static_cast(cm.p)[cm.ncol], + static_cast(cm.p), static_cast(cm.i),static_cast(cm.x) ); +} + +namespace internal { + +// template specializations for int and long that call the correct cholmod method + +#define EIGEN_CHOLMOD_SPECIALIZE0(ret, name) \ + template inline ret cm_ ## name (cholmod_common &Common) { return cholmod_ ## name (&Common); } \ + template<> inline ret cm_ ## name (cholmod_common &Common) { return cholmod_l_ ## name (&Common); } + +#define EIGEN_CHOLMOD_SPECIALIZE1(ret, name, t1, a1) \ + template inline ret cm_ ## name (t1& a1, cholmod_common &Common) { return cholmod_ ## name (&a1, &Common); } \ + template<> inline ret cm_ ## name (t1& a1, cholmod_common &Common) { return cholmod_l_ ## name (&a1, &Common); } + +EIGEN_CHOLMOD_SPECIALIZE0(int, start) +EIGEN_CHOLMOD_SPECIALIZE0(int, finish) + +EIGEN_CHOLMOD_SPECIALIZE1(int, free_factor, cholmod_factor*, L) +EIGEN_CHOLMOD_SPECIALIZE1(int, free_dense, cholmod_dense*, X) +EIGEN_CHOLMOD_SPECIALIZE1(int, free_sparse, cholmod_sparse*, A) + +EIGEN_CHOLMOD_SPECIALIZE1(cholmod_factor*, analyze, cholmod_sparse, A) + +template inline cholmod_dense* cm_solve (int sys, cholmod_factor& L, cholmod_dense& B, cholmod_common &Common) { return cholmod_solve (sys, &L, &B, &Common); } +template<> inline cholmod_dense* cm_solve (int sys, cholmod_factor& L, cholmod_dense& B, cholmod_common &Common) { return cholmod_l_solve (sys, &L, &B, &Common); } + +template inline cholmod_sparse* cm_spsolve (int sys, cholmod_factor& L, cholmod_sparse& B, cholmod_common &Common) { return cholmod_spsolve (sys, &L, &B, &Common); } +template<> inline cholmod_sparse* cm_spsolve (int sys, cholmod_factor& L, cholmod_sparse& B, cholmod_common &Common) { return cholmod_l_spsolve (sys, &L, &B, &Common); } + +template +inline int cm_factorize_p (cholmod_sparse* A, double beta[2], _StorageIndex* fset, std::size_t fsize, cholmod_factor* L, cholmod_common &Common) { return cholmod_factorize_p (A, beta, fset, fsize, L, &Common); } +template<> +inline int cm_factorize_p (cholmod_sparse* A, double beta[2], SuiteSparse_long* fset, std::size_t fsize, cholmod_factor* L, cholmod_common &Common) { return cholmod_l_factorize_p (A, beta, fset, fsize, L, &Common); } + +#undef EIGEN_CHOLMOD_SPECIALIZE0 +#undef EIGEN_CHOLMOD_SPECIALIZE1 + +} // namespace internal + + +enum CholmodMode { + CholmodAuto, CholmodSimplicialLLt, CholmodSupernodalLLt, CholmodLDLt +}; + + +/** \ingroup CholmodSupport_Module + * \class CholmodBase + * \brief The base class for the direct Cholesky factorization of Cholmod + * \sa class CholmodSupernodalLLT, class CholmodSimplicialLDLT, class CholmodSimplicialLLT + */ +template +class CholmodBase : public SparseSolverBase +{ + protected: + typedef SparseSolverBase Base; + using Base::derived; + using Base::m_isInitialized; + public: + typedef _MatrixType MatrixType; + enum { UpLo = _UpLo }; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + typedef MatrixType CholMatrixType; + typedef typename MatrixType::StorageIndex StorageIndex; + enum { + ColsAtCompileTime = MatrixType::ColsAtCompileTime, + MaxColsAtCompileTime = MatrixType::MaxColsAtCompileTime + }; + + public: + + CholmodBase() + : m_cholmodFactor(0), m_info(Success), m_factorizationIsOk(false), m_analysisIsOk(false) + { + EIGEN_STATIC_ASSERT((internal::is_same::value), CHOLMOD_SUPPORTS_DOUBLE_PRECISION_ONLY); + m_shiftOffset[0] = m_shiftOffset[1] = 0.0; + internal::cm_start(m_cholmod); + } + + explicit CholmodBase(const MatrixType& matrix) + : m_cholmodFactor(0), m_info(Success), m_factorizationIsOk(false), m_analysisIsOk(false) + { + EIGEN_STATIC_ASSERT((internal::is_same::value), CHOLMOD_SUPPORTS_DOUBLE_PRECISION_ONLY); + m_shiftOffset[0] = m_shiftOffset[1] = 0.0; + internal::cm_start(m_cholmod); + compute(matrix); + } + + ~CholmodBase() + { + if(m_cholmodFactor) + internal::cm_free_factor(m_cholmodFactor, m_cholmod); + internal::cm_finish(m_cholmod); + } + + inline StorageIndex cols() const { return internal::convert_index(m_cholmodFactor->n); } + inline StorageIndex rows() const { return internal::convert_index(m_cholmodFactor->n); } + + /** \brief Reports whether previous computation was successful. + * + * \returns \c Success if computation was successful, + * \c NumericalIssue if the matrix.appears to be negative. + */ + ComputationInfo info() const + { + eigen_assert(m_isInitialized && "Decomposition is not initialized."); + return m_info; + } + + /** Computes the sparse Cholesky decomposition of \a matrix */ + Derived& compute(const MatrixType& matrix) + { + analyzePattern(matrix); + factorize(matrix); + return derived(); + } + + /** Performs a symbolic decomposition on the sparsity pattern of \a matrix. + * + * This function is particularly useful when solving for several problems having the same structure. + * + * \sa factorize() + */ + void analyzePattern(const MatrixType& matrix) + { + if(m_cholmodFactor) + { + internal::cm_free_factor(m_cholmodFactor, m_cholmod); + m_cholmodFactor = 0; + } + cholmod_sparse A = viewAsCholmod(matrix.template selfadjointView()); + m_cholmodFactor = internal::cm_analyze(A, m_cholmod); + + this->m_isInitialized = true; + this->m_info = Success; + m_analysisIsOk = true; + m_factorizationIsOk = false; + } + + /** Performs a numeric decomposition of \a matrix + * + * The given matrix must have the same sparsity pattern as the matrix on which the symbolic decomposition has been performed. + * + * \sa analyzePattern() + */ + void factorize(const MatrixType& matrix) + { + eigen_assert(m_analysisIsOk && "You must first call analyzePattern()"); + cholmod_sparse A = viewAsCholmod(matrix.template selfadjointView()); + internal::cm_factorize_p(&A, m_shiftOffset, 0, 0, m_cholmodFactor, m_cholmod); + + // If the factorization failed, minor is the column at which it did. On success minor == n. + this->m_info = (m_cholmodFactor->minor == m_cholmodFactor->n ? Success : NumericalIssue); + m_factorizationIsOk = true; + } + + /** Returns a reference to the Cholmod's configuration structure to get a full control over the performed operations. + * See the Cholmod user guide for details. */ + cholmod_common& cholmod() { return m_cholmod; } + + #ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal */ + template + void _solve_impl(const MatrixBase &b, MatrixBase &dest) const + { + eigen_assert(m_factorizationIsOk && "The decomposition is not in a valid state for solving, you must first call either compute() or symbolic()/numeric()"); + const Index size = m_cholmodFactor->n; + EIGEN_UNUSED_VARIABLE(size); + eigen_assert(size==b.rows()); + + // Cholmod needs column-major storage without inner-stride, which corresponds to the default behavior of Ref. + Ref > b_ref(b.derived()); + + cholmod_dense b_cd = viewAsCholmod(b_ref); + cholmod_dense* x_cd = internal::cm_solve(CHOLMOD_A, *m_cholmodFactor, b_cd, m_cholmod); + if(!x_cd) + { + this->m_info = NumericalIssue; + return; + } + // TODO optimize this copy by swapping when possible (be careful with alignment, etc.) + // NOTE Actually, the copy can be avoided by calling cholmod_solve2 instead of cholmod_solve + dest = Matrix::Map(reinterpret_cast(x_cd->x),b.rows(),b.cols()); + internal::cm_free_dense(x_cd, m_cholmod); + } + + /** \internal */ + template + void _solve_impl(const SparseMatrixBase &b, SparseMatrixBase &dest) const + { + eigen_assert(m_factorizationIsOk && "The decomposition is not in a valid state for solving, you must first call either compute() or symbolic()/numeric()"); + const Index size = m_cholmodFactor->n; + EIGEN_UNUSED_VARIABLE(size); + eigen_assert(size==b.rows()); + + // note: cs stands for Cholmod Sparse + Ref > b_ref(b.const_cast_derived()); + cholmod_sparse b_cs = viewAsCholmod(b_ref); + cholmod_sparse* x_cs = internal::cm_spsolve(CHOLMOD_A, *m_cholmodFactor, b_cs, m_cholmod); + if(!x_cs) + { + this->m_info = NumericalIssue; + return; + } + // TODO optimize this copy by swapping when possible (be careful with alignment, etc.) + // NOTE cholmod_spsolve in fact just calls the dense solver for blocks of 4 columns at a time (similar to Eigen's sparse solver) + dest.derived() = viewAsEigen(*x_cs); + internal::cm_free_sparse(x_cs, m_cholmod); + } + #endif // EIGEN_PARSED_BY_DOXYGEN + + + /** Sets the shift parameter that will be used to adjust the diagonal coefficients during the numerical factorization. + * + * During the numerical factorization, an offset term is added to the diagonal coefficients:\n + * \c d_ii = \a offset + \c d_ii + * + * The default is \a offset=0. + * + * \returns a reference to \c *this. + */ + Derived& setShift(const RealScalar& offset) + { + m_shiftOffset[0] = double(offset); + return derived(); + } + + /** \returns the determinant of the underlying matrix from the current factorization */ + Scalar determinant() const + { + using std::exp; + return exp(logDeterminant()); + } + + /** \returns the log determinant of the underlying matrix from the current factorization */ + Scalar logDeterminant() const + { + using std::log; + using numext::real; + eigen_assert(m_factorizationIsOk && "The decomposition is not in a valid state for solving, you must first call either compute() or symbolic()/numeric()"); + + RealScalar logDet = 0; + Scalar *x = static_cast(m_cholmodFactor->x); + if (m_cholmodFactor->is_super) + { + // Supernodal factorization stored as a packed list of dense column-major blocs, + // as described by the following structure: + + // super[k] == index of the first column of the j-th super node + StorageIndex *super = static_cast(m_cholmodFactor->super); + // pi[k] == offset to the description of row indices + StorageIndex *pi = static_cast(m_cholmodFactor->pi); + // px[k] == offset to the respective dense block + StorageIndex *px = static_cast(m_cholmodFactor->px); + + Index nb_super_nodes = m_cholmodFactor->nsuper; + for (Index k=0; k < nb_super_nodes; ++k) + { + StorageIndex ncols = super[k + 1] - super[k]; + StorageIndex nrows = pi[k + 1] - pi[k]; + + Map, 0, InnerStride<> > sk(x + px[k], ncols, InnerStride<>(nrows+1)); + logDet += sk.real().log().sum(); + } + } + else + { + // Simplicial factorization stored as standard CSC matrix. + StorageIndex *p = static_cast(m_cholmodFactor->p); + Index size = m_cholmodFactor->n; + for (Index k=0; kis_ll) + logDet *= 2.0; + return logDet; + }; + + template + void dumpMemory(Stream& /*s*/) + {} + + protected: + mutable cholmod_common m_cholmod; + cholmod_factor* m_cholmodFactor; + double m_shiftOffset[2]; + mutable ComputationInfo m_info; + int m_factorizationIsOk; + int m_analysisIsOk; +}; + +/** \ingroup CholmodSupport_Module + * \class CholmodSimplicialLLT + * \brief A simplicial direct Cholesky (LLT) factorization and solver based on Cholmod + * + * This class allows to solve for A.X = B sparse linear problems via a simplicial LL^T Cholesky factorization + * using the Cholmod library. + * This simplicial variant is equivalent to Eigen's built-in SimplicialLLT class. Therefore, it has little practical interest. + * The sparse matrix A must be selfadjoint and positive definite. The vectors or matrices + * X and B can be either dense or sparse. + * + * \tparam _MatrixType the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam _UpLo the triangular part that will be used for the computations. It can be Lower + * or Upper. Default is Lower. + * + * \implsparsesolverconcept + * + * This class supports all kind of SparseMatrix<>: row or column major; upper, lower, or both; compressed or non compressed. + * + * \warning Only double precision real and complex scalar types are supported by Cholmod. + * + * \sa \ref TutorialSparseSolverConcept, class CholmodSupernodalLLT, class SimplicialLLT + */ +template +class CholmodSimplicialLLT : public CholmodBase<_MatrixType, _UpLo, CholmodSimplicialLLT<_MatrixType, _UpLo> > +{ + typedef CholmodBase<_MatrixType, _UpLo, CholmodSimplicialLLT> Base; + using Base::m_cholmod; + + public: + + typedef _MatrixType MatrixType; + + CholmodSimplicialLLT() : Base() { init(); } + + CholmodSimplicialLLT(const MatrixType& matrix) : Base() + { + init(); + this->compute(matrix); + } + + ~CholmodSimplicialLLT() {} + protected: + void init() + { + m_cholmod.final_asis = 0; + m_cholmod.supernodal = CHOLMOD_SIMPLICIAL; + m_cholmod.final_ll = 1; + } +}; + + +/** \ingroup CholmodSupport_Module + * \class CholmodSimplicialLDLT + * \brief A simplicial direct Cholesky (LDLT) factorization and solver based on Cholmod + * + * This class allows to solve for A.X = B sparse linear problems via a simplicial LDL^T Cholesky factorization + * using the Cholmod library. + * This simplicial variant is equivalent to Eigen's built-in SimplicialLDLT class. Therefore, it has little practical interest. + * The sparse matrix A must be selfadjoint and positive definite. The vectors or matrices + * X and B can be either dense or sparse. + * + * \tparam _MatrixType the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam _UpLo the triangular part that will be used for the computations. It can be Lower + * or Upper. Default is Lower. + * + * \implsparsesolverconcept + * + * This class supports all kind of SparseMatrix<>: row or column major; upper, lower, or both; compressed or non compressed. + * + * \warning Only double precision real and complex scalar types are supported by Cholmod. + * + * \sa \ref TutorialSparseSolverConcept, class CholmodSupernodalLLT, class SimplicialLDLT + */ +template +class CholmodSimplicialLDLT : public CholmodBase<_MatrixType, _UpLo, CholmodSimplicialLDLT<_MatrixType, _UpLo> > +{ + typedef CholmodBase<_MatrixType, _UpLo, CholmodSimplicialLDLT> Base; + using Base::m_cholmod; + + public: + + typedef _MatrixType MatrixType; + + CholmodSimplicialLDLT() : Base() { init(); } + + CholmodSimplicialLDLT(const MatrixType& matrix) : Base() + { + init(); + this->compute(matrix); + } + + ~CholmodSimplicialLDLT() {} + protected: + void init() + { + m_cholmod.final_asis = 1; + m_cholmod.supernodal = CHOLMOD_SIMPLICIAL; + } +}; + +/** \ingroup CholmodSupport_Module + * \class CholmodSupernodalLLT + * \brief A supernodal Cholesky (LLT) factorization and solver based on Cholmod + * + * This class allows to solve for A.X = B sparse linear problems via a supernodal LL^T Cholesky factorization + * using the Cholmod library. + * This supernodal variant performs best on dense enough problems, e.g., 3D FEM, or very high order 2D FEM. + * The sparse matrix A must be selfadjoint and positive definite. The vectors or matrices + * X and B can be either dense or sparse. + * + * \tparam _MatrixType the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam _UpLo the triangular part that will be used for the computations. It can be Lower + * or Upper. Default is Lower. + * + * \implsparsesolverconcept + * + * This class supports all kind of SparseMatrix<>: row or column major; upper, lower, or both; compressed or non compressed. + * + * \warning Only double precision real and complex scalar types are supported by Cholmod. + * + * \sa \ref TutorialSparseSolverConcept + */ +template +class CholmodSupernodalLLT : public CholmodBase<_MatrixType, _UpLo, CholmodSupernodalLLT<_MatrixType, _UpLo> > +{ + typedef CholmodBase<_MatrixType, _UpLo, CholmodSupernodalLLT> Base; + using Base::m_cholmod; + + public: + + typedef _MatrixType MatrixType; + + CholmodSupernodalLLT() : Base() { init(); } + + CholmodSupernodalLLT(const MatrixType& matrix) : Base() + { + init(); + this->compute(matrix); + } + + ~CholmodSupernodalLLT() {} + protected: + void init() + { + m_cholmod.final_asis = 1; + m_cholmod.supernodal = CHOLMOD_SUPERNODAL; + } +}; + +/** \ingroup CholmodSupport_Module + * \class CholmodDecomposition + * \brief A general Cholesky factorization and solver based on Cholmod + * + * This class allows to solve for A.X = B sparse linear problems via a LL^T or LDL^T Cholesky factorization + * using the Cholmod library. The sparse matrix A must be selfadjoint and positive definite. The vectors or matrices + * X and B can be either dense or sparse. + * + * This variant permits to change the underlying Cholesky method at runtime. + * On the other hand, it does not provide access to the result of the factorization. + * The default is to let Cholmod automatically choose between a simplicial and supernodal factorization. + * + * \tparam _MatrixType the type of the sparse matrix A, it must be a SparseMatrix<> + * \tparam _UpLo the triangular part that will be used for the computations. It can be Lower + * or Upper. Default is Lower. + * + * \implsparsesolverconcept + * + * This class supports all kind of SparseMatrix<>: row or column major; upper, lower, or both; compressed or non compressed. + * + * \warning Only double precision real and complex scalar types are supported by Cholmod. + * + * \sa \ref TutorialSparseSolverConcept + */ +template +class CholmodDecomposition : public CholmodBase<_MatrixType, _UpLo, CholmodDecomposition<_MatrixType, _UpLo> > +{ + typedef CholmodBase<_MatrixType, _UpLo, CholmodDecomposition> Base; + using Base::m_cholmod; + + public: + + typedef _MatrixType MatrixType; + + CholmodDecomposition() : Base() { init(); } + + CholmodDecomposition(const MatrixType& matrix) : Base() + { + init(); + this->compute(matrix); + } + + ~CholmodDecomposition() {} + + void setMode(CholmodMode mode) + { + switch(mode) + { + case CholmodAuto: + m_cholmod.final_asis = 1; + m_cholmod.supernodal = CHOLMOD_AUTO; + break; + case CholmodSimplicialLLt: + m_cholmod.final_asis = 0; + m_cholmod.supernodal = CHOLMOD_SIMPLICIAL; + m_cholmod.final_ll = 1; + break; + case CholmodSupernodalLLt: + m_cholmod.final_asis = 1; + m_cholmod.supernodal = CHOLMOD_SUPERNODAL; + break; + case CholmodLDLt: + m_cholmod.final_asis = 1; + m_cholmod.supernodal = CHOLMOD_SIMPLICIAL; + break; + default: + break; + } + } + protected: + void init() + { + m_cholmod.final_asis = 1; + m_cholmod.supernodal = CHOLMOD_AUTO; + } +}; + +} // end namespace Eigen + +#endif // EIGEN_CHOLMODSUPPORT_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ArithmeticSequence.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ArithmeticSequence.h new file mode 100644 index 0000000..b6200fa --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ArithmeticSequence.h @@ -0,0 +1,413 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2017 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ARITHMETIC_SEQUENCE_H +#define EIGEN_ARITHMETIC_SEQUENCE_H + +namespace Eigen { + +namespace internal { + +#if (!EIGEN_HAS_CXX11) || !((!EIGEN_COMP_GNUC) || EIGEN_COMP_GNUC>=48) +template struct aseq_negate {}; + +template<> struct aseq_negate { + typedef Index type; +}; + +template struct aseq_negate > { + typedef FixedInt<-N> type; +}; + +// Compilation error in the following case: +template<> struct aseq_negate > {}; + +template::value, + bool SizeIsSymbolic =symbolic::is_symbolic::value> +struct aseq_reverse_first_type { + typedef Index type; +}; + +template +struct aseq_reverse_first_type { + typedef symbolic::AddExpr > >, + symbolic::ValueExpr > + > type; +}; + +template +struct aseq_reverse_first_type_aux { + typedef Index type; +}; + +template +struct aseq_reverse_first_type_aux::type> { + typedef FixedInt<(SizeType::value-1)*IncrType::value> type; +}; + +template +struct aseq_reverse_first_type { + typedef typename aseq_reverse_first_type_aux::type Aux; + typedef symbolic::AddExpr > type; +}; + +template +struct aseq_reverse_first_type { + typedef symbolic::AddExpr > >, + symbolic::ValueExpr >, + symbolic::ValueExpr<> > type; +}; +#endif + +// Helper to cleanup the type of the increment: +template struct cleanup_seq_incr { + typedef typename cleanup_index_type::type type; +}; + +} + +//-------------------------------------------------------------------------------- +// seq(first,last,incr) and seqN(first,size,incr) +//-------------------------------------------------------------------------------- + +template > +class ArithmeticSequence; + +template +ArithmeticSequence::type, + typename internal::cleanup_index_type::type, + typename internal::cleanup_seq_incr::type > +seqN(FirstType first, SizeType size, IncrType incr); + +/** \class ArithmeticSequence + * \ingroup Core_Module + * + * This class represents an arithmetic progression \f$ a_0, a_1, a_2, ..., a_{n-1}\f$ defined by + * its \em first value \f$ a_0 \f$, its \em size (aka length) \em n, and the \em increment (aka stride) + * that is equal to \f$ a_{i+1}-a_{i}\f$ for any \em i. + * + * It is internally used as the return type of the Eigen::seq and Eigen::seqN functions, and as the input arguments + * of DenseBase::operator()(const RowIndices&, const ColIndices&), and most of the time this is the + * only way it is used. + * + * \tparam FirstType type of the first element, usually an Index, + * but internally it can be a symbolic expression + * \tparam SizeType type representing the size of the sequence, usually an Index + * or a compile time integral constant. Internally, it can also be a symbolic expression + * \tparam IncrType type of the increment, can be a runtime Index, or a compile time integral constant (default is compile-time 1) + * + * \sa Eigen::seq, Eigen::seqN, DenseBase::operator()(const RowIndices&, const ColIndices&), class IndexedView + */ +template +class ArithmeticSequence +{ +public: + ArithmeticSequence(FirstType first, SizeType size) : m_first(first), m_size(size) {} + ArithmeticSequence(FirstType first, SizeType size, IncrType incr) : m_first(first), m_size(size), m_incr(incr) {} + + enum { + SizeAtCompileTime = internal::get_fixed_value::value, + IncrAtCompileTime = internal::get_fixed_value::value + }; + + /** \returns the size, i.e., number of elements, of the sequence */ + Index size() const { return m_size; } + + /** \returns the first element \f$ a_0 \f$ in the sequence */ + Index first() const { return m_first; } + + /** \returns the value \f$ a_i \f$ at index \a i in the sequence. */ + Index operator[](Index i) const { return m_first + i * m_incr; } + + const FirstType& firstObject() const { return m_first; } + const SizeType& sizeObject() const { return m_size; } + const IncrType& incrObject() const { return m_incr; } + +protected: + FirstType m_first; + SizeType m_size; + IncrType m_incr; + +public: + +#if EIGEN_HAS_CXX11 && ((!EIGEN_COMP_GNUC) || EIGEN_COMP_GNUC>=48) + auto reverse() const -> decltype(Eigen::seqN(m_first+(m_size+fix<-1>())*m_incr,m_size,-m_incr)) { + return seqN(m_first+(m_size+fix<-1>())*m_incr,m_size,-m_incr); + } +#else +protected: + typedef typename internal::aseq_negate::type ReverseIncrType; + typedef typename internal::aseq_reverse_first_type::type ReverseFirstType; +public: + ArithmeticSequence + reverse() const { + return seqN(m_first+(m_size+fix<-1>())*m_incr,m_size,-m_incr); + } +#endif +}; + +/** \returns an ArithmeticSequence starting at \a first, of length \a size, and increment \a incr + * + * \sa seqN(FirstType,SizeType), seq(FirstType,LastType,IncrType) */ +template +ArithmeticSequence::type,typename internal::cleanup_index_type::type,typename internal::cleanup_seq_incr::type > +seqN(FirstType first, SizeType size, IncrType incr) { + return ArithmeticSequence::type,typename internal::cleanup_index_type::type,typename internal::cleanup_seq_incr::type>(first,size,incr); +} + +/** \returns an ArithmeticSequence starting at \a first, of length \a size, and unit increment + * + * \sa seqN(FirstType,SizeType,IncrType), seq(FirstType,LastType) */ +template +ArithmeticSequence::type,typename internal::cleanup_index_type::type > +seqN(FirstType first, SizeType size) { + return ArithmeticSequence::type,typename internal::cleanup_index_type::type>(first,size); +} + +#ifdef EIGEN_PARSED_BY_DOXYGEN + +/** \returns an ArithmeticSequence starting at \a f, up (or down) to \a l, and with positive (or negative) increment \a incr + * + * It is essentially an alias to: + * \code + * seqN(f, (l-f+incr)/incr, incr); + * \endcode + * + * \sa seqN(FirstType,SizeType,IncrType), seq(FirstType,LastType) + */ +template +auto seq(FirstType f, LastType l, IncrType incr); + +/** \returns an ArithmeticSequence starting at \a f, up (or down) to \a l, and unit increment + * + * It is essentially an alias to: + * \code + * seqN(f,l-f+1); + * \endcode + * + * \sa seqN(FirstType,SizeType), seq(FirstType,LastType,IncrType) + */ +template +auto seq(FirstType f, LastType l); + +#else // EIGEN_PARSED_BY_DOXYGEN + +#if EIGEN_HAS_CXX11 +template +auto seq(FirstType f, LastType l) -> decltype(seqN(typename internal::cleanup_index_type::type(f), + ( typename internal::cleanup_index_type::type(l) + - typename internal::cleanup_index_type::type(f)+fix<1>()))) +{ + return seqN(typename internal::cleanup_index_type::type(f), + (typename internal::cleanup_index_type::type(l) + -typename internal::cleanup_index_type::type(f)+fix<1>())); +} + +template +auto seq(FirstType f, LastType l, IncrType incr) + -> decltype(seqN(typename internal::cleanup_index_type::type(f), + ( typename internal::cleanup_index_type::type(l) + - typename internal::cleanup_index_type::type(f)+typename internal::cleanup_seq_incr::type(incr) + ) / typename internal::cleanup_seq_incr::type(incr), + typename internal::cleanup_seq_incr::type(incr))) +{ + typedef typename internal::cleanup_seq_incr::type CleanedIncrType; + return seqN(typename internal::cleanup_index_type::type(f), + ( typename internal::cleanup_index_type::type(l) + -typename internal::cleanup_index_type::type(f)+CleanedIncrType(incr)) / CleanedIncrType(incr), + CleanedIncrType(incr)); +} + +#else // EIGEN_HAS_CXX11 + +template +typename internal::enable_if::value || symbolic::is_symbolic::value), + ArithmeticSequence::type,Index> >::type +seq(FirstType f, LastType l) +{ + return seqN(typename internal::cleanup_index_type::type(f), + Index((typename internal::cleanup_index_type::type(l)-typename internal::cleanup_index_type::type(f)+fix<1>()))); +} + +template +typename internal::enable_if::value, + ArithmeticSequence,symbolic::ValueExpr<> >, + symbolic::ValueExpr > > > >::type +seq(const symbolic::BaseExpr &f, LastType l) +{ + return seqN(f.derived(),(typename internal::cleanup_index_type::type(l)-f.derived()+fix<1>())); +} + +template +typename internal::enable_if::value, + ArithmeticSequence::type, + symbolic::AddExpr >, + symbolic::ValueExpr > > > >::type +seq(FirstType f, const symbolic::BaseExpr &l) +{ + return seqN(typename internal::cleanup_index_type::type(f),(l.derived()-typename internal::cleanup_index_type::type(f)+fix<1>())); +} + +template +ArithmeticSequence >,symbolic::ValueExpr > > > +seq(const symbolic::BaseExpr &f, const symbolic::BaseExpr &l) +{ + return seqN(f.derived(),(l.derived()-f.derived()+fix<1>())); +} + + +template +typename internal::enable_if::value || symbolic::is_symbolic::value), + ArithmeticSequence::type,Index,typename internal::cleanup_seq_incr::type> >::type +seq(FirstType f, LastType l, IncrType incr) +{ + typedef typename internal::cleanup_seq_incr::type CleanedIncrType; + return seqN(typename internal::cleanup_index_type::type(f), + Index((typename internal::cleanup_index_type::type(l)-typename internal::cleanup_index_type::type(f)+CleanedIncrType(incr))/CleanedIncrType(incr)), incr); +} + +template +typename internal::enable_if::value, + ArithmeticSequence, + symbolic::ValueExpr<> >, + symbolic::ValueExpr::type> >, + symbolic::ValueExpr::type> >, + typename internal::cleanup_seq_incr::type> >::type +seq(const symbolic::BaseExpr &f, LastType l, IncrType incr) +{ + typedef typename internal::cleanup_seq_incr::type CleanedIncrType; + return seqN(f.derived(),(typename internal::cleanup_index_type::type(l)-f.derived()+CleanedIncrType(incr))/CleanedIncrType(incr), incr); +} + +template +typename internal::enable_if::value, + ArithmeticSequence::type, + symbolic::QuotientExpr >, + symbolic::ValueExpr::type> >, + symbolic::ValueExpr::type> >, + typename internal::cleanup_seq_incr::type> >::type +seq(FirstType f, const symbolic::BaseExpr &l, IncrType incr) +{ + typedef typename internal::cleanup_seq_incr::type CleanedIncrType; + return seqN(typename internal::cleanup_index_type::type(f), + (l.derived()-typename internal::cleanup_index_type::type(f)+CleanedIncrType(incr))/CleanedIncrType(incr), incr); +} + +template +ArithmeticSequence >, + symbolic::ValueExpr::type> >, + symbolic::ValueExpr::type> >, + typename internal::cleanup_seq_incr::type> +seq(const symbolic::BaseExpr &f, const symbolic::BaseExpr &l, IncrType incr) +{ + typedef typename internal::cleanup_seq_incr::type CleanedIncrType; + return seqN(f.derived(),(l.derived()-f.derived()+CleanedIncrType(incr))/CleanedIncrType(incr), incr); +} +#endif // EIGEN_HAS_CXX11 + +#endif // EIGEN_PARSED_BY_DOXYGEN + + +#if EIGEN_HAS_CXX11 || defined(EIGEN_PARSED_BY_DOXYGEN) +/** \cpp11 + * \returns a symbolic ArithmeticSequence representing the last \a size elements with increment \a incr. + * + * It is a shortcut for: \code seqN(last-(size-fix<1>)*incr, size, incr) \endcode + * + * \sa lastN(SizeType), seqN(FirstType,SizeType), seq(FirstType,LastType,IncrType) */ +template +auto lastN(SizeType size, IncrType incr) +-> decltype(seqN(Eigen::last-(size-fix<1>())*incr, size, incr)) +{ + return seqN(Eigen::last-(size-fix<1>())*incr, size, incr); +} + +/** \cpp11 + * \returns a symbolic ArithmeticSequence representing the last \a size elements with a unit increment. + * + * It is a shortcut for: \code seq(last+fix<1>-size, last) \endcode + * + * \sa lastN(SizeType,IncrType, seqN(FirstType,SizeType), seq(FirstType,LastType) */ +template +auto lastN(SizeType size) +-> decltype(seqN(Eigen::last+fix<1>()-size, size)) +{ + return seqN(Eigen::last+fix<1>()-size, size); +} +#endif + +namespace internal { + +// Convert a symbolic span into a usable one (i.e., remove last/end "keywords") +template +struct make_size_type { + typedef typename internal::conditional::value, Index, T>::type type; +}; + +template +struct IndexedViewCompatibleType, XprSize> { + typedef ArithmeticSequence::type,IncrType> type; +}; + +template +ArithmeticSequence::type,IncrType> +makeIndexedViewCompatible(const ArithmeticSequence& ids, Index size,SpecializedType) { + return ArithmeticSequence::type,IncrType>( + eval_expr_given_size(ids.firstObject(),size),eval_expr_given_size(ids.sizeObject(),size),ids.incrObject()); +} + +template +struct get_compile_time_incr > { + enum { value = get_fixed_value::value }; +}; + +} // end namespace internal + +/** \namespace Eigen::indexing + * \ingroup Core_Module + * + * The sole purpose of this namespace is to be able to import all functions + * and symbols that are expected to be used within operator() for indexing + * and slicing. If you already imported the whole Eigen namespace: + * \code using namespace Eigen; \endcode + * then you are already all set. Otherwise, if you don't want/cannot import + * the whole Eigen namespace, the following line: + * \code using namespace Eigen::indexing; \endcode + * is equivalent to: + * \code + using Eigen::all; + using Eigen::seq; + using Eigen::seqN; + using Eigen::lastN; // c++11 only + using Eigen::last; + using Eigen::lastp1; + using Eigen::fix; + \endcode + */ +namespace indexing { + using Eigen::all; + using Eigen::seq; + using Eigen::seqN; + #if EIGEN_HAS_CXX11 + using Eigen::lastN; + #endif + using Eigen::last; + using Eigen::lastp1; + using Eigen::fix; +} + +} // end namespace Eigen + +#endif // EIGEN_ARITHMETIC_SEQUENCE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Array.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Array.h new file mode 100644 index 0000000..20c789b --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Array.h @@ -0,0 +1,417 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ARRAY_H +#define EIGEN_ARRAY_H + +namespace Eigen { + +namespace internal { +template +struct traits > : traits > +{ + typedef ArrayXpr XprKind; + typedef ArrayBase > XprBase; +}; +} + +/** \class Array + * \ingroup Core_Module + * + * \brief General-purpose arrays with easy API for coefficient-wise operations + * + * The %Array class is very similar to the Matrix class. It provides + * general-purpose one- and two-dimensional arrays. The difference between the + * %Array and the %Matrix class is primarily in the API: the API for the + * %Array class provides easy access to coefficient-wise operations, while the + * API for the %Matrix class provides easy access to linear-algebra + * operations. + * + * See documentation of class Matrix for detailed information on the template parameters + * storage layout. + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_ARRAY_PLUGIN. + * + * \sa \blank \ref TutorialArrayClass, \ref TopicClassHierarchy + */ +template +class Array + : public PlainObjectBase > +{ + public: + + typedef PlainObjectBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Array) + + enum { Options = _Options }; + typedef typename Base::PlainObject PlainObject; + + protected: + template + friend struct internal::conservative_resize_like_impl; + + using Base::m_storage; + + public: + + using Base::base; + using Base::coeff; + using Base::coeffRef; + + /** + * The usage of + * using Base::operator=; + * fails on MSVC. Since the code below is working with GCC and MSVC, we skipped + * the usage of 'using'. This should be done only for operator=. + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array& operator=(const EigenBase &other) + { + return Base::operator=(other); + } + + /** Set all the entries to \a value. + * \sa DenseBase::setConstant(), DenseBase::fill() + */ + /* This overload is needed because the usage of + * using Base::operator=; + * fails on MSVC. Since the code below is working with GCC and MSVC, we skipped + * the usage of 'using'. This should be done only for operator=. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array& operator=(const Scalar &value) + { + Base::setConstant(value); + return *this; + } + + /** Copies the value of the expression \a other into \c *this with automatic resizing. + * + * *this might be resized to match the dimensions of \a other. If *this was a null matrix (not already initialized), + * it will be initialized. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array& operator=(const DenseBase& other) + { + return Base::_set(other); + } + + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array& operator=(const Array& other) + { + return Base::_set(other); + } + + /** Default constructor. + * + * For fixed-size matrices, does nothing. + * + * For dynamic-size matrices, creates an empty matrix of size 0. Does not allocate any array. Such a matrix + * is called a null matrix. This constructor is the unique way to create null matrices: resizing + * a matrix to 0 is not supported. + * + * \sa resize(Index,Index) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array() : Base() + { + Base::_check_template_params(); + EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + // FIXME is it still needed ?? + /** \internal */ + EIGEN_DEVICE_FUNC + Array(internal::constructor_without_unaligned_array_assert) + : Base(internal::constructor_without_unaligned_array_assert()) + { + Base::_check_template_params(); + EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + } +#endif + +#if EIGEN_HAS_RVALUE_REFERENCES + EIGEN_DEVICE_FUNC + Array(Array&& other) EIGEN_NOEXCEPT_IF(std::is_nothrow_move_constructible::value) + : Base(std::move(other)) + { + Base::_check_template_params(); + } + EIGEN_DEVICE_FUNC + Array& operator=(Array&& other) EIGEN_NOEXCEPT_IF(std::is_nothrow_move_assignable::value) + { + Base::operator=(std::move(other)); + return *this; + } +#endif + + #if EIGEN_HAS_CXX11 + /** \copydoc PlainObjectBase(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + * + * Example: \include Array_variadic_ctor_cxx11.cpp + * Output: \verbinclude Array_variadic_ctor_cxx11.out + * + * \sa Array(const std::initializer_list>&) + * \sa Array(const Scalar&), Array(const Scalar&,const Scalar&) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + : Base(a0, a1, a2, a3, args...) {} + + /** \brief Constructs an array and initializes it from the coefficients given as initializer-lists grouped by row. \cpp11 + * + * In the general case, the constructor takes a list of rows, each row being represented as a list of coefficients: + * + * Example: \include Array_initializer_list_23_cxx11.cpp + * Output: \verbinclude Array_initializer_list_23_cxx11.out + * + * Each of the inner initializer lists must contain the exact same number of elements, otherwise an assertion is triggered. + * + * In the case of a compile-time column 1D array, implicit transposition from a single row is allowed. + * Therefore Array{{1,2,3,4,5}} is legal and the more verbose syntax + * Array{{1},{2},{3},{4},{5}} can be avoided: + * + * Example: \include Array_initializer_list_vector_cxx11.cpp + * Output: \verbinclude Array_initializer_list_vector_cxx11.out + * + * In the case of fixed-sized arrays, the initializer list sizes must exactly match the array sizes, + * and implicit transposition is allowed for compile-time 1D arrays only. + * + * \sa Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array(const std::initializer_list>& list) : Base(list) {} + #endif // end EIGEN_HAS_CXX11 + + #ifndef EIGEN_PARSED_BY_DOXYGEN + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE explicit Array(const T& x) + { + Base::_check_template_params(); + Base::template _init1(x); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array(const T0& val0, const T1& val1) + { + Base::_check_template_params(); + this->template _init2(val0, val1); + } + + #else + /** \brief Constructs a fixed-sized array initialized with coefficients starting at \a data */ + EIGEN_DEVICE_FUNC explicit Array(const Scalar *data); + /** Constructs a vector or row-vector with given dimension. \only_for_vectors + * + * Note that this is only useful for dynamic-size vectors. For fixed-size vectors, + * it is redundant to pass the dimension here, so it makes more sense to use the default + * constructor Array() instead. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE explicit Array(Index dim); + /** constructs an initialized 1x1 Array with the given coefficient + * \sa const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args */ + Array(const Scalar& value); + /** constructs an uninitialized array with \a rows rows and \a cols columns. + * + * This is useful for dynamic-size arrays. For fixed-size arrays, + * it is redundant to pass these parameters, so one should use the default constructor + * Array() instead. */ + Array(Index rows, Index cols); + /** constructs an initialized 2D vector with given coefficients + * \sa Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) */ + Array(const Scalar& val0, const Scalar& val1); + #endif // end EIGEN_PARSED_BY_DOXYGEN + + /** constructs an initialized 3D vector with given coefficients + * \sa Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array(const Scalar& val0, const Scalar& val1, const Scalar& val2) + { + Base::_check_template_params(); + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(Array, 3) + m_storage.data()[0] = val0; + m_storage.data()[1] = val1; + m_storage.data()[2] = val2; + } + /** constructs an initialized 4D vector with given coefficients + * \sa Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array(const Scalar& val0, const Scalar& val1, const Scalar& val2, const Scalar& val3) + { + Base::_check_template_params(); + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(Array, 4) + m_storage.data()[0] = val0; + m_storage.data()[1] = val1; + m_storage.data()[2] = val2; + m_storage.data()[3] = val3; + } + + /** Copy constructor */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array(const Array& other) + : Base(other) + { } + + private: + struct PrivateType {}; + public: + + /** \sa MatrixBase::operator=(const EigenBase&) */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array(const EigenBase &other, + typename internal::enable_if::value, + PrivateType>::type = PrivateType()) + : Base(other.derived()) + { } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT{ return 1; } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT { return this->innerSize(); } + + #ifdef EIGEN_ARRAY_PLUGIN + #include EIGEN_ARRAY_PLUGIN + #endif + + private: + + template + friend struct internal::matrix_swap_impl; +}; + +/** \defgroup arraytypedefs Global array typedefs + * \ingroup Core_Module + * + * %Eigen defines several typedef shortcuts for most common 1D and 2D array types. + * + * The general patterns are the following: + * + * \c ArrayRowsColsType where \c Rows and \c Cols can be \c 2,\c 3,\c 4 for fixed size square matrices or \c X for dynamic size, + * and where \c Type can be \c i for integer, \c f for float, \c d for double, \c cf for complex float, \c cd + * for complex double. + * + * For example, \c Array33d is a fixed-size 3x3 array type of doubles, and \c ArrayXXf is a dynamic-size matrix of floats. + * + * There are also \c ArraySizeType which are self-explanatory. For example, \c Array4cf is + * a fixed-size 1D array of 4 complex floats. + * + * With \cpp11, template alias are also defined for common sizes. + * They follow the same pattern as above except that the scalar type suffix is replaced by a + * template parameter, i.e.: + * - `ArrayRowsCols` where `Rows` and `Cols` can be \c 2,\c 3,\c 4, or \c X for fixed or dynamic size. + * - `ArraySize` where `Size` can be \c 2,\c 3,\c 4 or \c X for fixed or dynamic size 1D arrays. + * + * \sa class Array + */ + +#define EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, Size, SizeSuffix) \ +/** \ingroup arraytypedefs */ \ +typedef Array Array##SizeSuffix##SizeSuffix##TypeSuffix; \ +/** \ingroup arraytypedefs */ \ +typedef Array Array##SizeSuffix##TypeSuffix; + +#define EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Type, TypeSuffix, Size) \ +/** \ingroup arraytypedefs */ \ +typedef Array Array##Size##X##TypeSuffix; \ +/** \ingroup arraytypedefs */ \ +typedef Array Array##X##Size##TypeSuffix; + +#define EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(Type, TypeSuffix) \ +EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, 2, 2) \ +EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, 3, 3) \ +EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, 4, 4) \ +EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, Dynamic, X) \ +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Type, TypeSuffix, 2) \ +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Type, TypeSuffix, 3) \ +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Type, TypeSuffix, 4) + +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(int, i) +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(float, f) +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(double, d) +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(std::complex, cf) +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(std::complex, cd) + +#undef EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES +#undef EIGEN_MAKE_ARRAY_TYPEDEFS +#undef EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS + +#if EIGEN_HAS_CXX11 + +#define EIGEN_MAKE_ARRAY_TYPEDEFS(Size, SizeSuffix) \ +/** \ingroup arraytypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Array##SizeSuffix##SizeSuffix = Array; \ +/** \ingroup arraytypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Array##SizeSuffix = Array; + +#define EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Size) \ +/** \ingroup arraytypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Array##Size##X = Array; \ +/** \ingroup arraytypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Array##X##Size = Array; + +EIGEN_MAKE_ARRAY_TYPEDEFS(2, 2) +EIGEN_MAKE_ARRAY_TYPEDEFS(3, 3) +EIGEN_MAKE_ARRAY_TYPEDEFS(4, 4) +EIGEN_MAKE_ARRAY_TYPEDEFS(Dynamic, X) +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(2) +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(3) +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(4) + +#undef EIGEN_MAKE_ARRAY_TYPEDEFS +#undef EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS + +#endif // EIGEN_HAS_CXX11 + +#define EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, SizeSuffix) \ +using Eigen::Matrix##SizeSuffix##TypeSuffix; \ +using Eigen::Vector##SizeSuffix##TypeSuffix; \ +using Eigen::RowVector##SizeSuffix##TypeSuffix; + +#define EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(TypeSuffix) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, 2) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, 3) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, 4) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, X) \ + +#define EIGEN_USING_ARRAY_TYPEDEFS \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(i) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(f) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(d) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(cf) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(cd) + +} // end namespace Eigen + +#endif // EIGEN_ARRAY_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ArrayBase.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ArrayBase.h new file mode 100644 index 0000000..ea3dd1c --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ArrayBase.h @@ -0,0 +1,226 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ARRAYBASE_H +#define EIGEN_ARRAYBASE_H + +namespace Eigen { + +template class MatrixWrapper; + +/** \class ArrayBase + * \ingroup Core_Module + * + * \brief Base class for all 1D and 2D array, and related expressions + * + * An array is similar to a dense vector or matrix. While matrices are mathematical + * objects with well defined linear algebra operators, an array is just a collection + * of scalar values arranged in a one or two dimensionnal fashion. As the main consequence, + * all operations applied to an array are performed coefficient wise. Furthermore, + * arrays support scalar math functions of the c++ standard library (e.g., std::sin(x)), and convenient + * constructors allowing to easily write generic code working for both scalar values + * and arrays. + * + * This class is the base that is inherited by all array expression types. + * + * \tparam Derived is the derived type, e.g., an array or an expression type. + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_ARRAYBASE_PLUGIN. + * + * \sa class MatrixBase, \ref TopicClassHierarchy + */ +template class ArrayBase + : public DenseBase +{ + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** The base class for a given storage type. */ + typedef ArrayBase StorageBaseType; + + typedef ArrayBase Eigen_BaseClassForSpecializationOfGlobalMathFuncImpl; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + + typedef DenseBase Base; + using Base::RowsAtCompileTime; + using Base::ColsAtCompileTime; + using Base::SizeAtCompileTime; + using Base::MaxRowsAtCompileTime; + using Base::MaxColsAtCompileTime; + using Base::MaxSizeAtCompileTime; + using Base::IsVectorAtCompileTime; + using Base::Flags; + + using Base::derived; + using Base::const_cast_derived; + using Base::rows; + using Base::cols; + using Base::size; + using Base::coeff; + using Base::coeffRef; + using Base::lazyAssign; + using Base::operator-; + using Base::operator=; + using Base::operator+=; + using Base::operator-=; + using Base::operator*=; + using Base::operator/=; + + typedef typename Base::CoeffReturnType CoeffReturnType; + +#endif // not EIGEN_PARSED_BY_DOXYGEN + +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Base::PlainObject PlainObject; + + /** \internal Represents a matrix with all coefficients equal to one another*/ + typedef CwiseNullaryOp,PlainObject> ConstantReturnType; +#endif // not EIGEN_PARSED_BY_DOXYGEN + +#define EIGEN_CURRENT_STORAGE_BASE_CLASS Eigen::ArrayBase +#define EIGEN_DOC_UNARY_ADDONS(X,Y) +# include "../plugins/MatrixCwiseUnaryOps.h" +# include "../plugins/ArrayCwiseUnaryOps.h" +# include "../plugins/CommonCwiseBinaryOps.h" +# include "../plugins/MatrixCwiseBinaryOps.h" +# include "../plugins/ArrayCwiseBinaryOps.h" +# ifdef EIGEN_ARRAYBASE_PLUGIN +# include EIGEN_ARRAYBASE_PLUGIN +# endif +#undef EIGEN_CURRENT_STORAGE_BASE_CLASS +#undef EIGEN_DOC_UNARY_ADDONS + + /** Special case of the template operator=, in order to prevent the compiler + * from generating a default operator= (issue hit with g++ 4.1) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator=(const ArrayBase& other) + { + internal::call_assignment(derived(), other.derived()); + return derived(); + } + + /** Set all the entries to \a value. + * \sa DenseBase::setConstant(), DenseBase::fill() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator=(const Scalar &value) + { Base::setConstant(value); return derived(); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator+=(const Scalar& scalar); + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator-=(const Scalar& scalar); + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator+=(const ArrayBase& other); + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator-=(const ArrayBase& other); + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator*=(const ArrayBase& other); + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator/=(const ArrayBase& other); + + public: + EIGEN_DEVICE_FUNC + ArrayBase& array() { return *this; } + EIGEN_DEVICE_FUNC + const ArrayBase& array() const { return *this; } + + /** \returns an \link Eigen::MatrixBase Matrix \endlink expression of this array + * \sa MatrixBase::array() */ + EIGEN_DEVICE_FUNC + MatrixWrapper matrix() { return MatrixWrapper(derived()); } + EIGEN_DEVICE_FUNC + const MatrixWrapper matrix() const { return MatrixWrapper(derived()); } + +// template +// inline void evalTo(Dest& dst) const { dst = matrix(); } + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(ArrayBase) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(ArrayBase) + + private: + explicit ArrayBase(Index); + ArrayBase(Index,Index); + template explicit ArrayBase(const ArrayBase&); + protected: + // mixing arrays and matrices is not legal + template Derived& operator+=(const MatrixBase& ) + {EIGEN_STATIC_ASSERT(std::ptrdiff_t(sizeof(typename OtherDerived::Scalar))==-1,YOU_CANNOT_MIX_ARRAYS_AND_MATRICES); return *this;} + // mixing arrays and matrices is not legal + template Derived& operator-=(const MatrixBase& ) + {EIGEN_STATIC_ASSERT(std::ptrdiff_t(sizeof(typename OtherDerived::Scalar))==-1,YOU_CANNOT_MIX_ARRAYS_AND_MATRICES); return *this;} +}; + +/** replaces \c *this by \c *this - \a other. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived & +ArrayBase::operator-=(const ArrayBase &other) +{ + call_assignment(derived(), other.derived(), internal::sub_assign_op()); + return derived(); +} + +/** replaces \c *this by \c *this + \a other. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived & +ArrayBase::operator+=(const ArrayBase& other) +{ + call_assignment(derived(), other.derived(), internal::add_assign_op()); + return derived(); +} + +/** replaces \c *this by \c *this * \a other coefficient wise. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived & +ArrayBase::operator*=(const ArrayBase& other) +{ + call_assignment(derived(), other.derived(), internal::mul_assign_op()); + return derived(); +} + +/** replaces \c *this by \c *this / \a other coefficient wise. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived & +ArrayBase::operator/=(const ArrayBase& other) +{ + call_assignment(derived(), other.derived(), internal::div_assign_op()); + return derived(); +} + +} // end namespace Eigen + +#endif // EIGEN_ARRAYBASE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ArrayWrapper.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ArrayWrapper.h new file mode 100644 index 0000000..2e9555b --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ArrayWrapper.h @@ -0,0 +1,209 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ARRAYWRAPPER_H +#define EIGEN_ARRAYWRAPPER_H + +namespace Eigen { + +/** \class ArrayWrapper + * \ingroup Core_Module + * + * \brief Expression of a mathematical vector or matrix as an array object + * + * This class is the return type of MatrixBase::array(), and most of the time + * this is the only way it is use. + * + * \sa MatrixBase::array(), class MatrixWrapper + */ + +namespace internal { +template +struct traits > + : public traits::type > +{ + typedef ArrayXpr XprKind; + // Let's remove NestByRefBit + enum { + Flags0 = traits::type >::Flags, + LvalueBitFlag = is_lvalue::value ? LvalueBit : 0, + Flags = (Flags0 & ~(NestByRefBit | LvalueBit)) | LvalueBitFlag + }; +}; +} + +template +class ArrayWrapper : public ArrayBase > +{ + public: + typedef ArrayBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ArrayWrapper) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(ArrayWrapper) + typedef typename internal::remove_all::type NestedExpression; + + typedef typename internal::conditional< + internal::is_lvalue::value, + Scalar, + const Scalar + >::type ScalarWithConstIfNotLvalue; + + typedef typename internal::ref_selector::non_const_type NestedExpressionType; + + using Base::coeffRef; + + EIGEN_DEVICE_FUNC + explicit EIGEN_STRONG_INLINE ArrayWrapper(ExpressionType& matrix) : m_expression(matrix) {} + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return m_expression.rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return m_expression.cols(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT { return m_expression.outerStride(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT { return m_expression.innerStride(); } + + EIGEN_DEVICE_FUNC + inline ScalarWithConstIfNotLvalue* data() { return m_expression.data(); } + EIGEN_DEVICE_FUNC + inline const Scalar* data() const { return m_expression.data(); } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index rowId, Index colId) const + { + return m_expression.coeffRef(rowId, colId); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index index) const + { + return m_expression.coeffRef(index); + } + + template + EIGEN_DEVICE_FUNC + inline void evalTo(Dest& dst) const { dst = m_expression; } + + EIGEN_DEVICE_FUNC + const typename internal::remove_all::type& + nestedExpression() const + { + return m_expression; + } + + /** Forwards the resizing request to the nested expression + * \sa DenseBase::resize(Index) */ + EIGEN_DEVICE_FUNC + void resize(Index newSize) { m_expression.resize(newSize); } + /** Forwards the resizing request to the nested expression + * \sa DenseBase::resize(Index,Index)*/ + EIGEN_DEVICE_FUNC + void resize(Index rows, Index cols) { m_expression.resize(rows,cols); } + + protected: + NestedExpressionType m_expression; +}; + +/** \class MatrixWrapper + * \ingroup Core_Module + * + * \brief Expression of an array as a mathematical vector or matrix + * + * This class is the return type of ArrayBase::matrix(), and most of the time + * this is the only way it is use. + * + * \sa MatrixBase::matrix(), class ArrayWrapper + */ + +namespace internal { +template +struct traits > + : public traits::type > +{ + typedef MatrixXpr XprKind; + // Let's remove NestByRefBit + enum { + Flags0 = traits::type >::Flags, + LvalueBitFlag = is_lvalue::value ? LvalueBit : 0, + Flags = (Flags0 & ~(NestByRefBit | LvalueBit)) | LvalueBitFlag + }; +}; +} + +template +class MatrixWrapper : public MatrixBase > +{ + public: + typedef MatrixBase > Base; + EIGEN_DENSE_PUBLIC_INTERFACE(MatrixWrapper) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(MatrixWrapper) + typedef typename internal::remove_all::type NestedExpression; + + typedef typename internal::conditional< + internal::is_lvalue::value, + Scalar, + const Scalar + >::type ScalarWithConstIfNotLvalue; + + typedef typename internal::ref_selector::non_const_type NestedExpressionType; + + using Base::coeffRef; + + EIGEN_DEVICE_FUNC + explicit inline MatrixWrapper(ExpressionType& matrix) : m_expression(matrix) {} + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return m_expression.rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return m_expression.cols(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT { return m_expression.outerStride(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT { return m_expression.innerStride(); } + + EIGEN_DEVICE_FUNC + inline ScalarWithConstIfNotLvalue* data() { return m_expression.data(); } + EIGEN_DEVICE_FUNC + inline const Scalar* data() const { return m_expression.data(); } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index rowId, Index colId) const + { + return m_expression.derived().coeffRef(rowId, colId); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index index) const + { + return m_expression.coeffRef(index); + } + + EIGEN_DEVICE_FUNC + const typename internal::remove_all::type& + nestedExpression() const + { + return m_expression; + } + + /** Forwards the resizing request to the nested expression + * \sa DenseBase::resize(Index) */ + EIGEN_DEVICE_FUNC + void resize(Index newSize) { m_expression.resize(newSize); } + /** Forwards the resizing request to the nested expression + * \sa DenseBase::resize(Index,Index)*/ + EIGEN_DEVICE_FUNC + void resize(Index rows, Index cols) { m_expression.resize(rows,cols); } + + protected: + NestedExpressionType m_expression; +}; + +} // end namespace Eigen + +#endif // EIGEN_ARRAYWRAPPER_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Assign.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Assign.h new file mode 100644 index 0000000..655412e --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Assign.h @@ -0,0 +1,90 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007 Michael Olbrich +// Copyright (C) 2006-2010 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ASSIGN_H +#define EIGEN_ASSIGN_H + +namespace Eigen { + +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase + ::lazyAssign(const DenseBase& other) +{ + enum{ + SameType = internal::is_same::value + }; + + EIGEN_STATIC_ASSERT_LVALUE(Derived) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Derived,OtherDerived) + EIGEN_STATIC_ASSERT(SameType,YOU_MIXED_DIFFERENT_NUMERIC_TYPES__YOU_NEED_TO_USE_THE_CAST_METHOD_OF_MATRIXBASE_TO_CAST_NUMERIC_TYPES_EXPLICITLY) + + eigen_assert(rows() == other.rows() && cols() == other.cols()); + internal::call_assignment_no_alias(derived(),other.derived()); + + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE Derived& DenseBase::operator=(const DenseBase& other) +{ + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE Derived& DenseBase::operator=(const DenseBase& other) +{ + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE Derived& MatrixBase::operator=(const MatrixBase& other) +{ + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE Derived& MatrixBase::operator=(const DenseBase& other) +{ + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE Derived& MatrixBase::operator=(const EigenBase& other) +{ + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE Derived& MatrixBase::operator=(const ReturnByValue& other) +{ + other.derived().evalTo(derived()); + return derived(); +} + +} // end namespace Eigen + +#endif // EIGEN_ASSIGN_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/AssignEvaluator.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/AssignEvaluator.h new file mode 100644 index 0000000..7d76f0c --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/AssignEvaluator.h @@ -0,0 +1,1010 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2011 Benoit Jacob +// Copyright (C) 2011-2014 Gael Guennebaud +// Copyright (C) 2011-2012 Jitse Niesen +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ASSIGN_EVALUATOR_H +#define EIGEN_ASSIGN_EVALUATOR_H + +namespace Eigen { + +// This implementation is based on Assign.h + +namespace internal { + +/*************************************************************************** +* Part 1 : the logic deciding a strategy for traversal and unrolling * +***************************************************************************/ + +// copy_using_evaluator_traits is based on assign_traits + +template +struct copy_using_evaluator_traits +{ + typedef typename DstEvaluator::XprType Dst; + typedef typename Dst::Scalar DstScalar; + + enum { + DstFlags = DstEvaluator::Flags, + SrcFlags = SrcEvaluator::Flags + }; + +public: + enum { + DstAlignment = DstEvaluator::Alignment, + SrcAlignment = SrcEvaluator::Alignment, + DstHasDirectAccess = (DstFlags & DirectAccessBit) == DirectAccessBit, + JointAlignment = EIGEN_PLAIN_ENUM_MIN(DstAlignment,SrcAlignment) + }; + +private: + enum { + InnerSize = int(Dst::IsVectorAtCompileTime) ? int(Dst::SizeAtCompileTime) + : int(DstFlags)&RowMajorBit ? int(Dst::ColsAtCompileTime) + : int(Dst::RowsAtCompileTime), + InnerMaxSize = int(Dst::IsVectorAtCompileTime) ? int(Dst::MaxSizeAtCompileTime) + : int(DstFlags)&RowMajorBit ? int(Dst::MaxColsAtCompileTime) + : int(Dst::MaxRowsAtCompileTime), + RestrictedInnerSize = EIGEN_SIZE_MIN_PREFER_FIXED(InnerSize,MaxPacketSize), + RestrictedLinearSize = EIGEN_SIZE_MIN_PREFER_FIXED(Dst::SizeAtCompileTime,MaxPacketSize), + OuterStride = int(outer_stride_at_compile_time::ret), + MaxSizeAtCompileTime = Dst::SizeAtCompileTime + }; + + // TODO distinguish between linear traversal and inner-traversals + typedef typename find_best_packet::type LinearPacketType; + typedef typename find_best_packet::type InnerPacketType; + + enum { + LinearPacketSize = unpacket_traits::size, + InnerPacketSize = unpacket_traits::size + }; + +public: + enum { + LinearRequiredAlignment = unpacket_traits::alignment, + InnerRequiredAlignment = unpacket_traits::alignment + }; + +private: + enum { + DstIsRowMajor = DstFlags&RowMajorBit, + SrcIsRowMajor = SrcFlags&RowMajorBit, + StorageOrdersAgree = (int(DstIsRowMajor) == int(SrcIsRowMajor)), + MightVectorize = bool(StorageOrdersAgree) + && (int(DstFlags) & int(SrcFlags) & ActualPacketAccessBit) + && bool(functor_traits::PacketAccess), + MayInnerVectorize = MightVectorize + && int(InnerSize)!=Dynamic && int(InnerSize)%int(InnerPacketSize)==0 + && int(OuterStride)!=Dynamic && int(OuterStride)%int(InnerPacketSize)==0 + && (EIGEN_UNALIGNED_VECTORIZE || int(JointAlignment)>=int(InnerRequiredAlignment)), + MayLinearize = bool(StorageOrdersAgree) && (int(DstFlags) & int(SrcFlags) & LinearAccessBit), + MayLinearVectorize = bool(MightVectorize) && bool(MayLinearize) && bool(DstHasDirectAccess) + && (EIGEN_UNALIGNED_VECTORIZE || (int(DstAlignment)>=int(LinearRequiredAlignment)) || MaxSizeAtCompileTime == Dynamic), + /* If the destination isn't aligned, we have to do runtime checks and we don't unroll, + so it's only good for large enough sizes. */ + MaySliceVectorize = bool(MightVectorize) && bool(DstHasDirectAccess) + && (int(InnerMaxSize)==Dynamic || int(InnerMaxSize)>=(EIGEN_UNALIGNED_VECTORIZE?InnerPacketSize:(3*InnerPacketSize))) + /* slice vectorization can be slow, so we only want it if the slices are big, which is + indicated by InnerMaxSize rather than InnerSize, think of the case of a dynamic block + in a fixed-size matrix + However, with EIGEN_UNALIGNED_VECTORIZE and unrolling, slice vectorization is still worth it */ + }; + +public: + enum { + Traversal = int(Dst::SizeAtCompileTime) == 0 ? int(AllAtOnceTraversal) // If compile-size is zero, traversing will fail at compile-time. + : (int(MayLinearVectorize) && (LinearPacketSize>InnerPacketSize)) ? int(LinearVectorizedTraversal) + : int(MayInnerVectorize) ? int(InnerVectorizedTraversal) + : int(MayLinearVectorize) ? int(LinearVectorizedTraversal) + : int(MaySliceVectorize) ? int(SliceVectorizedTraversal) + : int(MayLinearize) ? int(LinearTraversal) + : int(DefaultTraversal), + Vectorized = int(Traversal) == InnerVectorizedTraversal + || int(Traversal) == LinearVectorizedTraversal + || int(Traversal) == SliceVectorizedTraversal + }; + + typedef typename conditional::type PacketType; + +private: + enum { + ActualPacketSize = int(Traversal)==LinearVectorizedTraversal ? LinearPacketSize + : Vectorized ? InnerPacketSize + : 1, + UnrollingLimit = EIGEN_UNROLLING_LIMIT * ActualPacketSize, + MayUnrollCompletely = int(Dst::SizeAtCompileTime) != Dynamic + && int(Dst::SizeAtCompileTime) * (int(DstEvaluator::CoeffReadCost)+int(SrcEvaluator::CoeffReadCost)) <= int(UnrollingLimit), + MayUnrollInner = int(InnerSize) != Dynamic + && int(InnerSize) * (int(DstEvaluator::CoeffReadCost)+int(SrcEvaluator::CoeffReadCost)) <= int(UnrollingLimit) + }; + +public: + enum { + Unrolling = (int(Traversal) == int(InnerVectorizedTraversal) || int(Traversal) == int(DefaultTraversal)) + ? ( + int(MayUnrollCompletely) ? int(CompleteUnrolling) + : int(MayUnrollInner) ? int(InnerUnrolling) + : int(NoUnrolling) + ) + : int(Traversal) == int(LinearVectorizedTraversal) + ? ( bool(MayUnrollCompletely) && ( EIGEN_UNALIGNED_VECTORIZE || (int(DstAlignment)>=int(LinearRequiredAlignment))) + ? int(CompleteUnrolling) + : int(NoUnrolling) ) + : int(Traversal) == int(LinearTraversal) + ? ( bool(MayUnrollCompletely) ? int(CompleteUnrolling) + : int(NoUnrolling) ) +#if EIGEN_UNALIGNED_VECTORIZE + : int(Traversal) == int(SliceVectorizedTraversal) + ? ( bool(MayUnrollInner) ? int(InnerUnrolling) + : int(NoUnrolling) ) +#endif + : int(NoUnrolling) + }; + +#ifdef EIGEN_DEBUG_ASSIGN + static void debug() + { + std::cerr << "DstXpr: " << typeid(typename DstEvaluator::XprType).name() << std::endl; + std::cerr << "SrcXpr: " << typeid(typename SrcEvaluator::XprType).name() << std::endl; + std::cerr.setf(std::ios::hex, std::ios::basefield); + std::cerr << "DstFlags" << " = " << DstFlags << " (" << demangle_flags(DstFlags) << " )" << std::endl; + std::cerr << "SrcFlags" << " = " << SrcFlags << " (" << demangle_flags(SrcFlags) << " )" << std::endl; + std::cerr.unsetf(std::ios::hex); + EIGEN_DEBUG_VAR(DstAlignment) + EIGEN_DEBUG_VAR(SrcAlignment) + EIGEN_DEBUG_VAR(LinearRequiredAlignment) + EIGEN_DEBUG_VAR(InnerRequiredAlignment) + EIGEN_DEBUG_VAR(JointAlignment) + EIGEN_DEBUG_VAR(InnerSize) + EIGEN_DEBUG_VAR(InnerMaxSize) + EIGEN_DEBUG_VAR(LinearPacketSize) + EIGEN_DEBUG_VAR(InnerPacketSize) + EIGEN_DEBUG_VAR(ActualPacketSize) + EIGEN_DEBUG_VAR(StorageOrdersAgree) + EIGEN_DEBUG_VAR(MightVectorize) + EIGEN_DEBUG_VAR(MayLinearize) + EIGEN_DEBUG_VAR(MayInnerVectorize) + EIGEN_DEBUG_VAR(MayLinearVectorize) + EIGEN_DEBUG_VAR(MaySliceVectorize) + std::cerr << "Traversal" << " = " << Traversal << " (" << demangle_traversal(Traversal) << ")" << std::endl; + EIGEN_DEBUG_VAR(SrcEvaluator::CoeffReadCost) + EIGEN_DEBUG_VAR(DstEvaluator::CoeffReadCost) + EIGEN_DEBUG_VAR(Dst::SizeAtCompileTime) + EIGEN_DEBUG_VAR(UnrollingLimit) + EIGEN_DEBUG_VAR(MayUnrollCompletely) + EIGEN_DEBUG_VAR(MayUnrollInner) + std::cerr << "Unrolling" << " = " << Unrolling << " (" << demangle_unrolling(Unrolling) << ")" << std::endl; + std::cerr << std::endl; + } +#endif +}; + +/*************************************************************************** +* Part 2 : meta-unrollers +***************************************************************************/ + +/************************ +*** Default traversal *** +************************/ + +template +struct copy_using_evaluator_DefaultTraversal_CompleteUnrolling +{ + // FIXME: this is not very clean, perhaps this information should be provided by the kernel? + typedef typename Kernel::DstEvaluatorType DstEvaluatorType; + typedef typename DstEvaluatorType::XprType DstXprType; + + enum { + outer = Index / DstXprType::InnerSizeAtCompileTime, + inner = Index % DstXprType::InnerSizeAtCompileTime + }; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + kernel.assignCoeffByOuterInner(outer, inner); + copy_using_evaluator_DefaultTraversal_CompleteUnrolling::run(kernel); + } +}; + +template +struct copy_using_evaluator_DefaultTraversal_CompleteUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel&) { } +}; + +template +struct copy_using_evaluator_DefaultTraversal_InnerUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel, Index outer) + { + kernel.assignCoeffByOuterInner(outer, Index_); + copy_using_evaluator_DefaultTraversal_InnerUnrolling::run(kernel, outer); + } +}; + +template +struct copy_using_evaluator_DefaultTraversal_InnerUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel&, Index) { } +}; + +/*********************** +*** Linear traversal *** +***********************/ + +template +struct copy_using_evaluator_LinearTraversal_CompleteUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel& kernel) + { + kernel.assignCoeff(Index); + copy_using_evaluator_LinearTraversal_CompleteUnrolling::run(kernel); + } +}; + +template +struct copy_using_evaluator_LinearTraversal_CompleteUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel&) { } +}; + +/************************** +*** Inner vectorization *** +**************************/ + +template +struct copy_using_evaluator_innervec_CompleteUnrolling +{ + // FIXME: this is not very clean, perhaps this information should be provided by the kernel? + typedef typename Kernel::DstEvaluatorType DstEvaluatorType; + typedef typename DstEvaluatorType::XprType DstXprType; + typedef typename Kernel::PacketType PacketType; + + enum { + outer = Index / DstXprType::InnerSizeAtCompileTime, + inner = Index % DstXprType::InnerSizeAtCompileTime, + SrcAlignment = Kernel::AssignmentTraits::SrcAlignment, + DstAlignment = Kernel::AssignmentTraits::DstAlignment + }; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + kernel.template assignPacketByOuterInner(outer, inner); + enum { NextIndex = Index + unpacket_traits::size }; + copy_using_evaluator_innervec_CompleteUnrolling::run(kernel); + } +}; + +template +struct copy_using_evaluator_innervec_CompleteUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel&) { } +}; + +template +struct copy_using_evaluator_innervec_InnerUnrolling +{ + typedef typename Kernel::PacketType PacketType; + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel, Index outer) + { + kernel.template assignPacketByOuterInner(outer, Index_); + enum { NextIndex = Index_ + unpacket_traits::size }; + copy_using_evaluator_innervec_InnerUnrolling::run(kernel, outer); + } +}; + +template +struct copy_using_evaluator_innervec_InnerUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &, Index) { } +}; + +/*************************************************************************** +* Part 3 : implementation of all cases +***************************************************************************/ + +// dense_assignment_loop is based on assign_impl + +template +struct dense_assignment_loop; + +/************************ +***** Special Cases ***** +************************/ + +// Zero-sized assignment is a no-op. +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static void EIGEN_STRONG_INLINE run(Kernel& /*kernel*/) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + EIGEN_STATIC_ASSERT(int(DstXprType::SizeAtCompileTime) == 0, + EIGEN_INTERNAL_ERROR_PLEASE_FILE_A_BUG_REPORT) + } +}; + +/************************ +*** Default traversal *** +************************/ + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static void EIGEN_STRONG_INLINE run(Kernel &kernel) + { + for(Index outer = 0; outer < kernel.outerSize(); ++outer) { + for(Index inner = 0; inner < kernel.innerSize(); ++inner) { + kernel.assignCoeffByOuterInner(outer, inner); + } + } + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + copy_using_evaluator_DefaultTraversal_CompleteUnrolling::run(kernel); + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + + const Index outerSize = kernel.outerSize(); + for(Index outer = 0; outer < outerSize; ++outer) + copy_using_evaluator_DefaultTraversal_InnerUnrolling::run(kernel, outer); + } +}; + +/*************************** +*** Linear vectorization *** +***************************/ + + +// The goal of unaligned_dense_assignment_loop is simply to factorize the handling +// of the non vectorizable beginning and ending parts + +template +struct unaligned_dense_assignment_loop +{ + // if IsAligned = true, then do nothing + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel&, Index, Index) {} +}; + +template <> +struct unaligned_dense_assignment_loop +{ + // MSVC must not inline this functions. If it does, it fails to optimize the + // packet access path. + // FIXME check which version exhibits this issue +#if EIGEN_COMP_MSVC + template + static EIGEN_DONT_INLINE void run(Kernel &kernel, + Index start, + Index end) +#else + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel, + Index start, + Index end) +#endif + { + for (Index index = start; index < end; ++index) + kernel.assignCoeff(index); + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + const Index size = kernel.size(); + typedef typename Kernel::Scalar Scalar; + typedef typename Kernel::PacketType PacketType; + enum { + requestedAlignment = Kernel::AssignmentTraits::LinearRequiredAlignment, + packetSize = unpacket_traits::size, + dstIsAligned = int(Kernel::AssignmentTraits::DstAlignment)>=int(requestedAlignment), + dstAlignment = packet_traits::AlignedOnScalar ? int(requestedAlignment) + : int(Kernel::AssignmentTraits::DstAlignment), + srcAlignment = Kernel::AssignmentTraits::JointAlignment + }; + const Index alignedStart = dstIsAligned ? 0 : internal::first_aligned(kernel.dstDataPtr(), size); + const Index alignedEnd = alignedStart + ((size-alignedStart)/packetSize)*packetSize; + + unaligned_dense_assignment_loop::run(kernel, 0, alignedStart); + + for(Index index = alignedStart; index < alignedEnd; index += packetSize) + kernel.template assignPacket(index); + + unaligned_dense_assignment_loop<>::run(kernel, alignedEnd, size); + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + typedef typename Kernel::PacketType PacketType; + + enum { size = DstXprType::SizeAtCompileTime, + packetSize =unpacket_traits::size, + alignedSize = (int(size)/packetSize)*packetSize }; + + copy_using_evaluator_innervec_CompleteUnrolling::run(kernel); + copy_using_evaluator_DefaultTraversal_CompleteUnrolling::run(kernel); + } +}; + +/************************** +*** Inner vectorization *** +**************************/ + +template +struct dense_assignment_loop +{ + typedef typename Kernel::PacketType PacketType; + enum { + SrcAlignment = Kernel::AssignmentTraits::SrcAlignment, + DstAlignment = Kernel::AssignmentTraits::DstAlignment + }; + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + const Index innerSize = kernel.innerSize(); + const Index outerSize = kernel.outerSize(); + const Index packetSize = unpacket_traits::size; + for(Index outer = 0; outer < outerSize; ++outer) + for(Index inner = 0; inner < innerSize; inner+=packetSize) + kernel.template assignPacketByOuterInner(outer, inner); + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + copy_using_evaluator_innervec_CompleteUnrolling::run(kernel); + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + typedef typename Kernel::AssignmentTraits Traits; + const Index outerSize = kernel.outerSize(); + for(Index outer = 0; outer < outerSize; ++outer) + copy_using_evaluator_innervec_InnerUnrolling::run(kernel, outer); + } +}; + +/*********************** +*** Linear traversal *** +***********************/ + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + const Index size = kernel.size(); + for(Index i = 0; i < size; ++i) + kernel.assignCoeff(i); + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + copy_using_evaluator_LinearTraversal_CompleteUnrolling::run(kernel); + } +}; + +/************************** +*** Slice vectorization *** +***************************/ + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::Scalar Scalar; + typedef typename Kernel::PacketType PacketType; + enum { + packetSize = unpacket_traits::size, + requestedAlignment = int(Kernel::AssignmentTraits::InnerRequiredAlignment), + alignable = packet_traits::AlignedOnScalar || int(Kernel::AssignmentTraits::DstAlignment)>=sizeof(Scalar), + dstIsAligned = int(Kernel::AssignmentTraits::DstAlignment)>=int(requestedAlignment), + dstAlignment = alignable ? int(requestedAlignment) + : int(Kernel::AssignmentTraits::DstAlignment) + }; + const Scalar *dst_ptr = kernel.dstDataPtr(); + if((!bool(dstIsAligned)) && (UIntPtr(dst_ptr) % sizeof(Scalar))>0) + { + // the pointer is not aligned-on scalar, so alignment is not possible + return dense_assignment_loop::run(kernel); + } + const Index packetAlignedMask = packetSize - 1; + const Index innerSize = kernel.innerSize(); + const Index outerSize = kernel.outerSize(); + const Index alignedStep = alignable ? (packetSize - kernel.outerStride() % packetSize) & packetAlignedMask : 0; + Index alignedStart = ((!alignable) || bool(dstIsAligned)) ? 0 : internal::first_aligned(dst_ptr, innerSize); + + for(Index outer = 0; outer < outerSize; ++outer) + { + const Index alignedEnd = alignedStart + ((innerSize-alignedStart) & ~packetAlignedMask); + // do the non-vectorizable part of the assignment + for(Index inner = 0; inner(outer, inner); + + // do the non-vectorizable part of the assignment + for(Index inner = alignedEnd; inner +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + typedef typename Kernel::PacketType PacketType; + + enum { innerSize = DstXprType::InnerSizeAtCompileTime, + packetSize =unpacket_traits::size, + vectorizableSize = (int(innerSize) / int(packetSize)) * int(packetSize), + size = DstXprType::SizeAtCompileTime }; + + for(Index outer = 0; outer < kernel.outerSize(); ++outer) + { + copy_using_evaluator_innervec_InnerUnrolling::run(kernel, outer); + copy_using_evaluator_DefaultTraversal_InnerUnrolling::run(kernel, outer); + } + } +}; +#endif + + +/*************************************************************************** +* Part 4 : Generic dense assignment kernel +***************************************************************************/ + +// This class generalize the assignment of a coefficient (or packet) from one dense evaluator +// to another dense writable evaluator. +// It is parametrized by the two evaluators, and the actual assignment functor. +// This abstraction level permits to keep the evaluation loops as simple and as generic as possible. +// One can customize the assignment using this generic dense_assignment_kernel with different +// functors, or by completely overloading it, by-passing a functor. +template +class generic_dense_assignment_kernel +{ +protected: + typedef typename DstEvaluatorTypeT::XprType DstXprType; + typedef typename SrcEvaluatorTypeT::XprType SrcXprType; +public: + + typedef DstEvaluatorTypeT DstEvaluatorType; + typedef SrcEvaluatorTypeT SrcEvaluatorType; + typedef typename DstEvaluatorType::Scalar Scalar; + typedef copy_using_evaluator_traits AssignmentTraits; + typedef typename AssignmentTraits::PacketType PacketType; + + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + generic_dense_assignment_kernel(DstEvaluatorType &dst, const SrcEvaluatorType &src, const Functor &func, DstXprType& dstExpr) + : m_dst(dst), m_src(src), m_functor(func), m_dstExpr(dstExpr) + { + #ifdef EIGEN_DEBUG_ASSIGN + AssignmentTraits::debug(); + #endif + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index size() const EIGEN_NOEXCEPT { return m_dstExpr.size(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index innerSize() const EIGEN_NOEXCEPT { return m_dstExpr.innerSize(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index outerSize() const EIGEN_NOEXCEPT { return m_dstExpr.outerSize(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index rows() const EIGEN_NOEXCEPT { return m_dstExpr.rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index cols() const EIGEN_NOEXCEPT { return m_dstExpr.cols(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index outerStride() const EIGEN_NOEXCEPT { return m_dstExpr.outerStride(); } + + EIGEN_DEVICE_FUNC DstEvaluatorType& dstEvaluator() EIGEN_NOEXCEPT { return m_dst; } + EIGEN_DEVICE_FUNC const SrcEvaluatorType& srcEvaluator() const EIGEN_NOEXCEPT { return m_src; } + + /// Assign src(row,col) to dst(row,col) through the assignment functor. + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignCoeff(Index row, Index col) + { + m_functor.assignCoeff(m_dst.coeffRef(row,col), m_src.coeff(row,col)); + } + + /// \sa assignCoeff(Index,Index) + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignCoeff(Index index) + { + m_functor.assignCoeff(m_dst.coeffRef(index), m_src.coeff(index)); + } + + /// \sa assignCoeff(Index,Index) + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignCoeffByOuterInner(Index outer, Index inner) + { + Index row = rowIndexByOuterInner(outer, inner); + Index col = colIndexByOuterInner(outer, inner); + assignCoeff(row, col); + } + + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignPacket(Index row, Index col) + { + m_functor.template assignPacket(&m_dst.coeffRef(row,col), m_src.template packet(row,col)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignPacket(Index index) + { + m_functor.template assignPacket(&m_dst.coeffRef(index), m_src.template packet(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignPacketByOuterInner(Index outer, Index inner) + { + Index row = rowIndexByOuterInner(outer, inner); + Index col = colIndexByOuterInner(outer, inner); + assignPacket(row, col); + } + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Index rowIndexByOuterInner(Index outer, Index inner) + { + typedef typename DstEvaluatorType::ExpressionTraits Traits; + return int(Traits::RowsAtCompileTime) == 1 ? 0 + : int(Traits::ColsAtCompileTime) == 1 ? inner + : int(DstEvaluatorType::Flags)&RowMajorBit ? outer + : inner; + } + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Index colIndexByOuterInner(Index outer, Index inner) + { + typedef typename DstEvaluatorType::ExpressionTraits Traits; + return int(Traits::ColsAtCompileTime) == 1 ? 0 + : int(Traits::RowsAtCompileTime) == 1 ? inner + : int(DstEvaluatorType::Flags)&RowMajorBit ? inner + : outer; + } + + EIGEN_DEVICE_FUNC const Scalar* dstDataPtr() const + { + return m_dstExpr.data(); + } + +protected: + DstEvaluatorType& m_dst; + const SrcEvaluatorType& m_src; + const Functor &m_functor; + // TODO find a way to avoid the needs of the original expression + DstXprType& m_dstExpr; +}; + +// Special kernel used when computing small products whose operands have dynamic dimensions. It ensures that the +// PacketSize used is no larger than 4, thereby increasing the chance that vectorized instructions will be used +// when computing the product. + +template +class restricted_packet_dense_assignment_kernel : public generic_dense_assignment_kernel +{ +protected: + typedef generic_dense_assignment_kernel Base; + public: + typedef typename Base::Scalar Scalar; + typedef typename Base::DstXprType DstXprType; + typedef copy_using_evaluator_traits AssignmentTraits; + typedef typename AssignmentTraits::PacketType PacketType; + + EIGEN_DEVICE_FUNC restricted_packet_dense_assignment_kernel(DstEvaluatorTypeT &dst, const SrcEvaluatorTypeT &src, const Functor &func, DstXprType& dstExpr) + : Base(dst, src, func, dstExpr) + { + } + }; + +/*************************************************************************** +* Part 5 : Entry point for dense rectangular assignment +***************************************************************************/ + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void resize_if_allowed(DstXprType &dst, const SrcXprType& src, const Functor &/*func*/) +{ + EIGEN_ONLY_USED_FOR_DEBUG(dst); + EIGEN_ONLY_USED_FOR_DEBUG(src); + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void resize_if_allowed(DstXprType &dst, const SrcXprType& src, const internal::assign_op &/*func*/) +{ + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if(((dst.rows()!=dstRows) || (dst.cols()!=dstCols))) + dst.resize(dstRows, dstCols); + eigen_assert(dst.rows() == dstRows && dst.cols() == dstCols); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void call_dense_assignment_loop(DstXprType& dst, const SrcXprType& src, const Functor &func) +{ + typedef evaluator DstEvaluatorType; + typedef evaluator SrcEvaluatorType; + + SrcEvaluatorType srcEvaluator(src); + + // NOTE To properly handle A = (A*A.transpose())/s with A rectangular, + // we need to resize the destination after the source evaluator has been created. + resize_if_allowed(dst, src, func); + + DstEvaluatorType dstEvaluator(dst); + + typedef generic_dense_assignment_kernel Kernel; + Kernel kernel(dstEvaluator, srcEvaluator, func, dst.const_cast_derived()); + + dense_assignment_loop::run(kernel); +} + +// Specialization for filling the destination with a constant value. +#ifndef EIGEN_GPU_COMPILE_PHASE +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void call_dense_assignment_loop(DstXprType& dst, const Eigen::CwiseNullaryOp, DstXprType>& src, const internal::assign_op& func) +{ + resize_if_allowed(dst, src, func); + std::fill_n(dst.data(), dst.size(), src.functor()()); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void call_dense_assignment_loop(DstXprType& dst, const SrcXprType& src) +{ + call_dense_assignment_loop(dst, src, internal::assign_op()); +} + +/*************************************************************************** +* Part 6 : Generic assignment +***************************************************************************/ + +// Based on the respective shapes of the destination and source, +// the class AssignmentKind determine the kind of assignment mechanism. +// AssignmentKind must define a Kind typedef. +template struct AssignmentKind; + +// Assignment kind defined in this file: +struct Dense2Dense {}; +struct EigenBase2EigenBase {}; + +template struct AssignmentKind { typedef EigenBase2EigenBase Kind; }; +template<> struct AssignmentKind { typedef Dense2Dense Kind; }; + +// This is the main assignment class +template< typename DstXprType, typename SrcXprType, typename Functor, + typename Kind = typename AssignmentKind< typename evaluator_traits::Shape , typename evaluator_traits::Shape >::Kind, + typename EnableIf = void> +struct Assignment; + + +// The only purpose of this call_assignment() function is to deal with noalias() / "assume-aliasing" and automatic transposition. +// Indeed, I (Gael) think that this concept of "assume-aliasing" was a mistake, and it makes thing quite complicated. +// So this intermediate function removes everything related to "assume-aliasing" such that Assignment +// does not has to bother about these annoying details. + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment(Dst& dst, const Src& src) +{ + call_assignment(dst, src, internal::assign_op()); +} +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment(const Dst& dst, const Src& src) +{ + call_assignment(dst, src, internal::assign_op()); +} + +// Deal with "assume-aliasing" +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment(Dst& dst, const Src& src, const Func& func, typename enable_if< evaluator_assume_aliasing::value, void*>::type = 0) +{ + typename plain_matrix_type::type tmp(src); + call_assignment_no_alias(dst, tmp, func); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment(Dst& dst, const Src& src, const Func& func, typename enable_if::value, void*>::type = 0) +{ + call_assignment_no_alias(dst, src, func); +} + +// by-pass "assume-aliasing" +// When there is no aliasing, we require that 'dst' has been properly resized +template class StorageBase, typename Src, typename Func> +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment(NoAlias& dst, const Src& src, const Func& func) +{ + call_assignment_no_alias(dst.expression(), src, func); +} + + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment_no_alias(Dst& dst, const Src& src, const Func& func) +{ + enum { + NeedToTranspose = ( (int(Dst::RowsAtCompileTime) == 1 && int(Src::ColsAtCompileTime) == 1) + || (int(Dst::ColsAtCompileTime) == 1 && int(Src::RowsAtCompileTime) == 1) + ) && int(Dst::SizeAtCompileTime) != 1 + }; + + typedef typename internal::conditional, Dst>::type ActualDstTypeCleaned; + typedef typename internal::conditional, Dst&>::type ActualDstType; + ActualDstType actualDst(dst); + + // TODO check whether this is the right place to perform these checks: + EIGEN_STATIC_ASSERT_LVALUE(Dst) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(ActualDstTypeCleaned,Src) + EIGEN_CHECK_BINARY_COMPATIBILIY(Func,typename ActualDstTypeCleaned::Scalar,typename Src::Scalar); + + Assignment::run(actualDst, src, func); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_restricted_packet_assignment_no_alias(Dst& dst, const Src& src, const Func& func) +{ + typedef evaluator DstEvaluatorType; + typedef evaluator SrcEvaluatorType; + typedef restricted_packet_dense_assignment_kernel Kernel; + + EIGEN_STATIC_ASSERT_LVALUE(Dst) + EIGEN_CHECK_BINARY_COMPATIBILIY(Func,typename Dst::Scalar,typename Src::Scalar); + + SrcEvaluatorType srcEvaluator(src); + resize_if_allowed(dst, src, func); + + DstEvaluatorType dstEvaluator(dst); + Kernel kernel(dstEvaluator, srcEvaluator, func, dst.const_cast_derived()); + + dense_assignment_loop::run(kernel); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment_no_alias(Dst& dst, const Src& src) +{ + call_assignment_no_alias(dst, src, internal::assign_op()); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment_no_alias_no_transpose(Dst& dst, const Src& src, const Func& func) +{ + // TODO check whether this is the right place to perform these checks: + EIGEN_STATIC_ASSERT_LVALUE(Dst) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Dst,Src) + EIGEN_CHECK_BINARY_COMPATIBILIY(Func,typename Dst::Scalar,typename Src::Scalar); + + Assignment::run(dst, src, func); +} +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment_no_alias_no_transpose(Dst& dst, const Src& src) +{ + call_assignment_no_alias_no_transpose(dst, src, internal::assign_op()); +} + +// forward declaration +template void check_for_aliasing(const Dst &dst, const Src &src); + +// Generic Dense to Dense assignment +// Note that the last template argument "Weak" is needed to make it possible to perform +// both partial specialization+SFINAE without ambiguous specialization +template< typename DstXprType, typename SrcXprType, typename Functor, typename Weak> +struct Assignment +{ + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE void run(DstXprType &dst, const SrcXprType &src, const Functor &func) + { +#ifndef EIGEN_NO_DEBUG + internal::check_for_aliasing(dst, src); +#endif + + call_dense_assignment_loop(dst, src, func); + } +}; + +// Generic assignment through evalTo. +// TODO: not sure we have to keep that one, but it helps porting current code to new evaluator mechanism. +// Note that the last template argument "Weak" is needed to make it possible to perform +// both partial specialization+SFINAE without ambiguous specialization +template< typename DstXprType, typename SrcXprType, typename Functor, typename Weak> +struct Assignment +{ + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE void run(DstXprType &dst, const SrcXprType &src, const internal::assign_op &/*func*/) + { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if((dst.rows()!=dstRows) || (dst.cols()!=dstCols)) + dst.resize(dstRows, dstCols); + + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + src.evalTo(dst); + } + + // NOTE The following two functions are templated to avoid their instantiation if not needed + // This is needed because some expressions supports evalTo only and/or have 'void' as scalar type. + template + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE void run(DstXprType &dst, const SrcXprType &src, const internal::add_assign_op &/*func*/) + { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if((dst.rows()!=dstRows) || (dst.cols()!=dstCols)) + dst.resize(dstRows, dstCols); + + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + src.addTo(dst); + } + + template + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE void run(DstXprType &dst, const SrcXprType &src, const internal::sub_assign_op &/*func*/) + { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if((dst.rows()!=dstRows) || (dst.cols()!=dstCols)) + dst.resize(dstRows, dstCols); + + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + src.subTo(dst); + } +}; + +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_ASSIGN_EVALUATOR_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Assign_MKL.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Assign_MKL.h new file mode 100644 index 0000000..c6140d1 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Assign_MKL.h @@ -0,0 +1,178 @@ +/* + Copyright (c) 2011, Intel Corporation. All rights reserved. + Copyright (C) 2015 Gael Guennebaud + + Redistribution and use in source and binary forms, with or without modification, + are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + * Neither the name of Intel Corporation nor the names of its contributors may + be used to endorse or promote products derived from this software without + specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR + ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + ******************************************************************************** + * Content : Eigen bindings to Intel(R) MKL + * MKL VML support for coefficient-wise unary Eigen expressions like a=b.sin() + ******************************************************************************** +*/ + +#ifndef EIGEN_ASSIGN_VML_H +#define EIGEN_ASSIGN_VML_H + +namespace Eigen { + +namespace internal { + +template +class vml_assign_traits +{ + private: + enum { + DstHasDirectAccess = Dst::Flags & DirectAccessBit, + SrcHasDirectAccess = Src::Flags & DirectAccessBit, + StorageOrdersAgree = (int(Dst::IsRowMajor) == int(Src::IsRowMajor)), + InnerSize = int(Dst::IsVectorAtCompileTime) ? int(Dst::SizeAtCompileTime) + : int(Dst::Flags)&RowMajorBit ? int(Dst::ColsAtCompileTime) + : int(Dst::RowsAtCompileTime), + InnerMaxSize = int(Dst::IsVectorAtCompileTime) ? int(Dst::MaxSizeAtCompileTime) + : int(Dst::Flags)&RowMajorBit ? int(Dst::MaxColsAtCompileTime) + : int(Dst::MaxRowsAtCompileTime), + MaxSizeAtCompileTime = Dst::SizeAtCompileTime, + + MightEnableVml = StorageOrdersAgree && DstHasDirectAccess && SrcHasDirectAccess && Src::InnerStrideAtCompileTime==1 && Dst::InnerStrideAtCompileTime==1, + MightLinearize = MightEnableVml && (int(Dst::Flags) & int(Src::Flags) & LinearAccessBit), + VmlSize = MightLinearize ? MaxSizeAtCompileTime : InnerMaxSize, + LargeEnough = VmlSize==Dynamic || VmlSize>=EIGEN_MKL_VML_THRESHOLD + }; + public: + enum { + EnableVml = MightEnableVml && LargeEnough, + Traversal = MightLinearize ? LinearTraversal : DefaultTraversal + }; +}; + +#define EIGEN_PP_EXPAND(ARG) ARG +#if !defined (EIGEN_FAST_MATH) || (EIGEN_FAST_MATH != 1) +#define EIGEN_VMLMODE_EXPAND_xLA , VML_HA +#else +#define EIGEN_VMLMODE_EXPAND_xLA , VML_LA +#endif + +#define EIGEN_VMLMODE_EXPAND_x_ + +#define EIGEN_VMLMODE_PREFIX_xLA vm +#define EIGEN_VMLMODE_PREFIX_x_ v +#define EIGEN_VMLMODE_PREFIX(VMLMODE) EIGEN_CAT(EIGEN_VMLMODE_PREFIX_x,VMLMODE) + +#define EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, VMLOP, EIGENTYPE, VMLTYPE, VMLMODE) \ + template< typename DstXprType, typename SrcXprNested> \ + struct Assignment, SrcXprNested>, assign_op, \ + Dense2Dense, typename enable_if::EnableVml>::type> { \ + typedef CwiseUnaryOp, SrcXprNested> SrcXprType; \ + static void run(DstXprType &dst, const SrcXprType &src, const assign_op &func) { \ + resize_if_allowed(dst, src, func); \ + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); \ + if(vml_assign_traits::Traversal==LinearTraversal) { \ + VMLOP(dst.size(), (const VMLTYPE*)src.nestedExpression().data(), \ + (VMLTYPE*)dst.data() EIGEN_PP_EXPAND(EIGEN_VMLMODE_EXPAND_x##VMLMODE) ); \ + } else { \ + const Index outerSize = dst.outerSize(); \ + for(Index outer = 0; outer < outerSize; ++outer) { \ + const EIGENTYPE *src_ptr = src.IsRowMajor ? &(src.nestedExpression().coeffRef(outer,0)) : \ + &(src.nestedExpression().coeffRef(0, outer)); \ + EIGENTYPE *dst_ptr = dst.IsRowMajor ? &(dst.coeffRef(outer,0)) : &(dst.coeffRef(0, outer)); \ + VMLOP( dst.innerSize(), (const VMLTYPE*)src_ptr, \ + (VMLTYPE*)dst_ptr EIGEN_PP_EXPAND(EIGEN_VMLMODE_EXPAND_x##VMLMODE)); \ + } \ + } \ + } \ + }; \ + + +#define EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(EIGENOP, VMLOP, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, EIGEN_CAT(EIGEN_VMLMODE_PREFIX(VMLMODE),s##VMLOP), float, float, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, EIGEN_CAT(EIGEN_VMLMODE_PREFIX(VMLMODE),d##VMLOP), double, double, VMLMODE) + +#define EIGEN_MKL_VML_DECLARE_UNARY_CALLS_CPLX(EIGENOP, VMLOP, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, EIGEN_CAT(EIGEN_VMLMODE_PREFIX(VMLMODE),c##VMLOP), scomplex, MKL_Complex8, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, EIGEN_CAT(EIGEN_VMLMODE_PREFIX(VMLMODE),z##VMLOP), dcomplex, MKL_Complex16, VMLMODE) + +#define EIGEN_MKL_VML_DECLARE_UNARY_CALLS(EIGENOP, VMLOP, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(EIGENOP, VMLOP, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALLS_CPLX(EIGENOP, VMLOP, VMLMODE) + + +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(sin, Sin, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(asin, Asin, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(sinh, Sinh, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(cos, Cos, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(acos, Acos, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(cosh, Cosh, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(tan, Tan, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(atan, Atan, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(tanh, Tanh, LA) +// EIGEN_MKL_VML_DECLARE_UNARY_CALLS(abs, Abs, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(exp, Exp, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(log, Ln, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(log10, Log10, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(sqrt, Sqrt, _) + +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(square, Sqr, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_CPLX(arg, Arg, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(round, Round, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(floor, Floor, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(ceil, Ceil, _) + +#define EIGEN_MKL_VML_DECLARE_POW_CALL(EIGENOP, VMLOP, EIGENTYPE, VMLTYPE, VMLMODE) \ + template< typename DstXprType, typename SrcXprNested, typename Plain> \ + struct Assignment, SrcXprNested, \ + const CwiseNullaryOp,Plain> >, assign_op, \ + Dense2Dense, typename enable_if::EnableVml>::type> { \ + typedef CwiseBinaryOp, SrcXprNested, \ + const CwiseNullaryOp,Plain> > SrcXprType; \ + static void run(DstXprType &dst, const SrcXprType &src, const assign_op &func) { \ + resize_if_allowed(dst, src, func); \ + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); \ + VMLTYPE exponent = reinterpret_cast(src.rhs().functor().m_other); \ + if(vml_assign_traits::Traversal==LinearTraversal) \ + { \ + VMLOP( dst.size(), (const VMLTYPE*)src.lhs().data(), exponent, \ + (VMLTYPE*)dst.data() EIGEN_PP_EXPAND(EIGEN_VMLMODE_EXPAND_x##VMLMODE) ); \ + } else { \ + const Index outerSize = dst.outerSize(); \ + for(Index outer = 0; outer < outerSize; ++outer) { \ + const EIGENTYPE *src_ptr = src.IsRowMajor ? &(src.lhs().coeffRef(outer,0)) : \ + &(src.lhs().coeffRef(0, outer)); \ + EIGENTYPE *dst_ptr = dst.IsRowMajor ? &(dst.coeffRef(outer,0)) : &(dst.coeffRef(0, outer)); \ + VMLOP( dst.innerSize(), (const VMLTYPE*)src_ptr, exponent, \ + (VMLTYPE*)dst_ptr EIGEN_PP_EXPAND(EIGEN_VMLMODE_EXPAND_x##VMLMODE)); \ + } \ + } \ + } \ + }; + +EIGEN_MKL_VML_DECLARE_POW_CALL(pow, vmsPowx, float, float, LA) +EIGEN_MKL_VML_DECLARE_POW_CALL(pow, vmdPowx, double, double, LA) +EIGEN_MKL_VML_DECLARE_POW_CALL(pow, vmcPowx, scomplex, MKL_Complex8, LA) +EIGEN_MKL_VML_DECLARE_POW_CALL(pow, vmzPowx, dcomplex, MKL_Complex16, LA) + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_ASSIGN_VML_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/BandMatrix.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/BandMatrix.h new file mode 100644 index 0000000..878c024 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/BandMatrix.h @@ -0,0 +1,353 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_BANDMATRIX_H +#define EIGEN_BANDMATRIX_H + +namespace Eigen { + +namespace internal { + +template +class BandMatrixBase : public EigenBase +{ + public: + + enum { + Flags = internal::traits::Flags, + CoeffReadCost = internal::traits::CoeffReadCost, + RowsAtCompileTime = internal::traits::RowsAtCompileTime, + ColsAtCompileTime = internal::traits::ColsAtCompileTime, + MaxRowsAtCompileTime = internal::traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = internal::traits::MaxColsAtCompileTime, + Supers = internal::traits::Supers, + Subs = internal::traits::Subs, + Options = internal::traits::Options + }; + typedef typename internal::traits::Scalar Scalar; + typedef Matrix DenseMatrixType; + typedef typename DenseMatrixType::StorageIndex StorageIndex; + typedef typename internal::traits::CoefficientsType CoefficientsType; + typedef EigenBase Base; + + protected: + enum { + DataRowsAtCompileTime = ((Supers!=Dynamic) && (Subs!=Dynamic)) + ? 1 + Supers + Subs + : Dynamic, + SizeAtCompileTime = EIGEN_SIZE_MIN_PREFER_DYNAMIC(RowsAtCompileTime,ColsAtCompileTime) + }; + + public: + + using Base::derived; + using Base::rows; + using Base::cols; + + /** \returns the number of super diagonals */ + inline Index supers() const { return derived().supers(); } + + /** \returns the number of sub diagonals */ + inline Index subs() const { return derived().subs(); } + + /** \returns an expression of the underlying coefficient matrix */ + inline const CoefficientsType& coeffs() const { return derived().coeffs(); } + + /** \returns an expression of the underlying coefficient matrix */ + inline CoefficientsType& coeffs() { return derived().coeffs(); } + + /** \returns a vector expression of the \a i -th column, + * only the meaningful part is returned. + * \warning the internal storage must be column major. */ + inline Block col(Index i) + { + EIGEN_STATIC_ASSERT((int(Options) & int(RowMajor)) == 0, THIS_METHOD_IS_ONLY_FOR_COLUMN_MAJOR_MATRICES); + Index start = 0; + Index len = coeffs().rows(); + if (i<=supers()) + { + start = supers()-i; + len = (std::min)(rows(),std::max(0,coeffs().rows() - (supers()-i))); + } + else if (i>=rows()-subs()) + len = std::max(0,coeffs().rows() - (i + 1 - rows() + subs())); + return Block(coeffs(), start, i, len, 1); + } + + /** \returns a vector expression of the main diagonal */ + inline Block diagonal() + { return Block(coeffs(),supers(),0,1,(std::min)(rows(),cols())); } + + /** \returns a vector expression of the main diagonal (const version) */ + inline const Block diagonal() const + { return Block(coeffs(),supers(),0,1,(std::min)(rows(),cols())); } + + template struct DiagonalIntReturnType { + enum { + ReturnOpposite = (int(Options) & int(SelfAdjoint)) && (((Index) > 0 && Supers == 0) || ((Index) < 0 && Subs == 0)), + Conjugate = ReturnOpposite && NumTraits::IsComplex, + ActualIndex = ReturnOpposite ? -Index : Index, + DiagonalSize = (RowsAtCompileTime==Dynamic || ColsAtCompileTime==Dynamic) + ? Dynamic + : (ActualIndex<0 + ? EIGEN_SIZE_MIN_PREFER_DYNAMIC(ColsAtCompileTime, RowsAtCompileTime + ActualIndex) + : EIGEN_SIZE_MIN_PREFER_DYNAMIC(RowsAtCompileTime, ColsAtCompileTime - ActualIndex)) + }; + typedef Block BuildType; + typedef typename internal::conditional,BuildType >, + BuildType>::type Type; + }; + + /** \returns a vector expression of the \a N -th sub or super diagonal */ + template inline typename DiagonalIntReturnType::Type diagonal() + { + return typename DiagonalIntReturnType::BuildType(coeffs(), supers()-N, (std::max)(0,N), 1, diagonalLength(N)); + } + + /** \returns a vector expression of the \a N -th sub or super diagonal */ + template inline const typename DiagonalIntReturnType::Type diagonal() const + { + return typename DiagonalIntReturnType::BuildType(coeffs(), supers()-N, (std::max)(0,N), 1, diagonalLength(N)); + } + + /** \returns a vector expression of the \a i -th sub or super diagonal */ + inline Block diagonal(Index i) + { + eigen_assert((i<0 && -i<=subs()) || (i>=0 && i<=supers())); + return Block(coeffs(), supers()-i, std::max(0,i), 1, diagonalLength(i)); + } + + /** \returns a vector expression of the \a i -th sub or super diagonal */ + inline const Block diagonal(Index i) const + { + eigen_assert((i<0 && -i<=subs()) || (i>=0 && i<=supers())); + return Block(coeffs(), supers()-i, std::max(0,i), 1, diagonalLength(i)); + } + + template inline void evalTo(Dest& dst) const + { + dst.resize(rows(),cols()); + dst.setZero(); + dst.diagonal() = diagonal(); + for (Index i=1; i<=supers();++i) + dst.diagonal(i) = diagonal(i); + for (Index i=1; i<=subs();++i) + dst.diagonal(-i) = diagonal(-i); + } + + DenseMatrixType toDenseMatrix() const + { + DenseMatrixType res(rows(),cols()); + evalTo(res); + return res; + } + + protected: + + inline Index diagonalLength(Index i) const + { return i<0 ? (std::min)(cols(),rows()+i) : (std::min)(rows(),cols()-i); } +}; + +/** + * \class BandMatrix + * \ingroup Core_Module + * + * \brief Represents a rectangular matrix with a banded storage + * + * \tparam _Scalar Numeric type, i.e. float, double, int + * \tparam _Rows Number of rows, or \b Dynamic + * \tparam _Cols Number of columns, or \b Dynamic + * \tparam _Supers Number of super diagonal + * \tparam _Subs Number of sub diagonal + * \tparam _Options A combination of either \b #RowMajor or \b #ColMajor, and of \b #SelfAdjoint + * The former controls \ref TopicStorageOrders "storage order", and defaults to + * column-major. The latter controls whether the matrix represents a selfadjoint + * matrix in which case either Supers of Subs have to be null. + * + * \sa class TridiagonalMatrix + */ + +template +struct traits > +{ + typedef _Scalar Scalar; + typedef Dense StorageKind; + typedef Eigen::Index StorageIndex; + enum { + CoeffReadCost = NumTraits::ReadCost, + RowsAtCompileTime = _Rows, + ColsAtCompileTime = _Cols, + MaxRowsAtCompileTime = _Rows, + MaxColsAtCompileTime = _Cols, + Flags = LvalueBit, + Supers = _Supers, + Subs = _Subs, + Options = _Options, + DataRowsAtCompileTime = ((Supers!=Dynamic) && (Subs!=Dynamic)) ? 1 + Supers + Subs : Dynamic + }; + typedef Matrix CoefficientsType; +}; + +template +class BandMatrix : public BandMatrixBase > +{ + public: + + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::traits::StorageIndex StorageIndex; + typedef typename internal::traits::CoefficientsType CoefficientsType; + + explicit inline BandMatrix(Index rows=Rows, Index cols=Cols, Index supers=Supers, Index subs=Subs) + : m_coeffs(1+supers+subs,cols), + m_rows(rows), m_supers(supers), m_subs(subs) + { + } + + /** \returns the number of columns */ + inline EIGEN_CONSTEXPR Index rows() const { return m_rows.value(); } + + /** \returns the number of rows */ + inline EIGEN_CONSTEXPR Index cols() const { return m_coeffs.cols(); } + + /** \returns the number of super diagonals */ + inline EIGEN_CONSTEXPR Index supers() const { return m_supers.value(); } + + /** \returns the number of sub diagonals */ + inline EIGEN_CONSTEXPR Index subs() const { return m_subs.value(); } + + inline const CoefficientsType& coeffs() const { return m_coeffs; } + inline CoefficientsType& coeffs() { return m_coeffs; } + + protected: + + CoefficientsType m_coeffs; + internal::variable_if_dynamic m_rows; + internal::variable_if_dynamic m_supers; + internal::variable_if_dynamic m_subs; +}; + +template +class BandMatrixWrapper; + +template +struct traits > +{ + typedef typename _CoefficientsType::Scalar Scalar; + typedef typename _CoefficientsType::StorageKind StorageKind; + typedef typename _CoefficientsType::StorageIndex StorageIndex; + enum { + CoeffReadCost = internal::traits<_CoefficientsType>::CoeffReadCost, + RowsAtCompileTime = _Rows, + ColsAtCompileTime = _Cols, + MaxRowsAtCompileTime = _Rows, + MaxColsAtCompileTime = _Cols, + Flags = LvalueBit, + Supers = _Supers, + Subs = _Subs, + Options = _Options, + DataRowsAtCompileTime = ((Supers!=Dynamic) && (Subs!=Dynamic)) ? 1 + Supers + Subs : Dynamic + }; + typedef _CoefficientsType CoefficientsType; +}; + +template +class BandMatrixWrapper : public BandMatrixBase > +{ + public: + + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::traits::CoefficientsType CoefficientsType; + typedef typename internal::traits::StorageIndex StorageIndex; + + explicit inline BandMatrixWrapper(const CoefficientsType& coeffs, Index rows=_Rows, Index cols=_Cols, Index supers=_Supers, Index subs=_Subs) + : m_coeffs(coeffs), + m_rows(rows), m_supers(supers), m_subs(subs) + { + EIGEN_UNUSED_VARIABLE(cols); + //internal::assert(coeffs.cols()==cols() && (supers()+subs()+1)==coeffs.rows()); + } + + /** \returns the number of columns */ + inline EIGEN_CONSTEXPR Index rows() const { return m_rows.value(); } + + /** \returns the number of rows */ + inline EIGEN_CONSTEXPR Index cols() const { return m_coeffs.cols(); } + + /** \returns the number of super diagonals */ + inline EIGEN_CONSTEXPR Index supers() const { return m_supers.value(); } + + /** \returns the number of sub diagonals */ + inline EIGEN_CONSTEXPR Index subs() const { return m_subs.value(); } + + inline const CoefficientsType& coeffs() const { return m_coeffs; } + + protected: + + const CoefficientsType& m_coeffs; + internal::variable_if_dynamic m_rows; + internal::variable_if_dynamic m_supers; + internal::variable_if_dynamic m_subs; +}; + +/** + * \class TridiagonalMatrix + * \ingroup Core_Module + * + * \brief Represents a tridiagonal matrix with a compact banded storage + * + * \tparam Scalar Numeric type, i.e. float, double, int + * \tparam Size Number of rows and cols, or \b Dynamic + * \tparam Options Can be 0 or \b SelfAdjoint + * + * \sa class BandMatrix + */ +template +class TridiagonalMatrix : public BandMatrix +{ + typedef BandMatrix Base; + typedef typename Base::StorageIndex StorageIndex; + public: + explicit TridiagonalMatrix(Index size = Size) : Base(size,size,Options&SelfAdjoint?0:1,1) {} + + inline typename Base::template DiagonalIntReturnType<1>::Type super() + { return Base::template diagonal<1>(); } + inline const typename Base::template DiagonalIntReturnType<1>::Type super() const + { return Base::template diagonal<1>(); } + inline typename Base::template DiagonalIntReturnType<-1>::Type sub() + { return Base::template diagonal<-1>(); } + inline const typename Base::template DiagonalIntReturnType<-1>::Type sub() const + { return Base::template diagonal<-1>(); } + protected: +}; + + +struct BandShape {}; + +template +struct evaluator_traits > + : public evaluator_traits_base > +{ + typedef BandShape Shape; +}; + +template +struct evaluator_traits > + : public evaluator_traits_base > +{ + typedef BandShape Shape; +}; + +template<> struct AssignmentKind { typedef EigenBase2EigenBase Kind; }; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_BANDMATRIX_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Block.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Block.h new file mode 100644 index 0000000..3206d66 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Block.h @@ -0,0 +1,448 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_BLOCK_H +#define EIGEN_BLOCK_H + +namespace Eigen { + +namespace internal { +template +struct traits > : traits +{ + typedef typename traits::Scalar Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + typedef typename ref_selector::type XprTypeNested; + typedef typename remove_reference::type _XprTypeNested; + enum{ + MatrixRows = traits::RowsAtCompileTime, + MatrixCols = traits::ColsAtCompileTime, + RowsAtCompileTime = MatrixRows == 0 ? 0 : BlockRows, + ColsAtCompileTime = MatrixCols == 0 ? 0 : BlockCols, + MaxRowsAtCompileTime = BlockRows==0 ? 0 + : RowsAtCompileTime != Dynamic ? int(RowsAtCompileTime) + : int(traits::MaxRowsAtCompileTime), + MaxColsAtCompileTime = BlockCols==0 ? 0 + : ColsAtCompileTime != Dynamic ? int(ColsAtCompileTime) + : int(traits::MaxColsAtCompileTime), + + XprTypeIsRowMajor = (int(traits::Flags)&RowMajorBit) != 0, + IsRowMajor = (MaxRowsAtCompileTime==1&&MaxColsAtCompileTime!=1) ? 1 + : (MaxColsAtCompileTime==1&&MaxRowsAtCompileTime!=1) ? 0 + : XprTypeIsRowMajor, + HasSameStorageOrderAsXprType = (IsRowMajor == XprTypeIsRowMajor), + InnerSize = IsRowMajor ? int(ColsAtCompileTime) : int(RowsAtCompileTime), + InnerStrideAtCompileTime = HasSameStorageOrderAsXprType + ? int(inner_stride_at_compile_time::ret) + : int(outer_stride_at_compile_time::ret), + OuterStrideAtCompileTime = HasSameStorageOrderAsXprType + ? int(outer_stride_at_compile_time::ret) + : int(inner_stride_at_compile_time::ret), + + // FIXME, this traits is rather specialized for dense object and it needs to be cleaned further + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + FlagsRowMajorBit = IsRowMajor ? RowMajorBit : 0, + Flags = (traits::Flags & (DirectAccessBit | (InnerPanel?CompressedAccessBit:0))) | FlagsLvalueBit | FlagsRowMajorBit, + // FIXME DirectAccessBit should not be handled by expressions + // + // Alignment is needed by MapBase's assertions + // We can sefely set it to false here. Internal alignment errors will be detected by an eigen_internal_assert in the respective evaluator + Alignment = 0 + }; +}; + +template::ret> class BlockImpl_dense; + +} // end namespace internal + +template class BlockImpl; + +/** \class Block + * \ingroup Core_Module + * + * \brief Expression of a fixed-size or dynamic-size block + * + * \tparam XprType the type of the expression in which we are taking a block + * \tparam BlockRows the number of rows of the block we are taking at compile time (optional) + * \tparam BlockCols the number of columns of the block we are taking at compile time (optional) + * \tparam InnerPanel is true, if the block maps to a set of rows of a row major matrix or + * to set of columns of a column major matrix (optional). The parameter allows to determine + * at compile time whether aligned access is possible on the block expression. + * + * This class represents an expression of either a fixed-size or dynamic-size block. It is the return + * type of DenseBase::block(Index,Index,Index,Index) and DenseBase::block(Index,Index) and + * most of the time this is the only way it is used. + * + * However, if you want to directly maniputate block expressions, + * for instance if you want to write a function returning such an expression, you + * will need to use this class. + * + * Here is an example illustrating the dynamic case: + * \include class_Block.cpp + * Output: \verbinclude class_Block.out + * + * \note Even though this expression has dynamic size, in the case where \a XprType + * has fixed size, this expression inherits a fixed maximal size which means that evaluating + * it does not cause a dynamic memory allocation. + * + * Here is an example illustrating the fixed-size case: + * \include class_FixedBlock.cpp + * Output: \verbinclude class_FixedBlock.out + * + * \sa DenseBase::block(Index,Index,Index,Index), DenseBase::block(Index,Index), class VectorBlock + */ +template class Block + : public BlockImpl::StorageKind> +{ + typedef BlockImpl::StorageKind> Impl; + public: + //typedef typename Impl::Base Base; + typedef Impl Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(Block) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Block) + + typedef typename internal::remove_all::type NestedExpression; + + /** Column or Row constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Block(XprType& xpr, Index i) : Impl(xpr,i) + { + eigen_assert( (i>=0) && ( + ((BlockRows==1) && (BlockCols==XprType::ColsAtCompileTime) && i= 0 && BlockRows >= 0 && startRow + BlockRows <= xpr.rows() + && startCol >= 0 && BlockCols >= 0 && startCol + BlockCols <= xpr.cols()); + } + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Block(XprType& xpr, + Index startRow, Index startCol, + Index blockRows, Index blockCols) + : Impl(xpr, startRow, startCol, blockRows, blockCols) + { + eigen_assert((RowsAtCompileTime==Dynamic || RowsAtCompileTime==blockRows) + && (ColsAtCompileTime==Dynamic || ColsAtCompileTime==blockCols)); + eigen_assert(startRow >= 0 && blockRows >= 0 && startRow <= xpr.rows() - blockRows + && startCol >= 0 && blockCols >= 0 && startCol <= xpr.cols() - blockCols); + } +}; + +// The generic default implementation for dense block simplu forward to the internal::BlockImpl_dense +// that must be specialized for direct and non-direct access... +template +class BlockImpl + : public internal::BlockImpl_dense +{ + typedef internal::BlockImpl_dense Impl; + typedef typename XprType::StorageIndex StorageIndex; + public: + typedef Impl Base; + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(BlockImpl) + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE BlockImpl(XprType& xpr, Index i) : Impl(xpr,i) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE BlockImpl(XprType& xpr, Index startRow, Index startCol) : Impl(xpr, startRow, startCol) {} + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE BlockImpl(XprType& xpr, Index startRow, Index startCol, Index blockRows, Index blockCols) + : Impl(xpr, startRow, startCol, blockRows, blockCols) {} +}; + +namespace internal { + +/** \internal Internal implementation of dense Blocks in the general case. */ +template class BlockImpl_dense + : public internal::dense_xpr_base >::type +{ + typedef Block BlockType; + typedef typename internal::ref_selector::non_const_type XprTypeNested; + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(BlockType) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(BlockImpl_dense) + + // class InnerIterator; // FIXME apparently never used + + /** Column or Row constructor + */ + EIGEN_DEVICE_FUNC + inline BlockImpl_dense(XprType& xpr, Index i) + : m_xpr(xpr), + // It is a row if and only if BlockRows==1 and BlockCols==XprType::ColsAtCompileTime, + // and it is a column if and only if BlockRows==XprType::RowsAtCompileTime and BlockCols==1, + // all other cases are invalid. + // The case a 1x1 matrix seems ambiguous, but the result is the same anyway. + m_startRow( (BlockRows==1) && (BlockCols==XprType::ColsAtCompileTime) ? i : 0), + m_startCol( (BlockRows==XprType::RowsAtCompileTime) && (BlockCols==1) ? i : 0), + m_blockRows(BlockRows==1 ? 1 : xpr.rows()), + m_blockCols(BlockCols==1 ? 1 : xpr.cols()) + {} + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC + inline BlockImpl_dense(XprType& xpr, Index startRow, Index startCol) + : m_xpr(xpr), m_startRow(startRow), m_startCol(startCol), + m_blockRows(BlockRows), m_blockCols(BlockCols) + {} + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC + inline BlockImpl_dense(XprType& xpr, + Index startRow, Index startCol, + Index blockRows, Index blockCols) + : m_xpr(xpr), m_startRow(startRow), m_startCol(startCol), + m_blockRows(blockRows), m_blockCols(blockCols) + {} + + EIGEN_DEVICE_FUNC inline Index rows() const { return m_blockRows.value(); } + EIGEN_DEVICE_FUNC inline Index cols() const { return m_blockCols.value(); } + + EIGEN_DEVICE_FUNC + inline Scalar& coeffRef(Index rowId, Index colId) + { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + return m_xpr.coeffRef(rowId + m_startRow.value(), colId + m_startCol.value()); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index rowId, Index colId) const + { + return m_xpr.derived().coeffRef(rowId + m_startRow.value(), colId + m_startCol.value()); + } + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE const CoeffReturnType coeff(Index rowId, Index colId) const + { + return m_xpr.coeff(rowId + m_startRow.value(), colId + m_startCol.value()); + } + + EIGEN_DEVICE_FUNC + inline Scalar& coeffRef(Index index) + { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + return m_xpr.coeffRef(m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0)); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index index) const + { + return m_xpr.coeffRef(m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0)); + } + + EIGEN_DEVICE_FUNC + inline const CoeffReturnType coeff(Index index) const + { + return m_xpr.coeff(m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0)); + } + + template + inline PacketScalar packet(Index rowId, Index colId) const + { + return m_xpr.template packet(rowId + m_startRow.value(), colId + m_startCol.value()); + } + + template + inline void writePacket(Index rowId, Index colId, const PacketScalar& val) + { + m_xpr.template writePacket(rowId + m_startRow.value(), colId + m_startCol.value(), val); + } + + template + inline PacketScalar packet(Index index) const + { + return m_xpr.template packet + (m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0)); + } + + template + inline void writePacket(Index index, const PacketScalar& val) + { + m_xpr.template writePacket + (m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0), val); + } + + #ifdef EIGEN_PARSED_BY_DOXYGEN + /** \sa MapBase::data() */ + EIGEN_DEVICE_FUNC inline const Scalar* data() const; + EIGEN_DEVICE_FUNC inline Index innerStride() const; + EIGEN_DEVICE_FUNC inline Index outerStride() const; + #endif + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const typename internal::remove_all::type& nestedExpression() const + { + return m_xpr; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + XprType& nestedExpression() { return m_xpr; } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + StorageIndex startRow() const EIGEN_NOEXCEPT + { + return m_startRow.value(); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + StorageIndex startCol() const EIGEN_NOEXCEPT + { + return m_startCol.value(); + } + + protected: + + XprTypeNested m_xpr; + const internal::variable_if_dynamic m_startRow; + const internal::variable_if_dynamic m_startCol; + const internal::variable_if_dynamic m_blockRows; + const internal::variable_if_dynamic m_blockCols; +}; + +/** \internal Internal implementation of dense Blocks in the direct access case.*/ +template +class BlockImpl_dense + : public MapBase > +{ + typedef Block BlockType; + typedef typename internal::ref_selector::non_const_type XprTypeNested; + enum { + XprTypeIsRowMajor = (int(traits::Flags)&RowMajorBit) != 0 + }; + public: + + typedef MapBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(BlockType) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(BlockImpl_dense) + + /** Column or Row constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + BlockImpl_dense(XprType& xpr, Index i) + : Base(xpr.data() + i * ( ((BlockRows==1) && (BlockCols==XprType::ColsAtCompileTime) && (!XprTypeIsRowMajor)) + || ((BlockRows==XprType::RowsAtCompileTime) && (BlockCols==1) && ( XprTypeIsRowMajor)) ? xpr.innerStride() : xpr.outerStride()), + BlockRows==1 ? 1 : xpr.rows(), + BlockCols==1 ? 1 : xpr.cols()), + m_xpr(xpr), + m_startRow( (BlockRows==1) && (BlockCols==XprType::ColsAtCompileTime) ? i : 0), + m_startCol( (BlockRows==XprType::RowsAtCompileTime) && (BlockCols==1) ? i : 0) + { + init(); + } + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + BlockImpl_dense(XprType& xpr, Index startRow, Index startCol) + : Base(xpr.data()+xpr.innerStride()*(XprTypeIsRowMajor?startCol:startRow) + xpr.outerStride()*(XprTypeIsRowMajor?startRow:startCol)), + m_xpr(xpr), m_startRow(startRow), m_startCol(startCol) + { + init(); + } + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + BlockImpl_dense(XprType& xpr, + Index startRow, Index startCol, + Index blockRows, Index blockCols) + : Base(xpr.data()+xpr.innerStride()*(XprTypeIsRowMajor?startCol:startRow) + xpr.outerStride()*(XprTypeIsRowMajor?startRow:startCol), blockRows, blockCols), + m_xpr(xpr), m_startRow(startRow), m_startCol(startCol) + { + init(); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const typename internal::remove_all::type& nestedExpression() const EIGEN_NOEXCEPT + { + return m_xpr; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + XprType& nestedExpression() { return m_xpr; } + + /** \sa MapBase::innerStride() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index innerStride() const EIGEN_NOEXCEPT + { + return internal::traits::HasSameStorageOrderAsXprType + ? m_xpr.innerStride() + : m_xpr.outerStride(); + } + + /** \sa MapBase::outerStride() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index outerStride() const EIGEN_NOEXCEPT + { + return internal::traits::HasSameStorageOrderAsXprType + ? m_xpr.outerStride() + : m_xpr.innerStride(); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + StorageIndex startRow() const EIGEN_NOEXCEPT { return m_startRow.value(); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + StorageIndex startCol() const EIGEN_NOEXCEPT { return m_startCol.value(); } + + #ifndef __SUNPRO_CC + // FIXME sunstudio is not friendly with the above friend... + // META-FIXME there is no 'friend' keyword around here. Is this obsolete? + protected: + #endif + + #ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal used by allowAligned() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + BlockImpl_dense(XprType& xpr, const Scalar* data, Index blockRows, Index blockCols) + : Base(data, blockRows, blockCols), m_xpr(xpr) + { + init(); + } + #endif + + protected: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void init() + { + m_outerStride = internal::traits::HasSameStorageOrderAsXprType + ? m_xpr.outerStride() + : m_xpr.innerStride(); + } + + XprTypeNested m_xpr; + const internal::variable_if_dynamic m_startRow; + const internal::variable_if_dynamic m_startCol; + Index m_outerStride; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_BLOCK_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/BooleanRedux.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/BooleanRedux.h new file mode 100644 index 0000000..852de8b --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/BooleanRedux.h @@ -0,0 +1,162 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ALLANDANY_H +#define EIGEN_ALLANDANY_H + +namespace Eigen { + +namespace internal { + +template +struct all_unroller +{ + enum { + col = (UnrollCount-1) / Rows, + row = (UnrollCount-1) % Rows + }; + + EIGEN_DEVICE_FUNC static inline bool run(const Derived &mat) + { + return all_unroller::run(mat) && mat.coeff(row, col); + } +}; + +template +struct all_unroller +{ + EIGEN_DEVICE_FUNC static inline bool run(const Derived &/*mat*/) { return true; } +}; + +template +struct all_unroller +{ + EIGEN_DEVICE_FUNC static inline bool run(const Derived &) { return false; } +}; + +template +struct any_unroller +{ + enum { + col = (UnrollCount-1) / Rows, + row = (UnrollCount-1) % Rows + }; + + EIGEN_DEVICE_FUNC static inline bool run(const Derived &mat) + { + return any_unroller::run(mat) || mat.coeff(row, col); + } +}; + +template +struct any_unroller +{ + EIGEN_DEVICE_FUNC static inline bool run(const Derived & /*mat*/) { return false; } +}; + +template +struct any_unroller +{ + EIGEN_DEVICE_FUNC static inline bool run(const Derived &) { return false; } +}; + +} // end namespace internal + +/** \returns true if all coefficients are true + * + * Example: \include MatrixBase_all.cpp + * Output: \verbinclude MatrixBase_all.out + * + * \sa any(), Cwise::operator<() + */ +template +EIGEN_DEVICE_FUNC inline bool DenseBase::all() const +{ + typedef internal::evaluator Evaluator; + enum { + unroll = SizeAtCompileTime != Dynamic + && SizeAtCompileTime * (int(Evaluator::CoeffReadCost) + int(NumTraits::AddCost)) <= EIGEN_UNROLLING_LIMIT + }; + Evaluator evaluator(derived()); + if(unroll) + return internal::all_unroller::RowsAtCompileTime>::run(evaluator); + else + { + for(Index j = 0; j < cols(); ++j) + for(Index i = 0; i < rows(); ++i) + if (!evaluator.coeff(i, j)) return false; + return true; + } +} + +/** \returns true if at least one coefficient is true + * + * \sa all() + */ +template +EIGEN_DEVICE_FUNC inline bool DenseBase::any() const +{ + typedef internal::evaluator Evaluator; + enum { + unroll = SizeAtCompileTime != Dynamic + && SizeAtCompileTime * (int(Evaluator::CoeffReadCost) + int(NumTraits::AddCost)) <= EIGEN_UNROLLING_LIMIT + }; + Evaluator evaluator(derived()); + if(unroll) + return internal::any_unroller::RowsAtCompileTime>::run(evaluator); + else + { + for(Index j = 0; j < cols(); ++j) + for(Index i = 0; i < rows(); ++i) + if (evaluator.coeff(i, j)) return true; + return false; + } +} + +/** \returns the number of coefficients which evaluate to true + * + * \sa all(), any() + */ +template +EIGEN_DEVICE_FUNC inline Eigen::Index DenseBase::count() const +{ + return derived().template cast().template cast().sum(); +} + +/** \returns true is \c *this contains at least one Not A Number (NaN). + * + * \sa allFinite() + */ +template +inline bool DenseBase::hasNaN() const +{ +#if EIGEN_COMP_MSVC || (defined __FAST_MATH__) + return derived().array().isNaN().any(); +#else + return !((derived().array()==derived().array()).all()); +#endif +} + +/** \returns true if \c *this contains only finite numbers, i.e., no NaN and no +/-INF values. + * + * \sa hasNaN() + */ +template +inline bool DenseBase::allFinite() const +{ +#if EIGEN_COMP_MSVC || (defined __FAST_MATH__) + return derived().array().isFinite().all(); +#else + return !((derived()-derived()).hasNaN()); +#endif +} + +} // end namespace Eigen + +#endif // EIGEN_ALLANDANY_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CommaInitializer.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CommaInitializer.h new file mode 100644 index 0000000..c0e29c7 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CommaInitializer.h @@ -0,0 +1,164 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_COMMAINITIALIZER_H +#define EIGEN_COMMAINITIALIZER_H + +namespace Eigen { + +/** \class CommaInitializer + * \ingroup Core_Module + * + * \brief Helper class used by the comma initializer operator + * + * This class is internally used to implement the comma initializer feature. It is + * the return type of MatrixBase::operator<<, and most of the time this is the only + * way it is used. + * + * \sa \blank \ref MatrixBaseCommaInitRef "MatrixBase::operator<<", CommaInitializer::finished() + */ +template +struct CommaInitializer +{ + typedef typename XprType::Scalar Scalar; + + EIGEN_DEVICE_FUNC + inline CommaInitializer(XprType& xpr, const Scalar& s) + : m_xpr(xpr), m_row(0), m_col(1), m_currentBlockRows(1) + { + eigen_assert(m_xpr.rows() > 0 && m_xpr.cols() > 0 + && "Cannot comma-initialize a 0x0 matrix (operator<<)"); + m_xpr.coeffRef(0,0) = s; + } + + template + EIGEN_DEVICE_FUNC + inline CommaInitializer(XprType& xpr, const DenseBase& other) + : m_xpr(xpr), m_row(0), m_col(other.cols()), m_currentBlockRows(other.rows()) + { + eigen_assert(m_xpr.rows() >= other.rows() && m_xpr.cols() >= other.cols() + && "Cannot comma-initialize a 0x0 matrix (operator<<)"); + m_xpr.block(0, 0, other.rows(), other.cols()) = other; + } + + /* Copy/Move constructor which transfers ownership. This is crucial in + * absence of return value optimization to avoid assertions during destruction. */ + // FIXME in C++11 mode this could be replaced by a proper RValue constructor + EIGEN_DEVICE_FUNC + inline CommaInitializer(const CommaInitializer& o) + : m_xpr(o.m_xpr), m_row(o.m_row), m_col(o.m_col), m_currentBlockRows(o.m_currentBlockRows) { + // Mark original object as finished. In absence of R-value references we need to const_cast: + const_cast(o).m_row = m_xpr.rows(); + const_cast(o).m_col = m_xpr.cols(); + const_cast(o).m_currentBlockRows = 0; + } + + /* inserts a scalar value in the target matrix */ + EIGEN_DEVICE_FUNC + CommaInitializer& operator,(const Scalar& s) + { + if (m_col==m_xpr.cols()) + { + m_row+=m_currentBlockRows; + m_col = 0; + m_currentBlockRows = 1; + eigen_assert(m_row + EIGEN_DEVICE_FUNC + CommaInitializer& operator,(const DenseBase& other) + { + if (m_col==m_xpr.cols() && (other.cols()!=0 || other.rows()!=m_currentBlockRows)) + { + m_row+=m_currentBlockRows; + m_col = 0; + m_currentBlockRows = other.rows(); + eigen_assert(m_row+m_currentBlockRows<=m_xpr.rows() + && "Too many rows passed to comma initializer (operator<<)"); + } + eigen_assert((m_col + other.cols() <= m_xpr.cols()) + && "Too many coefficients passed to comma initializer (operator<<)"); + eigen_assert(m_currentBlockRows==other.rows()); + m_xpr.template block + (m_row, m_col, other.rows(), other.cols()) = other; + m_col += other.cols(); + return *this; + } + + EIGEN_DEVICE_FUNC + inline ~CommaInitializer() +#if defined VERIFY_RAISES_ASSERT && (!defined EIGEN_NO_ASSERTION_CHECKING) && defined EIGEN_EXCEPTIONS + EIGEN_EXCEPTION_SPEC(Eigen::eigen_assert_exception) +#endif + { + finished(); + } + + /** \returns the built matrix once all its coefficients have been set. + * Calling finished is 100% optional. Its purpose is to write expressions + * like this: + * \code + * quaternion.fromRotationMatrix((Matrix3f() << axis0, axis1, axis2).finished()); + * \endcode + */ + EIGEN_DEVICE_FUNC + inline XprType& finished() { + eigen_assert(((m_row+m_currentBlockRows) == m_xpr.rows() || m_xpr.cols() == 0) + && m_col == m_xpr.cols() + && "Too few coefficients passed to comma initializer (operator<<)"); + return m_xpr; + } + + XprType& m_xpr; // target expression + Index m_row; // current row id + Index m_col; // current col id + Index m_currentBlockRows; // current block height +}; + +/** \anchor MatrixBaseCommaInitRef + * Convenient operator to set the coefficients of a matrix. + * + * The coefficients must be provided in a row major order and exactly match + * the size of the matrix. Otherwise an assertion is raised. + * + * Example: \include MatrixBase_set.cpp + * Output: \verbinclude MatrixBase_set.out + * + * \note According the c++ standard, the argument expressions of this comma initializer are evaluated in arbitrary order. + * + * \sa CommaInitializer::finished(), class CommaInitializer + */ +template +EIGEN_DEVICE_FUNC inline CommaInitializer DenseBase::operator<< (const Scalar& s) +{ + return CommaInitializer(*static_cast(this), s); +} + +/** \sa operator<<(const Scalar&) */ +template +template +EIGEN_DEVICE_FUNC inline CommaInitializer +DenseBase::operator<<(const DenseBase& other) +{ + return CommaInitializer(*static_cast(this), other); +} + +} // end namespace Eigen + +#endif // EIGEN_COMMAINITIALIZER_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ConditionEstimator.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ConditionEstimator.h new file mode 100644 index 0000000..51a2e5f --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ConditionEstimator.h @@ -0,0 +1,175 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2016 Rasmus Munk Larsen (rmlarsen@google.com) +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CONDITIONESTIMATOR_H +#define EIGEN_CONDITIONESTIMATOR_H + +namespace Eigen { + +namespace internal { + +template +struct rcond_compute_sign { + static inline Vector run(const Vector& v) { + const RealVector v_abs = v.cwiseAbs(); + return (v_abs.array() == static_cast(0)) + .select(Vector::Ones(v.size()), v.cwiseQuotient(v_abs)); + } +}; + +// Partial specialization to avoid elementwise division for real vectors. +template +struct rcond_compute_sign { + static inline Vector run(const Vector& v) { + return (v.array() < static_cast(0)) + .select(-Vector::Ones(v.size()), Vector::Ones(v.size())); + } +}; + +/** + * \returns an estimate of ||inv(matrix)||_1 given a decomposition of + * \a matrix that implements .solve() and .adjoint().solve() methods. + * + * This function implements Algorithms 4.1 and 5.1 from + * http://www.maths.manchester.ac.uk/~higham/narep/narep135.pdf + * which also forms the basis for the condition number estimators in + * LAPACK. Since at most 10 calls to the solve method of dec are + * performed, the total cost is O(dims^2), as opposed to O(dims^3) + * needed to compute the inverse matrix explicitly. + * + * The most common usage is in estimating the condition number + * ||matrix||_1 * ||inv(matrix)||_1. The first term ||matrix||_1 can be + * computed directly in O(n^2) operations. + * + * Supports the following decompositions: FullPivLU, PartialPivLU, LDLT, and + * LLT. + * + * \sa FullPivLU, PartialPivLU, LDLT, LLT. + */ +template +typename Decomposition::RealScalar rcond_invmatrix_L1_norm_estimate(const Decomposition& dec) +{ + typedef typename Decomposition::MatrixType MatrixType; + typedef typename Decomposition::Scalar Scalar; + typedef typename Decomposition::RealScalar RealScalar; + typedef typename internal::plain_col_type::type Vector; + typedef typename internal::plain_col_type::type RealVector; + const bool is_complex = (NumTraits::IsComplex != 0); + + eigen_assert(dec.rows() == dec.cols()); + const Index n = dec.rows(); + if (n == 0) + return 0; + + // Disable Index to float conversion warning +#ifdef __INTEL_COMPILER + #pragma warning push + #pragma warning ( disable : 2259 ) +#endif + Vector v = dec.solve(Vector::Ones(n) / Scalar(n)); +#ifdef __INTEL_COMPILER + #pragma warning pop +#endif + + // lower_bound is a lower bound on + // ||inv(matrix)||_1 = sup_v ||inv(matrix) v||_1 / ||v||_1 + // and is the objective maximized by the ("super-") gradient ascent + // algorithm below. + RealScalar lower_bound = v.template lpNorm<1>(); + if (n == 1) + return lower_bound; + + // Gradient ascent algorithm follows: We know that the optimum is achieved at + // one of the simplices v = e_i, so in each iteration we follow a + // super-gradient to move towards the optimal one. + RealScalar old_lower_bound = lower_bound; + Vector sign_vector(n); + Vector old_sign_vector; + Index v_max_abs_index = -1; + Index old_v_max_abs_index = v_max_abs_index; + for (int k = 0; k < 4; ++k) + { + sign_vector = internal::rcond_compute_sign::run(v); + if (k > 0 && !is_complex && sign_vector == old_sign_vector) { + // Break if the solution stagnated. + break; + } + // v_max_abs_index = argmax |real( inv(matrix)^T * sign_vector )| + v = dec.adjoint().solve(sign_vector); + v.real().cwiseAbs().maxCoeff(&v_max_abs_index); + if (v_max_abs_index == old_v_max_abs_index) { + // Break if the solution stagnated. + break; + } + // Move to the new simplex e_j, where j = v_max_abs_index. + v = dec.solve(Vector::Unit(n, v_max_abs_index)); // v = inv(matrix) * e_j. + lower_bound = v.template lpNorm<1>(); + if (lower_bound <= old_lower_bound) { + // Break if the gradient step did not increase the lower_bound. + break; + } + if (!is_complex) { + old_sign_vector = sign_vector; + } + old_v_max_abs_index = v_max_abs_index; + old_lower_bound = lower_bound; + } + // The following calculates an independent estimate of ||matrix||_1 by + // multiplying matrix by a vector with entries of slowly increasing + // magnitude and alternating sign: + // v_i = (-1)^{i} (1 + (i / (dim-1))), i = 0,...,dim-1. + // This improvement to Hager's algorithm above is due to Higham. It was + // added to make the algorithm more robust in certain corner cases where + // large elements in the matrix might otherwise escape detection due to + // exact cancellation (especially when op and op_adjoint correspond to a + // sequence of backsubstitutions and permutations), which could cause + // Hager's algorithm to vastly underestimate ||matrix||_1. + Scalar alternating_sign(RealScalar(1)); + for (Index i = 0; i < n; ++i) { + // The static_cast is needed when Scalar is a complex and RealScalar implements expression templates + v[i] = alternating_sign * static_cast(RealScalar(1) + (RealScalar(i) / (RealScalar(n - 1)))); + alternating_sign = -alternating_sign; + } + v = dec.solve(v); + const RealScalar alternate_lower_bound = (2 * v.template lpNorm<1>()) / (3 * RealScalar(n)); + return numext::maxi(lower_bound, alternate_lower_bound); +} + +/** \brief Reciprocal condition number estimator. + * + * Computing a decomposition of a dense matrix takes O(n^3) operations, while + * this method estimates the condition number quickly and reliably in O(n^2) + * operations. + * + * \returns an estimate of the reciprocal condition number + * (1 / (||matrix||_1 * ||inv(matrix)||_1)) of matrix, given ||matrix||_1 and + * its decomposition. Supports the following decompositions: FullPivLU, + * PartialPivLU, LDLT, and LLT. + * + * \sa FullPivLU, PartialPivLU, LDLT, LLT. + */ +template +typename Decomposition::RealScalar +rcond_estimate_helper(typename Decomposition::RealScalar matrix_norm, const Decomposition& dec) +{ + typedef typename Decomposition::RealScalar RealScalar; + eigen_assert(dec.rows() == dec.cols()); + if (dec.rows() == 0) return NumTraits::infinity(); + if (matrix_norm == RealScalar(0)) return RealScalar(0); + if (dec.rows() == 1) return RealScalar(1); + const RealScalar inverse_matrix_norm = rcond_invmatrix_L1_norm_estimate(dec); + return (inverse_matrix_norm == RealScalar(0) ? RealScalar(0) + : (RealScalar(1) / inverse_matrix_norm) / matrix_norm); +} + +} // namespace internal + +} // namespace Eigen + +#endif diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CoreEvaluators.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CoreEvaluators.h new file mode 100644 index 0000000..0ff8c8d --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CoreEvaluators.h @@ -0,0 +1,1741 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2011 Benoit Jacob +// Copyright (C) 2011-2014 Gael Guennebaud +// Copyright (C) 2011-2012 Jitse Niesen +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + + +#ifndef EIGEN_COREEVALUATORS_H +#define EIGEN_COREEVALUATORS_H + +namespace Eigen { + +namespace internal { + +// This class returns the evaluator kind from the expression storage kind. +// Default assumes index based accessors +template +struct storage_kind_to_evaluator_kind { + typedef IndexBased Kind; +}; + +// This class returns the evaluator shape from the expression storage kind. +// It can be Dense, Sparse, Triangular, Diagonal, SelfAdjoint, Band, etc. +template struct storage_kind_to_shape; + +template<> struct storage_kind_to_shape { typedef DenseShape Shape; }; +template<> struct storage_kind_to_shape { typedef SolverShape Shape; }; +template<> struct storage_kind_to_shape { typedef PermutationShape Shape; }; +template<> struct storage_kind_to_shape { typedef TranspositionsShape Shape; }; + +// Evaluators have to be specialized with respect to various criteria such as: +// - storage/structure/shape +// - scalar type +// - etc. +// Therefore, we need specialization of evaluator providing additional template arguments for each kind of evaluators. +// We currently distinguish the following kind of evaluators: +// - unary_evaluator for expressions taking only one arguments (CwiseUnaryOp, CwiseUnaryView, Transpose, MatrixWrapper, ArrayWrapper, Reverse, Replicate) +// - binary_evaluator for expression taking two arguments (CwiseBinaryOp) +// - ternary_evaluator for expression taking three arguments (CwiseTernaryOp) +// - product_evaluator for linear algebra products (Product); special case of binary_evaluator because it requires additional tags for dispatching. +// - mapbase_evaluator for Map, Block, Ref +// - block_evaluator for Block (special dispatching to a mapbase_evaluator or unary_evaluator) + +template< typename T, + typename Arg1Kind = typename evaluator_traits::Kind, + typename Arg2Kind = typename evaluator_traits::Kind, + typename Arg3Kind = typename evaluator_traits::Kind, + typename Arg1Scalar = typename traits::Scalar, + typename Arg2Scalar = typename traits::Scalar, + typename Arg3Scalar = typename traits::Scalar> struct ternary_evaluator; + +template< typename T, + typename LhsKind = typename evaluator_traits::Kind, + typename RhsKind = typename evaluator_traits::Kind, + typename LhsScalar = typename traits::Scalar, + typename RhsScalar = typename traits::Scalar> struct binary_evaluator; + +template< typename T, + typename Kind = typename evaluator_traits::Kind, + typename Scalar = typename T::Scalar> struct unary_evaluator; + +// evaluator_traits contains traits for evaluator + +template +struct evaluator_traits_base +{ + // by default, get evaluator kind and shape from storage + typedef typename storage_kind_to_evaluator_kind::StorageKind>::Kind Kind; + typedef typename storage_kind_to_shape::StorageKind>::Shape Shape; +}; + +// Default evaluator traits +template +struct evaluator_traits : public evaluator_traits_base +{ +}; + +template::Shape > +struct evaluator_assume_aliasing { + static const bool value = false; +}; + +// By default, we assume a unary expression: +template +struct evaluator : public unary_evaluator +{ + typedef unary_evaluator Base; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const T& xpr) : Base(xpr) {} +}; + + +// TODO: Think about const-correctness +template +struct evaluator + : evaluator +{ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const T& xpr) : evaluator(xpr) {} +}; + +// ---------- base class for all evaluators ---------- + +template +struct evaluator_base +{ + // TODO that's not very nice to have to propagate all these traits. They are currently only needed to handle outer,inner indices. + typedef traits ExpressionTraits; + + enum { + Alignment = 0 + }; + // noncopyable: + // Don't make this class inherit noncopyable as this kills EBO (Empty Base Optimization) + // and make complex evaluator much larger than then should do. + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE evaluator_base() {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE ~evaluator_base() {} +private: + EIGEN_DEVICE_FUNC evaluator_base(const evaluator_base&); + EIGEN_DEVICE_FUNC const evaluator_base& operator=(const evaluator_base&); +}; + +// -------------------- Matrix and Array -------------------- +// +// evaluator is a common base class for the +// Matrix and Array evaluators. +// Here we directly specialize evaluator. This is not really a unary expression, and it is, by definition, dense, +// so no need for more sophisticated dispatching. + +// this helper permits to completely eliminate m_outerStride if it is known at compiletime. +template class plainobjectbase_evaluator_data { +public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + plainobjectbase_evaluator_data(const Scalar* ptr, Index outerStride) : data(ptr) + { +#ifndef EIGEN_INTERNAL_DEBUGGING + EIGEN_UNUSED_VARIABLE(outerStride); +#endif + eigen_internal_assert(outerStride==OuterStride); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index outerStride() const EIGEN_NOEXCEPT { return OuterStride; } + const Scalar *data; +}; + +template class plainobjectbase_evaluator_data { +public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + plainobjectbase_evaluator_data(const Scalar* ptr, Index outerStride) : data(ptr), m_outerStride(outerStride) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Index outerStride() const { return m_outerStride; } + const Scalar *data; +protected: + Index m_outerStride; +}; + +template +struct evaluator > + : evaluator_base +{ + typedef PlainObjectBase PlainObjectType; + typedef typename PlainObjectType::Scalar Scalar; + typedef typename PlainObjectType::CoeffReturnType CoeffReturnType; + + enum { + IsRowMajor = PlainObjectType::IsRowMajor, + IsVectorAtCompileTime = PlainObjectType::IsVectorAtCompileTime, + RowsAtCompileTime = PlainObjectType::RowsAtCompileTime, + ColsAtCompileTime = PlainObjectType::ColsAtCompileTime, + + CoeffReadCost = NumTraits::ReadCost, + Flags = traits::EvaluatorFlags, + Alignment = traits::Alignment + }; + enum { + // We do not need to know the outer stride for vectors + OuterStrideAtCompileTime = IsVectorAtCompileTime ? 0 + : int(IsRowMajor) ? ColsAtCompileTime + : RowsAtCompileTime + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + evaluator() + : m_d(0,OuterStrideAtCompileTime) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const PlainObjectType& m) + : m_d(m.data(),IsVectorAtCompileTime ? 0 : m.outerStride()) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + if (IsRowMajor) + return m_d.data[row * m_d.outerStride() + col]; + else + return m_d.data[row + col * m_d.outerStride()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_d.data[index]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + if (IsRowMajor) + return const_cast(m_d.data)[row * m_d.outerStride() + col]; + else + return const_cast(m_d.data)[row + col * m_d.outerStride()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return const_cast(m_d.data)[index]; + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + if (IsRowMajor) + return ploadt(m_d.data + row * m_d.outerStride() + col); + else + return ploadt(m_d.data + row + col * m_d.outerStride()); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return ploadt(m_d.data + index); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index row, Index col, const PacketType& x) + { + if (IsRowMajor) + return pstoret + (const_cast(m_d.data) + row * m_d.outerStride() + col, x); + else + return pstoret + (const_cast(m_d.data) + row + col * m_d.outerStride(), x); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index index, const PacketType& x) + { + return pstoret(const_cast(m_d.data) + index, x); + } + +protected: + + plainobjectbase_evaluator_data m_d; +}; + +template +struct evaluator > + : evaluator > > +{ + typedef Matrix XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + evaluator() {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& m) + : evaluator >(m) + { } +}; + +template +struct evaluator > + : evaluator > > +{ + typedef Array XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + evaluator() {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& m) + : evaluator >(m) + { } +}; + +// -------------------- Transpose -------------------- + +template +struct unary_evaluator, IndexBased> + : evaluator_base > +{ + typedef Transpose XprType; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + Flags = evaluator::Flags ^ RowMajorBit, + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& t) : m_argImpl(t.nestedExpression()) {} + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_argImpl.coeff(col, row); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_argImpl.coeff(index); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_argImpl.coeffRef(col, row); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + typename XprType::Scalar& coeffRef(Index index) + { + return m_argImpl.coeffRef(index); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + return m_argImpl.template packet(col, row); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return m_argImpl.template packet(index); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index row, Index col, const PacketType& x) + { + m_argImpl.template writePacket(col, row, x); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index index, const PacketType& x) + { + m_argImpl.template writePacket(index, x); + } + +protected: + evaluator m_argImpl; +}; + +// -------------------- CwiseNullaryOp -------------------- +// Like Matrix and Array, this is not really a unary expression, so we directly specialize evaluator. +// Likewise, there is not need to more sophisticated dispatching here. + +template::value, + bool has_unary = has_unary_operator::value, + bool has_binary = has_binary_operator::value> +struct nullary_wrapper +{ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i, IndexType j) const { return op(i,j); } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i) const { return op(i); } + + template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i, IndexType j) const { return op.template packetOp(i,j); } + template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i) const { return op.template packetOp(i); } +}; + +template +struct nullary_wrapper +{ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType=0, IndexType=0) const { return op(); } + template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType=0, IndexType=0) const { return op.template packetOp(); } +}; + +template +struct nullary_wrapper +{ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i, IndexType j=0) const { return op(i,j); } + template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i, IndexType j=0) const { return op.template packetOp(i,j); } +}; + +// We need the following specialization for vector-only functors assigned to a runtime vector, +// for instance, using linspace and assigning a RowVectorXd to a MatrixXd or even a row of a MatrixXd. +// In this case, i==0 and j is used for the actual iteration. +template +struct nullary_wrapper +{ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i, IndexType j) const { + eigen_assert(i==0 || j==0); + return op(i+j); + } + template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i, IndexType j) const { + eigen_assert(i==0 || j==0); + return op.template packetOp(i+j); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i) const { return op(i); } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i) const { return op.template packetOp(i); } +}; + +template +struct nullary_wrapper {}; + +#if 0 && EIGEN_COMP_MSVC>0 +// Disable this ugly workaround. This is now handled in traits::match, +// but this piece of code might still become handly if some other weird compilation +// erros pop up again. + +// MSVC exhibits a weird compilation error when +// compiling: +// Eigen::MatrixXf A = MatrixXf::Random(3,3); +// Ref R = 2.f*A; +// and that has_*ary_operator> have not been instantiated yet. +// The "problem" is that evaluator<2.f*A> is instantiated by traits::match<2.f*A> +// and at that time has_*ary_operator returns true regardless of T. +// Then nullary_wrapper is badly instantiated as nullary_wrapper<.,.,true,true,true>. +// The trick is thus to defer the proper instantiation of nullary_wrapper when coeff(), +// and packet() are really instantiated as implemented below: + +// This is a simple wrapper around Index to enforce the re-instantiation of +// has_*ary_operator when needed. +template struct nullary_wrapper_workaround_msvc { + nullary_wrapper_workaround_msvc(const T&); + operator T()const; +}; + +template +struct nullary_wrapper +{ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i, IndexType j) const { + return nullary_wrapper >::value, + has_unary_operator >::value, + has_binary_operator >::value>().operator()(op,i,j); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i) const { + return nullary_wrapper >::value, + has_unary_operator >::value, + has_binary_operator >::value>().operator()(op,i); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i, IndexType j) const { + return nullary_wrapper >::value, + has_unary_operator >::value, + has_binary_operator >::value>().template packetOp(op,i,j); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i) const { + return nullary_wrapper >::value, + has_unary_operator >::value, + has_binary_operator >::value>().template packetOp(op,i); + } +}; +#endif // MSVC workaround + +template +struct evaluator > + : evaluator_base > +{ + typedef CwiseNullaryOp XprType; + typedef typename internal::remove_all::type PlainObjectTypeCleaned; + + enum { + CoeffReadCost = internal::functor_traits::Cost, + + Flags = (evaluator::Flags + & ( HereditaryBits + | (functor_has_linear_access::ret ? LinearAccessBit : 0) + | (functor_traits::PacketAccess ? PacketAccessBit : 0))) + | (functor_traits::IsRepeatable ? 0 : EvalBeforeNestingBit), + Alignment = AlignedMax + }; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& n) + : m_functor(n.functor()), m_wrapper() + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(IndexType row, IndexType col) const + { + return m_wrapper(m_functor, row, col); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(IndexType index) const + { + return m_wrapper(m_functor,index); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(IndexType row, IndexType col) const + { + return m_wrapper.template packetOp(m_functor, row, col); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(IndexType index) const + { + return m_wrapper.template packetOp(m_functor, index); + } + +protected: + const NullaryOp m_functor; + const internal::nullary_wrapper m_wrapper; +}; + +// -------------------- CwiseUnaryOp -------------------- + +template +struct unary_evaluator, IndexBased > + : evaluator_base > +{ + typedef CwiseUnaryOp XprType; + + enum { + CoeffReadCost = int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + + Flags = evaluator::Flags + & (HereditaryBits | LinearAccessBit | (functor_traits::PacketAccess ? PacketAccessBit : 0)), + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& op) : m_d(op) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_d.func()(m_d.argImpl.coeff(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_d.func()(m_d.argImpl.coeff(index)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + return m_d.func().packetOp(m_d.argImpl.template packet(row, col)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return m_d.func().packetOp(m_d.argImpl.template packet(index)); + } + +protected: + + // this helper permits to completely eliminate the functor if it is empty + struct Data + { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Data(const XprType& xpr) : op(xpr.functor()), argImpl(xpr.nestedExpression()) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const UnaryOp& func() const { return op; } + UnaryOp op; + evaluator argImpl; + }; + + Data m_d; +}; + +// -------------------- CwiseTernaryOp -------------------- + +// this is a ternary expression +template +struct evaluator > + : public ternary_evaluator > +{ + typedef CwiseTernaryOp XprType; + typedef ternary_evaluator > Base; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& xpr) : Base(xpr) {} +}; + +template +struct ternary_evaluator, IndexBased, IndexBased> + : evaluator_base > +{ + typedef CwiseTernaryOp XprType; + + enum { + CoeffReadCost = int(evaluator::CoeffReadCost) + int(evaluator::CoeffReadCost) + int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + + Arg1Flags = evaluator::Flags, + Arg2Flags = evaluator::Flags, + Arg3Flags = evaluator::Flags, + SameType = is_same::value && is_same::value, + StorageOrdersAgree = (int(Arg1Flags)&RowMajorBit)==(int(Arg2Flags)&RowMajorBit) && (int(Arg1Flags)&RowMajorBit)==(int(Arg3Flags)&RowMajorBit), + Flags0 = (int(Arg1Flags) | int(Arg2Flags) | int(Arg3Flags)) & ( + HereditaryBits + | (int(Arg1Flags) & int(Arg2Flags) & int(Arg3Flags) & + ( (StorageOrdersAgree ? LinearAccessBit : 0) + | (functor_traits::PacketAccess && StorageOrdersAgree && SameType ? PacketAccessBit : 0) + ) + ) + ), + Flags = (Flags0 & ~RowMajorBit) | (Arg1Flags & RowMajorBit), + Alignment = EIGEN_PLAIN_ENUM_MIN( + EIGEN_PLAIN_ENUM_MIN(evaluator::Alignment, evaluator::Alignment), + evaluator::Alignment) + }; + + EIGEN_DEVICE_FUNC explicit ternary_evaluator(const XprType& xpr) : m_d(xpr) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_d.func()(m_d.arg1Impl.coeff(row, col), m_d.arg2Impl.coeff(row, col), m_d.arg3Impl.coeff(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_d.func()(m_d.arg1Impl.coeff(index), m_d.arg2Impl.coeff(index), m_d.arg3Impl.coeff(index)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + return m_d.func().packetOp(m_d.arg1Impl.template packet(row, col), + m_d.arg2Impl.template packet(row, col), + m_d.arg3Impl.template packet(row, col)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return m_d.func().packetOp(m_d.arg1Impl.template packet(index), + m_d.arg2Impl.template packet(index), + m_d.arg3Impl.template packet(index)); + } + +protected: + // this helper permits to completely eliminate the functor if it is empty + struct Data + { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Data(const XprType& xpr) : op(xpr.functor()), arg1Impl(xpr.arg1()), arg2Impl(xpr.arg2()), arg3Impl(xpr.arg3()) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const TernaryOp& func() const { return op; } + TernaryOp op; + evaluator arg1Impl; + evaluator arg2Impl; + evaluator arg3Impl; + }; + + Data m_d; +}; + +// -------------------- CwiseBinaryOp -------------------- + +// this is a binary expression +template +struct evaluator > + : public binary_evaluator > +{ + typedef CwiseBinaryOp XprType; + typedef binary_evaluator > Base; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& xpr) : Base(xpr) {} +}; + +template +struct binary_evaluator, IndexBased, IndexBased> + : evaluator_base > +{ + typedef CwiseBinaryOp XprType; + + enum { + CoeffReadCost = int(evaluator::CoeffReadCost) + int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + + LhsFlags = evaluator::Flags, + RhsFlags = evaluator::Flags, + SameType = is_same::value, + StorageOrdersAgree = (int(LhsFlags)&RowMajorBit)==(int(RhsFlags)&RowMajorBit), + Flags0 = (int(LhsFlags) | int(RhsFlags)) & ( + HereditaryBits + | (int(LhsFlags) & int(RhsFlags) & + ( (StorageOrdersAgree ? LinearAccessBit : 0) + | (functor_traits::PacketAccess && StorageOrdersAgree && SameType ? PacketAccessBit : 0) + ) + ) + ), + Flags = (Flags0 & ~RowMajorBit) | (LhsFlags & RowMajorBit), + Alignment = EIGEN_PLAIN_ENUM_MIN(evaluator::Alignment,evaluator::Alignment) + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit binary_evaluator(const XprType& xpr) : m_d(xpr) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_d.func()(m_d.lhsImpl.coeff(row, col), m_d.rhsImpl.coeff(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_d.func()(m_d.lhsImpl.coeff(index), m_d.rhsImpl.coeff(index)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + return m_d.func().packetOp(m_d.lhsImpl.template packet(row, col), + m_d.rhsImpl.template packet(row, col)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return m_d.func().packetOp(m_d.lhsImpl.template packet(index), + m_d.rhsImpl.template packet(index)); + } + +protected: + + // this helper permits to completely eliminate the functor if it is empty + struct Data + { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Data(const XprType& xpr) : op(xpr.functor()), lhsImpl(xpr.lhs()), rhsImpl(xpr.rhs()) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const BinaryOp& func() const { return op; } + BinaryOp op; + evaluator lhsImpl; + evaluator rhsImpl; + }; + + Data m_d; +}; + +// -------------------- CwiseUnaryView -------------------- + +template +struct unary_evaluator, IndexBased> + : evaluator_base > +{ + typedef CwiseUnaryView XprType; + + enum { + CoeffReadCost = int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + + Flags = (evaluator::Flags & (HereditaryBits | LinearAccessBit | DirectAccessBit)), + + Alignment = 0 // FIXME it is not very clear why alignment is necessarily lost... + }; + + EIGEN_DEVICE_FUNC explicit unary_evaluator(const XprType& op) : m_d(op) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_d.func()(m_d.argImpl.coeff(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_d.func()(m_d.argImpl.coeff(index)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_d.func()(m_d.argImpl.coeffRef(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return m_d.func()(m_d.argImpl.coeffRef(index)); + } + +protected: + + // this helper permits to completely eliminate the functor if it is empty + struct Data + { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Data(const XprType& xpr) : op(xpr.functor()), argImpl(xpr.nestedExpression()) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const UnaryOp& func() const { return op; } + UnaryOp op; + evaluator argImpl; + }; + + Data m_d; +}; + +// -------------------- Map -------------------- + +// FIXME perhaps the PlainObjectType could be provided by Derived::PlainObject ? +// but that might complicate template specialization +template +struct mapbase_evaluator; + +template +struct mapbase_evaluator : evaluator_base +{ + typedef Derived XprType; + typedef typename XprType::PointerType PointerType; + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + enum { + IsRowMajor = XprType::RowsAtCompileTime, + ColsAtCompileTime = XprType::ColsAtCompileTime, + CoeffReadCost = NumTraits::ReadCost + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit mapbase_evaluator(const XprType& map) + : m_data(const_cast(map.data())), + m_innerStride(map.innerStride()), + m_outerStride(map.outerStride()) + { + EIGEN_STATIC_ASSERT(EIGEN_IMPLIES(evaluator::Flags&PacketAccessBit, internal::inner_stride_at_compile_time::ret==1), + PACKET_ACCESS_REQUIRES_TO_HAVE_INNER_STRIDE_FIXED_TO_1); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_data[col * colStride() + row * rowStride()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_data[index * m_innerStride.value()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_data[col * colStride() + row * rowStride()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return m_data[index * m_innerStride.value()]; + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + PointerType ptr = m_data + row * rowStride() + col * colStride(); + return internal::ploadt(ptr); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return internal::ploadt(m_data + index * m_innerStride.value()); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index row, Index col, const PacketType& x) + { + PointerType ptr = m_data + row * rowStride() + col * colStride(); + return internal::pstoret(ptr, x); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index index, const PacketType& x) + { + internal::pstoret(m_data + index * m_innerStride.value(), x); + } +protected: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rowStride() const EIGEN_NOEXCEPT { + return XprType::IsRowMajor ? m_outerStride.value() : m_innerStride.value(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index colStride() const EIGEN_NOEXCEPT { + return XprType::IsRowMajor ? m_innerStride.value() : m_outerStride.value(); + } + + PointerType m_data; + const internal::variable_if_dynamic m_innerStride; + const internal::variable_if_dynamic m_outerStride; +}; + +template +struct evaluator > + : public mapbase_evaluator, PlainObjectType> +{ + typedef Map XprType; + typedef typename XprType::Scalar Scalar; + // TODO: should check for smaller packet types once we can handle multi-sized packet types + typedef typename packet_traits::type PacketScalar; + + enum { + InnerStrideAtCompileTime = StrideType::InnerStrideAtCompileTime == 0 + ? int(PlainObjectType::InnerStrideAtCompileTime) + : int(StrideType::InnerStrideAtCompileTime), + OuterStrideAtCompileTime = StrideType::OuterStrideAtCompileTime == 0 + ? int(PlainObjectType::OuterStrideAtCompileTime) + : int(StrideType::OuterStrideAtCompileTime), + HasNoInnerStride = InnerStrideAtCompileTime == 1, + HasNoOuterStride = StrideType::OuterStrideAtCompileTime == 0, + HasNoStride = HasNoInnerStride && HasNoOuterStride, + IsDynamicSize = PlainObjectType::SizeAtCompileTime==Dynamic, + + PacketAccessMask = bool(HasNoInnerStride) ? ~int(0) : ~int(PacketAccessBit), + LinearAccessMask = bool(HasNoStride) || bool(PlainObjectType::IsVectorAtCompileTime) ? ~int(0) : ~int(LinearAccessBit), + Flags = int( evaluator::Flags) & (LinearAccessMask&PacketAccessMask), + + Alignment = int(MapOptions)&int(AlignedMask) + }; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& map) + : mapbase_evaluator(map) + { } +}; + +// -------------------- Ref -------------------- + +template +struct evaluator > + : public mapbase_evaluator, PlainObjectType> +{ + typedef Ref XprType; + + enum { + Flags = evaluator >::Flags, + Alignment = evaluator >::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& ref) + : mapbase_evaluator(ref) + { } +}; + +// -------------------- Block -------------------- + +template::ret> struct block_evaluator; + +template +struct evaluator > + : block_evaluator +{ + typedef Block XprType; + typedef typename XprType::Scalar Scalar; + // TODO: should check for smaller packet types once we can handle multi-sized packet types + typedef typename packet_traits::type PacketScalar; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + + RowsAtCompileTime = traits::RowsAtCompileTime, + ColsAtCompileTime = traits::ColsAtCompileTime, + MaxRowsAtCompileTime = traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = traits::MaxColsAtCompileTime, + + ArgTypeIsRowMajor = (int(evaluator::Flags)&RowMajorBit) != 0, + IsRowMajor = (MaxRowsAtCompileTime==1 && MaxColsAtCompileTime!=1) ? 1 + : (MaxColsAtCompileTime==1 && MaxRowsAtCompileTime!=1) ? 0 + : ArgTypeIsRowMajor, + HasSameStorageOrderAsArgType = (IsRowMajor == ArgTypeIsRowMajor), + InnerSize = IsRowMajor ? int(ColsAtCompileTime) : int(RowsAtCompileTime), + InnerStrideAtCompileTime = HasSameStorageOrderAsArgType + ? int(inner_stride_at_compile_time::ret) + : int(outer_stride_at_compile_time::ret), + OuterStrideAtCompileTime = HasSameStorageOrderAsArgType + ? int(outer_stride_at_compile_time::ret) + : int(inner_stride_at_compile_time::ret), + MaskPacketAccessBit = (InnerStrideAtCompileTime == 1 || HasSameStorageOrderAsArgType) ? PacketAccessBit : 0, + + FlagsLinearAccessBit = (RowsAtCompileTime == 1 || ColsAtCompileTime == 1 || (InnerPanel && (evaluator::Flags&LinearAccessBit))) ? LinearAccessBit : 0, + FlagsRowMajorBit = XprType::Flags&RowMajorBit, + Flags0 = evaluator::Flags & ( (HereditaryBits & ~RowMajorBit) | + DirectAccessBit | + MaskPacketAccessBit), + Flags = Flags0 | FlagsLinearAccessBit | FlagsRowMajorBit, + + PacketAlignment = unpacket_traits::alignment, + Alignment0 = (InnerPanel && (OuterStrideAtCompileTime!=Dynamic) + && (OuterStrideAtCompileTime!=0) + && (((OuterStrideAtCompileTime * int(sizeof(Scalar))) % int(PacketAlignment)) == 0)) ? int(PacketAlignment) : 0, + Alignment = EIGEN_PLAIN_ENUM_MIN(evaluator::Alignment, Alignment0) + }; + typedef block_evaluator block_evaluator_type; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& block) : block_evaluator_type(block) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } +}; + +// no direct-access => dispatch to a unary evaluator +template +struct block_evaluator + : unary_evaluator > +{ + typedef Block XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit block_evaluator(const XprType& block) + : unary_evaluator(block) + {} +}; + +template +struct unary_evaluator, IndexBased> + : evaluator_base > +{ + typedef Block XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& block) + : m_argImpl(block.nestedExpression()), + m_startRow(block.startRow()), + m_startCol(block.startCol()), + m_linear_offset(ForwardLinearAccess?(ArgType::IsRowMajor ? block.startRow()*block.nestedExpression().cols() + block.startCol() : block.startCol()*block.nestedExpression().rows() + block.startRow()):0) + { } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + enum { + RowsAtCompileTime = XprType::RowsAtCompileTime, + ForwardLinearAccess = (InnerPanel || int(XprType::IsRowMajor)==int(ArgType::IsRowMajor)) && bool(evaluator::Flags&LinearAccessBit) + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_argImpl.coeff(m_startRow.value() + row, m_startCol.value() + col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return linear_coeff_impl(index, bool_constant()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_argImpl.coeffRef(m_startRow.value() + row, m_startCol.value() + col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return linear_coeffRef_impl(index, bool_constant()); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + return m_argImpl.template packet(m_startRow.value() + row, m_startCol.value() + col); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + if (ForwardLinearAccess) + return m_argImpl.template packet(m_linear_offset.value() + index); + else + return packet(RowsAtCompileTime == 1 ? 0 : index, + RowsAtCompileTime == 1 ? index : 0); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index row, Index col, const PacketType& x) + { + return m_argImpl.template writePacket(m_startRow.value() + row, m_startCol.value() + col, x); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index index, const PacketType& x) + { + if (ForwardLinearAccess) + return m_argImpl.template writePacket(m_linear_offset.value() + index, x); + else + return writePacket(RowsAtCompileTime == 1 ? 0 : index, + RowsAtCompileTime == 1 ? index : 0, + x); + } + +protected: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType linear_coeff_impl(Index index, internal::true_type /* ForwardLinearAccess */) const + { + return m_argImpl.coeff(m_linear_offset.value() + index); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType linear_coeff_impl(Index index, internal::false_type /* not ForwardLinearAccess */) const + { + return coeff(RowsAtCompileTime == 1 ? 0 : index, RowsAtCompileTime == 1 ? index : 0); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& linear_coeffRef_impl(Index index, internal::true_type /* ForwardLinearAccess */) + { + return m_argImpl.coeffRef(m_linear_offset.value() + index); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& linear_coeffRef_impl(Index index, internal::false_type /* not ForwardLinearAccess */) + { + return coeffRef(RowsAtCompileTime == 1 ? 0 : index, RowsAtCompileTime == 1 ? index : 0); + } + + evaluator m_argImpl; + const variable_if_dynamic m_startRow; + const variable_if_dynamic m_startCol; + const variable_if_dynamic m_linear_offset; +}; + +// TODO: This evaluator does not actually use the child evaluator; +// all action is via the data() as returned by the Block expression. + +template +struct block_evaluator + : mapbase_evaluator, + typename Block::PlainObject> +{ + typedef Block XprType; + typedef typename XprType::Scalar Scalar; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit block_evaluator(const XprType& block) + : mapbase_evaluator(block) + { + // TODO: for the 3.3 release, this should be turned to an internal assertion, but let's keep it as is for the beta lifetime + eigen_assert(((internal::UIntPtr(block.data()) % EIGEN_PLAIN_ENUM_MAX(1,evaluator::Alignment)) == 0) && "data is not aligned"); + } +}; + + +// -------------------- Select -------------------- +// NOTE shall we introduce a ternary_evaluator? + +// TODO enable vectorization for Select +template +struct evaluator > + : evaluator_base > +{ + typedef Select XprType; + enum { + CoeffReadCost = evaluator::CoeffReadCost + + EIGEN_PLAIN_ENUM_MAX(evaluator::CoeffReadCost, + evaluator::CoeffReadCost), + + Flags = (unsigned int)evaluator::Flags & evaluator::Flags & HereditaryBits, + + Alignment = EIGEN_PLAIN_ENUM_MIN(evaluator::Alignment, evaluator::Alignment) + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& select) + : m_conditionImpl(select.conditionMatrix()), + m_thenImpl(select.thenMatrix()), + m_elseImpl(select.elseMatrix()) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + if (m_conditionImpl.coeff(row, col)) + return m_thenImpl.coeff(row, col); + else + return m_elseImpl.coeff(row, col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + if (m_conditionImpl.coeff(index)) + return m_thenImpl.coeff(index); + else + return m_elseImpl.coeff(index); + } + +protected: + evaluator m_conditionImpl; + evaluator m_thenImpl; + evaluator m_elseImpl; +}; + + +// -------------------- Replicate -------------------- + +template +struct unary_evaluator > + : evaluator_base > +{ + typedef Replicate XprType; + typedef typename XprType::CoeffReturnType CoeffReturnType; + enum { + Factor = (RowFactor==Dynamic || ColFactor==Dynamic) ? Dynamic : RowFactor*ColFactor + }; + typedef typename internal::nested_eval::type ArgTypeNested; + typedef typename internal::remove_all::type ArgTypeNestedCleaned; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + LinearAccessMask = XprType::IsVectorAtCompileTime ? LinearAccessBit : 0, + Flags = (evaluator::Flags & (HereditaryBits|LinearAccessMask) & ~RowMajorBit) | (traits::Flags & RowMajorBit), + + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& replicate) + : m_arg(replicate.nestedExpression()), + m_argImpl(m_arg), + m_rows(replicate.nestedExpression().rows()), + m_cols(replicate.nestedExpression().cols()) + {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + // try to avoid using modulo; this is a pure optimization strategy + const Index actual_row = internal::traits::RowsAtCompileTime==1 ? 0 + : RowFactor==1 ? row + : row % m_rows.value(); + const Index actual_col = internal::traits::ColsAtCompileTime==1 ? 0 + : ColFactor==1 ? col + : col % m_cols.value(); + + return m_argImpl.coeff(actual_row, actual_col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + // try to avoid using modulo; this is a pure optimization strategy + const Index actual_index = internal::traits::RowsAtCompileTime==1 + ? (ColFactor==1 ? index : index%m_cols.value()) + : (RowFactor==1 ? index : index%m_rows.value()); + + return m_argImpl.coeff(actual_index); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + const Index actual_row = internal::traits::RowsAtCompileTime==1 ? 0 + : RowFactor==1 ? row + : row % m_rows.value(); + const Index actual_col = internal::traits::ColsAtCompileTime==1 ? 0 + : ColFactor==1 ? col + : col % m_cols.value(); + + return m_argImpl.template packet(actual_row, actual_col); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + const Index actual_index = internal::traits::RowsAtCompileTime==1 + ? (ColFactor==1 ? index : index%m_cols.value()) + : (RowFactor==1 ? index : index%m_rows.value()); + + return m_argImpl.template packet(actual_index); + } + +protected: + const ArgTypeNested m_arg; + evaluator m_argImpl; + const variable_if_dynamic m_rows; + const variable_if_dynamic m_cols; +}; + +// -------------------- MatrixWrapper and ArrayWrapper -------------------- +// +// evaluator_wrapper_base is a common base class for the +// MatrixWrapper and ArrayWrapper evaluators. + +template +struct evaluator_wrapper_base + : evaluator_base +{ + typedef typename remove_all::type ArgType; + enum { + CoeffReadCost = evaluator::CoeffReadCost, + Flags = evaluator::Flags, + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator_wrapper_base(const ArgType& arg) : m_argImpl(arg) {} + + typedef typename ArgType::Scalar Scalar; + typedef typename ArgType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_argImpl.coeff(row, col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_argImpl.coeff(index); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_argImpl.coeffRef(row, col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return m_argImpl.coeffRef(index); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + return m_argImpl.template packet(row, col); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return m_argImpl.template packet(index); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index row, Index col, const PacketType& x) + { + m_argImpl.template writePacket(row, col, x); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index index, const PacketType& x) + { + m_argImpl.template writePacket(index, x); + } + +protected: + evaluator m_argImpl; +}; + +template +struct unary_evaluator > + : evaluator_wrapper_base > +{ + typedef MatrixWrapper XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& wrapper) + : evaluator_wrapper_base >(wrapper.nestedExpression()) + { } +}; + +template +struct unary_evaluator > + : evaluator_wrapper_base > +{ + typedef ArrayWrapper XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& wrapper) + : evaluator_wrapper_base >(wrapper.nestedExpression()) + { } +}; + + +// -------------------- Reverse -------------------- + +// defined in Reverse.h: +template struct reverse_packet_cond; + +template +struct unary_evaluator > + : evaluator_base > +{ + typedef Reverse XprType; + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + enum { + IsRowMajor = XprType::IsRowMajor, + IsColMajor = !IsRowMajor, + ReverseRow = (Direction == Vertical) || (Direction == BothDirections), + ReverseCol = (Direction == Horizontal) || (Direction == BothDirections), + ReversePacket = (Direction == BothDirections) + || ((Direction == Vertical) && IsColMajor) + || ((Direction == Horizontal) && IsRowMajor), + + CoeffReadCost = evaluator::CoeffReadCost, + + // let's enable LinearAccess only with vectorization because of the product overhead + // FIXME enable DirectAccess with negative strides? + Flags0 = evaluator::Flags, + LinearAccess = ( (Direction==BothDirections) && (int(Flags0)&PacketAccessBit) ) + || ((ReverseRow && XprType::ColsAtCompileTime==1) || (ReverseCol && XprType::RowsAtCompileTime==1)) + ? LinearAccessBit : 0, + + Flags = int(Flags0) & (HereditaryBits | PacketAccessBit | LinearAccess), + + Alignment = 0 // FIXME in some rare cases, Alignment could be preserved, like a Vector4f. + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& reverse) + : m_argImpl(reverse.nestedExpression()), + m_rows(ReverseRow ? reverse.nestedExpression().rows() : 1), + m_cols(ReverseCol ? reverse.nestedExpression().cols() : 1) + { } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_argImpl.coeff(ReverseRow ? m_rows.value() - row - 1 : row, + ReverseCol ? m_cols.value() - col - 1 : col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_argImpl.coeff(m_rows.value() * m_cols.value() - index - 1); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_argImpl.coeffRef(ReverseRow ? m_rows.value() - row - 1 : row, + ReverseCol ? m_cols.value() - col - 1 : col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return m_argImpl.coeffRef(m_rows.value() * m_cols.value() - index - 1); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + enum { + PacketSize = unpacket_traits::size, + OffsetRow = ReverseRow && IsColMajor ? PacketSize : 1, + OffsetCol = ReverseCol && IsRowMajor ? PacketSize : 1 + }; + typedef internal::reverse_packet_cond reverse_packet; + return reverse_packet::run(m_argImpl.template packet( + ReverseRow ? m_rows.value() - row - OffsetRow : row, + ReverseCol ? m_cols.value() - col - OffsetCol : col)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + enum { PacketSize = unpacket_traits::size }; + return preverse(m_argImpl.template packet(m_rows.value() * m_cols.value() - index - PacketSize)); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index row, Index col, const PacketType& x) + { + // FIXME we could factorize some code with packet(i,j) + enum { + PacketSize = unpacket_traits::size, + OffsetRow = ReverseRow && IsColMajor ? PacketSize : 1, + OffsetCol = ReverseCol && IsRowMajor ? PacketSize : 1 + }; + typedef internal::reverse_packet_cond reverse_packet; + m_argImpl.template writePacket( + ReverseRow ? m_rows.value() - row - OffsetRow : row, + ReverseCol ? m_cols.value() - col - OffsetCol : col, + reverse_packet::run(x)); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index index, const PacketType& x) + { + enum { PacketSize = unpacket_traits::size }; + m_argImpl.template writePacket + (m_rows.value() * m_cols.value() - index - PacketSize, preverse(x)); + } + +protected: + evaluator m_argImpl; + + // If we do not reverse rows, then we do not need to know the number of rows; same for columns + // Nonetheless, in this case it is important to set to 1 such that the coeff(index) method works fine for vectors. + const variable_if_dynamic m_rows; + const variable_if_dynamic m_cols; +}; + + +// -------------------- Diagonal -------------------- + +template +struct evaluator > + : evaluator_base > +{ + typedef Diagonal XprType; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + + Flags = (unsigned int)(evaluator::Flags & (HereditaryBits | DirectAccessBit) & ~RowMajorBit) | LinearAccessBit, + + Alignment = 0 + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& diagonal) + : m_argImpl(diagonal.nestedExpression()), + m_index(diagonal.index()) + { } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index) const + { + return m_argImpl.coeff(row + rowOffset(), row + colOffset()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_argImpl.coeff(index + rowOffset(), index + colOffset()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index) + { + return m_argImpl.coeffRef(row + rowOffset(), row + colOffset()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return m_argImpl.coeffRef(index + rowOffset(), index + colOffset()); + } + +protected: + evaluator m_argImpl; + const internal::variable_if_dynamicindex m_index; + +private: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rowOffset() const { return m_index.value() > 0 ? 0 : -m_index.value(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index colOffset() const { return m_index.value() > 0 ? m_index.value() : 0; } +}; + + +//---------------------------------------------------------------------- +// deprecated code +//---------------------------------------------------------------------- + +// -------------------- EvalToTemp -------------------- + +// expression class for evaluating nested expression to a temporary + +template class EvalToTemp; + +template +struct traits > + : public traits +{ }; + +template +class EvalToTemp + : public dense_xpr_base >::type +{ + public: + + typedef typename dense_xpr_base::type Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(EvalToTemp) + + explicit EvalToTemp(const ArgType& arg) + : m_arg(arg) + { } + + const ArgType& arg() const + { + return m_arg; + } + + EIGEN_CONSTEXPR Index rows() const EIGEN_NOEXCEPT + { + return m_arg.rows(); + } + + EIGEN_CONSTEXPR Index cols() const EIGEN_NOEXCEPT + { + return m_arg.cols(); + } + + private: + const ArgType& m_arg; +}; + +template +struct evaluator > + : public evaluator +{ + typedef EvalToTemp XprType; + typedef typename ArgType::PlainObject PlainObject; + typedef evaluator Base; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& xpr) + : m_result(xpr.arg()) + { + ::new (static_cast(this)) Base(m_result); + } + + // This constructor is used when nesting an EvalTo evaluator in another evaluator + EIGEN_DEVICE_FUNC evaluator(const ArgType& arg) + : m_result(arg) + { + ::new (static_cast(this)) Base(m_result); + } + +protected: + PlainObject m_result; +}; + +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_COREEVALUATORS_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CoreIterators.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CoreIterators.h new file mode 100644 index 0000000..b967196 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CoreIterators.h @@ -0,0 +1,132 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2014 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_COREITERATORS_H +#define EIGEN_COREITERATORS_H + +namespace Eigen { + +/* This file contains the respective InnerIterator definition of the expressions defined in Eigen/Core + */ + +namespace internal { + +template +class inner_iterator_selector; + +} + +/** \class InnerIterator + * \brief An InnerIterator allows to loop over the element of any matrix expression. + * + * \warning To be used with care because an evaluator is constructed every time an InnerIterator iterator is constructed. + * + * TODO: add a usage example + */ +template +class InnerIterator +{ +protected: + typedef internal::inner_iterator_selector::Kind> IteratorType; + typedef internal::evaluator EvaluatorType; + typedef typename internal::traits::Scalar Scalar; +public: + /** Construct an iterator over the \a outerId -th row or column of \a xpr */ + InnerIterator(const XprType &xpr, const Index &outerId) + : m_eval(xpr), m_iter(m_eval, outerId, xpr.innerSize()) + {} + + /// \returns the value of the current coefficient. + EIGEN_STRONG_INLINE Scalar value() const { return m_iter.value(); } + /** Increment the iterator \c *this to the next non-zero coefficient. + * Explicit zeros are not skipped over. To skip explicit zeros, see class SparseView + */ + EIGEN_STRONG_INLINE InnerIterator& operator++() { m_iter.operator++(); return *this; } + EIGEN_STRONG_INLINE InnerIterator& operator+=(Index i) { m_iter.operator+=(i); return *this; } + EIGEN_STRONG_INLINE InnerIterator operator+(Index i) + { InnerIterator result(*this); result+=i; return result; } + + + /// \returns the column or row index of the current coefficient. + EIGEN_STRONG_INLINE Index index() const { return m_iter.index(); } + /// \returns the row index of the current coefficient. + EIGEN_STRONG_INLINE Index row() const { return m_iter.row(); } + /// \returns the column index of the current coefficient. + EIGEN_STRONG_INLINE Index col() const { return m_iter.col(); } + /// \returns \c true if the iterator \c *this still references a valid coefficient. + EIGEN_STRONG_INLINE operator bool() const { return m_iter; } + +protected: + EvaluatorType m_eval; + IteratorType m_iter; +private: + // If you get here, then you're not using the right InnerIterator type, e.g.: + // SparseMatrix A; + // SparseMatrix::InnerIterator it(A,0); + template InnerIterator(const EigenBase&,Index outer); +}; + +namespace internal { + +// Generic inner iterator implementation for dense objects +template +class inner_iterator_selector +{ +protected: + typedef evaluator EvaluatorType; + typedef typename traits::Scalar Scalar; + enum { IsRowMajor = (XprType::Flags&RowMajorBit)==RowMajorBit }; + +public: + EIGEN_STRONG_INLINE inner_iterator_selector(const EvaluatorType &eval, const Index &outerId, const Index &innerSize) + : m_eval(eval), m_inner(0), m_outer(outerId), m_end(innerSize) + {} + + EIGEN_STRONG_INLINE Scalar value() const + { + return (IsRowMajor) ? m_eval.coeff(m_outer, m_inner) + : m_eval.coeff(m_inner, m_outer); + } + + EIGEN_STRONG_INLINE inner_iterator_selector& operator++() { m_inner++; return *this; } + + EIGEN_STRONG_INLINE Index index() const { return m_inner; } + inline Index row() const { return IsRowMajor ? m_outer : index(); } + inline Index col() const { return IsRowMajor ? index() : m_outer; } + + EIGEN_STRONG_INLINE operator bool() const { return m_inner < m_end && m_inner>=0; } + +protected: + const EvaluatorType& m_eval; + Index m_inner; + const Index m_outer; + const Index m_end; +}; + +// For iterator-based evaluator, inner-iterator is already implemented as +// evaluator<>::InnerIterator +template +class inner_iterator_selector + : public evaluator::InnerIterator +{ +protected: + typedef typename evaluator::InnerIterator Base; + typedef evaluator EvaluatorType; + +public: + EIGEN_STRONG_INLINE inner_iterator_selector(const EvaluatorType &eval, const Index &outerId, const Index &/*innerSize*/) + : Base(eval, outerId) + {} +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_COREITERATORS_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseBinaryOp.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseBinaryOp.h new file mode 100644 index 0000000..2202b1c --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseBinaryOp.h @@ -0,0 +1,183 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2014 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_BINARY_OP_H +#define EIGEN_CWISE_BINARY_OP_H + +namespace Eigen { + +namespace internal { +template +struct traits > +{ + // we must not inherit from traits since it has + // the potential to cause problems with MSVC + typedef typename remove_all::type Ancestor; + typedef typename traits::XprKind XprKind; + enum { + RowsAtCompileTime = traits::RowsAtCompileTime, + ColsAtCompileTime = traits::ColsAtCompileTime, + MaxRowsAtCompileTime = traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = traits::MaxColsAtCompileTime + }; + + // even though we require Lhs and Rhs to have the same scalar type (see CwiseBinaryOp constructor), + // we still want to handle the case when the result type is different. + typedef typename result_of< + BinaryOp( + const typename Lhs::Scalar&, + const typename Rhs::Scalar& + ) + >::type Scalar; + typedef typename cwise_promote_storage_type::StorageKind, + typename traits::StorageKind, + BinaryOp>::ret StorageKind; + typedef typename promote_index_type::StorageIndex, + typename traits::StorageIndex>::type StorageIndex; + typedef typename Lhs::Nested LhsNested; + typedef typename Rhs::Nested RhsNested; + typedef typename remove_reference::type _LhsNested; + typedef typename remove_reference::type _RhsNested; + enum { + Flags = cwise_promote_storage_order::StorageKind,typename traits::StorageKind,_LhsNested::Flags & RowMajorBit,_RhsNested::Flags & RowMajorBit>::value + }; +}; +} // end namespace internal + +template +class CwiseBinaryOpImpl; + +/** \class CwiseBinaryOp + * \ingroup Core_Module + * + * \brief Generic expression where a coefficient-wise binary operator is applied to two expressions + * + * \tparam BinaryOp template functor implementing the operator + * \tparam LhsType the type of the left-hand side + * \tparam RhsType the type of the right-hand side + * + * This class represents an expression where a coefficient-wise binary operator is applied to two expressions. + * It is the return type of binary operators, by which we mean only those binary operators where + * both the left-hand side and the right-hand side are Eigen expressions. + * For example, the return type of matrix1+matrix2 is a CwiseBinaryOp. + * + * Most of the time, this is the only way that it is used, so you typically don't have to name + * CwiseBinaryOp types explicitly. + * + * \sa MatrixBase::binaryExpr(const MatrixBase &,const CustomBinaryOp &) const, class CwiseUnaryOp, class CwiseNullaryOp + */ +template +class CwiseBinaryOp : + public CwiseBinaryOpImpl< + BinaryOp, LhsType, RhsType, + typename internal::cwise_promote_storage_type::StorageKind, + typename internal::traits::StorageKind, + BinaryOp>::ret>, + internal::no_assignment_operator +{ + public: + + typedef typename internal::remove_all::type Functor; + typedef typename internal::remove_all::type Lhs; + typedef typename internal::remove_all::type Rhs; + + typedef typename CwiseBinaryOpImpl< + BinaryOp, LhsType, RhsType, + typename internal::cwise_promote_storage_type::StorageKind, + typename internal::traits::StorageKind, + BinaryOp>::ret>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(CwiseBinaryOp) + + typedef typename internal::ref_selector::type LhsNested; + typedef typename internal::ref_selector::type RhsNested; + typedef typename internal::remove_reference::type _LhsNested; + typedef typename internal::remove_reference::type _RhsNested; + +#if EIGEN_COMP_MSVC && EIGEN_HAS_CXX11 + //Required for Visual Studio or the Copy constructor will probably not get inlined! + EIGEN_STRONG_INLINE + CwiseBinaryOp(const CwiseBinaryOp&) = default; +#endif + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CwiseBinaryOp(const Lhs& aLhs, const Rhs& aRhs, const BinaryOp& func = BinaryOp()) + : m_lhs(aLhs), m_rhs(aRhs), m_functor(func) + { + EIGEN_CHECK_BINARY_COMPATIBILIY(BinaryOp,typename Lhs::Scalar,typename Rhs::Scalar); + // require the sizes to match + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Lhs, Rhs) + eigen_assert(aLhs.rows() == aRhs.rows() && aLhs.cols() == aRhs.cols()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rows() const EIGEN_NOEXCEPT { + // return the fixed size type if available to enable compile time optimizations + return internal::traits::type>::RowsAtCompileTime==Dynamic ? m_rhs.rows() : m_lhs.rows(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index cols() const EIGEN_NOEXCEPT { + // return the fixed size type if available to enable compile time optimizations + return internal::traits::type>::ColsAtCompileTime==Dynamic ? m_rhs.cols() : m_lhs.cols(); + } + + /** \returns the left hand side nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const _LhsNested& lhs() const { return m_lhs; } + /** \returns the right hand side nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const _RhsNested& rhs() const { return m_rhs; } + /** \returns the functor representing the binary operation */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const BinaryOp& functor() const { return m_functor; } + + protected: + LhsNested m_lhs; + RhsNested m_rhs; + const BinaryOp m_functor; +}; + +// Generic API dispatcher +template +class CwiseBinaryOpImpl + : public internal::generic_xpr_base >::type +{ +public: + typedef typename internal::generic_xpr_base >::type Base; +}; + +/** replaces \c *this by \c *this - \a other. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived & +MatrixBase::operator-=(const MatrixBase &other) +{ + call_assignment(derived(), other.derived(), internal::sub_assign_op()); + return derived(); +} + +/** replaces \c *this by \c *this + \a other. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived & +MatrixBase::operator+=(const MatrixBase& other) +{ + call_assignment(derived(), other.derived(), internal::add_assign_op()); + return derived(); +} + +} // end namespace Eigen + +#endif // EIGEN_CWISE_BINARY_OP_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseNullaryOp.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseNullaryOp.h new file mode 100644 index 0000000..289ec51 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseNullaryOp.h @@ -0,0 +1,1001 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_NULLARY_OP_H +#define EIGEN_CWISE_NULLARY_OP_H + +namespace Eigen { + +namespace internal { +template +struct traits > : traits +{ + enum { + Flags = traits::Flags & RowMajorBit + }; +}; + +} // namespace internal + +/** \class CwiseNullaryOp + * \ingroup Core_Module + * + * \brief Generic expression of a matrix where all coefficients are defined by a functor + * + * \tparam NullaryOp template functor implementing the operator + * \tparam PlainObjectType the underlying plain matrix/array type + * + * This class represents an expression of a generic nullary operator. + * It is the return type of the Ones(), Zero(), Constant(), Identity() and Random() methods, + * and most of the time this is the only way it is used. + * + * However, if you want to write a function returning such an expression, you + * will need to use this class. + * + * The functor NullaryOp must expose one of the following method: + + + + +
\c operator()() if the procedural generation does not depend on the coefficient entries (e.g., random numbers)
\c operator()(Index i)if the procedural generation makes sense for vectors only and that it depends on the coefficient index \c i (e.g., linspace)
\c operator()(Index i,Index j)if the procedural generation depends on the matrix coordinates \c i, \c j (e.g., to generate a checkerboard with 0 and 1)
+ * It is also possible to expose the last two operators if the generation makes sense for matrices but can be optimized for vectors. + * + * See DenseBase::NullaryExpr(Index,const CustomNullaryOp&) for an example binding + * C++11 random number generators. + * + * A nullary expression can also be used to implement custom sophisticated matrix manipulations + * that cannot be covered by the existing set of natively supported matrix manipulations. + * See this \ref TopicCustomizing_NullaryExpr "page" for some examples and additional explanations + * on the behavior of CwiseNullaryOp. + * + * \sa class CwiseUnaryOp, class CwiseBinaryOp, DenseBase::NullaryExpr + */ +template +class CwiseNullaryOp : public internal::dense_xpr_base< CwiseNullaryOp >::type, internal::no_assignment_operator +{ + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(CwiseNullaryOp) + + EIGEN_DEVICE_FUNC + CwiseNullaryOp(Index rows, Index cols, const NullaryOp& func = NullaryOp()) + : m_rows(rows), m_cols(cols), m_functor(func) + { + eigen_assert(rows >= 0 + && (RowsAtCompileTime == Dynamic || RowsAtCompileTime == rows) + && cols >= 0 + && (ColsAtCompileTime == Dynamic || ColsAtCompileTime == cols)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rows() const { return m_rows.value(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index cols() const { return m_cols.value(); } + + /** \returns the functor representing the nullary operation */ + EIGEN_DEVICE_FUNC + const NullaryOp& functor() const { return m_functor; } + + protected: + const internal::variable_if_dynamic m_rows; + const internal::variable_if_dynamic m_cols; + const NullaryOp m_functor; +}; + + +/** \returns an expression of a matrix defined by a custom functor \a func + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Zero() should be used + * instead. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +#ifndef EIGEN_PARSED_BY_DOXYGEN +const CwiseNullaryOp::PlainObject> +#else +const CwiseNullaryOp +#endif +DenseBase::NullaryExpr(Index rows, Index cols, const CustomNullaryOp& func) +{ + return CwiseNullaryOp(rows, cols, func); +} + +/** \returns an expression of a matrix defined by a custom functor \a func + * + * The parameter \a size is the size of the returned vector. + * Must be compatible with this MatrixBase type. + * + * \only_for_vectors + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Zero() should be used + * instead. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * Here is an example with C++11 random generators: \include random_cpp11.cpp + * Output: \verbinclude random_cpp11.out + * + * \sa class CwiseNullaryOp + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +#ifndef EIGEN_PARSED_BY_DOXYGEN +const CwiseNullaryOp::PlainObject> +#else +const CwiseNullaryOp +#endif +DenseBase::NullaryExpr(Index size, const CustomNullaryOp& func) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + if(RowsAtCompileTime == 1) return CwiseNullaryOp(1, size, func); + else return CwiseNullaryOp(size, 1, func); +} + +/** \returns an expression of a matrix defined by a custom functor \a func + * + * This variant is only for fixed-size DenseBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +#ifndef EIGEN_PARSED_BY_DOXYGEN +const CwiseNullaryOp::PlainObject> +#else +const CwiseNullaryOp +#endif +DenseBase::NullaryExpr(const CustomNullaryOp& func) +{ + return CwiseNullaryOp(RowsAtCompileTime, ColsAtCompileTime, func); +} + +/** \returns an expression of a constant matrix of value \a value + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this DenseBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Zero() should be used + * instead. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Constant(Index rows, Index cols, const Scalar& value) +{ + return DenseBase::NullaryExpr(rows, cols, internal::scalar_constant_op(value)); +} + +/** \returns an expression of a constant matrix of value \a value + * + * The parameter \a size is the size of the returned vector. + * Must be compatible with this DenseBase type. + * + * \only_for_vectors + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Zero() should be used + * instead. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Constant(Index size, const Scalar& value) +{ + return DenseBase::NullaryExpr(size, internal::scalar_constant_op(value)); +} + +/** \returns an expression of a constant matrix of value \a value + * + * This variant is only for fixed-size DenseBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Constant(const Scalar& value) +{ + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + return DenseBase::NullaryExpr(RowsAtCompileTime, ColsAtCompileTime, internal::scalar_constant_op(value)); +} + +/** \deprecated because of accuracy loss. In Eigen 3.3, it is an alias for LinSpaced(Index,const Scalar&,const Scalar&) + * + * \only_for_vectors + * + * Example: \include DenseBase_LinSpaced_seq_deprecated.cpp + * Output: \verbinclude DenseBase_LinSpaced_seq_deprecated.out + * + * \sa LinSpaced(Index,const Scalar&, const Scalar&), setLinSpaced(Index,const Scalar&,const Scalar&) + */ +template +EIGEN_DEPRECATED EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessLinSpacedReturnType +DenseBase::LinSpaced(Sequential_t, Index size, const Scalar& low, const Scalar& high) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return DenseBase::NullaryExpr(size, internal::linspaced_op(low,high,size)); +} + +/** \deprecated because of accuracy loss. In Eigen 3.3, it is an alias for LinSpaced(const Scalar&,const Scalar&) + * + * \sa LinSpaced(const Scalar&, const Scalar&) + */ +template +EIGEN_DEPRECATED EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessLinSpacedReturnType +DenseBase::LinSpaced(Sequential_t, const Scalar& low, const Scalar& high) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + return DenseBase::NullaryExpr(Derived::SizeAtCompileTime, internal::linspaced_op(low,high,Derived::SizeAtCompileTime)); +} + +/** + * \brief Sets a linearly spaced vector. + * + * The function generates 'size' equally spaced values in the closed interval [low,high]. + * When size is set to 1, a vector of length 1 containing 'high' is returned. + * + * \only_for_vectors + * + * Example: \include DenseBase_LinSpaced.cpp + * Output: \verbinclude DenseBase_LinSpaced.out + * + * For integer scalar types, an even spacing is possible if and only if the length of the range, + * i.e., \c high-low is a scalar multiple of \c size-1, or if \c size is a scalar multiple of the + * number of values \c high-low+1 (meaning each value can be repeated the same number of time). + * If one of these two considions is not satisfied, then \c high is lowered to the largest value + * satisfying one of this constraint. + * Here are some examples: + * + * Example: \include DenseBase_LinSpacedInt.cpp + * Output: \verbinclude DenseBase_LinSpacedInt.out + * + * \sa setLinSpaced(Index,const Scalar&,const Scalar&), CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessLinSpacedReturnType +DenseBase::LinSpaced(Index size, const Scalar& low, const Scalar& high) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return DenseBase::NullaryExpr(size, internal::linspaced_op(low,high,size)); +} + +/** + * \copydoc DenseBase::LinSpaced(Index, const Scalar&, const Scalar&) + * Special version for fixed size types which does not require the size parameter. + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessLinSpacedReturnType +DenseBase::LinSpaced(const Scalar& low, const Scalar& high) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + return DenseBase::NullaryExpr(Derived::SizeAtCompileTime, internal::linspaced_op(low,high,Derived::SizeAtCompileTime)); +} + +/** \returns true if all coefficients in this matrix are approximately equal to \a val, to within precision \a prec */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isApproxToConstant +(const Scalar& val, const RealScalar& prec) const +{ + typename internal::nested_eval::type self(derived()); + for(Index j = 0; j < cols(); ++j) + for(Index i = 0; i < rows(); ++i) + if(!internal::isApprox(self.coeff(i, j), val, prec)) + return false; + return true; +} + +/** This is just an alias for isApproxToConstant(). + * + * \returns true if all coefficients in this matrix are approximately equal to \a value, to within precision \a prec */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isConstant +(const Scalar& val, const RealScalar& prec) const +{ + return isApproxToConstant(val, prec); +} + +/** Alias for setConstant(): sets all coefficients in this expression to \a val. + * + * \sa setConstant(), Constant(), class CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void DenseBase::fill(const Scalar& val) +{ + setConstant(val); +} + +/** Sets all coefficients in this expression to value \a val. + * + * \sa fill(), setConstant(Index,const Scalar&), setConstant(Index,Index,const Scalar&), setZero(), setOnes(), Constant(), class CwiseNullaryOp, setZero(), setOnes() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setConstant(const Scalar& val) +{ + return derived() = Constant(rows(), cols(), val); +} + +/** Resizes to the given \a size, and sets all coefficients in this expression to the given value \a val. + * + * \only_for_vectors + * + * Example: \include Matrix_setConstant_int.cpp + * Output: \verbinclude Matrix_setConstant_int.out + * + * \sa MatrixBase::setConstant(const Scalar&), setConstant(Index,Index,const Scalar&), class CwiseNullaryOp, MatrixBase::Constant(const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setConstant(Index size, const Scalar& val) +{ + resize(size); + return setConstant(val); +} + +/** Resizes to the given size, and sets all coefficients in this expression to the given value \a val. + * + * \param rows the new number of rows + * \param cols the new number of columns + * \param val the value to which all coefficients are set + * + * Example: \include Matrix_setConstant_int_int.cpp + * Output: \verbinclude Matrix_setConstant_int_int.out + * + * \sa MatrixBase::setConstant(const Scalar&), setConstant(Index,const Scalar&), class CwiseNullaryOp, MatrixBase::Constant(const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setConstant(Index rows, Index cols, const Scalar& val) +{ + resize(rows, cols); + return setConstant(val); +} + +/** Resizes to the given size, changing only the number of columns, and sets all + * coefficients in this expression to the given value \a val. For the parameter + * of type NoChange_t, just pass the special value \c NoChange. + * + * \sa MatrixBase::setConstant(const Scalar&), setConstant(Index,const Scalar&), class CwiseNullaryOp, MatrixBase::Constant(const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setConstant(NoChange_t, Index cols, const Scalar& val) +{ + return setConstant(rows(), cols, val); +} + +/** Resizes to the given size, changing only the number of rows, and sets all + * coefficients in this expression to the given value \a val. For the parameter + * of type NoChange_t, just pass the special value \c NoChange. + * + * \sa MatrixBase::setConstant(const Scalar&), setConstant(Index,const Scalar&), class CwiseNullaryOp, MatrixBase::Constant(const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setConstant(Index rows, NoChange_t, const Scalar& val) +{ + return setConstant(rows, cols(), val); +} + + +/** + * \brief Sets a linearly spaced vector. + * + * The function generates 'size' equally spaced values in the closed interval [low,high]. + * When size is set to 1, a vector of length 1 containing 'high' is returned. + * + * \only_for_vectors + * + * Example: \include DenseBase_setLinSpaced.cpp + * Output: \verbinclude DenseBase_setLinSpaced.out + * + * For integer scalar types, do not miss the explanations on the definition + * of \link LinSpaced(Index,const Scalar&,const Scalar&) even spacing \endlink. + * + * \sa LinSpaced(Index,const Scalar&,const Scalar&), CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setLinSpaced(Index newSize, const Scalar& low, const Scalar& high) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return derived() = Derived::NullaryExpr(newSize, internal::linspaced_op(low,high,newSize)); +} + +/** + * \brief Sets a linearly spaced vector. + * + * The function fills \c *this with equally spaced values in the closed interval [low,high]. + * When size is set to 1, a vector of length 1 containing 'high' is returned. + * + * \only_for_vectors + * + * For integer scalar types, do not miss the explanations on the definition + * of \link LinSpaced(Index,const Scalar&,const Scalar&) even spacing \endlink. + * + * \sa LinSpaced(Index,const Scalar&,const Scalar&), setLinSpaced(Index, const Scalar&, const Scalar&), CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setLinSpaced(const Scalar& low, const Scalar& high) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return setLinSpaced(size(), low, high); +} + +// zero: + +/** \returns an expression of a zero matrix. + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Zero() should be used + * instead. + * + * Example: \include MatrixBase_zero_int_int.cpp + * Output: \verbinclude MatrixBase_zero_int_int.out + * + * \sa Zero(), Zero(Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Zero(Index rows, Index cols) +{ + return Constant(rows, cols, Scalar(0)); +} + +/** \returns an expression of a zero vector. + * + * The parameter \a size is the size of the returned vector. + * Must be compatible with this MatrixBase type. + * + * \only_for_vectors + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Zero() should be used + * instead. + * + * Example: \include MatrixBase_zero_int.cpp + * Output: \verbinclude MatrixBase_zero_int.out + * + * \sa Zero(), Zero(Index,Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Zero(Index size) +{ + return Constant(size, Scalar(0)); +} + +/** \returns an expression of a fixed-size zero matrix or vector. + * + * This variant is only for fixed-size MatrixBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * Example: \include MatrixBase_zero.cpp + * Output: \verbinclude MatrixBase_zero.out + * + * \sa Zero(Index), Zero(Index,Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Zero() +{ + return Constant(Scalar(0)); +} + +/** \returns true if *this is approximately equal to the zero matrix, + * within the precision given by \a prec. + * + * Example: \include MatrixBase_isZero.cpp + * Output: \verbinclude MatrixBase_isZero.out + * + * \sa class CwiseNullaryOp, Zero() + */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isZero(const RealScalar& prec) const +{ + typename internal::nested_eval::type self(derived()); + for(Index j = 0; j < cols(); ++j) + for(Index i = 0; i < rows(); ++i) + if(!internal::isMuchSmallerThan(self.coeff(i, j), static_cast(1), prec)) + return false; + return true; +} + +/** Sets all coefficients in this expression to zero. + * + * Example: \include MatrixBase_setZero.cpp + * Output: \verbinclude MatrixBase_setZero.out + * + * \sa class CwiseNullaryOp, Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setZero() +{ + return setConstant(Scalar(0)); +} + +/** Resizes to the given \a size, and sets all coefficients in this expression to zero. + * + * \only_for_vectors + * + * Example: \include Matrix_setZero_int.cpp + * Output: \verbinclude Matrix_setZero_int.out + * + * \sa DenseBase::setZero(), setZero(Index,Index), class CwiseNullaryOp, DenseBase::Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setZero(Index newSize) +{ + resize(newSize); + return setConstant(Scalar(0)); +} + +/** Resizes to the given size, and sets all coefficients in this expression to zero. + * + * \param rows the new number of rows + * \param cols the new number of columns + * + * Example: \include Matrix_setZero_int_int.cpp + * Output: \verbinclude Matrix_setZero_int_int.out + * + * \sa DenseBase::setZero(), setZero(Index), class CwiseNullaryOp, DenseBase::Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setZero(Index rows, Index cols) +{ + resize(rows, cols); + return setConstant(Scalar(0)); +} + +/** Resizes to the given size, changing only the number of columns, and sets all + * coefficients in this expression to zero. For the parameter of type NoChange_t, + * just pass the special value \c NoChange. + * + * \sa DenseBase::setZero(), setZero(Index), setZero(Index, Index), setZero(Index, NoChange_t), class CwiseNullaryOp, DenseBase::Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setZero(NoChange_t, Index cols) +{ + return setZero(rows(), cols); +} + +/** Resizes to the given size, changing only the number of rows, and sets all + * coefficients in this expression to zero. For the parameter of type NoChange_t, + * just pass the special value \c NoChange. + * + * \sa DenseBase::setZero(), setZero(Index), setZero(Index, Index), setZero(NoChange_t, Index), class CwiseNullaryOp, DenseBase::Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setZero(Index rows, NoChange_t) +{ + return setZero(rows, cols()); +} + +// ones: + +/** \returns an expression of a matrix where all coefficients equal one. + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Ones() should be used + * instead. + * + * Example: \include MatrixBase_ones_int_int.cpp + * Output: \verbinclude MatrixBase_ones_int_int.out + * + * \sa Ones(), Ones(Index), isOnes(), class Ones + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Ones(Index rows, Index cols) +{ + return Constant(rows, cols, Scalar(1)); +} + +/** \returns an expression of a vector where all coefficients equal one. + * + * The parameter \a newSize is the size of the returned vector. + * Must be compatible with this MatrixBase type. + * + * \only_for_vectors + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Ones() should be used + * instead. + * + * Example: \include MatrixBase_ones_int.cpp + * Output: \verbinclude MatrixBase_ones_int.out + * + * \sa Ones(), Ones(Index,Index), isOnes(), class Ones + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Ones(Index newSize) +{ + return Constant(newSize, Scalar(1)); +} + +/** \returns an expression of a fixed-size matrix or vector where all coefficients equal one. + * + * This variant is only for fixed-size MatrixBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * Example: \include MatrixBase_ones.cpp + * Output: \verbinclude MatrixBase_ones.out + * + * \sa Ones(Index), Ones(Index,Index), isOnes(), class Ones + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Ones() +{ + return Constant(Scalar(1)); +} + +/** \returns true if *this is approximately equal to the matrix where all coefficients + * are equal to 1, within the precision given by \a prec. + * + * Example: \include MatrixBase_isOnes.cpp + * Output: \verbinclude MatrixBase_isOnes.out + * + * \sa class CwiseNullaryOp, Ones() + */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isOnes +(const RealScalar& prec) const +{ + return isApproxToConstant(Scalar(1), prec); +} + +/** Sets all coefficients in this expression to one. + * + * Example: \include MatrixBase_setOnes.cpp + * Output: \verbinclude MatrixBase_setOnes.out + * + * \sa class CwiseNullaryOp, Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setOnes() +{ + return setConstant(Scalar(1)); +} + +/** Resizes to the given \a newSize, and sets all coefficients in this expression to one. + * + * \only_for_vectors + * + * Example: \include Matrix_setOnes_int.cpp + * Output: \verbinclude Matrix_setOnes_int.out + * + * \sa MatrixBase::setOnes(), setOnes(Index,Index), class CwiseNullaryOp, MatrixBase::Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setOnes(Index newSize) +{ + resize(newSize); + return setConstant(Scalar(1)); +} + +/** Resizes to the given size, and sets all coefficients in this expression to one. + * + * \param rows the new number of rows + * \param cols the new number of columns + * + * Example: \include Matrix_setOnes_int_int.cpp + * Output: \verbinclude Matrix_setOnes_int_int.out + * + * \sa MatrixBase::setOnes(), setOnes(Index), class CwiseNullaryOp, MatrixBase::Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setOnes(Index rows, Index cols) +{ + resize(rows, cols); + return setConstant(Scalar(1)); +} + +/** Resizes to the given size, changing only the number of rows, and sets all + * coefficients in this expression to one. For the parameter of type NoChange_t, + * just pass the special value \c NoChange. + * + * \sa MatrixBase::setOnes(), setOnes(Index), setOnes(Index, Index), setOnes(NoChange_t, Index), class CwiseNullaryOp, MatrixBase::Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setOnes(Index rows, NoChange_t) +{ + return setOnes(rows, cols()); +} + +/** Resizes to the given size, changing only the number of columns, and sets all + * coefficients in this expression to one. For the parameter of type NoChange_t, + * just pass the special value \c NoChange. + * + * \sa MatrixBase::setOnes(), setOnes(Index), setOnes(Index, Index), setOnes(Index, NoChange_t) class CwiseNullaryOp, MatrixBase::Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setOnes(NoChange_t, Index cols) +{ + return setOnes(rows(), cols); +} + +// Identity: + +/** \returns an expression of the identity matrix (not necessarily square). + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Identity() should be used + * instead. + * + * Example: \include MatrixBase_identity_int_int.cpp + * Output: \verbinclude MatrixBase_identity_int_int.out + * + * \sa Identity(), setIdentity(), isIdentity() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::IdentityReturnType +MatrixBase::Identity(Index rows, Index cols) +{ + return DenseBase::NullaryExpr(rows, cols, internal::scalar_identity_op()); +} + +/** \returns an expression of the identity matrix (not necessarily square). + * + * This variant is only for fixed-size MatrixBase types. For dynamic-size types, you + * need to use the variant taking size arguments. + * + * Example: \include MatrixBase_identity.cpp + * Output: \verbinclude MatrixBase_identity.out + * + * \sa Identity(Index,Index), setIdentity(), isIdentity() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::IdentityReturnType +MatrixBase::Identity() +{ + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + return MatrixBase::NullaryExpr(RowsAtCompileTime, ColsAtCompileTime, internal::scalar_identity_op()); +} + +/** \returns true if *this is approximately equal to the identity matrix + * (not necessarily square), + * within the precision given by \a prec. + * + * Example: \include MatrixBase_isIdentity.cpp + * Output: \verbinclude MatrixBase_isIdentity.out + * + * \sa class CwiseNullaryOp, Identity(), Identity(Index,Index), setIdentity() + */ +template +bool MatrixBase::isIdentity +(const RealScalar& prec) const +{ + typename internal::nested_eval::type self(derived()); + for(Index j = 0; j < cols(); ++j) + { + for(Index i = 0; i < rows(); ++i) + { + if(i == j) + { + if(!internal::isApprox(self.coeff(i, j), static_cast(1), prec)) + return false; + } + else + { + if(!internal::isMuchSmallerThan(self.coeff(i, j), static_cast(1), prec)) + return false; + } + } + } + return true; +} + +namespace internal { + +template=16)> +struct setIdentity_impl +{ + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE Derived& run(Derived& m) + { + return m = Derived::Identity(m.rows(), m.cols()); + } +}; + +template +struct setIdentity_impl +{ + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE Derived& run(Derived& m) + { + m.setZero(); + const Index size = numext::mini(m.rows(), m.cols()); + for(Index i = 0; i < size; ++i) m.coeffRef(i,i) = typename Derived::Scalar(1); + return m; + } +}; + +} // end namespace internal + +/** Writes the identity expression (not necessarily square) into *this. + * + * Example: \include MatrixBase_setIdentity.cpp + * Output: \verbinclude MatrixBase_setIdentity.out + * + * \sa class CwiseNullaryOp, Identity(), Identity(Index,Index), isIdentity() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::setIdentity() +{ + return internal::setIdentity_impl::run(derived()); +} + +/** \brief Resizes to the given size, and writes the identity expression (not necessarily square) into *this. + * + * \param rows the new number of rows + * \param cols the new number of columns + * + * Example: \include Matrix_setIdentity_int_int.cpp + * Output: \verbinclude Matrix_setIdentity_int_int.out + * + * \sa MatrixBase::setIdentity(), class CwiseNullaryOp, MatrixBase::Identity() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::setIdentity(Index rows, Index cols) +{ + derived().resize(rows, cols); + return setIdentity(); +} + +/** \returns an expression of the i-th unit (basis) vector. + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index), MatrixBase::UnitX(), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::Unit(Index newSize, Index i) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return BasisReturnType(SquareMatrixType::Identity(newSize,newSize), i); +} + +/** \returns an expression of the i-th unit (basis) vector. + * + * \only_for_vectors + * + * This variant is for fixed-size vector only. + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::UnitX(), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::Unit(Index i) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return BasisReturnType(SquareMatrixType::Identity(),i); +} + +/** \returns an expression of the X axis unit vector (1{,0}^*) + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::Unit(Index), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::UnitX() +{ return Derived::Unit(0); } + +/** \returns an expression of the Y axis unit vector (0,1{,0}^*) + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::Unit(Index), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::UnitY() +{ return Derived::Unit(1); } + +/** \returns an expression of the Z axis unit vector (0,0,1{,0}^*) + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::Unit(Index), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::UnitZ() +{ return Derived::Unit(2); } + +/** \returns an expression of the W axis unit vector (0,0,0,1) + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::Unit(Index), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::UnitW() +{ return Derived::Unit(3); } + +/** \brief Set the coefficients of \c *this to the i-th unit (basis) vector + * + * \param i index of the unique coefficient to be set to 1 + * + * \only_for_vectors + * + * \sa MatrixBase::setIdentity(), class CwiseNullaryOp, MatrixBase::Unit(Index,Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::setUnit(Index i) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived); + eigen_assert(i +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::setUnit(Index newSize, Index i) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived); + eigen_assert(i +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2016 Eugene Brevdo +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_TERNARY_OP_H +#define EIGEN_CWISE_TERNARY_OP_H + +namespace Eigen { + +namespace internal { +template +struct traits > { + // we must not inherit from traits since it has + // the potential to cause problems with MSVC + typedef typename remove_all::type Ancestor; + typedef typename traits::XprKind XprKind; + enum { + RowsAtCompileTime = traits::RowsAtCompileTime, + ColsAtCompileTime = traits::ColsAtCompileTime, + MaxRowsAtCompileTime = traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = traits::MaxColsAtCompileTime + }; + + // even though we require Arg1, Arg2, and Arg3 to have the same scalar type + // (see CwiseTernaryOp constructor), + // we still want to handle the case when the result type is different. + typedef typename result_of::type Scalar; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + + typedef typename Arg1::Nested Arg1Nested; + typedef typename Arg2::Nested Arg2Nested; + typedef typename Arg3::Nested Arg3Nested; + typedef typename remove_reference::type _Arg1Nested; + typedef typename remove_reference::type _Arg2Nested; + typedef typename remove_reference::type _Arg3Nested; + enum { Flags = _Arg1Nested::Flags & RowMajorBit }; +}; +} // end namespace internal + +template +class CwiseTernaryOpImpl; + +/** \class CwiseTernaryOp + * \ingroup Core_Module + * + * \brief Generic expression where a coefficient-wise ternary operator is + * applied to two expressions + * + * \tparam TernaryOp template functor implementing the operator + * \tparam Arg1Type the type of the first argument + * \tparam Arg2Type the type of the second argument + * \tparam Arg3Type the type of the third argument + * + * This class represents an expression where a coefficient-wise ternary + * operator is applied to three expressions. + * It is the return type of ternary operators, by which we mean only those + * ternary operators where + * all three arguments are Eigen expressions. + * For example, the return type of betainc(matrix1, matrix2, matrix3) is a + * CwiseTernaryOp. + * + * Most of the time, this is the only way that it is used, so you typically + * don't have to name + * CwiseTernaryOp types explicitly. + * + * \sa MatrixBase::ternaryExpr(const MatrixBase &, const + * MatrixBase &, const CustomTernaryOp &) const, class CwiseBinaryOp, + * class CwiseUnaryOp, class CwiseNullaryOp + */ +template +class CwiseTernaryOp : public CwiseTernaryOpImpl< + TernaryOp, Arg1Type, Arg2Type, Arg3Type, + typename internal::traits::StorageKind>, + internal::no_assignment_operator +{ + public: + typedef typename internal::remove_all::type Arg1; + typedef typename internal::remove_all::type Arg2; + typedef typename internal::remove_all::type Arg3; + + typedef typename CwiseTernaryOpImpl< + TernaryOp, Arg1Type, Arg2Type, Arg3Type, + typename internal::traits::StorageKind>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(CwiseTernaryOp) + + typedef typename internal::ref_selector::type Arg1Nested; + typedef typename internal::ref_selector::type Arg2Nested; + typedef typename internal::ref_selector::type Arg3Nested; + typedef typename internal::remove_reference::type _Arg1Nested; + typedef typename internal::remove_reference::type _Arg2Nested; + typedef typename internal::remove_reference::type _Arg3Nested; + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CwiseTernaryOp(const Arg1& a1, const Arg2& a2, + const Arg3& a3, + const TernaryOp& func = TernaryOp()) + : m_arg1(a1), m_arg2(a2), m_arg3(a3), m_functor(func) { + // require the sizes to match + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Arg1, Arg2) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Arg1, Arg3) + + // The index types should match + EIGEN_STATIC_ASSERT((internal::is_same< + typename internal::traits::StorageKind, + typename internal::traits::StorageKind>::value), + STORAGE_KIND_MUST_MATCH) + EIGEN_STATIC_ASSERT((internal::is_same< + typename internal::traits::StorageKind, + typename internal::traits::StorageKind>::value), + STORAGE_KIND_MUST_MATCH) + + eigen_assert(a1.rows() == a2.rows() && a1.cols() == a2.cols() && + a1.rows() == a3.rows() && a1.cols() == a3.cols()); + } + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Index rows() const { + // return the fixed size type if available to enable compile time + // optimizations + if (internal::traits::type>:: + RowsAtCompileTime == Dynamic && + internal::traits::type>:: + RowsAtCompileTime == Dynamic) + return m_arg3.rows(); + else if (internal::traits::type>:: + RowsAtCompileTime == Dynamic && + internal::traits::type>:: + RowsAtCompileTime == Dynamic) + return m_arg2.rows(); + else + return m_arg1.rows(); + } + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Index cols() const { + // return the fixed size type if available to enable compile time + // optimizations + if (internal::traits::type>:: + ColsAtCompileTime == Dynamic && + internal::traits::type>:: + ColsAtCompileTime == Dynamic) + return m_arg3.cols(); + else if (internal::traits::type>:: + ColsAtCompileTime == Dynamic && + internal::traits::type>:: + ColsAtCompileTime == Dynamic) + return m_arg2.cols(); + else + return m_arg1.cols(); + } + + /** \returns the first argument nested expression */ + EIGEN_DEVICE_FUNC + const _Arg1Nested& arg1() const { return m_arg1; } + /** \returns the first argument nested expression */ + EIGEN_DEVICE_FUNC + const _Arg2Nested& arg2() const { return m_arg2; } + /** \returns the third argument nested expression */ + EIGEN_DEVICE_FUNC + const _Arg3Nested& arg3() const { return m_arg3; } + /** \returns the functor representing the ternary operation */ + EIGEN_DEVICE_FUNC + const TernaryOp& functor() const { return m_functor; } + + protected: + Arg1Nested m_arg1; + Arg2Nested m_arg2; + Arg3Nested m_arg3; + const TernaryOp m_functor; +}; + +// Generic API dispatcher +template +class CwiseTernaryOpImpl + : public internal::generic_xpr_base< + CwiseTernaryOp >::type { + public: + typedef typename internal::generic_xpr_base< + CwiseTernaryOp >::type Base; +}; + +} // end namespace Eigen + +#endif // EIGEN_CWISE_TERNARY_OP_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseUnaryOp.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseUnaryOp.h new file mode 100644 index 0000000..e68c4f7 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseUnaryOp.h @@ -0,0 +1,103 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2014 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_UNARY_OP_H +#define EIGEN_CWISE_UNARY_OP_H + +namespace Eigen { + +namespace internal { +template +struct traits > + : traits +{ + typedef typename result_of< + UnaryOp(const typename XprType::Scalar&) + >::type Scalar; + typedef typename XprType::Nested XprTypeNested; + typedef typename remove_reference::type _XprTypeNested; + enum { + Flags = _XprTypeNested::Flags & RowMajorBit + }; +}; +} + +template +class CwiseUnaryOpImpl; + +/** \class CwiseUnaryOp + * \ingroup Core_Module + * + * \brief Generic expression where a coefficient-wise unary operator is applied to an expression + * + * \tparam UnaryOp template functor implementing the operator + * \tparam XprType the type of the expression to which we are applying the unary operator + * + * This class represents an expression where a unary operator is applied to an expression. + * It is the return type of all operations taking exactly 1 input expression, regardless of the + * presence of other inputs such as scalars. For example, the operator* in the expression 3*matrix + * is considered unary, because only the right-hand side is an expression, and its + * return type is a specialization of CwiseUnaryOp. + * + * Most of the time, this is the only way that it is used, so you typically don't have to name + * CwiseUnaryOp types explicitly. + * + * \sa MatrixBase::unaryExpr(const CustomUnaryOp &) const, class CwiseBinaryOp, class CwiseNullaryOp + */ +template +class CwiseUnaryOp : public CwiseUnaryOpImpl::StorageKind>, internal::no_assignment_operator +{ + public: + + typedef typename CwiseUnaryOpImpl::StorageKind>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(CwiseUnaryOp) + typedef typename internal::ref_selector::type XprTypeNested; + typedef typename internal::remove_all::type NestedExpression; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit CwiseUnaryOp(const XprType& xpr, const UnaryOp& func = UnaryOp()) + : m_xpr(xpr), m_functor(func) {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rows() const EIGEN_NOEXCEPT { return m_xpr.rows(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index cols() const EIGEN_NOEXCEPT { return m_xpr.cols(); } + + /** \returns the functor representing the unary operation */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const UnaryOp& functor() const { return m_functor; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const typename internal::remove_all::type& + nestedExpression() const { return m_xpr; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + typename internal::remove_all::type& + nestedExpression() { return m_xpr; } + + protected: + XprTypeNested m_xpr; + const UnaryOp m_functor; +}; + +// Generic API dispatcher +template +class CwiseUnaryOpImpl + : public internal::generic_xpr_base >::type +{ +public: + typedef typename internal::generic_xpr_base >::type Base; +}; + +} // end namespace Eigen + +#endif // EIGEN_CWISE_UNARY_OP_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseUnaryView.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseUnaryView.h new file mode 100644 index 0000000..a06d762 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/CwiseUnaryView.h @@ -0,0 +1,132 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_UNARY_VIEW_H +#define EIGEN_CWISE_UNARY_VIEW_H + +namespace Eigen { + +namespace internal { +template +struct traits > + : traits +{ + typedef typename result_of< + ViewOp(const typename traits::Scalar&) + >::type Scalar; + typedef typename MatrixType::Nested MatrixTypeNested; + typedef typename remove_all::type _MatrixTypeNested; + enum { + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + Flags = traits<_MatrixTypeNested>::Flags & (RowMajorBit | FlagsLvalueBit | DirectAccessBit), // FIXME DirectAccessBit should not be handled by expressions + MatrixTypeInnerStride = inner_stride_at_compile_time::ret, + // need to cast the sizeof's from size_t to int explicitly, otherwise: + // "error: no integral type can represent all of the enumerator values + InnerStrideAtCompileTime = MatrixTypeInnerStride == Dynamic + ? int(Dynamic) + : int(MatrixTypeInnerStride) * int(sizeof(typename traits::Scalar) / sizeof(Scalar)), + OuterStrideAtCompileTime = outer_stride_at_compile_time::ret == Dynamic + ? int(Dynamic) + : outer_stride_at_compile_time::ret * int(sizeof(typename traits::Scalar) / sizeof(Scalar)) + }; +}; +} + +template +class CwiseUnaryViewImpl; + +/** \class CwiseUnaryView + * \ingroup Core_Module + * + * \brief Generic lvalue expression of a coefficient-wise unary operator of a matrix or a vector + * + * \tparam ViewOp template functor implementing the view + * \tparam MatrixType the type of the matrix we are applying the unary operator + * + * This class represents a lvalue expression of a generic unary view operator of a matrix or a vector. + * It is the return type of real() and imag(), and most of the time this is the only way it is used. + * + * \sa MatrixBase::unaryViewExpr(const CustomUnaryOp &) const, class CwiseUnaryOp + */ +template +class CwiseUnaryView : public CwiseUnaryViewImpl::StorageKind> +{ + public: + + typedef typename CwiseUnaryViewImpl::StorageKind>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(CwiseUnaryView) + typedef typename internal::ref_selector::non_const_type MatrixTypeNested; + typedef typename internal::remove_all::type NestedExpression; + + explicit EIGEN_DEVICE_FUNC inline CwiseUnaryView(MatrixType& mat, const ViewOp& func = ViewOp()) + : m_matrix(mat), m_functor(func) {} + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(CwiseUnaryView) + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rows() const EIGEN_NOEXCEPT { return m_matrix.rows(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index cols() const EIGEN_NOEXCEPT { return m_matrix.cols(); } + + /** \returns the functor representing unary operation */ + EIGEN_DEVICE_FUNC const ViewOp& functor() const { return m_functor; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC const typename internal::remove_all::type& + nestedExpression() const { return m_matrix; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC typename internal::remove_reference::type& + nestedExpression() { return m_matrix; } + + protected: + MatrixTypeNested m_matrix; + ViewOp m_functor; +}; + +// Generic API dispatcher +template +class CwiseUnaryViewImpl + : public internal::generic_xpr_base >::type +{ +public: + typedef typename internal::generic_xpr_base >::type Base; +}; + +template +class CwiseUnaryViewImpl + : public internal::dense_xpr_base< CwiseUnaryView >::type +{ + public: + + typedef CwiseUnaryView Derived; + typedef typename internal::dense_xpr_base< CwiseUnaryView >::type Base; + + EIGEN_DENSE_PUBLIC_INTERFACE(Derived) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(CwiseUnaryViewImpl) + + EIGEN_DEVICE_FUNC inline Scalar* data() { return &(this->coeffRef(0)); } + EIGEN_DEVICE_FUNC inline const Scalar* data() const { return &(this->coeff(0)); } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR inline Index innerStride() const + { + return derived().nestedExpression().innerStride() * sizeof(typename internal::traits::Scalar) / sizeof(Scalar); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR inline Index outerStride() const + { + return derived().nestedExpression().outerStride() * sizeof(typename internal::traits::Scalar) / sizeof(Scalar); + } + protected: + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(CwiseUnaryViewImpl) +}; + +} // end namespace Eigen + +#endif // EIGEN_CWISE_UNARY_VIEW_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DenseBase.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DenseBase.h new file mode 100644 index 0000000..9b16db6 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DenseBase.h @@ -0,0 +1,701 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007-2010 Benoit Jacob +// Copyright (C) 2008-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DENSEBASE_H +#define EIGEN_DENSEBASE_H + +namespace Eigen { + +namespace internal { + +// The index type defined by EIGEN_DEFAULT_DENSE_INDEX_TYPE must be a signed type. +// This dummy function simply aims at checking that at compile time. +static inline void check_DenseIndex_is_signed() { + EIGEN_STATIC_ASSERT(NumTraits::IsSigned,THE_INDEX_TYPE_MUST_BE_A_SIGNED_TYPE) +} + +} // end namespace internal + +/** \class DenseBase + * \ingroup Core_Module + * + * \brief Base class for all dense matrices, vectors, and arrays + * + * This class is the base that is inherited by all dense objects (matrix, vector, arrays, + * and related expression types). The common Eigen API for dense objects is contained in this class. + * + * \tparam Derived is the derived type, e.g., a matrix type or an expression. + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_DENSEBASE_PLUGIN. + * + * \sa \blank \ref TopicClassHierarchy + */ +template class DenseBase +#ifndef EIGEN_PARSED_BY_DOXYGEN + : public DenseCoeffsBase::value> +#else + : public DenseCoeffsBase +#endif // not EIGEN_PARSED_BY_DOXYGEN +{ + public: + + /** Inner iterator type to iterate over the coefficients of a row or column. + * \sa class InnerIterator + */ + typedef Eigen::InnerIterator InnerIterator; + + typedef typename internal::traits::StorageKind StorageKind; + + /** + * \brief The type used to store indices + * \details This typedef is relevant for types that store multiple indices such as + * PermutationMatrix or Transpositions, otherwise it defaults to Eigen::Index + * \sa \blank \ref TopicPreprocessorDirectives, Eigen::Index, SparseMatrixBase. + */ + typedef typename internal::traits::StorageIndex StorageIndex; + + /** The numeric type of the expression' coefficients, e.g. float, double, int or std::complex, etc. */ + typedef typename internal::traits::Scalar Scalar; + + /** The numeric type of the expression' coefficients, e.g. float, double, int or std::complex, etc. + * + * It is an alias for the Scalar type */ + typedef Scalar value_type; + + typedef typename NumTraits::Real RealScalar; + typedef DenseCoeffsBase::value> Base; + + using Base::derived; + using Base::const_cast_derived; + using Base::rows; + using Base::cols; + using Base::size; + using Base::rowIndexByOuterInner; + using Base::colIndexByOuterInner; + using Base::coeff; + using Base::coeffByOuterInner; + using Base::operator(); + using Base::operator[]; + using Base::x; + using Base::y; + using Base::z; + using Base::w; + using Base::stride; + using Base::innerStride; + using Base::outerStride; + using Base::rowStride; + using Base::colStride; + typedef typename Base::CoeffReturnType CoeffReturnType; + + enum { + + RowsAtCompileTime = internal::traits::RowsAtCompileTime, + /**< The number of rows at compile-time. This is just a copy of the value provided + * by the \a Derived type. If a value is not known at compile-time, + * it is set to the \a Dynamic constant. + * \sa MatrixBase::rows(), MatrixBase::cols(), ColsAtCompileTime, SizeAtCompileTime */ + + ColsAtCompileTime = internal::traits::ColsAtCompileTime, + /**< The number of columns at compile-time. This is just a copy of the value provided + * by the \a Derived type. If a value is not known at compile-time, + * it is set to the \a Dynamic constant. + * \sa MatrixBase::rows(), MatrixBase::cols(), RowsAtCompileTime, SizeAtCompileTime */ + + + SizeAtCompileTime = (internal::size_at_compile_time::RowsAtCompileTime, + internal::traits::ColsAtCompileTime>::ret), + /**< This is equal to the number of coefficients, i.e. the number of + * rows times the number of columns, or to \a Dynamic if this is not + * known at compile-time. \sa RowsAtCompileTime, ColsAtCompileTime */ + + MaxRowsAtCompileTime = internal::traits::MaxRowsAtCompileTime, + /**< This value is equal to the maximum possible number of rows that this expression + * might have. If this expression might have an arbitrarily high number of rows, + * this value is set to \a Dynamic. + * + * This value is useful to know when evaluating an expression, in order to determine + * whether it is possible to avoid doing a dynamic memory allocation. + * + * \sa RowsAtCompileTime, MaxColsAtCompileTime, MaxSizeAtCompileTime + */ + + MaxColsAtCompileTime = internal::traits::MaxColsAtCompileTime, + /**< This value is equal to the maximum possible number of columns that this expression + * might have. If this expression might have an arbitrarily high number of columns, + * this value is set to \a Dynamic. + * + * This value is useful to know when evaluating an expression, in order to determine + * whether it is possible to avoid doing a dynamic memory allocation. + * + * \sa ColsAtCompileTime, MaxRowsAtCompileTime, MaxSizeAtCompileTime + */ + + MaxSizeAtCompileTime = (internal::size_at_compile_time::MaxRowsAtCompileTime, + internal::traits::MaxColsAtCompileTime>::ret), + /**< This value is equal to the maximum possible number of coefficients that this expression + * might have. If this expression might have an arbitrarily high number of coefficients, + * this value is set to \a Dynamic. + * + * This value is useful to know when evaluating an expression, in order to determine + * whether it is possible to avoid doing a dynamic memory allocation. + * + * \sa SizeAtCompileTime, MaxRowsAtCompileTime, MaxColsAtCompileTime + */ + + IsVectorAtCompileTime = internal::traits::RowsAtCompileTime == 1 + || internal::traits::ColsAtCompileTime == 1, + /**< This is set to true if either the number of rows or the number of + * columns is known at compile-time to be equal to 1. Indeed, in that case, + * we are dealing with a column-vector (if there is only one column) or with + * a row-vector (if there is only one row). */ + + NumDimensions = int(MaxSizeAtCompileTime) == 1 ? 0 : bool(IsVectorAtCompileTime) ? 1 : 2, + /**< This value is equal to Tensor::NumDimensions, i.e. 0 for scalars, 1 for vectors, + * and 2 for matrices. + */ + + Flags = internal::traits::Flags, + /**< This stores expression \ref flags flags which may or may not be inherited by new expressions + * constructed from this one. See the \ref flags "list of flags". + */ + + IsRowMajor = int(Flags) & RowMajorBit, /**< True if this expression has row-major storage order. */ + + InnerSizeAtCompileTime = int(IsVectorAtCompileTime) ? int(SizeAtCompileTime) + : int(IsRowMajor) ? int(ColsAtCompileTime) : int(RowsAtCompileTime), + + InnerStrideAtCompileTime = internal::inner_stride_at_compile_time::ret, + OuterStrideAtCompileTime = internal::outer_stride_at_compile_time::ret + }; + + typedef typename internal::find_best_packet::type PacketScalar; + + enum { IsPlainObjectBase = 0 }; + + /** The plain matrix type corresponding to this expression. + * \sa PlainObject */ + typedef Matrix::Scalar, + internal::traits::RowsAtCompileTime, + internal::traits::ColsAtCompileTime, + AutoAlign | (internal::traits::Flags&RowMajorBit ? RowMajor : ColMajor), + internal::traits::MaxRowsAtCompileTime, + internal::traits::MaxColsAtCompileTime + > PlainMatrix; + + /** The plain array type corresponding to this expression. + * \sa PlainObject */ + typedef Array::Scalar, + internal::traits::RowsAtCompileTime, + internal::traits::ColsAtCompileTime, + AutoAlign | (internal::traits::Flags&RowMajorBit ? RowMajor : ColMajor), + internal::traits::MaxRowsAtCompileTime, + internal::traits::MaxColsAtCompileTime + > PlainArray; + + /** \brief The plain matrix or array type corresponding to this expression. + * + * This is not necessarily exactly the return type of eval(). In the case of plain matrices, + * the return type of eval() is a const reference to a matrix, not a matrix! It is however guaranteed + * that the return type of eval() is either PlainObject or const PlainObject&. + */ + typedef typename internal::conditional::XprKind,MatrixXpr >::value, + PlainMatrix, PlainArray>::type PlainObject; + + /** \returns the number of nonzero coefficients which is in practice the number + * of stored coefficients. */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index nonZeros() const { return size(); } + + /** \returns the outer size. + * + * \note For a vector, this returns just 1. For a matrix (non-vector), this is the major dimension + * with respect to the \ref TopicStorageOrders "storage order", i.e., the number of columns for a + * column-major matrix, and the number of rows for a row-major matrix. */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + Index outerSize() const + { + return IsVectorAtCompileTime ? 1 + : int(IsRowMajor) ? this->rows() : this->cols(); + } + + /** \returns the inner size. + * + * \note For a vector, this is just the size. For a matrix (non-vector), this is the minor dimension + * with respect to the \ref TopicStorageOrders "storage order", i.e., the number of rows for a + * column-major matrix, and the number of columns for a row-major matrix. */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + Index innerSize() const + { + return IsVectorAtCompileTime ? this->size() + : int(IsRowMajor) ? this->cols() : this->rows(); + } + + /** Only plain matrices/arrays, not expressions, may be resized; therefore the only useful resize methods are + * Matrix::resize() and Array::resize(). The present method only asserts that the new size equals the old size, and does + * nothing else. + */ + EIGEN_DEVICE_FUNC + void resize(Index newSize) + { + EIGEN_ONLY_USED_FOR_DEBUG(newSize); + eigen_assert(newSize == this->size() + && "DenseBase::resize() does not actually allow to resize."); + } + /** Only plain matrices/arrays, not expressions, may be resized; therefore the only useful resize methods are + * Matrix::resize() and Array::resize(). The present method only asserts that the new size equals the old size, and does + * nothing else. + */ + EIGEN_DEVICE_FUNC + void resize(Index rows, Index cols) + { + EIGEN_ONLY_USED_FOR_DEBUG(rows); + EIGEN_ONLY_USED_FOR_DEBUG(cols); + eigen_assert(rows == this->rows() && cols == this->cols() + && "DenseBase::resize() does not actually allow to resize."); + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal Represents a matrix with all coefficients equal to one another*/ + typedef CwiseNullaryOp,PlainObject> ConstantReturnType; + /** \internal \deprecated Represents a vector with linearly spaced coefficients that allows sequential access only. */ + EIGEN_DEPRECATED typedef CwiseNullaryOp,PlainObject> SequentialLinSpacedReturnType; + /** \internal Represents a vector with linearly spaced coefficients that allows random access. */ + typedef CwiseNullaryOp,PlainObject> RandomAccessLinSpacedReturnType; + /** \internal the return type of MatrixBase::eigenvalues() */ + typedef Matrix::Scalar>::Real, internal::traits::ColsAtCompileTime, 1> EigenvaluesReturnType; + +#endif // not EIGEN_PARSED_BY_DOXYGEN + + /** Copies \a other into *this. \returns a reference to *this. */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator=(const DenseBase& other); + + /** Special case of the template operator=, in order to prevent the compiler + * from generating a default operator= (issue hit with g++ 4.1) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator=(const DenseBase& other); + + template + EIGEN_DEVICE_FUNC + Derived& operator=(const EigenBase &other); + + template + EIGEN_DEVICE_FUNC + Derived& operator+=(const EigenBase &other); + + template + EIGEN_DEVICE_FUNC + Derived& operator-=(const EigenBase &other); + + template + EIGEN_DEVICE_FUNC + Derived& operator=(const ReturnByValue& func); + + /** \internal + * Copies \a other into *this without evaluating other. \returns a reference to *this. */ + template + /** \deprecated */ + EIGEN_DEPRECATED EIGEN_DEVICE_FUNC + Derived& lazyAssign(const DenseBase& other); + + EIGEN_DEVICE_FUNC + CommaInitializer operator<< (const Scalar& s); + + template + /** \deprecated it now returns \c *this */ + EIGEN_DEPRECATED + const Derived& flagged() const + { return derived(); } + + template + EIGEN_DEVICE_FUNC + CommaInitializer operator<< (const DenseBase& other); + + typedef Transpose TransposeReturnType; + EIGEN_DEVICE_FUNC + TransposeReturnType transpose(); + typedef typename internal::add_const >::type ConstTransposeReturnType; + EIGEN_DEVICE_FUNC + ConstTransposeReturnType transpose() const; + EIGEN_DEVICE_FUNC + void transposeInPlace(); + + EIGEN_DEVICE_FUNC static const ConstantReturnType + Constant(Index rows, Index cols, const Scalar& value); + EIGEN_DEVICE_FUNC static const ConstantReturnType + Constant(Index size, const Scalar& value); + EIGEN_DEVICE_FUNC static const ConstantReturnType + Constant(const Scalar& value); + + EIGEN_DEPRECATED EIGEN_DEVICE_FUNC static const RandomAccessLinSpacedReturnType + LinSpaced(Sequential_t, Index size, const Scalar& low, const Scalar& high); + EIGEN_DEPRECATED EIGEN_DEVICE_FUNC static const RandomAccessLinSpacedReturnType + LinSpaced(Sequential_t, const Scalar& low, const Scalar& high); + + EIGEN_DEVICE_FUNC static const RandomAccessLinSpacedReturnType + LinSpaced(Index size, const Scalar& low, const Scalar& high); + EIGEN_DEVICE_FUNC static const RandomAccessLinSpacedReturnType + LinSpaced(const Scalar& low, const Scalar& high); + + template EIGEN_DEVICE_FUNC + static const CwiseNullaryOp + NullaryExpr(Index rows, Index cols, const CustomNullaryOp& func); + template EIGEN_DEVICE_FUNC + static const CwiseNullaryOp + NullaryExpr(Index size, const CustomNullaryOp& func); + template EIGEN_DEVICE_FUNC + static const CwiseNullaryOp + NullaryExpr(const CustomNullaryOp& func); + + EIGEN_DEVICE_FUNC static const ConstantReturnType Zero(Index rows, Index cols); + EIGEN_DEVICE_FUNC static const ConstantReturnType Zero(Index size); + EIGEN_DEVICE_FUNC static const ConstantReturnType Zero(); + EIGEN_DEVICE_FUNC static const ConstantReturnType Ones(Index rows, Index cols); + EIGEN_DEVICE_FUNC static const ConstantReturnType Ones(Index size); + EIGEN_DEVICE_FUNC static const ConstantReturnType Ones(); + + EIGEN_DEVICE_FUNC void fill(const Scalar& value); + EIGEN_DEVICE_FUNC Derived& setConstant(const Scalar& value); + EIGEN_DEVICE_FUNC Derived& setLinSpaced(Index size, const Scalar& low, const Scalar& high); + EIGEN_DEVICE_FUNC Derived& setLinSpaced(const Scalar& low, const Scalar& high); + EIGEN_DEVICE_FUNC Derived& setZero(); + EIGEN_DEVICE_FUNC Derived& setOnes(); + EIGEN_DEVICE_FUNC Derived& setRandom(); + + template EIGEN_DEVICE_FUNC + bool isApprox(const DenseBase& other, + const RealScalar& prec = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC + bool isMuchSmallerThan(const RealScalar& other, + const RealScalar& prec = NumTraits::dummy_precision()) const; + template EIGEN_DEVICE_FUNC + bool isMuchSmallerThan(const DenseBase& other, + const RealScalar& prec = NumTraits::dummy_precision()) const; + + EIGEN_DEVICE_FUNC bool isApproxToConstant(const Scalar& value, const RealScalar& prec = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC bool isConstant(const Scalar& value, const RealScalar& prec = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC bool isZero(const RealScalar& prec = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC bool isOnes(const RealScalar& prec = NumTraits::dummy_precision()) const; + + inline bool hasNaN() const; + inline bool allFinite() const; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator*=(const Scalar& other); + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator/=(const Scalar& other); + + typedef typename internal::add_const_on_value_type::type>::type EvalReturnType; + /** \returns the matrix or vector obtained by evaluating this expression. + * + * Notice that in the case of a plain matrix or vector (not an expression) this function just returns + * a const reference, in order to avoid a useless copy. + * + * \warning Be careful with eval() and the auto C++ keyword, as detailed in this \link TopicPitfalls_auto_keyword page \endlink. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE EvalReturnType eval() const + { + // Even though MSVC does not honor strong inlining when the return type + // is a dynamic matrix, we desperately need strong inlining for fixed + // size types on MSVC. + return typename internal::eval::type(derived()); + } + + /** swaps *this with the expression \a other. + * + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void swap(const DenseBase& other) + { + EIGEN_STATIC_ASSERT(!OtherDerived::IsPlainObjectBase,THIS_EXPRESSION_IS_NOT_A_LVALUE__IT_IS_READ_ONLY); + eigen_assert(rows()==other.rows() && cols()==other.cols()); + call_assignment(derived(), other.const_cast_derived(), internal::swap_assign_op()); + } + + /** swaps *this with the matrix or array \a other. + * + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void swap(PlainObjectBase& other) + { + eigen_assert(rows()==other.rows() && cols()==other.cols()); + call_assignment(derived(), other.derived(), internal::swap_assign_op()); + } + + EIGEN_DEVICE_FUNC inline const NestByValue nestByValue() const; + EIGEN_DEVICE_FUNC inline const ForceAlignedAccess forceAlignedAccess() const; + EIGEN_DEVICE_FUNC inline ForceAlignedAccess forceAlignedAccess(); + template EIGEN_DEVICE_FUNC + inline const typename internal::conditional,Derived&>::type forceAlignedAccessIf() const; + template EIGEN_DEVICE_FUNC + inline typename internal::conditional,Derived&>::type forceAlignedAccessIf(); + + EIGEN_DEVICE_FUNC Scalar sum() const; + EIGEN_DEVICE_FUNC Scalar mean() const; + EIGEN_DEVICE_FUNC Scalar trace() const; + + EIGEN_DEVICE_FUNC Scalar prod() const; + + template + EIGEN_DEVICE_FUNC typename internal::traits::Scalar minCoeff() const; + template + EIGEN_DEVICE_FUNC typename internal::traits::Scalar maxCoeff() const; + + + // By default, the fastest version with undefined NaN propagation semantics is + // used. + // TODO(rmlarsen): Replace with default template argument when we move to + // c++11 or beyond. + EIGEN_DEVICE_FUNC inline typename internal::traits::Scalar minCoeff() const { + return minCoeff(); + } + EIGEN_DEVICE_FUNC inline typename internal::traits::Scalar maxCoeff() const { + return maxCoeff(); + } + + template + EIGEN_DEVICE_FUNC + typename internal::traits::Scalar minCoeff(IndexType* row, IndexType* col) const; + template + EIGEN_DEVICE_FUNC + typename internal::traits::Scalar maxCoeff(IndexType* row, IndexType* col) const; + template + EIGEN_DEVICE_FUNC + typename internal::traits::Scalar minCoeff(IndexType* index) const; + template + EIGEN_DEVICE_FUNC + typename internal::traits::Scalar maxCoeff(IndexType* index) const; + + // TODO(rmlarsen): Replace these methods with a default template argument. + template + EIGEN_DEVICE_FUNC inline + typename internal::traits::Scalar minCoeff(IndexType* row, IndexType* col) const { + return minCoeff(row, col); + } + template + EIGEN_DEVICE_FUNC inline + typename internal::traits::Scalar maxCoeff(IndexType* row, IndexType* col) const { + return maxCoeff(row, col); + } + template + EIGEN_DEVICE_FUNC inline + typename internal::traits::Scalar minCoeff(IndexType* index) const { + return minCoeff(index); + } + template + EIGEN_DEVICE_FUNC inline + typename internal::traits::Scalar maxCoeff(IndexType* index) const { + return maxCoeff(index); + } + + template + EIGEN_DEVICE_FUNC + Scalar redux(const BinaryOp& func) const; + + template + EIGEN_DEVICE_FUNC + void visit(Visitor& func) const; + + /** \returns a WithFormat proxy object allowing to print a matrix the with given + * format \a fmt. + * + * See class IOFormat for some examples. + * + * \sa class IOFormat, class WithFormat + */ + inline const WithFormat format(const IOFormat& fmt) const + { + return WithFormat(derived(), fmt); + } + + /** \returns the unique coefficient of a 1x1 expression */ + EIGEN_DEVICE_FUNC + CoeffReturnType value() const + { + EIGEN_STATIC_ASSERT_SIZE_1x1(Derived) + eigen_assert(this->rows() == 1 && this->cols() == 1); + return derived().coeff(0,0); + } + + EIGEN_DEVICE_FUNC bool all() const; + EIGEN_DEVICE_FUNC bool any() const; + EIGEN_DEVICE_FUNC Index count() const; + + typedef VectorwiseOp RowwiseReturnType; + typedef const VectorwiseOp ConstRowwiseReturnType; + typedef VectorwiseOp ColwiseReturnType; + typedef const VectorwiseOp ConstColwiseReturnType; + + /** \returns a VectorwiseOp wrapper of *this for broadcasting and partial reductions + * + * Example: \include MatrixBase_rowwise.cpp + * Output: \verbinclude MatrixBase_rowwise.out + * + * \sa colwise(), class VectorwiseOp, \ref TutorialReductionsVisitorsBroadcasting + */ + //Code moved here due to a CUDA compiler bug + EIGEN_DEVICE_FUNC inline ConstRowwiseReturnType rowwise() const { + return ConstRowwiseReturnType(derived()); + } + EIGEN_DEVICE_FUNC RowwiseReturnType rowwise(); + + /** \returns a VectorwiseOp wrapper of *this broadcasting and partial reductions + * + * Example: \include MatrixBase_colwise.cpp + * Output: \verbinclude MatrixBase_colwise.out + * + * \sa rowwise(), class VectorwiseOp, \ref TutorialReductionsVisitorsBroadcasting + */ + EIGEN_DEVICE_FUNC inline ConstColwiseReturnType colwise() const { + return ConstColwiseReturnType(derived()); + } + EIGEN_DEVICE_FUNC ColwiseReturnType colwise(); + + typedef CwiseNullaryOp,PlainObject> RandomReturnType; + static const RandomReturnType Random(Index rows, Index cols); + static const RandomReturnType Random(Index size); + static const RandomReturnType Random(); + + template + inline EIGEN_DEVICE_FUNC const Select + select(const DenseBase& thenMatrix, + const DenseBase& elseMatrix) const; + + template + inline EIGEN_DEVICE_FUNC const Select + select(const DenseBase& thenMatrix, const typename ThenDerived::Scalar& elseScalar) const; + + template + inline EIGEN_DEVICE_FUNC const Select + select(const typename ElseDerived::Scalar& thenScalar, const DenseBase& elseMatrix) const; + + template RealScalar lpNorm() const; + + template + EIGEN_DEVICE_FUNC + const Replicate replicate() const; + /** + * \return an expression of the replication of \c *this + * + * Example: \include MatrixBase_replicate_int_int.cpp + * Output: \verbinclude MatrixBase_replicate_int_int.out + * + * \sa VectorwiseOp::replicate(), DenseBase::replicate(), class Replicate + */ + //Code moved here due to a CUDA compiler bug + EIGEN_DEVICE_FUNC + const Replicate replicate(Index rowFactor, Index colFactor) const + { + return Replicate(derived(), rowFactor, colFactor); + } + + typedef Reverse ReverseReturnType; + typedef const Reverse ConstReverseReturnType; + EIGEN_DEVICE_FUNC ReverseReturnType reverse(); + /** This is the const version of reverse(). */ + //Code moved here due to a CUDA compiler bug + EIGEN_DEVICE_FUNC ConstReverseReturnType reverse() const + { + return ConstReverseReturnType(derived()); + } + EIGEN_DEVICE_FUNC void reverseInPlace(); + + #ifdef EIGEN_PARSED_BY_DOXYGEN + /** STL-like RandomAccessIterator + * iterator type as returned by the begin() and end() methods. + */ + typedef random_access_iterator_type iterator; + /** This is the const version of iterator (aka read-only) */ + typedef random_access_iterator_type const_iterator; + #else + typedef typename internal::conditional< (Flags&DirectAccessBit)==DirectAccessBit, + internal::pointer_based_stl_iterator, + internal::generic_randaccess_stl_iterator + >::type iterator_type; + + typedef typename internal::conditional< (Flags&DirectAccessBit)==DirectAccessBit, + internal::pointer_based_stl_iterator, + internal::generic_randaccess_stl_iterator + >::type const_iterator_type; + + // Stl-style iterators are supported only for vectors. + + typedef typename internal::conditional< IsVectorAtCompileTime, + iterator_type, + void + >::type iterator; + + typedef typename internal::conditional< IsVectorAtCompileTime, + const_iterator_type, + void + >::type const_iterator; + #endif + + inline iterator begin(); + inline const_iterator begin() const; + inline const_iterator cbegin() const; + inline iterator end(); + inline const_iterator end() const; + inline const_iterator cend() const; + +#define EIGEN_CURRENT_STORAGE_BASE_CLASS Eigen::DenseBase +#define EIGEN_DOC_BLOCK_ADDONS_NOT_INNER_PANEL +#define EIGEN_DOC_BLOCK_ADDONS_INNER_PANEL_IF(COND) +#define EIGEN_DOC_UNARY_ADDONS(X,Y) +# include "../plugins/CommonCwiseUnaryOps.h" +# include "../plugins/BlockMethods.h" +# include "../plugins/IndexedViewMethods.h" +# include "../plugins/ReshapedMethods.h" +# ifdef EIGEN_DENSEBASE_PLUGIN +# include EIGEN_DENSEBASE_PLUGIN +# endif +#undef EIGEN_CURRENT_STORAGE_BASE_CLASS +#undef EIGEN_DOC_BLOCK_ADDONS_NOT_INNER_PANEL +#undef EIGEN_DOC_BLOCK_ADDONS_INNER_PANEL_IF +#undef EIGEN_DOC_UNARY_ADDONS + + // disable the use of evalTo for dense objects with a nice compilation error + template + EIGEN_DEVICE_FUNC + inline void evalTo(Dest& ) const + { + EIGEN_STATIC_ASSERT((internal::is_same::value),THE_EVAL_EVALTO_FUNCTION_SHOULD_NEVER_BE_CALLED_FOR_DENSE_OBJECTS); + } + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(DenseBase) + /** Default constructor. Do nothing. */ + EIGEN_DEVICE_FUNC DenseBase() + { + /* Just checks for self-consistency of the flags. + * Only do it when debugging Eigen, as this borders on paranoia and could slow compilation down + */ +#ifdef EIGEN_INTERNAL_DEBUGGING + EIGEN_STATIC_ASSERT((EIGEN_IMPLIES(MaxRowsAtCompileTime==1 && MaxColsAtCompileTime!=1, int(IsRowMajor)) + && EIGEN_IMPLIES(MaxColsAtCompileTime==1 && MaxRowsAtCompileTime!=1, int(!IsRowMajor))), + INVALID_STORAGE_ORDER_FOR_THIS_VECTOR_EXPRESSION) +#endif + } + + private: + EIGEN_DEVICE_FUNC explicit DenseBase(int); + EIGEN_DEVICE_FUNC DenseBase(int,int); + template EIGEN_DEVICE_FUNC explicit DenseBase(const DenseBase&); +}; + +} // end namespace Eigen + +#endif // EIGEN_DENSEBASE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DenseCoeffsBase.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DenseCoeffsBase.h new file mode 100644 index 0000000..37fcdb5 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DenseCoeffsBase.h @@ -0,0 +1,685 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DENSECOEFFSBASE_H +#define EIGEN_DENSECOEFFSBASE_H + +namespace Eigen { + +namespace internal { +template struct add_const_on_value_type_if_arithmetic +{ + typedef typename conditional::value, T, typename add_const_on_value_type::type>::type type; +}; +} + +/** \brief Base class providing read-only coefficient access to matrices and arrays. + * \ingroup Core_Module + * \tparam Derived Type of the derived class + * + * \note #ReadOnlyAccessors Constant indicating read-only access + * + * This class defines the \c operator() \c const function and friends, which can be used to read specific + * entries of a matrix or array. + * + * \sa DenseCoeffsBase, DenseCoeffsBase, + * \ref TopicClassHierarchy + */ +template +class DenseCoeffsBase : public EigenBase +{ + public: + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + + // Explanation for this CoeffReturnType typedef. + // - This is the return type of the coeff() method. + // - The LvalueBit means exactly that we can offer a coeffRef() method, which means exactly that we can get references + // to coeffs, which means exactly that we can have coeff() return a const reference (as opposed to returning a value). + // - The is_artihmetic check is required since "const int", "const double", etc. will cause warnings on some systems + // while the declaration of "const T", where T is a non arithmetic type does not. Always returning "const Scalar&" is + // not possible, since the underlying expressions might not offer a valid address the reference could be referring to. + typedef typename internal::conditional::Flags&LvalueBit), + const Scalar&, + typename internal::conditional::value, Scalar, const Scalar>::type + >::type CoeffReturnType; + + typedef typename internal::add_const_on_value_type_if_arithmetic< + typename internal::packet_traits::type + >::type PacketReturnType; + + typedef EigenBase Base; + using Base::rows; + using Base::cols; + using Base::size; + using Base::derived; + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Index rowIndexByOuterInner(Index outer, Index inner) const + { + return int(Derived::RowsAtCompileTime) == 1 ? 0 + : int(Derived::ColsAtCompileTime) == 1 ? inner + : int(Derived::Flags)&RowMajorBit ? outer + : inner; + } + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Index colIndexByOuterInner(Index outer, Index inner) const + { + return int(Derived::ColsAtCompileTime) == 1 ? 0 + : int(Derived::RowsAtCompileTime) == 1 ? inner + : int(Derived::Flags)&RowMajorBit ? inner + : outer; + } + + /** Short version: don't use this function, use + * \link operator()(Index,Index) const \endlink instead. + * + * Long version: this function is similar to + * \link operator()(Index,Index) const \endlink, but without the assertion. + * Use this for limiting the performance cost of debugging code when doing + * repeated coefficient access. Only use this when it is guaranteed that the + * parameters \a row and \a col are in range. + * + * If EIGEN_INTERNAL_DEBUGGING is defined, an assertion will be made, making this + * function equivalent to \link operator()(Index,Index) const \endlink. + * + * \sa operator()(Index,Index) const, coeffRef(Index,Index), coeff(Index) const + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const + { + eigen_internal_assert(row >= 0 && row < rows() + && col >= 0 && col < cols()); + return internal::evaluator(derived()).coeff(row,col); + } + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType coeffByOuterInner(Index outer, Index inner) const + { + return coeff(rowIndexByOuterInner(outer, inner), + colIndexByOuterInner(outer, inner)); + } + + /** \returns the coefficient at given the given row and column. + * + * \sa operator()(Index,Index), operator[](Index) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType operator()(Index row, Index col) const + { + eigen_assert(row >= 0 && row < rows() + && col >= 0 && col < cols()); + return coeff(row, col); + } + + /** Short version: don't use this function, use + * \link operator[](Index) const \endlink instead. + * + * Long version: this function is similar to + * \link operator[](Index) const \endlink, but without the assertion. + * Use this for limiting the performance cost of debugging code when doing + * repeated coefficient access. Only use this when it is guaranteed that the + * parameter \a index is in range. + * + * If EIGEN_INTERNAL_DEBUGGING is defined, an assertion will be made, making this + * function equivalent to \link operator[](Index) const \endlink. + * + * \sa operator[](Index) const, coeffRef(Index), coeff(Index,Index) const + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + coeff(Index index) const + { + EIGEN_STATIC_ASSERT(internal::evaluator::Flags & LinearAccessBit, + THIS_COEFFICIENT_ACCESSOR_TAKING_ONE_ACCESS_IS_ONLY_FOR_EXPRESSIONS_ALLOWING_LINEAR_ACCESS) + eigen_internal_assert(index >= 0 && index < size()); + return internal::evaluator(derived()).coeff(index); + } + + + /** \returns the coefficient at given index. + * + * This method is allowed only for vector expressions, and for matrix expressions having the LinearAccessBit. + * + * \sa operator[](Index), operator()(Index,Index) const, x() const, y() const, + * z() const, w() const + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + operator[](Index index) const + { + EIGEN_STATIC_ASSERT(Derived::IsVectorAtCompileTime, + THE_BRACKET_OPERATOR_IS_ONLY_FOR_VECTORS__USE_THE_PARENTHESIS_OPERATOR_INSTEAD) + eigen_assert(index >= 0 && index < size()); + return coeff(index); + } + + /** \returns the coefficient at given index. + * + * This is synonymous to operator[](Index) const. + * + * This method is allowed only for vector expressions, and for matrix expressions having the LinearAccessBit. + * + * \sa operator[](Index), operator()(Index,Index) const, x() const, y() const, + * z() const, w() const + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + operator()(Index index) const + { + eigen_assert(index >= 0 && index < size()); + return coeff(index); + } + + /** equivalent to operator[](0). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + x() const { return (*this)[0]; } + + /** equivalent to operator[](1). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + y() const + { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime==-1 || Derived::SizeAtCompileTime>=2, OUT_OF_RANGE_ACCESS); + return (*this)[1]; + } + + /** equivalent to operator[](2). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + z() const + { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime==-1 || Derived::SizeAtCompileTime>=3, OUT_OF_RANGE_ACCESS); + return (*this)[2]; + } + + /** equivalent to operator[](3). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + w() const + { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime==-1 || Derived::SizeAtCompileTime>=4, OUT_OF_RANGE_ACCESS); + return (*this)[3]; + } + + /** \internal + * \returns the packet of coefficients starting at the given row and column. It is your responsibility + * to ensure that a packet really starts there. This method is only available on expressions having the + * PacketAccessBit. + * + * The \a LoadMode parameter may have the value \a #Aligned or \a #Unaligned. Its effect is to select + * the appropriate vectorization instruction. Aligned access is faster, but is only possible for packets + * starting at an address which is a multiple of the packet size. + */ + + template + EIGEN_STRONG_INLINE PacketReturnType packet(Index row, Index col) const + { + typedef typename internal::packet_traits::type DefaultPacketType; + eigen_internal_assert(row >= 0 && row < rows() && col >= 0 && col < cols()); + return internal::evaluator(derived()).template packet(row,col); + } + + + /** \internal */ + template + EIGEN_STRONG_INLINE PacketReturnType packetByOuterInner(Index outer, Index inner) const + { + return packet(rowIndexByOuterInner(outer, inner), + colIndexByOuterInner(outer, inner)); + } + + /** \internal + * \returns the packet of coefficients starting at the given index. It is your responsibility + * to ensure that a packet really starts there. This method is only available on expressions having the + * PacketAccessBit and the LinearAccessBit. + * + * The \a LoadMode parameter may have the value \a #Aligned or \a #Unaligned. Its effect is to select + * the appropriate vectorization instruction. Aligned access is faster, but is only possible for packets + * starting at an address which is a multiple of the packet size. + */ + + template + EIGEN_STRONG_INLINE PacketReturnType packet(Index index) const + { + EIGEN_STATIC_ASSERT(internal::evaluator::Flags & LinearAccessBit, + THIS_COEFFICIENT_ACCESSOR_TAKING_ONE_ACCESS_IS_ONLY_FOR_EXPRESSIONS_ALLOWING_LINEAR_ACCESS) + typedef typename internal::packet_traits::type DefaultPacketType; + eigen_internal_assert(index >= 0 && index < size()); + return internal::evaluator(derived()).template packet(index); + } + + protected: + // explanation: DenseBase is doing "using ..." on the methods from DenseCoeffsBase. + // But some methods are only available in the DirectAccess case. + // So we add dummy methods here with these names, so that "using... " doesn't fail. + // It's not private so that the child class DenseBase can access them, and it's not public + // either since it's an implementation detail, so has to be protected. + void coeffRef(); + void coeffRefByOuterInner(); + void writePacket(); + void writePacketByOuterInner(); + void copyCoeff(); + void copyCoeffByOuterInner(); + void copyPacket(); + void copyPacketByOuterInner(); + void stride(); + void innerStride(); + void outerStride(); + void rowStride(); + void colStride(); +}; + +/** \brief Base class providing read/write coefficient access to matrices and arrays. + * \ingroup Core_Module + * \tparam Derived Type of the derived class + * + * \note #WriteAccessors Constant indicating read/write access + * + * This class defines the non-const \c operator() function and friends, which can be used to write specific + * entries of a matrix or array. This class inherits DenseCoeffsBase which + * defines the const variant for reading specific entries. + * + * \sa DenseCoeffsBase, \ref TopicClassHierarchy + */ +template +class DenseCoeffsBase : public DenseCoeffsBase +{ + public: + + typedef DenseCoeffsBase Base; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + + using Base::coeff; + using Base::rows; + using Base::cols; + using Base::size; + using Base::derived; + using Base::rowIndexByOuterInner; + using Base::colIndexByOuterInner; + using Base::operator[]; + using Base::operator(); + using Base::x; + using Base::y; + using Base::z; + using Base::w; + + /** Short version: don't use this function, use + * \link operator()(Index,Index) \endlink instead. + * + * Long version: this function is similar to + * \link operator()(Index,Index) \endlink, but without the assertion. + * Use this for limiting the performance cost of debugging code when doing + * repeated coefficient access. Only use this when it is guaranteed that the + * parameters \a row and \a col are in range. + * + * If EIGEN_INTERNAL_DEBUGGING is defined, an assertion will be made, making this + * function equivalent to \link operator()(Index,Index) \endlink. + * + * \sa operator()(Index,Index), coeff(Index, Index) const, coeffRef(Index) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& coeffRef(Index row, Index col) + { + eigen_internal_assert(row >= 0 && row < rows() + && col >= 0 && col < cols()); + return internal::evaluator(derived()).coeffRef(row,col); + } + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + coeffRefByOuterInner(Index outer, Index inner) + { + return coeffRef(rowIndexByOuterInner(outer, inner), + colIndexByOuterInner(outer, inner)); + } + + /** \returns a reference to the coefficient at given the given row and column. + * + * \sa operator[](Index) + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + operator()(Index row, Index col) + { + eigen_assert(row >= 0 && row < rows() + && col >= 0 && col < cols()); + return coeffRef(row, col); + } + + + /** Short version: don't use this function, use + * \link operator[](Index) \endlink instead. + * + * Long version: this function is similar to + * \link operator[](Index) \endlink, but without the assertion. + * Use this for limiting the performance cost of debugging code when doing + * repeated coefficient access. Only use this when it is guaranteed that the + * parameters \a row and \a col are in range. + * + * If EIGEN_INTERNAL_DEBUGGING is defined, an assertion will be made, making this + * function equivalent to \link operator[](Index) \endlink. + * + * \sa operator[](Index), coeff(Index) const, coeffRef(Index,Index) + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + coeffRef(Index index) + { + EIGEN_STATIC_ASSERT(internal::evaluator::Flags & LinearAccessBit, + THIS_COEFFICIENT_ACCESSOR_TAKING_ONE_ACCESS_IS_ONLY_FOR_EXPRESSIONS_ALLOWING_LINEAR_ACCESS) + eigen_internal_assert(index >= 0 && index < size()); + return internal::evaluator(derived()).coeffRef(index); + } + + /** \returns a reference to the coefficient at given index. + * + * This method is allowed only for vector expressions, and for matrix expressions having the LinearAccessBit. + * + * \sa operator[](Index) const, operator()(Index,Index), x(), y(), z(), w() + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + operator[](Index index) + { + EIGEN_STATIC_ASSERT(Derived::IsVectorAtCompileTime, + THE_BRACKET_OPERATOR_IS_ONLY_FOR_VECTORS__USE_THE_PARENTHESIS_OPERATOR_INSTEAD) + eigen_assert(index >= 0 && index < size()); + return coeffRef(index); + } + + /** \returns a reference to the coefficient at given index. + * + * This is synonymous to operator[](Index). + * + * This method is allowed only for vector expressions, and for matrix expressions having the LinearAccessBit. + * + * \sa operator[](Index) const, operator()(Index,Index), x(), y(), z(), w() + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + operator()(Index index) + { + eigen_assert(index >= 0 && index < size()); + return coeffRef(index); + } + + /** equivalent to operator[](0). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + x() { return (*this)[0]; } + + /** equivalent to operator[](1). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + y() + { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime==-1 || Derived::SizeAtCompileTime>=2, OUT_OF_RANGE_ACCESS); + return (*this)[1]; + } + + /** equivalent to operator[](2). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + z() + { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime==-1 || Derived::SizeAtCompileTime>=3, OUT_OF_RANGE_ACCESS); + return (*this)[2]; + } + + /** equivalent to operator[](3). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + w() + { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime==-1 || Derived::SizeAtCompileTime>=4, OUT_OF_RANGE_ACCESS); + return (*this)[3]; + } +}; + +/** \brief Base class providing direct read-only coefficient access to matrices and arrays. + * \ingroup Core_Module + * \tparam Derived Type of the derived class + * + * \note #DirectAccessors Constant indicating direct access + * + * This class defines functions to work with strides which can be used to access entries directly. This class + * inherits DenseCoeffsBase which defines functions to access entries read-only using + * \c operator() . + * + * \sa \blank \ref TopicClassHierarchy + */ +template +class DenseCoeffsBase : public DenseCoeffsBase +{ + public: + + typedef DenseCoeffsBase Base; + typedef typename internal::traits::Scalar Scalar; + typedef typename NumTraits::Real RealScalar; + + using Base::rows; + using Base::cols; + using Base::size; + using Base::derived; + + /** \returns the pointer increment between two consecutive elements within a slice in the inner direction. + * + * \sa outerStride(), rowStride(), colStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const + { + return derived().innerStride(); + } + + /** \returns the pointer increment between two consecutive inner slices (for example, between two consecutive columns + * in a column-major matrix). + * + * \sa innerStride(), rowStride(), colStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const + { + return derived().outerStride(); + } + + // FIXME shall we remove it ? + EIGEN_CONSTEXPR inline Index stride() const + { + return Derived::IsVectorAtCompileTime ? innerStride() : outerStride(); + } + + /** \returns the pointer increment between two consecutive rows. + * + * \sa innerStride(), outerStride(), colStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rowStride() const + { + return Derived::IsRowMajor ? outerStride() : innerStride(); + } + + /** \returns the pointer increment between two consecutive columns. + * + * \sa innerStride(), outerStride(), rowStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index colStride() const + { + return Derived::IsRowMajor ? innerStride() : outerStride(); + } +}; + +/** \brief Base class providing direct read/write coefficient access to matrices and arrays. + * \ingroup Core_Module + * \tparam Derived Type of the derived class + * + * \note #DirectWriteAccessors Constant indicating direct access + * + * This class defines functions to work with strides which can be used to access entries directly. This class + * inherits DenseCoeffsBase which defines functions to access entries read/write using + * \c operator(). + * + * \sa \blank \ref TopicClassHierarchy + */ +template +class DenseCoeffsBase + : public DenseCoeffsBase +{ + public: + + typedef DenseCoeffsBase Base; + typedef typename internal::traits::Scalar Scalar; + typedef typename NumTraits::Real RealScalar; + + using Base::rows; + using Base::cols; + using Base::size; + using Base::derived; + + /** \returns the pointer increment between two consecutive elements within a slice in the inner direction. + * + * \sa outerStride(), rowStride(), colStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT + { + return derived().innerStride(); + } + + /** \returns the pointer increment between two consecutive inner slices (for example, between two consecutive columns + * in a column-major matrix). + * + * \sa innerStride(), rowStride(), colStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT + { + return derived().outerStride(); + } + + // FIXME shall we remove it ? + EIGEN_CONSTEXPR inline Index stride() const EIGEN_NOEXCEPT + { + return Derived::IsVectorAtCompileTime ? innerStride() : outerStride(); + } + + /** \returns the pointer increment between two consecutive rows. + * + * \sa innerStride(), outerStride(), colStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rowStride() const EIGEN_NOEXCEPT + { + return Derived::IsRowMajor ? outerStride() : innerStride(); + } + + /** \returns the pointer increment between two consecutive columns. + * + * \sa innerStride(), outerStride(), rowStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index colStride() const EIGEN_NOEXCEPT + { + return Derived::IsRowMajor ? innerStride() : outerStride(); + } +}; + +namespace internal { + +template +struct first_aligned_impl +{ + static EIGEN_CONSTEXPR inline Index run(const Derived&) EIGEN_NOEXCEPT + { return 0; } +}; + +template +struct first_aligned_impl +{ + static inline Index run(const Derived& m) + { + return internal::first_aligned(m.data(), m.size()); + } +}; + +/** \internal \returns the index of the first element of the array stored by \a m that is properly aligned with respect to \a Alignment for vectorization. + * + * \tparam Alignment requested alignment in Bytes. + * + * There is also the variant first_aligned(const Scalar*, Integer) defined in Memory.h. See it for more + * documentation. + */ +template +static inline Index first_aligned(const DenseBase& m) +{ + enum { ReturnZero = (int(evaluator::Alignment) >= Alignment) || !(Derived::Flags & DirectAccessBit) }; + return first_aligned_impl::run(m.derived()); +} + +template +static inline Index first_default_aligned(const DenseBase& m) +{ + typedef typename Derived::Scalar Scalar; + typedef typename packet_traits::type DefaultPacketType; + return internal::first_aligned::alignment),Derived>(m); +} + +template::ret> +struct inner_stride_at_compile_time +{ + enum { ret = traits::InnerStrideAtCompileTime }; +}; + +template +struct inner_stride_at_compile_time +{ + enum { ret = 0 }; +}; + +template::ret> +struct outer_stride_at_compile_time +{ + enum { ret = traits::OuterStrideAtCompileTime }; +}; + +template +struct outer_stride_at_compile_time +{ + enum { ret = 0 }; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_DENSECOEFFSBASE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DenseStorage.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DenseStorage.h new file mode 100644 index 0000000..08ef6c5 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DenseStorage.h @@ -0,0 +1,652 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2009 Benoit Jacob +// Copyright (C) 2010-2013 Hauke Heibel +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATRIXSTORAGE_H +#define EIGEN_MATRIXSTORAGE_H + +#ifdef EIGEN_DENSE_STORAGE_CTOR_PLUGIN + #define EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(X) X; EIGEN_DENSE_STORAGE_CTOR_PLUGIN; +#else + #define EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(X) +#endif + +namespace Eigen { + +namespace internal { + +struct constructor_without_unaligned_array_assert {}; + +template +EIGEN_DEVICE_FUNC +void check_static_allocation_size() +{ + // if EIGEN_STACK_ALLOCATION_LIMIT is defined to 0, then no limit + #if EIGEN_STACK_ALLOCATION_LIMIT + EIGEN_STATIC_ASSERT(Size * sizeof(T) <= EIGEN_STACK_ALLOCATION_LIMIT, OBJECT_ALLOCATED_ON_STACK_IS_TOO_BIG); + #endif +} + +/** \internal + * Static array. If the MatrixOrArrayOptions require auto-alignment, the array will be automatically aligned: + * to 16 bytes boundary if the total size is a multiple of 16 bytes. + */ +template ::value > +struct plain_array +{ + T array[Size]; + + EIGEN_DEVICE_FUNC + plain_array() + { + check_static_allocation_size(); + } + + EIGEN_DEVICE_FUNC + plain_array(constructor_without_unaligned_array_assert) + { + check_static_allocation_size(); + } +}; + +#if defined(EIGEN_DISABLE_UNALIGNED_ARRAY_ASSERT) + #define EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(sizemask) +#elif EIGEN_GNUC_AT_LEAST(4,7) + // GCC 4.7 is too aggressive in its optimizations and remove the alignment test based on the fact the array is declared to be aligned. + // See this bug report: http://gcc.gnu.org/bugzilla/show_bug.cgi?id=53900 + // Hiding the origin of the array pointer behind a function argument seems to do the trick even if the function is inlined: + template + EIGEN_ALWAYS_INLINE PtrType eigen_unaligned_array_assert_workaround_gcc47(PtrType array) { return array; } + #define EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(sizemask) \ + eigen_assert((internal::UIntPtr(eigen_unaligned_array_assert_workaround_gcc47(array)) & (sizemask)) == 0 \ + && "this assertion is explained here: " \ + "http://eigen.tuxfamily.org/dox-devel/group__TopicUnalignedArrayAssert.html" \ + " **** READ THIS WEB PAGE !!! ****"); +#else + #define EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(sizemask) \ + eigen_assert((internal::UIntPtr(array) & (sizemask)) == 0 \ + && "this assertion is explained here: " \ + "http://eigen.tuxfamily.org/dox-devel/group__TopicUnalignedArrayAssert.html" \ + " **** READ THIS WEB PAGE !!! ****"); +#endif + +template +struct plain_array +{ + EIGEN_ALIGN_TO_BOUNDARY(8) T array[Size]; + + EIGEN_DEVICE_FUNC + plain_array() + { + EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(7); + check_static_allocation_size(); + } + + EIGEN_DEVICE_FUNC + plain_array(constructor_without_unaligned_array_assert) + { + check_static_allocation_size(); + } +}; + +template +struct plain_array +{ + EIGEN_ALIGN_TO_BOUNDARY(16) T array[Size]; + + EIGEN_DEVICE_FUNC + plain_array() + { + EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(15); + check_static_allocation_size(); + } + + EIGEN_DEVICE_FUNC + plain_array(constructor_without_unaligned_array_assert) + { + check_static_allocation_size(); + } +}; + +template +struct plain_array +{ + EIGEN_ALIGN_TO_BOUNDARY(32) T array[Size]; + + EIGEN_DEVICE_FUNC + plain_array() + { + EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(31); + check_static_allocation_size(); + } + + EIGEN_DEVICE_FUNC + plain_array(constructor_without_unaligned_array_assert) + { + check_static_allocation_size(); + } +}; + +template +struct plain_array +{ + EIGEN_ALIGN_TO_BOUNDARY(64) T array[Size]; + + EIGEN_DEVICE_FUNC + plain_array() + { + EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(63); + check_static_allocation_size(); + } + + EIGEN_DEVICE_FUNC + plain_array(constructor_without_unaligned_array_assert) + { + check_static_allocation_size(); + } +}; + +template +struct plain_array +{ + T array[1]; + EIGEN_DEVICE_FUNC plain_array() {} + EIGEN_DEVICE_FUNC plain_array(constructor_without_unaligned_array_assert) {} +}; + +struct plain_array_helper { + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + static void copy(const plain_array& src, const Eigen::Index size, + plain_array& dst) { + smart_copy(src.array, src.array + size, dst.array); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + static void swap(plain_array& a, const Eigen::Index a_size, + plain_array& b, const Eigen::Index b_size) { + if (a_size < b_size) { + std::swap_ranges(b.array, b.array + a_size, a.array); + smart_move(b.array + a_size, b.array + b_size, a.array + a_size); + } else if (a_size > b_size) { + std::swap_ranges(a.array, a.array + b_size, b.array); + smart_move(a.array + b_size, a.array + a_size, b.array + b_size); + } else { + std::swap_ranges(a.array, a.array + a_size, b.array); + } + } +}; + +} // end namespace internal + +/** \internal + * + * \class DenseStorage + * \ingroup Core_Module + * + * \brief Stores the data of a matrix + * + * This class stores the data of fixed-size, dynamic-size or mixed matrices + * in a way as compact as possible. + * + * \sa Matrix + */ +template class DenseStorage; + +// purely fixed-size matrix +template class DenseStorage +{ + internal::plain_array m_data; + public: + EIGEN_DEVICE_FUNC DenseStorage() { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = Size) + } + EIGEN_DEVICE_FUNC + explicit DenseStorage(internal::constructor_without_unaligned_array_assert) + : m_data(internal::constructor_without_unaligned_array_assert()) {} +#if !EIGEN_HAS_CXX11 || defined(EIGEN_DENSE_STORAGE_CTOR_PLUGIN) + EIGEN_DEVICE_FUNC + DenseStorage(const DenseStorage& other) : m_data(other.m_data) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = Size) + } +#else + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage&) = default; +#endif +#if !EIGEN_HAS_CXX11 + EIGEN_DEVICE_FUNC + DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) m_data = other.m_data; + return *this; + } +#else + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage&) = default; +#endif +#if EIGEN_HAS_RVALUE_REFERENCES +#if !EIGEN_HAS_CXX11 + EIGEN_DEVICE_FUNC DenseStorage(DenseStorage&& other) EIGEN_NOEXCEPT + : m_data(std::move(other.m_data)) + { + } + EIGEN_DEVICE_FUNC DenseStorage& operator=(DenseStorage&& other) EIGEN_NOEXCEPT + { + if (this != &other) + m_data = std::move(other.m_data); + return *this; + } +#else + EIGEN_DEVICE_FUNC DenseStorage(DenseStorage&&) = default; + EIGEN_DEVICE_FUNC DenseStorage& operator=(DenseStorage&&) = default; +#endif +#endif + EIGEN_DEVICE_FUNC DenseStorage(Index size, Index rows, Index cols) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + eigen_internal_assert(size==rows*cols && rows==_Rows && cols==_Cols); + EIGEN_UNUSED_VARIABLE(size); + EIGEN_UNUSED_VARIABLE(rows); + EIGEN_UNUSED_VARIABLE(cols); + } + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) { + numext::swap(m_data, other.m_data); + } + EIGEN_DEVICE_FUNC static EIGEN_CONSTEXPR Index rows(void) EIGEN_NOEXCEPT {return _Rows;} + EIGEN_DEVICE_FUNC static EIGEN_CONSTEXPR Index cols(void) EIGEN_NOEXCEPT {return _Cols;} + EIGEN_DEVICE_FUNC void conservativeResize(Index,Index,Index) {} + EIGEN_DEVICE_FUNC void resize(Index,Index,Index) {} + EIGEN_DEVICE_FUNC const T *data() const { return m_data.array; } + EIGEN_DEVICE_FUNC T *data() { return m_data.array; } +}; + +// null matrix +template class DenseStorage +{ + public: + EIGEN_DEVICE_FUNC DenseStorage() {} + EIGEN_DEVICE_FUNC explicit DenseStorage(internal::constructor_without_unaligned_array_assert) {} + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage&) {} + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage&) { return *this; } + EIGEN_DEVICE_FUNC DenseStorage(Index,Index,Index) {} + EIGEN_DEVICE_FUNC void swap(DenseStorage& ) {} + EIGEN_DEVICE_FUNC static EIGEN_CONSTEXPR Index rows(void) EIGEN_NOEXCEPT {return _Rows;} + EIGEN_DEVICE_FUNC static EIGEN_CONSTEXPR Index cols(void) EIGEN_NOEXCEPT {return _Cols;} + EIGEN_DEVICE_FUNC void conservativeResize(Index,Index,Index) {} + EIGEN_DEVICE_FUNC void resize(Index,Index,Index) {} + EIGEN_DEVICE_FUNC const T *data() const { return 0; } + EIGEN_DEVICE_FUNC T *data() { return 0; } +}; + +// more specializations for null matrices; these are necessary to resolve ambiguities +template class DenseStorage +: public DenseStorage { }; + +template class DenseStorage +: public DenseStorage { }; + +template class DenseStorage +: public DenseStorage { }; + +// dynamic-size matrix with fixed-size storage +template class DenseStorage +{ + internal::plain_array m_data; + Index m_rows; + Index m_cols; + public: + EIGEN_DEVICE_FUNC DenseStorage() : m_rows(0), m_cols(0) {} + EIGEN_DEVICE_FUNC explicit DenseStorage(internal::constructor_without_unaligned_array_assert) + : m_data(internal::constructor_without_unaligned_array_assert()), m_rows(0), m_cols(0) {} + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage& other) + : m_data(internal::constructor_without_unaligned_array_assert()), m_rows(other.m_rows), m_cols(other.m_cols) + { + internal::plain_array_helper::copy(other.m_data, m_rows * m_cols, m_data); + } + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) + { + m_rows = other.m_rows; + m_cols = other.m_cols; + internal::plain_array_helper::copy(other.m_data, m_rows * m_cols, m_data); + } + return *this; + } + EIGEN_DEVICE_FUNC DenseStorage(Index, Index rows, Index cols) : m_rows(rows), m_cols(cols) {} + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) + { + internal::plain_array_helper::swap(m_data, m_rows * m_cols, other.m_data, other.m_rows * other.m_cols); + numext::swap(m_rows,other.m_rows); + numext::swap(m_cols,other.m_cols); + } + EIGEN_DEVICE_FUNC Index rows() const {return m_rows;} + EIGEN_DEVICE_FUNC Index cols() const {return m_cols;} + EIGEN_DEVICE_FUNC void conservativeResize(Index, Index rows, Index cols) { m_rows = rows; m_cols = cols; } + EIGEN_DEVICE_FUNC void resize(Index, Index rows, Index cols) { m_rows = rows; m_cols = cols; } + EIGEN_DEVICE_FUNC const T *data() const { return m_data.array; } + EIGEN_DEVICE_FUNC T *data() { return m_data.array; } +}; + +// dynamic-size matrix with fixed-size storage and fixed width +template class DenseStorage +{ + internal::plain_array m_data; + Index m_rows; + public: + EIGEN_DEVICE_FUNC DenseStorage() : m_rows(0) {} + EIGEN_DEVICE_FUNC explicit DenseStorage(internal::constructor_without_unaligned_array_assert) + : m_data(internal::constructor_without_unaligned_array_assert()), m_rows(0) {} + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage& other) + : m_data(internal::constructor_without_unaligned_array_assert()), m_rows(other.m_rows) + { + internal::plain_array_helper::copy(other.m_data, m_rows * _Cols, m_data); + } + + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) + { + m_rows = other.m_rows; + internal::plain_array_helper::copy(other.m_data, m_rows * _Cols, m_data); + } + return *this; + } + EIGEN_DEVICE_FUNC DenseStorage(Index, Index rows, Index) : m_rows(rows) {} + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) + { + internal::plain_array_helper::swap(m_data, m_rows * _Cols, other.m_data, other.m_rows * _Cols); + numext::swap(m_rows, other.m_rows); + } + EIGEN_DEVICE_FUNC Index rows(void) const EIGEN_NOEXCEPT {return m_rows;} + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index cols(void) const EIGEN_NOEXCEPT {return _Cols;} + EIGEN_DEVICE_FUNC void conservativeResize(Index, Index rows, Index) { m_rows = rows; } + EIGEN_DEVICE_FUNC void resize(Index, Index rows, Index) { m_rows = rows; } + EIGEN_DEVICE_FUNC const T *data() const { return m_data.array; } + EIGEN_DEVICE_FUNC T *data() { return m_data.array; } +}; + +// dynamic-size matrix with fixed-size storage and fixed height +template class DenseStorage +{ + internal::plain_array m_data; + Index m_cols; + public: + EIGEN_DEVICE_FUNC DenseStorage() : m_cols(0) {} + EIGEN_DEVICE_FUNC explicit DenseStorage(internal::constructor_without_unaligned_array_assert) + : m_data(internal::constructor_without_unaligned_array_assert()), m_cols(0) {} + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage& other) + : m_data(internal::constructor_without_unaligned_array_assert()), m_cols(other.m_cols) + { + internal::plain_array_helper::copy(other.m_data, _Rows * m_cols, m_data); + } + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) + { + m_cols = other.m_cols; + internal::plain_array_helper::copy(other.m_data, _Rows * m_cols, m_data); + } + return *this; + } + EIGEN_DEVICE_FUNC DenseStorage(Index, Index, Index cols) : m_cols(cols) {} + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) { + internal::plain_array_helper::swap(m_data, _Rows * m_cols, other.m_data, _Rows * other.m_cols); + numext::swap(m_cols, other.m_cols); + } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index rows(void) const EIGEN_NOEXCEPT {return _Rows;} + EIGEN_DEVICE_FUNC Index cols(void) const EIGEN_NOEXCEPT {return m_cols;} + EIGEN_DEVICE_FUNC void conservativeResize(Index, Index, Index cols) { m_cols = cols; } + EIGEN_DEVICE_FUNC void resize(Index, Index, Index cols) { m_cols = cols; } + EIGEN_DEVICE_FUNC const T *data() const { return m_data.array; } + EIGEN_DEVICE_FUNC T *data() { return m_data.array; } +}; + +// purely dynamic matrix. +template class DenseStorage +{ + T *m_data; + Index m_rows; + Index m_cols; + public: + EIGEN_DEVICE_FUNC DenseStorage() : m_data(0), m_rows(0), m_cols(0) {} + EIGEN_DEVICE_FUNC explicit DenseStorage(internal::constructor_without_unaligned_array_assert) + : m_data(0), m_rows(0), m_cols(0) {} + EIGEN_DEVICE_FUNC DenseStorage(Index size, Index rows, Index cols) + : m_data(internal::conditional_aligned_new_auto(size)), m_rows(rows), m_cols(cols) + { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + eigen_internal_assert(size==rows*cols && rows>=0 && cols >=0); + } + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage& other) + : m_data(internal::conditional_aligned_new_auto(other.m_rows*other.m_cols)) + , m_rows(other.m_rows) + , m_cols(other.m_cols) + { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = m_rows*m_cols) + internal::smart_copy(other.m_data, other.m_data+other.m_rows*other.m_cols, m_data); + } + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) + { + DenseStorage tmp(other); + this->swap(tmp); + } + return *this; + } +#if EIGEN_HAS_RVALUE_REFERENCES + EIGEN_DEVICE_FUNC + DenseStorage(DenseStorage&& other) EIGEN_NOEXCEPT + : m_data(std::move(other.m_data)) + , m_rows(std::move(other.m_rows)) + , m_cols(std::move(other.m_cols)) + { + other.m_data = nullptr; + other.m_rows = 0; + other.m_cols = 0; + } + EIGEN_DEVICE_FUNC + DenseStorage& operator=(DenseStorage&& other) EIGEN_NOEXCEPT + { + numext::swap(m_data, other.m_data); + numext::swap(m_rows, other.m_rows); + numext::swap(m_cols, other.m_cols); + return *this; + } +#endif + EIGEN_DEVICE_FUNC ~DenseStorage() { internal::conditional_aligned_delete_auto(m_data, m_rows*m_cols); } + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) + { + numext::swap(m_data,other.m_data); + numext::swap(m_rows,other.m_rows); + numext::swap(m_cols,other.m_cols); + } + EIGEN_DEVICE_FUNC Index rows(void) const EIGEN_NOEXCEPT {return m_rows;} + EIGEN_DEVICE_FUNC Index cols(void) const EIGEN_NOEXCEPT {return m_cols;} + void conservativeResize(Index size, Index rows, Index cols) + { + m_data = internal::conditional_aligned_realloc_new_auto(m_data, size, m_rows*m_cols); + m_rows = rows; + m_cols = cols; + } + EIGEN_DEVICE_FUNC void resize(Index size, Index rows, Index cols) + { + if(size != m_rows*m_cols) + { + internal::conditional_aligned_delete_auto(m_data, m_rows*m_cols); + if (size>0) // >0 and not simply !=0 to let the compiler knows that size cannot be negative + m_data = internal::conditional_aligned_new_auto(size); + else + m_data = 0; + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + } + m_rows = rows; + m_cols = cols; + } + EIGEN_DEVICE_FUNC const T *data() const { return m_data; } + EIGEN_DEVICE_FUNC T *data() { return m_data; } +}; + +// matrix with dynamic width and fixed height (so that matrix has dynamic size). +template class DenseStorage +{ + T *m_data; + Index m_cols; + public: + EIGEN_DEVICE_FUNC DenseStorage() : m_data(0), m_cols(0) {} + explicit DenseStorage(internal::constructor_without_unaligned_array_assert) : m_data(0), m_cols(0) {} + EIGEN_DEVICE_FUNC DenseStorage(Index size, Index rows, Index cols) : m_data(internal::conditional_aligned_new_auto(size)), m_cols(cols) + { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + eigen_internal_assert(size==rows*cols && rows==_Rows && cols >=0); + EIGEN_UNUSED_VARIABLE(rows); + } + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage& other) + : m_data(internal::conditional_aligned_new_auto(_Rows*other.m_cols)) + , m_cols(other.m_cols) + { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = m_cols*_Rows) + internal::smart_copy(other.m_data, other.m_data+_Rows*m_cols, m_data); + } + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) + { + DenseStorage tmp(other); + this->swap(tmp); + } + return *this; + } +#if EIGEN_HAS_RVALUE_REFERENCES + EIGEN_DEVICE_FUNC + DenseStorage(DenseStorage&& other) EIGEN_NOEXCEPT + : m_data(std::move(other.m_data)) + , m_cols(std::move(other.m_cols)) + { + other.m_data = nullptr; + other.m_cols = 0; + } + EIGEN_DEVICE_FUNC + DenseStorage& operator=(DenseStorage&& other) EIGEN_NOEXCEPT + { + numext::swap(m_data, other.m_data); + numext::swap(m_cols, other.m_cols); + return *this; + } +#endif + EIGEN_DEVICE_FUNC ~DenseStorage() { internal::conditional_aligned_delete_auto(m_data, _Rows*m_cols); } + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) { + numext::swap(m_data,other.m_data); + numext::swap(m_cols,other.m_cols); + } + EIGEN_DEVICE_FUNC static EIGEN_CONSTEXPR Index rows(void) EIGEN_NOEXCEPT {return _Rows;} + EIGEN_DEVICE_FUNC Index cols(void) const EIGEN_NOEXCEPT {return m_cols;} + EIGEN_DEVICE_FUNC void conservativeResize(Index size, Index, Index cols) + { + m_data = internal::conditional_aligned_realloc_new_auto(m_data, size, _Rows*m_cols); + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void resize(Index size, Index, Index cols) + { + if(size != _Rows*m_cols) + { + internal::conditional_aligned_delete_auto(m_data, _Rows*m_cols); + if (size>0) // >0 and not simply !=0 to let the compiler knows that size cannot be negative + m_data = internal::conditional_aligned_new_auto(size); + else + m_data = 0; + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + } + m_cols = cols; + } + EIGEN_DEVICE_FUNC const T *data() const { return m_data; } + EIGEN_DEVICE_FUNC T *data() { return m_data; } +}; + +// matrix with dynamic height and fixed width (so that matrix has dynamic size). +template class DenseStorage +{ + T *m_data; + Index m_rows; + public: + EIGEN_DEVICE_FUNC DenseStorage() : m_data(0), m_rows(0) {} + explicit DenseStorage(internal::constructor_without_unaligned_array_assert) : m_data(0), m_rows(0) {} + EIGEN_DEVICE_FUNC DenseStorage(Index size, Index rows, Index cols) : m_data(internal::conditional_aligned_new_auto(size)), m_rows(rows) + { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + eigen_internal_assert(size==rows*cols && rows>=0 && cols == _Cols); + EIGEN_UNUSED_VARIABLE(cols); + } + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage& other) + : m_data(internal::conditional_aligned_new_auto(other.m_rows*_Cols)) + , m_rows(other.m_rows) + { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = m_rows*_Cols) + internal::smart_copy(other.m_data, other.m_data+other.m_rows*_Cols, m_data); + } + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) + { + DenseStorage tmp(other); + this->swap(tmp); + } + return *this; + } +#if EIGEN_HAS_RVALUE_REFERENCES + EIGEN_DEVICE_FUNC + DenseStorage(DenseStorage&& other) EIGEN_NOEXCEPT + : m_data(std::move(other.m_data)) + , m_rows(std::move(other.m_rows)) + { + other.m_data = nullptr; + other.m_rows = 0; + } + EIGEN_DEVICE_FUNC + DenseStorage& operator=(DenseStorage&& other) EIGEN_NOEXCEPT + { + numext::swap(m_data, other.m_data); + numext::swap(m_rows, other.m_rows); + return *this; + } +#endif + EIGEN_DEVICE_FUNC ~DenseStorage() { internal::conditional_aligned_delete_auto(m_data, _Cols*m_rows); } + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) { + numext::swap(m_data,other.m_data); + numext::swap(m_rows,other.m_rows); + } + EIGEN_DEVICE_FUNC Index rows(void) const EIGEN_NOEXCEPT {return m_rows;} + EIGEN_DEVICE_FUNC static EIGEN_CONSTEXPR Index cols(void) {return _Cols;} + void conservativeResize(Index size, Index rows, Index) + { + m_data = internal::conditional_aligned_realloc_new_auto(m_data, size, m_rows*_Cols); + m_rows = rows; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void resize(Index size, Index rows, Index) + { + if(size != m_rows*_Cols) + { + internal::conditional_aligned_delete_auto(m_data, _Cols*m_rows); + if (size>0) // >0 and not simply !=0 to let the compiler knows that size cannot be negative + m_data = internal::conditional_aligned_new_auto(size); + else + m_data = 0; + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + } + m_rows = rows; + } + EIGEN_DEVICE_FUNC const T *data() const { return m_data; } + EIGEN_DEVICE_FUNC T *data() { return m_data; } +}; + +} // end namespace Eigen + +#endif // EIGEN_MATRIX_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Diagonal.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Diagonal.h new file mode 100644 index 0000000..3112d2c --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Diagonal.h @@ -0,0 +1,258 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007-2009 Benoit Jacob +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DIAGONAL_H +#define EIGEN_DIAGONAL_H + +namespace Eigen { + +/** \class Diagonal + * \ingroup Core_Module + * + * \brief Expression of a diagonal/subdiagonal/superdiagonal in a matrix + * + * \param MatrixType the type of the object in which we are taking a sub/main/super diagonal + * \param DiagIndex the index of the sub/super diagonal. The default is 0 and it means the main diagonal. + * A positive value means a superdiagonal, a negative value means a subdiagonal. + * You can also use DynamicIndex so the index can be set at runtime. + * + * The matrix is not required to be square. + * + * This class represents an expression of the main diagonal, or any sub/super diagonal + * of a square matrix. It is the return type of MatrixBase::diagonal() and MatrixBase::diagonal(Index) and most of the + * time this is the only way it is used. + * + * \sa MatrixBase::diagonal(), MatrixBase::diagonal(Index) + */ + +namespace internal { +template +struct traits > + : traits +{ + typedef typename ref_selector::type MatrixTypeNested; + typedef typename remove_reference::type _MatrixTypeNested; + typedef typename MatrixType::StorageKind StorageKind; + enum { + RowsAtCompileTime = (int(DiagIndex) == DynamicIndex || int(MatrixType::SizeAtCompileTime) == Dynamic) ? Dynamic + : (EIGEN_PLAIN_ENUM_MIN(MatrixType::RowsAtCompileTime - EIGEN_PLAIN_ENUM_MAX(-DiagIndex, 0), + MatrixType::ColsAtCompileTime - EIGEN_PLAIN_ENUM_MAX( DiagIndex, 0))), + ColsAtCompileTime = 1, + MaxRowsAtCompileTime = int(MatrixType::MaxSizeAtCompileTime) == Dynamic ? Dynamic + : DiagIndex == DynamicIndex ? EIGEN_SIZE_MIN_PREFER_FIXED(MatrixType::MaxRowsAtCompileTime, + MatrixType::MaxColsAtCompileTime) + : (EIGEN_PLAIN_ENUM_MIN(MatrixType::MaxRowsAtCompileTime - EIGEN_PLAIN_ENUM_MAX(-DiagIndex, 0), + MatrixType::MaxColsAtCompileTime - EIGEN_PLAIN_ENUM_MAX( DiagIndex, 0))), + MaxColsAtCompileTime = 1, + MaskLvalueBit = is_lvalue::value ? LvalueBit : 0, + Flags = (unsigned int)_MatrixTypeNested::Flags & (RowMajorBit | MaskLvalueBit | DirectAccessBit) & ~RowMajorBit, // FIXME DirectAccessBit should not be handled by expressions + MatrixTypeOuterStride = outer_stride_at_compile_time::ret, + InnerStrideAtCompileTime = MatrixTypeOuterStride == Dynamic ? Dynamic : MatrixTypeOuterStride+1, + OuterStrideAtCompileTime = 0 + }; +}; +} + +template class Diagonal + : public internal::dense_xpr_base< Diagonal >::type +{ + public: + + enum { DiagIndex = _DiagIndex }; + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Diagonal) + + EIGEN_DEVICE_FUNC + explicit inline Diagonal(MatrixType& matrix, Index a_index = DiagIndex) : m_matrix(matrix), m_index(a_index) + { + eigen_assert( a_index <= m_matrix.cols() && -a_index <= m_matrix.rows() ); + } + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Diagonal) + + EIGEN_DEVICE_FUNC + inline Index rows() const + { + return m_index.value()<0 ? numext::mini(m_matrix.cols(),m_matrix.rows()+m_index.value()) + : numext::mini(m_matrix.rows(),m_matrix.cols()-m_index.value()); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return 1; } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT { + return m_matrix.outerStride() + 1; + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT { return 0; } + + typedef typename internal::conditional< + internal::is_lvalue::value, + Scalar, + const Scalar + >::type ScalarWithConstIfNotLvalue; + + EIGEN_DEVICE_FUNC + inline ScalarWithConstIfNotLvalue* data() { return &(m_matrix.coeffRef(rowOffset(), colOffset())); } + EIGEN_DEVICE_FUNC + inline const Scalar* data() const { return &(m_matrix.coeffRef(rowOffset(), colOffset())); } + + EIGEN_DEVICE_FUNC + inline Scalar& coeffRef(Index row, Index) + { + EIGEN_STATIC_ASSERT_LVALUE(MatrixType) + return m_matrix.coeffRef(row+rowOffset(), row+colOffset()); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index row, Index) const + { + return m_matrix.coeffRef(row+rowOffset(), row+colOffset()); + } + + EIGEN_DEVICE_FUNC + inline CoeffReturnType coeff(Index row, Index) const + { + return m_matrix.coeff(row+rowOffset(), row+colOffset()); + } + + EIGEN_DEVICE_FUNC + inline Scalar& coeffRef(Index idx) + { + EIGEN_STATIC_ASSERT_LVALUE(MatrixType) + return m_matrix.coeffRef(idx+rowOffset(), idx+colOffset()); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index idx) const + { + return m_matrix.coeffRef(idx+rowOffset(), idx+colOffset()); + } + + EIGEN_DEVICE_FUNC + inline CoeffReturnType coeff(Index idx) const + { + return m_matrix.coeff(idx+rowOffset(), idx+colOffset()); + } + + EIGEN_DEVICE_FUNC + inline const typename internal::remove_all::type& + nestedExpression() const + { + return m_matrix; + } + + EIGEN_DEVICE_FUNC + inline Index index() const + { + return m_index.value(); + } + + protected: + typename internal::ref_selector::non_const_type m_matrix; + const internal::variable_if_dynamicindex m_index; + + private: + // some compilers may fail to optimize std::max etc in case of compile-time constants... + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index absDiagIndex() const EIGEN_NOEXCEPT { return m_index.value()>0 ? m_index.value() : -m_index.value(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rowOffset() const EIGEN_NOEXCEPT { return m_index.value()>0 ? 0 : -m_index.value(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index colOffset() const EIGEN_NOEXCEPT { return m_index.value()>0 ? m_index.value() : 0; } + // trigger a compile-time error if someone try to call packet + template typename MatrixType::PacketReturnType packet(Index) const; + template typename MatrixType::PacketReturnType packet(Index,Index) const; +}; + +/** \returns an expression of the main diagonal of the matrix \c *this + * + * \c *this is not required to be square. + * + * Example: \include MatrixBase_diagonal.cpp + * Output: \verbinclude MatrixBase_diagonal.out + * + * \sa class Diagonal */ +template +EIGEN_DEVICE_FUNC inline typename MatrixBase::DiagonalReturnType +MatrixBase::diagonal() +{ + return DiagonalReturnType(derived()); +} + +/** This is the const version of diagonal(). */ +template +EIGEN_DEVICE_FUNC inline typename MatrixBase::ConstDiagonalReturnType +MatrixBase::diagonal() const +{ + return ConstDiagonalReturnType(derived()); +} + +/** \returns an expression of the \a DiagIndex-th sub or super diagonal of the matrix \c *this + * + * \c *this is not required to be square. + * + * The template parameter \a DiagIndex represent a super diagonal if \a DiagIndex > 0 + * and a sub diagonal otherwise. \a DiagIndex == 0 is equivalent to the main diagonal. + * + * Example: \include MatrixBase_diagonal_int.cpp + * Output: \verbinclude MatrixBase_diagonal_int.out + * + * \sa MatrixBase::diagonal(), class Diagonal */ +template +EIGEN_DEVICE_FUNC inline typename MatrixBase::DiagonalDynamicIndexReturnType +MatrixBase::diagonal(Index index) +{ + return DiagonalDynamicIndexReturnType(derived(), index); +} + +/** This is the const version of diagonal(Index). */ +template +EIGEN_DEVICE_FUNC inline typename MatrixBase::ConstDiagonalDynamicIndexReturnType +MatrixBase::diagonal(Index index) const +{ + return ConstDiagonalDynamicIndexReturnType(derived(), index); +} + +/** \returns an expression of the \a DiagIndex-th sub or super diagonal of the matrix \c *this + * + * \c *this is not required to be square. + * + * The template parameter \a DiagIndex represent a super diagonal if \a DiagIndex > 0 + * and a sub diagonal otherwise. \a DiagIndex == 0 is equivalent to the main diagonal. + * + * Example: \include MatrixBase_diagonal_template_int.cpp + * Output: \verbinclude MatrixBase_diagonal_template_int.out + * + * \sa MatrixBase::diagonal(), class Diagonal */ +template +template +EIGEN_DEVICE_FUNC +inline typename MatrixBase::template DiagonalIndexReturnType::Type +MatrixBase::diagonal() +{ + return typename DiagonalIndexReturnType::Type(derived()); +} + +/** This is the const version of diagonal(). */ +template +template +EIGEN_DEVICE_FUNC +inline typename MatrixBase::template ConstDiagonalIndexReturnType::Type +MatrixBase::diagonal() const +{ + return typename ConstDiagonalIndexReturnType::Type(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_DIAGONAL_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DiagonalMatrix.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DiagonalMatrix.h new file mode 100644 index 0000000..542685c --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DiagonalMatrix.h @@ -0,0 +1,391 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// Copyright (C) 2007-2009 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DIAGONALMATRIX_H +#define EIGEN_DIAGONALMATRIX_H + +namespace Eigen { + +#ifndef EIGEN_PARSED_BY_DOXYGEN +template +class DiagonalBase : public EigenBase +{ + public: + typedef typename internal::traits::DiagonalVectorType DiagonalVectorType; + typedef typename DiagonalVectorType::Scalar Scalar; + typedef typename DiagonalVectorType::RealScalar RealScalar; + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + + enum { + RowsAtCompileTime = DiagonalVectorType::SizeAtCompileTime, + ColsAtCompileTime = DiagonalVectorType::SizeAtCompileTime, + MaxRowsAtCompileTime = DiagonalVectorType::MaxSizeAtCompileTime, + MaxColsAtCompileTime = DiagonalVectorType::MaxSizeAtCompileTime, + IsVectorAtCompileTime = 0, + Flags = NoPreferredStorageOrderBit + }; + + typedef Matrix DenseMatrixType; + typedef DenseMatrixType DenseType; + typedef DiagonalMatrix PlainObject; + + EIGEN_DEVICE_FUNC + inline const Derived& derived() const { return *static_cast(this); } + EIGEN_DEVICE_FUNC + inline Derived& derived() { return *static_cast(this); } + + EIGEN_DEVICE_FUNC + DenseMatrixType toDenseMatrix() const { return derived(); } + + EIGEN_DEVICE_FUNC + inline const DiagonalVectorType& diagonal() const { return derived().diagonal(); } + EIGEN_DEVICE_FUNC + inline DiagonalVectorType& diagonal() { return derived().diagonal(); } + + EIGEN_DEVICE_FUNC + inline Index rows() const { return diagonal().size(); } + EIGEN_DEVICE_FUNC + inline Index cols() const { return diagonal().size(); } + + template + EIGEN_DEVICE_FUNC + const Product + operator*(const MatrixBase &matrix) const + { + return Product(derived(),matrix.derived()); + } + + typedef DiagonalWrapper, const DiagonalVectorType> > InverseReturnType; + EIGEN_DEVICE_FUNC + inline const InverseReturnType + inverse() const + { + return InverseReturnType(diagonal().cwiseInverse()); + } + + EIGEN_DEVICE_FUNC + inline const DiagonalWrapper + operator*(const Scalar& scalar) const + { + return DiagonalWrapper(diagonal() * scalar); + } + EIGEN_DEVICE_FUNC + friend inline const DiagonalWrapper + operator*(const Scalar& scalar, const DiagonalBase& other) + { + return DiagonalWrapper(scalar * other.diagonal()); + } + + template + EIGEN_DEVICE_FUNC + #ifdef EIGEN_PARSED_BY_DOXYGEN + inline unspecified_expression_type + #else + inline const DiagonalWrapper + #endif + operator+(const DiagonalBase& other) const + { + return (diagonal() + other.diagonal()).asDiagonal(); + } + + template + EIGEN_DEVICE_FUNC + #ifdef EIGEN_PARSED_BY_DOXYGEN + inline unspecified_expression_type + #else + inline const DiagonalWrapper + #endif + operator-(const DiagonalBase& other) const + { + return (diagonal() - other.diagonal()).asDiagonal(); + } +}; + +#endif + +/** \class DiagonalMatrix + * \ingroup Core_Module + * + * \brief Represents a diagonal matrix with its storage + * + * \param _Scalar the type of coefficients + * \param SizeAtCompileTime the dimension of the matrix, or Dynamic + * \param MaxSizeAtCompileTime the dimension of the matrix, or Dynamic. This parameter is optional and defaults + * to SizeAtCompileTime. Most of the time, you do not need to specify it. + * + * \sa class DiagonalWrapper + */ + +namespace internal { +template +struct traits > + : traits > +{ + typedef Matrix<_Scalar,SizeAtCompileTime,1,0,MaxSizeAtCompileTime,1> DiagonalVectorType; + typedef DiagonalShape StorageKind; + enum { + Flags = LvalueBit | NoPreferredStorageOrderBit + }; +}; +} +template +class DiagonalMatrix + : public DiagonalBase > +{ + public: + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename internal::traits::DiagonalVectorType DiagonalVectorType; + typedef const DiagonalMatrix& Nested; + typedef _Scalar Scalar; + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + #endif + + protected: + + DiagonalVectorType m_diagonal; + + public: + + /** const version of diagonal(). */ + EIGEN_DEVICE_FUNC + inline const DiagonalVectorType& diagonal() const { return m_diagonal; } + /** \returns a reference to the stored vector of diagonal coefficients. */ + EIGEN_DEVICE_FUNC + inline DiagonalVectorType& diagonal() { return m_diagonal; } + + /** Default constructor without initialization */ + EIGEN_DEVICE_FUNC + inline DiagonalMatrix() {} + + /** Constructs a diagonal matrix with given dimension */ + EIGEN_DEVICE_FUNC + explicit inline DiagonalMatrix(Index dim) : m_diagonal(dim) {} + + /** 2D constructor. */ + EIGEN_DEVICE_FUNC + inline DiagonalMatrix(const Scalar& x, const Scalar& y) : m_diagonal(x,y) {} + + /** 3D constructor. */ + EIGEN_DEVICE_FUNC + inline DiagonalMatrix(const Scalar& x, const Scalar& y, const Scalar& z) : m_diagonal(x,y,z) {} + + #if EIGEN_HAS_CXX11 + /** \brief Construct a diagonal matrix with fixed size from an arbitrary number of coefficients. \cpp11 + * + * There exists C++98 anologue constructors for fixed-size diagonal matrices having 2 or 3 coefficients. + * + * \warning To construct a diagonal matrix of fixed size, the number of values passed to this + * constructor must match the fixed dimension of \c *this. + * + * \sa DiagonalMatrix(const Scalar&, const Scalar&) + * \sa DiagonalMatrix(const Scalar&, const Scalar&, const Scalar&) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + DiagonalMatrix(const Scalar& a0, const Scalar& a1, const Scalar& a2, const ArgTypes&... args) + : m_diagonal(a0, a1, a2, args...) {} + + /** \brief Constructs a DiagonalMatrix and initializes it by elements given by an initializer list of initializer + * lists \cpp11 + */ + EIGEN_DEVICE_FUNC + explicit EIGEN_STRONG_INLINE DiagonalMatrix(const std::initializer_list>& list) + : m_diagonal(list) {} + #endif // EIGEN_HAS_CXX11 + + /** Copy constructor. */ + template + EIGEN_DEVICE_FUNC + inline DiagonalMatrix(const DiagonalBase& other) : m_diagonal(other.diagonal()) {} + + #ifndef EIGEN_PARSED_BY_DOXYGEN + /** copy constructor. prevent a default copy constructor from hiding the other templated constructor */ + inline DiagonalMatrix(const DiagonalMatrix& other) : m_diagonal(other.diagonal()) {} + #endif + + /** generic constructor from expression of the diagonal coefficients */ + template + EIGEN_DEVICE_FUNC + explicit inline DiagonalMatrix(const MatrixBase& other) : m_diagonal(other) + {} + + /** Copy operator. */ + template + EIGEN_DEVICE_FUNC + DiagonalMatrix& operator=(const DiagonalBase& other) + { + m_diagonal = other.diagonal(); + return *this; + } + + #ifndef EIGEN_PARSED_BY_DOXYGEN + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + EIGEN_DEVICE_FUNC + DiagonalMatrix& operator=(const DiagonalMatrix& other) + { + m_diagonal = other.diagonal(); + return *this; + } + #endif + + /** Resizes to given size. */ + EIGEN_DEVICE_FUNC + inline void resize(Index size) { m_diagonal.resize(size); } + /** Sets all coefficients to zero. */ + EIGEN_DEVICE_FUNC + inline void setZero() { m_diagonal.setZero(); } + /** Resizes and sets all coefficients to zero. */ + EIGEN_DEVICE_FUNC + inline void setZero(Index size) { m_diagonal.setZero(size); } + /** Sets this matrix to be the identity matrix of the current size. */ + EIGEN_DEVICE_FUNC + inline void setIdentity() { m_diagonal.setOnes(); } + /** Sets this matrix to be the identity matrix of the given size. */ + EIGEN_DEVICE_FUNC + inline void setIdentity(Index size) { m_diagonal.setOnes(size); } +}; + +/** \class DiagonalWrapper + * \ingroup Core_Module + * + * \brief Expression of a diagonal matrix + * + * \param _DiagonalVectorType the type of the vector of diagonal coefficients + * + * This class is an expression of a diagonal matrix, but not storing its own vector of diagonal coefficients, + * instead wrapping an existing vector expression. It is the return type of MatrixBase::asDiagonal() + * and most of the time this is the only way that it is used. + * + * \sa class DiagonalMatrix, class DiagonalBase, MatrixBase::asDiagonal() + */ + +namespace internal { +template +struct traits > +{ + typedef _DiagonalVectorType DiagonalVectorType; + typedef typename DiagonalVectorType::Scalar Scalar; + typedef typename DiagonalVectorType::StorageIndex StorageIndex; + typedef DiagonalShape StorageKind; + typedef typename traits::XprKind XprKind; + enum { + RowsAtCompileTime = DiagonalVectorType::SizeAtCompileTime, + ColsAtCompileTime = DiagonalVectorType::SizeAtCompileTime, + MaxRowsAtCompileTime = DiagonalVectorType::MaxSizeAtCompileTime, + MaxColsAtCompileTime = DiagonalVectorType::MaxSizeAtCompileTime, + Flags = (traits::Flags & LvalueBit) | NoPreferredStorageOrderBit + }; +}; +} + +template +class DiagonalWrapper + : public DiagonalBase >, internal::no_assignment_operator +{ + public: + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef _DiagonalVectorType DiagonalVectorType; + typedef DiagonalWrapper Nested; + #endif + + /** Constructor from expression of diagonal coefficients to wrap. */ + EIGEN_DEVICE_FUNC + explicit inline DiagonalWrapper(DiagonalVectorType& a_diagonal) : m_diagonal(a_diagonal) {} + + /** \returns a const reference to the wrapped expression of diagonal coefficients. */ + EIGEN_DEVICE_FUNC + const DiagonalVectorType& diagonal() const { return m_diagonal; } + + protected: + typename DiagonalVectorType::Nested m_diagonal; +}; + +/** \returns a pseudo-expression of a diagonal matrix with *this as vector of diagonal coefficients + * + * \only_for_vectors + * + * Example: \include MatrixBase_asDiagonal.cpp + * Output: \verbinclude MatrixBase_asDiagonal.out + * + * \sa class DiagonalWrapper, class DiagonalMatrix, diagonal(), isDiagonal() + **/ +template +EIGEN_DEVICE_FUNC inline const DiagonalWrapper +MatrixBase::asDiagonal() const +{ + return DiagonalWrapper(derived()); +} + +/** \returns true if *this is approximately equal to a diagonal matrix, + * within the precision given by \a prec. + * + * Example: \include MatrixBase_isDiagonal.cpp + * Output: \verbinclude MatrixBase_isDiagonal.out + * + * \sa asDiagonal() + */ +template +bool MatrixBase::isDiagonal(const RealScalar& prec) const +{ + if(cols() != rows()) return false; + RealScalar maxAbsOnDiagonal = static_cast(-1); + for(Index j = 0; j < cols(); ++j) + { + RealScalar absOnDiagonal = numext::abs(coeff(j,j)); + if(absOnDiagonal > maxAbsOnDiagonal) maxAbsOnDiagonal = absOnDiagonal; + } + for(Index j = 0; j < cols(); ++j) + for(Index i = 0; i < j; ++i) + { + if(!internal::isMuchSmallerThan(coeff(i, j), maxAbsOnDiagonal, prec)) return false; + if(!internal::isMuchSmallerThan(coeff(j, i), maxAbsOnDiagonal, prec)) return false; + } + return true; +} + +namespace internal { + +template<> struct storage_kind_to_shape { typedef DiagonalShape Shape; }; + +struct Diagonal2Dense {}; + +template<> struct AssignmentKind { typedef Diagonal2Dense Kind; }; + +// Diagonal matrix to Dense assignment +template< typename DstXprType, typename SrcXprType, typename Functor> +struct Assignment +{ + static void run(DstXprType &dst, const SrcXprType &src, const internal::assign_op &/*func*/) + { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if((dst.rows()!=dstRows) || (dst.cols()!=dstCols)) + dst.resize(dstRows, dstCols); + + dst.setZero(); + dst.diagonal() = src.diagonal(); + } + + static void run(DstXprType &dst, const SrcXprType &src, const internal::add_assign_op &/*func*/) + { dst.diagonal() += src.diagonal(); } + + static void run(DstXprType &dst, const SrcXprType &src, const internal::sub_assign_op &/*func*/) + { dst.diagonal() -= src.diagonal(); } +}; + +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_DIAGONALMATRIX_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DiagonalProduct.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DiagonalProduct.h new file mode 100644 index 0000000..7911d1c --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/DiagonalProduct.h @@ -0,0 +1,28 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2007-2009 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DIAGONALPRODUCT_H +#define EIGEN_DIAGONALPRODUCT_H + +namespace Eigen { + +/** \returns the diagonal matrix product of \c *this by the diagonal matrix \a diagonal. + */ +template +template +EIGEN_DEVICE_FUNC inline const Product +MatrixBase::operator*(const DiagonalBase &a_diagonal) const +{ + return Product(derived(),a_diagonal.derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_DIAGONALPRODUCT_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Dot.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Dot.h new file mode 100644 index 0000000..5c3441b --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Dot.h @@ -0,0 +1,318 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008, 2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DOT_H +#define EIGEN_DOT_H + +namespace Eigen { + +namespace internal { + +// helper function for dot(). The problem is that if we put that in the body of dot(), then upon calling dot +// with mismatched types, the compiler emits errors about failing to instantiate cwiseProduct BEFORE +// looking at the static assertions. Thus this is a trick to get better compile errors. +template +struct dot_nocheck +{ + typedef scalar_conj_product_op::Scalar,typename traits::Scalar> conj_prod; + typedef typename conj_prod::result_type ResScalar; + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE + static ResScalar run(const MatrixBase& a, const MatrixBase& b) + { + return a.template binaryExpr(b).sum(); + } +}; + +template +struct dot_nocheck +{ + typedef scalar_conj_product_op::Scalar,typename traits::Scalar> conj_prod; + typedef typename conj_prod::result_type ResScalar; + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE + static ResScalar run(const MatrixBase& a, const MatrixBase& b) + { + return a.transpose().template binaryExpr(b).sum(); + } +}; + +} // end namespace internal + +/** \fn MatrixBase::dot + * \returns the dot product of *this with other. + * + * \only_for_vectors + * + * \note If the scalar type is complex numbers, then this function returns the hermitian + * (sesquilinear) dot product, conjugate-linear in the first variable and linear in the + * second variable. + * + * \sa squaredNorm(), norm() + */ +template +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE +typename ScalarBinaryOpTraits::Scalar,typename internal::traits::Scalar>::ReturnType +MatrixBase::dot(const MatrixBase& other) const +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + EIGEN_STATIC_ASSERT_VECTOR_ONLY(OtherDerived) + EIGEN_STATIC_ASSERT_SAME_VECTOR_SIZE(Derived,OtherDerived) +#if !(defined(EIGEN_NO_STATIC_ASSERT) && defined(EIGEN_NO_DEBUG)) + typedef internal::scalar_conj_product_op func; + EIGEN_CHECK_BINARY_COMPATIBILIY(func,Scalar,typename OtherDerived::Scalar); +#endif + + eigen_assert(size() == other.size()); + + return internal::dot_nocheck::run(*this, other); +} + +//---------- implementation of L2 norm and related functions ---------- + +/** \returns, for vectors, the squared \em l2 norm of \c *this, and for matrices the squared Frobenius norm. + * In both cases, it consists in the sum of the square of all the matrix entries. + * For vectors, this is also equals to the dot product of \c *this with itself. + * + * \sa dot(), norm(), lpNorm() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename NumTraits::Scalar>::Real MatrixBase::squaredNorm() const +{ + return numext::real((*this).cwiseAbs2().sum()); +} + +/** \returns, for vectors, the \em l2 norm of \c *this, and for matrices the Frobenius norm. + * In both cases, it consists in the square root of the sum of the square of all the matrix entries. + * For vectors, this is also equals to the square root of the dot product of \c *this with itself. + * + * \sa lpNorm(), dot(), squaredNorm() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename NumTraits::Scalar>::Real MatrixBase::norm() const +{ + return numext::sqrt(squaredNorm()); +} + +/** \returns an expression of the quotient of \c *this by its own norm. + * + * \warning If the input vector is too small (i.e., this->norm()==0), + * then this function returns a copy of the input. + * + * \only_for_vectors + * + * \sa norm(), normalize() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::PlainObject +MatrixBase::normalized() const +{ + typedef typename internal::nested_eval::type _Nested; + _Nested n(derived()); + RealScalar z = n.squaredNorm(); + // NOTE: after extensive benchmarking, this conditional does not impact performance, at least on recent x86 CPU + if(z>RealScalar(0)) + return n / numext::sqrt(z); + else + return n; +} + +/** Normalizes the vector, i.e. divides it by its own norm. + * + * \only_for_vectors + * + * \warning If the input vector is too small (i.e., this->norm()==0), then \c *this is left unchanged. + * + * \sa norm(), normalized() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void MatrixBase::normalize() +{ + RealScalar z = squaredNorm(); + // NOTE: after extensive benchmarking, this conditional does not impact performance, at least on recent x86 CPU + if(z>RealScalar(0)) + derived() /= numext::sqrt(z); +} + +/** \returns an expression of the quotient of \c *this by its own norm while avoiding underflow and overflow. + * + * \only_for_vectors + * + * This method is analogue to the normalized() method, but it reduces the risk of + * underflow and overflow when computing the norm. + * + * \warning If the input vector is too small (i.e., this->norm()==0), + * then this function returns a copy of the input. + * + * \sa stableNorm(), stableNormalize(), normalized() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::PlainObject +MatrixBase::stableNormalized() const +{ + typedef typename internal::nested_eval::type _Nested; + _Nested n(derived()); + RealScalar w = n.cwiseAbs().maxCoeff(); + RealScalar z = (n/w).squaredNorm(); + if(z>RealScalar(0)) + return n / (numext::sqrt(z)*w); + else + return n; +} + +/** Normalizes the vector while avoid underflow and overflow + * + * \only_for_vectors + * + * This method is analogue to the normalize() method, but it reduces the risk of + * underflow and overflow when computing the norm. + * + * \warning If the input vector is too small (i.e., this->norm()==0), then \c *this is left unchanged. + * + * \sa stableNorm(), stableNormalized(), normalize() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void MatrixBase::stableNormalize() +{ + RealScalar w = cwiseAbs().maxCoeff(); + RealScalar z = (derived()/w).squaredNorm(); + if(z>RealScalar(0)) + derived() /= numext::sqrt(z)*w; +} + +//---------- implementation of other norms ---------- + +namespace internal { + +template +struct lpNorm_selector +{ + typedef typename NumTraits::Scalar>::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const MatrixBase& m) + { + EIGEN_USING_STD(pow) + return pow(m.cwiseAbs().array().pow(p).sum(), RealScalar(1)/p); + } +}; + +template +struct lpNorm_selector +{ + EIGEN_DEVICE_FUNC + static inline typename NumTraits::Scalar>::Real run(const MatrixBase& m) + { + return m.cwiseAbs().sum(); + } +}; + +template +struct lpNorm_selector +{ + EIGEN_DEVICE_FUNC + static inline typename NumTraits::Scalar>::Real run(const MatrixBase& m) + { + return m.norm(); + } +}; + +template +struct lpNorm_selector +{ + typedef typename NumTraits::Scalar>::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const MatrixBase& m) + { + if(Derived::SizeAtCompileTime==0 || (Derived::SizeAtCompileTime==Dynamic && m.size()==0)) + return RealScalar(0); + return m.cwiseAbs().maxCoeff(); + } +}; + +} // end namespace internal + +/** \returns the \b coefficient-wise \f$ \ell^p \f$ norm of \c *this, that is, returns the p-th root of the sum of the p-th powers of the absolute values + * of the coefficients of \c *this. If \a p is the special value \a Eigen::Infinity, this function returns the \f$ \ell^\infty \f$ + * norm, that is the maximum of the absolute values of the coefficients of \c *this. + * + * In all cases, if \c *this is empty, then the value 0 is returned. + * + * \note For matrices, this function does not compute the operator-norm. That is, if \c *this is a matrix, then its coefficients are interpreted as a 1D vector. Nonetheless, you can easily compute the 1-norm and \f$\infty\f$-norm matrix operator norms using \link TutorialReductionsVisitorsBroadcastingReductionsNorm partial reductions \endlink. + * + * \sa norm() + */ +template +template +#ifndef EIGEN_PARSED_BY_DOXYGEN +EIGEN_DEVICE_FUNC inline typename NumTraits::Scalar>::Real +#else +EIGEN_DEVICE_FUNC MatrixBase::RealScalar +#endif +MatrixBase::lpNorm() const +{ + return internal::lpNorm_selector::run(*this); +} + +//---------- implementation of isOrthogonal / isUnitary ---------- + +/** \returns true if *this is approximately orthogonal to \a other, + * within the precision given by \a prec. + * + * Example: \include MatrixBase_isOrthogonal.cpp + * Output: \verbinclude MatrixBase_isOrthogonal.out + */ +template +template +bool MatrixBase::isOrthogonal +(const MatrixBase& other, const RealScalar& prec) const +{ + typename internal::nested_eval::type nested(derived()); + typename internal::nested_eval::type otherNested(other.derived()); + return numext::abs2(nested.dot(otherNested)) <= prec * prec * nested.squaredNorm() * otherNested.squaredNorm(); +} + +/** \returns true if *this is approximately an unitary matrix, + * within the precision given by \a prec. In the case where the \a Scalar + * type is real numbers, a unitary matrix is an orthogonal matrix, whence the name. + * + * \note This can be used to check whether a family of vectors forms an orthonormal basis. + * Indeed, \c m.isUnitary() returns true if and only if the columns (equivalently, the rows) of m form an + * orthonormal basis. + * + * Example: \include MatrixBase_isUnitary.cpp + * Output: \verbinclude MatrixBase_isUnitary.out + */ +template +bool MatrixBase::isUnitary(const RealScalar& prec) const +{ + typename internal::nested_eval::type self(derived()); + for(Index i = 0; i < cols(); ++i) + { + if(!internal::isApprox(self.col(i).squaredNorm(), static_cast(1), prec)) + return false; + for(Index j = 0; j < i; ++j) + if(!internal::isMuchSmallerThan(self.col(i).dot(self.col(j)), static_cast(1), prec)) + return false; + } + return true; +} + +} // end namespace Eigen + +#endif // EIGEN_DOT_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/EigenBase.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/EigenBase.h new file mode 100644 index 0000000..6b3c7d3 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/EigenBase.h @@ -0,0 +1,160 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Benoit Jacob +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_EIGENBASE_H +#define EIGEN_EIGENBASE_H + +namespace Eigen { + +/** \class EigenBase + * \ingroup Core_Module + * + * Common base class for all classes T such that MatrixBase has an operator=(T) and a constructor MatrixBase(T). + * + * In other words, an EigenBase object is an object that can be copied into a MatrixBase. + * + * Besides MatrixBase-derived classes, this also includes special matrix classes such as diagonal matrices, etc. + * + * Notice that this class is trivial, it is only used to disambiguate overloaded functions. + * + * \sa \blank \ref TopicClassHierarchy + */ +template struct EigenBase +{ +// typedef typename internal::plain_matrix_type::type PlainObject; + + /** \brief The interface type of indices + * \details To change this, \c \#define the preprocessor symbol \c EIGEN_DEFAULT_DENSE_INDEX_TYPE. + * \sa StorageIndex, \ref TopicPreprocessorDirectives. + * DEPRECATED: Since Eigen 3.3, its usage is deprecated. Use Eigen::Index instead. + * Deprecation is not marked with a doxygen comment because there are too many existing usages to add the deprecation attribute. + */ + typedef Eigen::Index Index; + + // FIXME is it needed? + typedef typename internal::traits::StorageKind StorageKind; + + /** \returns a reference to the derived object */ + EIGEN_DEVICE_FUNC + Derived& derived() { return *static_cast(this); } + /** \returns a const reference to the derived object */ + EIGEN_DEVICE_FUNC + const Derived& derived() const { return *static_cast(this); } + + EIGEN_DEVICE_FUNC + inline Derived& const_cast_derived() const + { return *static_cast(const_cast(this)); } + EIGEN_DEVICE_FUNC + inline const Derived& const_derived() const + { return *static_cast(this); } + + /** \returns the number of rows. \sa cols(), RowsAtCompileTime */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return derived().rows(); } + /** \returns the number of columns. \sa rows(), ColsAtCompileTime*/ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return derived().cols(); } + /** \returns the number of coefficients, which is rows()*cols(). + * \sa rows(), cols(), SizeAtCompileTime. */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index size() const EIGEN_NOEXCEPT { return rows() * cols(); } + + /** \internal Don't use it, but do the equivalent: \code dst = *this; \endcode */ + template + EIGEN_DEVICE_FUNC + inline void evalTo(Dest& dst) const + { derived().evalTo(dst); } + + /** \internal Don't use it, but do the equivalent: \code dst += *this; \endcode */ + template + EIGEN_DEVICE_FUNC + inline void addTo(Dest& dst) const + { + // This is the default implementation, + // derived class can reimplement it in a more optimized way. + typename Dest::PlainObject res(rows(),cols()); + evalTo(res); + dst += res; + } + + /** \internal Don't use it, but do the equivalent: \code dst -= *this; \endcode */ + template + EIGEN_DEVICE_FUNC + inline void subTo(Dest& dst) const + { + // This is the default implementation, + // derived class can reimplement it in a more optimized way. + typename Dest::PlainObject res(rows(),cols()); + evalTo(res); + dst -= res; + } + + /** \internal Don't use it, but do the equivalent: \code dst.applyOnTheRight(*this); \endcode */ + template + EIGEN_DEVICE_FUNC inline void applyThisOnTheRight(Dest& dst) const + { + // This is the default implementation, + // derived class can reimplement it in a more optimized way. + dst = dst * this->derived(); + } + + /** \internal Don't use it, but do the equivalent: \code dst.applyOnTheLeft(*this); \endcode */ + template + EIGEN_DEVICE_FUNC inline void applyThisOnTheLeft(Dest& dst) const + { + // This is the default implementation, + // derived class can reimplement it in a more optimized way. + dst = this->derived() * dst; + } + +}; + +/*************************************************************************** +* Implementation of matrix base methods +***************************************************************************/ + +/** \brief Copies the generic expression \a other into *this. + * + * \details The expression must provide a (templated) evalTo(Derived& dst) const + * function which does the actual job. In practice, this allows any user to write + * its own special matrix without having to modify MatrixBase + * + * \returns a reference to *this. + */ +template +template +EIGEN_DEVICE_FUNC +Derived& DenseBase::operator=(const EigenBase &other) +{ + call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC +Derived& DenseBase::operator+=(const EigenBase &other) +{ + call_assignment(derived(), other.derived(), internal::add_assign_op()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC +Derived& DenseBase::operator-=(const EigenBase &other) +{ + call_assignment(derived(), other.derived(), internal::sub_assign_op()); + return derived(); +} + +} // end namespace Eigen + +#endif // EIGEN_EIGENBASE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ForceAlignedAccess.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ForceAlignedAccess.h new file mode 100644 index 0000000..817a43a --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ForceAlignedAccess.h @@ -0,0 +1,150 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_FORCEALIGNEDACCESS_H +#define EIGEN_FORCEALIGNEDACCESS_H + +namespace Eigen { + +/** \class ForceAlignedAccess + * \ingroup Core_Module + * + * \brief Enforce aligned packet loads and stores regardless of what is requested + * + * \param ExpressionType the type of the object of which we are forcing aligned packet access + * + * This class is the return type of MatrixBase::forceAlignedAccess() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::forceAlignedAccess() + */ + +namespace internal { +template +struct traits > : public traits +{}; +} + +template class ForceAlignedAccess + : public internal::dense_xpr_base< ForceAlignedAccess >::type +{ + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ForceAlignedAccess) + + EIGEN_DEVICE_FUNC explicit inline ForceAlignedAccess(const ExpressionType& matrix) : m_expression(matrix) {} + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return m_expression.rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return m_expression.cols(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT { return m_expression.outerStride(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT { return m_expression.innerStride(); } + + EIGEN_DEVICE_FUNC inline const CoeffReturnType coeff(Index row, Index col) const + { + return m_expression.coeff(row, col); + } + + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index row, Index col) + { + return m_expression.const_cast_derived().coeffRef(row, col); + } + + EIGEN_DEVICE_FUNC inline const CoeffReturnType coeff(Index index) const + { + return m_expression.coeff(index); + } + + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index index) + { + return m_expression.const_cast_derived().coeffRef(index); + } + + template + inline const PacketScalar packet(Index row, Index col) const + { + return m_expression.template packet(row, col); + } + + template + inline void writePacket(Index row, Index col, const PacketScalar& x) + { + m_expression.const_cast_derived().template writePacket(row, col, x); + } + + template + inline const PacketScalar packet(Index index) const + { + return m_expression.template packet(index); + } + + template + inline void writePacket(Index index, const PacketScalar& x) + { + m_expression.const_cast_derived().template writePacket(index, x); + } + + EIGEN_DEVICE_FUNC operator const ExpressionType&() const { return m_expression; } + + protected: + const ExpressionType& m_expression; + + private: + ForceAlignedAccess& operator=(const ForceAlignedAccess&); +}; + +/** \returns an expression of *this with forced aligned access + * \sa forceAlignedAccessIf(),class ForceAlignedAccess + */ +template +inline const ForceAlignedAccess +MatrixBase::forceAlignedAccess() const +{ + return ForceAlignedAccess(derived()); +} + +/** \returns an expression of *this with forced aligned access + * \sa forceAlignedAccessIf(), class ForceAlignedAccess + */ +template +inline ForceAlignedAccess +MatrixBase::forceAlignedAccess() +{ + return ForceAlignedAccess(derived()); +} + +/** \returns an expression of *this with forced aligned access if \a Enable is true. + * \sa forceAlignedAccess(), class ForceAlignedAccess + */ +template +template +inline typename internal::add_const_on_value_type,Derived&>::type>::type +MatrixBase::forceAlignedAccessIf() const +{ + return derived(); // FIXME This should not work but apparently is never used +} + +/** \returns an expression of *this with forced aligned access if \a Enable is true. + * \sa forceAlignedAccess(), class ForceAlignedAccess + */ +template +template +inline typename internal::conditional,Derived&>::type +MatrixBase::forceAlignedAccessIf() +{ + return derived(); // FIXME This should not work but apparently is never used +} + +} // end namespace Eigen + +#endif // EIGEN_FORCEALIGNEDACCESS_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Fuzzy.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Fuzzy.h new file mode 100644 index 0000000..43aa49b --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Fuzzy.h @@ -0,0 +1,155 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_FUZZY_H +#define EIGEN_FUZZY_H + +namespace Eigen { + +namespace internal +{ + +template::IsInteger> +struct isApprox_selector +{ + EIGEN_DEVICE_FUNC + static bool run(const Derived& x, const OtherDerived& y, const typename Derived::RealScalar& prec) + { + typename internal::nested_eval::type nested(x); + typename internal::nested_eval::type otherNested(y); + return (nested - otherNested).cwiseAbs2().sum() <= prec * prec * numext::mini(nested.cwiseAbs2().sum(), otherNested.cwiseAbs2().sum()); + } +}; + +template +struct isApprox_selector +{ + EIGEN_DEVICE_FUNC + static bool run(const Derived& x, const OtherDerived& y, const typename Derived::RealScalar&) + { + return x.matrix() == y.matrix(); + } +}; + +template::IsInteger> +struct isMuchSmallerThan_object_selector +{ + EIGEN_DEVICE_FUNC + static bool run(const Derived& x, const OtherDerived& y, const typename Derived::RealScalar& prec) + { + return x.cwiseAbs2().sum() <= numext::abs2(prec) * y.cwiseAbs2().sum(); + } +}; + +template +struct isMuchSmallerThan_object_selector +{ + EIGEN_DEVICE_FUNC + static bool run(const Derived& x, const OtherDerived&, const typename Derived::RealScalar&) + { + return x.matrix() == Derived::Zero(x.rows(), x.cols()).matrix(); + } +}; + +template::IsInteger> +struct isMuchSmallerThan_scalar_selector +{ + EIGEN_DEVICE_FUNC + static bool run(const Derived& x, const typename Derived::RealScalar& y, const typename Derived::RealScalar& prec) + { + return x.cwiseAbs2().sum() <= numext::abs2(prec * y); + } +}; + +template +struct isMuchSmallerThan_scalar_selector +{ + EIGEN_DEVICE_FUNC + static bool run(const Derived& x, const typename Derived::RealScalar&, const typename Derived::RealScalar&) + { + return x.matrix() == Derived::Zero(x.rows(), x.cols()).matrix(); + } +}; + +} // end namespace internal + + +/** \returns \c true if \c *this is approximately equal to \a other, within the precision + * determined by \a prec. + * + * \note The fuzzy compares are done multiplicatively. Two vectors \f$ v \f$ and \f$ w \f$ + * are considered to be approximately equal within precision \f$ p \f$ if + * \f[ \Vert v - w \Vert \leqslant p\,\min(\Vert v\Vert, \Vert w\Vert). \f] + * For matrices, the comparison is done using the Hilbert-Schmidt norm (aka Frobenius norm + * L2 norm). + * + * \note Because of the multiplicativeness of this comparison, one can't use this function + * to check whether \c *this is approximately equal to the zero matrix or vector. + * Indeed, \c isApprox(zero) returns false unless \c *this itself is exactly the zero matrix + * or vector. If you want to test whether \c *this is zero, use internal::isMuchSmallerThan(const + * RealScalar&, RealScalar) instead. + * + * \sa internal::isMuchSmallerThan(const RealScalar&, RealScalar) const + */ +template +template +EIGEN_DEVICE_FUNC bool DenseBase::isApprox( + const DenseBase& other, + const RealScalar& prec +) const +{ + return internal::isApprox_selector::run(derived(), other.derived(), prec); +} + +/** \returns \c true if the norm of \c *this is much smaller than \a other, + * within the precision determined by \a prec. + * + * \note The fuzzy compares are done multiplicatively. A vector \f$ v \f$ is + * considered to be much smaller than \f$ x \f$ within precision \f$ p \f$ if + * \f[ \Vert v \Vert \leqslant p\,\vert x\vert. \f] + * + * For matrices, the comparison is done using the Hilbert-Schmidt norm. For this reason, + * the value of the reference scalar \a other should come from the Hilbert-Schmidt norm + * of a reference matrix of same dimensions. + * + * \sa isApprox(), isMuchSmallerThan(const DenseBase&, RealScalar) const + */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isMuchSmallerThan( + const typename NumTraits::Real& other, + const RealScalar& prec +) const +{ + return internal::isMuchSmallerThan_scalar_selector::run(derived(), other, prec); +} + +/** \returns \c true if the norm of \c *this is much smaller than the norm of \a other, + * within the precision determined by \a prec. + * + * \note The fuzzy compares are done multiplicatively. A vector \f$ v \f$ is + * considered to be much smaller than a vector \f$ w \f$ within precision \f$ p \f$ if + * \f[ \Vert v \Vert \leqslant p\,\Vert w\Vert. \f] + * For matrices, the comparison is done using the Hilbert-Schmidt norm. + * + * \sa isApprox(), isMuchSmallerThan(const RealScalar&, RealScalar) const + */ +template +template +EIGEN_DEVICE_FUNC bool DenseBase::isMuchSmallerThan( + const DenseBase& other, + const RealScalar& prec +) const +{ + return internal::isMuchSmallerThan_object_selector::run(derived(), other.derived(), prec); +} + +} // end namespace Eigen + +#endif // EIGEN_FUZZY_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/GeneralProduct.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/GeneralProduct.h new file mode 100644 index 0000000..6906aa7 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/GeneralProduct.h @@ -0,0 +1,465 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2008-2011 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_GENERAL_PRODUCT_H +#define EIGEN_GENERAL_PRODUCT_H + +namespace Eigen { + +enum { + Large = 2, + Small = 3 +}; + +// Define the threshold value to fallback from the generic matrix-matrix product +// implementation (heavy) to the lightweight coeff-based product one. +// See generic_product_impl +// in products/GeneralMatrixMatrix.h for more details. +// TODO This threshold should also be used in the compile-time selector below. +#ifndef EIGEN_GEMM_TO_COEFFBASED_THRESHOLD +// This default value has been obtained on a Haswell architecture. +#define EIGEN_GEMM_TO_COEFFBASED_THRESHOLD 20 +#endif + +namespace internal { + +template struct product_type_selector; + +template struct product_size_category +{ + enum { + #ifndef EIGEN_GPU_COMPILE_PHASE + is_large = MaxSize == Dynamic || + Size >= EIGEN_CACHEFRIENDLY_PRODUCT_THRESHOLD || + (Size==Dynamic && MaxSize>=EIGEN_CACHEFRIENDLY_PRODUCT_THRESHOLD), + #else + is_large = 0, + #endif + value = is_large ? Large + : Size == 1 ? 1 + : Small + }; +}; + +template struct product_type +{ + typedef typename remove_all::type _Lhs; + typedef typename remove_all::type _Rhs; + enum { + MaxRows = traits<_Lhs>::MaxRowsAtCompileTime, + Rows = traits<_Lhs>::RowsAtCompileTime, + MaxCols = traits<_Rhs>::MaxColsAtCompileTime, + Cols = traits<_Rhs>::ColsAtCompileTime, + MaxDepth = EIGEN_SIZE_MIN_PREFER_FIXED(traits<_Lhs>::MaxColsAtCompileTime, + traits<_Rhs>::MaxRowsAtCompileTime), + Depth = EIGEN_SIZE_MIN_PREFER_FIXED(traits<_Lhs>::ColsAtCompileTime, + traits<_Rhs>::RowsAtCompileTime) + }; + + // the splitting into different lines of code here, introducing the _select enums and the typedef below, + // is to work around an internal compiler error with gcc 4.1 and 4.2. +private: + enum { + rows_select = product_size_category::value, + cols_select = product_size_category::value, + depth_select = product_size_category::value + }; + typedef product_type_selector selector; + +public: + enum { + value = selector::ret, + ret = selector::ret + }; +#ifdef EIGEN_DEBUG_PRODUCT + static void debug() + { + EIGEN_DEBUG_VAR(Rows); + EIGEN_DEBUG_VAR(Cols); + EIGEN_DEBUG_VAR(Depth); + EIGEN_DEBUG_VAR(rows_select); + EIGEN_DEBUG_VAR(cols_select); + EIGEN_DEBUG_VAR(depth_select); + EIGEN_DEBUG_VAR(value); + } +#endif +}; + +/* The following allows to select the kind of product at compile time + * based on the three dimensions of the product. + * This is a compile time mapping from {1,Small,Large}^3 -> {product types} */ +// FIXME I'm not sure the current mapping is the ideal one. +template struct product_type_selector { enum { ret = OuterProduct }; }; +template struct product_type_selector { enum { ret = LazyCoeffBasedProductMode }; }; +template struct product_type_selector<1, N, 1> { enum { ret = LazyCoeffBasedProductMode }; }; +template struct product_type_selector<1, 1, Depth> { enum { ret = InnerProduct }; }; +template<> struct product_type_selector<1, 1, 1> { enum { ret = InnerProduct }; }; +template<> struct product_type_selector { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector<1, Small,Small> { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = LazyCoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = LazyCoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = LazyCoeffBasedProductMode }; }; +template<> struct product_type_selector<1, Large,Small> { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector<1, Large,Large> { enum { ret = GemvProduct }; }; +template<> struct product_type_selector<1, Small,Large> { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = GemvProduct }; }; +template<> struct product_type_selector { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = GemmProduct }; }; +template<> struct product_type_selector { enum { ret = GemmProduct }; }; +template<> struct product_type_selector { enum { ret = GemmProduct }; }; +template<> struct product_type_selector { enum { ret = GemmProduct }; }; +template<> struct product_type_selector { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = GemmProduct }; }; + +} // end namespace internal + +/*********************************************************************** +* Implementation of Inner Vector Vector Product +***********************************************************************/ + +// FIXME : maybe the "inner product" could return a Scalar +// instead of a 1x1 matrix ?? +// Pro: more natural for the user +// Cons: this could be a problem if in a meta unrolled algorithm a matrix-matrix +// product ends up to a row-vector times col-vector product... To tackle this use +// case, we could have a specialization for Block with: operator=(Scalar x); + +/*********************************************************************** +* Implementation of Outer Vector Vector Product +***********************************************************************/ + +/*********************************************************************** +* Implementation of General Matrix Vector Product +***********************************************************************/ + +/* According to the shape/flags of the matrix we have to distinghish 3 different cases: + * 1 - the matrix is col-major, BLAS compatible and M is large => call fast BLAS-like colmajor routine + * 2 - the matrix is row-major, BLAS compatible and N is large => call fast BLAS-like rowmajor routine + * 3 - all other cases are handled using a simple loop along the outer-storage direction. + * Therefore we need a lower level meta selector. + * Furthermore, if the matrix is the rhs, then the product has to be transposed. + */ +namespace internal { + +template +struct gemv_dense_selector; + +} // end namespace internal + +namespace internal { + +template struct gemv_static_vector_if; + +template +struct gemv_static_vector_if +{ + EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC Scalar* data() { eigen_internal_assert(false && "should never be called"); return 0; } +}; + +template +struct gemv_static_vector_if +{ + EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC Scalar* data() { return 0; } +}; + +template +struct gemv_static_vector_if +{ + enum { + ForceAlignment = internal::packet_traits::Vectorizable, + PacketSize = internal::packet_traits::size + }; + #if EIGEN_MAX_STATIC_ALIGN_BYTES!=0 + internal::plain_array m_data; + EIGEN_STRONG_INLINE Scalar* data() { return m_data.array; } + #else + // Some architectures cannot align on the stack, + // => let's manually enforce alignment by allocating more data and return the address of the first aligned element. + internal::plain_array m_data; + EIGEN_STRONG_INLINE Scalar* data() { + return ForceAlignment + ? reinterpret_cast((internal::UIntPtr(m_data.array) & ~(std::size_t(EIGEN_MAX_ALIGN_BYTES-1))) + EIGEN_MAX_ALIGN_BYTES) + : m_data.array; + } + #endif +}; + +// The vector is on the left => transposition +template +struct gemv_dense_selector +{ + template + static void run(const Lhs &lhs, const Rhs &rhs, Dest& dest, const typename Dest::Scalar& alpha) + { + Transpose destT(dest); + enum { OtherStorageOrder = StorageOrder == RowMajor ? ColMajor : RowMajor }; + gemv_dense_selector + ::run(rhs.transpose(), lhs.transpose(), destT, alpha); + } +}; + +template<> struct gemv_dense_selector +{ + template + static inline void run(const Lhs &lhs, const Rhs &rhs, Dest& dest, const typename Dest::Scalar& alpha) + { + typedef typename Lhs::Scalar LhsScalar; + typedef typename Rhs::Scalar RhsScalar; + typedef typename Dest::Scalar ResScalar; + typedef typename Dest::RealScalar RealScalar; + + typedef internal::blas_traits LhsBlasTraits; + typedef typename LhsBlasTraits::DirectLinearAccessType ActualLhsType; + typedef internal::blas_traits RhsBlasTraits; + typedef typename RhsBlasTraits::DirectLinearAccessType ActualRhsType; + + typedef Map, EIGEN_PLAIN_ENUM_MIN(AlignedMax,internal::packet_traits::size)> MappedDest; + + ActualLhsType actualLhs = LhsBlasTraits::extract(lhs); + ActualRhsType actualRhs = RhsBlasTraits::extract(rhs); + + ResScalar actualAlpha = combine_scalar_factors(alpha, lhs, rhs); + + // make sure Dest is a compile-time vector type (bug 1166) + typedef typename conditional::type ActualDest; + + enum { + // FIXME find a way to allow an inner stride on the result if packet_traits::size==1 + // on, the other hand it is good for the cache to pack the vector anyways... + EvalToDestAtCompileTime = (ActualDest::InnerStrideAtCompileTime==1), + ComplexByReal = (NumTraits::IsComplex) && (!NumTraits::IsComplex), + MightCannotUseDest = ((!EvalToDestAtCompileTime) || ComplexByReal) && (ActualDest::MaxSizeAtCompileTime!=0) + }; + + typedef const_blas_data_mapper LhsMapper; + typedef const_blas_data_mapper RhsMapper; + RhsScalar compatibleAlpha = get_factor::run(actualAlpha); + + if(!MightCannotUseDest) + { + // shortcut if we are sure to be able to use dest directly, + // this ease the compiler to generate cleaner and more optimzized code for most common cases + general_matrix_vector_product + ::run( + actualLhs.rows(), actualLhs.cols(), + LhsMapper(actualLhs.data(), actualLhs.outerStride()), + RhsMapper(actualRhs.data(), actualRhs.innerStride()), + dest.data(), 1, + compatibleAlpha); + } + else + { + gemv_static_vector_if static_dest; + + const bool alphaIsCompatible = (!ComplexByReal) || (numext::imag(actualAlpha)==RealScalar(0)); + const bool evalToDest = EvalToDestAtCompileTime && alphaIsCompatible; + + ei_declare_aligned_stack_constructed_variable(ResScalar,actualDestPtr,dest.size(), + evalToDest ? dest.data() : static_dest.data()); + + if(!evalToDest) + { + #ifdef EIGEN_DENSE_STORAGE_CTOR_PLUGIN + Index size = dest.size(); + EIGEN_DENSE_STORAGE_CTOR_PLUGIN + #endif + if(!alphaIsCompatible) + { + MappedDest(actualDestPtr, dest.size()).setZero(); + compatibleAlpha = RhsScalar(1); + } + else + MappedDest(actualDestPtr, dest.size()) = dest; + } + + general_matrix_vector_product + ::run( + actualLhs.rows(), actualLhs.cols(), + LhsMapper(actualLhs.data(), actualLhs.outerStride()), + RhsMapper(actualRhs.data(), actualRhs.innerStride()), + actualDestPtr, 1, + compatibleAlpha); + + if (!evalToDest) + { + if(!alphaIsCompatible) + dest.matrix() += actualAlpha * MappedDest(actualDestPtr, dest.size()); + else + dest = MappedDest(actualDestPtr, dest.size()); + } + } + } +}; + +template<> struct gemv_dense_selector +{ + template + static void run(const Lhs &lhs, const Rhs &rhs, Dest& dest, const typename Dest::Scalar& alpha) + { + typedef typename Lhs::Scalar LhsScalar; + typedef typename Rhs::Scalar RhsScalar; + typedef typename Dest::Scalar ResScalar; + + typedef internal::blas_traits LhsBlasTraits; + typedef typename LhsBlasTraits::DirectLinearAccessType ActualLhsType; + typedef internal::blas_traits RhsBlasTraits; + typedef typename RhsBlasTraits::DirectLinearAccessType ActualRhsType; + typedef typename internal::remove_all::type ActualRhsTypeCleaned; + + typename add_const::type actualLhs = LhsBlasTraits::extract(lhs); + typename add_const::type actualRhs = RhsBlasTraits::extract(rhs); + + ResScalar actualAlpha = combine_scalar_factors(alpha, lhs, rhs); + + enum { + // FIXME find a way to allow an inner stride on the result if packet_traits::size==1 + // on, the other hand it is good for the cache to pack the vector anyways... + DirectlyUseRhs = ActualRhsTypeCleaned::InnerStrideAtCompileTime==1 || ActualRhsTypeCleaned::MaxSizeAtCompileTime==0 + }; + + gemv_static_vector_if static_rhs; + + ei_declare_aligned_stack_constructed_variable(RhsScalar,actualRhsPtr,actualRhs.size(), + DirectlyUseRhs ? const_cast(actualRhs.data()) : static_rhs.data()); + + if(!DirectlyUseRhs) + { + #ifdef EIGEN_DENSE_STORAGE_CTOR_PLUGIN + Index size = actualRhs.size(); + EIGEN_DENSE_STORAGE_CTOR_PLUGIN + #endif + Map(actualRhsPtr, actualRhs.size()) = actualRhs; + } + + typedef const_blas_data_mapper LhsMapper; + typedef const_blas_data_mapper RhsMapper; + general_matrix_vector_product + ::run( + actualLhs.rows(), actualLhs.cols(), + LhsMapper(actualLhs.data(), actualLhs.outerStride()), + RhsMapper(actualRhsPtr, 1), + dest.data(), dest.col(0).innerStride(), //NOTE if dest is not a vector at compile-time, then dest.innerStride() might be wrong. (bug 1166) + actualAlpha); + } +}; + +template<> struct gemv_dense_selector +{ + template + static void run(const Lhs &lhs, const Rhs &rhs, Dest& dest, const typename Dest::Scalar& alpha) + { + EIGEN_STATIC_ASSERT((!nested_eval::Evaluate),EIGEN_INTERNAL_COMPILATION_ERROR_OR_YOU_MADE_A_PROGRAMMING_MISTAKE); + // TODO if rhs is large enough it might be beneficial to make sure that dest is sequentially stored in memory, otherwise use a temp + typename nested_eval::type actual_rhs(rhs); + const Index size = rhs.rows(); + for(Index k=0; k struct gemv_dense_selector +{ + template + static void run(const Lhs &lhs, const Rhs &rhs, Dest& dest, const typename Dest::Scalar& alpha) + { + EIGEN_STATIC_ASSERT((!nested_eval::Evaluate),EIGEN_INTERNAL_COMPILATION_ERROR_OR_YOU_MADE_A_PROGRAMMING_MISTAKE); + typename nested_eval::type actual_rhs(rhs); + const Index rows = dest.rows(); + for(Index i=0; i +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +const Product +MatrixBase::operator*(const MatrixBase &other) const +{ + // A note regarding the function declaration: In MSVC, this function will sometimes + // not be inlined since DenseStorage is an unwindable object for dynamic + // matrices and product types are holding a member to store the result. + // Thus it does not help tagging this function with EIGEN_STRONG_INLINE. + enum { + ProductIsValid = Derived::ColsAtCompileTime==Dynamic + || OtherDerived::RowsAtCompileTime==Dynamic + || int(Derived::ColsAtCompileTime)==int(OtherDerived::RowsAtCompileTime), + AreVectors = Derived::IsVectorAtCompileTime && OtherDerived::IsVectorAtCompileTime, + SameSizes = EIGEN_PREDICATE_SAME_MATRIX_SIZE(Derived,OtherDerived) + }; + // note to the lost user: + // * for a dot product use: v1.dot(v2) + // * for a coeff-wise product use: v1.cwiseProduct(v2) + EIGEN_STATIC_ASSERT(ProductIsValid || !(AreVectors && SameSizes), + INVALID_VECTOR_VECTOR_PRODUCT__IF_YOU_WANTED_A_DOT_OR_COEFF_WISE_PRODUCT_YOU_MUST_USE_THE_EXPLICIT_FUNCTIONS) + EIGEN_STATIC_ASSERT(ProductIsValid || !(SameSizes && !AreVectors), + INVALID_MATRIX_PRODUCT__IF_YOU_WANTED_A_COEFF_WISE_PRODUCT_YOU_MUST_USE_THE_EXPLICIT_FUNCTION) + EIGEN_STATIC_ASSERT(ProductIsValid || SameSizes, INVALID_MATRIX_PRODUCT) +#ifdef EIGEN_DEBUG_PRODUCT + internal::product_type::debug(); +#endif + + return Product(derived(), other.derived()); +} + +/** \returns an expression of the matrix product of \c *this and \a other without implicit evaluation. + * + * The returned product will behave like any other expressions: the coefficients of the product will be + * computed once at a time as requested. This might be useful in some extremely rare cases when only + * a small and no coherent fraction of the result's coefficients have to be computed. + * + * \warning This version of the matrix product can be much much slower. So use it only if you know + * what you are doing and that you measured a true speed improvement. + * + * \sa operator*(const MatrixBase&) + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +const Product +MatrixBase::lazyProduct(const MatrixBase &other) const +{ + enum { + ProductIsValid = Derived::ColsAtCompileTime==Dynamic + || OtherDerived::RowsAtCompileTime==Dynamic + || int(Derived::ColsAtCompileTime)==int(OtherDerived::RowsAtCompileTime), + AreVectors = Derived::IsVectorAtCompileTime && OtherDerived::IsVectorAtCompileTime, + SameSizes = EIGEN_PREDICATE_SAME_MATRIX_SIZE(Derived,OtherDerived) + }; + // note to the lost user: + // * for a dot product use: v1.dot(v2) + // * for a coeff-wise product use: v1.cwiseProduct(v2) + EIGEN_STATIC_ASSERT(ProductIsValid || !(AreVectors && SameSizes), + INVALID_VECTOR_VECTOR_PRODUCT__IF_YOU_WANTED_A_DOT_OR_COEFF_WISE_PRODUCT_YOU_MUST_USE_THE_EXPLICIT_FUNCTIONS) + EIGEN_STATIC_ASSERT(ProductIsValid || !(SameSizes && !AreVectors), + INVALID_MATRIX_PRODUCT__IF_YOU_WANTED_A_COEFF_WISE_PRODUCT_YOU_MUST_USE_THE_EXPLICIT_FUNCTION) + EIGEN_STATIC_ASSERT(ProductIsValid || SameSizes, INVALID_MATRIX_PRODUCT) + + return Product(derived(), other.derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_PRODUCT_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/GenericPacketMath.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/GenericPacketMath.h new file mode 100644 index 0000000..cf677a1 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/GenericPacketMath.h @@ -0,0 +1,1040 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_GENERIC_PACKET_MATH_H +#define EIGEN_GENERIC_PACKET_MATH_H + +namespace Eigen { + +namespace internal { + +/** \internal + * \file GenericPacketMath.h + * + * Default implementation for types not supported by the vectorization. + * In practice these functions are provided to make easier the writing + * of generic vectorized code. + */ + +#ifndef EIGEN_DEBUG_ALIGNED_LOAD +#define EIGEN_DEBUG_ALIGNED_LOAD +#endif + +#ifndef EIGEN_DEBUG_UNALIGNED_LOAD +#define EIGEN_DEBUG_UNALIGNED_LOAD +#endif + +#ifndef EIGEN_DEBUG_ALIGNED_STORE +#define EIGEN_DEBUG_ALIGNED_STORE +#endif + +#ifndef EIGEN_DEBUG_UNALIGNED_STORE +#define EIGEN_DEBUG_UNALIGNED_STORE +#endif + +struct default_packet_traits +{ + enum { + HasHalfPacket = 0, + + HasAdd = 1, + HasSub = 1, + HasShift = 1, + HasMul = 1, + HasNegate = 1, + HasAbs = 1, + HasArg = 0, + HasAbs2 = 1, + HasAbsDiff = 0, + HasMin = 1, + HasMax = 1, + HasConj = 1, + HasSetLinear = 1, + HasBlend = 0, + // This flag is used to indicate whether packet comparison is supported. + // pcmp_eq, pcmp_lt and pcmp_le should be defined for it to be true. + HasCmp = 0, + + HasDiv = 0, + HasSqrt = 0, + HasRsqrt = 0, + HasExp = 0, + HasExpm1 = 0, + HasLog = 0, + HasLog1p = 0, + HasLog10 = 0, + HasPow = 0, + + HasSin = 0, + HasCos = 0, + HasTan = 0, + HasASin = 0, + HasACos = 0, + HasATan = 0, + HasSinh = 0, + HasCosh = 0, + HasTanh = 0, + HasLGamma = 0, + HasDiGamma = 0, + HasZeta = 0, + HasPolygamma = 0, + HasErf = 0, + HasErfc = 0, + HasNdtri = 0, + HasBessel = 0, + HasIGamma = 0, + HasIGammaDerA = 0, + HasGammaSampleDerAlpha = 0, + HasIGammac = 0, + HasBetaInc = 0, + + HasRound = 0, + HasRint = 0, + HasFloor = 0, + HasCeil = 0, + HasSign = 0 + }; +}; + +template struct packet_traits : default_packet_traits +{ + typedef T type; + typedef T half; + enum { + Vectorizable = 0, + size = 1, + AlignedOnScalar = 0, + HasHalfPacket = 0 + }; + enum { + HasAdd = 0, + HasSub = 0, + HasMul = 0, + HasNegate = 0, + HasAbs = 0, + HasAbs2 = 0, + HasMin = 0, + HasMax = 0, + HasConj = 0, + HasSetLinear = 0 + }; +}; + +template struct packet_traits : packet_traits { }; + +template struct unpacket_traits +{ + typedef T type; + typedef T half; + enum + { + size = 1, + alignment = 1, + vectorizable = false, + masked_load_available=false, + masked_store_available=false + }; +}; + +template struct unpacket_traits : unpacket_traits { }; + +template struct type_casting_traits { + enum { + VectorizedCast = 0, + SrcCoeffRatio = 1, + TgtCoeffRatio = 1 + }; +}; + +/** \internal Wrapper to ensure that multiple packet types can map to the same + same underlying vector type. */ +template +struct eigen_packet_wrapper +{ + EIGEN_ALWAYS_INLINE operator T&() { return m_val; } + EIGEN_ALWAYS_INLINE operator const T&() const { return m_val; } + EIGEN_ALWAYS_INLINE eigen_packet_wrapper() {} + EIGEN_ALWAYS_INLINE eigen_packet_wrapper(const T &v) : m_val(v) {} + EIGEN_ALWAYS_INLINE eigen_packet_wrapper& operator=(const T &v) { + m_val = v; + return *this; + } + + T m_val; +}; + + +/** \internal A convenience utility for determining if the type is a scalar. + * This is used to enable some generic packet implementations. + */ +template +struct is_scalar { + typedef typename unpacket_traits::type Scalar; + enum { + value = internal::is_same::value + }; +}; + +/** \internal \returns static_cast(a) (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline TgtPacket +pcast(const SrcPacket& a) { + return static_cast(a); +} +template +EIGEN_DEVICE_FUNC inline TgtPacket +pcast(const SrcPacket& a, const SrcPacket& /*b*/) { + return static_cast(a); +} +template +EIGEN_DEVICE_FUNC inline TgtPacket +pcast(const SrcPacket& a, const SrcPacket& /*b*/, const SrcPacket& /*c*/, const SrcPacket& /*d*/) { + return static_cast(a); +} +template +EIGEN_DEVICE_FUNC inline TgtPacket +pcast(const SrcPacket& a, const SrcPacket& /*b*/, const SrcPacket& /*c*/, const SrcPacket& /*d*/, + const SrcPacket& /*e*/, const SrcPacket& /*f*/, const SrcPacket& /*g*/, const SrcPacket& /*h*/) { + return static_cast(a); +} + +/** \internal \returns reinterpret_cast(a) */ +template +EIGEN_DEVICE_FUNC inline Target +preinterpret(const Packet& a); /* { return reinterpret_cast(a); } */ + +/** \internal \returns a + b (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +padd(const Packet& a, const Packet& b) { return a+b; } +// Avoid compiler warning for boolean algebra. +template<> EIGEN_DEVICE_FUNC inline bool +padd(const bool& a, const bool& b) { return a || b; } + +/** \internal \returns a - b (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +psub(const Packet& a, const Packet& b) { return a-b; } + +/** \internal \returns -a (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +pnegate(const Packet& a) { return -a; } + +template<> EIGEN_DEVICE_FUNC inline bool +pnegate(const bool& a) { return !a; } + +/** \internal \returns conj(a) (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +pconj(const Packet& a) { return numext::conj(a); } + +/** \internal \returns a * b (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +pmul(const Packet& a, const Packet& b) { return a*b; } +// Avoid compiler warning for boolean algebra. +template<> EIGEN_DEVICE_FUNC inline bool +pmul(const bool& a, const bool& b) { return a && b; } + +/** \internal \returns a / b (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +pdiv(const Packet& a, const Packet& b) { return a/b; } + +// In the generic case, memset to all one bits. +template +struct ptrue_impl { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& /*a*/){ + Packet b; + memset(static_cast(&b), 0xff, sizeof(Packet)); + return b; + } +}; + +// For non-trivial scalars, set to Scalar(1) (i.e. a non-zero value). +// Although this is technically not a valid bitmask, the scalar path for pselect +// uses a comparison to zero, so this should still work in most cases. We don't +// have another option, since the scalar type requires initialization. +template +struct ptrue_impl::value && NumTraits::RequireInitialization>::type > { + static EIGEN_DEVICE_FUNC inline T run(const T& /*a*/){ + return T(1); + } +}; + +/** \internal \returns one bits. */ +template EIGEN_DEVICE_FUNC inline Packet +ptrue(const Packet& a) { + return ptrue_impl::run(a); +} + +// In the general case, memset to zero. +template +struct pzero_impl { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& /*a*/) { + Packet b; + memset(static_cast(&b), 0x00, sizeof(Packet)); + return b; + } +}; + +// For scalars, explicitly set to Scalar(0), since the underlying representation +// for zero may not consist of all-zero bits. +template +struct pzero_impl::value>::type> { + static EIGEN_DEVICE_FUNC inline T run(const T& /*a*/) { + return T(0); + } +}; + +/** \internal \returns packet of zeros */ +template EIGEN_DEVICE_FUNC inline Packet +pzero(const Packet& a) { + return pzero_impl::run(a); +} + +/** \internal \returns a <= b as a bit mask */ +template EIGEN_DEVICE_FUNC inline Packet +pcmp_le(const Packet& a, const Packet& b) { return a<=b ? ptrue(a) : pzero(a); } + +/** \internal \returns a < b as a bit mask */ +template EIGEN_DEVICE_FUNC inline Packet +pcmp_lt(const Packet& a, const Packet& b) { return a EIGEN_DEVICE_FUNC inline Packet +pcmp_eq(const Packet& a, const Packet& b) { return a==b ? ptrue(a) : pzero(a); } + +/** \internal \returns a < b or a==NaN or b==NaN as a bit mask */ +template EIGEN_DEVICE_FUNC inline Packet +pcmp_lt_or_nan(const Packet& a, const Packet& b) { return a>=b ? pzero(a) : ptrue(a); } + +template +struct bit_and { + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR EIGEN_ALWAYS_INLINE T operator()(const T& a, const T& b) const { + return a & b; + } +}; + +template +struct bit_or { + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR EIGEN_ALWAYS_INLINE T operator()(const T& a, const T& b) const { + return a | b; + } +}; + +template +struct bit_xor { + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR EIGEN_ALWAYS_INLINE T operator()(const T& a, const T& b) const { + return a ^ b; + } +}; + +template +struct bit_not { + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR EIGEN_ALWAYS_INLINE T operator()(const T& a) const { + return ~a; + } +}; + +// Use operators &, |, ^, ~. +template +struct operator_bitwise_helper { + EIGEN_DEVICE_FUNC static inline T bitwise_and(const T& a, const T& b) { return bit_and()(a, b); } + EIGEN_DEVICE_FUNC static inline T bitwise_or(const T& a, const T& b) { return bit_or()(a, b); } + EIGEN_DEVICE_FUNC static inline T bitwise_xor(const T& a, const T& b) { return bit_xor()(a, b); } + EIGEN_DEVICE_FUNC static inline T bitwise_not(const T& a) { return bit_not()(a); } +}; + +// Apply binary operations byte-by-byte +template +struct bytewise_bitwise_helper { + EIGEN_DEVICE_FUNC static inline T bitwise_and(const T& a, const T& b) { + return binary(a, b, bit_and()); + } + EIGEN_DEVICE_FUNC static inline T bitwise_or(const T& a, const T& b) { + return binary(a, b, bit_or()); + } + EIGEN_DEVICE_FUNC static inline T bitwise_xor(const T& a, const T& b) { + return binary(a, b, bit_xor()); + } + EIGEN_DEVICE_FUNC static inline T bitwise_not(const T& a) { + return unary(a,bit_not()); + } + + private: + template + EIGEN_DEVICE_FUNC static inline T unary(const T& a, Op op) { + const unsigned char* a_ptr = reinterpret_cast(&a); + T c; + unsigned char* c_ptr = reinterpret_cast(&c); + for (size_t i = 0; i < sizeof(T); ++i) { + *c_ptr++ = op(*a_ptr++); + } + return c; + } + + template + EIGEN_DEVICE_FUNC static inline T binary(const T& a, const T& b, Op op) { + const unsigned char* a_ptr = reinterpret_cast(&a); + const unsigned char* b_ptr = reinterpret_cast(&b); + T c; + unsigned char* c_ptr = reinterpret_cast(&c); + for (size_t i = 0; i < sizeof(T); ++i) { + *c_ptr++ = op(*a_ptr++, *b_ptr++); + } + return c; + } +}; + +// In the general case, use byte-by-byte manipulation. +template +struct bitwise_helper : public bytewise_bitwise_helper {}; + +// For integers or non-trivial scalars, use binary operators. +template +struct bitwise_helper::value && (NumTraits::IsInteger || NumTraits::RequireInitialization)>::type + > : public operator_bitwise_helper {}; + +/** \internal \returns the bitwise and of \a a and \a b */ +template EIGEN_DEVICE_FUNC inline Packet +pand(const Packet& a, const Packet& b) { + return bitwise_helper::bitwise_and(a, b); +} + +/** \internal \returns the bitwise or of \a a and \a b */ +template EIGEN_DEVICE_FUNC inline Packet +por(const Packet& a, const Packet& b) { + return bitwise_helper::bitwise_or(a, b); +} + +/** \internal \returns the bitwise xor of \a a and \a b */ +template EIGEN_DEVICE_FUNC inline Packet +pxor(const Packet& a, const Packet& b) { + return bitwise_helper::bitwise_xor(a, b); +} + +/** \internal \returns the bitwise not of \a a */ +template EIGEN_DEVICE_FUNC inline Packet +pnot(const Packet& a) { + return bitwise_helper::bitwise_not(a); +} + +/** \internal \returns the bitwise and of \a a and not \a b */ +template EIGEN_DEVICE_FUNC inline Packet +pandnot(const Packet& a, const Packet& b) { return pand(a, pnot(b)); } + +// In the general case, use bitwise select. +template +struct pselect_impl { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& mask, const Packet& a, const Packet& b) { + return por(pand(a,mask),pandnot(b,mask)); + } +}; + +// For scalars, use ternary select. +template +struct pselect_impl::value>::type > { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& mask, const Packet& a, const Packet& b) { + return numext::equal_strict(mask, Packet(0)) ? b : a; + } +}; + +/** \internal \returns \a or \b for each field in packet according to \mask */ +template EIGEN_DEVICE_FUNC inline Packet +pselect(const Packet& mask, const Packet& a, const Packet& b) { + return pselect_impl::run(mask, a, b); +} + +template<> EIGEN_DEVICE_FUNC inline bool pselect( + const bool& cond, const bool& a, const bool& b) { + return cond ? a : b; +} + +/** \internal \returns the min or of \a a and \a b (coeff-wise) + If either \a a or \a b are NaN, the result is implementation defined. */ +template +struct pminmax_impl { + template + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& a, const Packet& b, Op op) { + return op(a,b); + } +}; + +/** \internal \returns the min or max of \a a and \a b (coeff-wise) + If either \a a or \a b are NaN, NaN is returned. */ +template<> +struct pminmax_impl { + template + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& a, const Packet& b, Op op) { + Packet not_nan_mask_a = pcmp_eq(a, a); + Packet not_nan_mask_b = pcmp_eq(b, b); + return pselect(not_nan_mask_a, + pselect(not_nan_mask_b, op(a, b), b), + a); + } +}; + +/** \internal \returns the min or max of \a a and \a b (coeff-wise) + If both \a a and \a b are NaN, NaN is returned. + Equivalent to std::fmin(a, b). */ +template<> +struct pminmax_impl { + template + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& a, const Packet& b, Op op) { + Packet not_nan_mask_a = pcmp_eq(a, a); + Packet not_nan_mask_b = pcmp_eq(b, b); + return pselect(not_nan_mask_a, + pselect(not_nan_mask_b, op(a, b), a), + b); + } +}; + + +#ifndef SYCL_DEVICE_ONLY +#define EIGEN_BINARY_OP_NAN_PROPAGATION(Type, Func) Func +#else +#define EIGEN_BINARY_OP_NAN_PROPAGATION(Type, Func) \ +[](const Type& a, const Type& b) { \ + return Func(a, b);} +#endif + +/** \internal \returns the min of \a a and \a b (coeff-wise). + If \a a or \b b is NaN, the return value is implementation defined. */ +template EIGEN_DEVICE_FUNC inline Packet +pmin(const Packet& a, const Packet& b) { return numext::mini(a,b); } + +/** \internal \returns the min of \a a and \a b (coeff-wise). + NaNPropagation determines the NaN propagation semantics. */ +template +EIGEN_DEVICE_FUNC inline Packet pmin(const Packet& a, const Packet& b) { + return pminmax_impl::run(a, b, EIGEN_BINARY_OP_NAN_PROPAGATION(Packet, (pmin))); +} + +/** \internal \returns the max of \a a and \a b (coeff-wise) + If \a a or \b b is NaN, the return value is implementation defined. */ +template EIGEN_DEVICE_FUNC inline Packet +pmax(const Packet& a, const Packet& b) { return numext::maxi(a, b); } + +/** \internal \returns the max of \a a and \a b (coeff-wise). + NaNPropagation determines the NaN propagation semantics. */ +template +EIGEN_DEVICE_FUNC inline Packet pmax(const Packet& a, const Packet& b) { + return pminmax_impl::run(a, b, EIGEN_BINARY_OP_NAN_PROPAGATION(Packet,(pmax))); +} + +/** \internal \returns the absolute value of \a a */ +template EIGEN_DEVICE_FUNC inline Packet +pabs(const Packet& a) { return numext::abs(a); } +template<> EIGEN_DEVICE_FUNC inline unsigned int +pabs(const unsigned int& a) { return a; } +template<> EIGEN_DEVICE_FUNC inline unsigned long +pabs(const unsigned long& a) { return a; } +template<> EIGEN_DEVICE_FUNC inline unsigned long long +pabs(const unsigned long long& a) { return a; } + +/** \internal \returns the addsub value of \a a,b */ +template EIGEN_DEVICE_FUNC inline Packet +paddsub(const Packet& a, const Packet& b) { + return pselect(peven_mask(a), padd(a, b), psub(a, b)); + } + +/** \internal \returns the phase angle of \a a */ +template EIGEN_DEVICE_FUNC inline Packet +parg(const Packet& a) { using numext::arg; return arg(a); } + + +/** \internal \returns \a a logically shifted by N bits to the right */ +template EIGEN_DEVICE_FUNC inline int +parithmetic_shift_right(const int& a) { return a >> N; } +template EIGEN_DEVICE_FUNC inline long int +parithmetic_shift_right(const long int& a) { return a >> N; } + +/** \internal \returns \a a arithmetically shifted by N bits to the right */ +template EIGEN_DEVICE_FUNC inline int +plogical_shift_right(const int& a) { return static_cast(static_cast(a) >> N); } +template EIGEN_DEVICE_FUNC inline long int +plogical_shift_right(const long int& a) { return static_cast(static_cast(a) >> N); } + +/** \internal \returns \a a shifted by N bits to the left */ +template EIGEN_DEVICE_FUNC inline int +plogical_shift_left(const int& a) { return a << N; } +template EIGEN_DEVICE_FUNC inline long int +plogical_shift_left(const long int& a) { return a << N; } + +/** \internal \returns the significant and exponent of the underlying floating point numbers + * See https://en.cppreference.com/w/cpp/numeric/math/frexp + */ +template +EIGEN_DEVICE_FUNC inline Packet pfrexp(const Packet& a, Packet& exponent) { + int exp; + EIGEN_USING_STD(frexp); + Packet result = static_cast(frexp(a, &exp)); + exponent = static_cast(exp); + return result; +} + +/** \internal \returns a * 2^((int)exponent) + * See https://en.cppreference.com/w/cpp/numeric/math/ldexp + */ +template EIGEN_DEVICE_FUNC inline Packet +pldexp(const Packet &a, const Packet &exponent) { + EIGEN_USING_STD(ldexp) + return static_cast(ldexp(a, static_cast(exponent))); +} + +/** \internal \returns the min of \a a and \a b (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +pabsdiff(const Packet& a, const Packet& b) { return pselect(pcmp_lt(a, b), psub(b, a), psub(a, b)); } + +/** \internal \returns a packet version of \a *from, from must be 16 bytes aligned */ +template EIGEN_DEVICE_FUNC inline Packet +pload(const typename unpacket_traits::type* from) { return *from; } + +/** \internal \returns a packet version of \a *from, (un-aligned load) */ +template EIGEN_DEVICE_FUNC inline Packet +ploadu(const typename unpacket_traits::type* from) { return *from; } + +/** \internal \returns a packet version of \a *from, (un-aligned masked load) + * There is no generic implementation. We only have implementations for specialized + * cases. Generic case should not be called. + */ +template EIGEN_DEVICE_FUNC inline +typename enable_if::masked_load_available, Packet>::type +ploadu(const typename unpacket_traits::type* from, typename unpacket_traits::mask_t umask); + +/** \internal \returns a packet with constant coefficients \a a, e.g.: (a,a,a,a) */ +template EIGEN_DEVICE_FUNC inline Packet +pset1(const typename unpacket_traits::type& a) { return a; } + +/** \internal \returns a packet with constant coefficients set from bits */ +template EIGEN_DEVICE_FUNC inline Packet +pset1frombits(BitsType a); + +/** \internal \returns a packet with constant coefficients \a a[0], e.g.: (a[0],a[0],a[0],a[0]) */ +template EIGEN_DEVICE_FUNC inline Packet +pload1(const typename unpacket_traits::type *a) { return pset1(*a); } + +/** \internal \returns a packet with elements of \a *from duplicated. + * For instance, for a packet of 8 elements, 4 scalars will be read from \a *from and + * duplicated to form: {from[0],from[0],from[1],from[1],from[2],from[2],from[3],from[3]} + * Currently, this function is only used for scalar * complex products. + */ +template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet +ploaddup(const typename unpacket_traits::type* from) { return *from; } + +/** \internal \returns a packet with elements of \a *from quadrupled. + * For instance, for a packet of 8 elements, 2 scalars will be read from \a *from and + * replicated to form: {from[0],from[0],from[0],from[0],from[1],from[1],from[1],from[1]} + * Currently, this function is only used in matrix products. + * For packet-size smaller or equal to 4, this function is equivalent to pload1 + */ +template EIGEN_DEVICE_FUNC inline Packet +ploadquad(const typename unpacket_traits::type* from) +{ return pload1(from); } + +/** \internal equivalent to + * \code + * a0 = pload1(a+0); + * a1 = pload1(a+1); + * a2 = pload1(a+2); + * a3 = pload1(a+3); + * \endcode + * \sa pset1, pload1, ploaddup, pbroadcast2 + */ +template EIGEN_DEVICE_FUNC +inline void pbroadcast4(const typename unpacket_traits::type *a, + Packet& a0, Packet& a1, Packet& a2, Packet& a3) +{ + a0 = pload1(a+0); + a1 = pload1(a+1); + a2 = pload1(a+2); + a3 = pload1(a+3); +} + +/** \internal equivalent to + * \code + * a0 = pload1(a+0); + * a1 = pload1(a+1); + * \endcode + * \sa pset1, pload1, ploaddup, pbroadcast4 + */ +template EIGEN_DEVICE_FUNC +inline void pbroadcast2(const typename unpacket_traits::type *a, + Packet& a0, Packet& a1) +{ + a0 = pload1(a+0); + a1 = pload1(a+1); +} + +/** \internal \brief Returns a packet with coefficients (a,a+1,...,a+packet_size-1). */ +template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet +plset(const typename unpacket_traits::type& a) { return a; } + +/** \internal \returns a packet with constant coefficients \a a, e.g.: (x, 0, x, 0), + where x is the value of all 1-bits. */ +template EIGEN_DEVICE_FUNC inline Packet +peven_mask(const Packet& /*a*/) { + typedef typename unpacket_traits::type Scalar; + const size_t n = unpacket_traits::size; + EIGEN_ALIGN_TO_BOUNDARY(sizeof(Packet)) Scalar elements[n]; + for(size_t i = 0; i < n; ++i) { + memset(elements+i, ((i & 1) == 0 ? 0xff : 0), sizeof(Scalar)); + } + return ploadu(elements); +} + + +/** \internal copy the packet \a from to \a *to, \a to must be 16 bytes aligned */ +template EIGEN_DEVICE_FUNC inline void pstore(Scalar* to, const Packet& from) +{ (*to) = from; } + +/** \internal copy the packet \a from to \a *to, (un-aligned store) */ +template EIGEN_DEVICE_FUNC inline void pstoreu(Scalar* to, const Packet& from) +{ (*to) = from; } + +/** \internal copy the packet \a from to \a *to, (un-aligned store with a mask) + * There is no generic implementation. We only have implementations for specialized + * cases. Generic case should not be called. + */ +template +EIGEN_DEVICE_FUNC inline +typename enable_if::masked_store_available, void>::type +pstoreu(Scalar* to, const Packet& from, typename unpacket_traits::mask_t umask); + + template EIGEN_DEVICE_FUNC inline Packet pgather(const Scalar* from, Index /*stride*/) + { return ploadu(from); } + + template EIGEN_DEVICE_FUNC inline void pscatter(Scalar* to, const Packet& from, Index /*stride*/) + { pstore(to, from); } + +/** \internal tries to do cache prefetching of \a addr */ +template EIGEN_DEVICE_FUNC inline void prefetch(const Scalar* addr) +{ +#if defined(EIGEN_HIP_DEVICE_COMPILE) + // do nothing +#elif defined(EIGEN_CUDA_ARCH) +#if defined(__LP64__) || EIGEN_OS_WIN64 + // 64-bit pointer operand constraint for inlined asm + asm(" prefetch.L1 [ %1 ];" : "=l"(addr) : "l"(addr)); +#else + // 32-bit pointer operand constraint for inlined asm + asm(" prefetch.L1 [ %1 ];" : "=r"(addr) : "r"(addr)); +#endif +#elif (!EIGEN_COMP_MSVC) && (EIGEN_COMP_GNUC || EIGEN_COMP_CLANG || EIGEN_COMP_ICC) + __builtin_prefetch(addr); +#endif +} + +/** \internal \returns the reversed elements of \a a*/ +template EIGEN_DEVICE_FUNC inline Packet preverse(const Packet& a) +{ return a; } + +/** \internal \returns \a a with real and imaginary part flipped (for complex type only) */ +template EIGEN_DEVICE_FUNC inline Packet pcplxflip(const Packet& a) +{ + return Packet(numext::imag(a),numext::real(a)); +} + +/************************** +* Special math functions +***************************/ + +/** \internal \returns the sine of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet psin(const Packet& a) { EIGEN_USING_STD(sin); return sin(a); } + +/** \internal \returns the cosine of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pcos(const Packet& a) { EIGEN_USING_STD(cos); return cos(a); } + +/** \internal \returns the tan of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet ptan(const Packet& a) { EIGEN_USING_STD(tan); return tan(a); } + +/** \internal \returns the arc sine of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pasin(const Packet& a) { EIGEN_USING_STD(asin); return asin(a); } + +/** \internal \returns the arc cosine of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pacos(const Packet& a) { EIGEN_USING_STD(acos); return acos(a); } + +/** \internal \returns the arc tangent of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet patan(const Packet& a) { EIGEN_USING_STD(atan); return atan(a); } + +/** \internal \returns the hyperbolic sine of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet psinh(const Packet& a) { EIGEN_USING_STD(sinh); return sinh(a); } + +/** \internal \returns the hyperbolic cosine of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pcosh(const Packet& a) { EIGEN_USING_STD(cosh); return cosh(a); } + +/** \internal \returns the hyperbolic tan of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet ptanh(const Packet& a) { EIGEN_USING_STD(tanh); return tanh(a); } + +/** \internal \returns the exp of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pexp(const Packet& a) { EIGEN_USING_STD(exp); return exp(a); } + +/** \internal \returns the expm1 of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pexpm1(const Packet& a) { return numext::expm1(a); } + +/** \internal \returns the log of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet plog(const Packet& a) { EIGEN_USING_STD(log); return log(a); } + +/** \internal \returns the log1p of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet plog1p(const Packet& a) { return numext::log1p(a); } + +/** \internal \returns the log10 of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet plog10(const Packet& a) { EIGEN_USING_STD(log10); return log10(a); } + +/** \internal \returns the log10 of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet plog2(const Packet& a) { + typedef typename internal::unpacket_traits::type Scalar; + return pmul(pset1(Scalar(EIGEN_LOG2E)), plog(a)); +} + +/** \internal \returns the square-root of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet psqrt(const Packet& a) { return numext::sqrt(a); } + +/** \internal \returns the reciprocal square-root of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet prsqrt(const Packet& a) { + typedef typename internal::unpacket_traits::type Scalar; + return pdiv(pset1(Scalar(1)), psqrt(a)); +} + +/** \internal \returns the rounded value of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pround(const Packet& a) { using numext::round; return round(a); } + +/** \internal \returns the floor of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pfloor(const Packet& a) { using numext::floor; return floor(a); } + +/** \internal \returns the rounded value of \a a (coeff-wise) with current + * rounding mode */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet print(const Packet& a) { using numext::rint; return rint(a); } + +/** \internal \returns the ceil of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pceil(const Packet& a) { using numext::ceil; return ceil(a); } + +/** \internal \returns the first element of a packet */ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type +pfirst(const Packet& a) +{ return a; } + +/** \internal \returns the sum of the elements of upper and lower half of \a a if \a a is larger than 4. + * For a packet {a0, a1, a2, a3, a4, a5, a6, a7}, it returns a half packet {a0+a4, a1+a5, a2+a6, a3+a7} + * For packet-size smaller or equal to 4, this boils down to a noop. + */ +template +EIGEN_DEVICE_FUNC inline typename conditional<(unpacket_traits::size%8)==0,typename unpacket_traits::half,Packet>::type +predux_half_dowto4(const Packet& a) +{ return a; } + +// Slow generic implementation of Packet reduction. +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type +predux_helper(const Packet& a, Op op) { + typedef typename unpacket_traits::type Scalar; + const size_t n = unpacket_traits::size; + EIGEN_ALIGN_TO_BOUNDARY(sizeof(Packet)) Scalar elements[n]; + pstoreu(elements, a); + for(size_t k = n / 2; k > 0; k /= 2) { + for(size_t i = 0; i < k; ++i) { + elements[i] = op(elements[i], elements[i + k]); + } + } + return elements[0]; +} + +/** \internal \returns the sum of the elements of \a a*/ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type +predux(const Packet& a) +{ + return a; +} + +/** \internal \returns the product of the elements of \a a */ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_mul( + const Packet& a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmul))); +} + +/** \internal \returns the min of the elements of \a a */ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_min( + const Packet &a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmin))); +} + +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_min( + const Packet& a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmin))); +} + +/** \internal \returns the min of the elements of \a a */ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_max( + const Packet &a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmax))); +} + +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_max( + const Packet& a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmax))); +} + +#undef EIGEN_BINARY_OP_NAN_PROPAGATION + +/** \internal \returns true if all coeffs of \a a means "true" + * It is supposed to be called on values returned by pcmp_*. + */ +// not needed yet +// template EIGEN_DEVICE_FUNC inline bool predux_all(const Packet& a) +// { return bool(a); } + +/** \internal \returns true if any coeffs of \a a means "true" + * It is supposed to be called on values returned by pcmp_*. + */ +template EIGEN_DEVICE_FUNC inline bool predux_any(const Packet& a) +{ + // Dirty but generic implementation where "true" is assumed to be non 0 and all the sames. + // It is expected that "true" is either: + // - Scalar(1) + // - bits full of ones (NaN for floats), + // - or first bit equals to 1 (1 for ints, smallest denormal for floats). + // For all these cases, taking the sum is just fine, and this boils down to a no-op for scalars. + typedef typename unpacket_traits::type Scalar; + return numext::not_equal_strict(predux(a), Scalar(0)); +} + +/*************************************************************************** +* The following functions might not have to be overwritten for vectorized types +***************************************************************************/ + +/** \internal copy a packet with constant coefficient \a a (e.g., [a,a,a,a]) to \a *to. \a to must be 16 bytes aligned */ +// NOTE: this function must really be templated on the packet type (think about different packet types for the same scalar type) +template +inline void pstore1(typename unpacket_traits::type* to, const typename unpacket_traits::type& a) +{ + pstore(to, pset1(a)); +} + +/** \internal \returns a * b + c (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +pmadd(const Packet& a, + const Packet& b, + const Packet& c) +{ return padd(pmul(a, b),c); } + +/** \internal \returns a packet version of \a *from. + * The pointer \a from must be aligned on a \a Alignment bytes boundary. */ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet ploadt(const typename unpacket_traits::type* from) +{ + if(Alignment >= unpacket_traits::alignment) + return pload(from); + else + return ploadu(from); +} + +/** \internal copy the packet \a from to \a *to. + * The pointer \a from must be aligned on a \a Alignment bytes boundary. */ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE void pstoret(Scalar* to, const Packet& from) +{ + if(Alignment >= unpacket_traits::alignment) + pstore(to, from); + else + pstoreu(to, from); +} + +/** \internal \returns a packet version of \a *from. + * Unlike ploadt, ploadt_ro takes advantage of the read-only memory path on the + * hardware if available to speedup the loading of data that won't be modified + * by the current computation. + */ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet ploadt_ro(const typename unpacket_traits::type* from) +{ + return ploadt(from); +} + +/*************************************************************************** +* Fast complex products (GCC generates a function call which is very slow) +***************************************************************************/ + +// Eigen+CUDA does not support complexes. +#if !defined(EIGEN_GPUCC) + +template<> inline std::complex pmul(const std::complex& a, const std::complex& b) +{ return std::complex(a.real()*b.real() - a.imag()*b.imag(), a.imag()*b.real() + a.real()*b.imag()); } + +template<> inline std::complex pmul(const std::complex& a, const std::complex& b) +{ return std::complex(a.real()*b.real() - a.imag()*b.imag(), a.imag()*b.real() + a.real()*b.imag()); } + +#endif + + +/*************************************************************************** + * PacketBlock, that is a collection of N packets where the number of words + * in the packet is a multiple of N. +***************************************************************************/ +template ::size> struct PacketBlock { + Packet packet[N]; +}; + +template EIGEN_DEVICE_FUNC inline void +ptranspose(PacketBlock& /*kernel*/) { + // Nothing to do in the scalar case, i.e. a 1x1 matrix. +} + +/*************************************************************************** + * Selector, i.e. vector of N boolean values used to select (i.e. blend) + * words from 2 packets. +***************************************************************************/ +template struct Selector { + bool select[N]; +}; + +template EIGEN_DEVICE_FUNC inline Packet +pblend(const Selector::size>& ifPacket, const Packet& thenPacket, const Packet& elsePacket) { + return ifPacket.select[0] ? thenPacket : elsePacket; +} + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_GENERIC_PACKET_MATH_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/GlobalFunctions.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/GlobalFunctions.h new file mode 100644 index 0000000..629af94 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/GlobalFunctions.h @@ -0,0 +1,194 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2010-2016 Gael Guennebaud +// Copyright (C) 2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_GLOBAL_FUNCTIONS_H +#define EIGEN_GLOBAL_FUNCTIONS_H + +#ifdef EIGEN_PARSED_BY_DOXYGEN + +#define EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(NAME,FUNCTOR,DOC_OP,DOC_DETAILS) \ + /** \returns an expression of the coefficient-wise DOC_OP of \a x + + DOC_DETAILS + + \sa Math functions, class CwiseUnaryOp + */ \ + template \ + inline const Eigen::CwiseUnaryOp, const Derived> \ + NAME(const Eigen::ArrayBase& x); + +#else + +#define EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(NAME,FUNCTOR,DOC_OP,DOC_DETAILS) \ + template \ + inline const Eigen::CwiseUnaryOp, const Derived> \ + (NAME)(const Eigen::ArrayBase& x) { \ + return Eigen::CwiseUnaryOp, const Derived>(x.derived()); \ + } + +#endif // EIGEN_PARSED_BY_DOXYGEN + +#define EIGEN_ARRAY_DECLARE_GLOBAL_EIGEN_UNARY(NAME,FUNCTOR) \ + \ + template \ + struct NAME##_retval > \ + { \ + typedef const Eigen::CwiseUnaryOp, const Derived> type; \ + }; \ + template \ + struct NAME##_impl > \ + { \ + static inline typename NAME##_retval >::type run(const Eigen::ArrayBase& x) \ + { \ + return typename NAME##_retval >::type(x.derived()); \ + } \ + }; + +namespace Eigen +{ + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(real,scalar_real_op,real part,\sa ArrayBase::real) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(imag,scalar_imag_op,imaginary part,\sa ArrayBase::imag) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(conj,scalar_conjugate_op,complex conjugate,\sa ArrayBase::conjugate) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(inverse,scalar_inverse_op,inverse,\sa ArrayBase::inverse) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(sin,scalar_sin_op,sine,\sa ArrayBase::sin) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(cos,scalar_cos_op,cosine,\sa ArrayBase::cos) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(tan,scalar_tan_op,tangent,\sa ArrayBase::tan) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(atan,scalar_atan_op,arc-tangent,\sa ArrayBase::atan) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(asin,scalar_asin_op,arc-sine,\sa ArrayBase::asin) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(acos,scalar_acos_op,arc-consine,\sa ArrayBase::acos) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(sinh,scalar_sinh_op,hyperbolic sine,\sa ArrayBase::sinh) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(cosh,scalar_cosh_op,hyperbolic cosine,\sa ArrayBase::cosh) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(tanh,scalar_tanh_op,hyperbolic tangent,\sa ArrayBase::tanh) +#if EIGEN_HAS_CXX11_MATH + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(asinh,scalar_asinh_op,inverse hyperbolic sine,\sa ArrayBase::asinh) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(acosh,scalar_acosh_op,inverse hyperbolic cosine,\sa ArrayBase::acosh) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(atanh,scalar_atanh_op,inverse hyperbolic tangent,\sa ArrayBase::atanh) +#endif + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(logistic,scalar_logistic_op,logistic function,\sa ArrayBase::logistic) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(lgamma,scalar_lgamma_op,natural logarithm of the gamma function,\sa ArrayBase::lgamma) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(digamma,scalar_digamma_op,derivative of lgamma,\sa ArrayBase::digamma) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(erf,scalar_erf_op,error function,\sa ArrayBase::erf) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(erfc,scalar_erfc_op,complement error function,\sa ArrayBase::erfc) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(ndtri,scalar_ndtri_op,inverse normal distribution function,\sa ArrayBase::ndtri) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(exp,scalar_exp_op,exponential,\sa ArrayBase::exp) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(expm1,scalar_expm1_op,exponential of a value minus 1,\sa ArrayBase::expm1) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(log,scalar_log_op,natural logarithm,\sa Eigen::log10 DOXCOMMA ArrayBase::log) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(log1p,scalar_log1p_op,natural logarithm of 1 plus the value,\sa ArrayBase::log1p) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(log10,scalar_log10_op,base 10 logarithm,\sa Eigen::log DOXCOMMA ArrayBase::log10) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(log2,scalar_log2_op,base 2 logarithm,\sa Eigen::log DOXCOMMA ArrayBase::log2) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(abs,scalar_abs_op,absolute value,\sa ArrayBase::abs DOXCOMMA MatrixBase::cwiseAbs) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(abs2,scalar_abs2_op,squared absolute value,\sa ArrayBase::abs2 DOXCOMMA MatrixBase::cwiseAbs2) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(arg,scalar_arg_op,complex argument,\sa ArrayBase::arg DOXCOMMA MatrixBase::cwiseArg) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(sqrt,scalar_sqrt_op,square root,\sa ArrayBase::sqrt DOXCOMMA MatrixBase::cwiseSqrt) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(rsqrt,scalar_rsqrt_op,reciprocal square root,\sa ArrayBase::rsqrt) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(square,scalar_square_op,square (power 2),\sa Eigen::abs2 DOXCOMMA Eigen::pow DOXCOMMA ArrayBase::square) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(cube,scalar_cube_op,cube (power 3),\sa Eigen::pow DOXCOMMA ArrayBase::cube) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(rint,scalar_rint_op,nearest integer,\sa Eigen::floor DOXCOMMA Eigen::ceil DOXCOMMA ArrayBase::round) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(round,scalar_round_op,nearest integer,\sa Eigen::floor DOXCOMMA Eigen::ceil DOXCOMMA ArrayBase::round) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(floor,scalar_floor_op,nearest integer not greater than the giben value,\sa Eigen::ceil DOXCOMMA ArrayBase::floor) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(ceil,scalar_ceil_op,nearest integer not less than the giben value,\sa Eigen::floor DOXCOMMA ArrayBase::ceil) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(isnan,scalar_isnan_op,not-a-number test,\sa Eigen::isinf DOXCOMMA Eigen::isfinite DOXCOMMA ArrayBase::isnan) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(isinf,scalar_isinf_op,infinite value test,\sa Eigen::isnan DOXCOMMA Eigen::isfinite DOXCOMMA ArrayBase::isinf) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(isfinite,scalar_isfinite_op,finite value test,\sa Eigen::isinf DOXCOMMA Eigen::isnan DOXCOMMA ArrayBase::isfinite) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(sign,scalar_sign_op,sign (or 0),\sa ArrayBase::sign) + + /** \returns an expression of the coefficient-wise power of \a x to the given constant \a exponent. + * + * \tparam ScalarExponent is the scalar type of \a exponent. It must be compatible with the scalar type of the given expression (\c Derived::Scalar). + * + * \sa ArrayBase::pow() + * + * \relates ArrayBase + */ +#ifdef EIGEN_PARSED_BY_DOXYGEN + template + inline const CwiseBinaryOp,Derived,Constant > + pow(const Eigen::ArrayBase& x, const ScalarExponent& exponent); +#else + template + EIGEN_DEVICE_FUNC inline + EIGEN_MSVC10_WORKAROUND_BINARYOP_RETURN_TYPE( + const EIGEN_EXPR_BINARYOP_SCALAR_RETURN_TYPE(Derived,typename internal::promote_scalar_arg::type,pow)) + pow(const Eigen::ArrayBase& x, const ScalarExponent& exponent) + { + typedef typename internal::promote_scalar_arg::type PromotedExponent; + return EIGEN_EXPR_BINARYOP_SCALAR_RETURN_TYPE(Derived,PromotedExponent,pow)(x.derived(), + typename internal::plain_constant_type::type(x.derived().rows(), x.derived().cols(), internal::scalar_constant_op(exponent))); + } +#endif + + /** \returns an expression of the coefficient-wise power of \a x to the given array of \a exponents. + * + * This function computes the coefficient-wise power. + * + * Example: \include Cwise_array_power_array.cpp + * Output: \verbinclude Cwise_array_power_array.out + * + * \sa ArrayBase::pow() + * + * \relates ArrayBase + */ + template + inline const Eigen::CwiseBinaryOp, const Derived, const ExponentDerived> + pow(const Eigen::ArrayBase& x, const Eigen::ArrayBase& exponents) + { + return Eigen::CwiseBinaryOp, const Derived, const ExponentDerived>( + x.derived(), + exponents.derived() + ); + } + + /** \returns an expression of the coefficient-wise power of the scalar \a x to the given array of \a exponents. + * + * This function computes the coefficient-wise power between a scalar and an array of exponents. + * + * \tparam Scalar is the scalar type of \a x. It must be compatible with the scalar type of the given array expression (\c Derived::Scalar). + * + * Example: \include Cwise_scalar_power_array.cpp + * Output: \verbinclude Cwise_scalar_power_array.out + * + * \sa ArrayBase::pow() + * + * \relates ArrayBase + */ +#ifdef EIGEN_PARSED_BY_DOXYGEN + template + inline const CwiseBinaryOp,Constant,Derived> + pow(const Scalar& x,const Eigen::ArrayBase& x); +#else + template + EIGEN_DEVICE_FUNC inline + EIGEN_MSVC10_WORKAROUND_BINARYOP_RETURN_TYPE( + const EIGEN_SCALAR_BINARYOP_EXPR_RETURN_TYPE(typename internal::promote_scalar_arg::type,Derived,pow)) + pow(const Scalar& x, const Eigen::ArrayBase& exponents) { + typedef typename internal::promote_scalar_arg::type PromotedScalar; + return EIGEN_SCALAR_BINARYOP_EXPR_RETURN_TYPE(PromotedScalar,Derived,pow)( + typename internal::plain_constant_type::type(exponents.derived().rows(), exponents.derived().cols(), internal::scalar_constant_op(x)), exponents.derived()); + } +#endif + + + namespace internal + { + EIGEN_ARRAY_DECLARE_GLOBAL_EIGEN_UNARY(real,scalar_real_op) + EIGEN_ARRAY_DECLARE_GLOBAL_EIGEN_UNARY(imag,scalar_imag_op) + EIGEN_ARRAY_DECLARE_GLOBAL_EIGEN_UNARY(abs2,scalar_abs2_op) + } +} + +// TODO: cleanly disable those functions that are not supported on Array (numext::real_ref, internal::random, internal::isApprox...) + +#endif // EIGEN_GLOBAL_FUNCTIONS_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/IO.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/IO.h new file mode 100644 index 0000000..e81c315 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/IO.h @@ -0,0 +1,258 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_IO_H +#define EIGEN_IO_H + +namespace Eigen { + +enum { DontAlignCols = 1 }; +enum { StreamPrecision = -1, + FullPrecision = -2 }; + +namespace internal { +template +std::ostream & print_matrix(std::ostream & s, const Derived& _m, const IOFormat& fmt); +} + +/** \class IOFormat + * \ingroup Core_Module + * + * \brief Stores a set of parameters controlling the way matrices are printed + * + * List of available parameters: + * - \b precision number of digits for floating point values, or one of the special constants \c StreamPrecision and \c FullPrecision. + * The default is the special value \c StreamPrecision which means to use the + * stream's own precision setting, as set for instance using \c cout.precision(3). The other special value + * \c FullPrecision means that the number of digits will be computed to match the full precision of each floating-point + * type. + * - \b flags an OR-ed combination of flags, the default value is 0, the only currently available flag is \c DontAlignCols which + * allows to disable the alignment of columns, resulting in faster code. + * - \b coeffSeparator string printed between two coefficients of the same row + * - \b rowSeparator string printed between two rows + * - \b rowPrefix string printed at the beginning of each row + * - \b rowSuffix string printed at the end of each row + * - \b matPrefix string printed at the beginning of the matrix + * - \b matSuffix string printed at the end of the matrix + * - \b fill character printed to fill the empty space in aligned columns + * + * Example: \include IOFormat.cpp + * Output: \verbinclude IOFormat.out + * + * \sa DenseBase::format(), class WithFormat + */ +struct IOFormat +{ + /** Default constructor, see class IOFormat for the meaning of the parameters */ + IOFormat(int _precision = StreamPrecision, int _flags = 0, + const std::string& _coeffSeparator = " ", + const std::string& _rowSeparator = "\n", const std::string& _rowPrefix="", const std::string& _rowSuffix="", + const std::string& _matPrefix="", const std::string& _matSuffix="", const char _fill=' ') + : matPrefix(_matPrefix), matSuffix(_matSuffix), rowPrefix(_rowPrefix), rowSuffix(_rowSuffix), rowSeparator(_rowSeparator), + rowSpacer(""), coeffSeparator(_coeffSeparator), fill(_fill), precision(_precision), flags(_flags) + { + // TODO check if rowPrefix, rowSuffix or rowSeparator contains a newline + // don't add rowSpacer if columns are not to be aligned + if((flags & DontAlignCols)) + return; + int i = int(matSuffix.length())-1; + while (i>=0 && matSuffix[i]!='\n') + { + rowSpacer += ' '; + i--; + } + } + std::string matPrefix, matSuffix; + std::string rowPrefix, rowSuffix, rowSeparator, rowSpacer; + std::string coeffSeparator; + char fill; + int precision; + int flags; +}; + +/** \class WithFormat + * \ingroup Core_Module + * + * \brief Pseudo expression providing matrix output with given format + * + * \tparam ExpressionType the type of the object on which IO stream operations are performed + * + * This class represents an expression with stream operators controlled by a given IOFormat. + * It is the return type of DenseBase::format() + * and most of the time this is the only way it is used. + * + * See class IOFormat for some examples. + * + * \sa DenseBase::format(), class IOFormat + */ +template +class WithFormat +{ + public: + + WithFormat(const ExpressionType& matrix, const IOFormat& format) + : m_matrix(matrix), m_format(format) + {} + + friend std::ostream & operator << (std::ostream & s, const WithFormat& wf) + { + return internal::print_matrix(s, wf.m_matrix.eval(), wf.m_format); + } + + protected: + typename ExpressionType::Nested m_matrix; + IOFormat m_format; +}; + +namespace internal { + +// NOTE: This helper is kept for backward compatibility with previous code specializing +// this internal::significant_decimals_impl structure. In the future we should directly +// call digits10() which has been introduced in July 2016 in 3.3. +template +struct significant_decimals_impl +{ + static inline int run() + { + return NumTraits::digits10(); + } +}; + +/** \internal + * print the matrix \a _m to the output stream \a s using the output format \a fmt */ +template +std::ostream & print_matrix(std::ostream & s, const Derived& _m, const IOFormat& fmt) +{ + using internal::is_same; + using internal::conditional; + + if(_m.size() == 0) + { + s << fmt.matPrefix << fmt.matSuffix; + return s; + } + + typename Derived::Nested m = _m; + typedef typename Derived::Scalar Scalar; + typedef typename + conditional< + is_same::value || + is_same::value || + is_same::value || + is_same::value, + int, + typename conditional< + is_same >::value || + is_same >::value || + is_same >::value || + is_same >::value, + std::complex, + const Scalar& + >::type + >::type PrintType; + + Index width = 0; + + std::streamsize explicit_precision; + if(fmt.precision == StreamPrecision) + { + explicit_precision = 0; + } + else if(fmt.precision == FullPrecision) + { + if (NumTraits::IsInteger) + { + explicit_precision = 0; + } + else + { + explicit_precision = significant_decimals_impl::run(); + } + } + else + { + explicit_precision = fmt.precision; + } + + std::streamsize old_precision = 0; + if(explicit_precision) old_precision = s.precision(explicit_precision); + + bool align_cols = !(fmt.flags & DontAlignCols); + if(align_cols) + { + // compute the largest width + for(Index j = 0; j < m.cols(); ++j) + for(Index i = 0; i < m.rows(); ++i) + { + std::stringstream sstr; + sstr.copyfmt(s); + sstr << static_cast(m.coeff(i,j)); + width = std::max(width, Index(sstr.str().length())); + } + } + std::streamsize old_width = s.width(); + char old_fill_character = s.fill(); + s << fmt.matPrefix; + for(Index i = 0; i < m.rows(); ++i) + { + if (i) + s << fmt.rowSpacer; + s << fmt.rowPrefix; + if(width) { + s.fill(fmt.fill); + s.width(width); + } + s << static_cast(m.coeff(i, 0)); + for(Index j = 1; j < m.cols(); ++j) + { + s << fmt.coeffSeparator; + if(width) { + s.fill(fmt.fill); + s.width(width); + } + s << static_cast(m.coeff(i, j)); + } + s << fmt.rowSuffix; + if( i < m.rows() - 1) + s << fmt.rowSeparator; + } + s << fmt.matSuffix; + if(explicit_precision) s.precision(old_precision); + if(width) { + s.fill(old_fill_character); + s.width(old_width); + } + return s; +} + +} // end namespace internal + +/** \relates DenseBase + * + * Outputs the matrix, to the given stream. + * + * If you wish to print the matrix with a format different than the default, use DenseBase::format(). + * + * It is also possible to change the default format by defining EIGEN_DEFAULT_IO_FORMAT before including Eigen headers. + * If not defined, this will automatically be defined to Eigen::IOFormat(), that is the Eigen::IOFormat with default parameters. + * + * \sa DenseBase::format() + */ +template +std::ostream & operator << +(std::ostream & s, + const DenseBase & m) +{ + return internal::print_matrix(s, m.eval(), EIGEN_DEFAULT_IO_FORMAT); +} + +} // end namespace Eigen + +#endif // EIGEN_IO_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/IndexedView.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/IndexedView.h new file mode 100644 index 0000000..0847625 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/IndexedView.h @@ -0,0 +1,237 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2017 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_INDEXED_VIEW_H +#define EIGEN_INDEXED_VIEW_H + +namespace Eigen { + +namespace internal { + +template +struct traits > + : traits +{ + enum { + RowsAtCompileTime = int(array_size::value), + ColsAtCompileTime = int(array_size::value), + MaxRowsAtCompileTime = RowsAtCompileTime != Dynamic ? int(RowsAtCompileTime) : Dynamic, + MaxColsAtCompileTime = ColsAtCompileTime != Dynamic ? int(ColsAtCompileTime) : Dynamic, + + XprTypeIsRowMajor = (int(traits::Flags)&RowMajorBit) != 0, + IsRowMajor = (MaxRowsAtCompileTime==1&&MaxColsAtCompileTime!=1) ? 1 + : (MaxColsAtCompileTime==1&&MaxRowsAtCompileTime!=1) ? 0 + : XprTypeIsRowMajor, + + RowIncr = int(get_compile_time_incr::value), + ColIncr = int(get_compile_time_incr::value), + InnerIncr = IsRowMajor ? ColIncr : RowIncr, + OuterIncr = IsRowMajor ? RowIncr : ColIncr, + + HasSameStorageOrderAsXprType = (IsRowMajor == XprTypeIsRowMajor), + XprInnerStride = HasSameStorageOrderAsXprType ? int(inner_stride_at_compile_time::ret) : int(outer_stride_at_compile_time::ret), + XprOuterstride = HasSameStorageOrderAsXprType ? int(outer_stride_at_compile_time::ret) : int(inner_stride_at_compile_time::ret), + + InnerSize = XprTypeIsRowMajor ? ColsAtCompileTime : RowsAtCompileTime, + IsBlockAlike = InnerIncr==1 && OuterIncr==1, + IsInnerPannel = HasSameStorageOrderAsXprType && is_same,typename conditional::type>::value, + + InnerStrideAtCompileTime = InnerIncr<0 || InnerIncr==DynamicIndex || XprInnerStride==Dynamic ? Dynamic : XprInnerStride * InnerIncr, + OuterStrideAtCompileTime = OuterIncr<0 || OuterIncr==DynamicIndex || XprOuterstride==Dynamic ? Dynamic : XprOuterstride * OuterIncr, + + ReturnAsScalar = is_same::value && is_same::value, + ReturnAsBlock = (!ReturnAsScalar) && IsBlockAlike, + ReturnAsIndexedView = (!ReturnAsScalar) && (!ReturnAsBlock), + + // FIXME we deal with compile-time strides if and only if we have DirectAccessBit flag, + // but this is too strict regarding negative strides... + DirectAccessMask = (int(InnerIncr)!=UndefinedIncr && int(OuterIncr)!=UndefinedIncr && InnerIncr>=0 && OuterIncr>=0) ? DirectAccessBit : 0, + FlagsRowMajorBit = IsRowMajor ? RowMajorBit : 0, + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + FlagsLinearAccessBit = (RowsAtCompileTime == 1 || ColsAtCompileTime == 1) ? LinearAccessBit : 0, + Flags = (traits::Flags & (HereditaryBits | DirectAccessMask )) | FlagsLvalueBit | FlagsRowMajorBit | FlagsLinearAccessBit + }; + + typedef Block BlockType; +}; + +} + +template +class IndexedViewImpl; + + +/** \class IndexedView + * \ingroup Core_Module + * + * \brief Expression of a non-sequential sub-matrix defined by arbitrary sequences of row and column indices + * + * \tparam XprType the type of the expression in which we are taking the intersections of sub-rows and sub-columns + * \tparam RowIndices the type of the object defining the sequence of row indices + * \tparam ColIndices the type of the object defining the sequence of column indices + * + * This class represents an expression of a sub-matrix (or sub-vector) defined as the intersection + * of sub-sets of rows and columns, that are themself defined by generic sequences of row indices \f$ \{r_0,r_1,..r_{m-1}\} \f$ + * and column indices \f$ \{c_0,c_1,..c_{n-1} \}\f$. Let \f$ A \f$ be the nested matrix, then the resulting matrix \f$ B \f$ has \c m + * rows and \c n columns, and its entries are given by: \f$ B(i,j) = A(r_i,c_j) \f$. + * + * The \c RowIndices and \c ColIndices types must be compatible with the following API: + * \code + * operator[](Index) const; + * Index size() const; + * \endcode + * + * Typical supported types thus include: + * - std::vector + * - std::valarray + * - std::array + * - Plain C arrays: int[N] + * - Eigen::ArrayXi + * - decltype(ArrayXi::LinSpaced(...)) + * - Any view/expressions of the previous types + * - Eigen::ArithmeticSequence + * - Eigen::internal::AllRange (helper for Eigen::all) + * - Eigen::internal::SingleRange (helper for single index) + * - etc. + * + * In typical usages of %Eigen, this class should never be used directly. It is the return type of + * DenseBase::operator()(const RowIndices&, const ColIndices&). + * + * \sa class Block + */ +template +class IndexedView : public IndexedViewImpl::StorageKind> +{ +public: + typedef typename IndexedViewImpl::StorageKind>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(IndexedView) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(IndexedView) + + typedef typename internal::ref_selector::non_const_type MatrixTypeNested; + typedef typename internal::remove_all::type NestedExpression; + + template + IndexedView(XprType& xpr, const T0& rowIndices, const T1& colIndices) + : m_xpr(xpr), m_rowIndices(rowIndices), m_colIndices(colIndices) + {} + + /** \returns number of rows */ + Index rows() const { return internal::size(m_rowIndices); } + + /** \returns number of columns */ + Index cols() const { return internal::size(m_colIndices); } + + /** \returns the nested expression */ + const typename internal::remove_all::type& + nestedExpression() const { return m_xpr; } + + /** \returns the nested expression */ + typename internal::remove_reference::type& + nestedExpression() { return m_xpr; } + + /** \returns a const reference to the object storing/generating the row indices */ + const RowIndices& rowIndices() const { return m_rowIndices; } + + /** \returns a const reference to the object storing/generating the column indices */ + const ColIndices& colIndices() const { return m_colIndices; } + +protected: + MatrixTypeNested m_xpr; + RowIndices m_rowIndices; + ColIndices m_colIndices; +}; + + +// Generic API dispatcher +template +class IndexedViewImpl + : public internal::generic_xpr_base >::type +{ +public: + typedef typename internal::generic_xpr_base >::type Base; +}; + +namespace internal { + + +template +struct unary_evaluator, IndexBased> + : evaluator_base > +{ + typedef IndexedView XprType; + + enum { + CoeffReadCost = evaluator::CoeffReadCost /* TODO + cost of row/col index */, + + FlagsLinearAccessBit = (traits::RowsAtCompileTime == 1 || traits::ColsAtCompileTime == 1) ? LinearAccessBit : 0, + + FlagsRowMajorBit = traits::FlagsRowMajorBit, + + Flags = (evaluator::Flags & (HereditaryBits & ~RowMajorBit /*| LinearAccessBit | DirectAccessBit*/)) | FlagsLinearAccessBit | FlagsRowMajorBit, + + Alignment = 0 + }; + + EIGEN_DEVICE_FUNC explicit unary_evaluator(const XprType& xpr) : m_argImpl(xpr.nestedExpression()), m_xpr(xpr) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_argImpl.coeff(m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_argImpl.coeffRef(m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + Index row = XprType::RowsAtCompileTime == 1 ? 0 : index; + Index col = XprType::RowsAtCompileTime == 1 ? index : 0; + return m_argImpl.coeffRef( m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const Scalar& coeffRef(Index index) const + { + Index row = XprType::RowsAtCompileTime == 1 ? 0 : index; + Index col = XprType::RowsAtCompileTime == 1 ? index : 0; + return m_argImpl.coeffRef( m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const CoeffReturnType coeff(Index index) const + { + Index row = XprType::RowsAtCompileTime == 1 ? 0 : index; + Index col = XprType::RowsAtCompileTime == 1 ? index : 0; + return m_argImpl.coeff( m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + +protected: + + evaluator m_argImpl; + const XprType& m_xpr; + +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_INDEXED_VIEW_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Inverse.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Inverse.h new file mode 100644 index 0000000..c514438 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Inverse.h @@ -0,0 +1,117 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2014-2019 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_INVERSE_H +#define EIGEN_INVERSE_H + +namespace Eigen { + +template class InverseImpl; + +namespace internal { + +template +struct traits > + : traits +{ + typedef typename XprType::PlainObject PlainObject; + typedef traits BaseTraits; + enum { + Flags = BaseTraits::Flags & RowMajorBit + }; +}; + +} // end namespace internal + +/** \class Inverse + * + * \brief Expression of the inverse of another expression + * + * \tparam XprType the type of the expression we are taking the inverse + * + * This class represents an abstract expression of A.inverse() + * and most of the time this is the only way it is used. + * + */ +template +class Inverse : public InverseImpl::StorageKind> +{ +public: + typedef typename XprType::StorageIndex StorageIndex; + typedef typename XprType::Scalar Scalar; + typedef typename internal::ref_selector::type XprTypeNested; + typedef typename internal::remove_all::type XprTypeNestedCleaned; + typedef typename internal::ref_selector::type Nested; + typedef typename internal::remove_all::type NestedExpression; + + explicit EIGEN_DEVICE_FUNC Inverse(const XprType &xpr) + : m_xpr(xpr) + {} + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index rows() const EIGEN_NOEXCEPT { return m_xpr.cols(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index cols() const EIGEN_NOEXCEPT { return m_xpr.rows(); } + + EIGEN_DEVICE_FUNC const XprTypeNestedCleaned& nestedExpression() const { return m_xpr; } + +protected: + XprTypeNested m_xpr; +}; + +// Generic API dispatcher +template +class InverseImpl + : public internal::generic_xpr_base >::type +{ +public: + typedef typename internal::generic_xpr_base >::type Base; + typedef typename XprType::Scalar Scalar; +private: + + Scalar coeff(Index row, Index col) const; + Scalar coeff(Index i) const; +}; + +namespace internal { + +/** \internal + * \brief Default evaluator for Inverse expression. + * + * This default evaluator for Inverse expression simply evaluate the inverse into a temporary + * by a call to internal::call_assignment_no_alias. + * Therefore, inverse implementers only have to specialize Assignment, ...> for + * there own nested expression. + * + * \sa class Inverse + */ +template +struct unary_evaluator > + : public evaluator::PlainObject> +{ + typedef Inverse InverseType; + typedef typename InverseType::PlainObject PlainObject; + typedef evaluator Base; + + enum { Flags = Base::Flags | EvalBeforeNestingBit }; + + unary_evaluator(const InverseType& inv_xpr) + : m_result(inv_xpr.rows(), inv_xpr.cols()) + { + ::new (static_cast(this)) Base(m_result); + internal::call_assignment_no_alias(m_result, inv_xpr); + } + +protected: + PlainObject m_result; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_INVERSE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Map.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Map.h new file mode 100644 index 0000000..218cc15 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Map.h @@ -0,0 +1,171 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007-2010 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MAP_H +#define EIGEN_MAP_H + +namespace Eigen { + +namespace internal { +template +struct traits > + : public traits +{ + typedef traits TraitsBase; + enum { + PlainObjectTypeInnerSize = ((traits::Flags&RowMajorBit)==RowMajorBit) + ? PlainObjectType::ColsAtCompileTime + : PlainObjectType::RowsAtCompileTime, + + InnerStrideAtCompileTime = StrideType::InnerStrideAtCompileTime == 0 + ? int(PlainObjectType::InnerStrideAtCompileTime) + : int(StrideType::InnerStrideAtCompileTime), + OuterStrideAtCompileTime = StrideType::OuterStrideAtCompileTime == 0 + ? (InnerStrideAtCompileTime==Dynamic || PlainObjectTypeInnerSize==Dynamic + ? Dynamic + : int(InnerStrideAtCompileTime) * int(PlainObjectTypeInnerSize)) + : int(StrideType::OuterStrideAtCompileTime), + Alignment = int(MapOptions)&int(AlignedMask), + Flags0 = TraitsBase::Flags & (~NestByRefBit), + Flags = is_lvalue::value ? int(Flags0) : (int(Flags0) & ~LvalueBit) + }; +private: + enum { Options }; // Expressions don't have Options +}; +} + +/** \class Map + * \ingroup Core_Module + * + * \brief A matrix or vector expression mapping an existing array of data. + * + * \tparam PlainObjectType the equivalent matrix type of the mapped data + * \tparam MapOptions specifies the pointer alignment in bytes. It can be: \c #Aligned128, \c #Aligned64, \c #Aligned32, \c #Aligned16, \c #Aligned8 or \c #Unaligned. + * The default is \c #Unaligned. + * \tparam StrideType optionally specifies strides. By default, Map assumes the memory layout + * of an ordinary, contiguous array. This can be overridden by specifying strides. + * The type passed here must be a specialization of the Stride template, see examples below. + * + * This class represents a matrix or vector expression mapping an existing array of data. + * It can be used to let Eigen interface without any overhead with non-Eigen data structures, + * such as plain C arrays or structures from other libraries. By default, it assumes that the + * data is laid out contiguously in memory. You can however override this by explicitly specifying + * inner and outer strides. + * + * Here's an example of simply mapping a contiguous array as a \ref TopicStorageOrders "column-major" matrix: + * \include Map_simple.cpp + * Output: \verbinclude Map_simple.out + * + * If you need to map non-contiguous arrays, you can do so by specifying strides: + * + * Here's an example of mapping an array as a vector, specifying an inner stride, that is, the pointer + * increment between two consecutive coefficients. Here, we're specifying the inner stride as a compile-time + * fixed value. + * \include Map_inner_stride.cpp + * Output: \verbinclude Map_inner_stride.out + * + * Here's an example of mapping an array while specifying an outer stride. Here, since we're mapping + * as a column-major matrix, 'outer stride' means the pointer increment between two consecutive columns. + * Here, we're specifying the outer stride as a runtime parameter. Note that here \c OuterStride<> is + * a short version of \c OuterStride because the default template parameter of OuterStride + * is \c Dynamic + * \include Map_outer_stride.cpp + * Output: \verbinclude Map_outer_stride.out + * + * For more details and for an example of specifying both an inner and an outer stride, see class Stride. + * + * \b Tip: to change the array of data mapped by a Map object, you can use the C++ + * placement new syntax: + * + * Example: \include Map_placement_new.cpp + * Output: \verbinclude Map_placement_new.out + * + * This class is the return type of PlainObjectBase::Map() but can also be used directly. + * + * \sa PlainObjectBase::Map(), \ref TopicStorageOrders + */ +template class Map + : public MapBase > +{ + public: + + typedef MapBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Map) + + typedef typename Base::PointerType PointerType; + typedef PointerType PointerArgType; + EIGEN_DEVICE_FUNC + inline PointerType cast_to_pointer_type(PointerArgType ptr) { return ptr; } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const + { + return StrideType::InnerStrideAtCompileTime != 0 ? m_stride.inner() : 1; + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const + { + return StrideType::OuterStrideAtCompileTime != 0 ? m_stride.outer() + : internal::traits::OuterStrideAtCompileTime != Dynamic ? Index(internal::traits::OuterStrideAtCompileTime) + : IsVectorAtCompileTime ? (this->size() * innerStride()) + : int(Flags)&RowMajorBit ? (this->cols() * innerStride()) + : (this->rows() * innerStride()); + } + + /** Constructor in the fixed-size case. + * + * \param dataPtr pointer to the array to map + * \param stride optional Stride object, passing the strides. + */ + EIGEN_DEVICE_FUNC + explicit inline Map(PointerArgType dataPtr, const StrideType& stride = StrideType()) + : Base(cast_to_pointer_type(dataPtr)), m_stride(stride) + { + PlainObjectType::Base::_check_template_params(); + } + + /** Constructor in the dynamic-size vector case. + * + * \param dataPtr pointer to the array to map + * \param size the size of the vector expression + * \param stride optional Stride object, passing the strides. + */ + EIGEN_DEVICE_FUNC + inline Map(PointerArgType dataPtr, Index size, const StrideType& stride = StrideType()) + : Base(cast_to_pointer_type(dataPtr), size), m_stride(stride) + { + PlainObjectType::Base::_check_template_params(); + } + + /** Constructor in the dynamic-size matrix case. + * + * \param dataPtr pointer to the array to map + * \param rows the number of rows of the matrix expression + * \param cols the number of columns of the matrix expression + * \param stride optional Stride object, passing the strides. + */ + EIGEN_DEVICE_FUNC + inline Map(PointerArgType dataPtr, Index rows, Index cols, const StrideType& stride = StrideType()) + : Base(cast_to_pointer_type(dataPtr), rows, cols), m_stride(stride) + { + PlainObjectType::Base::_check_template_params(); + } + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Map) + + protected: + StrideType m_stride; +}; + + +} // end namespace Eigen + +#endif // EIGEN_MAP_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/MapBase.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/MapBase.h new file mode 100644 index 0000000..d856447 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/MapBase.h @@ -0,0 +1,310 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007-2010 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MAPBASE_H +#define EIGEN_MAPBASE_H + +#define EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) \ + EIGEN_STATIC_ASSERT((int(internal::evaluator::Flags) & LinearAccessBit) || Derived::IsVectorAtCompileTime, \ + YOU_ARE_TRYING_TO_USE_AN_INDEX_BASED_ACCESSOR_ON_AN_EXPRESSION_THAT_DOES_NOT_SUPPORT_THAT) + +namespace Eigen { + +/** \ingroup Core_Module + * + * \brief Base class for dense Map and Block expression with direct access + * + * This base class provides the const low-level accessors (e.g. coeff, coeffRef) of dense + * Map and Block objects with direct access. + * Typical users do not have to directly deal with this class. + * + * This class can be extended by through the macro plugin \c EIGEN_MAPBASE_PLUGIN. + * See \link TopicCustomizing_Plugins customizing Eigen \endlink for details. + * + * The \c Derived class has to provide the following two methods describing the memory layout: + * \code Index innerStride() const; \endcode + * \code Index outerStride() const; \endcode + * + * \sa class Map, class Block + */ +template class MapBase + : public internal::dense_xpr_base::type +{ + public: + + typedef typename internal::dense_xpr_base::type Base; + enum { + RowsAtCompileTime = internal::traits::RowsAtCompileTime, + ColsAtCompileTime = internal::traits::ColsAtCompileTime, + InnerStrideAtCompileTime = internal::traits::InnerStrideAtCompileTime, + SizeAtCompileTime = Base::SizeAtCompileTime + }; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + typedef typename internal::conditional< + bool(internal::is_lvalue::value), + Scalar *, + const Scalar *>::type + PointerType; + + using Base::derived; +// using Base::RowsAtCompileTime; +// using Base::ColsAtCompileTime; +// using Base::SizeAtCompileTime; + using Base::MaxRowsAtCompileTime; + using Base::MaxColsAtCompileTime; + using Base::MaxSizeAtCompileTime; + using Base::IsVectorAtCompileTime; + using Base::Flags; + using Base::IsRowMajor; + + using Base::rows; + using Base::cols; + using Base::size; + using Base::coeff; + using Base::coeffRef; + using Base::lazyAssign; + using Base::eval; + + using Base::innerStride; + using Base::outerStride; + using Base::rowStride; + using Base::colStride; + + // bug 217 - compile error on ICC 11.1 + using Base::operator=; + + typedef typename Base::CoeffReturnType CoeffReturnType; + + /** \copydoc DenseBase::rows() */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return m_rows.value(); } + /** \copydoc DenseBase::cols() */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return m_cols.value(); } + + /** Returns a pointer to the first coefficient of the matrix or vector. + * + * \note When addressing this data, make sure to honor the strides returned by innerStride() and outerStride(). + * + * \sa innerStride(), outerStride() + */ + EIGEN_DEVICE_FUNC inline const Scalar* data() const { return m_data; } + + /** \copydoc PlainObjectBase::coeff(Index,Index) const */ + EIGEN_DEVICE_FUNC + inline const Scalar& coeff(Index rowId, Index colId) const + { + return m_data[colId * colStride() + rowId * rowStride()]; + } + + /** \copydoc PlainObjectBase::coeff(Index) const */ + EIGEN_DEVICE_FUNC + inline const Scalar& coeff(Index index) const + { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + return m_data[index * innerStride()]; + } + + /** \copydoc PlainObjectBase::coeffRef(Index,Index) const */ + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index rowId, Index colId) const + { + return this->m_data[colId * colStride() + rowId * rowStride()]; + } + + /** \copydoc PlainObjectBase::coeffRef(Index) const */ + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index index) const + { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + return this->m_data[index * innerStride()]; + } + + /** \internal */ + template + inline PacketScalar packet(Index rowId, Index colId) const + { + return internal::ploadt + (m_data + (colId * colStride() + rowId * rowStride())); + } + + /** \internal */ + template + inline PacketScalar packet(Index index) const + { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + return internal::ploadt(m_data + index * innerStride()); + } + + /** \internal Constructor for fixed size matrices or vectors */ + EIGEN_DEVICE_FUNC + explicit inline MapBase(PointerType dataPtr) : m_data(dataPtr), m_rows(RowsAtCompileTime), m_cols(ColsAtCompileTime) + { + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + checkSanity(); + } + + /** \internal Constructor for dynamically sized vectors */ + EIGEN_DEVICE_FUNC + inline MapBase(PointerType dataPtr, Index vecSize) + : m_data(dataPtr), + m_rows(RowsAtCompileTime == Dynamic ? vecSize : Index(RowsAtCompileTime)), + m_cols(ColsAtCompileTime == Dynamic ? vecSize : Index(ColsAtCompileTime)) + { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + eigen_assert(vecSize >= 0); + eigen_assert(dataPtr == 0 || SizeAtCompileTime == Dynamic || SizeAtCompileTime == vecSize); + checkSanity(); + } + + /** \internal Constructor for dynamically sized matrices */ + EIGEN_DEVICE_FUNC + inline MapBase(PointerType dataPtr, Index rows, Index cols) + : m_data(dataPtr), m_rows(rows), m_cols(cols) + { + eigen_assert( (dataPtr == 0) + || ( rows >= 0 && (RowsAtCompileTime == Dynamic || RowsAtCompileTime == rows) + && cols >= 0 && (ColsAtCompileTime == Dynamic || ColsAtCompileTime == cols))); + checkSanity(); + } + + #ifdef EIGEN_MAPBASE_PLUGIN + #include EIGEN_MAPBASE_PLUGIN + #endif + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(MapBase) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(MapBase) + + template + EIGEN_DEVICE_FUNC + void checkSanity(typename internal::enable_if<(internal::traits::Alignment>0),void*>::type = 0) const + { +#if EIGEN_MAX_ALIGN_BYTES>0 + // innerStride() is not set yet when this function is called, so we optimistically assume the lowest plausible value: + const Index minInnerStride = InnerStrideAtCompileTime == Dynamic ? 1 : Index(InnerStrideAtCompileTime); + EIGEN_ONLY_USED_FOR_DEBUG(minInnerStride); + eigen_assert(( ((internal::UIntPtr(m_data) % internal::traits::Alignment) == 0) + || (cols() * rows() * minInnerStride * sizeof(Scalar)) < internal::traits::Alignment ) && "data is not aligned"); +#endif + } + + template + EIGEN_DEVICE_FUNC + void checkSanity(typename internal::enable_if::Alignment==0,void*>::type = 0) const + {} + + PointerType m_data; + const internal::variable_if_dynamic m_rows; + const internal::variable_if_dynamic m_cols; +}; + +/** \ingroup Core_Module + * + * \brief Base class for non-const dense Map and Block expression with direct access + * + * This base class provides the non-const low-level accessors (e.g. coeff and coeffRef) of + * dense Map and Block objects with direct access. + * It inherits MapBase which defines the const variant for reading specific entries. + * + * \sa class Map, class Block + */ +template class MapBase + : public MapBase +{ + typedef MapBase ReadOnlyMapBase; + public: + + typedef MapBase Base; + + typedef typename Base::Scalar Scalar; + typedef typename Base::PacketScalar PacketScalar; + typedef typename Base::StorageIndex StorageIndex; + typedef typename Base::PointerType PointerType; + + using Base::derived; + using Base::rows; + using Base::cols; + using Base::size; + using Base::coeff; + using Base::coeffRef; + + using Base::innerStride; + using Base::outerStride; + using Base::rowStride; + using Base::colStride; + + typedef typename internal::conditional< + internal::is_lvalue::value, + Scalar, + const Scalar + >::type ScalarWithConstIfNotLvalue; + + EIGEN_DEVICE_FUNC + inline const Scalar* data() const { return this->m_data; } + EIGEN_DEVICE_FUNC + inline ScalarWithConstIfNotLvalue* data() { return this->m_data; } // no const-cast here so non-const-correct code will give a compile error + + EIGEN_DEVICE_FUNC + inline ScalarWithConstIfNotLvalue& coeffRef(Index row, Index col) + { + return this->m_data[col * colStride() + row * rowStride()]; + } + + EIGEN_DEVICE_FUNC + inline ScalarWithConstIfNotLvalue& coeffRef(Index index) + { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + return this->m_data[index * innerStride()]; + } + + template + inline void writePacket(Index row, Index col, const PacketScalar& val) + { + internal::pstoret + (this->m_data + (col * colStride() + row * rowStride()), val); + } + + template + inline void writePacket(Index index, const PacketScalar& val) + { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + internal::pstoret + (this->m_data + index * innerStride(), val); + } + + EIGEN_DEVICE_FUNC explicit inline MapBase(PointerType dataPtr) : Base(dataPtr) {} + EIGEN_DEVICE_FUNC inline MapBase(PointerType dataPtr, Index vecSize) : Base(dataPtr, vecSize) {} + EIGEN_DEVICE_FUNC inline MapBase(PointerType dataPtr, Index rows, Index cols) : Base(dataPtr, rows, cols) {} + + EIGEN_DEVICE_FUNC + Derived& operator=(const MapBase& other) + { + ReadOnlyMapBase::Base::operator=(other); + return derived(); + } + + // In theory we could simply refer to Base:Base::operator=, but MSVC does not like Base::Base, + // see bugs 821 and 920. + using ReadOnlyMapBase::Base::operator=; + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(MapBase) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(MapBase) +}; + +#undef EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS + +} // end namespace Eigen + +#endif // EIGEN_MAPBASE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/MathFunctions.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/MathFunctions.h new file mode 100644 index 0000000..61b78f4 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/MathFunctions.h @@ -0,0 +1,2057 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2010 Benoit Jacob +// Copyright (c) 2021, NVIDIA CORPORATION. All rights reserved. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATHFUNCTIONS_H +#define EIGEN_MATHFUNCTIONS_H + +// TODO this should better be moved to NumTraits +// Source: WolframAlpha +#define EIGEN_PI 3.141592653589793238462643383279502884197169399375105820974944592307816406L +#define EIGEN_LOG2E 1.442695040888963407359924681001892137426645954152985934135449406931109219L +#define EIGEN_LN2 0.693147180559945309417232121458176568075500134360255254120680009493393621L + +namespace Eigen { + +// On WINCE, std::abs is defined for int only, so let's defined our own overloads: +// This issue has been confirmed with MSVC 2008 only, but the issue might exist for more recent versions too. +#if EIGEN_OS_WINCE && EIGEN_COMP_MSVC && EIGEN_COMP_MSVC<=1500 +long abs(long x) { return (labs(x)); } +double abs(double x) { return (fabs(x)); } +float abs(float x) { return (fabsf(x)); } +long double abs(long double x) { return (fabsl(x)); } +#endif + +namespace internal { + +/** \internal \class global_math_functions_filtering_base + * + * What it does: + * Defines a typedef 'type' as follows: + * - if type T has a member typedef Eigen_BaseClassForSpecializationOfGlobalMathFuncImpl, then + * global_math_functions_filtering_base::type is a typedef for it. + * - otherwise, global_math_functions_filtering_base::type is a typedef for T. + * + * How it's used: + * To allow to defined the global math functions (like sin...) in certain cases, like the Array expressions. + * When you do sin(array1+array2), the object array1+array2 has a complicated expression type, all what you want to know + * is that it inherits ArrayBase. So we implement a partial specialization of sin_impl for ArrayBase. + * So we must make sure to use sin_impl > and not sin_impl, otherwise our partial specialization + * won't be used. How does sin know that? That's exactly what global_math_functions_filtering_base tells it. + * + * How it's implemented: + * SFINAE in the style of enable_if. Highly susceptible of breaking compilers. With GCC, it sure does work, but if you replace + * the typename dummy by an integer template parameter, it doesn't work anymore! + */ + +template +struct global_math_functions_filtering_base +{ + typedef T type; +}; + +template struct always_void { typedef void type; }; + +template +struct global_math_functions_filtering_base + ::type + > +{ + typedef typename T::Eigen_BaseClassForSpecializationOfGlobalMathFuncImpl type; +}; + +#define EIGEN_MATHFUNC_IMPL(func, scalar) Eigen::internal::func##_impl::type> +#define EIGEN_MATHFUNC_RETVAL(func, scalar) typename Eigen::internal::func##_retval::type>::type + +/**************************************************************************** +* Implementation of real * +****************************************************************************/ + +template::IsComplex> +struct real_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + return x; + } +}; + +template +struct real_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + using std::real; + return real(x); + } +}; + +template struct real_impl : real_default_impl {}; + +#if defined(EIGEN_GPU_COMPILE_PHASE) +template +struct real_impl > +{ + typedef T RealScalar; + EIGEN_DEVICE_FUNC + static inline T run(const std::complex& x) + { + return x.real(); + } +}; +#endif + +template +struct real_retval +{ + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** +* Implementation of imag * +****************************************************************************/ + +template::IsComplex> +struct imag_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar&) + { + return RealScalar(0); + } +}; + +template +struct imag_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + using std::imag; + return imag(x); + } +}; + +template struct imag_impl : imag_default_impl {}; + +#if defined(EIGEN_GPU_COMPILE_PHASE) +template +struct imag_impl > +{ + typedef T RealScalar; + EIGEN_DEVICE_FUNC + static inline T run(const std::complex& x) + { + return x.imag(); + } +}; +#endif + +template +struct imag_retval +{ + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** +* Implementation of real_ref * +****************************************************************************/ + +template +struct real_ref_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar& run(Scalar& x) + { + return reinterpret_cast(&x)[0]; + } + EIGEN_DEVICE_FUNC + static inline const RealScalar& run(const Scalar& x) + { + return reinterpret_cast(&x)[0]; + } +}; + +template +struct real_ref_retval +{ + typedef typename NumTraits::Real & type; +}; + +/**************************************************************************** +* Implementation of imag_ref * +****************************************************************************/ + +template +struct imag_ref_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar& run(Scalar& x) + { + return reinterpret_cast(&x)[1]; + } + EIGEN_DEVICE_FUNC + static inline const RealScalar& run(const Scalar& x) + { + return reinterpret_cast(&x)[1]; + } +}; + +template +struct imag_ref_default_impl +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline Scalar run(Scalar&) + { + return Scalar(0); + } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline const Scalar run(const Scalar&) + { + return Scalar(0); + } +}; + +template +struct imag_ref_impl : imag_ref_default_impl::IsComplex> {}; + +template +struct imag_ref_retval +{ + typedef typename NumTraits::Real & type; +}; + +/**************************************************************************** +* Implementation of conj * +****************************************************************************/ + +template::IsComplex> +struct conj_default_impl +{ + EIGEN_DEVICE_FUNC + static inline Scalar run(const Scalar& x) + { + return x; + } +}; + +template +struct conj_default_impl +{ + EIGEN_DEVICE_FUNC + static inline Scalar run(const Scalar& x) + { + using std::conj; + return conj(x); + } +}; + +template::IsComplex> +struct conj_impl : conj_default_impl {}; + +template +struct conj_retval +{ + typedef Scalar type; +}; + +/**************************************************************************** +* Implementation of abs2 * +****************************************************************************/ + +template +struct abs2_impl_default +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + return x*x; + } +}; + +template +struct abs2_impl_default // IsComplex +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + return x.real()*x.real() + x.imag()*x.imag(); + } +}; + +template +struct abs2_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + return abs2_impl_default::IsComplex>::run(x); + } +}; + +template +struct abs2_retval +{ + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** +* Implementation of sqrt/rsqrt * +****************************************************************************/ + +template +struct sqrt_impl +{ + EIGEN_DEVICE_FUNC + static EIGEN_ALWAYS_INLINE Scalar run(const Scalar& x) + { + EIGEN_USING_STD(sqrt); + return sqrt(x); + } +}; + +// Complex sqrt defined in MathFunctionsImpl.h. +template EIGEN_DEVICE_FUNC std::complex complex_sqrt(const std::complex& a_x); + +// Custom implementation is faster than `std::sqrt`, works on +// GPU, and correctly handles special cases (unlike MSVC). +template +struct sqrt_impl > +{ + EIGEN_DEVICE_FUNC + static EIGEN_ALWAYS_INLINE std::complex run(const std::complex& x) + { + return complex_sqrt(x); + } +}; + +template +struct sqrt_retval +{ + typedef Scalar type; +}; + +// Default implementation relies on numext::sqrt, at bottom of file. +template +struct rsqrt_impl; + +// Complex rsqrt defined in MathFunctionsImpl.h. +template EIGEN_DEVICE_FUNC std::complex complex_rsqrt(const std::complex& a_x); + +template +struct rsqrt_impl > +{ + EIGEN_DEVICE_FUNC + static EIGEN_ALWAYS_INLINE std::complex run(const std::complex& x) + { + return complex_rsqrt(x); + } +}; + +template +struct rsqrt_retval +{ + typedef Scalar type; +}; + +/**************************************************************************** +* Implementation of norm1 * +****************************************************************************/ + +template +struct norm1_default_impl; + +template +struct norm1_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + EIGEN_USING_STD(abs); + return abs(x.real()) + abs(x.imag()); + } +}; + +template +struct norm1_default_impl +{ + EIGEN_DEVICE_FUNC + static inline Scalar run(const Scalar& x) + { + EIGEN_USING_STD(abs); + return abs(x); + } +}; + +template +struct norm1_impl : norm1_default_impl::IsComplex> {}; + +template +struct norm1_retval +{ + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** +* Implementation of hypot * +****************************************************************************/ + +template struct hypot_impl; + +template +struct hypot_retval +{ + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** +* Implementation of cast * +****************************************************************************/ + +template +struct cast_impl +{ + EIGEN_DEVICE_FUNC + static inline NewType run(const OldType& x) + { + return static_cast(x); + } +}; + +// Casting from S -> Complex leads to an implicit conversion from S to T, +// generating warnings on clang. Here we explicitly cast the real component. +template +struct cast_impl::IsComplex && NumTraits::IsComplex + >::type> +{ + EIGEN_DEVICE_FUNC + static inline NewType run(const OldType& x) + { + typedef typename NumTraits::Real NewReal; + return static_cast(static_cast(x)); + } +}; + +// here, for once, we're plainly returning NewType: we don't want cast to do weird things. + +template +EIGEN_DEVICE_FUNC +inline NewType cast(const OldType& x) +{ + return cast_impl::run(x); +} + +/**************************************************************************** +* Implementation of round * +****************************************************************************/ + +template +struct round_impl +{ + EIGEN_DEVICE_FUNC + static inline Scalar run(const Scalar& x) + { + EIGEN_STATIC_ASSERT((!NumTraits::IsComplex), NUMERIC_TYPE_MUST_BE_REAL) +#if EIGEN_HAS_CXX11_MATH + EIGEN_USING_STD(round); +#endif + return Scalar(round(x)); + } +}; + +#if !EIGEN_HAS_CXX11_MATH +#if EIGEN_HAS_C99_MATH +// Use ::roundf for float. +template<> +struct round_impl { + EIGEN_DEVICE_FUNC + static inline float run(const float& x) + { + return ::roundf(x); + } +}; +#else +template +struct round_using_floor_ceil_impl +{ + EIGEN_DEVICE_FUNC + static inline Scalar run(const Scalar& x) + { + EIGEN_STATIC_ASSERT((!NumTraits::IsComplex), NUMERIC_TYPE_MUST_BE_REAL) + // Without C99 round/roundf, resort to floor/ceil. + EIGEN_USING_STD(floor); + EIGEN_USING_STD(ceil); + // If not enough precision to resolve a decimal at all, return the input. + // Otherwise, adding 0.5 can trigger an increment by 1. + const Scalar limit = Scalar(1ull << (NumTraits::digits() - 1)); + if (x >= limit || x <= -limit) { + return x; + } + return (x > Scalar(0)) ? Scalar(floor(x + Scalar(0.5))) : Scalar(ceil(x - Scalar(0.5))); + } +}; + +template<> +struct round_impl : round_using_floor_ceil_impl {}; + +template<> +struct round_impl : round_using_floor_ceil_impl {}; +#endif // EIGEN_HAS_C99_MATH +#endif // !EIGEN_HAS_CXX11_MATH + +template +struct round_retval +{ + typedef Scalar type; +}; + +/**************************************************************************** +* Implementation of rint * +****************************************************************************/ + +template +struct rint_impl { + EIGEN_DEVICE_FUNC + static inline Scalar run(const Scalar& x) + { + EIGEN_STATIC_ASSERT((!NumTraits::IsComplex), NUMERIC_TYPE_MUST_BE_REAL) +#if EIGEN_HAS_CXX11_MATH + EIGEN_USING_STD(rint); +#endif + return rint(x); + } +}; + +#if !EIGEN_HAS_CXX11_MATH +template<> +struct rint_impl { + EIGEN_DEVICE_FUNC + static inline double run(const double& x) + { + return ::rint(x); + } +}; +template<> +struct rint_impl { + EIGEN_DEVICE_FUNC + static inline float run(const float& x) + { + return ::rintf(x); + } +}; +#endif + +template +struct rint_retval +{ + typedef Scalar type; +}; + +/**************************************************************************** +* Implementation of arg * +****************************************************************************/ + +// Visual Studio 2017 has a bug where arg(float) returns 0 for negative inputs. +// This seems to be fixed in VS 2019. +#if EIGEN_HAS_CXX11_MATH && (!EIGEN_COMP_MSVC || EIGEN_COMP_MSVC >= 1920) +// std::arg is only defined for types of std::complex, or integer types or float/double/long double +template::IsComplex || is_integral::value + || is_same::value || is_same::value + || is_same::value > +struct arg_default_impl; + +template +struct arg_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + #if defined(EIGEN_HIP_DEVICE_COMPILE) + // HIP does not seem to have a native device side implementation for the math routine "arg" + using std::arg; + #else + EIGEN_USING_STD(arg); + #endif + return static_cast(arg(x)); + } +}; + +// Must be non-complex floating-point type (e.g. half/bfloat16). +template +struct arg_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + return (x < Scalar(0)) ? RealScalar(EIGEN_PI) : RealScalar(0); + } +}; +#else +template::IsComplex> +struct arg_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + return (x < RealScalar(0)) ? RealScalar(EIGEN_PI) : RealScalar(0); + } +}; + +template +struct arg_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + EIGEN_USING_STD(arg); + return arg(x); + } +}; +#endif +template struct arg_impl : arg_default_impl {}; + +template +struct arg_retval +{ + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** +* Implementation of expm1 * +****************************************************************************/ + +// This implementation is based on GSL Math's expm1. +namespace std_fallback { + // fallback expm1 implementation in case there is no expm1(Scalar) function in namespace of Scalar, + // or that there is no suitable std::expm1 function available. Implementation + // attributed to Kahan. See: http://www.plunk.org/~hatch/rightway.php. + template + EIGEN_DEVICE_FUNC inline Scalar expm1(const Scalar& x) { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + typedef typename NumTraits::Real RealScalar; + + EIGEN_USING_STD(exp); + Scalar u = exp(x); + if (numext::equal_strict(u, Scalar(1))) { + return x; + } + Scalar um1 = u - RealScalar(1); + if (numext::equal_strict(um1, Scalar(-1))) { + return RealScalar(-1); + } + + EIGEN_USING_STD(log); + Scalar logu = log(u); + return numext::equal_strict(u, logu) ? u : (u - RealScalar(1)) * x / logu; + } +} + +template +struct expm1_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& x) + { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + #if EIGEN_HAS_CXX11_MATH + using std::expm1; + #else + using std_fallback::expm1; + #endif + return expm1(x); + } +}; + +template +struct expm1_retval +{ + typedef Scalar type; +}; + +/**************************************************************************** +* Implementation of log * +****************************************************************************/ + +// Complex log defined in MathFunctionsImpl.h. +template EIGEN_DEVICE_FUNC std::complex complex_log(const std::complex& z); + +template +struct log_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& x) + { + EIGEN_USING_STD(log); + return static_cast(log(x)); + } +}; + +template +struct log_impl > { + EIGEN_DEVICE_FUNC static inline std::complex run(const std::complex& z) + { + return complex_log(z); + } +}; + +/**************************************************************************** +* Implementation of log1p * +****************************************************************************/ + +namespace std_fallback { + // fallback log1p implementation in case there is no log1p(Scalar) function in namespace of Scalar, + // or that there is no suitable std::log1p function available + template + EIGEN_DEVICE_FUNC inline Scalar log1p(const Scalar& x) { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + typedef typename NumTraits::Real RealScalar; + EIGEN_USING_STD(log); + Scalar x1p = RealScalar(1) + x; + Scalar log_1p = log_impl::run(x1p); + const bool is_small = numext::equal_strict(x1p, Scalar(1)); + const bool is_inf = numext::equal_strict(x1p, log_1p); + return (is_small || is_inf) ? x : x * (log_1p / (x1p - RealScalar(1))); + } +} + +template +struct log1p_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& x) + { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + #if EIGEN_HAS_CXX11_MATH + using std::log1p; + #else + using std_fallback::log1p; + #endif + return log1p(x); + } +}; + +// Specialization for complex types that are not supported by std::log1p. +template +struct log1p_impl > { + EIGEN_DEVICE_FUNC static inline std::complex run( + const std::complex& x) { + EIGEN_STATIC_ASSERT_NON_INTEGER(RealScalar) + return std_fallback::log1p(x); + } +}; + +template +struct log1p_retval +{ + typedef Scalar type; +}; + +/**************************************************************************** +* Implementation of pow * +****************************************************************************/ + +template::IsInteger&&NumTraits::IsInteger> +struct pow_impl +{ + //typedef Scalar retval; + typedef typename ScalarBinaryOpTraits >::ReturnType result_type; + static EIGEN_DEVICE_FUNC inline result_type run(const ScalarX& x, const ScalarY& y) + { + EIGEN_USING_STD(pow); + return pow(x, y); + } +}; + +template +struct pow_impl +{ + typedef ScalarX result_type; + static EIGEN_DEVICE_FUNC inline ScalarX run(ScalarX x, ScalarY y) + { + ScalarX res(1); + eigen_assert(!NumTraits::IsSigned || y >= 0); + if(y & 1) res *= x; + y >>= 1; + while(y) + { + x *= x; + if(y&1) res *= x; + y >>= 1; + } + return res; + } +}; + +/**************************************************************************** +* Implementation of random * +****************************************************************************/ + +template +struct random_default_impl {}; + +template +struct random_impl : random_default_impl::IsComplex, NumTraits::IsInteger> {}; + +template +struct random_retval +{ + typedef Scalar type; +}; + +template inline EIGEN_MATHFUNC_RETVAL(random, Scalar) random(const Scalar& x, const Scalar& y); +template inline EIGEN_MATHFUNC_RETVAL(random, Scalar) random(); + +template +struct random_default_impl +{ + static inline Scalar run(const Scalar& x, const Scalar& y) + { + return x + (y-x) * Scalar(std::rand()) / Scalar(RAND_MAX); + } + static inline Scalar run() + { + return run(Scalar(NumTraits::IsSigned ? -1 : 0), Scalar(1)); + } +}; + +enum { + meta_floor_log2_terminate, + meta_floor_log2_move_up, + meta_floor_log2_move_down, + meta_floor_log2_bogus +}; + +template struct meta_floor_log2_selector +{ + enum { middle = (lower + upper) / 2, + value = (upper <= lower + 1) ? int(meta_floor_log2_terminate) + : (n < (1 << middle)) ? int(meta_floor_log2_move_down) + : (n==0) ? int(meta_floor_log2_bogus) + : int(meta_floor_log2_move_up) + }; +}; + +template::value> +struct meta_floor_log2 {}; + +template +struct meta_floor_log2 +{ + enum { value = meta_floor_log2::middle>::value }; +}; + +template +struct meta_floor_log2 +{ + enum { value = meta_floor_log2::middle, upper>::value }; +}; + +template +struct meta_floor_log2 +{ + enum { value = (n >= ((unsigned int)(1) << (lower+1))) ? lower+1 : lower }; +}; + +template +struct meta_floor_log2 +{ + // no value, error at compile time +}; + +template +struct random_default_impl +{ + static inline Scalar run(const Scalar& x, const Scalar& y) + { + if (y <= x) + return x; + // ScalarU is the unsigned counterpart of Scalar, possibly Scalar itself. + typedef typename make_unsigned::type ScalarU; + // ScalarX is the widest of ScalarU and unsigned int. + // We'll deal only with ScalarX and unsigned int below thus avoiding signed + // types and arithmetic and signed overflows (which are undefined behavior). + typedef typename conditional<(ScalarU(-1) > unsigned(-1)), ScalarU, unsigned>::type ScalarX; + // The following difference doesn't overflow, provided our integer types are two's + // complement and have the same number of padding bits in signed and unsigned variants. + // This is the case in most modern implementations of C++. + ScalarX range = ScalarX(y) - ScalarX(x); + ScalarX offset = 0; + ScalarX divisor = 1; + ScalarX multiplier = 1; + const unsigned rand_max = RAND_MAX; + if (range <= rand_max) divisor = (rand_max + 1) / (range + 1); + else multiplier = 1 + range / (rand_max + 1); + // Rejection sampling. + do { + offset = (unsigned(std::rand()) * multiplier) / divisor; + } while (offset > range); + return Scalar(ScalarX(x) + offset); + } + + static inline Scalar run() + { +#ifdef EIGEN_MAKING_DOCS + return run(Scalar(NumTraits::IsSigned ? -10 : 0), Scalar(10)); +#else + enum { rand_bits = meta_floor_log2<(unsigned int)(RAND_MAX)+1>::value, + scalar_bits = sizeof(Scalar) * CHAR_BIT, + shift = EIGEN_PLAIN_ENUM_MAX(0, int(rand_bits) - int(scalar_bits)), + offset = NumTraits::IsSigned ? (1 << (EIGEN_PLAIN_ENUM_MIN(rand_bits,scalar_bits)-1)) : 0 + }; + return Scalar((std::rand() >> shift) - offset); +#endif + } +}; + +template +struct random_default_impl +{ + static inline Scalar run(const Scalar& x, const Scalar& y) + { + return Scalar(random(x.real(), y.real()), + random(x.imag(), y.imag())); + } + static inline Scalar run() + { + typedef typename NumTraits::Real RealScalar; + return Scalar(random(), random()); + } +}; + +template +inline EIGEN_MATHFUNC_RETVAL(random, Scalar) random(const Scalar& x, const Scalar& y) +{ + return EIGEN_MATHFUNC_IMPL(random, Scalar)::run(x, y); +} + +template +inline EIGEN_MATHFUNC_RETVAL(random, Scalar) random() +{ + return EIGEN_MATHFUNC_IMPL(random, Scalar)::run(); +} + +// Implementation of is* functions + +// std::is* do not work with fast-math and gcc, std::is* are available on MSVC 2013 and newer, as well as in clang. +#if (EIGEN_HAS_CXX11_MATH && !(EIGEN_COMP_GNUC_STRICT && __FINITE_MATH_ONLY__)) || (EIGEN_COMP_MSVC>=1800) || (EIGEN_COMP_CLANG) +#define EIGEN_USE_STD_FPCLASSIFY 1 +#else +#define EIGEN_USE_STD_FPCLASSIFY 0 +#endif + +template +EIGEN_DEVICE_FUNC +typename internal::enable_if::value,bool>::type +isnan_impl(const T&) { return false; } + +template +EIGEN_DEVICE_FUNC +typename internal::enable_if::value,bool>::type +isinf_impl(const T&) { return false; } + +template +EIGEN_DEVICE_FUNC +typename internal::enable_if::value,bool>::type +isfinite_impl(const T&) { return true; } + +template +EIGEN_DEVICE_FUNC +typename internal::enable_if<(!internal::is_integral::value)&&(!NumTraits::IsComplex),bool>::type +isfinite_impl(const T& x) +{ + #if defined(EIGEN_GPU_COMPILE_PHASE) + return (::isfinite)(x); + #elif EIGEN_USE_STD_FPCLASSIFY + using std::isfinite; + return isfinite EIGEN_NOT_A_MACRO (x); + #else + return x<=NumTraits::highest() && x>=NumTraits::lowest(); + #endif +} + +template +EIGEN_DEVICE_FUNC +typename internal::enable_if<(!internal::is_integral::value)&&(!NumTraits::IsComplex),bool>::type +isinf_impl(const T& x) +{ + #if defined(EIGEN_GPU_COMPILE_PHASE) + return (::isinf)(x); + #elif EIGEN_USE_STD_FPCLASSIFY + using std::isinf; + return isinf EIGEN_NOT_A_MACRO (x); + #else + return x>NumTraits::highest() || x::lowest(); + #endif +} + +template +EIGEN_DEVICE_FUNC +typename internal::enable_if<(!internal::is_integral::value)&&(!NumTraits::IsComplex),bool>::type +isnan_impl(const T& x) +{ + #if defined(EIGEN_GPU_COMPILE_PHASE) + return (::isnan)(x); + #elif EIGEN_USE_STD_FPCLASSIFY + using std::isnan; + return isnan EIGEN_NOT_A_MACRO (x); + #else + return x != x; + #endif +} + +#if (!EIGEN_USE_STD_FPCLASSIFY) + +#if EIGEN_COMP_MSVC + +template EIGEN_DEVICE_FUNC bool isinf_msvc_helper(T x) +{ + return _fpclass(x)==_FPCLASS_NINF || _fpclass(x)==_FPCLASS_PINF; +} + +//MSVC defines a _isnan builtin function, but for double only +EIGEN_DEVICE_FUNC inline bool isnan_impl(const long double& x) { return _isnan(x)!=0; } +EIGEN_DEVICE_FUNC inline bool isnan_impl(const double& x) { return _isnan(x)!=0; } +EIGEN_DEVICE_FUNC inline bool isnan_impl(const float& x) { return _isnan(x)!=0; } + +EIGEN_DEVICE_FUNC inline bool isinf_impl(const long double& x) { return isinf_msvc_helper(x); } +EIGEN_DEVICE_FUNC inline bool isinf_impl(const double& x) { return isinf_msvc_helper(x); } +EIGEN_DEVICE_FUNC inline bool isinf_impl(const float& x) { return isinf_msvc_helper(x); } + +#elif (defined __FINITE_MATH_ONLY__ && __FINITE_MATH_ONLY__ && EIGEN_COMP_GNUC) + +#if EIGEN_GNUC_AT_LEAST(5,0) + #define EIGEN_TMP_NOOPT_ATTRIB EIGEN_DEVICE_FUNC inline __attribute__((optimize("no-finite-math-only"))) +#else + // NOTE the inline qualifier and noinline attribute are both needed: the former is to avoid linking issue (duplicate symbol), + // while the second prevent too aggressive optimizations in fast-math mode: + #define EIGEN_TMP_NOOPT_ATTRIB EIGEN_DEVICE_FUNC inline __attribute__((noinline,optimize("no-finite-math-only"))) +#endif + +template<> EIGEN_TMP_NOOPT_ATTRIB bool isnan_impl(const long double& x) { return __builtin_isnan(x); } +template<> EIGEN_TMP_NOOPT_ATTRIB bool isnan_impl(const double& x) { return __builtin_isnan(x); } +template<> EIGEN_TMP_NOOPT_ATTRIB bool isnan_impl(const float& x) { return __builtin_isnan(x); } +template<> EIGEN_TMP_NOOPT_ATTRIB bool isinf_impl(const double& x) { return __builtin_isinf(x); } +template<> EIGEN_TMP_NOOPT_ATTRIB bool isinf_impl(const float& x) { return __builtin_isinf(x); } +template<> EIGEN_TMP_NOOPT_ATTRIB bool isinf_impl(const long double& x) { return __builtin_isinf(x); } + +#undef EIGEN_TMP_NOOPT_ATTRIB + +#endif + +#endif + +// The following overload are defined at the end of this file +template EIGEN_DEVICE_FUNC bool isfinite_impl(const std::complex& x); +template EIGEN_DEVICE_FUNC bool isnan_impl(const std::complex& x); +template EIGEN_DEVICE_FUNC bool isinf_impl(const std::complex& x); + +template T generic_fast_tanh_float(const T& a_x); +} // end namespace internal + +/**************************************************************************** +* Generic math functions * +****************************************************************************/ + +namespace numext { + +#if (!defined(EIGEN_GPUCC) || defined(EIGEN_CONSTEXPR_ARE_DEVICE_FUNC)) +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE T mini(const T& x, const T& y) +{ + EIGEN_USING_STD(min) + return min EIGEN_NOT_A_MACRO (x,y); +} + +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE T maxi(const T& x, const T& y) +{ + EIGEN_USING_STD(max) + return max EIGEN_NOT_A_MACRO (x,y); +} +#else +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE T mini(const T& x, const T& y) +{ + return y < x ? y : x; +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE float mini(const float& x, const float& y) +{ + return fminf(x, y); +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE double mini(const double& x, const double& y) +{ + return fmin(x, y); +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE long double mini(const long double& x, const long double& y) +{ +#if defined(EIGEN_HIPCC) + // no "fminl" on HIP yet + return (x < y) ? x : y; +#else + return fminl(x, y); +#endif +} + +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE T maxi(const T& x, const T& y) +{ + return x < y ? y : x; +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE float maxi(const float& x, const float& y) +{ + return fmaxf(x, y); +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE double maxi(const double& x, const double& y) +{ + return fmax(x, y); +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE long double maxi(const long double& x, const long double& y) +{ +#if defined(EIGEN_HIPCC) + // no "fmaxl" on HIP yet + return (x > y) ? x : y; +#else + return fmaxl(x, y); +#endif +} +#endif + +#if defined(SYCL_DEVICE_ONLY) + + +#define SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_char) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_short) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_int) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_long) +#define SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_char) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_short) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_int) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_long) +#define SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_uchar) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_ushort) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_uint) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_ulong) +#define SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_uchar) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_ushort) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_uint) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_ulong) +#define SYCL_SPECIALIZE_INTEGER_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_BINARY(NAME, FUNC) +#define SYCL_SPECIALIZE_INTEGER_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_UNARY(NAME, FUNC) +#define SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_float) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC,cl::sycl::cl_double) +#define SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_float) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC,cl::sycl::cl_double) +#define SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE(NAME, FUNC, RET_TYPE) \ + SYCL_SPECIALIZE_GEN_UNARY_FUNC(NAME, FUNC, RET_TYPE, cl::sycl::cl_float) \ + SYCL_SPECIALIZE_GEN_UNARY_FUNC(NAME, FUNC, RET_TYPE, cl::sycl::cl_double) + +#define SYCL_SPECIALIZE_GEN_UNARY_FUNC(NAME, FUNC, RET_TYPE, ARG_TYPE) \ +template<> \ + EIGEN_DEVICE_FUNC \ + EIGEN_ALWAYS_INLINE RET_TYPE NAME(const ARG_TYPE& x) { \ + return cl::sycl::FUNC(x); \ + } + +#define SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, TYPE) \ + SYCL_SPECIALIZE_GEN_UNARY_FUNC(NAME, FUNC, TYPE, TYPE) + +#define SYCL_SPECIALIZE_GEN1_BINARY_FUNC(NAME, FUNC, RET_TYPE, ARG_TYPE1, ARG_TYPE2) \ + template<> \ + EIGEN_DEVICE_FUNC \ + EIGEN_ALWAYS_INLINE RET_TYPE NAME(const ARG_TYPE1& x, const ARG_TYPE2& y) { \ + return cl::sycl::FUNC(x, y); \ + } + +#define SYCL_SPECIALIZE_GEN2_BINARY_FUNC(NAME, FUNC, RET_TYPE, ARG_TYPE) \ + SYCL_SPECIALIZE_GEN1_BINARY_FUNC(NAME, FUNC, RET_TYPE, ARG_TYPE, ARG_TYPE) + +#define SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, TYPE) \ + SYCL_SPECIALIZE_GEN2_BINARY_FUNC(NAME, FUNC, TYPE, TYPE) + +SYCL_SPECIALIZE_INTEGER_TYPES_BINARY(mini, min) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(mini, fmin) +SYCL_SPECIALIZE_INTEGER_TYPES_BINARY(maxi, max) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(maxi, fmax) + +#endif + + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(real, Scalar) real(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(real, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline typename internal::add_const_on_value_type< EIGEN_MATHFUNC_RETVAL(real_ref, Scalar) >::type real_ref(const Scalar& x) +{ + return internal::real_ref_impl::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(real_ref, Scalar) real_ref(Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(real_ref, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(imag, Scalar) imag(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(imag, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(arg, Scalar) arg(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(arg, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline typename internal::add_const_on_value_type< EIGEN_MATHFUNC_RETVAL(imag_ref, Scalar) >::type imag_ref(const Scalar& x) +{ + return internal::imag_ref_impl::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(imag_ref, Scalar) imag_ref(Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(imag_ref, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(conj, Scalar) conj(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(conj, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(abs2, Scalar) abs2(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(abs2, Scalar)::run(x); +} + +EIGEN_DEVICE_FUNC +inline bool abs2(bool x) { return x; } + +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE T absdiff(const T& x, const T& y) +{ + return x > y ? x - y : y - x; +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE float absdiff(const float& x, const float& y) +{ + return fabsf(x - y); +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE double absdiff(const double& x, const double& y) +{ + return fabs(x - y); +} + +#if !defined(EIGEN_GPUCC) +// HIP and CUDA do not support long double. +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE long double absdiff(const long double& x, const long double& y) { + return fabsl(x - y); +} +#endif + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(norm1, Scalar) norm1(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(norm1, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(hypot, Scalar) hypot(const Scalar& x, const Scalar& y) +{ + return EIGEN_MATHFUNC_IMPL(hypot, Scalar)::run(x, y); +} + +#if defined(SYCL_DEVICE_ONLY) + SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(hypot, hypot) +#endif + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(log1p, Scalar) log1p(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(log1p, Scalar)::run(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(log1p, log1p) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float log1p(const float &x) { return ::log1pf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double log1p(const double &x) { return ::log1p(x); } +#endif + +template +EIGEN_DEVICE_FUNC +inline typename internal::pow_impl::result_type pow(const ScalarX& x, const ScalarY& y) +{ + return internal::pow_impl::run(x, y); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(pow, pow) +#endif + +template EIGEN_DEVICE_FUNC bool (isnan) (const T &x) { return internal::isnan_impl(x); } +template EIGEN_DEVICE_FUNC bool (isinf) (const T &x) { return internal::isinf_impl(x); } +template EIGEN_DEVICE_FUNC bool (isfinite)(const T &x) { return internal::isfinite_impl(x); } + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE(isnan, isnan, bool) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE(isinf, isinf, bool) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE(isfinite, isfinite, bool) +#endif + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(rint, Scalar) rint(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(rint, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(round, Scalar) round(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(round, Scalar)::run(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(round, round) +#endif + +template +EIGEN_DEVICE_FUNC +T (floor)(const T& x) +{ + EIGEN_USING_STD(floor) + return floor(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(floor, floor) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float floor(const float &x) { return ::floorf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double floor(const double &x) { return ::floor(x); } +#endif + +template +EIGEN_DEVICE_FUNC +T (ceil)(const T& x) +{ + EIGEN_USING_STD(ceil); + return ceil(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(ceil, ceil) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float ceil(const float &x) { return ::ceilf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double ceil(const double &x) { return ::ceil(x); } +#endif + + +/** Log base 2 for 32 bits positive integers. + * Conveniently returns 0 for x==0. */ +inline int log2(int x) +{ + eigen_assert(x>=0); + unsigned int v(x); + static const int table[32] = { 0, 9, 1, 10, 13, 21, 2, 29, 11, 14, 16, 18, 22, 25, 3, 30, 8, 12, 20, 28, 15, 17, 24, 7, 19, 27, 23, 6, 26, 5, 4, 31 }; + v |= v >> 1; + v |= v >> 2; + v |= v >> 4; + v |= v >> 8; + v |= v >> 16; + return table[(v * 0x07C4ACDDU) >> 27]; +} + +/** \returns the square root of \a x. + * + * It is essentially equivalent to + * \code using std::sqrt; return sqrt(x); \endcode + * but slightly faster for float/double and some compilers (e.g., gcc), thanks to + * specializations when SSE is enabled. + * + * It's usage is justified in performance critical functions, like norm/normalize. + */ +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE EIGEN_MATHFUNC_RETVAL(sqrt, Scalar) sqrt(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(sqrt, Scalar)::run(x); +} + +// Boolean specialization, avoids implicit float to bool conversion (-Wimplicit-conversion-floating-point-to-bool). +template<> +EIGEN_DEFINE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS EIGEN_DEVICE_FUNC +bool sqrt(const bool &x) { return x; } + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(sqrt, sqrt) +#endif + +/** \returns the reciprocal square root of \a x. **/ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T rsqrt(const T& x) +{ + return internal::rsqrt_impl::run(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T log(const T &x) { + return internal::log_impl::run(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(log, log) +#endif + + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float log(const float &x) { return ::logf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double log(const double &x) { return ::log(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +typename internal::enable_if::IsSigned || NumTraits::IsComplex,typename NumTraits::Real>::type +abs(const T &x) { + EIGEN_USING_STD(abs); + return abs(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +typename internal::enable_if::IsSigned || NumTraits::IsComplex),typename NumTraits::Real>::type +abs(const T &x) { + return x; +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_INTEGER_TYPES_UNARY(abs, abs) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(abs, fabs) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float abs(const float &x) { return ::fabsf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double abs(const double &x) { return ::fabs(x); } + +template <> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float abs(const std::complex& x) { + return ::hypotf(x.real(), x.imag()); +} + +template <> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double abs(const std::complex& x) { + return ::hypot(x.real(), x.imag()); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T exp(const T &x) { + EIGEN_USING_STD(exp); + return exp(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(exp, exp) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float exp(const float &x) { return ::expf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double exp(const double &x) { return ::exp(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +std::complex exp(const std::complex& x) { + float com = ::expf(x.real()); + float res_real = com * ::cosf(x.imag()); + float res_imag = com * ::sinf(x.imag()); + return std::complex(res_real, res_imag); +} + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +std::complex exp(const std::complex& x) { + double com = ::exp(x.real()); + double res_real = com * ::cos(x.imag()); + double res_imag = com * ::sin(x.imag()); + return std::complex(res_real, res_imag); +} +#endif + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(expm1, Scalar) expm1(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(expm1, Scalar)::run(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(expm1, expm1) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float expm1(const float &x) { return ::expm1f(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double expm1(const double &x) { return ::expm1(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T cos(const T &x) { + EIGEN_USING_STD(cos); + return cos(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(cos,cos) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float cos(const float &x) { return ::cosf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double cos(const double &x) { return ::cos(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T sin(const T &x) { + EIGEN_USING_STD(sin); + return sin(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(sin, sin) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float sin(const float &x) { return ::sinf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double sin(const double &x) { return ::sin(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T tan(const T &x) { + EIGEN_USING_STD(tan); + return tan(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(tan, tan) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float tan(const float &x) { return ::tanf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double tan(const double &x) { return ::tan(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T acos(const T &x) { + EIGEN_USING_STD(acos); + return acos(x); +} + +#if EIGEN_HAS_CXX11_MATH +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T acosh(const T &x) { + EIGEN_USING_STD(acosh); + return static_cast(acosh(x)); +} +#endif + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(acos, acos) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(acosh, acosh) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float acos(const float &x) { return ::acosf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double acos(const double &x) { return ::acos(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T asin(const T &x) { + EIGEN_USING_STD(asin); + return asin(x); +} + +#if EIGEN_HAS_CXX11_MATH +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T asinh(const T &x) { + EIGEN_USING_STD(asinh); + return static_cast(asinh(x)); +} +#endif + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(asin, asin) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(asinh, asinh) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float asin(const float &x) { return ::asinf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double asin(const double &x) { return ::asin(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T atan(const T &x) { + EIGEN_USING_STD(atan); + return static_cast(atan(x)); +} + +#if EIGEN_HAS_CXX11_MATH +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T atanh(const T &x) { + EIGEN_USING_STD(atanh); + return static_cast(atanh(x)); +} +#endif + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(atan, atan) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(atanh, atanh) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float atan(const float &x) { return ::atanf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double atan(const double &x) { return ::atan(x); } +#endif + + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T cosh(const T &x) { + EIGEN_USING_STD(cosh); + return static_cast(cosh(x)); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(cosh, cosh) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float cosh(const float &x) { return ::coshf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double cosh(const double &x) { return ::cosh(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T sinh(const T &x) { + EIGEN_USING_STD(sinh); + return static_cast(sinh(x)); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(sinh, sinh) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float sinh(const float &x) { return ::sinhf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double sinh(const double &x) { return ::sinh(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T tanh(const T &x) { + EIGEN_USING_STD(tanh); + return tanh(x); +} + +#if (!defined(EIGEN_GPUCC)) && EIGEN_FAST_MATH && !defined(SYCL_DEVICE_ONLY) +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float tanh(float x) { return internal::generic_fast_tanh_float(x); } +#endif + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(tanh, tanh) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float tanh(const float &x) { return ::tanhf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double tanh(const double &x) { return ::tanh(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T fmod(const T& a, const T& b) { + EIGEN_USING_STD(fmod); + return fmod(a, b); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(fmod, fmod) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float fmod(const float& a, const float& b) { + return ::fmodf(a, b); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double fmod(const double& a, const double& b) { + return ::fmod(a, b); +} +#endif + +#if defined(SYCL_DEVICE_ONLY) +#undef SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_BINARY +#undef SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_UNARY +#undef SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_BINARY +#undef SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_UNARY +#undef SYCL_SPECIALIZE_INTEGER_TYPES_BINARY +#undef SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_UNARY +#undef SYCL_SPECIALIZE_FLOATING_TYPES_BINARY +#undef SYCL_SPECIALIZE_FLOATING_TYPES_UNARY +#undef SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE +#undef SYCL_SPECIALIZE_GEN_UNARY_FUNC +#undef SYCL_SPECIALIZE_UNARY_FUNC +#undef SYCL_SPECIALIZE_GEN1_BINARY_FUNC +#undef SYCL_SPECIALIZE_GEN2_BINARY_FUNC +#undef SYCL_SPECIALIZE_BINARY_FUNC +#endif + +} // end namespace numext + +namespace internal { + +template +EIGEN_DEVICE_FUNC bool isfinite_impl(const std::complex& x) +{ + return (numext::isfinite)(numext::real(x)) && (numext::isfinite)(numext::imag(x)); +} + +template +EIGEN_DEVICE_FUNC bool isnan_impl(const std::complex& x) +{ + return (numext::isnan)(numext::real(x)) || (numext::isnan)(numext::imag(x)); +} + +template +EIGEN_DEVICE_FUNC bool isinf_impl(const std::complex& x) +{ + return ((numext::isinf)(numext::real(x)) || (numext::isinf)(numext::imag(x))) && (!(numext::isnan)(x)); +} + +/**************************************************************************** +* Implementation of fuzzy comparisons * +****************************************************************************/ + +template +struct scalar_fuzzy_default_impl {}; + +template +struct scalar_fuzzy_default_impl +{ + typedef typename NumTraits::Real RealScalar; + template EIGEN_DEVICE_FUNC + static inline bool isMuchSmallerThan(const Scalar& x, const OtherScalar& y, const RealScalar& prec) + { + return numext::abs(x) <= numext::abs(y) * prec; + } + EIGEN_DEVICE_FUNC + static inline bool isApprox(const Scalar& x, const Scalar& y, const RealScalar& prec) + { + return numext::abs(x - y) <= numext::mini(numext::abs(x), numext::abs(y)) * prec; + } + EIGEN_DEVICE_FUNC + static inline bool isApproxOrLessThan(const Scalar& x, const Scalar& y, const RealScalar& prec) + { + return x <= y || isApprox(x, y, prec); + } +}; + +template +struct scalar_fuzzy_default_impl +{ + typedef typename NumTraits::Real RealScalar; + template EIGEN_DEVICE_FUNC + static inline bool isMuchSmallerThan(const Scalar& x, const Scalar&, const RealScalar&) + { + return x == Scalar(0); + } + EIGEN_DEVICE_FUNC + static inline bool isApprox(const Scalar& x, const Scalar& y, const RealScalar&) + { + return x == y; + } + EIGEN_DEVICE_FUNC + static inline bool isApproxOrLessThan(const Scalar& x, const Scalar& y, const RealScalar&) + { + return x <= y; + } +}; + +template +struct scalar_fuzzy_default_impl +{ + typedef typename NumTraits::Real RealScalar; + template EIGEN_DEVICE_FUNC + static inline bool isMuchSmallerThan(const Scalar& x, const OtherScalar& y, const RealScalar& prec) + { + return numext::abs2(x) <= numext::abs2(y) * prec * prec; + } + EIGEN_DEVICE_FUNC + static inline bool isApprox(const Scalar& x, const Scalar& y, const RealScalar& prec) + { + return numext::abs2(x - y) <= numext::mini(numext::abs2(x), numext::abs2(y)) * prec * prec; + } +}; + +template +struct scalar_fuzzy_impl : scalar_fuzzy_default_impl::IsComplex, NumTraits::IsInteger> {}; + +template EIGEN_DEVICE_FUNC +inline bool isMuchSmallerThan(const Scalar& x, const OtherScalar& y, + const typename NumTraits::Real &precision = NumTraits::dummy_precision()) +{ + return scalar_fuzzy_impl::template isMuchSmallerThan(x, y, precision); +} + +template EIGEN_DEVICE_FUNC +inline bool isApprox(const Scalar& x, const Scalar& y, + const typename NumTraits::Real &precision = NumTraits::dummy_precision()) +{ + return scalar_fuzzy_impl::isApprox(x, y, precision); +} + +template EIGEN_DEVICE_FUNC +inline bool isApproxOrLessThan(const Scalar& x, const Scalar& y, + const typename NumTraits::Real &precision = NumTraits::dummy_precision()) +{ + return scalar_fuzzy_impl::isApproxOrLessThan(x, y, precision); +} + +/****************************************** +*** The special case of the bool type *** +******************************************/ + +template<> struct random_impl +{ + static inline bool run() + { + return random(0,1)==0 ? false : true; + } + + static inline bool run(const bool& a, const bool& b) + { + return random(a, b)==0 ? false : true; + } +}; + +template<> struct scalar_fuzzy_impl +{ + typedef bool RealScalar; + + template EIGEN_DEVICE_FUNC + static inline bool isMuchSmallerThan(const bool& x, const bool&, const bool&) + { + return !x; + } + + EIGEN_DEVICE_FUNC + static inline bool isApprox(bool x, bool y, bool) + { + return x == y; + } + + EIGEN_DEVICE_FUNC + static inline bool isApproxOrLessThan(const bool& x, const bool& y, const bool&) + { + return (!x) || y; + } + +}; + +} // end namespace internal + +// Default implementations that rely on other numext implementations +namespace internal { + +// Specialization for complex types that are not supported by std::expm1. +template +struct expm1_impl > { + EIGEN_DEVICE_FUNC static inline std::complex run( + const std::complex& x) { + EIGEN_STATIC_ASSERT_NON_INTEGER(RealScalar) + RealScalar xr = x.real(); + RealScalar xi = x.imag(); + // expm1(z) = exp(z) - 1 + // = exp(x + i * y) - 1 + // = exp(x) * (cos(y) + i * sin(y)) - 1 + // = exp(x) * cos(y) - 1 + i * exp(x) * sin(y) + // Imag(expm1(z)) = exp(x) * sin(y) + // Real(expm1(z)) = exp(x) * cos(y) - 1 + // = exp(x) * cos(y) - 1. + // = expm1(x) + exp(x) * (cos(y) - 1) + // = expm1(x) + exp(x) * (2 * sin(y / 2) ** 2) + RealScalar erm1 = numext::expm1(xr); + RealScalar er = erm1 + RealScalar(1.); + RealScalar sin2 = numext::sin(xi / RealScalar(2.)); + sin2 = sin2 * sin2; + RealScalar s = numext::sin(xi); + RealScalar real_part = erm1 - RealScalar(2.) * er * sin2; + return std::complex(real_part, er * s); + } +}; + +template +struct rsqrt_impl { + EIGEN_DEVICE_FUNC + static EIGEN_ALWAYS_INLINE T run(const T& x) { + return T(1)/numext::sqrt(x); + } +}; + +#if defined(EIGEN_GPU_COMPILE_PHASE) +template +struct conj_impl, true> +{ + EIGEN_DEVICE_FUNC + static inline std::complex run(const std::complex& x) + { + return std::complex(numext::real(x), -numext::imag(x)); + } +}; +#endif + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_MATHFUNCTIONS_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/MathFunctionsImpl.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/MathFunctionsImpl.h new file mode 100644 index 0000000..4eaaaa7 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/MathFunctionsImpl.h @@ -0,0 +1,200 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2014 Pedro Gonnet (pedro.gonnet@gmail.com) +// Copyright (C) 2016 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATHFUNCTIONSIMPL_H +#define EIGEN_MATHFUNCTIONSIMPL_H + +namespace Eigen { + +namespace internal { + +/** \internal \returns the hyperbolic tan of \a a (coeff-wise) + Doesn't do anything fancy, just a 13/6-degree rational interpolant which + is accurate up to a couple of ulps in the (approximate) range [-8, 8], + outside of which tanh(x) = +/-1 in single precision. The input is clamped + to the range [-c, c]. The value c is chosen as the smallest value where + the approximation evaluates to exactly 1. In the reange [-0.0004, 0.0004] + the approxmation tanh(x) ~= x is used for better accuracy as x tends to zero. + + This implementation works on both scalars and packets. +*/ +template +T generic_fast_tanh_float(const T& a_x) +{ + // Clamp the inputs to the range [-c, c] +#ifdef EIGEN_VECTORIZE_FMA + const T plus_clamp = pset1(7.99881172180175781f); + const T minus_clamp = pset1(-7.99881172180175781f); +#else + const T plus_clamp = pset1(7.90531110763549805f); + const T minus_clamp = pset1(-7.90531110763549805f); +#endif + const T tiny = pset1(0.0004f); + const T x = pmax(pmin(a_x, plus_clamp), minus_clamp); + const T tiny_mask = pcmp_lt(pabs(a_x), tiny); + // The monomial coefficients of the numerator polynomial (odd). + const T alpha_1 = pset1(4.89352455891786e-03f); + const T alpha_3 = pset1(6.37261928875436e-04f); + const T alpha_5 = pset1(1.48572235717979e-05f); + const T alpha_7 = pset1(5.12229709037114e-08f); + const T alpha_9 = pset1(-8.60467152213735e-11f); + const T alpha_11 = pset1(2.00018790482477e-13f); + const T alpha_13 = pset1(-2.76076847742355e-16f); + + // The monomial coefficients of the denominator polynomial (even). + const T beta_0 = pset1(4.89352518554385e-03f); + const T beta_2 = pset1(2.26843463243900e-03f); + const T beta_4 = pset1(1.18534705686654e-04f); + const T beta_6 = pset1(1.19825839466702e-06f); + + // Since the polynomials are odd/even, we need x^2. + const T x2 = pmul(x, x); + + // Evaluate the numerator polynomial p. + T p = pmadd(x2, alpha_13, alpha_11); + p = pmadd(x2, p, alpha_9); + p = pmadd(x2, p, alpha_7); + p = pmadd(x2, p, alpha_5); + p = pmadd(x2, p, alpha_3); + p = pmadd(x2, p, alpha_1); + p = pmul(x, p); + + // Evaluate the denominator polynomial q. + T q = pmadd(x2, beta_6, beta_4); + q = pmadd(x2, q, beta_2); + q = pmadd(x2, q, beta_0); + + // Divide the numerator by the denominator. + return pselect(tiny_mask, x, pdiv(p, q)); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +RealScalar positive_real_hypot(const RealScalar& x, const RealScalar& y) +{ + // IEEE IEC 6059 special cases. + if ((numext::isinf)(x) || (numext::isinf)(y)) + return NumTraits::infinity(); + if ((numext::isnan)(x) || (numext::isnan)(y)) + return NumTraits::quiet_NaN(); + + EIGEN_USING_STD(sqrt); + RealScalar p, qp; + p = numext::maxi(x,y); + if(p==RealScalar(0)) return RealScalar(0); + qp = numext::mini(y,x) / p; + return p * sqrt(RealScalar(1) + qp*qp); +} + +template +struct hypot_impl +{ + typedef typename NumTraits::Real RealScalar; + static EIGEN_DEVICE_FUNC + inline RealScalar run(const Scalar& x, const Scalar& y) + { + EIGEN_USING_STD(abs); + return positive_real_hypot(abs(x), abs(y)); + } +}; + +// Generic complex sqrt implementation that correctly handles corner cases +// according to https://en.cppreference.com/w/cpp/numeric/complex/sqrt +template +EIGEN_DEVICE_FUNC std::complex complex_sqrt(const std::complex& z) { + // Computes the principal sqrt of the input. + // + // For a complex square root of the number x + i*y. We want to find real + // numbers u and v such that + // (u + i*v)^2 = x + i*y <=> + // u^2 - v^2 + i*2*u*v = x + i*v. + // By equating the real and imaginary parts we get: + // u^2 - v^2 = x + // 2*u*v = y. + // + // For x >= 0, this has the numerically stable solution + // u = sqrt(0.5 * (x + sqrt(x^2 + y^2))) + // v = y / (2 * u) + // and for x < 0, + // v = sign(y) * sqrt(0.5 * (-x + sqrt(x^2 + y^2))) + // u = y / (2 * v) + // + // Letting w = sqrt(0.5 * (|x| + |z|)), + // if x == 0: u = w, v = sign(y) * w + // if x > 0: u = w, v = y / (2 * w) + // if x < 0: u = |y| / (2 * w), v = sign(y) * w + + const T x = numext::real(z); + const T y = numext::imag(z); + const T zero = T(0); + const T w = numext::sqrt(T(0.5) * (numext::abs(x) + numext::hypot(x, y))); + + return + (numext::isinf)(y) ? std::complex(NumTraits::infinity(), y) + : x == zero ? std::complex(w, y < zero ? -w : w) + : x > zero ? std::complex(w, y / (2 * w)) + : std::complex(numext::abs(y) / (2 * w), y < zero ? -w : w ); +} + +// Generic complex rsqrt implementation. +template +EIGEN_DEVICE_FUNC std::complex complex_rsqrt(const std::complex& z) { + // Computes the principal reciprocal sqrt of the input. + // + // For a complex reciprocal square root of the number z = x + i*y. We want to + // find real numbers u and v such that + // (u + i*v)^2 = 1 / (x + i*y) <=> + // u^2 - v^2 + i*2*u*v = x/|z|^2 - i*v/|z|^2. + // By equating the real and imaginary parts we get: + // u^2 - v^2 = x/|z|^2 + // 2*u*v = y/|z|^2. + // + // For x >= 0, this has the numerically stable solution + // u = sqrt(0.5 * (x + |z|)) / |z| + // v = -y / (2 * u * |z|) + // and for x < 0, + // v = -sign(y) * sqrt(0.5 * (-x + |z|)) / |z| + // u = -y / (2 * v * |z|) + // + // Letting w = sqrt(0.5 * (|x| + |z|)), + // if x == 0: u = w / |z|, v = -sign(y) * w / |z| + // if x > 0: u = w / |z|, v = -y / (2 * w * |z|) + // if x < 0: u = |y| / (2 * w * |z|), v = -sign(y) * w / |z| + + const T x = numext::real(z); + const T y = numext::imag(z); + const T zero = T(0); + + const T abs_z = numext::hypot(x, y); + const T w = numext::sqrt(T(0.5) * (numext::abs(x) + abs_z)); + const T woz = w / abs_z; + // Corner cases consistent with 1/sqrt(z) on gcc/clang. + return + abs_z == zero ? std::complex(NumTraits::infinity(), NumTraits::quiet_NaN()) + : ((numext::isinf)(x) || (numext::isinf)(y)) ? std::complex(zero, zero) + : x == zero ? std::complex(woz, y < zero ? woz : -woz) + : x > zero ? std::complex(woz, -y / (2 * w * abs_z)) + : std::complex(numext::abs(y) / (2 * w * abs_z), y < zero ? woz : -woz ); +} + +template +EIGEN_DEVICE_FUNC std::complex complex_log(const std::complex& z) { + // Computes complex log. + T a = numext::abs(z); + EIGEN_USING_STD(atan2); + T b = atan2(z.imag(), z.real()); + return std::complex(numext::log(a), b); +} + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_MATHFUNCTIONSIMPL_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Matrix.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Matrix.h new file mode 100644 index 0000000..f0e59a9 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Matrix.h @@ -0,0 +1,565 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2010 Benoit Jacob +// Copyright (C) 2008-2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATRIX_H +#define EIGEN_MATRIX_H + +namespace Eigen { + +namespace internal { +template +struct traits > +{ +private: + enum { size = internal::size_at_compile_time<_Rows,_Cols>::ret }; + typedef typename find_best_packet<_Scalar,size>::type PacketScalar; + enum { + row_major_bit = _Options&RowMajor ? RowMajorBit : 0, + is_dynamic_size_storage = _MaxRows==Dynamic || _MaxCols==Dynamic, + max_size = is_dynamic_size_storage ? Dynamic : _MaxRows*_MaxCols, + default_alignment = compute_default_alignment<_Scalar,max_size>::value, + actual_alignment = ((_Options&DontAlign)==0) ? default_alignment : 0, + required_alignment = unpacket_traits::alignment, + packet_access_bit = (packet_traits<_Scalar>::Vectorizable && (EIGEN_UNALIGNED_VECTORIZE || (actual_alignment>=required_alignment))) ? PacketAccessBit : 0 + }; + +public: + typedef _Scalar Scalar; + typedef Dense StorageKind; + typedef Eigen::Index StorageIndex; + typedef MatrixXpr XprKind; + enum { + RowsAtCompileTime = _Rows, + ColsAtCompileTime = _Cols, + MaxRowsAtCompileTime = _MaxRows, + MaxColsAtCompileTime = _MaxCols, + Flags = compute_matrix_flags<_Scalar, _Rows, _Cols, _Options, _MaxRows, _MaxCols>::ret, + Options = _Options, + InnerStrideAtCompileTime = 1, + OuterStrideAtCompileTime = (Options&RowMajor) ? ColsAtCompileTime : RowsAtCompileTime, + + // FIXME, the following flag in only used to define NeedsToAlign in PlainObjectBase + EvaluatorFlags = LinearAccessBit | DirectAccessBit | packet_access_bit | row_major_bit, + Alignment = actual_alignment + }; +}; +} + +/** \class Matrix + * \ingroup Core_Module + * + * \brief The matrix class, also used for vectors and row-vectors + * + * The %Matrix class is the work-horse for all \em dense (\ref dense "note") matrices and vectors within Eigen. + * Vectors are matrices with one column, and row-vectors are matrices with one row. + * + * The %Matrix class encompasses \em both fixed-size and dynamic-size objects (\ref fixedsize "note"). + * + * The first three template parameters are required: + * \tparam _Scalar Numeric type, e.g. float, double, int or std::complex. + * User defined scalar types are supported as well (see \ref user_defined_scalars "here"). + * \tparam _Rows Number of rows, or \b Dynamic + * \tparam _Cols Number of columns, or \b Dynamic + * + * The remaining template parameters are optional -- in most cases you don't have to worry about them. + * \tparam _Options A combination of either \b #RowMajor or \b #ColMajor, and of either + * \b #AutoAlign or \b #DontAlign. + * The former controls \ref TopicStorageOrders "storage order", and defaults to column-major. The latter controls alignment, which is required + * for vectorization. It defaults to aligning matrices except for fixed sizes that aren't a multiple of the packet size. + * \tparam _MaxRows Maximum number of rows. Defaults to \a _Rows (\ref maxrows "note"). + * \tparam _MaxCols Maximum number of columns. Defaults to \a _Cols (\ref maxrows "note"). + * + * Eigen provides a number of typedefs covering the usual cases. Here are some examples: + * + * \li \c Matrix2d is a 2x2 square matrix of doubles (\c Matrix) + * \li \c Vector4f is a vector of 4 floats (\c Matrix) + * \li \c RowVector3i is a row-vector of 3 ints (\c Matrix) + * + * \li \c MatrixXf is a dynamic-size matrix of floats (\c Matrix) + * \li \c VectorXf is a dynamic-size vector of floats (\c Matrix) + * + * \li \c Matrix2Xf is a partially fixed-size (dynamic-size) matrix of floats (\c Matrix) + * \li \c MatrixX3d is a partially dynamic-size (fixed-size) matrix of double (\c Matrix) + * + * See \link matrixtypedefs this page \endlink for a complete list of predefined \em %Matrix and \em Vector typedefs. + * + * You can access elements of vectors and matrices using normal subscripting: + * + * \code + * Eigen::VectorXd v(10); + * v[0] = 0.1; + * v[1] = 0.2; + * v(0) = 0.3; + * v(1) = 0.4; + * + * Eigen::MatrixXi m(10, 10); + * m(0, 1) = 1; + * m(0, 2) = 2; + * m(0, 3) = 3; + * \endcode + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_MATRIX_PLUGIN. + * + * Some notes: + * + *

+ *
\anchor dense Dense versus sparse:
+ *
This %Matrix class handles dense, not sparse matrices and vectors. For sparse matrices and vectors, see the Sparse module. + * + * Dense matrices and vectors are plain usual arrays of coefficients. All the coefficients are stored, in an ordinary contiguous array. + * This is unlike Sparse matrices and vectors where the coefficients are stored as a list of nonzero coefficients.
+ * + *
\anchor fixedsize Fixed-size versus dynamic-size:
+ *
Fixed-size means that the numbers of rows and columns are known are compile-time. In this case, Eigen allocates the array + * of coefficients as a fixed-size array, as a class member. This makes sense for very small matrices, typically up to 4x4, sometimes up + * to 16x16. Larger matrices should be declared as dynamic-size even if one happens to know their size at compile-time. + * + * Dynamic-size means that the numbers of rows or columns are not necessarily known at compile-time. In this case they are runtime + * variables, and the array of coefficients is allocated dynamically on the heap. + * + * Note that \em dense matrices, be they Fixed-size or Dynamic-size, do not expand dynamically in the sense of a std::map. + * If you want this behavior, see the Sparse module.
+ * + *
\anchor maxrows _MaxRows and _MaxCols:
+ *
In most cases, one just leaves these parameters to the default values. + * These parameters mean the maximum size of rows and columns that the matrix may have. They are useful in cases + * when the exact numbers of rows and columns are not known are compile-time, but it is known at compile-time that they cannot + * exceed a certain value. This happens when taking dynamic-size blocks inside fixed-size matrices: in this case _MaxRows and _MaxCols + * are the dimensions of the original matrix, while _Rows and _Cols are Dynamic.
+ *
+ * + * ABI and storage layout + * + * The table below summarizes the ABI of some possible Matrix instances which is fixed thorough the lifetime of Eigen 3. + * + * + * + * + * + * + *
Matrix typeEquivalent C structure
\code Matrix \endcode\code + * struct { + * T *data; // with (size_t(data)%EIGEN_MAX_ALIGN_BYTES)==0 + * Eigen::Index rows, cols; + * }; + * \endcode
\code + * Matrix + * Matrix \endcode\code + * struct { + * T *data; // with (size_t(data)%EIGEN_MAX_ALIGN_BYTES)==0 + * Eigen::Index size; + * }; + * \endcode
\code Matrix \endcode\code + * struct { + * T data[Rows*Cols]; // with (size_t(data)%A(Rows*Cols*sizeof(T)))==0 + * }; + * \endcode
\code Matrix \endcode\code + * struct { + * T data[MaxRows*MaxCols]; // with (size_t(data)%A(MaxRows*MaxCols*sizeof(T)))==0 + * Eigen::Index rows, cols; + * }; + * \endcode
+ * Note that in this table Rows, Cols, MaxRows and MaxCols are all positive integers. A(S) is defined to the largest possible power-of-two + * smaller to EIGEN_MAX_STATIC_ALIGN_BYTES. + * + * \see MatrixBase for the majority of the API methods for matrices, \ref TopicClassHierarchy, + * \ref TopicStorageOrders + */ + +template +class Matrix + : public PlainObjectBase > +{ + public: + + /** \brief Base class typedef. + * \sa PlainObjectBase + */ + typedef PlainObjectBase Base; + + enum { Options = _Options }; + + EIGEN_DENSE_PUBLIC_INTERFACE(Matrix) + + typedef typename Base::PlainObject PlainObject; + + using Base::base; + using Base::coeffRef; + + /** + * \brief Assigns matrices to each other. + * + * \note This is a special case of the templated operator=. Its purpose is + * to prevent a default operator= from hiding the templated operator=. + * + * \callgraph + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix& operator=(const Matrix& other) + { + return Base::_set(other); + } + + /** \internal + * \brief Copies the value of the expression \a other into \c *this with automatic resizing. + * + * *this might be resized to match the dimensions of \a other. If *this was a null matrix (not already initialized), + * it will be initialized. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix& operator=(const DenseBase& other) + { + return Base::_set(other); + } + + /* Here, doxygen failed to copy the brief information when using \copydoc */ + + /** + * \brief Copies the generic expression \a other into *this. + * \copydetails DenseBase::operator=(const EigenBase &other) + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix& operator=(const EigenBase &other) + { + return Base::operator=(other); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix& operator=(const ReturnByValue& func) + { + return Base::operator=(func); + } + + /** \brief Default constructor. + * + * For fixed-size matrices, does nothing. + * + * For dynamic-size matrices, creates an empty matrix of size 0. Does not allocate any array. Such a matrix + * is called a null matrix. This constructor is the unique way to create null matrices: resizing + * a matrix to 0 is not supported. + * + * \sa resize(Index,Index) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Matrix() : Base() + { + Base::_check_template_params(); + EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + } + + // FIXME is it still needed + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit Matrix(internal::constructor_without_unaligned_array_assert) + : Base(internal::constructor_without_unaligned_array_assert()) + { Base::_check_template_params(); EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED } + +#if EIGEN_HAS_RVALUE_REFERENCES + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Matrix(Matrix&& other) EIGEN_NOEXCEPT_IF(std::is_nothrow_move_constructible::value) + : Base(std::move(other)) + { + Base::_check_template_params(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Matrix& operator=(Matrix&& other) EIGEN_NOEXCEPT_IF(std::is_nothrow_move_assignable::value) + { + Base::operator=(std::move(other)); + return *this; + } +#endif + +#if EIGEN_HAS_CXX11 + /** \copydoc PlainObjectBase(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&... args) + * + * Example: \include Matrix_variadic_ctor_cxx11.cpp + * Output: \verbinclude Matrix_variadic_ctor_cxx11.out + * + * \sa Matrix(const std::initializer_list>&) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Matrix(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + : Base(a0, a1, a2, a3, args...) {} + + /** \brief Constructs a Matrix and initializes it from the coefficients given as initializer-lists grouped by row. \cpp11 + * + * In the general case, the constructor takes a list of rows, each row being represented as a list of coefficients: + * + * Example: \include Matrix_initializer_list_23_cxx11.cpp + * Output: \verbinclude Matrix_initializer_list_23_cxx11.out + * + * Each of the inner initializer lists must contain the exact same number of elements, otherwise an assertion is triggered. + * + * In the case of a compile-time column vector, implicit transposition from a single row is allowed. + * Therefore VectorXd{{1,2,3,4,5}} is legal and the more verbose syntax + * RowVectorXd{{1},{2},{3},{4},{5}} can be avoided: + * + * Example: \include Matrix_initializer_list_vector_cxx11.cpp + * Output: \verbinclude Matrix_initializer_list_vector_cxx11.out + * + * In the case of fixed-sized matrices, the initializer list sizes must exactly match the matrix sizes, + * and implicit transposition is allowed for compile-time vectors only. + * + * \sa Matrix(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + */ + EIGEN_DEVICE_FUNC + explicit EIGEN_STRONG_INLINE Matrix(const std::initializer_list>& list) : Base(list) {} +#endif // end EIGEN_HAS_CXX11 + +#ifndef EIGEN_PARSED_BY_DOXYGEN + + // This constructor is for both 1x1 matrices and dynamic vectors + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit Matrix(const T& x) + { + Base::_check_template_params(); + Base::template _init1(x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Matrix(const T0& x, const T1& y) + { + Base::_check_template_params(); + Base::template _init2(x, y); + } + + +#else + /** \brief Constructs a fixed-sized matrix initialized with coefficients starting at \a data */ + EIGEN_DEVICE_FUNC + explicit Matrix(const Scalar *data); + + /** \brief Constructs a vector or row-vector with given dimension. \only_for_vectors + * + * This is useful for dynamic-size vectors. For fixed-size vectors, + * it is redundant to pass these parameters, so one should use the default constructor + * Matrix() instead. + * + * \warning This constructor is disabled for fixed-size \c 1x1 matrices. For instance, + * calling Matrix(1) will call the initialization constructor: Matrix(const Scalar&). + * For fixed-size \c 1x1 matrices it is therefore recommended to use the default + * constructor Matrix() instead, especially when using one of the non standard + * \c EIGEN_INITIALIZE_MATRICES_BY_{ZERO,\c NAN} macros (see \ref TopicPreprocessorDirectives). + */ + EIGEN_STRONG_INLINE explicit Matrix(Index dim); + /** \brief Constructs an initialized 1x1 matrix with the given coefficient + * \sa Matrix(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&...) */ + Matrix(const Scalar& x); + /** \brief Constructs an uninitialized matrix with \a rows rows and \a cols columns. + * + * This is useful for dynamic-size matrices. For fixed-size matrices, + * it is redundant to pass these parameters, so one should use the default constructor + * Matrix() instead. + * + * \warning This constructor is disabled for fixed-size \c 1x2 and \c 2x1 vectors. For instance, + * calling Matrix2f(2,1) will call the initialization constructor: Matrix(const Scalar& x, const Scalar& y). + * For fixed-size \c 1x2 or \c 2x1 vectors it is therefore recommended to use the default + * constructor Matrix() instead, especially when using one of the non standard + * \c EIGEN_INITIALIZE_MATRICES_BY_{ZERO,\c NAN} macros (see \ref TopicPreprocessorDirectives). + */ + EIGEN_DEVICE_FUNC + Matrix(Index rows, Index cols); + + /** \brief Constructs an initialized 2D vector with given coefficients + * \sa Matrix(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&...) */ + Matrix(const Scalar& x, const Scalar& y); + #endif // end EIGEN_PARSED_BY_DOXYGEN + + /** \brief Constructs an initialized 3D vector with given coefficients + * \sa Matrix(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&...) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix(const Scalar& x, const Scalar& y, const Scalar& z) + { + Base::_check_template_params(); + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(Matrix, 3) + m_storage.data()[0] = x; + m_storage.data()[1] = y; + m_storage.data()[2] = z; + } + /** \brief Constructs an initialized 4D vector with given coefficients + * \sa Matrix(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&...) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix(const Scalar& x, const Scalar& y, const Scalar& z, const Scalar& w) + { + Base::_check_template_params(); + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(Matrix, 4) + m_storage.data()[0] = x; + m_storage.data()[1] = y; + m_storage.data()[2] = z; + m_storage.data()[3] = w; + } + + + /** \brief Copy constructor */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix(const Matrix& other) : Base(other) + { } + + /** \brief Copy constructor for generic expressions. + * \sa MatrixBase::operator=(const EigenBase&) + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix(const EigenBase &other) + : Base(other.derived()) + { } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT { return 1; } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT { return this->innerSize(); } + + /////////// Geometry module /////////// + + template + EIGEN_DEVICE_FUNC + explicit Matrix(const RotationBase& r); + template + EIGEN_DEVICE_FUNC + Matrix& operator=(const RotationBase& r); + + // allow to extend Matrix outside Eigen + #ifdef EIGEN_MATRIX_PLUGIN + #include EIGEN_MATRIX_PLUGIN + #endif + + protected: + template + friend struct internal::conservative_resize_like_impl; + + using Base::m_storage; +}; + +/** \defgroup matrixtypedefs Global matrix typedefs + * + * \ingroup Core_Module + * + * %Eigen defines several typedef shortcuts for most common matrix and vector types. + * + * The general patterns are the following: + * + * \c MatrixSizeType where \c Size can be \c 2,\c 3,\c 4 for fixed size square matrices or \c X for dynamic size, + * and where \c Type can be \c i for integer, \c f for float, \c d for double, \c cf for complex float, \c cd + * for complex double. + * + * For example, \c Matrix3d is a fixed-size 3x3 matrix type of doubles, and \c MatrixXf is a dynamic-size matrix of floats. + * + * There are also \c VectorSizeType and \c RowVectorSizeType which are self-explanatory. For example, \c Vector4cf is + * a fixed-size vector of 4 complex floats. + * + * With \cpp11, template alias are also defined for common sizes. + * They follow the same pattern as above except that the scalar type suffix is replaced by a + * template parameter, i.e.: + * - `MatrixSize` where `Size` can be \c 2,\c 3,\c 4 for fixed size square matrices or \c X for dynamic size. + * - `MatrixXSize` and `MatrixSizeX` where `Size` can be \c 2,\c 3,\c 4 for hybrid dynamic/fixed matrices. + * - `VectorSize` and `RowVectorSize` for column and row vectors. + * + * With \cpp11, you can also use fully generic column and row vector types: `Vector` and `RowVector`. + * + * \sa class Matrix + */ + +#define EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, Size, SizeSuffix) \ +/** \ingroup matrixtypedefs */ \ +typedef Matrix Matrix##SizeSuffix##TypeSuffix; \ +/** \ingroup matrixtypedefs */ \ +typedef Matrix Vector##SizeSuffix##TypeSuffix; \ +/** \ingroup matrixtypedefs */ \ +typedef Matrix RowVector##SizeSuffix##TypeSuffix; + +#define EIGEN_MAKE_FIXED_TYPEDEFS(Type, TypeSuffix, Size) \ +/** \ingroup matrixtypedefs */ \ +typedef Matrix Matrix##Size##X##TypeSuffix; \ +/** \ingroup matrixtypedefs */ \ +typedef Matrix Matrix##X##Size##TypeSuffix; + +#define EIGEN_MAKE_TYPEDEFS_ALL_SIZES(Type, TypeSuffix) \ +EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, 2, 2) \ +EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, 3, 3) \ +EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, 4, 4) \ +EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, Dynamic, X) \ +EIGEN_MAKE_FIXED_TYPEDEFS(Type, TypeSuffix, 2) \ +EIGEN_MAKE_FIXED_TYPEDEFS(Type, TypeSuffix, 3) \ +EIGEN_MAKE_FIXED_TYPEDEFS(Type, TypeSuffix, 4) + +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(int, i) +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(float, f) +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(double, d) +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(std::complex, cf) +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(std::complex, cd) + +#undef EIGEN_MAKE_TYPEDEFS_ALL_SIZES +#undef EIGEN_MAKE_TYPEDEFS +#undef EIGEN_MAKE_FIXED_TYPEDEFS + +#if EIGEN_HAS_CXX11 + +#define EIGEN_MAKE_TYPEDEFS(Size, SizeSuffix) \ +/** \ingroup matrixtypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Matrix##SizeSuffix = Matrix; \ +/** \ingroup matrixtypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Vector##SizeSuffix = Matrix; \ +/** \ingroup matrixtypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using RowVector##SizeSuffix = Matrix; + +#define EIGEN_MAKE_FIXED_TYPEDEFS(Size) \ +/** \ingroup matrixtypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Matrix##Size##X = Matrix; \ +/** \ingroup matrixtypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Matrix##X##Size = Matrix; + +EIGEN_MAKE_TYPEDEFS(2, 2) +EIGEN_MAKE_TYPEDEFS(3, 3) +EIGEN_MAKE_TYPEDEFS(4, 4) +EIGEN_MAKE_TYPEDEFS(Dynamic, X) +EIGEN_MAKE_FIXED_TYPEDEFS(2) +EIGEN_MAKE_FIXED_TYPEDEFS(3) +EIGEN_MAKE_FIXED_TYPEDEFS(4) + +/** \ingroup matrixtypedefs + * \brief \cpp11 */ +template +using Vector = Matrix; + +/** \ingroup matrixtypedefs + * \brief \cpp11 */ +template +using RowVector = Matrix; + +#undef EIGEN_MAKE_TYPEDEFS +#undef EIGEN_MAKE_FIXED_TYPEDEFS + +#endif // EIGEN_HAS_CXX11 + +} // end namespace Eigen + +#endif // EIGEN_MATRIX_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/MatrixBase.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/MatrixBase.h new file mode 100644 index 0000000..45c3a59 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/MatrixBase.h @@ -0,0 +1,547 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2009 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATRIXBASE_H +#define EIGEN_MATRIXBASE_H + +namespace Eigen { + +/** \class MatrixBase + * \ingroup Core_Module + * + * \brief Base class for all dense matrices, vectors, and expressions + * + * This class is the base that is inherited by all matrix, vector, and related expression + * types. Most of the Eigen API is contained in this class, and its base classes. Other important + * classes for the Eigen API are Matrix, and VectorwiseOp. + * + * Note that some methods are defined in other modules such as the \ref LU_Module LU module + * for all functions related to matrix inversions. + * + * \tparam Derived is the derived type, e.g. a matrix type, or an expression, etc. + * + * When writing a function taking Eigen objects as argument, if you want your function + * to take as argument any matrix, vector, or expression, just let it take a + * MatrixBase argument. As an example, here is a function printFirstRow which, given + * a matrix, vector, or expression \a x, prints the first row of \a x. + * + * \code + template + void printFirstRow(const Eigen::MatrixBase& x) + { + cout << x.row(0) << endl; + } + * \endcode + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_MATRIXBASE_PLUGIN. + * + * \sa \blank \ref TopicClassHierarchy + */ +template class MatrixBase + : public DenseBase +{ + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef MatrixBase StorageBaseType; + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + + typedef DenseBase Base; + using Base::RowsAtCompileTime; + using Base::ColsAtCompileTime; + using Base::SizeAtCompileTime; + using Base::MaxRowsAtCompileTime; + using Base::MaxColsAtCompileTime; + using Base::MaxSizeAtCompileTime; + using Base::IsVectorAtCompileTime; + using Base::Flags; + + using Base::derived; + using Base::const_cast_derived; + using Base::rows; + using Base::cols; + using Base::size; + using Base::coeff; + using Base::coeffRef; + using Base::lazyAssign; + using Base::eval; + using Base::operator-; + using Base::operator+=; + using Base::operator-=; + using Base::operator*=; + using Base::operator/=; + + typedef typename Base::CoeffReturnType CoeffReturnType; + typedef typename Base::ConstTransposeReturnType ConstTransposeReturnType; + typedef typename Base::RowXpr RowXpr; + typedef typename Base::ColXpr ColXpr; +#endif // not EIGEN_PARSED_BY_DOXYGEN + + + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** type of the equivalent square matrix */ + typedef Matrix SquareMatrixType; +#endif // not EIGEN_PARSED_BY_DOXYGEN + + /** \returns the size of the main diagonal, which is min(rows(),cols()). + * \sa rows(), cols(), SizeAtCompileTime. */ + EIGEN_DEVICE_FUNC + inline Index diagonalSize() const { return (numext::mini)(rows(),cols()); } + + typedef typename Base::PlainObject PlainObject; + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal Represents a matrix with all coefficients equal to one another*/ + typedef CwiseNullaryOp,PlainObject> ConstantReturnType; + /** \internal the return type of MatrixBase::adjoint() */ + typedef typename internal::conditional::IsComplex, + CwiseUnaryOp, ConstTransposeReturnType>, + ConstTransposeReturnType + >::type AdjointReturnType; + /** \internal Return type of eigenvalues() */ + typedef Matrix, internal::traits::ColsAtCompileTime, 1, ColMajor> EigenvaluesReturnType; + /** \internal the return type of identity */ + typedef CwiseNullaryOp,PlainObject> IdentityReturnType; + /** \internal the return type of unit vectors */ + typedef Block, SquareMatrixType>, + internal::traits::RowsAtCompileTime, + internal::traits::ColsAtCompileTime> BasisReturnType; +#endif // not EIGEN_PARSED_BY_DOXYGEN + +#define EIGEN_CURRENT_STORAGE_BASE_CLASS Eigen::MatrixBase +#define EIGEN_DOC_UNARY_ADDONS(X,Y) +# include "../plugins/CommonCwiseBinaryOps.h" +# include "../plugins/MatrixCwiseUnaryOps.h" +# include "../plugins/MatrixCwiseBinaryOps.h" +# ifdef EIGEN_MATRIXBASE_PLUGIN +# include EIGEN_MATRIXBASE_PLUGIN +# endif +#undef EIGEN_CURRENT_STORAGE_BASE_CLASS +#undef EIGEN_DOC_UNARY_ADDONS + + /** Special case of the template operator=, in order to prevent the compiler + * from generating a default operator= (issue hit with g++ 4.1) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator=(const MatrixBase& other); + + // We cannot inherit here via Base::operator= since it is causing + // trouble with MSVC. + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator=(const DenseBase& other); + + template + EIGEN_DEVICE_FUNC + Derived& operator=(const EigenBase& other); + + template + EIGEN_DEVICE_FUNC + Derived& operator=(const ReturnByValue& other); + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator+=(const MatrixBase& other); + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator-=(const MatrixBase& other); + + template + EIGEN_DEVICE_FUNC + const Product + operator*(const MatrixBase &other) const; + + template + EIGEN_DEVICE_FUNC + const Product + lazyProduct(const MatrixBase &other) const; + + template + Derived& operator*=(const EigenBase& other); + + template + void applyOnTheLeft(const EigenBase& other); + + template + void applyOnTheRight(const EigenBase& other); + + template + EIGEN_DEVICE_FUNC + const Product + operator*(const DiagonalBase &diagonal) const; + + template + EIGEN_DEVICE_FUNC + typename ScalarBinaryOpTraits::Scalar,typename internal::traits::Scalar>::ReturnType + dot(const MatrixBase& other) const; + + EIGEN_DEVICE_FUNC RealScalar squaredNorm() const; + EIGEN_DEVICE_FUNC RealScalar norm() const; + RealScalar stableNorm() const; + RealScalar blueNorm() const; + RealScalar hypotNorm() const; + EIGEN_DEVICE_FUNC const PlainObject normalized() const; + EIGEN_DEVICE_FUNC const PlainObject stableNormalized() const; + EIGEN_DEVICE_FUNC void normalize(); + EIGEN_DEVICE_FUNC void stableNormalize(); + + EIGEN_DEVICE_FUNC const AdjointReturnType adjoint() const; + EIGEN_DEVICE_FUNC void adjointInPlace(); + + typedef Diagonal DiagonalReturnType; + EIGEN_DEVICE_FUNC + DiagonalReturnType diagonal(); + + typedef typename internal::add_const >::type ConstDiagonalReturnType; + EIGEN_DEVICE_FUNC + ConstDiagonalReturnType diagonal() const; + + template struct DiagonalIndexReturnType { typedef Diagonal Type; }; + template struct ConstDiagonalIndexReturnType { typedef const Diagonal Type; }; + + template + EIGEN_DEVICE_FUNC + typename DiagonalIndexReturnType::Type diagonal(); + + template + EIGEN_DEVICE_FUNC + typename ConstDiagonalIndexReturnType::Type diagonal() const; + + typedef Diagonal DiagonalDynamicIndexReturnType; + typedef typename internal::add_const >::type ConstDiagonalDynamicIndexReturnType; + + EIGEN_DEVICE_FUNC + DiagonalDynamicIndexReturnType diagonal(Index index); + EIGEN_DEVICE_FUNC + ConstDiagonalDynamicIndexReturnType diagonal(Index index) const; + + template struct TriangularViewReturnType { typedef TriangularView Type; }; + template struct ConstTriangularViewReturnType { typedef const TriangularView Type; }; + + template + EIGEN_DEVICE_FUNC + typename TriangularViewReturnType::Type triangularView(); + template + EIGEN_DEVICE_FUNC + typename ConstTriangularViewReturnType::Type triangularView() const; + + template struct SelfAdjointViewReturnType { typedef SelfAdjointView Type; }; + template struct ConstSelfAdjointViewReturnType { typedef const SelfAdjointView Type; }; + + template + EIGEN_DEVICE_FUNC + typename SelfAdjointViewReturnType::Type selfadjointView(); + template + EIGEN_DEVICE_FUNC + typename ConstSelfAdjointViewReturnType::Type selfadjointView() const; + + const SparseView sparseView(const Scalar& m_reference = Scalar(0), + const typename NumTraits::Real& m_epsilon = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC static const IdentityReturnType Identity(); + EIGEN_DEVICE_FUNC static const IdentityReturnType Identity(Index rows, Index cols); + EIGEN_DEVICE_FUNC static const BasisReturnType Unit(Index size, Index i); + EIGEN_DEVICE_FUNC static const BasisReturnType Unit(Index i); + EIGEN_DEVICE_FUNC static const BasisReturnType UnitX(); + EIGEN_DEVICE_FUNC static const BasisReturnType UnitY(); + EIGEN_DEVICE_FUNC static const BasisReturnType UnitZ(); + EIGEN_DEVICE_FUNC static const BasisReturnType UnitW(); + + EIGEN_DEVICE_FUNC + const DiagonalWrapper asDiagonal() const; + const PermutationWrapper asPermutation() const; + + EIGEN_DEVICE_FUNC + Derived& setIdentity(); + EIGEN_DEVICE_FUNC + Derived& setIdentity(Index rows, Index cols); + EIGEN_DEVICE_FUNC Derived& setUnit(Index i); + EIGEN_DEVICE_FUNC Derived& setUnit(Index newSize, Index i); + + bool isIdentity(const RealScalar& prec = NumTraits::dummy_precision()) const; + bool isDiagonal(const RealScalar& prec = NumTraits::dummy_precision()) const; + + bool isUpperTriangular(const RealScalar& prec = NumTraits::dummy_precision()) const; + bool isLowerTriangular(const RealScalar& prec = NumTraits::dummy_precision()) const; + + template + bool isOrthogonal(const MatrixBase& other, + const RealScalar& prec = NumTraits::dummy_precision()) const; + bool isUnitary(const RealScalar& prec = NumTraits::dummy_precision()) const; + + /** \returns true if each coefficients of \c *this and \a other are all exactly equal. + * \warning When using floating point scalar values you probably should rather use a + * fuzzy comparison such as isApprox() + * \sa isApprox(), operator!= */ + template + EIGEN_DEVICE_FUNC inline bool operator==(const MatrixBase& other) const + { return cwiseEqual(other).all(); } + + /** \returns true if at least one pair of coefficients of \c *this and \a other are not exactly equal to each other. + * \warning When using floating point scalar values you probably should rather use a + * fuzzy comparison such as isApprox() + * \sa isApprox(), operator== */ + template + EIGEN_DEVICE_FUNC inline bool operator!=(const MatrixBase& other) const + { return cwiseNotEqual(other).any(); } + + NoAlias EIGEN_DEVICE_FUNC noalias(); + + // TODO forceAlignedAccess is temporarily disabled + // Need to find a nicer workaround. + inline const Derived& forceAlignedAccess() const { return derived(); } + inline Derived& forceAlignedAccess() { return derived(); } + template inline const Derived& forceAlignedAccessIf() const { return derived(); } + template inline Derived& forceAlignedAccessIf() { return derived(); } + + EIGEN_DEVICE_FUNC Scalar trace() const; + + template EIGEN_DEVICE_FUNC RealScalar lpNorm() const; + + EIGEN_DEVICE_FUNC MatrixBase& matrix() { return *this; } + EIGEN_DEVICE_FUNC const MatrixBase& matrix() const { return *this; } + + /** \returns an \link Eigen::ArrayBase Array \endlink expression of this matrix + * \sa ArrayBase::matrix() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE ArrayWrapper array() { return ArrayWrapper(derived()); } + /** \returns a const \link Eigen::ArrayBase Array \endlink expression of this matrix + * \sa ArrayBase::matrix() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const ArrayWrapper array() const { return ArrayWrapper(derived()); } + +/////////// LU module /////////// + + inline const FullPivLU fullPivLu() const; + inline const PartialPivLU partialPivLu() const; + + inline const PartialPivLU lu() const; + + EIGEN_DEVICE_FUNC + inline const Inverse inverse() const; + + template + inline void computeInverseAndDetWithCheck( + ResultType& inverse, + typename ResultType::Scalar& determinant, + bool& invertible, + const RealScalar& absDeterminantThreshold = NumTraits::dummy_precision() + ) const; + + template + inline void computeInverseWithCheck( + ResultType& inverse, + bool& invertible, + const RealScalar& absDeterminantThreshold = NumTraits::dummy_precision() + ) const; + + EIGEN_DEVICE_FUNC + Scalar determinant() const; + +/////////// Cholesky module /////////// + + inline const LLT llt() const; + inline const LDLT ldlt() const; + +/////////// QR module /////////// + + inline const HouseholderQR householderQr() const; + inline const ColPivHouseholderQR colPivHouseholderQr() const; + inline const FullPivHouseholderQR fullPivHouseholderQr() const; + inline const CompleteOrthogonalDecomposition completeOrthogonalDecomposition() const; + +/////////// Eigenvalues module /////////// + + inline EigenvaluesReturnType eigenvalues() const; + inline RealScalar operatorNorm() const; + +/////////// SVD module /////////// + + inline JacobiSVD jacobiSvd(unsigned int computationOptions = 0) const; + inline BDCSVD bdcSvd(unsigned int computationOptions = 0) const; + +/////////// Geometry module /////////// + + #ifndef EIGEN_PARSED_BY_DOXYGEN + /// \internal helper struct to form the return type of the cross product + template struct cross_product_return_type { + typedef typename ScalarBinaryOpTraits::Scalar,typename internal::traits::Scalar>::ReturnType Scalar; + typedef Matrix type; + }; + #endif // EIGEN_PARSED_BY_DOXYGEN + template + EIGEN_DEVICE_FUNC +#ifndef EIGEN_PARSED_BY_DOXYGEN + inline typename cross_product_return_type::type +#else + inline PlainObject +#endif + cross(const MatrixBase& other) const; + + template + EIGEN_DEVICE_FUNC + inline PlainObject cross3(const MatrixBase& other) const; + + EIGEN_DEVICE_FUNC + inline PlainObject unitOrthogonal(void) const; + + EIGEN_DEVICE_FUNC + inline Matrix eulerAngles(Index a0, Index a1, Index a2) const; + + // put this as separate enum value to work around possible GCC 4.3 bug (?) + enum { HomogeneousReturnTypeDirection = ColsAtCompileTime==1&&RowsAtCompileTime==1 ? ((internal::traits::Flags&RowMajorBit)==RowMajorBit ? Horizontal : Vertical) + : ColsAtCompileTime==1 ? Vertical : Horizontal }; + typedef Homogeneous HomogeneousReturnType; + EIGEN_DEVICE_FUNC + inline HomogeneousReturnType homogeneous() const; + + enum { + SizeMinusOne = SizeAtCompileTime==Dynamic ? Dynamic : SizeAtCompileTime-1 + }; + typedef Block::ColsAtCompileTime==1 ? SizeMinusOne : 1, + internal::traits::ColsAtCompileTime==1 ? 1 : SizeMinusOne> ConstStartMinusOne; + typedef EIGEN_EXPR_BINARYOP_SCALAR_RETURN_TYPE(ConstStartMinusOne,Scalar,quotient) HNormalizedReturnType; + EIGEN_DEVICE_FUNC + inline const HNormalizedReturnType hnormalized() const; + +////////// Householder module /////////// + + EIGEN_DEVICE_FUNC + void makeHouseholderInPlace(Scalar& tau, RealScalar& beta); + template + EIGEN_DEVICE_FUNC + void makeHouseholder(EssentialPart& essential, + Scalar& tau, RealScalar& beta) const; + template + EIGEN_DEVICE_FUNC + void applyHouseholderOnTheLeft(const EssentialPart& essential, + const Scalar& tau, + Scalar* workspace); + template + EIGEN_DEVICE_FUNC + void applyHouseholderOnTheRight(const EssentialPart& essential, + const Scalar& tau, + Scalar* workspace); + +///////// Jacobi module ///////// + + template + EIGEN_DEVICE_FUNC + void applyOnTheLeft(Index p, Index q, const JacobiRotation& j); + template + EIGEN_DEVICE_FUNC + void applyOnTheRight(Index p, Index q, const JacobiRotation& j); + +///////// SparseCore module ///////// + + template + EIGEN_STRONG_INLINE const typename SparseMatrixBase::template CwiseProductDenseReturnType::Type + cwiseProduct(const SparseMatrixBase &other) const + { + return other.cwiseProduct(derived()); + } + +///////// MatrixFunctions module ///////// + + typedef typename internal::stem_function::type StemFunction; +#define EIGEN_MATRIX_FUNCTION(ReturnType, Name, Description) \ + /** \returns an expression of the matrix Description of \c *this. \brief This function requires the unsupported MatrixFunctions module. To compute the coefficient-wise Description use ArrayBase::##Name . */ \ + const ReturnType Name() const; +#define EIGEN_MATRIX_FUNCTION_1(ReturnType, Name, Description, Argument) \ + /** \returns an expression of the matrix Description of \c *this. \brief This function requires the unsupported MatrixFunctions module. To compute the coefficient-wise Description use ArrayBase::##Name . */ \ + const ReturnType Name(Argument) const; + + EIGEN_MATRIX_FUNCTION(MatrixExponentialReturnValue, exp, exponential) + /** \brief Helper function for the unsupported MatrixFunctions module.*/ + const MatrixFunctionReturnValue matrixFunction(StemFunction f) const; + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, cosh, hyperbolic cosine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, sinh, hyperbolic sine) +#if EIGEN_HAS_CXX11_MATH + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, atanh, inverse hyperbolic cosine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, acosh, inverse hyperbolic cosine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, asinh, inverse hyperbolic sine) +#endif + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, cos, cosine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, sin, sine) + EIGEN_MATRIX_FUNCTION(MatrixSquareRootReturnValue, sqrt, square root) + EIGEN_MATRIX_FUNCTION(MatrixLogarithmReturnValue, log, logarithm) + EIGEN_MATRIX_FUNCTION_1(MatrixPowerReturnValue, pow, power to \c p, const RealScalar& p) + EIGEN_MATRIX_FUNCTION_1(MatrixComplexPowerReturnValue, pow, power to \c p, const std::complex& p) + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(MatrixBase) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(MatrixBase) + + private: + EIGEN_DEVICE_FUNC explicit MatrixBase(int); + EIGEN_DEVICE_FUNC MatrixBase(int,int); + template EIGEN_DEVICE_FUNC explicit MatrixBase(const MatrixBase&); + protected: + // mixing arrays and matrices is not legal + template Derived& operator+=(const ArrayBase& ) + {EIGEN_STATIC_ASSERT(std::ptrdiff_t(sizeof(typename OtherDerived::Scalar))==-1,YOU_CANNOT_MIX_ARRAYS_AND_MATRICES); return *this;} + // mixing arrays and matrices is not legal + template Derived& operator-=(const ArrayBase& ) + {EIGEN_STATIC_ASSERT(std::ptrdiff_t(sizeof(typename OtherDerived::Scalar))==-1,YOU_CANNOT_MIX_ARRAYS_AND_MATRICES); return *this;} +}; + + +/*************************************************************************** +* Implementation of matrix base methods +***************************************************************************/ + +/** replaces \c *this by \c *this * \a other. + * + * \returns a reference to \c *this + * + * Example: \include MatrixBase_applyOnTheRight.cpp + * Output: \verbinclude MatrixBase_applyOnTheRight.out + */ +template +template +inline Derived& +MatrixBase::operator*=(const EigenBase &other) +{ + other.derived().applyThisOnTheRight(derived()); + return derived(); +} + +/** replaces \c *this by \c *this * \a other. It is equivalent to MatrixBase::operator*=(). + * + * Example: \include MatrixBase_applyOnTheRight.cpp + * Output: \verbinclude MatrixBase_applyOnTheRight.out + */ +template +template +inline void MatrixBase::applyOnTheRight(const EigenBase &other) +{ + other.derived().applyThisOnTheRight(derived()); +} + +/** replaces \c *this by \a other * \c *this. + * + * Example: \include MatrixBase_applyOnTheLeft.cpp + * Output: \verbinclude MatrixBase_applyOnTheLeft.out + */ +template +template +inline void MatrixBase::applyOnTheLeft(const EigenBase &other) +{ + other.derived().applyThisOnTheLeft(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_MATRIXBASE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/NestByValue.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/NestByValue.h new file mode 100644 index 0000000..b427576 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/NestByValue.h @@ -0,0 +1,85 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_NESTBYVALUE_H +#define EIGEN_NESTBYVALUE_H + +namespace Eigen { + +namespace internal { +template +struct traits > : public traits +{ + enum { + Flags = traits::Flags & ~NestByRefBit + }; +}; +} + +/** \class NestByValue + * \ingroup Core_Module + * + * \brief Expression which must be nested by value + * + * \tparam ExpressionType the type of the object of which we are requiring nesting-by-value + * + * This class is the return type of MatrixBase::nestByValue() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::nestByValue() + */ +template class NestByValue + : public internal::dense_xpr_base< NestByValue >::type +{ + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(NestByValue) + + EIGEN_DEVICE_FUNC explicit inline NestByValue(const ExpressionType& matrix) : m_expression(matrix) {} + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR inline Index rows() const EIGEN_NOEXCEPT { return m_expression.rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR inline Index cols() const EIGEN_NOEXCEPT { return m_expression.cols(); } + + EIGEN_DEVICE_FUNC operator const ExpressionType&() const { return m_expression; } + + EIGEN_DEVICE_FUNC const ExpressionType& nestedExpression() const { return m_expression; } + + protected: + const ExpressionType m_expression; +}; + +/** \returns an expression of the temporary version of *this. + */ +template +EIGEN_DEVICE_FUNC inline const NestByValue +DenseBase::nestByValue() const +{ + return NestByValue(derived()); +} + +namespace internal { + +// Evaluator of Solve -> eval into a temporary +template +struct evaluator > + : public evaluator +{ + typedef evaluator Base; + + EIGEN_DEVICE_FUNC explicit evaluator(const NestByValue& xpr) + : Base(xpr.nestedExpression()) + {} +}; +} + +} // end namespace Eigen + +#endif // EIGEN_NESTBYVALUE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/NoAlias.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/NoAlias.h new file mode 100644 index 0000000..570283d --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/NoAlias.h @@ -0,0 +1,109 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_NOALIAS_H +#define EIGEN_NOALIAS_H + +namespace Eigen { + +/** \class NoAlias + * \ingroup Core_Module + * + * \brief Pseudo expression providing an operator = assuming no aliasing + * + * \tparam ExpressionType the type of the object on which to do the lazy assignment + * + * This class represents an expression with special assignment operators + * assuming no aliasing between the target expression and the source expression. + * More precisely it alloas to bypass the EvalBeforeAssignBit flag of the source expression. + * It is the return type of MatrixBase::noalias() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::noalias() + */ +template class StorageBase> +class NoAlias +{ + public: + typedef typename ExpressionType::Scalar Scalar; + + EIGEN_DEVICE_FUNC + explicit NoAlias(ExpressionType& expression) : m_expression(expression) {} + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE ExpressionType& operator=(const StorageBase& other) + { + call_assignment_no_alias(m_expression, other.derived(), internal::assign_op()); + return m_expression; + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE ExpressionType& operator+=(const StorageBase& other) + { + call_assignment_no_alias(m_expression, other.derived(), internal::add_assign_op()); + return m_expression; + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE ExpressionType& operator-=(const StorageBase& other) + { + call_assignment_no_alias(m_expression, other.derived(), internal::sub_assign_op()); + return m_expression; + } + + EIGEN_DEVICE_FUNC + ExpressionType& expression() const + { + return m_expression; + } + + protected: + ExpressionType& m_expression; +}; + +/** \returns a pseudo expression of \c *this with an operator= assuming + * no aliasing between \c *this and the source expression. + * + * More precisely, noalias() allows to bypass the EvalBeforeAssignBit flag. + * Currently, even though several expressions may alias, only product + * expressions have this flag. Therefore, noalias() is only useful when + * the source expression contains a matrix product. + * + * Here are some examples where noalias is useful: + * \code + * D.noalias() = A * B; + * D.noalias() += A.transpose() * B; + * D.noalias() -= 2 * A * B.adjoint(); + * \endcode + * + * On the other hand the following example will lead to a \b wrong result: + * \code + * A.noalias() = A * B; + * \endcode + * because the result matrix A is also an operand of the matrix product. Therefore, + * there is no alternative than evaluating A * B in a temporary, that is the default + * behavior when you write: + * \code + * A = A * B; + * \endcode + * + * \sa class NoAlias + */ +template +NoAlias EIGEN_DEVICE_FUNC MatrixBase::noalias() +{ + return NoAlias(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_NOALIAS_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/NumTraits.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/NumTraits.h new file mode 100644 index 0000000..72eac5a --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/NumTraits.h @@ -0,0 +1,335 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_NUMTRAITS_H +#define EIGEN_NUMTRAITS_H + +namespace Eigen { + +namespace internal { + +// default implementation of digits10(), based on numeric_limits if specialized, +// 0 for integer types, and log10(epsilon()) otherwise. +template< typename T, + bool use_numeric_limits = std::numeric_limits::is_specialized, + bool is_integer = NumTraits::IsInteger> +struct default_digits10_impl +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static int run() { return std::numeric_limits::digits10; } +}; + +template +struct default_digits10_impl // Floating point +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static int run() { + using std::log10; + using std::ceil; + typedef typename NumTraits::Real Real; + return int(ceil(-log10(NumTraits::epsilon()))); + } +}; + +template +struct default_digits10_impl // Integer +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static int run() { return 0; } +}; + + +// default implementation of digits(), based on numeric_limits if specialized, +// 0 for integer types, and log2(epsilon()) otherwise. +template< typename T, + bool use_numeric_limits = std::numeric_limits::is_specialized, + bool is_integer = NumTraits::IsInteger> +struct default_digits_impl +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static int run() { return std::numeric_limits::digits; } +}; + +template +struct default_digits_impl // Floating point +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static int run() { + using std::log; + using std::ceil; + typedef typename NumTraits::Real Real; + return int(ceil(-log(NumTraits::epsilon())/log(static_cast(2)))); + } +}; + +template +struct default_digits_impl // Integer +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static int run() { return 0; } +}; + +} // end namespace internal + +namespace numext { +/** \internal bit-wise cast without changing the underlying bit representation. */ + +// TODO: Replace by std::bit_cast (available in C++20) +template +EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC Tgt bit_cast(const Src& src) { +#if EIGEN_HAS_TYPE_TRAITS + // The behaviour of memcpy is not specified for non-trivially copyable types + EIGEN_STATIC_ASSERT(std::is_trivially_copyable::value, THIS_TYPE_IS_NOT_SUPPORTED); + EIGEN_STATIC_ASSERT(std::is_trivially_copyable::value && std::is_default_constructible::value, + THIS_TYPE_IS_NOT_SUPPORTED); +#endif + + EIGEN_STATIC_ASSERT(sizeof(Src) == sizeof(Tgt), THIS_TYPE_IS_NOT_SUPPORTED); + Tgt tgt; + EIGEN_USING_STD(memcpy) + memcpy(&tgt, &src, sizeof(Tgt)); + return tgt; +} +} // namespace numext + +/** \class NumTraits + * \ingroup Core_Module + * + * \brief Holds information about the various numeric (i.e. scalar) types allowed by Eigen. + * + * \tparam T the numeric type at hand + * + * This class stores enums, typedefs and static methods giving information about a numeric type. + * + * The provided data consists of: + * \li A typedef \c Real, giving the "real part" type of \a T. If \a T is already real, + * then \c Real is just a typedef to \a T. If \a T is \c std::complex then \c Real + * is a typedef to \a U. + * \li A typedef \c NonInteger, giving the type that should be used for operations producing non-integral values, + * such as quotients, square roots, etc. If \a T is a floating-point type, then this typedef just gives + * \a T again. Note however that many Eigen functions such as internal::sqrt simply refuse to + * take integers. Outside of a few cases, Eigen doesn't do automatic type promotion. Thus, this typedef is + * only intended as a helper for code that needs to explicitly promote types. + * \li A typedef \c Literal giving the type to use for numeric literals such as "2" or "0.5". For instance, for \c std::complex, Literal is defined as \c U. + * Of course, this type must be fully compatible with \a T. In doubt, just use \a T here. + * \li A typedef \a Nested giving the type to use to nest a value inside of the expression tree. If you don't know what + * this means, just use \a T here. + * \li An enum value \a IsComplex. It is equal to 1 if \a T is a \c std::complex + * type, and to 0 otherwise. + * \li An enum value \a IsInteger. It is equal to \c 1 if \a T is an integer type such as \c int, + * and to \c 0 otherwise. + * \li Enum values ReadCost, AddCost and MulCost representing a rough estimate of the number of CPU cycles needed + * to by move / add / mul instructions respectively, assuming the data is already stored in CPU registers. + * Stay vague here. No need to do architecture-specific stuff. If you don't know what this means, just use \c Eigen::HugeCost. + * \li An enum value \a IsSigned. It is equal to \c 1 if \a T is a signed type and to 0 if \a T is unsigned. + * \li An enum value \a RequireInitialization. It is equal to \c 1 if the constructor of the numeric type \a T must + * be called, and to 0 if it is safe not to call it. Default is 0 if \a T is an arithmetic type, and 1 otherwise. + * \li An epsilon() function which, unlike std::numeric_limits::epsilon(), + * it returns a \a Real instead of a \a T. + * \li A dummy_precision() function returning a weak epsilon value. It is mainly used as a default + * value by the fuzzy comparison operators. + * \li highest() and lowest() functions returning the highest and lowest possible values respectively. + * \li digits() function returning the number of radix digits (non-sign digits for integers, mantissa for floating-point). This is + * the analogue of std::numeric_limits::digits + * which is used as the default implementation if specialized. + * \li digits10() function returning the number of decimal digits that can be represented without change. This is + * the analogue of std::numeric_limits::digits10 + * which is used as the default implementation if specialized. + * \li min_exponent() and max_exponent() functions returning the highest and lowest possible values, respectively, + * such that the radix raised to the power exponent-1 is a normalized floating-point number. These are equivalent to + * std::numeric_limits::min_exponent/ + * std::numeric_limits::max_exponent. + * \li infinity() function returning a representation of positive infinity, if available. + * \li quiet_NaN function returning a non-signaling "not-a-number", if available. + */ + +template struct GenericNumTraits +{ + enum { + IsInteger = std::numeric_limits::is_integer, + IsSigned = std::numeric_limits::is_signed, + IsComplex = 0, + RequireInitialization = internal::is_arithmetic::value ? 0 : 1, + ReadCost = 1, + AddCost = 1, + MulCost = 1 + }; + + typedef T Real; + typedef typename internal::conditional< + IsInteger, + typename internal::conditional::type, + T + >::type NonInteger; + typedef T Nested; + typedef T Literal; + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline Real epsilon() + { + return numext::numeric_limits::epsilon(); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline int digits10() + { + return internal::default_digits10_impl::run(); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline int digits() + { + return internal::default_digits_impl::run(); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline int min_exponent() + { + return numext::numeric_limits::min_exponent; + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline int max_exponent() + { + return numext::numeric_limits::max_exponent; + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline Real dummy_precision() + { + // make sure to override this for floating-point types + return Real(0); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline T highest() { + return (numext::numeric_limits::max)(); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline T lowest() { + return IsInteger ? (numext::numeric_limits::min)() + : static_cast(-(numext::numeric_limits::max)()); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline T infinity() { + return numext::numeric_limits::infinity(); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline T quiet_NaN() { + return numext::numeric_limits::quiet_NaN(); + } +}; + +template struct NumTraits : GenericNumTraits +{}; + +template<> struct NumTraits + : GenericNumTraits +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline float dummy_precision() { return 1e-5f; } +}; + +template<> struct NumTraits : GenericNumTraits +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline double dummy_precision() { return 1e-12; } +}; + +template<> struct NumTraits + : GenericNumTraits +{ + EIGEN_CONSTEXPR + static inline long double dummy_precision() { return 1e-15l; } +}; + +template struct NumTraits > + : GenericNumTraits > +{ + typedef _Real Real; + typedef typename NumTraits<_Real>::Literal Literal; + enum { + IsComplex = 1, + RequireInitialization = NumTraits<_Real>::RequireInitialization, + ReadCost = 2 * NumTraits<_Real>::ReadCost, + AddCost = 2 * NumTraits::AddCost, + MulCost = 4 * NumTraits::MulCost + 2 * NumTraits::AddCost + }; + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline Real epsilon() { return NumTraits::epsilon(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline Real dummy_precision() { return NumTraits::dummy_precision(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline int digits10() { return NumTraits::digits10(); } +}; + +template +struct NumTraits > +{ + typedef Array ArrayType; + typedef typename NumTraits::Real RealScalar; + typedef Array Real; + typedef typename NumTraits::NonInteger NonIntegerScalar; + typedef Array NonInteger; + typedef ArrayType & Nested; + typedef typename NumTraits::Literal Literal; + + enum { + IsComplex = NumTraits::IsComplex, + IsInteger = NumTraits::IsInteger, + IsSigned = NumTraits::IsSigned, + RequireInitialization = 1, + ReadCost = ArrayType::SizeAtCompileTime==Dynamic ? HugeCost : ArrayType::SizeAtCompileTime * int(NumTraits::ReadCost), + AddCost = ArrayType::SizeAtCompileTime==Dynamic ? HugeCost : ArrayType::SizeAtCompileTime * int(NumTraits::AddCost), + MulCost = ArrayType::SizeAtCompileTime==Dynamic ? HugeCost : ArrayType::SizeAtCompileTime * int(NumTraits::MulCost) + }; + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline RealScalar epsilon() { return NumTraits::epsilon(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline RealScalar dummy_precision() { return NumTraits::dummy_precision(); } + + EIGEN_CONSTEXPR + static inline int digits10() { return NumTraits::digits10(); } +}; + +template<> struct NumTraits + : GenericNumTraits +{ + enum { + RequireInitialization = 1, + ReadCost = HugeCost, + AddCost = HugeCost, + MulCost = HugeCost + }; + + EIGEN_CONSTEXPR + static inline int digits10() { return 0; } + +private: + static inline std::string epsilon(); + static inline std::string dummy_precision(); + static inline std::string lowest(); + static inline std::string highest(); + static inline std::string infinity(); + static inline std::string quiet_NaN(); +}; + +// Empty specialization for void to allow template specialization based on NumTraits::Real with T==void and SFINAE. +template<> struct NumTraits {}; + +template<> struct NumTraits : GenericNumTraits {}; + +} // end namespace Eigen + +#endif // EIGEN_NUMTRAITS_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/PartialReduxEvaluator.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/PartialReduxEvaluator.h new file mode 100644 index 0000000..29abf35 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/PartialReduxEvaluator.h @@ -0,0 +1,232 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2011-2018 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PARTIALREDUX_H +#define EIGEN_PARTIALREDUX_H + +namespace Eigen { + +namespace internal { + + +/*************************************************************************** +* +* This file provides evaluators for partial reductions. +* There are two modes: +* +* - scalar path: simply calls the respective function on the column or row. +* -> nothing special here, all the tricky part is handled by the return +* types of VectorwiseOp's members. They embed the functor calling the +* respective DenseBase's member function. +* +* - vectorized path: implements a packet-wise reductions followed by +* some (optional) processing of the outcome, e.g., division by n for mean. +* +* For the vectorized path let's observe that the packet-size and outer-unrolling +* are both decided by the assignement logic. So all we have to do is to decide +* on the inner unrolling. +* +* For the unrolling, we can reuse "internal::redux_vec_unroller" from Redux.h, +* but be need to be careful to specify correct increment. +* +***************************************************************************/ + + +/* logic deciding a strategy for unrolling of vectorized paths */ +template +struct packetwise_redux_traits +{ + enum { + OuterSize = int(Evaluator::IsRowMajor) ? Evaluator::RowsAtCompileTime : Evaluator::ColsAtCompileTime, + Cost = OuterSize == Dynamic ? HugeCost + : OuterSize * Evaluator::CoeffReadCost + (OuterSize-1) * functor_traits::Cost, + Unrolling = Cost <= EIGEN_UNROLLING_LIMIT ? CompleteUnrolling : NoUnrolling + }; + +}; + +/* Value to be returned when size==0 , by default let's return 0 */ +template +EIGEN_DEVICE_FUNC +PacketType packetwise_redux_empty_value(const Func& ) { return pset1(0); } + +/* For products the default is 1 */ +template +EIGEN_DEVICE_FUNC +PacketType packetwise_redux_empty_value(const scalar_product_op& ) { return pset1(1); } + +/* Perform the actual reduction */ +template::Unrolling +> +struct packetwise_redux_impl; + +/* Perform the actual reduction with unrolling */ +template +struct packetwise_redux_impl +{ + typedef redux_novec_unroller Base; + typedef typename Evaluator::Scalar Scalar; + + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE + PacketType run(const Evaluator &eval, const Func& func, Index /*size*/) + { + return redux_vec_unroller::OuterSize>::template run(eval,func); + } +}; + +/* Add a specialization of redux_vec_unroller for size==0 at compiletime. + * This specialization is not required for general reductions, which is + * why it is defined here. + */ +template +struct redux_vec_unroller +{ + template + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE PacketType run(const Evaluator &, const Func& f) + { + return packetwise_redux_empty_value(f); + } +}; + +/* Perform the actual reduction for dynamic sizes */ +template +struct packetwise_redux_impl +{ + typedef typename Evaluator::Scalar Scalar; + typedef typename redux_traits::PacketType PacketScalar; + + template + EIGEN_DEVICE_FUNC + static PacketType run(const Evaluator &eval, const Func& func, Index size) + { + if(size==0) + return packetwise_redux_empty_value(func); + + const Index size4 = (size-1)&(~3); + PacketType p = eval.template packetByOuterInner(0,0); + Index i = 1; + // This loop is optimized for instruction pipelining: + // - each iteration generates two independent instructions + // - thanks to branch prediction and out-of-order execution we have independent instructions across loops + for(; i(i+0,0),eval.template packetByOuterInner(i+1,0)), + func.packetOp(eval.template packetByOuterInner(i+2,0),eval.template packetByOuterInner(i+3,0)))); + for(; i(i,0)); + return p; + } +}; + +template< typename ArgType, typename MemberOp, int Direction> +struct evaluator > + : evaluator_base > +{ + typedef PartialReduxExpr XprType; + typedef typename internal::nested_eval::type ArgTypeNested; + typedef typename internal::add_const_on_value_type::type ConstArgTypeNested; + typedef typename internal::remove_all::type ArgTypeNestedCleaned; + typedef typename ArgType::Scalar InputScalar; + typedef typename XprType::Scalar Scalar; + enum { + TraversalSize = Direction==int(Vertical) ? int(ArgType::RowsAtCompileTime) : int(ArgType::ColsAtCompileTime) + }; + typedef typename MemberOp::template Cost CostOpType; + enum { + CoeffReadCost = TraversalSize==Dynamic ? HugeCost + : TraversalSize==0 ? 1 + : int(TraversalSize) * int(evaluator::CoeffReadCost) + int(CostOpType::value), + + _ArgFlags = evaluator::Flags, + + _Vectorizable = bool(int(_ArgFlags)&PacketAccessBit) + && bool(MemberOp::Vectorizable) + && (Direction==int(Vertical) ? bool(_ArgFlags&RowMajorBit) : (_ArgFlags&RowMajorBit)==0) + && (TraversalSize!=0), + + Flags = (traits::Flags&RowMajorBit) + | (evaluator::Flags&(HereditaryBits&(~RowMajorBit))) + | (_Vectorizable ? PacketAccessBit : 0) + | LinearAccessBit, + + Alignment = 0 // FIXME this will need to be improved once PartialReduxExpr is vectorized + }; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType xpr) + : m_arg(xpr.nestedExpression()), m_functor(xpr.functor()) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(TraversalSize==Dynamic ? HugeCost : (TraversalSize==0 ? 1 : int(CostOpType::value))); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const Scalar coeff(Index i, Index j) const + { + return coeff(Direction==Vertical ? j : i); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const Scalar coeff(Index index) const + { + return m_functor(m_arg.template subVector(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + PacketType packet(Index i, Index j) const + { + return packet(Direction==Vertical ? j : i); + } + + template + EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC + PacketType packet(Index idx) const + { + enum { PacketSize = internal::unpacket_traits::size }; + typedef Block PanelType; + + PanelType panel(m_arg, + Direction==Vertical ? 0 : idx, + Direction==Vertical ? idx : 0, + Direction==Vertical ? m_arg.rows() : Index(PacketSize), + Direction==Vertical ? Index(PacketSize) : m_arg.cols()); + + // FIXME + // See bug 1612, currently if PacketSize==1 (i.e. complex with 128bits registers) then the storage-order of panel get reversed + // and methods like packetByOuterInner do not make sense anymore in this context. + // So let's just by pass "vectorization" in this case: + if(PacketSize==1) + return internal::pset1(coeff(idx)); + + typedef typename internal::redux_evaluator PanelEvaluator; + PanelEvaluator panel_eval(panel); + typedef typename MemberOp::BinaryOp BinaryOp; + PacketType p = internal::packetwise_redux_impl::template run(panel_eval,m_functor.binaryFunc(),m_arg.outerSize()); + return p; + } + +protected: + ConstArgTypeNested m_arg; + const MemberOp m_functor; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_PARTIALREDUX_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/PermutationMatrix.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/PermutationMatrix.h new file mode 100644 index 0000000..69401bf --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/PermutationMatrix.h @@ -0,0 +1,605 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Benoit Jacob +// Copyright (C) 2009-2015 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PERMUTATIONMATRIX_H +#define EIGEN_PERMUTATIONMATRIX_H + +namespace Eigen { + +namespace internal { + +enum PermPermProduct_t {PermPermProduct}; + +} // end namespace internal + +/** \class PermutationBase + * \ingroup Core_Module + * + * \brief Base class for permutations + * + * \tparam Derived the derived class + * + * This class is the base class for all expressions representing a permutation matrix, + * internally stored as a vector of integers. + * The convention followed here is that if \f$ \sigma \f$ is a permutation, the corresponding permutation matrix + * \f$ P_\sigma \f$ is such that if \f$ (e_1,\ldots,e_p) \f$ is the canonical basis, we have: + * \f[ P_\sigma(e_i) = e_{\sigma(i)}. \f] + * This convention ensures that for any two permutations \f$ \sigma, \tau \f$, we have: + * \f[ P_{\sigma\circ\tau} = P_\sigma P_\tau. \f] + * + * Permutation matrices are square and invertible. + * + * Notice that in addition to the member functions and operators listed here, there also are non-member + * operator* to multiply any kind of permutation object with any kind of matrix expression (MatrixBase) + * on either side. + * + * \sa class PermutationMatrix, class PermutationWrapper + */ +template +class PermutationBase : public EigenBase +{ + typedef internal::traits Traits; + typedef EigenBase Base; + public: + + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Traits::IndicesType IndicesType; + enum { + Flags = Traits::Flags, + RowsAtCompileTime = Traits::RowsAtCompileTime, + ColsAtCompileTime = Traits::ColsAtCompileTime, + MaxRowsAtCompileTime = Traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = Traits::MaxColsAtCompileTime + }; + typedef typename Traits::StorageIndex StorageIndex; + typedef Matrix + DenseMatrixType; + typedef PermutationMatrix + PlainPermutationType; + typedef PlainPermutationType PlainObject; + using Base::derived; + typedef Inverse InverseReturnType; + typedef void Scalar; + #endif + + /** Copies the other permutation into *this */ + template + Derived& operator=(const PermutationBase& other) + { + indices() = other.indices(); + return derived(); + } + + /** Assignment from the Transpositions \a tr */ + template + Derived& operator=(const TranspositionsBase& tr) + { + setIdentity(tr.size()); + for(Index k=size()-1; k>=0; --k) + applyTranspositionOnTheRight(k,tr.coeff(k)); + return derived(); + } + + /** \returns the number of rows */ + inline EIGEN_DEVICE_FUNC Index rows() const { return Index(indices().size()); } + + /** \returns the number of columns */ + inline EIGEN_DEVICE_FUNC Index cols() const { return Index(indices().size()); } + + /** \returns the size of a side of the respective square matrix, i.e., the number of indices */ + inline EIGEN_DEVICE_FUNC Index size() const { return Index(indices().size()); } + + #ifndef EIGEN_PARSED_BY_DOXYGEN + template + void evalTo(MatrixBase& other) const + { + other.setZero(); + for (Index i=0; i=0 && j>=0 && i=0 && j>=0 && i + void assignTranspose(const PermutationBase& other) + { + for (Index i=0; i + void assignProduct(const Lhs& lhs, const Rhs& rhs) + { + eigen_assert(lhs.cols() == rhs.rows()); + for (Index i=0; i + inline PlainPermutationType operator*(const PermutationBase& other) const + { return PlainPermutationType(internal::PermPermProduct, derived(), other.derived()); } + + /** \returns the product of a permutation with another inverse permutation. + * + * \note \blank \note_try_to_help_rvo + */ + template + inline PlainPermutationType operator*(const InverseImpl& other) const + { return PlainPermutationType(internal::PermPermProduct, *this, other.eval()); } + + /** \returns the product of an inverse permutation with another permutation. + * + * \note \blank \note_try_to_help_rvo + */ + template friend + inline PlainPermutationType operator*(const InverseImpl& other, const PermutationBase& perm) + { return PlainPermutationType(internal::PermPermProduct, other.eval(), perm); } + + /** \returns the determinant of the permutation matrix, which is either 1 or -1 depending on the parity of the permutation. + * + * This function is O(\c n) procedure allocating a buffer of \c n booleans. + */ + Index determinant() const + { + Index res = 1; + Index n = size(); + Matrix mask(n); + mask.fill(false); + Index r = 0; + while(r < n) + { + // search for the next seed + while(r=n) + break; + // we got one, let's follow it until we are back to the seed + Index k0 = r++; + mask.coeffRef(k0) = true; + for(Index k=indices().coeff(k0); k!=k0; k=indices().coeff(k)) + { + mask.coeffRef(k) = true; + res = -res; + } + } + return res; + } + + protected: + +}; + +namespace internal { +template +struct traits > + : traits > +{ + typedef PermutationStorage StorageKind; + typedef Matrix<_StorageIndex, SizeAtCompileTime, 1, 0, MaxSizeAtCompileTime, 1> IndicesType; + typedef _StorageIndex StorageIndex; + typedef void Scalar; +}; +} + +/** \class PermutationMatrix + * \ingroup Core_Module + * + * \brief Permutation matrix + * + * \tparam SizeAtCompileTime the number of rows/cols, or Dynamic + * \tparam MaxSizeAtCompileTime the maximum number of rows/cols, or Dynamic. This optional parameter defaults to SizeAtCompileTime. Most of the time, you should not have to specify it. + * \tparam _StorageIndex the integer type of the indices + * + * This class represents a permutation matrix, internally stored as a vector of integers. + * + * \sa class PermutationBase, class PermutationWrapper, class DiagonalMatrix + */ +template +class PermutationMatrix : public PermutationBase > +{ + typedef PermutationBase Base; + typedef internal::traits Traits; + public: + + typedef const PermutationMatrix& Nested; + + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Traits::IndicesType IndicesType; + typedef typename Traits::StorageIndex StorageIndex; + #endif + + inline PermutationMatrix() + {} + + /** Constructs an uninitialized permutation matrix of given size. + */ + explicit inline PermutationMatrix(Index size) : m_indices(size) + { + eigen_internal_assert(size <= NumTraits::highest()); + } + + /** Copy constructor. */ + template + inline PermutationMatrix(const PermutationBase& other) + : m_indices(other.indices()) {} + + /** Generic constructor from expression of the indices. The indices + * array has the meaning that the permutations sends each integer i to indices[i]. + * + * \warning It is your responsibility to check that the indices array that you passes actually + * describes a permutation, i.e., each value between 0 and n-1 occurs exactly once, where n is the + * array's size. + */ + template + explicit inline PermutationMatrix(const MatrixBase& indices) : m_indices(indices) + {} + + /** Convert the Transpositions \a tr to a permutation matrix */ + template + explicit PermutationMatrix(const TranspositionsBase& tr) + : m_indices(tr.size()) + { + *this = tr; + } + + /** Copies the other permutation into *this */ + template + PermutationMatrix& operator=(const PermutationBase& other) + { + m_indices = other.indices(); + return *this; + } + + /** Assignment from the Transpositions \a tr */ + template + PermutationMatrix& operator=(const TranspositionsBase& tr) + { + return Base::operator=(tr.derived()); + } + + /** const version of indices(). */ + const IndicesType& indices() const { return m_indices; } + /** \returns a reference to the stored array representing the permutation. */ + IndicesType& indices() { return m_indices; } + + + /**** multiplication helpers to hopefully get RVO ****/ + +#ifndef EIGEN_PARSED_BY_DOXYGEN + template + PermutationMatrix(const InverseImpl& other) + : m_indices(other.derived().nestedExpression().size()) + { + eigen_internal_assert(m_indices.size() <= NumTraits::highest()); + StorageIndex end = StorageIndex(m_indices.size()); + for (StorageIndex i=0; i + PermutationMatrix(internal::PermPermProduct_t, const Lhs& lhs, const Rhs& rhs) + : m_indices(lhs.indices().size()) + { + Base::assignProduct(lhs,rhs); + } +#endif + + protected: + + IndicesType m_indices; +}; + + +namespace internal { +template +struct traits,_PacketAccess> > + : traits > +{ + typedef PermutationStorage StorageKind; + typedef Map, _PacketAccess> IndicesType; + typedef _StorageIndex StorageIndex; + typedef void Scalar; +}; +} + +template +class Map,_PacketAccess> + : public PermutationBase,_PacketAccess> > +{ + typedef PermutationBase Base; + typedef internal::traits Traits; + public: + + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Traits::IndicesType IndicesType; + typedef typename IndicesType::Scalar StorageIndex; + #endif + + inline Map(const StorageIndex* indicesPtr) + : m_indices(indicesPtr) + {} + + inline Map(const StorageIndex* indicesPtr, Index size) + : m_indices(indicesPtr,size) + {} + + /** Copies the other permutation into *this */ + template + Map& operator=(const PermutationBase& other) + { return Base::operator=(other.derived()); } + + /** Assignment from the Transpositions \a tr */ + template + Map& operator=(const TranspositionsBase& tr) + { return Base::operator=(tr.derived()); } + + #ifndef EIGEN_PARSED_BY_DOXYGEN + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + Map& operator=(const Map& other) + { + m_indices = other.m_indices; + return *this; + } + #endif + + /** const version of indices(). */ + const IndicesType& indices() const { return m_indices; } + /** \returns a reference to the stored array representing the permutation. */ + IndicesType& indices() { return m_indices; } + + protected: + + IndicesType m_indices; +}; + +template class TranspositionsWrapper; +namespace internal { +template +struct traits > +{ + typedef PermutationStorage StorageKind; + typedef void Scalar; + typedef typename _IndicesType::Scalar StorageIndex; + typedef _IndicesType IndicesType; + enum { + RowsAtCompileTime = _IndicesType::SizeAtCompileTime, + ColsAtCompileTime = _IndicesType::SizeAtCompileTime, + MaxRowsAtCompileTime = IndicesType::MaxSizeAtCompileTime, + MaxColsAtCompileTime = IndicesType::MaxSizeAtCompileTime, + Flags = 0 + }; +}; +} + +/** \class PermutationWrapper + * \ingroup Core_Module + * + * \brief Class to view a vector of integers as a permutation matrix + * + * \tparam _IndicesType the type of the vector of integer (can be any compatible expression) + * + * This class allows to view any vector expression of integers as a permutation matrix. + * + * \sa class PermutationBase, class PermutationMatrix + */ +template +class PermutationWrapper : public PermutationBase > +{ + typedef PermutationBase Base; + typedef internal::traits Traits; + public: + + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Traits::IndicesType IndicesType; + #endif + + inline PermutationWrapper(const IndicesType& indices) + : m_indices(indices) + {} + + /** const version of indices(). */ + const typename internal::remove_all::type& + indices() const { return m_indices; } + + protected: + + typename IndicesType::Nested m_indices; +}; + + +/** \returns the matrix with the permutation applied to the columns. + */ +template +EIGEN_DEVICE_FUNC +const Product +operator*(const MatrixBase &matrix, + const PermutationBase& permutation) +{ + return Product + (matrix.derived(), permutation.derived()); +} + +/** \returns the matrix with the permutation applied to the rows. + */ +template +EIGEN_DEVICE_FUNC +const Product +operator*(const PermutationBase &permutation, + const MatrixBase& matrix) +{ + return Product + (permutation.derived(), matrix.derived()); +} + + +template +class InverseImpl + : public EigenBase > +{ + typedef typename PermutationType::PlainPermutationType PlainPermutationType; + typedef internal::traits PermTraits; + protected: + InverseImpl() {} + public: + typedef Inverse InverseType; + using EigenBase >::derived; + + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename PermutationType::DenseMatrixType DenseMatrixType; + enum { + RowsAtCompileTime = PermTraits::RowsAtCompileTime, + ColsAtCompileTime = PermTraits::ColsAtCompileTime, + MaxRowsAtCompileTime = PermTraits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = PermTraits::MaxColsAtCompileTime + }; + #endif + + #ifndef EIGEN_PARSED_BY_DOXYGEN + template + void evalTo(MatrixBase& other) const + { + other.setZero(); + for (Index i=0; i friend + const Product + operator*(const MatrixBase& matrix, const InverseType& trPerm) + { + return Product(matrix.derived(), trPerm.derived()); + } + + /** \returns the matrix with the inverse permutation applied to the rows. + */ + template + const Product + operator*(const MatrixBase& matrix) const + { + return Product(derived(), matrix.derived()); + } +}; + +template +const PermutationWrapper MatrixBase::asPermutation() const +{ + return derived(); +} + +namespace internal { + +template<> struct AssignmentKind { typedef EigenBase2EigenBase Kind; }; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_PERMUTATIONMATRIX_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/PlainObjectBase.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/PlainObjectBase.h new file mode 100644 index 0000000..e2ddbd1 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/PlainObjectBase.h @@ -0,0 +1,1128 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2009 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DENSESTORAGEBASE_H +#define EIGEN_DENSESTORAGEBASE_H + +#if defined(EIGEN_INITIALIZE_MATRICES_BY_ZERO) +# define EIGEN_INITIALIZE_COEFFS +# define EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED for(Index i=0;i::quiet_NaN(); +#else +# undef EIGEN_INITIALIZE_COEFFS +# define EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED +#endif + +namespace Eigen { + +namespace internal { + +template struct check_rows_cols_for_overflow { + template + EIGEN_DEVICE_FUNC + static EIGEN_ALWAYS_INLINE void run(Index, Index) + { + } +}; + +template<> struct check_rows_cols_for_overflow { + template + EIGEN_DEVICE_FUNC + static EIGEN_ALWAYS_INLINE void run(Index rows, Index cols) + { + // http://hg.mozilla.org/mozilla-central/file/6c8a909977d3/xpcom/ds/CheckedInt.h#l242 + // we assume Index is signed + Index max_index = (std::size_t(1) << (8 * sizeof(Index) - 1)) - 1; // assume Index is signed + bool error = (rows == 0 || cols == 0) ? false + : (rows > max_index / cols); + if (error) + throw_std_bad_alloc(); + } +}; + +template +struct conservative_resize_like_impl; + +template struct matrix_swap_impl; + +} // end namespace internal + +#ifdef EIGEN_PARSED_BY_DOXYGEN +namespace doxygen { + +// This is a workaround to doxygen not being able to understand the inheritance logic +// when it is hidden by the dense_xpr_base helper struct. +// Moreover, doxygen fails to include members that are not documented in the declaration body of +// MatrixBase if we inherits MatrixBase >, +// this is why we simply inherits MatrixBase, though this does not make sense. + +/** This class is just a workaround for Doxygen and it does not not actually exist. */ +template struct dense_xpr_base_dispatcher; +/** This class is just a workaround for Doxygen and it does not not actually exist. */ +template +struct dense_xpr_base_dispatcher > + : public MatrixBase {}; +/** This class is just a workaround for Doxygen and it does not not actually exist. */ +template +struct dense_xpr_base_dispatcher > + : public ArrayBase {}; + +} // namespace doxygen + +/** \class PlainObjectBase + * \ingroup Core_Module + * \brief %Dense storage base class for matrices and arrays. + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_PLAINOBJECTBASE_PLUGIN. + * + * \tparam Derived is the derived type, e.g., a Matrix or Array + * + * \sa \ref TopicClassHierarchy + */ +template +class PlainObjectBase : public doxygen::dense_xpr_base_dispatcher +#else +template +class PlainObjectBase : public internal::dense_xpr_base::type +#endif +{ + public: + enum { Options = internal::traits::Options }; + typedef typename internal::dense_xpr_base::type Base; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + typedef Derived DenseType; + + using Base::RowsAtCompileTime; + using Base::ColsAtCompileTime; + using Base::SizeAtCompileTime; + using Base::MaxRowsAtCompileTime; + using Base::MaxColsAtCompileTime; + using Base::MaxSizeAtCompileTime; + using Base::IsVectorAtCompileTime; + using Base::Flags; + + typedef Eigen::Map MapType; + typedef const Eigen::Map ConstMapType; + typedef Eigen::Map AlignedMapType; + typedef const Eigen::Map ConstAlignedMapType; + template struct StridedMapType { typedef Eigen::Map type; }; + template struct StridedConstMapType { typedef Eigen::Map type; }; + template struct StridedAlignedMapType { typedef Eigen::Map type; }; + template struct StridedConstAlignedMapType { typedef Eigen::Map type; }; + + protected: + DenseStorage m_storage; + + public: + enum { NeedsToAlign = (SizeAtCompileTime != Dynamic) && (internal::traits::Alignment>0) }; + EIGEN_MAKE_ALIGNED_OPERATOR_NEW_IF(NeedsToAlign) + + EIGEN_DEVICE_FUNC + Base& base() { return *static_cast(this); } + EIGEN_DEVICE_FUNC + const Base& base() const { return *static_cast(this); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rows() const EIGEN_NOEXCEPT { return m_storage.rows(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index cols() const EIGEN_NOEXCEPT { return m_storage.cols(); } + + /** This is an overloaded version of DenseCoeffsBase::coeff(Index,Index) const + * provided to by-pass the creation of an evaluator of the expression, thus saving compilation efforts. + * + * See DenseCoeffsBase::coeff(Index) const for details. */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE const Scalar& coeff(Index rowId, Index colId) const + { + if(Flags & RowMajorBit) + return m_storage.data()[colId + rowId * m_storage.cols()]; + else // column-major + return m_storage.data()[rowId + colId * m_storage.rows()]; + } + + /** This is an overloaded version of DenseCoeffsBase::coeff(Index) const + * provided to by-pass the creation of an evaluator of the expression, thus saving compilation efforts. + * + * See DenseCoeffsBase::coeff(Index) const for details. */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE const Scalar& coeff(Index index) const + { + return m_storage.data()[index]; + } + + /** This is an overloaded version of DenseCoeffsBase::coeffRef(Index,Index) const + * provided to by-pass the creation of an evaluator of the expression, thus saving compilation efforts. + * + * See DenseCoeffsBase::coeffRef(Index,Index) const for details. */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& coeffRef(Index rowId, Index colId) + { + if(Flags & RowMajorBit) + return m_storage.data()[colId + rowId * m_storage.cols()]; + else // column-major + return m_storage.data()[rowId + colId * m_storage.rows()]; + } + + /** This is an overloaded version of DenseCoeffsBase::coeffRef(Index) const + * provided to by-pass the creation of an evaluator of the expression, thus saving compilation efforts. + * + * See DenseCoeffsBase::coeffRef(Index) const for details. */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& coeffRef(Index index) + { + return m_storage.data()[index]; + } + + /** This is the const version of coeffRef(Index,Index) which is thus synonym of coeff(Index,Index). + * It is provided for convenience. */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE const Scalar& coeffRef(Index rowId, Index colId) const + { + if(Flags & RowMajorBit) + return m_storage.data()[colId + rowId * m_storage.cols()]; + else // column-major + return m_storage.data()[rowId + colId * m_storage.rows()]; + } + + /** This is the const version of coeffRef(Index) which is thus synonym of coeff(Index). + * It is provided for convenience. */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE const Scalar& coeffRef(Index index) const + { + return m_storage.data()[index]; + } + + /** \internal */ + template + EIGEN_STRONG_INLINE PacketScalar packet(Index rowId, Index colId) const + { + return internal::ploadt + (m_storage.data() + (Flags & RowMajorBit + ? colId + rowId * m_storage.cols() + : rowId + colId * m_storage.rows())); + } + + /** \internal */ + template + EIGEN_STRONG_INLINE PacketScalar packet(Index index) const + { + return internal::ploadt(m_storage.data() + index); + } + + /** \internal */ + template + EIGEN_STRONG_INLINE void writePacket(Index rowId, Index colId, const PacketScalar& val) + { + internal::pstoret + (m_storage.data() + (Flags & RowMajorBit + ? colId + rowId * m_storage.cols() + : rowId + colId * m_storage.rows()), val); + } + + /** \internal */ + template + EIGEN_STRONG_INLINE void writePacket(Index index, const PacketScalar& val) + { + internal::pstoret(m_storage.data() + index, val); + } + + /** \returns a const pointer to the data array of this matrix */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar *data() const + { return m_storage.data(); } + + /** \returns a pointer to the data array of this matrix */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar *data() + { return m_storage.data(); } + + /** Resizes \c *this to a \a rows x \a cols matrix. + * + * This method is intended for dynamic-size matrices, although it is legal to call it on any + * matrix as long as fixed dimensions are left unchanged. If you only want to change the number + * of rows and/or of columns, you can use resize(NoChange_t, Index), resize(Index, NoChange_t). + * + * If the current number of coefficients of \c *this exactly matches the + * product \a rows * \a cols, then no memory allocation is performed and + * the current values are left unchanged. In all other cases, including + * shrinking, the data is reallocated and all previous values are lost. + * + * Example: \include Matrix_resize_int_int.cpp + * Output: \verbinclude Matrix_resize_int_int.out + * + * \sa resize(Index) for vectors, resize(NoChange_t, Index), resize(Index, NoChange_t) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void resize(Index rows, Index cols) + { + eigen_assert( EIGEN_IMPLIES(RowsAtCompileTime!=Dynamic,rows==RowsAtCompileTime) + && EIGEN_IMPLIES(ColsAtCompileTime!=Dynamic,cols==ColsAtCompileTime) + && EIGEN_IMPLIES(RowsAtCompileTime==Dynamic && MaxRowsAtCompileTime!=Dynamic,rows<=MaxRowsAtCompileTime) + && EIGEN_IMPLIES(ColsAtCompileTime==Dynamic && MaxColsAtCompileTime!=Dynamic,cols<=MaxColsAtCompileTime) + && rows>=0 && cols>=0 && "Invalid sizes when resizing a matrix or array."); + internal::check_rows_cols_for_overflow::run(rows, cols); + #ifdef EIGEN_INITIALIZE_COEFFS + Index size = rows*cols; + bool size_changed = size != this->size(); + m_storage.resize(size, rows, cols); + if(size_changed) EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + #else + m_storage.resize(rows*cols, rows, cols); + #endif + } + + /** Resizes \c *this to a vector of length \a size + * + * \only_for_vectors. This method does not work for + * partially dynamic matrices when the static dimension is anything other + * than 1. For example it will not work with Matrix. + * + * Example: \include Matrix_resize_int.cpp + * Output: \verbinclude Matrix_resize_int.out + * + * \sa resize(Index,Index), resize(NoChange_t, Index), resize(Index, NoChange_t) + */ + EIGEN_DEVICE_FUNC + inline void resize(Index size) + { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(PlainObjectBase) + eigen_assert(((SizeAtCompileTime == Dynamic && (MaxSizeAtCompileTime==Dynamic || size<=MaxSizeAtCompileTime)) || SizeAtCompileTime == size) && size>=0); + #ifdef EIGEN_INITIALIZE_COEFFS + bool size_changed = size != this->size(); + #endif + if(RowsAtCompileTime == 1) + m_storage.resize(size, 1, size); + else + m_storage.resize(size, size, 1); + #ifdef EIGEN_INITIALIZE_COEFFS + if(size_changed) EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + #endif + } + + /** Resizes the matrix, changing only the number of columns. For the parameter of type NoChange_t, just pass the special value \c NoChange + * as in the example below. + * + * Example: \include Matrix_resize_NoChange_int.cpp + * Output: \verbinclude Matrix_resize_NoChange_int.out + * + * \sa resize(Index,Index) + */ + EIGEN_DEVICE_FUNC + inline void resize(NoChange_t, Index cols) + { + resize(rows(), cols); + } + + /** Resizes the matrix, changing only the number of rows. For the parameter of type NoChange_t, just pass the special value \c NoChange + * as in the example below. + * + * Example: \include Matrix_resize_int_NoChange.cpp + * Output: \verbinclude Matrix_resize_int_NoChange.out + * + * \sa resize(Index,Index) + */ + EIGEN_DEVICE_FUNC + inline void resize(Index rows, NoChange_t) + { + resize(rows, cols()); + } + + /** Resizes \c *this to have the same dimensions as \a other. + * Takes care of doing all the checking that's needed. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void resizeLike(const EigenBase& _other) + { + const OtherDerived& other = _other.derived(); + internal::check_rows_cols_for_overflow::run(other.rows(), other.cols()); + const Index othersize = other.rows()*other.cols(); + if(RowsAtCompileTime == 1) + { + eigen_assert(other.rows() == 1 || other.cols() == 1); + resize(1, othersize); + } + else if(ColsAtCompileTime == 1) + { + eigen_assert(other.rows() == 1 || other.cols() == 1); + resize(othersize, 1); + } + else resize(other.rows(), other.cols()); + } + + /** Resizes the matrix to \a rows x \a cols while leaving old values untouched. + * + * The method is intended for matrices of dynamic size. If you only want to change the number + * of rows and/or of columns, you can use conservativeResize(NoChange_t, Index) or + * conservativeResize(Index, NoChange_t). + * + * Matrices are resized relative to the top-left element. In case values need to be + * appended to the matrix they will be uninitialized. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void conservativeResize(Index rows, Index cols) + { + internal::conservative_resize_like_impl::run(*this, rows, cols); + } + + /** Resizes the matrix to \a rows x \a cols while leaving old values untouched. + * + * As opposed to conservativeResize(Index rows, Index cols), this version leaves + * the number of columns unchanged. + * + * In case the matrix is growing, new rows will be uninitialized. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void conservativeResize(Index rows, NoChange_t) + { + // Note: see the comment in conservativeResize(Index,Index) + conservativeResize(rows, cols()); + } + + /** Resizes the matrix to \a rows x \a cols while leaving old values untouched. + * + * As opposed to conservativeResize(Index rows, Index cols), this version leaves + * the number of rows unchanged. + * + * In case the matrix is growing, new columns will be uninitialized. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void conservativeResize(NoChange_t, Index cols) + { + // Note: see the comment in conservativeResize(Index,Index) + conservativeResize(rows(), cols); + } + + /** Resizes the vector to \a size while retaining old values. + * + * \only_for_vectors. This method does not work for + * partially dynamic matrices when the static dimension is anything other + * than 1. For example it will not work with Matrix. + * + * When values are appended, they will be uninitialized. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void conservativeResize(Index size) + { + internal::conservative_resize_like_impl::run(*this, size); + } + + /** Resizes the matrix to \a rows x \a cols of \c other, while leaving old values untouched. + * + * The method is intended for matrices of dynamic size. If you only want to change the number + * of rows and/or of columns, you can use conservativeResize(NoChange_t, Index) or + * conservativeResize(Index, NoChange_t). + * + * Matrices are resized relative to the top-left element. In case values need to be + * appended to the matrix they will copied from \c other. + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void conservativeResizeLike(const DenseBase& other) + { + internal::conservative_resize_like_impl::run(*this, other); + } + + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Derived& operator=(const PlainObjectBase& other) + { + return _set(other); + } + + /** \sa MatrixBase::lazyAssign() */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Derived& lazyAssign(const DenseBase& other) + { + _resize_to_match(other); + return Base::lazyAssign(other.derived()); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Derived& operator=(const ReturnByValue& func) + { + resize(func.rows(), func.cols()); + return Base::operator=(func); + } + + // Prevent user from trying to instantiate PlainObjectBase objects + // by making all its constructor protected. See bug 1074. + protected: + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE PlainObjectBase() : m_storage() + { +// _check_template_params(); +// EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + // FIXME is it still needed ? + /** \internal */ + EIGEN_DEVICE_FUNC + explicit PlainObjectBase(internal::constructor_without_unaligned_array_assert) + : m_storage(internal::constructor_without_unaligned_array_assert()) + { +// _check_template_params(); EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + } +#endif + +#if EIGEN_HAS_RVALUE_REFERENCES + EIGEN_DEVICE_FUNC + PlainObjectBase(PlainObjectBase&& other) EIGEN_NOEXCEPT + : m_storage( std::move(other.m_storage) ) + { + } + + EIGEN_DEVICE_FUNC + PlainObjectBase& operator=(PlainObjectBase&& other) EIGEN_NOEXCEPT + { + _check_template_params(); + m_storage = std::move(other.m_storage); + return *this; + } +#endif + + /** Copy constructor */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE PlainObjectBase(const PlainObjectBase& other) + : Base(), m_storage(other.m_storage) { } + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE PlainObjectBase(Index size, Index rows, Index cols) + : m_storage(size, rows, cols) + { +// _check_template_params(); +// EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + } + + #if EIGEN_HAS_CXX11 + /** \brief Construct a row of column vector with fixed size from an arbitrary number of coefficients. \cpp11 + * + * \only_for_vectors + * + * This constructor is for 1D array or vectors with more than 4 coefficients. + * There exists C++98 analogue constructors for fixed-size array/vector having 1, 2, 3, or 4 coefficients. + * + * \warning To construct a column (resp. row) vector of fixed length, the number of values passed to this + * constructor must match the the fixed number of rows (resp. columns) of \c *this. + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + PlainObjectBase(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + : m_storage() + { + _check_template_params(); + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, sizeof...(args) + 4); + m_storage.data()[0] = a0; + m_storage.data()[1] = a1; + m_storage.data()[2] = a2; + m_storage.data()[3] = a3; + Index i = 4; + auto x = {(m_storage.data()[i++] = args, 0)...}; + static_cast(x); + } + + /** \brief Constructs a Matrix or Array and initializes it by elements given by an initializer list of initializer + * lists \cpp11 + */ + EIGEN_DEVICE_FUNC + explicit EIGEN_STRONG_INLINE PlainObjectBase(const std::initializer_list>& list) + : m_storage() + { + _check_template_params(); + + size_t list_size = 0; + if (list.begin() != list.end()) { + list_size = list.begin()->size(); + } + + // This is to allow syntax like VectorXi {{1, 2, 3, 4}} + if (ColsAtCompileTime == 1 && list.size() == 1) { + eigen_assert(list_size == static_cast(RowsAtCompileTime) || RowsAtCompileTime == Dynamic); + resize(list_size, ColsAtCompileTime); + std::copy(list.begin()->begin(), list.begin()->end(), m_storage.data()); + } else { + eigen_assert(list.size() == static_cast(RowsAtCompileTime) || RowsAtCompileTime == Dynamic); + eigen_assert(list_size == static_cast(ColsAtCompileTime) || ColsAtCompileTime == Dynamic); + resize(list.size(), list_size); + + Index row_index = 0; + for (const std::initializer_list& row : list) { + eigen_assert(list_size == row.size()); + Index col_index = 0; + for (const Scalar& e : row) { + coeffRef(row_index, col_index) = e; + ++col_index; + } + ++row_index; + } + } + } + #endif // end EIGEN_HAS_CXX11 + + /** \sa PlainObjectBase::operator=(const EigenBase&) */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE PlainObjectBase(const DenseBase &other) + : m_storage() + { + _check_template_params(); + resizeLike(other); + _set_noalias(other); + } + + /** \sa PlainObjectBase::operator=(const EigenBase&) */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE PlainObjectBase(const EigenBase &other) + : m_storage() + { + _check_template_params(); + resizeLike(other); + *this = other.derived(); + } + /** \brief Copy constructor with in-place evaluation */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE PlainObjectBase(const ReturnByValue& other) + { + _check_template_params(); + // FIXME this does not automatically transpose vectors if necessary + resize(other.rows(), other.cols()); + other.evalTo(this->derived()); + } + + public: + + /** \brief Copies the generic expression \a other into *this. + * \copydetails DenseBase::operator=(const EigenBase &other) + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Derived& operator=(const EigenBase &other) + { + _resize_to_match(other); + Base::operator=(other.derived()); + return this->derived(); + } + + /** \name Map + * These are convenience functions returning Map objects. The Map() static functions return unaligned Map objects, + * while the AlignedMap() functions return aligned Map objects and thus should be called only with 16-byte-aligned + * \a data pointers. + * + * Here is an example using strides: + * \include Matrix_Map_stride.cpp + * Output: \verbinclude Matrix_Map_stride.out + * + * \see class Map + */ + //@{ + static inline ConstMapType Map(const Scalar* data) + { return ConstMapType(data); } + static inline MapType Map(Scalar* data) + { return MapType(data); } + static inline ConstMapType Map(const Scalar* data, Index size) + { return ConstMapType(data, size); } + static inline MapType Map(Scalar* data, Index size) + { return MapType(data, size); } + static inline ConstMapType Map(const Scalar* data, Index rows, Index cols) + { return ConstMapType(data, rows, cols); } + static inline MapType Map(Scalar* data, Index rows, Index cols) + { return MapType(data, rows, cols); } + + static inline ConstAlignedMapType MapAligned(const Scalar* data) + { return ConstAlignedMapType(data); } + static inline AlignedMapType MapAligned(Scalar* data) + { return AlignedMapType(data); } + static inline ConstAlignedMapType MapAligned(const Scalar* data, Index size) + { return ConstAlignedMapType(data, size); } + static inline AlignedMapType MapAligned(Scalar* data, Index size) + { return AlignedMapType(data, size); } + static inline ConstAlignedMapType MapAligned(const Scalar* data, Index rows, Index cols) + { return ConstAlignedMapType(data, rows, cols); } + static inline AlignedMapType MapAligned(Scalar* data, Index rows, Index cols) + { return AlignedMapType(data, rows, cols); } + + template + static inline typename StridedConstMapType >::type Map(const Scalar* data, const Stride& stride) + { return typename StridedConstMapType >::type(data, stride); } + template + static inline typename StridedMapType >::type Map(Scalar* data, const Stride& stride) + { return typename StridedMapType >::type(data, stride); } + template + static inline typename StridedConstMapType >::type Map(const Scalar* data, Index size, const Stride& stride) + { return typename StridedConstMapType >::type(data, size, stride); } + template + static inline typename StridedMapType >::type Map(Scalar* data, Index size, const Stride& stride) + { return typename StridedMapType >::type(data, size, stride); } + template + static inline typename StridedConstMapType >::type Map(const Scalar* data, Index rows, Index cols, const Stride& stride) + { return typename StridedConstMapType >::type(data, rows, cols, stride); } + template + static inline typename StridedMapType >::type Map(Scalar* data, Index rows, Index cols, const Stride& stride) + { return typename StridedMapType >::type(data, rows, cols, stride); } + + template + static inline typename StridedConstAlignedMapType >::type MapAligned(const Scalar* data, const Stride& stride) + { return typename StridedConstAlignedMapType >::type(data, stride); } + template + static inline typename StridedAlignedMapType >::type MapAligned(Scalar* data, const Stride& stride) + { return typename StridedAlignedMapType >::type(data, stride); } + template + static inline typename StridedConstAlignedMapType >::type MapAligned(const Scalar* data, Index size, const Stride& stride) + { return typename StridedConstAlignedMapType >::type(data, size, stride); } + template + static inline typename StridedAlignedMapType >::type MapAligned(Scalar* data, Index size, const Stride& stride) + { return typename StridedAlignedMapType >::type(data, size, stride); } + template + static inline typename StridedConstAlignedMapType >::type MapAligned(const Scalar* data, Index rows, Index cols, const Stride& stride) + { return typename StridedConstAlignedMapType >::type(data, rows, cols, stride); } + template + static inline typename StridedAlignedMapType >::type MapAligned(Scalar* data, Index rows, Index cols, const Stride& stride) + { return typename StridedAlignedMapType >::type(data, rows, cols, stride); } + //@} + + using Base::setConstant; + EIGEN_DEVICE_FUNC Derived& setConstant(Index size, const Scalar& val); + EIGEN_DEVICE_FUNC Derived& setConstant(Index rows, Index cols, const Scalar& val); + EIGEN_DEVICE_FUNC Derived& setConstant(NoChange_t, Index cols, const Scalar& val); + EIGEN_DEVICE_FUNC Derived& setConstant(Index rows, NoChange_t, const Scalar& val); + + using Base::setZero; + EIGEN_DEVICE_FUNC Derived& setZero(Index size); + EIGEN_DEVICE_FUNC Derived& setZero(Index rows, Index cols); + EIGEN_DEVICE_FUNC Derived& setZero(NoChange_t, Index cols); + EIGEN_DEVICE_FUNC Derived& setZero(Index rows, NoChange_t); + + using Base::setOnes; + EIGEN_DEVICE_FUNC Derived& setOnes(Index size); + EIGEN_DEVICE_FUNC Derived& setOnes(Index rows, Index cols); + EIGEN_DEVICE_FUNC Derived& setOnes(NoChange_t, Index cols); + EIGEN_DEVICE_FUNC Derived& setOnes(Index rows, NoChange_t); + + using Base::setRandom; + Derived& setRandom(Index size); + Derived& setRandom(Index rows, Index cols); + Derived& setRandom(NoChange_t, Index cols); + Derived& setRandom(Index rows, NoChange_t); + + #ifdef EIGEN_PLAINOBJECTBASE_PLUGIN + #include EIGEN_PLAINOBJECTBASE_PLUGIN + #endif + + protected: + /** \internal Resizes *this in preparation for assigning \a other to it. + * Takes care of doing all the checking that's needed. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _resize_to_match(const EigenBase& other) + { + #ifdef EIGEN_NO_AUTOMATIC_RESIZING + eigen_assert((this->size()==0 || (IsVectorAtCompileTime ? (this->size() == other.size()) + : (rows() == other.rows() && cols() == other.cols()))) + && "Size mismatch. Automatic resizing is disabled because EIGEN_NO_AUTOMATIC_RESIZING is defined"); + EIGEN_ONLY_USED_FOR_DEBUG(other); + #else + resizeLike(other); + #endif + } + + /** + * \brief Copies the value of the expression \a other into \c *this with automatic resizing. + * + * *this might be resized to match the dimensions of \a other. If *this was a null matrix (not already initialized), + * it will be initialized. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + * + * \sa operator=(const MatrixBase&), _set_noalias() + * + * \internal + */ + // aliasing is dealt once in internal::call_assignment + // so at this stage we have to assume aliasing... and resising has to be done later. + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Derived& _set(const DenseBase& other) + { + internal::call_assignment(this->derived(), other.derived()); + return this->derived(); + } + + /** \internal Like _set() but additionally makes the assumption that no aliasing effect can happen (which + * is the case when creating a new matrix) so one can enforce lazy evaluation. + * + * \sa operator=(const MatrixBase&), _set() + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Derived& _set_noalias(const DenseBase& other) + { + // I don't think we need this resize call since the lazyAssign will anyways resize + // and lazyAssign will be called by the assign selector. + //_resize_to_match(other); + // the 'false' below means to enforce lazy evaluation. We don't use lazyAssign() because + // it wouldn't allow to copy a row-vector into a column-vector. + internal::call_assignment_no_alias(this->derived(), other.derived(), internal::assign_op()); + return this->derived(); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init2(Index rows, Index cols, typename internal::enable_if::type* = 0) + { + const bool t0_is_integer_alike = internal::is_valid_index_type::value; + const bool t1_is_integer_alike = internal::is_valid_index_type::value; + EIGEN_STATIC_ASSERT(t0_is_integer_alike && + t1_is_integer_alike, + FLOATING_POINT_ARGUMENT_PASSED__INTEGER_WAS_EXPECTED) + resize(rows,cols); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init2(const T0& val0, const T1& val1, typename internal::enable_if::type* = 0) + { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, 2) + m_storage.data()[0] = Scalar(val0); + m_storage.data()[1] = Scalar(val1); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init2(const Index& val0, const Index& val1, + typename internal::enable_if< (!internal::is_same::value) + && (internal::is_same::value) + && (internal::is_same::value) + && Base::SizeAtCompileTime==2,T1>::type* = 0) + { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, 2) + m_storage.data()[0] = Scalar(val0); + m_storage.data()[1] = Scalar(val1); + } + + // The argument is convertible to the Index type and we either have a non 1x1 Matrix, or a dynamic-sized Array, + // then the argument is meant to be the size of the object. + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(Index size, typename internal::enable_if< (Base::SizeAtCompileTime!=1 || !internal::is_convertible::value) + && ((!internal::is_same::XprKind,ArrayXpr>::value || Base::SizeAtCompileTime==Dynamic)),T>::type* = 0) + { + // NOTE MSVC 2008 complains if we directly put bool(NumTraits::IsInteger) as the EIGEN_STATIC_ASSERT argument. + const bool is_integer_alike = internal::is_valid_index_type::value; + EIGEN_UNUSED_VARIABLE(is_integer_alike); + EIGEN_STATIC_ASSERT(is_integer_alike, + FLOATING_POINT_ARGUMENT_PASSED__INTEGER_WAS_EXPECTED) + resize(size); + } + + // We have a 1x1 matrix/array => the argument is interpreted as the value of the unique coefficient (case where scalar type can be implicitly converted) + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const Scalar& val0, typename internal::enable_if::value,T>::type* = 0) + { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, 1) + m_storage.data()[0] = val0; + } + + // We have a 1x1 matrix/array => the argument is interpreted as the value of the unique coefficient (case where scalar type match the index type) + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const Index& val0, + typename internal::enable_if< (!internal::is_same::value) + && (internal::is_same::value) + && Base::SizeAtCompileTime==1 + && internal::is_convertible::value,T*>::type* = 0) + { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, 1) + m_storage.data()[0] = Scalar(val0); + } + + // Initialize a fixed size matrix from a pointer to raw data + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const Scalar* data){ + this->_set_noalias(ConstMapType(data)); + } + + // Initialize an arbitrary matrix from a dense expression + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const DenseBase& other){ + this->_set_noalias(other); + } + + // Initialize an arbitrary matrix from an object convertible to the Derived type. + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const Derived& other){ + this->_set_noalias(other); + } + + // Initialize an arbitrary matrix from a generic Eigen expression + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const EigenBase& other){ + this->derived() = other; + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const ReturnByValue& other) + { + resize(other.rows(), other.cols()); + other.evalTo(this->derived()); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const RotationBase& r) + { + this->derived() = r; + } + + // For fixed-size Array + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const Scalar& val0, + typename internal::enable_if< Base::SizeAtCompileTime!=Dynamic + && Base::SizeAtCompileTime!=1 + && internal::is_convertible::value + && internal::is_same::XprKind,ArrayXpr>::value,T>::type* = 0) + { + Base::setConstant(val0); + } + + // For fixed-size Array + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const Index& val0, + typename internal::enable_if< (!internal::is_same::value) + && (internal::is_same::value) + && Base::SizeAtCompileTime!=Dynamic + && Base::SizeAtCompileTime!=1 + && internal::is_convertible::value + && internal::is_same::XprKind,ArrayXpr>::value,T*>::type* = 0) + { + Base::setConstant(val0); + } + + template + friend struct internal::matrix_swap_impl; + + public: + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal + * \brief Override DenseBase::swap() since for dynamic-sized matrices + * of same type it is enough to swap the data pointers. + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void swap(DenseBase & other) + { + enum { SwapPointers = internal::is_same::value && Base::SizeAtCompileTime==Dynamic }; + internal::matrix_swap_impl::run(this->derived(), other.derived()); + } + + /** \internal + * \brief const version forwarded to DenseBase::swap + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void swap(DenseBase const & other) + { Base::swap(other.derived()); } + + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE void _check_template_params() + { + EIGEN_STATIC_ASSERT((EIGEN_IMPLIES(MaxRowsAtCompileTime==1 && MaxColsAtCompileTime!=1, (int(Options)&RowMajor)==RowMajor) + && EIGEN_IMPLIES(MaxColsAtCompileTime==1 && MaxRowsAtCompileTime!=1, (int(Options)&RowMajor)==0) + && ((RowsAtCompileTime == Dynamic) || (RowsAtCompileTime >= 0)) + && ((ColsAtCompileTime == Dynamic) || (ColsAtCompileTime >= 0)) + && ((MaxRowsAtCompileTime == Dynamic) || (MaxRowsAtCompileTime >= 0)) + && ((MaxColsAtCompileTime == Dynamic) || (MaxColsAtCompileTime >= 0)) + && (MaxRowsAtCompileTime == RowsAtCompileTime || RowsAtCompileTime==Dynamic) + && (MaxColsAtCompileTime == ColsAtCompileTime || ColsAtCompileTime==Dynamic) + && (Options & (DontAlign|RowMajor)) == Options), + INVALID_MATRIX_TEMPLATE_PARAMETERS) + } + + enum { IsPlainObjectBase = 1 }; +#endif + public: + // These apparently need to be down here for nvcc+icc to prevent duplicate + // Map symbol. + template friend class Eigen::Map; + friend class Eigen::Map; + friend class Eigen::Map; +#if EIGEN_MAX_ALIGN_BYTES>0 + // for EIGEN_MAX_ALIGN_BYTES==0, AlignedMax==Unaligned, and many compilers generate warnings for friend-ing a class twice. + friend class Eigen::Map; + friend class Eigen::Map; +#endif +}; + +namespace internal { + +template +struct conservative_resize_like_impl +{ + #if EIGEN_HAS_TYPE_TRAITS + static const bool IsRelocatable = std::is_trivially_copyable::value; + #else + static const bool IsRelocatable = !NumTraits::RequireInitialization; + #endif + static void run(DenseBase& _this, Index rows, Index cols) + { + if (_this.rows() == rows && _this.cols() == cols) return; + EIGEN_STATIC_ASSERT_DYNAMIC_SIZE(Derived) + + if ( IsRelocatable + && (( Derived::IsRowMajor && _this.cols() == cols) || // row-major and we change only the number of rows + (!Derived::IsRowMajor && _this.rows() == rows) )) // column-major and we change only the number of columns + { + internal::check_rows_cols_for_overflow::run(rows, cols); + _this.derived().m_storage.conservativeResize(rows*cols,rows,cols); + } + else + { + // The storage order does not allow us to use reallocation. + Derived tmp(rows,cols); + const Index common_rows = numext::mini(rows, _this.rows()); + const Index common_cols = numext::mini(cols, _this.cols()); + tmp.block(0,0,common_rows,common_cols) = _this.block(0,0,common_rows,common_cols); + _this.derived().swap(tmp); + } + } + + static void run(DenseBase& _this, const DenseBase& other) + { + if (_this.rows() == other.rows() && _this.cols() == other.cols()) return; + + // Note: Here is space for improvement. Basically, for conservativeResize(Index,Index), + // neither RowsAtCompileTime or ColsAtCompileTime must be Dynamic. If only one of the + // dimensions is dynamic, one could use either conservativeResize(Index rows, NoChange_t) or + // conservativeResize(NoChange_t, Index cols). For these methods new static asserts like + // EIGEN_STATIC_ASSERT_DYNAMIC_ROWS and EIGEN_STATIC_ASSERT_DYNAMIC_COLS would be good. + EIGEN_STATIC_ASSERT_DYNAMIC_SIZE(Derived) + EIGEN_STATIC_ASSERT_DYNAMIC_SIZE(OtherDerived) + + if ( IsRelocatable && + (( Derived::IsRowMajor && _this.cols() == other.cols()) || // row-major and we change only the number of rows + (!Derived::IsRowMajor && _this.rows() == other.rows()) )) // column-major and we change only the number of columns + { + const Index new_rows = other.rows() - _this.rows(); + const Index new_cols = other.cols() - _this.cols(); + _this.derived().m_storage.conservativeResize(other.size(),other.rows(),other.cols()); + if (new_rows>0) + _this.bottomRightCorner(new_rows, other.cols()) = other.bottomRows(new_rows); + else if (new_cols>0) + _this.bottomRightCorner(other.rows(), new_cols) = other.rightCols(new_cols); + } + else + { + // The storage order does not allow us to use reallocation. + Derived tmp(other); + const Index common_rows = numext::mini(tmp.rows(), _this.rows()); + const Index common_cols = numext::mini(tmp.cols(), _this.cols()); + tmp.block(0,0,common_rows,common_cols) = _this.block(0,0,common_rows,common_cols); + _this.derived().swap(tmp); + } + } +}; + +// Here, the specialization for vectors inherits from the general matrix case +// to allow calling .conservativeResize(rows,cols) on vectors. +template +struct conservative_resize_like_impl + : conservative_resize_like_impl +{ + typedef conservative_resize_like_impl Base; + using Base::run; + using Base::IsRelocatable; + + static void run(DenseBase& _this, Index size) + { + const Index new_rows = Derived::RowsAtCompileTime==1 ? 1 : size; + const Index new_cols = Derived::RowsAtCompileTime==1 ? size : 1; + if(IsRelocatable) + _this.derived().m_storage.conservativeResize(size,new_rows,new_cols); + else + Base::run(_this.derived(), new_rows, new_cols); + } + + static void run(DenseBase& _this, const DenseBase& other) + { + if (_this.rows() == other.rows() && _this.cols() == other.cols()) return; + + const Index num_new_elements = other.size() - _this.size(); + + const Index new_rows = Derived::RowsAtCompileTime==1 ? 1 : other.rows(); + const Index new_cols = Derived::RowsAtCompileTime==1 ? other.cols() : 1; + if(IsRelocatable) + _this.derived().m_storage.conservativeResize(other.size(),new_rows,new_cols); + else + Base::run(_this.derived(), new_rows, new_cols); + + if (num_new_elements > 0) + _this.tail(num_new_elements) = other.tail(num_new_elements); + } +}; + +template +struct matrix_swap_impl +{ + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE void run(MatrixTypeA& a, MatrixTypeB& b) + { + a.base().swap(b); + } +}; + +template +struct matrix_swap_impl +{ + EIGEN_DEVICE_FUNC + static inline void run(MatrixTypeA& a, MatrixTypeB& b) + { + static_cast(a).m_storage.swap(static_cast(b).m_storage); + } +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_DENSESTORAGEBASE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Product.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Product.h new file mode 100644 index 0000000..70a6c10 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Product.h @@ -0,0 +1,191 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2011 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PRODUCT_H +#define EIGEN_PRODUCT_H + +namespace Eigen { + +template class ProductImpl; + +namespace internal { + +template +struct traits > +{ + typedef typename remove_all::type LhsCleaned; + typedef typename remove_all::type RhsCleaned; + typedef traits LhsTraits; + typedef traits RhsTraits; + + typedef MatrixXpr XprKind; + + typedef typename ScalarBinaryOpTraits::Scalar, typename traits::Scalar>::ReturnType Scalar; + typedef typename product_promote_storage_type::ret>::ret StorageKind; + typedef typename promote_index_type::type StorageIndex; + + enum { + RowsAtCompileTime = LhsTraits::RowsAtCompileTime, + ColsAtCompileTime = RhsTraits::ColsAtCompileTime, + MaxRowsAtCompileTime = LhsTraits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = RhsTraits::MaxColsAtCompileTime, + + // FIXME: only needed by GeneralMatrixMatrixTriangular + InnerSize = EIGEN_SIZE_MIN_PREFER_FIXED(LhsTraits::ColsAtCompileTime, RhsTraits::RowsAtCompileTime), + + // The storage order is somewhat arbitrary here. The correct one will be determined through the evaluator. + Flags = (MaxRowsAtCompileTime==1 && MaxColsAtCompileTime!=1) ? RowMajorBit + : (MaxColsAtCompileTime==1 && MaxRowsAtCompileTime!=1) ? 0 + : ( ((LhsTraits::Flags&NoPreferredStorageOrderBit) && (RhsTraits::Flags&RowMajorBit)) + || ((RhsTraits::Flags&NoPreferredStorageOrderBit) && (LhsTraits::Flags&RowMajorBit)) ) ? RowMajorBit + : NoPreferredStorageOrderBit + }; +}; + +} // end namespace internal + +/** \class Product + * \ingroup Core_Module + * + * \brief Expression of the product of two arbitrary matrices or vectors + * + * \tparam _Lhs the type of the left-hand side expression + * \tparam _Rhs the type of the right-hand side expression + * + * This class represents an expression of the product of two arbitrary matrices. + * + * The other template parameters are: + * \tparam Option can be DefaultProduct, AliasFreeProduct, or LazyProduct + * + */ +template +class Product : public ProductImpl<_Lhs,_Rhs,Option, + typename internal::product_promote_storage_type::StorageKind, + typename internal::traits<_Rhs>::StorageKind, + internal::product_type<_Lhs,_Rhs>::ret>::ret> +{ + public: + + typedef _Lhs Lhs; + typedef _Rhs Rhs; + + typedef typename ProductImpl< + Lhs, Rhs, Option, + typename internal::product_promote_storage_type::StorageKind, + typename internal::traits::StorageKind, + internal::product_type::ret>::ret>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(Product) + + typedef typename internal::ref_selector::type LhsNested; + typedef typename internal::ref_selector::type RhsNested; + typedef typename internal::remove_all::type LhsNestedCleaned; + typedef typename internal::remove_all::type RhsNestedCleaned; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Product(const Lhs& lhs, const Rhs& rhs) : m_lhs(lhs), m_rhs(rhs) + { + eigen_assert(lhs.cols() == rhs.rows() + && "invalid matrix product" + && "if you wanted a coeff-wise or a dot product use the respective explicit functions"); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rows() const EIGEN_NOEXCEPT { return m_lhs.rows(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index cols() const EIGEN_NOEXCEPT { return m_rhs.cols(); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const LhsNestedCleaned& lhs() const { return m_lhs; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const RhsNestedCleaned& rhs() const { return m_rhs; } + + protected: + + LhsNested m_lhs; + RhsNested m_rhs; +}; + +namespace internal { + +template::ret> +class dense_product_base + : public internal::dense_xpr_base >::type +{}; + +/** Conversion to scalar for inner-products */ +template +class dense_product_base + : public internal::dense_xpr_base >::type +{ + typedef Product ProductXpr; + typedef typename internal::dense_xpr_base::type Base; +public: + using Base::derived; + typedef typename Base::Scalar Scalar; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE operator const Scalar() const + { + return internal::evaluator(derived()).coeff(0,0); + } +}; + +} // namespace internal + +// Generic API dispatcher +template +class ProductImpl : public internal::generic_xpr_base, MatrixXpr, StorageKind>::type +{ + public: + typedef typename internal::generic_xpr_base, MatrixXpr, StorageKind>::type Base; +}; + +template +class ProductImpl + : public internal::dense_product_base +{ + typedef Product Derived; + + public: + + typedef typename internal::dense_product_base Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Derived) + protected: + enum { + IsOneByOne = (RowsAtCompileTime == 1 || RowsAtCompileTime == Dynamic) && + (ColsAtCompileTime == 1 || ColsAtCompileTime == Dynamic), + EnableCoeff = IsOneByOne || Option==LazyProduct + }; + + public: + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(Index row, Index col) const + { + EIGEN_STATIC_ASSERT(EnableCoeff, THIS_METHOD_IS_ONLY_FOR_INNER_OR_LAZY_PRODUCTS); + eigen_assert( (Option==LazyProduct) || (this->rows() == 1 && this->cols() == 1) ); + + return internal::evaluator(derived()).coeff(row,col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(Index i) const + { + EIGEN_STATIC_ASSERT(EnableCoeff, THIS_METHOD_IS_ONLY_FOR_INNER_OR_LAZY_PRODUCTS); + eigen_assert( (Option==LazyProduct) || (this->rows() == 1 && this->cols() == 1) ); + + return internal::evaluator(derived()).coeff(i); + } + + +}; + +} // end namespace Eigen + +#endif // EIGEN_PRODUCT_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ProductEvaluators.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ProductEvaluators.h new file mode 100644 index 0000000..8cf294b --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ProductEvaluators.h @@ -0,0 +1,1179 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2008-2010 Gael Guennebaud +// Copyright (C) 2011 Jitse Niesen +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + + +#ifndef EIGEN_PRODUCTEVALUATORS_H +#define EIGEN_PRODUCTEVALUATORS_H + +namespace Eigen { + +namespace internal { + +/** \internal + * Evaluator of a product expression. + * Since products require special treatments to handle all possible cases, + * we simply defer the evaluation logic to a product_evaluator class + * which offers more partial specialization possibilities. + * + * \sa class product_evaluator + */ +template +struct evaluator > + : public product_evaluator > +{ + typedef Product XprType; + typedef product_evaluator Base; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& xpr) : Base(xpr) {} +}; + +// Catch "scalar * ( A * B )" and transform it to "(A*scalar) * B" +// TODO we should apply that rule only if that's really helpful +template +struct evaluator_assume_aliasing, + const CwiseNullaryOp, Plain1>, + const Product > > +{ + static const bool value = true; +}; +template +struct evaluator, + const CwiseNullaryOp, Plain1>, + const Product > > + : public evaluator > +{ + typedef CwiseBinaryOp, + const CwiseNullaryOp, Plain1>, + const Product > XprType; + typedef evaluator > Base; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& xpr) + : Base(xpr.lhs().functor().m_other * xpr.rhs().lhs() * xpr.rhs().rhs()) + {} +}; + + +template +struct evaluator, DiagIndex> > + : public evaluator, DiagIndex> > +{ + typedef Diagonal, DiagIndex> XprType; + typedef evaluator, DiagIndex> > Base; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& xpr) + : Base(Diagonal, DiagIndex>( + Product(xpr.nestedExpression().lhs(), xpr.nestedExpression().rhs()), + xpr.index() )) + {} +}; + + +// Helper class to perform a matrix product with the destination at hand. +// Depending on the sizes of the factors, there are different evaluation strategies +// as controlled by internal::product_type. +template< typename Lhs, typename Rhs, + typename LhsShape = typename evaluator_traits::Shape, + typename RhsShape = typename evaluator_traits::Shape, + int ProductType = internal::product_type::value> +struct generic_product_impl; + +template +struct evaluator_assume_aliasing > { + static const bool value = true; +}; + +// This is the default evaluator implementation for products: +// It creates a temporary and call generic_product_impl +template +struct product_evaluator, ProductTag, LhsShape, RhsShape> + : public evaluator::PlainObject> +{ + typedef Product XprType; + typedef typename XprType::PlainObject PlainObject; + typedef evaluator Base; + enum { + Flags = Base::Flags | EvalBeforeNestingBit + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit product_evaluator(const XprType& xpr) + : m_result(xpr.rows(), xpr.cols()) + { + ::new (static_cast(this)) Base(m_result); + +// FIXME shall we handle nested_eval here?, +// if so, then we must take care at removing the call to nested_eval in the specializations (e.g., in permutation_matrix_product, transposition_matrix_product, etc.) +// typedef typename internal::nested_eval::type LhsNested; +// typedef typename internal::nested_eval::type RhsNested; +// typedef typename internal::remove_all::type LhsNestedCleaned; +// typedef typename internal::remove_all::type RhsNestedCleaned; +// +// const LhsNested lhs(xpr.lhs()); +// const RhsNested rhs(xpr.rhs()); +// +// generic_product_impl::evalTo(m_result, lhs, rhs); + + generic_product_impl::evalTo(m_result, xpr.lhs(), xpr.rhs()); + } + +protected: + PlainObject m_result; +}; + +// The following three shortcuts are enabled only if the scalar types match exactly. +// TODO: we could enable them for different scalar types when the product is not vectorized. + +// Dense = Product +template< typename DstXprType, typename Lhs, typename Rhs, int Options, typename Scalar> +struct Assignment, internal::assign_op, Dense2Dense, + typename enable_if<(Options==DefaultProduct || Options==AliasFreeProduct)>::type> +{ + typedef Product SrcXprType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void run(DstXprType &dst, const SrcXprType &src, const internal::assign_op &) + { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if((dst.rows()!=dstRows) || (dst.cols()!=dstCols)) + dst.resize(dstRows, dstCols); + // FIXME shall we handle nested_eval here? + generic_product_impl::evalTo(dst, src.lhs(), src.rhs()); + } +}; + +// Dense += Product +template< typename DstXprType, typename Lhs, typename Rhs, int Options, typename Scalar> +struct Assignment, internal::add_assign_op, Dense2Dense, + typename enable_if<(Options==DefaultProduct || Options==AliasFreeProduct)>::type> +{ + typedef Product SrcXprType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void run(DstXprType &dst, const SrcXprType &src, const internal::add_assign_op &) + { + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + // FIXME shall we handle nested_eval here? + generic_product_impl::addTo(dst, src.lhs(), src.rhs()); + } +}; + +// Dense -= Product +template< typename DstXprType, typename Lhs, typename Rhs, int Options, typename Scalar> +struct Assignment, internal::sub_assign_op, Dense2Dense, + typename enable_if<(Options==DefaultProduct || Options==AliasFreeProduct)>::type> +{ + typedef Product SrcXprType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void run(DstXprType &dst, const SrcXprType &src, const internal::sub_assign_op &) + { + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + // FIXME shall we handle nested_eval here? + generic_product_impl::subTo(dst, src.lhs(), src.rhs()); + } +}; + + +// Dense ?= scalar * Product +// TODO we should apply that rule if that's really helpful +// for instance, this is not good for inner products +template< typename DstXprType, typename Lhs, typename Rhs, typename AssignFunc, typename Scalar, typename ScalarBis, typename Plain> +struct Assignment, const CwiseNullaryOp,Plain>, + const Product >, AssignFunc, Dense2Dense> +{ + typedef CwiseBinaryOp, + const CwiseNullaryOp,Plain>, + const Product > SrcXprType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void run(DstXprType &dst, const SrcXprType &src, const AssignFunc& func) + { + call_assignment_no_alias(dst, (src.lhs().functor().m_other * src.rhs().lhs())*src.rhs().rhs(), func); + } +}; + +//---------------------------------------- +// Catch "Dense ?= xpr + Product<>" expression to save one temporary +// FIXME we could probably enable these rules for any product, i.e., not only Dense and DefaultProduct + +template +struct evaluator_assume_aliasing::Scalar>, const OtherXpr, + const Product >, DenseShape > { + static const bool value = true; +}; + +template +struct evaluator_assume_aliasing::Scalar>, const OtherXpr, + const Product >, DenseShape > { + static const bool value = true; +}; + +template +struct assignment_from_xpr_op_product +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void run(DstXprType &dst, const SrcXprType &src, const InitialFunc& /*func*/) + { + call_assignment_no_alias(dst, src.lhs(), Func1()); + call_assignment_no_alias(dst, src.rhs(), Func2()); + } +}; + +#define EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(ASSIGN_OP,BINOP,ASSIGN_OP2) \ + template< typename DstXprType, typename OtherXpr, typename Lhs, typename Rhs, typename DstScalar, typename SrcScalar, typename OtherScalar,typename ProdScalar> \ + struct Assignment, const OtherXpr, \ + const Product >, internal::ASSIGN_OP, Dense2Dense> \ + : assignment_from_xpr_op_product, internal::ASSIGN_OP, internal::ASSIGN_OP2 > \ + {} + +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(assign_op, scalar_sum_op,add_assign_op); +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(add_assign_op,scalar_sum_op,add_assign_op); +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(sub_assign_op,scalar_sum_op,sub_assign_op); + +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(assign_op, scalar_difference_op,sub_assign_op); +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(add_assign_op,scalar_difference_op,sub_assign_op); +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(sub_assign_op,scalar_difference_op,add_assign_op); + +//---------------------------------------- + +template +struct generic_product_impl +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + dst.coeffRef(0,0) = (lhs.transpose().cwiseProduct(rhs)).sum(); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void addTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + dst.coeffRef(0,0) += (lhs.transpose().cwiseProduct(rhs)).sum(); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void subTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { dst.coeffRef(0,0) -= (lhs.transpose().cwiseProduct(rhs)).sum(); } +}; + + +/*********************************************************************** +* Implementation of outer dense * dense vector product +***********************************************************************/ + +// Column major result +template +void EIGEN_DEVICE_FUNC outer_product_selector_run(Dst& dst, const Lhs &lhs, const Rhs &rhs, const Func& func, const false_type&) +{ + evaluator rhsEval(rhs); + ei_declare_local_nested_eval(Lhs,lhs,Rhs::SizeAtCompileTime,actual_lhs); + // FIXME if cols is large enough, then it might be useful to make sure that lhs is sequentially stored + // FIXME not very good if rhs is real and lhs complex while alpha is real too + const Index cols = dst.cols(); + for (Index j=0; j +void EIGEN_DEVICE_FUNC outer_product_selector_run(Dst& dst, const Lhs &lhs, const Rhs &rhs, const Func& func, const true_type&) +{ + evaluator lhsEval(lhs); + ei_declare_local_nested_eval(Rhs,rhs,Lhs::SizeAtCompileTime,actual_rhs); + // FIXME if rows is large enough, then it might be useful to make sure that rhs is sequentially stored + // FIXME not very good if lhs is real and rhs complex while alpha is real too + const Index rows = dst.rows(); + for (Index i=0; i +struct generic_product_impl +{ + template struct is_row_major : internal::conditional<(int(T::Flags)&RowMajorBit), internal::true_type, internal::false_type>::type {}; + typedef typename Product::Scalar Scalar; + + // TODO it would be nice to be able to exploit our *_assign_op functors for that purpose + struct set { template EIGEN_DEVICE_FUNC void operator()(const Dst& dst, const Src& src) const { dst.const_cast_derived() = src; } }; + struct add { template EIGEN_DEVICE_FUNC void operator()(const Dst& dst, const Src& src) const { dst.const_cast_derived() += src; } }; + struct sub { template EIGEN_DEVICE_FUNC void operator()(const Dst& dst, const Src& src) const { dst.const_cast_derived() -= src; } }; + struct adds { + Scalar m_scale; + explicit adds(const Scalar& s) : m_scale(s) {} + template void EIGEN_DEVICE_FUNC operator()(const Dst& dst, const Src& src) const { + dst.const_cast_derived() += m_scale * src; + } + }; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + internal::outer_product_selector_run(dst, lhs, rhs, set(), is_row_major()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void addTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + internal::outer_product_selector_run(dst, lhs, rhs, add(), is_row_major()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void subTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + internal::outer_product_selector_run(dst, lhs, rhs, sub(), is_row_major()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void scaleAndAddTo(Dst& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { + internal::outer_product_selector_run(dst, lhs, rhs, adds(alpha), is_row_major()); + } + +}; + + +// This base class provides default implementations for evalTo, addTo, subTo, in terms of scaleAndAddTo +template +struct generic_product_impl_base +{ + typedef typename Product::Scalar Scalar; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { dst.setZero(); scaleAndAddTo(dst, lhs, rhs, Scalar(1)); } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void addTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { scaleAndAddTo(dst,lhs, rhs, Scalar(1)); } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void subTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { scaleAndAddTo(dst, lhs, rhs, Scalar(-1)); } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void scaleAndAddTo(Dst& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { Derived::scaleAndAddTo(dst,lhs,rhs,alpha); } + +}; + +template +struct generic_product_impl + : generic_product_impl_base > +{ + typedef typename nested_eval::type LhsNested; + typedef typename nested_eval::type RhsNested; + typedef typename Product::Scalar Scalar; + enum { Side = Lhs::IsVectorAtCompileTime ? OnTheLeft : OnTheRight }; + typedef typename internal::remove_all::type>::type MatrixType; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { + // Fallback to inner product if both the lhs and rhs is a runtime vector. + if (lhs.rows() == 1 && rhs.cols() == 1) { + dst.coeffRef(0,0) += alpha * lhs.row(0).conjugate().dot(rhs.col(0)); + return; + } + LhsNested actual_lhs(lhs); + RhsNested actual_rhs(rhs); + internal::gemv_dense_selector::HasUsableDirectAccess) + >::run(actual_lhs, actual_rhs, dst, alpha); + } +}; + +template +struct generic_product_impl +{ + typedef typename Product::Scalar Scalar; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + // Same as: dst.noalias() = lhs.lazyProduct(rhs); + // but easier on the compiler side + call_assignment_no_alias(dst, lhs.lazyProduct(rhs), internal::assign_op()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void addTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + // dst.noalias() += lhs.lazyProduct(rhs); + call_assignment_no_alias(dst, lhs.lazyProduct(rhs), internal::add_assign_op()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void subTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + // dst.noalias() -= lhs.lazyProduct(rhs); + call_assignment_no_alias(dst, lhs.lazyProduct(rhs), internal::sub_assign_op()); + } + + // This is a special evaluation path called from generic_product_impl<...,GemmProduct> in file GeneralMatrixMatrix.h + // This variant tries to extract scalar multiples from both the LHS and RHS and factor them out. For instance: + // dst {,+,-}= (s1*A)*(B*s2) + // will be rewritten as: + // dst {,+,-}= (s1*s2) * (A.lazyProduct(B)) + // There are at least four benefits of doing so: + // 1 - huge performance gain for heap-allocated matrix types as it save costly allocations. + // 2 - it is faster than simply by-passing the heap allocation through stack allocation. + // 3 - it makes this fallback consistent with the heavy GEMM routine. + // 4 - it fully by-passes huge stack allocation attempts when multiplying huge fixed-size matrices. + // (see https://stackoverflow.com/questions/54738495) + // For small fixed sizes matrices, howver, the gains are less obvious, it is sometimes x2 faster, but sometimes x3 slower, + // and the behavior depends also a lot on the compiler... This is why this re-writting strategy is currently + // enabled only when falling back from the main GEMM. + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void eval_dynamic(Dst& dst, const Lhs& lhs, const Rhs& rhs, const Func &func) + { + enum { + HasScalarFactor = blas_traits::HasScalarFactor || blas_traits::HasScalarFactor, + ConjLhs = blas_traits::NeedToConjugate, + ConjRhs = blas_traits::NeedToConjugate + }; + // FIXME: in c++11 this should be auto, and extractScalarFactor should also return auto + // this is important for real*complex_mat + Scalar actualAlpha = combine_scalar_factors(lhs, rhs); + + eval_dynamic_impl(dst, + blas_traits::extract(lhs).template conjugateIf(), + blas_traits::extract(rhs).template conjugateIf(), + func, + actualAlpha, + typename conditional::type()); + } + +protected: + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void eval_dynamic_impl(Dst& dst, const LhsT& lhs, const RhsT& rhs, const Func &func, const Scalar& s /* == 1 */, false_type) + { + EIGEN_UNUSED_VARIABLE(s); + eigen_internal_assert(s==Scalar(1)); + call_restricted_packet_assignment_no_alias(dst, lhs.lazyProduct(rhs), func); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void eval_dynamic_impl(Dst& dst, const LhsT& lhs, const RhsT& rhs, const Func &func, const Scalar& s, true_type) + { + call_restricted_packet_assignment_no_alias(dst, s * lhs.lazyProduct(rhs), func); + } +}; + +// This specialization enforces the use of a coefficient-based evaluation strategy +template +struct generic_product_impl + : generic_product_impl {}; + +// Case 2: Evaluate coeff by coeff +// +// This is mostly taken from CoeffBasedProduct.h +// The main difference is that we add an extra argument to the etor_product_*_impl::run() function +// for the inner dimension of the product, because evaluator object do not know their size. + +template +struct etor_product_coeff_impl; + +template +struct etor_product_packet_impl; + +template +struct product_evaluator, ProductTag, DenseShape, DenseShape> + : evaluator_base > +{ + typedef Product XprType; + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit product_evaluator(const XprType& xpr) + : m_lhs(xpr.lhs()), + m_rhs(xpr.rhs()), + m_lhsImpl(m_lhs), // FIXME the creation of the evaluator objects should result in a no-op, but check that! + m_rhsImpl(m_rhs), // Moreover, they are only useful for the packet path, so we could completely disable them when not needed, + // or perhaps declare them on the fly on the packet method... We have experiment to check what's best. + m_innerDim(xpr.lhs().cols()) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(NumTraits::MulCost); + EIGEN_INTERNAL_CHECK_COST_VALUE(NumTraits::AddCost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); +#if 0 + std::cerr << "LhsOuterStrideBytes= " << LhsOuterStrideBytes << "\n"; + std::cerr << "RhsOuterStrideBytes= " << RhsOuterStrideBytes << "\n"; + std::cerr << "LhsAlignment= " << LhsAlignment << "\n"; + std::cerr << "RhsAlignment= " << RhsAlignment << "\n"; + std::cerr << "CanVectorizeLhs= " << CanVectorizeLhs << "\n"; + std::cerr << "CanVectorizeRhs= " << CanVectorizeRhs << "\n"; + std::cerr << "CanVectorizeInner= " << CanVectorizeInner << "\n"; + std::cerr << "EvalToRowMajor= " << EvalToRowMajor << "\n"; + std::cerr << "Alignment= " << Alignment << "\n"; + std::cerr << "Flags= " << Flags << "\n"; +#endif + } + + // Everything below here is taken from CoeffBasedProduct.h + + typedef typename internal::nested_eval::type LhsNested; + typedef typename internal::nested_eval::type RhsNested; + + typedef typename internal::remove_all::type LhsNestedCleaned; + typedef typename internal::remove_all::type RhsNestedCleaned; + + typedef evaluator LhsEtorType; + typedef evaluator RhsEtorType; + + enum { + RowsAtCompileTime = LhsNestedCleaned::RowsAtCompileTime, + ColsAtCompileTime = RhsNestedCleaned::ColsAtCompileTime, + InnerSize = EIGEN_SIZE_MIN_PREFER_FIXED(LhsNestedCleaned::ColsAtCompileTime, RhsNestedCleaned::RowsAtCompileTime), + MaxRowsAtCompileTime = LhsNestedCleaned::MaxRowsAtCompileTime, + MaxColsAtCompileTime = RhsNestedCleaned::MaxColsAtCompileTime + }; + + typedef typename find_best_packet::type LhsVecPacketType; + typedef typename find_best_packet::type RhsVecPacketType; + + enum { + + LhsCoeffReadCost = LhsEtorType::CoeffReadCost, + RhsCoeffReadCost = RhsEtorType::CoeffReadCost, + CoeffReadCost = InnerSize==0 ? NumTraits::ReadCost + : InnerSize == Dynamic ? HugeCost + : InnerSize * (NumTraits::MulCost + int(LhsCoeffReadCost) + int(RhsCoeffReadCost)) + + (InnerSize - 1) * NumTraits::AddCost, + + Unroll = CoeffReadCost <= EIGEN_UNROLLING_LIMIT, + + LhsFlags = LhsEtorType::Flags, + RhsFlags = RhsEtorType::Flags, + + LhsRowMajor = LhsFlags & RowMajorBit, + RhsRowMajor = RhsFlags & RowMajorBit, + + LhsVecPacketSize = unpacket_traits::size, + RhsVecPacketSize = unpacket_traits::size, + + // Here, we don't care about alignment larger than the usable packet size. + LhsAlignment = EIGEN_PLAIN_ENUM_MIN(LhsEtorType::Alignment,LhsVecPacketSize*int(sizeof(typename LhsNestedCleaned::Scalar))), + RhsAlignment = EIGEN_PLAIN_ENUM_MIN(RhsEtorType::Alignment,RhsVecPacketSize*int(sizeof(typename RhsNestedCleaned::Scalar))), + + SameType = is_same::value, + + CanVectorizeRhs = bool(RhsRowMajor) && (RhsFlags & PacketAccessBit) && (ColsAtCompileTime!=1), + CanVectorizeLhs = (!LhsRowMajor) && (LhsFlags & PacketAccessBit) && (RowsAtCompileTime!=1), + + EvalToRowMajor = (MaxRowsAtCompileTime==1&&MaxColsAtCompileTime!=1) ? 1 + : (MaxColsAtCompileTime==1&&MaxRowsAtCompileTime!=1) ? 0 + : (bool(RhsRowMajor) && !CanVectorizeLhs), + + Flags = ((int(LhsFlags) | int(RhsFlags)) & HereditaryBits & ~RowMajorBit) + | (EvalToRowMajor ? RowMajorBit : 0) + // TODO enable vectorization for mixed types + | (SameType && (CanVectorizeLhs || CanVectorizeRhs) ? PacketAccessBit : 0) + | (XprType::IsVectorAtCompileTime ? LinearAccessBit : 0), + + LhsOuterStrideBytes = int(LhsNestedCleaned::OuterStrideAtCompileTime) * int(sizeof(typename LhsNestedCleaned::Scalar)), + RhsOuterStrideBytes = int(RhsNestedCleaned::OuterStrideAtCompileTime) * int(sizeof(typename RhsNestedCleaned::Scalar)), + + Alignment = bool(CanVectorizeLhs) ? (LhsOuterStrideBytes<=0 || (int(LhsOuterStrideBytes) % EIGEN_PLAIN_ENUM_MAX(1,LhsAlignment))!=0 ? 0 : LhsAlignment) + : bool(CanVectorizeRhs) ? (RhsOuterStrideBytes<=0 || (int(RhsOuterStrideBytes) % EIGEN_PLAIN_ENUM_MAX(1,RhsAlignment))!=0 ? 0 : RhsAlignment) + : 0, + + /* CanVectorizeInner deserves special explanation. It does not affect the product flags. It is not used outside + * of Product. If the Product itself is not a packet-access expression, there is still a chance that the inner + * loop of the product might be vectorized. This is the meaning of CanVectorizeInner. Since it doesn't affect + * the Flags, it is safe to make this value depend on ActualPacketAccessBit, that doesn't affect the ABI. + */ + CanVectorizeInner = SameType + && LhsRowMajor + && (!RhsRowMajor) + && (int(LhsFlags) & int(RhsFlags) & ActualPacketAccessBit) + && (int(InnerSize) % packet_traits::size == 0) + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const CoeffReturnType coeff(Index row, Index col) const + { + return (m_lhs.row(row).transpose().cwiseProduct( m_rhs.col(col) )).sum(); + } + + /* Allow index-based non-packet access. It is impossible though to allow index-based packed access, + * which is why we don't set the LinearAccessBit. + * TODO: this seems possible when the result is a vector + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const CoeffReturnType coeff(Index index) const + { + const Index row = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime==1) ? 0 : index; + const Index col = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime==1) ? index : 0; + return (m_lhs.row(row).transpose().cwiseProduct( m_rhs.col(col) )).sum(); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const PacketType packet(Index row, Index col) const + { + PacketType res; + typedef etor_product_packet_impl PacketImpl; + PacketImpl::run(row, col, m_lhsImpl, m_rhsImpl, m_innerDim, res); + return res; + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const PacketType packet(Index index) const + { + const Index row = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime==1) ? 0 : index; + const Index col = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime==1) ? index : 0; + return packet(row,col); + } + +protected: + typename internal::add_const_on_value_type::type m_lhs; + typename internal::add_const_on_value_type::type m_rhs; + + LhsEtorType m_lhsImpl; + RhsEtorType m_rhsImpl; + + // TODO: Get rid of m_innerDim if known at compile time + Index m_innerDim; +}; + +template +struct product_evaluator, LazyCoeffBasedProductMode, DenseShape, DenseShape> + : product_evaluator, CoeffBasedProductMode, DenseShape, DenseShape> +{ + typedef Product XprType; + typedef Product BaseProduct; + typedef product_evaluator Base; + enum { + Flags = Base::Flags | EvalBeforeNestingBit + }; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit product_evaluator(const XprType& xpr) + : Base(BaseProduct(xpr.lhs(),xpr.rhs())) + {} +}; + +/**************************************** +*** Coeff based product, Packet path *** +****************************************/ + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, Index innerDim, Packet &res) + { + etor_product_packet_impl::run(row, col, lhs, rhs, innerDim, res); + res = pmadd(pset1(lhs.coeff(row, Index(UnrollingIndex-1))), rhs.template packet(Index(UnrollingIndex-1), col), res); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, Index innerDim, Packet &res) + { + etor_product_packet_impl::run(row, col, lhs, rhs, innerDim, res); + res = pmadd(lhs.template packet(row, Index(UnrollingIndex-1)), pset1(rhs.coeff(Index(UnrollingIndex-1), col)), res); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, Index /*innerDim*/, Packet &res) + { + res = pmul(pset1(lhs.coeff(row, Index(0))),rhs.template packet(Index(0), col)); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, Index /*innerDim*/, Packet &res) + { + res = pmul(lhs.template packet(row, Index(0)), pset1(rhs.coeff(Index(0), col))); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index /*row*/, Index /*col*/, const Lhs& /*lhs*/, const Rhs& /*rhs*/, Index /*innerDim*/, Packet &res) + { + res = pset1(typename unpacket_traits::type(0)); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index /*row*/, Index /*col*/, const Lhs& /*lhs*/, const Rhs& /*rhs*/, Index /*innerDim*/, Packet &res) + { + res = pset1(typename unpacket_traits::type(0)); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, Index innerDim, Packet& res) + { + res = pset1(typename unpacket_traits::type(0)); + for(Index i = 0; i < innerDim; ++i) + res = pmadd(pset1(lhs.coeff(row, i)), rhs.template packet(i, col), res); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, Index innerDim, Packet& res) + { + res = pset1(typename unpacket_traits::type(0)); + for(Index i = 0; i < innerDim; ++i) + res = pmadd(lhs.template packet(row, i), pset1(rhs.coeff(i, col)), res); + } +}; + + +/*************************************************************************** +* Triangular products +***************************************************************************/ +template +struct triangular_product_impl; + +template +struct generic_product_impl + : generic_product_impl_base > +{ + typedef typename Product::Scalar Scalar; + + template + static void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { + triangular_product_impl + ::run(dst, lhs.nestedExpression(), rhs, alpha); + } +}; + +template +struct generic_product_impl +: generic_product_impl_base > +{ + typedef typename Product::Scalar Scalar; + + template + static void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { + triangular_product_impl::run(dst, lhs, rhs.nestedExpression(), alpha); + } +}; + + +/*************************************************************************** +* SelfAdjoint products +***************************************************************************/ +template +struct selfadjoint_product_impl; + +template +struct generic_product_impl + : generic_product_impl_base > +{ + typedef typename Product::Scalar Scalar; + + template + static EIGEN_DEVICE_FUNC + void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { + selfadjoint_product_impl::run(dst, lhs.nestedExpression(), rhs, alpha); + } +}; + +template +struct generic_product_impl +: generic_product_impl_base > +{ + typedef typename Product::Scalar Scalar; + + template + static void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { + selfadjoint_product_impl::run(dst, lhs, rhs.nestedExpression(), alpha); + } +}; + + +/*************************************************************************** +* Diagonal products +***************************************************************************/ + +template +struct diagonal_product_evaluator_base + : evaluator_base +{ + typedef typename ScalarBinaryOpTraits::ReturnType Scalar; +public: + enum { + CoeffReadCost = int(NumTraits::MulCost) + int(evaluator::CoeffReadCost) + int(evaluator::CoeffReadCost), + + MatrixFlags = evaluator::Flags, + DiagFlags = evaluator::Flags, + + _StorageOrder = (Derived::MaxRowsAtCompileTime==1 && Derived::MaxColsAtCompileTime!=1) ? RowMajor + : (Derived::MaxColsAtCompileTime==1 && Derived::MaxRowsAtCompileTime!=1) ? ColMajor + : MatrixFlags & RowMajorBit ? RowMajor : ColMajor, + _SameStorageOrder = _StorageOrder == (MatrixFlags & RowMajorBit ? RowMajor : ColMajor), + + _ScalarAccessOnDiag = !((int(_StorageOrder) == ColMajor && int(ProductOrder) == OnTheLeft) + ||(int(_StorageOrder) == RowMajor && int(ProductOrder) == OnTheRight)), + _SameTypes = is_same::value, + // FIXME currently we need same types, but in the future the next rule should be the one + //_Vectorizable = bool(int(MatrixFlags)&PacketAccessBit) && ((!_PacketOnDiag) || (_SameTypes && bool(int(DiagFlags)&PacketAccessBit))), + _Vectorizable = bool(int(MatrixFlags)&PacketAccessBit) + && _SameTypes + && (_SameStorageOrder || (MatrixFlags&LinearAccessBit)==LinearAccessBit) + && (_ScalarAccessOnDiag || (bool(int(DiagFlags)&PacketAccessBit))), + _LinearAccessMask = (MatrixType::RowsAtCompileTime==1 || MatrixType::ColsAtCompileTime==1) ? LinearAccessBit : 0, + Flags = ((HereditaryBits|_LinearAccessMask) & (unsigned int)(MatrixFlags)) | (_Vectorizable ? PacketAccessBit : 0), + Alignment = evaluator::Alignment, + + AsScalarProduct = (DiagonalType::SizeAtCompileTime==1) + || (DiagonalType::SizeAtCompileTime==Dynamic && MatrixType::RowsAtCompileTime==1 && ProductOrder==OnTheLeft) + || (DiagonalType::SizeAtCompileTime==Dynamic && MatrixType::ColsAtCompileTime==1 && ProductOrder==OnTheRight) + }; + + EIGEN_DEVICE_FUNC diagonal_product_evaluator_base(const MatrixType &mat, const DiagonalType &diag) + : m_diagImpl(diag), m_matImpl(mat) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(NumTraits::MulCost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar coeff(Index idx) const + { + if(AsScalarProduct) + return m_diagImpl.coeff(0) * m_matImpl.coeff(idx); + else + return m_diagImpl.coeff(idx) * m_matImpl.coeff(idx); + } + +protected: + template + EIGEN_STRONG_INLINE PacketType packet_impl(Index row, Index col, Index id, internal::true_type) const + { + return internal::pmul(m_matImpl.template packet(row, col), + internal::pset1(m_diagImpl.coeff(id))); + } + + template + EIGEN_STRONG_INLINE PacketType packet_impl(Index row, Index col, Index id, internal::false_type) const + { + enum { + InnerSize = (MatrixType::Flags & RowMajorBit) ? MatrixType::ColsAtCompileTime : MatrixType::RowsAtCompileTime, + DiagonalPacketLoadMode = EIGEN_PLAIN_ENUM_MIN(LoadMode,((InnerSize%16) == 0) ? int(Aligned16) : int(evaluator::Alignment)) // FIXME hardcoded 16!! + }; + return internal::pmul(m_matImpl.template packet(row, col), + m_diagImpl.template packet(id)); + } + + evaluator m_diagImpl; + evaluator m_matImpl; +}; + +// diagonal * dense +template +struct product_evaluator, ProductTag, DiagonalShape, DenseShape> + : diagonal_product_evaluator_base, OnTheLeft> +{ + typedef diagonal_product_evaluator_base, OnTheLeft> Base; + using Base::m_diagImpl; + using Base::m_matImpl; + using Base::coeff; + typedef typename Base::Scalar Scalar; + + typedef Product XprType; + typedef typename XprType::PlainObject PlainObject; + typedef typename Lhs::DiagonalVectorType DiagonalType; + + + enum { StorageOrder = Base::_StorageOrder }; + + EIGEN_DEVICE_FUNC explicit product_evaluator(const XprType& xpr) + : Base(xpr.rhs(), xpr.lhs().diagonal()) + { + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar coeff(Index row, Index col) const + { + return m_diagImpl.coeff(row) * m_matImpl.coeff(row, col); + } + +#ifndef EIGEN_GPUCC + template + EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const + { + // FIXME: NVCC used to complain about the template keyword, but we have to check whether this is still the case. + // See also similar calls below. + return this->template packet_impl(row,col, row, + typename internal::conditional::type()); + } + + template + EIGEN_STRONG_INLINE PacketType packet(Index idx) const + { + return packet(int(StorageOrder)==ColMajor?idx:0,int(StorageOrder)==ColMajor?0:idx); + } +#endif +}; + +// dense * diagonal +template +struct product_evaluator, ProductTag, DenseShape, DiagonalShape> + : diagonal_product_evaluator_base, OnTheRight> +{ + typedef diagonal_product_evaluator_base, OnTheRight> Base; + using Base::m_diagImpl; + using Base::m_matImpl; + using Base::coeff; + typedef typename Base::Scalar Scalar; + + typedef Product XprType; + typedef typename XprType::PlainObject PlainObject; + + enum { StorageOrder = Base::_StorageOrder }; + + EIGEN_DEVICE_FUNC explicit product_evaluator(const XprType& xpr) + : Base(xpr.lhs(), xpr.rhs().diagonal()) + { + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar coeff(Index row, Index col) const + { + return m_matImpl.coeff(row, col) * m_diagImpl.coeff(col); + } + +#ifndef EIGEN_GPUCC + template + EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const + { + return this->template packet_impl(row,col, col, + typename internal::conditional::type()); + } + + template + EIGEN_STRONG_INLINE PacketType packet(Index idx) const + { + return packet(int(StorageOrder)==ColMajor?idx:0,int(StorageOrder)==ColMajor?0:idx); + } +#endif +}; + +/*************************************************************************** +* Products with permutation matrices +***************************************************************************/ + +/** \internal + * \class permutation_matrix_product + * Internal helper class implementing the product between a permutation matrix and a matrix. + * This class is specialized for DenseShape below and for SparseShape in SparseCore/SparsePermutation.h + */ +template +struct permutation_matrix_product; + +template +struct permutation_matrix_product +{ + typedef typename nested_eval::type MatrixType; + typedef typename remove_all::type MatrixTypeCleaned; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Dest& dst, const PermutationType& perm, const ExpressionType& xpr) + { + MatrixType mat(xpr); + const Index n = Side==OnTheLeft ? mat.rows() : mat.cols(); + // FIXME we need an is_same for expression that is not sensitive to constness. For instance + // is_same_xpr, Block >::value should be true. + //if(is_same::value && extract_data(dst) == extract_data(mat)) + if(is_same_dense(dst, mat)) + { + // apply the permutation inplace + Matrix mask(perm.size()); + mask.fill(false); + Index r = 0; + while(r < perm.size()) + { + // search for the next seed + while(r=perm.size()) + break; + // we got one, let's follow it until we are back to the seed + Index k0 = r++; + Index kPrev = k0; + mask.coeffRef(k0) = true; + for(Index k=perm.indices().coeff(k0); k!=k0; k=perm.indices().coeff(k)) + { + Block(dst, k) + .swap(Block + (dst,((Side==OnTheLeft) ^ Transposed) ? k0 : kPrev)); + + mask.coeffRef(k) = true; + kPrev = k; + } + } + } + else + { + for(Index i = 0; i < n; ++i) + { + Block + (dst, ((Side==OnTheLeft) ^ Transposed) ? perm.indices().coeff(i) : i) + + = + + Block + (mat, ((Side==OnTheRight) ^ Transposed) ? perm.indices().coeff(i) : i); + } + } + } +}; + +template +struct generic_product_impl +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) + { + permutation_matrix_product::run(dst, lhs, rhs); + } +}; + +template +struct generic_product_impl +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) + { + permutation_matrix_product::run(dst, rhs, lhs); + } +}; + +template +struct generic_product_impl, Rhs, PermutationShape, MatrixShape, ProductTag> +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Inverse& lhs, const Rhs& rhs) + { + permutation_matrix_product::run(dst, lhs.nestedExpression(), rhs); + } +}; + +template +struct generic_product_impl, MatrixShape, PermutationShape, ProductTag> +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Inverse& rhs) + { + permutation_matrix_product::run(dst, rhs.nestedExpression(), lhs); + } +}; + + +/*************************************************************************** +* Products with transpositions matrices +***************************************************************************/ + +// FIXME could we unify Transpositions and Permutation into a single "shape"?? + +/** \internal + * \class transposition_matrix_product + * Internal helper class implementing the product between a permutation matrix and a matrix. + */ +template +struct transposition_matrix_product +{ + typedef typename nested_eval::type MatrixType; + typedef typename remove_all::type MatrixTypeCleaned; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Dest& dst, const TranspositionType& tr, const ExpressionType& xpr) + { + MatrixType mat(xpr); + typedef typename TranspositionType::StorageIndex StorageIndex; + const Index size = tr.size(); + StorageIndex j = 0; + + if(!is_same_dense(dst,mat)) + dst = mat; + + for(Index k=(Transposed?size-1:0) ; Transposed?k>=0:k +struct generic_product_impl +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) + { + transposition_matrix_product::run(dst, lhs, rhs); + } +}; + +template +struct generic_product_impl +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) + { + transposition_matrix_product::run(dst, rhs, lhs); + } +}; + + +template +struct generic_product_impl, Rhs, TranspositionsShape, MatrixShape, ProductTag> +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Transpose& lhs, const Rhs& rhs) + { + transposition_matrix_product::run(dst, lhs.nestedExpression(), rhs); + } +}; + +template +struct generic_product_impl, MatrixShape, TranspositionsShape, ProductTag> +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Transpose& rhs) + { + transposition_matrix_product::run(dst, rhs.nestedExpression(), lhs); + } +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_PRODUCT_EVALUATORS_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Random.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Random.h new file mode 100644 index 0000000..dab2ac8 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Random.h @@ -0,0 +1,218 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_RANDOM_H +#define EIGEN_RANDOM_H + +namespace Eigen { + +namespace internal { + +template struct scalar_random_op { + EIGEN_EMPTY_STRUCT_CTOR(scalar_random_op) + inline const Scalar operator() () const { return random(); } +}; + +template +struct functor_traits > +{ enum { Cost = 5 * NumTraits::MulCost, PacketAccess = false, IsRepeatable = false }; }; + +} // end namespace internal + +/** \returns a random matrix expression + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * \not_reentrant + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Random() should be used + * instead. + * + * + * Example: \include MatrixBase_random_int_int.cpp + * Output: \verbinclude MatrixBase_random_int_int.out + * + * This expression has the "evaluate before nesting" flag so that it will be evaluated into + * a temporary matrix whenever it is nested in a larger expression. This prevents unexpected + * behavior with expressions involving random matrices. + * + * See DenseBase::NullaryExpr(Index, const CustomNullaryOp&) for an example using C++11 random generators. + * + * \sa DenseBase::setRandom(), DenseBase::Random(Index), DenseBase::Random() + */ +template +inline const typename DenseBase::RandomReturnType +DenseBase::Random(Index rows, Index cols) +{ + return NullaryExpr(rows, cols, internal::scalar_random_op()); +} + +/** \returns a random vector expression + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * The parameter \a size is the size of the returned vector. + * Must be compatible with this MatrixBase type. + * + * \only_for_vectors + * \not_reentrant + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Random() should be used + * instead. + * + * Example: \include MatrixBase_random_int.cpp + * Output: \verbinclude MatrixBase_random_int.out + * + * This expression has the "evaluate before nesting" flag so that it will be evaluated into + * a temporary vector whenever it is nested in a larger expression. This prevents unexpected + * behavior with expressions involving random matrices. + * + * \sa DenseBase::setRandom(), DenseBase::Random(Index,Index), DenseBase::Random() + */ +template +inline const typename DenseBase::RandomReturnType +DenseBase::Random(Index size) +{ + return NullaryExpr(size, internal::scalar_random_op()); +} + +/** \returns a fixed-size random matrix or vector expression + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * This variant is only for fixed-size MatrixBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * Example: \include MatrixBase_random.cpp + * Output: \verbinclude MatrixBase_random.out + * + * This expression has the "evaluate before nesting" flag so that it will be evaluated into + * a temporary matrix whenever it is nested in a larger expression. This prevents unexpected + * behavior with expressions involving random matrices. + * + * \not_reentrant + * + * \sa DenseBase::setRandom(), DenseBase::Random(Index,Index), DenseBase::Random(Index) + */ +template +inline const typename DenseBase::RandomReturnType +DenseBase::Random() +{ + return NullaryExpr(RowsAtCompileTime, ColsAtCompileTime, internal::scalar_random_op()); +} + +/** Sets all coefficients in this expression to random values. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \not_reentrant + * + * Example: \include MatrixBase_setRandom.cpp + * Output: \verbinclude MatrixBase_setRandom.out + * + * \sa class CwiseNullaryOp, setRandom(Index), setRandom(Index,Index) + */ +template +EIGEN_DEVICE_FUNC inline Derived& DenseBase::setRandom() +{ + return *this = Random(rows(), cols()); +} + +/** Resizes to the given \a newSize, and sets all coefficients in this expression to random values. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \only_for_vectors + * \not_reentrant + * + * Example: \include Matrix_setRandom_int.cpp + * Output: \verbinclude Matrix_setRandom_int.out + * + * \sa DenseBase::setRandom(), setRandom(Index,Index), class CwiseNullaryOp, DenseBase::Random() + */ +template +EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setRandom(Index newSize) +{ + resize(newSize); + return setRandom(); +} + +/** Resizes to the given size, and sets all coefficients in this expression to random values. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \not_reentrant + * + * \param rows the new number of rows + * \param cols the new number of columns + * + * Example: \include Matrix_setRandom_int_int.cpp + * Output: \verbinclude Matrix_setRandom_int_int.out + * + * \sa DenseBase::setRandom(), setRandom(Index), class CwiseNullaryOp, DenseBase::Random() + */ +template +EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setRandom(Index rows, Index cols) +{ + resize(rows, cols); + return setRandom(); +} + +/** Resizes to the given size, changing only the number of columns, and sets all + * coefficients in this expression to random values. For the parameter of type + * NoChange_t, just pass the special value \c NoChange. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \not_reentrant + * + * \sa DenseBase::setRandom(), setRandom(Index), setRandom(Index, NoChange_t), class CwiseNullaryOp, DenseBase::Random() + */ +template +EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setRandom(NoChange_t, Index cols) +{ + return setRandom(rows(), cols); +} + +/** Resizes to the given size, changing only the number of rows, and sets all + * coefficients in this expression to random values. For the parameter of type + * NoChange_t, just pass the special value \c NoChange. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \not_reentrant + * + * \sa DenseBase::setRandom(), setRandom(Index), setRandom(NoChange_t, Index), class CwiseNullaryOp, DenseBase::Random() + */ +template +EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setRandom(Index rows, NoChange_t) +{ + return setRandom(rows, cols()); +} + +} // end namespace Eigen + +#endif // EIGEN_RANDOM_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Redux.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Redux.h new file mode 100644 index 0000000..b6790d1 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Redux.h @@ -0,0 +1,515 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REDUX_H +#define EIGEN_REDUX_H + +namespace Eigen { + +namespace internal { + +// TODO +// * implement other kind of vectorization +// * factorize code + +/*************************************************************************** +* Part 1 : the logic deciding a strategy for vectorization and unrolling +***************************************************************************/ + +template +struct redux_traits +{ +public: + typedef typename find_best_packet::type PacketType; + enum { + PacketSize = unpacket_traits::size, + InnerMaxSize = int(Evaluator::IsRowMajor) + ? Evaluator::MaxColsAtCompileTime + : Evaluator::MaxRowsAtCompileTime, + OuterMaxSize = int(Evaluator::IsRowMajor) + ? Evaluator::MaxRowsAtCompileTime + : Evaluator::MaxColsAtCompileTime, + SliceVectorizedWork = int(InnerMaxSize)==Dynamic ? Dynamic + : int(OuterMaxSize)==Dynamic ? (int(InnerMaxSize)>=int(PacketSize) ? Dynamic : 0) + : (int(InnerMaxSize)/int(PacketSize)) * int(OuterMaxSize) + }; + + enum { + MightVectorize = (int(Evaluator::Flags)&ActualPacketAccessBit) + && (functor_traits::PacketAccess), + MayLinearVectorize = bool(MightVectorize) && (int(Evaluator::Flags)&LinearAccessBit), + MaySliceVectorize = bool(MightVectorize) && (int(SliceVectorizedWork)==Dynamic || int(SliceVectorizedWork)>=3) + }; + +public: + enum { + Traversal = int(MayLinearVectorize) ? int(LinearVectorizedTraversal) + : int(MaySliceVectorize) ? int(SliceVectorizedTraversal) + : int(DefaultTraversal) + }; + +public: + enum { + Cost = Evaluator::SizeAtCompileTime == Dynamic ? HugeCost + : int(Evaluator::SizeAtCompileTime) * int(Evaluator::CoeffReadCost) + (Evaluator::SizeAtCompileTime-1) * functor_traits::Cost, + UnrollingLimit = EIGEN_UNROLLING_LIMIT * (int(Traversal) == int(DefaultTraversal) ? 1 : int(PacketSize)) + }; + +public: + enum { + Unrolling = Cost <= UnrollingLimit ? CompleteUnrolling : NoUnrolling + }; + +#ifdef EIGEN_DEBUG_ASSIGN + static void debug() + { + std::cerr << "Xpr: " << typeid(typename Evaluator::XprType).name() << std::endl; + std::cerr.setf(std::ios::hex, std::ios::basefield); + EIGEN_DEBUG_VAR(Evaluator::Flags) + std::cerr.unsetf(std::ios::hex); + EIGEN_DEBUG_VAR(InnerMaxSize) + EIGEN_DEBUG_VAR(OuterMaxSize) + EIGEN_DEBUG_VAR(SliceVectorizedWork) + EIGEN_DEBUG_VAR(PacketSize) + EIGEN_DEBUG_VAR(MightVectorize) + EIGEN_DEBUG_VAR(MayLinearVectorize) + EIGEN_DEBUG_VAR(MaySliceVectorize) + std::cerr << "Traversal" << " = " << Traversal << " (" << demangle_traversal(Traversal) << ")" << std::endl; + EIGEN_DEBUG_VAR(UnrollingLimit) + std::cerr << "Unrolling" << " = " << Unrolling << " (" << demangle_unrolling(Unrolling) << ")" << std::endl; + std::cerr << std::endl; + } +#endif +}; + +/*************************************************************************** +* Part 2 : unrollers +***************************************************************************/ + +/*** no vectorization ***/ + +template +struct redux_novec_unroller +{ + enum { + HalfLength = Length/2 + }; + + typedef typename Evaluator::Scalar Scalar; + + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE Scalar run(const Evaluator &eval, const Func& func) + { + return func(redux_novec_unroller::run(eval,func), + redux_novec_unroller::run(eval,func)); + } +}; + +template +struct redux_novec_unroller +{ + enum { + outer = Start / Evaluator::InnerSizeAtCompileTime, + inner = Start % Evaluator::InnerSizeAtCompileTime + }; + + typedef typename Evaluator::Scalar Scalar; + + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE Scalar run(const Evaluator &eval, const Func&) + { + return eval.coeffByOuterInner(outer, inner); + } +}; + +// This is actually dead code and will never be called. It is required +// to prevent false warnings regarding failed inlining though +// for 0 length run() will never be called at all. +template +struct redux_novec_unroller +{ + typedef typename Evaluator::Scalar Scalar; + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE Scalar run(const Evaluator&, const Func&) { return Scalar(); } +}; + +/*** vectorization ***/ + +template +struct redux_vec_unroller +{ + template + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE PacketType run(const Evaluator &eval, const Func& func) + { + enum { + PacketSize = unpacket_traits::size, + HalfLength = Length/2 + }; + + return func.packetOp( + redux_vec_unroller::template run(eval,func), + redux_vec_unroller::template run(eval,func) ); + } +}; + +template +struct redux_vec_unroller +{ + template + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE PacketType run(const Evaluator &eval, const Func&) + { + enum { + PacketSize = unpacket_traits::size, + index = Start * PacketSize, + outer = index / int(Evaluator::InnerSizeAtCompileTime), + inner = index % int(Evaluator::InnerSizeAtCompileTime), + alignment = Evaluator::Alignment + }; + return eval.template packetByOuterInner(outer, inner); + } +}; + +/*************************************************************************** +* Part 3 : implementation of all cases +***************************************************************************/ + +template::Traversal, + int Unrolling = redux_traits::Unrolling +> +struct redux_impl; + +template +struct redux_impl +{ + typedef typename Evaluator::Scalar Scalar; + + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE + Scalar run(const Evaluator &eval, const Func& func, const XprType& xpr) + { + eigen_assert(xpr.rows()>0 && xpr.cols()>0 && "you are using an empty matrix"); + Scalar res; + res = eval.coeffByOuterInner(0, 0); + for(Index i = 1; i < xpr.innerSize(); ++i) + res = func(res, eval.coeffByOuterInner(0, i)); + for(Index i = 1; i < xpr.outerSize(); ++i) + for(Index j = 0; j < xpr.innerSize(); ++j) + res = func(res, eval.coeffByOuterInner(i, j)); + return res; + } +}; + +template +struct redux_impl + : redux_novec_unroller +{ + typedef redux_novec_unroller Base; + typedef typename Evaluator::Scalar Scalar; + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE + Scalar run(const Evaluator &eval, const Func& func, const XprType& /*xpr*/) + { + return Base::run(eval,func); + } +}; + +template +struct redux_impl +{ + typedef typename Evaluator::Scalar Scalar; + typedef typename redux_traits::PacketType PacketScalar; + + template + static Scalar run(const Evaluator &eval, const Func& func, const XprType& xpr) + { + const Index size = xpr.size(); + + const Index packetSize = redux_traits::PacketSize; + const int packetAlignment = unpacket_traits::alignment; + enum { + alignment0 = (bool(Evaluator::Flags & DirectAccessBit) && bool(packet_traits::AlignedOnScalar)) ? int(packetAlignment) : int(Unaligned), + alignment = EIGEN_PLAIN_ENUM_MAX(alignment0, Evaluator::Alignment) + }; + const Index alignedStart = internal::first_default_aligned(xpr); + const Index alignedSize2 = ((size-alignedStart)/(2*packetSize))*(2*packetSize); + const Index alignedSize = ((size-alignedStart)/(packetSize))*(packetSize); + const Index alignedEnd2 = alignedStart + alignedSize2; + const Index alignedEnd = alignedStart + alignedSize; + Scalar res; + if(alignedSize) + { + PacketScalar packet_res0 = eval.template packet(alignedStart); + if(alignedSize>packetSize) // we have at least two packets to partly unroll the loop + { + PacketScalar packet_res1 = eval.template packet(alignedStart+packetSize); + for(Index index = alignedStart + 2*packetSize; index < alignedEnd2; index += 2*packetSize) + { + packet_res0 = func.packetOp(packet_res0, eval.template packet(index)); + packet_res1 = func.packetOp(packet_res1, eval.template packet(index+packetSize)); + } + + packet_res0 = func.packetOp(packet_res0,packet_res1); + if(alignedEnd>alignedEnd2) + packet_res0 = func.packetOp(packet_res0, eval.template packet(alignedEnd2)); + } + res = func.predux(packet_res0); + + for(Index index = 0; index < alignedStart; ++index) + res = func(res,eval.coeff(index)); + + for(Index index = alignedEnd; index < size; ++index) + res = func(res,eval.coeff(index)); + } + else // too small to vectorize anything. + // since this is dynamic-size hence inefficient anyway for such small sizes, don't try to optimize. + { + res = eval.coeff(0); + for(Index index = 1; index < size; ++index) + res = func(res,eval.coeff(index)); + } + + return res; + } +}; + +// NOTE: for SliceVectorizedTraversal we simply bypass unrolling +template +struct redux_impl +{ + typedef typename Evaluator::Scalar Scalar; + typedef typename redux_traits::PacketType PacketType; + + template + EIGEN_DEVICE_FUNC static Scalar run(const Evaluator &eval, const Func& func, const XprType& xpr) + { + eigen_assert(xpr.rows()>0 && xpr.cols()>0 && "you are using an empty matrix"); + const Index innerSize = xpr.innerSize(); + const Index outerSize = xpr.outerSize(); + enum { + packetSize = redux_traits::PacketSize + }; + const Index packetedInnerSize = ((innerSize)/packetSize)*packetSize; + Scalar res; + if(packetedInnerSize) + { + PacketType packet_res = eval.template packet(0,0); + for(Index j=0; j(j,i)); + + res = func.predux(packet_res); + for(Index j=0; j::run(eval, func, xpr); + } + + return res; + } +}; + +template +struct redux_impl +{ + typedef typename Evaluator::Scalar Scalar; + + typedef typename redux_traits::PacketType PacketType; + enum { + PacketSize = redux_traits::PacketSize, + Size = Evaluator::SizeAtCompileTime, + VectorizedSize = (int(Size) / int(PacketSize)) * int(PacketSize) + }; + + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE + Scalar run(const Evaluator &eval, const Func& func, const XprType &xpr) + { + EIGEN_ONLY_USED_FOR_DEBUG(xpr) + eigen_assert(xpr.rows()>0 && xpr.cols()>0 && "you are using an empty matrix"); + if (VectorizedSize > 0) { + Scalar res = func.predux(redux_vec_unroller::template run(eval,func)); + if (VectorizedSize != Size) + res = func(res,redux_novec_unroller::run(eval,func)); + return res; + } + else { + return redux_novec_unroller::run(eval,func); + } + } +}; + +// evaluator adaptor +template +class redux_evaluator : public internal::evaluator<_XprType> +{ + typedef internal::evaluator<_XprType> Base; +public: + typedef _XprType XprType; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit redux_evaluator(const XprType &xpr) : Base(xpr) {} + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + typedef typename XprType::PacketScalar PacketScalar; + + enum { + MaxRowsAtCompileTime = XprType::MaxRowsAtCompileTime, + MaxColsAtCompileTime = XprType::MaxColsAtCompileTime, + // TODO we should not remove DirectAccessBit and rather find an elegant way to query the alignment offset at runtime from the evaluator + Flags = Base::Flags & ~DirectAccessBit, + IsRowMajor = XprType::IsRowMajor, + SizeAtCompileTime = XprType::SizeAtCompileTime, + InnerSizeAtCompileTime = XprType::InnerSizeAtCompileTime + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeffByOuterInner(Index outer, Index inner) const + { return Base::coeff(IsRowMajor ? outer : inner, IsRowMajor ? inner : outer); } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + PacketType packetByOuterInner(Index outer, Index inner) const + { return Base::template packet(IsRowMajor ? outer : inner, IsRowMajor ? inner : outer); } + +}; + +} // end namespace internal + +/*************************************************************************** +* Part 4 : public API +***************************************************************************/ + + +/** \returns the result of a full redux operation on the whole matrix or vector using \a func + * + * The template parameter \a BinaryOp is the type of the functor \a func which must be + * an associative operator. Both current C++98 and C++11 functor styles are handled. + * + * \warning the matrix must be not empty, otherwise an assertion is triggered. + * + * \sa DenseBase::sum(), DenseBase::minCoeff(), DenseBase::maxCoeff(), MatrixBase::colwise(), MatrixBase::rowwise() + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +DenseBase::redux(const Func& func) const +{ + eigen_assert(this->rows()>0 && this->cols()>0 && "you are using an empty matrix"); + + typedef typename internal::redux_evaluator ThisEvaluator; + ThisEvaluator thisEval(derived()); + + // The initial expression is passed to the reducer as an additional argument instead of + // passing it as a member of redux_evaluator to help + return internal::redux_impl::run(thisEval, func, derived()); +} + +/** \returns the minimum of all coefficients of \c *this. + * In case \c *this contains NaN, NaNPropagation determines the behavior: + * NaNPropagation == PropagateFast : undefined + * NaNPropagation == PropagateNaN : result is NaN + * NaNPropagation == PropagateNumbers : result is minimum of elements that are not NaN + * \warning the matrix must be not empty, otherwise an assertion is triggered. + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +DenseBase::minCoeff() const +{ + return derived().redux(Eigen::internal::scalar_min_op()); +} + +/** \returns the maximum of all coefficients of \c *this. + * In case \c *this contains NaN, NaNPropagation determines the behavior: + * NaNPropagation == PropagateFast : undefined + * NaNPropagation == PropagateNaN : result is NaN + * NaNPropagation == PropagateNumbers : result is maximum of elements that are not NaN + * \warning the matrix must be not empty, otherwise an assertion is triggered. + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +DenseBase::maxCoeff() const +{ + return derived().redux(Eigen::internal::scalar_max_op()); +} + +/** \returns the sum of all coefficients of \c *this + * + * If \c *this is empty, then the value 0 is returned. + * + * \sa trace(), prod(), mean() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +DenseBase::sum() const +{ + if(SizeAtCompileTime==0 || (SizeAtCompileTime==Dynamic && size()==0)) + return Scalar(0); + return derived().redux(Eigen::internal::scalar_sum_op()); +} + +/** \returns the mean of all coefficients of *this +* +* \sa trace(), prod(), sum() +*/ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +DenseBase::mean() const +{ +#ifdef __INTEL_COMPILER + #pragma warning push + #pragma warning ( disable : 2259 ) +#endif + return Scalar(derived().redux(Eigen::internal::scalar_sum_op())) / Scalar(this->size()); +#ifdef __INTEL_COMPILER + #pragma warning pop +#endif +} + +/** \returns the product of all coefficients of *this + * + * Example: \include MatrixBase_prod.cpp + * Output: \verbinclude MatrixBase_prod.out + * + * \sa sum(), mean(), trace() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +DenseBase::prod() const +{ + if(SizeAtCompileTime==0 || (SizeAtCompileTime==Dynamic && size()==0)) + return Scalar(1); + return derived().redux(Eigen::internal::scalar_product_op()); +} + +/** \returns the trace of \c *this, i.e. the sum of the coefficients on the main diagonal. + * + * \c *this can be any matrix, not necessarily square. + * + * \sa diagonal(), sum() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +MatrixBase::trace() const +{ + return derived().diagonal().sum(); +} + +} // end namespace Eigen + +#endif // EIGEN_REDUX_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Ref.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Ref.h new file mode 100644 index 0000000..c2a37ea --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Ref.h @@ -0,0 +1,381 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2012 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REF_H +#define EIGEN_REF_H + +namespace Eigen { + +namespace internal { + +template +struct traits > + : public traits > +{ + typedef _PlainObjectType PlainObjectType; + typedef _StrideType StrideType; + enum { + Options = _Options, + Flags = traits >::Flags | NestByRefBit, + Alignment = traits >::Alignment + }; + + template struct match { + enum { + IsVectorAtCompileTime = PlainObjectType::IsVectorAtCompileTime || Derived::IsVectorAtCompileTime, + HasDirectAccess = internal::has_direct_access::ret, + StorageOrderMatch = IsVectorAtCompileTime || ((PlainObjectType::Flags&RowMajorBit)==(Derived::Flags&RowMajorBit)), + InnerStrideMatch = int(StrideType::InnerStrideAtCompileTime)==int(Dynamic) + || int(StrideType::InnerStrideAtCompileTime)==int(Derived::InnerStrideAtCompileTime) + || (int(StrideType::InnerStrideAtCompileTime)==0 && int(Derived::InnerStrideAtCompileTime)==1), + OuterStrideMatch = IsVectorAtCompileTime + || int(StrideType::OuterStrideAtCompileTime)==int(Dynamic) || int(StrideType::OuterStrideAtCompileTime)==int(Derived::OuterStrideAtCompileTime), + // NOTE, this indirection of evaluator::Alignment is needed + // to workaround a very strange bug in MSVC related to the instantiation + // of has_*ary_operator in evaluator. + // This line is surprisingly very sensitive. For instance, simply adding parenthesis + // as "DerivedAlignment = (int(evaluator::Alignment))," will make MSVC fail... + DerivedAlignment = int(evaluator::Alignment), + AlignmentMatch = (int(traits::Alignment)==int(Unaligned)) || (DerivedAlignment >= int(Alignment)), // FIXME the first condition is not very clear, it should be replaced by the required alignment + ScalarTypeMatch = internal::is_same::value, + MatchAtCompileTime = HasDirectAccess && StorageOrderMatch && InnerStrideMatch && OuterStrideMatch && AlignmentMatch && ScalarTypeMatch + }; + typedef typename internal::conditional::type type; + }; + +}; + +template +struct traits > : public traits {}; + +} + +template class RefBase + : public MapBase +{ + typedef typename internal::traits::PlainObjectType PlainObjectType; + typedef typename internal::traits::StrideType StrideType; + +public: + + typedef MapBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(RefBase) + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR inline Index innerStride() const + { + return StrideType::InnerStrideAtCompileTime != 0 ? m_stride.inner() : 1; + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR inline Index outerStride() const + { + return StrideType::OuterStrideAtCompileTime != 0 ? m_stride.outer() + : IsVectorAtCompileTime ? this->size() + : int(Flags)&RowMajorBit ? this->cols() + : this->rows(); + } + + EIGEN_DEVICE_FUNC RefBase() + : Base(0,RowsAtCompileTime==Dynamic?0:RowsAtCompileTime,ColsAtCompileTime==Dynamic?0:ColsAtCompileTime), + // Stride<> does not allow default ctor for Dynamic strides, so let' initialize it with dummy values: + m_stride(StrideType::OuterStrideAtCompileTime==Dynamic?0:StrideType::OuterStrideAtCompileTime, + StrideType::InnerStrideAtCompileTime==Dynamic?0:StrideType::InnerStrideAtCompileTime) + {} + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(RefBase) + +protected: + + typedef Stride StrideBase; + + // Resolves inner stride if default 0. + static EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index resolveInnerStride(Index inner) { + return inner == 0 ? 1 : inner; + } + + // Resolves outer stride if default 0. + static EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index resolveOuterStride(Index inner, Index outer, Index rows, Index cols, bool isVectorAtCompileTime, bool isRowMajor) { + return outer == 0 ? isVectorAtCompileTime ? inner * rows * cols : isRowMajor ? inner * cols : inner * rows : outer; + } + + // Returns true if construction is valid, false if there is a stride mismatch, + // and fails if there is a size mismatch. + template + EIGEN_DEVICE_FUNC bool construct(Expression& expr) + { + // Check matrix sizes. If this is a compile-time vector, we do allow + // implicitly transposing. + EIGEN_STATIC_ASSERT( + EIGEN_PREDICATE_SAME_MATRIX_SIZE(PlainObjectType, Expression) + // If it is a vector, the transpose sizes might match. + || ( PlainObjectType::IsVectorAtCompileTime + && ((int(PlainObjectType::RowsAtCompileTime)==Eigen::Dynamic + || int(Expression::ColsAtCompileTime)==Eigen::Dynamic + || int(PlainObjectType::RowsAtCompileTime)==int(Expression::ColsAtCompileTime)) + && (int(PlainObjectType::ColsAtCompileTime)==Eigen::Dynamic + || int(Expression::RowsAtCompileTime)==Eigen::Dynamic + || int(PlainObjectType::ColsAtCompileTime)==int(Expression::RowsAtCompileTime)))), + YOU_MIXED_MATRICES_OF_DIFFERENT_SIZES + ) + + // Determine runtime rows and columns. + Index rows = expr.rows(); + Index cols = expr.cols(); + if(PlainObjectType::RowsAtCompileTime==1) + { + eigen_assert(expr.rows()==1 || expr.cols()==1); + rows = 1; + cols = expr.size(); + } + else if(PlainObjectType::ColsAtCompileTime==1) + { + eigen_assert(expr.rows()==1 || expr.cols()==1); + rows = expr.size(); + cols = 1; + } + // Verify that the sizes are valid. + eigen_assert( + (PlainObjectType::RowsAtCompileTime == Dynamic) || (PlainObjectType::RowsAtCompileTime == rows)); + eigen_assert( + (PlainObjectType::ColsAtCompileTime == Dynamic) || (PlainObjectType::ColsAtCompileTime == cols)); + + + // If this is a vector, we might be transposing, which means that stride should swap. + const bool transpose = PlainObjectType::IsVectorAtCompileTime && (rows != expr.rows()); + // If the storage format differs, we also need to swap the stride. + const bool row_major = ((PlainObjectType::Flags)&RowMajorBit) != 0; + const bool expr_row_major = (Expression::Flags&RowMajorBit) != 0; + const bool storage_differs = (row_major != expr_row_major); + + const bool swap_stride = (transpose != storage_differs); + + // Determine expr's actual strides, resolving any defaults if zero. + const Index expr_inner_actual = resolveInnerStride(expr.innerStride()); + const Index expr_outer_actual = resolveOuterStride(expr_inner_actual, + expr.outerStride(), + expr.rows(), + expr.cols(), + Expression::IsVectorAtCompileTime != 0, + expr_row_major); + + // If this is a column-major row vector or row-major column vector, the inner-stride + // is arbitrary, so set it to either the compile-time inner stride or 1. + const bool row_vector = (rows == 1); + const bool col_vector = (cols == 1); + const Index inner_stride = + ( (!row_major && row_vector) || (row_major && col_vector) ) ? + ( StrideType::InnerStrideAtCompileTime > 0 ? Index(StrideType::InnerStrideAtCompileTime) : 1) + : swap_stride ? expr_outer_actual : expr_inner_actual; + + // If this is a column-major column vector or row-major row vector, the outer-stride + // is arbitrary, so set it to either the compile-time outer stride or vector size. + const Index outer_stride = + ( (!row_major && col_vector) || (row_major && row_vector) ) ? + ( StrideType::OuterStrideAtCompileTime > 0 ? Index(StrideType::OuterStrideAtCompileTime) : rows * cols * inner_stride) + : swap_stride ? expr_inner_actual : expr_outer_actual; + + // Check if given inner/outer strides are compatible with compile-time strides. + const bool inner_valid = (StrideType::InnerStrideAtCompileTime == Dynamic) + || (resolveInnerStride(Index(StrideType::InnerStrideAtCompileTime)) == inner_stride); + if (!inner_valid) { + return false; + } + + const bool outer_valid = (StrideType::OuterStrideAtCompileTime == Dynamic) + || (resolveOuterStride( + inner_stride, + Index(StrideType::OuterStrideAtCompileTime), + rows, cols, PlainObjectType::IsVectorAtCompileTime != 0, + row_major) + == outer_stride); + if (!outer_valid) { + return false; + } + + ::new (static_cast(this)) Base(expr.data(), rows, cols); + ::new (&m_stride) StrideBase( + (StrideType::OuterStrideAtCompileTime == 0) ? 0 : outer_stride, + (StrideType::InnerStrideAtCompileTime == 0) ? 0 : inner_stride ); + return true; + } + + StrideBase m_stride; +}; + +/** \class Ref + * \ingroup Core_Module + * + * \brief A matrix or vector expression mapping an existing expression + * + * \tparam PlainObjectType the equivalent matrix type of the mapped data + * \tparam Options specifies the pointer alignment in bytes. It can be: \c #Aligned128, , \c #Aligned64, \c #Aligned32, \c #Aligned16, \c #Aligned8 or \c #Unaligned. + * The default is \c #Unaligned. + * \tparam StrideType optionally specifies strides. By default, Ref implies a contiguous storage along the inner dimension (inner stride==1), + * but accepts a variable outer stride (leading dimension). + * This can be overridden by specifying strides. + * The type passed here must be a specialization of the Stride template, see examples below. + * + * This class provides a way to write non-template functions taking Eigen objects as parameters while limiting the number of copies. + * A Ref<> object can represent either a const expression or a l-value: + * \code + * // in-out argument: + * void foo1(Ref x); + * + * // read-only const argument: + * void foo2(const Ref& x); + * \endcode + * + * In the in-out case, the input argument must satisfy the constraints of the actual Ref<> type, otherwise a compilation issue will be triggered. + * By default, a Ref can reference any dense vector expression of float having a contiguous memory layout. + * Likewise, a Ref can reference any column-major dense matrix expression of float whose column's elements are contiguously stored with + * the possibility to have a constant space in-between each column, i.e. the inner stride must be equal to 1, but the outer stride (or leading dimension) + * can be greater than the number of rows. + * + * In the const case, if the input expression does not match the above requirement, then it is evaluated into a temporary before being passed to the function. + * Here are some examples: + * \code + * MatrixXf A; + * VectorXf a; + * foo1(a.head()); // OK + * foo1(A.col()); // OK + * foo1(A.row()); // Compilation error because here innerstride!=1 + * foo2(A.row()); // Compilation error because A.row() is a 1xN object while foo2 is expecting a Nx1 object + * foo2(A.row().transpose()); // The row is copied into a contiguous temporary + * foo2(2*a); // The expression is evaluated into a temporary + * foo2(A.col().segment(2,4)); // No temporary + * \endcode + * + * The range of inputs that can be referenced without temporary can be enlarged using the last two template parameters. + * Here is an example accepting an innerstride!=1: + * \code + * // in-out argument: + * void foo3(Ref > x); + * foo3(A.row()); // OK + * \endcode + * The downside here is that the function foo3 might be significantly slower than foo1 because it won't be able to exploit vectorization, and will involve more + * expensive address computations even if the input is contiguously stored in memory. To overcome this issue, one might propose to overload internally calling a + * template function, e.g.: + * \code + * // in the .h: + * void foo(const Ref& A); + * void foo(const Ref >& A); + * + * // in the .cpp: + * template void foo_impl(const TypeOfA& A) { + * ... // crazy code goes here + * } + * void foo(const Ref& A) { foo_impl(A); } + * void foo(const Ref >& A) { foo_impl(A); } + * \endcode + * + * See also the following stackoverflow questions for further references: + * - Correct usage of the Eigen::Ref<> class + * + * \sa PlainObjectBase::Map(), \ref TopicStorageOrders + */ +template class Ref + : public RefBase > +{ + private: + typedef internal::traits Traits; + template + EIGEN_DEVICE_FUNC inline Ref(const PlainObjectBase& expr, + typename internal::enable_if::MatchAtCompileTime),Derived>::type* = 0); + public: + + typedef RefBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Ref) + + + #ifndef EIGEN_PARSED_BY_DOXYGEN + template + EIGEN_DEVICE_FUNC inline Ref(PlainObjectBase& expr, + typename internal::enable_if::MatchAtCompileTime),Derived>::type* = 0) + { + EIGEN_STATIC_ASSERT(bool(Traits::template match::MatchAtCompileTime), STORAGE_LAYOUT_DOES_NOT_MATCH); + // Construction must pass since we will not create temprary storage in the non-const case. + const bool success = Base::construct(expr.derived()); + EIGEN_UNUSED_VARIABLE(success) + eigen_assert(success); + } + template + EIGEN_DEVICE_FUNC inline Ref(const DenseBase& expr, + typename internal::enable_if::MatchAtCompileTime),Derived>::type* = 0) + #else + /** Implicit constructor from any dense expression */ + template + inline Ref(DenseBase& expr) + #endif + { + EIGEN_STATIC_ASSERT(bool(internal::is_lvalue::value), THIS_EXPRESSION_IS_NOT_A_LVALUE__IT_IS_READ_ONLY); + EIGEN_STATIC_ASSERT(bool(Traits::template match::MatchAtCompileTime), STORAGE_LAYOUT_DOES_NOT_MATCH); + EIGEN_STATIC_ASSERT(!Derived::IsPlainObjectBase,THIS_EXPRESSION_IS_NOT_A_LVALUE__IT_IS_READ_ONLY); + // Construction must pass since we will not create temporary storage in the non-const case. + const bool success = Base::construct(expr.const_cast_derived()); + EIGEN_UNUSED_VARIABLE(success) + eigen_assert(success); + } + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Ref) + +}; + +// this is the const ref version +template class Ref + : public RefBase > +{ + typedef internal::traits Traits; + public: + + typedef RefBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Ref) + + template + EIGEN_DEVICE_FUNC inline Ref(const DenseBase& expr, + typename internal::enable_if::ScalarTypeMatch),Derived>::type* = 0) + { +// std::cout << match_helper::HasDirectAccess << "," << match_helper::OuterStrideMatch << "," << match_helper::InnerStrideMatch << "\n"; +// std::cout << int(StrideType::OuterStrideAtCompileTime) << " - " << int(Derived::OuterStrideAtCompileTime) << "\n"; +// std::cout << int(StrideType::InnerStrideAtCompileTime) << " - " << int(Derived::InnerStrideAtCompileTime) << "\n"; + construct(expr.derived(), typename Traits::template match::type()); + } + + EIGEN_DEVICE_FUNC inline Ref(const Ref& other) : Base(other) { + // copy constructor shall not copy the m_object, to avoid unnecessary malloc and copy + } + + template + EIGEN_DEVICE_FUNC inline Ref(const RefBase& other) { + construct(other.derived(), typename Traits::template match::type()); + } + + protected: + + template + EIGEN_DEVICE_FUNC void construct(const Expression& expr,internal::true_type) + { + // Check if we can use the underlying expr's storage directly, otherwise call the copy version. + if (!Base::construct(expr)) { + construct(expr, internal::false_type()); + } + } + + template + EIGEN_DEVICE_FUNC void construct(const Expression& expr, internal::false_type) + { + internal::call_assignment_no_alias(m_object,expr,internal::assign_op()); + Base::construct(m_object); + } + + protected: + TPlainObjectType m_object; +}; + +} // end namespace Eigen + +#endif // EIGEN_REF_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Replicate.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Replicate.h new file mode 100644 index 0000000..ab5be7e --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Replicate.h @@ -0,0 +1,142 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REPLICATE_H +#define EIGEN_REPLICATE_H + +namespace Eigen { + +namespace internal { +template +struct traits > + : traits +{ + typedef typename MatrixType::Scalar Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + typedef typename ref_selector::type MatrixTypeNested; + typedef typename remove_reference::type _MatrixTypeNested; + enum { + RowsAtCompileTime = RowFactor==Dynamic || int(MatrixType::RowsAtCompileTime)==Dynamic + ? Dynamic + : RowFactor * MatrixType::RowsAtCompileTime, + ColsAtCompileTime = ColFactor==Dynamic || int(MatrixType::ColsAtCompileTime)==Dynamic + ? Dynamic + : ColFactor * MatrixType::ColsAtCompileTime, + //FIXME we don't propagate the max sizes !!! + MaxRowsAtCompileTime = RowsAtCompileTime, + MaxColsAtCompileTime = ColsAtCompileTime, + IsRowMajor = MaxRowsAtCompileTime==1 && MaxColsAtCompileTime!=1 ? 1 + : MaxColsAtCompileTime==1 && MaxRowsAtCompileTime!=1 ? 0 + : (MatrixType::Flags & RowMajorBit) ? 1 : 0, + + // FIXME enable DirectAccess with negative strides? + Flags = IsRowMajor ? RowMajorBit : 0 + }; +}; +} + +/** + * \class Replicate + * \ingroup Core_Module + * + * \brief Expression of the multiple replication of a matrix or vector + * + * \tparam MatrixType the type of the object we are replicating + * \tparam RowFactor number of repetitions at compile time along the vertical direction, can be Dynamic. + * \tparam ColFactor number of repetitions at compile time along the horizontal direction, can be Dynamic. + * + * This class represents an expression of the multiple replication of a matrix or vector. + * It is the return type of DenseBase::replicate() and most of the time + * this is the only way it is used. + * + * \sa DenseBase::replicate() + */ +template class Replicate + : public internal::dense_xpr_base< Replicate >::type +{ + typedef typename internal::traits::MatrixTypeNested MatrixTypeNested; + typedef typename internal::traits::_MatrixTypeNested _MatrixTypeNested; + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Replicate) + typedef typename internal::remove_all::type NestedExpression; + + template + EIGEN_DEVICE_FUNC + inline explicit Replicate(const OriginalMatrixType& matrix) + : m_matrix(matrix), m_rowFactor(RowFactor), m_colFactor(ColFactor) + { + EIGEN_STATIC_ASSERT((internal::is_same::type,OriginalMatrixType>::value), + THE_MATRIX_OR_EXPRESSION_THAT_YOU_PASSED_DOES_NOT_HAVE_THE_EXPECTED_TYPE) + eigen_assert(RowFactor!=Dynamic && ColFactor!=Dynamic); + } + + template + EIGEN_DEVICE_FUNC + inline Replicate(const OriginalMatrixType& matrix, Index rowFactor, Index colFactor) + : m_matrix(matrix), m_rowFactor(rowFactor), m_colFactor(colFactor) + { + EIGEN_STATIC_ASSERT((internal::is_same::type,OriginalMatrixType>::value), + THE_MATRIX_OR_EXPRESSION_THAT_YOU_PASSED_DOES_NOT_HAVE_THE_EXPECTED_TYPE) + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const { return m_matrix.rows() * m_rowFactor.value(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const { return m_matrix.cols() * m_colFactor.value(); } + + EIGEN_DEVICE_FUNC + const _MatrixTypeNested& nestedExpression() const + { + return m_matrix; + } + + protected: + MatrixTypeNested m_matrix; + const internal::variable_if_dynamic m_rowFactor; + const internal::variable_if_dynamic m_colFactor; +}; + +/** + * \return an expression of the replication of \c *this + * + * Example: \include MatrixBase_replicate.cpp + * Output: \verbinclude MatrixBase_replicate.out + * + * \sa VectorwiseOp::replicate(), DenseBase::replicate(Index,Index), class Replicate + */ +template +template +EIGEN_DEVICE_FUNC const Replicate +DenseBase::replicate() const +{ + return Replicate(derived()); +} + +/** + * \return an expression of the replication of each column (or row) of \c *this + * + * Example: \include DirectionWise_replicate_int.cpp + * Output: \verbinclude DirectionWise_replicate_int.out + * + * \sa VectorwiseOp::replicate(), DenseBase::replicate(), class Replicate + */ +template +EIGEN_DEVICE_FUNC const typename VectorwiseOp::ReplicateReturnType +VectorwiseOp::replicate(Index factor) const +{ + return typename VectorwiseOp::ReplicateReturnType + (_expression(),Direction==Vertical?factor:1,Direction==Horizontal?factor:1); +} + +} // end namespace Eigen + +#endif // EIGEN_REPLICATE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Reshaped.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Reshaped.h new file mode 100644 index 0000000..52de73b --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Reshaped.h @@ -0,0 +1,454 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2017 Gael Guennebaud +// Copyright (C) 2014 yoco +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_RESHAPED_H +#define EIGEN_RESHAPED_H + +namespace Eigen { + +/** \class Reshaped + * \ingroup Core_Module + * + * \brief Expression of a fixed-size or dynamic-size reshape + * + * \tparam XprType the type of the expression in which we are taking a reshape + * \tparam Rows the number of rows of the reshape we are taking at compile time (optional) + * \tparam Cols the number of columns of the reshape we are taking at compile time (optional) + * \tparam Order can be ColMajor or RowMajor, default is ColMajor. + * + * This class represents an expression of either a fixed-size or dynamic-size reshape. + * It is the return type of DenseBase::reshaped(NRowsType,NColsType) and + * most of the time this is the only way it is used. + * + * However, in C++98, if you want to directly maniputate reshaped expressions, + * for instance if you want to write a function returning such an expression, you + * will need to use this class. In C++11, it is advised to use the \em auto + * keyword for such use cases. + * + * Here is an example illustrating the dynamic case: + * \include class_Reshaped.cpp + * Output: \verbinclude class_Reshaped.out + * + * Here is an example illustrating the fixed-size case: + * \include class_FixedReshaped.cpp + * Output: \verbinclude class_FixedReshaped.out + * + * \sa DenseBase::reshaped(NRowsType,NColsType) + */ + +namespace internal { + +template +struct traits > : traits +{ + typedef typename traits::Scalar Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + enum{ + MatrixRows = traits::RowsAtCompileTime, + MatrixCols = traits::ColsAtCompileTime, + RowsAtCompileTime = Rows, + ColsAtCompileTime = Cols, + MaxRowsAtCompileTime = Rows, + MaxColsAtCompileTime = Cols, + XpxStorageOrder = ((int(traits::Flags) & RowMajorBit) == RowMajorBit) ? RowMajor : ColMajor, + ReshapedStorageOrder = (RowsAtCompileTime == 1 && ColsAtCompileTime != 1) ? RowMajor + : (ColsAtCompileTime == 1 && RowsAtCompileTime != 1) ? ColMajor + : XpxStorageOrder, + HasSameStorageOrderAsXprType = (ReshapedStorageOrder == XpxStorageOrder), + InnerSize = (ReshapedStorageOrder==int(RowMajor)) ? int(ColsAtCompileTime) : int(RowsAtCompileTime), + InnerStrideAtCompileTime = HasSameStorageOrderAsXprType + ? int(inner_stride_at_compile_time::ret) + : Dynamic, + OuterStrideAtCompileTime = Dynamic, + + HasDirectAccess = internal::has_direct_access::ret + && (Order==int(XpxStorageOrder)) + && ((evaluator::Flags&LinearAccessBit)==LinearAccessBit), + + MaskPacketAccessBit = (InnerSize == Dynamic || (InnerSize % packet_traits::size) == 0) + && (InnerStrideAtCompileTime == 1) + ? PacketAccessBit : 0, + //MaskAlignedBit = ((OuterStrideAtCompileTime!=Dynamic) && (((OuterStrideAtCompileTime * int(sizeof(Scalar))) % 16) == 0)) ? AlignedBit : 0, + FlagsLinearAccessBit = (RowsAtCompileTime == 1 || ColsAtCompileTime == 1) ? LinearAccessBit : 0, + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + FlagsRowMajorBit = (ReshapedStorageOrder==int(RowMajor)) ? RowMajorBit : 0, + FlagsDirectAccessBit = HasDirectAccess ? DirectAccessBit : 0, + Flags0 = traits::Flags & ( (HereditaryBits & ~RowMajorBit) | MaskPacketAccessBit), + + Flags = (Flags0 | FlagsLinearAccessBit | FlagsLvalueBit | FlagsRowMajorBit | FlagsDirectAccessBit) + }; +}; + +template class ReshapedImpl_dense; + +} // end namespace internal + +template class ReshapedImpl; + +template class Reshaped + : public ReshapedImpl::StorageKind> +{ + typedef ReshapedImpl::StorageKind> Impl; + public: + //typedef typename Impl::Base Base; + typedef Impl Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(Reshaped) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Reshaped) + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC + inline Reshaped(XprType& xpr) + : Impl(xpr) + { + EIGEN_STATIC_ASSERT(RowsAtCompileTime!=Dynamic && ColsAtCompileTime!=Dynamic,THIS_METHOD_IS_ONLY_FOR_FIXED_SIZE) + eigen_assert(Rows * Cols == xpr.rows() * xpr.cols()); + } + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC + inline Reshaped(XprType& xpr, + Index reshapeRows, Index reshapeCols) + : Impl(xpr, reshapeRows, reshapeCols) + { + eigen_assert((RowsAtCompileTime==Dynamic || RowsAtCompileTime==reshapeRows) + && (ColsAtCompileTime==Dynamic || ColsAtCompileTime==reshapeCols)); + eigen_assert(reshapeRows * reshapeCols == xpr.rows() * xpr.cols()); + } +}; + +// The generic default implementation for dense reshape simply forward to the internal::ReshapedImpl_dense +// that must be specialized for direct and non-direct access... +template +class ReshapedImpl + : public internal::ReshapedImpl_dense >::HasDirectAccess> +{ + typedef internal::ReshapedImpl_dense >::HasDirectAccess> Impl; + public: + typedef Impl Base; + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(ReshapedImpl) + EIGEN_DEVICE_FUNC inline ReshapedImpl(XprType& xpr) : Impl(xpr) {} + EIGEN_DEVICE_FUNC inline ReshapedImpl(XprType& xpr, Index reshapeRows, Index reshapeCols) + : Impl(xpr, reshapeRows, reshapeCols) {} +}; + +namespace internal { + +/** \internal Internal implementation of dense Reshaped in the general case. */ +template +class ReshapedImpl_dense + : public internal::dense_xpr_base >::type +{ + typedef Reshaped ReshapedType; + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ReshapedType) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(ReshapedImpl_dense) + + typedef typename internal::ref_selector::non_const_type MatrixTypeNested; + typedef typename internal::remove_all::type NestedExpression; + + class InnerIterator; + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC + inline ReshapedImpl_dense(XprType& xpr) + : m_xpr(xpr), m_rows(Rows), m_cols(Cols) + {} + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC + inline ReshapedImpl_dense(XprType& xpr, Index nRows, Index nCols) + : m_xpr(xpr), m_rows(nRows), m_cols(nCols) + {} + + EIGEN_DEVICE_FUNC Index rows() const { return m_rows; } + EIGEN_DEVICE_FUNC Index cols() const { return m_cols; } + + #ifdef EIGEN_PARSED_BY_DOXYGEN + /** \sa MapBase::data() */ + EIGEN_DEVICE_FUNC inline const Scalar* data() const; + EIGEN_DEVICE_FUNC inline Index innerStride() const; + EIGEN_DEVICE_FUNC inline Index outerStride() const; + #endif + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC + const typename internal::remove_all::type& + nestedExpression() const { return m_xpr; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC + typename internal::remove_reference::type& + nestedExpression() { return m_xpr; } + + protected: + + MatrixTypeNested m_xpr; + const internal::variable_if_dynamic m_rows; + const internal::variable_if_dynamic m_cols; +}; + + +/** \internal Internal implementation of dense Reshaped in the direct access case. */ +template +class ReshapedImpl_dense + : public MapBase > +{ + typedef Reshaped ReshapedType; + typedef typename internal::ref_selector::non_const_type XprTypeNested; + public: + + typedef MapBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ReshapedType) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(ReshapedImpl_dense) + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC + inline ReshapedImpl_dense(XprType& xpr) + : Base(xpr.data()), m_xpr(xpr) + {} + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC + inline ReshapedImpl_dense(XprType& xpr, Index nRows, Index nCols) + : Base(xpr.data(), nRows, nCols), + m_xpr(xpr) + {} + + EIGEN_DEVICE_FUNC + const typename internal::remove_all::type& nestedExpression() const + { + return m_xpr; + } + + EIGEN_DEVICE_FUNC + XprType& nestedExpression() { return m_xpr; } + + /** \sa MapBase::innerStride() */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const + { + return m_xpr.innerStride(); + } + + /** \sa MapBase::outerStride() */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const + { + return ((Flags&RowMajorBit)==RowMajorBit) ? this->cols() : this->rows(); + } + + protected: + + XprTypeNested m_xpr; +}; + +// Evaluators +template struct reshaped_evaluator; + +template +struct evaluator > + : reshaped_evaluator >::HasDirectAccess> +{ + typedef Reshaped XprType; + typedef typename XprType::Scalar Scalar; + // TODO: should check for smaller packet types + typedef typename packet_traits::type PacketScalar; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + HasDirectAccess = traits::HasDirectAccess, + +// RowsAtCompileTime = traits::RowsAtCompileTime, +// ColsAtCompileTime = traits::ColsAtCompileTime, +// MaxRowsAtCompileTime = traits::MaxRowsAtCompileTime, +// MaxColsAtCompileTime = traits::MaxColsAtCompileTime, +// +// InnerStrideAtCompileTime = traits::HasSameStorageOrderAsXprType +// ? int(inner_stride_at_compile_time::ret) +// : Dynamic, +// OuterStrideAtCompileTime = Dynamic, + + FlagsLinearAccessBit = (traits::RowsAtCompileTime == 1 || traits::ColsAtCompileTime == 1 || HasDirectAccess) ? LinearAccessBit : 0, + FlagsRowMajorBit = (traits::ReshapedStorageOrder==int(RowMajor)) ? RowMajorBit : 0, + FlagsDirectAccessBit = HasDirectAccess ? DirectAccessBit : 0, + Flags0 = evaluator::Flags & (HereditaryBits & ~RowMajorBit), + Flags = Flags0 | FlagsLinearAccessBit | FlagsRowMajorBit | FlagsDirectAccessBit, + + PacketAlignment = unpacket_traits::alignment, + Alignment = evaluator::Alignment + }; + typedef reshaped_evaluator reshaped_evaluator_type; + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& xpr) : reshaped_evaluator_type(xpr) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } +}; + +template +struct reshaped_evaluator + : evaluator_base > +{ + typedef Reshaped XprType; + + enum { + CoeffReadCost = evaluator::CoeffReadCost /* TODO + cost of index computations */, + + Flags = (evaluator::Flags & (HereditaryBits /*| LinearAccessBit | DirectAccessBit*/)), + + Alignment = 0 + }; + + EIGEN_DEVICE_FUNC explicit reshaped_evaluator(const XprType& xpr) : m_argImpl(xpr.nestedExpression()), m_xpr(xpr) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + typedef std::pair RowCol; + + inline RowCol index_remap(Index rowId, Index colId) const + { + if(Order==ColMajor) + { + const Index nth_elem_idx = colId * m_xpr.rows() + rowId; + return RowCol(nth_elem_idx % m_xpr.nestedExpression().rows(), + nth_elem_idx / m_xpr.nestedExpression().rows()); + } + else + { + const Index nth_elem_idx = colId + rowId * m_xpr.cols(); + return RowCol(nth_elem_idx / m_xpr.nestedExpression().cols(), + nth_elem_idx % m_xpr.nestedExpression().cols()); + } + } + + EIGEN_DEVICE_FUNC + inline Scalar& coeffRef(Index rowId, Index colId) + { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + const RowCol row_col = index_remap(rowId, colId); + return m_argImpl.coeffRef(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index rowId, Index colId) const + { + const RowCol row_col = index_remap(rowId, colId); + return m_argImpl.coeffRef(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE const CoeffReturnType coeff(Index rowId, Index colId) const + { + const RowCol row_col = index_remap(rowId, colId); + return m_argImpl.coeff(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC + inline Scalar& coeffRef(Index index) + { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + const RowCol row_col = index_remap(Rows == 1 ? 0 : index, + Rows == 1 ? index : 0); + return m_argImpl.coeffRef(row_col.first, row_col.second); + + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index index) const + { + const RowCol row_col = index_remap(Rows == 1 ? 0 : index, + Rows == 1 ? index : 0); + return m_argImpl.coeffRef(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC + inline const CoeffReturnType coeff(Index index) const + { + const RowCol row_col = index_remap(Rows == 1 ? 0 : index, + Rows == 1 ? index : 0); + return m_argImpl.coeff(row_col.first, row_col.second); + } +#if 0 + EIGEN_DEVICE_FUNC + template + inline PacketScalar packet(Index rowId, Index colId) const + { + const RowCol row_col = index_remap(rowId, colId); + return m_argImpl.template packet(row_col.first, row_col.second); + + } + + template + EIGEN_DEVICE_FUNC + inline void writePacket(Index rowId, Index colId, const PacketScalar& val) + { + const RowCol row_col = index_remap(rowId, colId); + m_argImpl.const_cast_derived().template writePacket + (row_col.first, row_col.second, val); + } + + template + EIGEN_DEVICE_FUNC + inline PacketScalar packet(Index index) const + { + const RowCol row_col = index_remap(RowsAtCompileTime == 1 ? 0 : index, + RowsAtCompileTime == 1 ? index : 0); + return m_argImpl.template packet(row_col.first, row_col.second); + } + + template + EIGEN_DEVICE_FUNC + inline void writePacket(Index index, const PacketScalar& val) + { + const RowCol row_col = index_remap(RowsAtCompileTime == 1 ? 0 : index, + RowsAtCompileTime == 1 ? index : 0); + return m_argImpl.template packet(row_col.first, row_col.second, val); + } +#endif +protected: + + evaluator m_argImpl; + const XprType& m_xpr; + +}; + +template +struct reshaped_evaluator +: mapbase_evaluator, + typename Reshaped::PlainObject> +{ + typedef Reshaped XprType; + typedef typename XprType::Scalar Scalar; + + EIGEN_DEVICE_FUNC explicit reshaped_evaluator(const XprType& xpr) + : mapbase_evaluator(xpr) + { + // TODO: for the 3.4 release, this should be turned to an internal assertion, but let's keep it as is for the beta lifetime + eigen_assert(((internal::UIntPtr(xpr.data()) % EIGEN_PLAIN_ENUM_MAX(1,evaluator::Alignment)) == 0) && "data is not aligned"); + } +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_RESHAPED_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ReturnByValue.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ReturnByValue.h new file mode 100644 index 0000000..4dad13e --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/ReturnByValue.h @@ -0,0 +1,119 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// Copyright (C) 2009-2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_RETURNBYVALUE_H +#define EIGEN_RETURNBYVALUE_H + +namespace Eigen { + +namespace internal { + +template +struct traits > + : public traits::ReturnType> +{ + enum { + // We're disabling the DirectAccess because e.g. the constructor of + // the Block-with-DirectAccess expression requires to have a coeffRef method. + // Also, we don't want to have to implement the stride stuff. + Flags = (traits::ReturnType>::Flags + | EvalBeforeNestingBit) & ~DirectAccessBit + }; +}; + +/* The ReturnByValue object doesn't even have a coeff() method. + * So the only way that nesting it in an expression can work, is by evaluating it into a plain matrix. + * So internal::nested always gives the plain return matrix type. + * + * FIXME: I don't understand why we need this specialization: isn't this taken care of by the EvalBeforeNestingBit ?? + * Answer: EvalBeforeNestingBit should be deprecated since we have the evaluators + */ +template +struct nested_eval, n, PlainObject> +{ + typedef typename traits::ReturnType type; +}; + +} // end namespace internal + +/** \class ReturnByValue + * \ingroup Core_Module + * + */ +template class ReturnByValue + : public internal::dense_xpr_base< ReturnByValue >::type, internal::no_assignment_operator +{ + public: + typedef typename internal::traits::ReturnType ReturnType; + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ReturnByValue) + + template + EIGEN_DEVICE_FUNC + inline void evalTo(Dest& dst) const + { static_cast(this)->evalTo(dst); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return static_cast(this)->rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return static_cast(this)->cols(); } + +#ifndef EIGEN_PARSED_BY_DOXYGEN +#define Unusable YOU_ARE_TRYING_TO_ACCESS_A_SINGLE_COEFFICIENT_IN_A_SPECIAL_EXPRESSION_WHERE_THAT_IS_NOT_ALLOWED_BECAUSE_THAT_WOULD_BE_INEFFICIENT + class Unusable{ + Unusable(const Unusable&) {} + Unusable& operator=(const Unusable&) {return *this;} + }; + const Unusable& coeff(Index) const { return *reinterpret_cast(this); } + const Unusable& coeff(Index,Index) const { return *reinterpret_cast(this); } + Unusable& coeffRef(Index) { return *reinterpret_cast(this); } + Unusable& coeffRef(Index,Index) { return *reinterpret_cast(this); } +#undef Unusable +#endif +}; + +template +template +EIGEN_DEVICE_FUNC Derived& DenseBase::operator=(const ReturnByValue& other) +{ + other.evalTo(derived()); + return derived(); +} + +namespace internal { + +// Expression is evaluated in a temporary; default implementation of Assignment is bypassed so that +// when a ReturnByValue expression is assigned, the evaluator is not constructed. +// TODO: Finalize port to new regime; ReturnByValue should not exist in the expression world + +template +struct evaluator > + : public evaluator::ReturnType> +{ + typedef ReturnByValue XprType; + typedef typename internal::traits::ReturnType PlainObject; + typedef evaluator Base; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& xpr) + : m_result(xpr.rows(), xpr.cols()) + { + ::new (static_cast(this)) Base(m_result); + xpr.evalTo(m_result); + } + +protected: + PlainObject m_result; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_RETURNBYVALUE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Reverse.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Reverse.h new file mode 100644 index 0000000..28cdd76 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Reverse.h @@ -0,0 +1,217 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2009 Ricard Marxer +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REVERSE_H +#define EIGEN_REVERSE_H + +namespace Eigen { + +namespace internal { + +template +struct traits > + : traits +{ + typedef typename MatrixType::Scalar Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + typedef typename ref_selector::type MatrixTypeNested; + typedef typename remove_reference::type _MatrixTypeNested; + enum { + RowsAtCompileTime = MatrixType::RowsAtCompileTime, + ColsAtCompileTime = MatrixType::ColsAtCompileTime, + MaxRowsAtCompileTime = MatrixType::MaxRowsAtCompileTime, + MaxColsAtCompileTime = MatrixType::MaxColsAtCompileTime, + Flags = _MatrixTypeNested::Flags & (RowMajorBit | LvalueBit) + }; +}; + +template struct reverse_packet_cond +{ + static inline PacketType run(const PacketType& x) { return preverse(x); } +}; + +template struct reverse_packet_cond +{ + static inline PacketType run(const PacketType& x) { return x; } +}; + +} // end namespace internal + +/** \class Reverse + * \ingroup Core_Module + * + * \brief Expression of the reverse of a vector or matrix + * + * \tparam MatrixType the type of the object of which we are taking the reverse + * \tparam Direction defines the direction of the reverse operation, can be Vertical, Horizontal, or BothDirections + * + * This class represents an expression of the reverse of a vector. + * It is the return type of MatrixBase::reverse() and VectorwiseOp::reverse() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::reverse(), VectorwiseOp::reverse() + */ +template class Reverse + : public internal::dense_xpr_base< Reverse >::type +{ + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Reverse) + typedef typename internal::remove_all::type NestedExpression; + using Base::IsRowMajor; + + protected: + enum { + PacketSize = internal::packet_traits::size, + IsColMajor = !IsRowMajor, + ReverseRow = (Direction == Vertical) || (Direction == BothDirections), + ReverseCol = (Direction == Horizontal) || (Direction == BothDirections), + OffsetRow = ReverseRow && IsColMajor ? PacketSize : 1, + OffsetCol = ReverseCol && IsRowMajor ? PacketSize : 1, + ReversePacket = (Direction == BothDirections) + || ((Direction == Vertical) && IsColMajor) + || ((Direction == Horizontal) && IsRowMajor) + }; + typedef internal::reverse_packet_cond reverse_packet; + public: + + EIGEN_DEVICE_FUNC explicit inline Reverse(const MatrixType& matrix) : m_matrix(matrix) { } + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Reverse) + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return m_matrix.rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return m_matrix.cols(); } + + EIGEN_DEVICE_FUNC inline Index innerStride() const + { + return -m_matrix.innerStride(); + } + + EIGEN_DEVICE_FUNC const typename internal::remove_all::type& + nestedExpression() const + { + return m_matrix; + } + + protected: + typename MatrixType::Nested m_matrix; +}; + +/** \returns an expression of the reverse of *this. + * + * Example: \include MatrixBase_reverse.cpp + * Output: \verbinclude MatrixBase_reverse.out + * + */ +template +EIGEN_DEVICE_FUNC inline typename DenseBase::ReverseReturnType +DenseBase::reverse() +{ + return ReverseReturnType(derived()); +} + + +//reverse const overload moved DenseBase.h due to a CUDA compiler bug + +/** This is the "in place" version of reverse: it reverses \c *this. + * + * In most cases it is probably better to simply use the reversed expression + * of a matrix. However, when reversing the matrix data itself is really needed, + * then this "in-place" version is probably the right choice because it provides + * the following additional benefits: + * - less error prone: doing the same operation with .reverse() requires special care: + * \code m = m.reverse().eval(); \endcode + * - this API enables reverse operations without the need for a temporary + * - it allows future optimizations (cache friendliness, etc.) + * + * \sa VectorwiseOp::reverseInPlace(), reverse() */ +template +EIGEN_DEVICE_FUNC inline void DenseBase::reverseInPlace() +{ + if(cols()>rows()) + { + Index half = cols()/2; + leftCols(half).swap(rightCols(half).reverse()); + if((cols()%2)==1) + { + Index half2 = rows()/2; + col(half).head(half2).swap(col(half).tail(half2).reverse()); + } + } + else + { + Index half = rows()/2; + topRows(half).swap(bottomRows(half).reverse()); + if((rows()%2)==1) + { + Index half2 = cols()/2; + row(half).head(half2).swap(row(half).tail(half2).reverse()); + } + } +} + +namespace internal { + +template +struct vectorwise_reverse_inplace_impl; + +template<> +struct vectorwise_reverse_inplace_impl +{ + template + static void run(ExpressionType &xpr) + { + const int HalfAtCompileTime = ExpressionType::RowsAtCompileTime==Dynamic?Dynamic:ExpressionType::RowsAtCompileTime/2; + Index half = xpr.rows()/2; + xpr.topRows(fix(half)) + .swap(xpr.bottomRows(fix(half)).colwise().reverse()); + } +}; + +template<> +struct vectorwise_reverse_inplace_impl +{ + template + static void run(ExpressionType &xpr) + { + const int HalfAtCompileTime = ExpressionType::ColsAtCompileTime==Dynamic?Dynamic:ExpressionType::ColsAtCompileTime/2; + Index half = xpr.cols()/2; + xpr.leftCols(fix(half)) + .swap(xpr.rightCols(fix(half)).rowwise().reverse()); + } +}; + +} // end namespace internal + +/** This is the "in place" version of VectorwiseOp::reverse: it reverses each column or row of \c *this. + * + * In most cases it is probably better to simply use the reversed expression + * of a matrix. However, when reversing the matrix data itself is really needed, + * then this "in-place" version is probably the right choice because it provides + * the following additional benefits: + * - less error prone: doing the same operation with .reverse() requires special care: + * \code m = m.reverse().eval(); \endcode + * - this API enables reverse operations without the need for a temporary + * + * \sa DenseBase::reverseInPlace(), reverse() */ +template +EIGEN_DEVICE_FUNC void VectorwiseOp::reverseInPlace() +{ + internal::vectorwise_reverse_inplace_impl::run(m_matrix); +} + +} // end namespace Eigen + +#endif // EIGEN_REVERSE_H diff --git a/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Select.h b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Select.h new file mode 100644 index 0000000..7c86bf8 --- /dev/null +++ b/src/thirdparty/eigen-3.4.0/Eigen/src/Core/Select.h @@ -0,0 +1,164 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SELECT_H +#define EIGEN_SELECT_H + +namespace Eigen { + +/** \class Select + * \ingroup Core_Module + * + * \brief Expression of a coefficient wise version of the C++ ternary operator ?: + * + * \param ConditionMatrixType the type of the \em condition expression which must be a boolean matrix + * \param ThenMatrixType the type of the \em then expression + * \param ElseMatrixType the type of the \em else expression + * + * This class represents an expression of a coefficient wise version of the C++ ternary operator ?:. + * It is the return type of DenseBase::select() and most of the time this is the only way it is used. + * + * \sa DenseBase::select(const DenseBase&, const DenseBase&) const + */ + +namespace internal { +template +struct traits > + : traits +{ + typedef typename traits::Scalar Scalar; + typedef Dense StorageKind; + typedef typename traits::XprKind XprKind; + typedef typename ConditionMatrixType::Nested ConditionMatrixNested; + typedef typename ThenMatrixType::Nested ThenMatrixNested; + typedef typename ElseMatrixType::Nested ElseMatrixNested; + enum { + RowsAtCompileTime = ConditionMatrixType::RowsAtCompileTime, + ColsAtCompileTime = ConditionMatrixType::ColsAtCompileTime, + MaxRowsAtCompileTime = ConditionMatrixType::MaxRowsAtCompileTime, + MaxColsAtCompileTime = ConditionMatrixType::MaxColsAtCompileTime, + Flags = (unsigned int)ThenMatrixType::Flags & ElseMatrixType::Flags & RowMajorBit + }; +}; +} + +template +class Select : public internal::dense_xpr_base< Select >::type, + internal::no_assignment_operator +{ + public: + + typedef typename internal::dense_xpr_base

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 z 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 literal 0 HcmV?d00001 diff --git a/experiment_data/sample_data/03-sampleName.xlsx b/experiment_data/sample_data/03-sampleName.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..a6f2179042187e76ea9b5ff3aab2998031fab9ab GIT binary patch literal 345129 zcmZ6yby$;O`vy#naDe0h84Zr^7${vTFhG$U-3T%|hIGeBDM3;Jkw!}C?h*m%(bCfW z&G&u3-*+6}U)vw|^<4LP^?lyYqosz6M}>t&NQeb^+i7UrgVLQ70ALlmfv{+?u&}%x z1-zVH-?-UXTf4gn{O3oA-`mMCw%K@+uQBe^xgM2AMFBgZzsIx8^jjhGCCSH*OKG28 zstF~%(EhYvci&vqkla__khJ?tUGvSz#>(tW#v0DE<#y-$x%=z-*1JDT0T5fZ#KHZ{{lwDU6}=?t=0oed`?S`8^NbZ!|Er3jqt%?d zlQh|z!>gl*_hH_v=iu0q56CcSizebVHX@nzA?BUQ4&< zhXMx_hIjiCt@lp%z4r&LH;0&Ymj|s^m!q}E@CUn8vVN8@Gh1pH1~@5uwK z0*)k3B<@x3b?`X*SL3s0S}jM2YOZp@2(Hxm+m%}_Lwe0ZsX&Q+tDHGgUiby*S7H$IsLavjEKj zqT|z}9q3D{oDx3KM9Gc?)bDd)kee&!S64e$Jb{ut&d}R>B~=P z{Hyvl2<8dy&|;GJ?@e#Yx|1JHqlr!RGKNN59i~{p#?|;%2G!Wiqa2VMpVWcYrkwp!Qf&$*LGbdjN32S{}ynEb27U zx-J(E3Z*sr#TFs_5E*X{1pa9Tc)U!U4E_UJ{=OX;rnvDSA9>nrzN1&&(-1paY$MM5~2(a(6tQgqG#A4J9et!oLcviQm)p2t>cY6Cx zCGOjL=BsQHJ0mCAwH)iQ50h8ntyyy*R)!$vEH-4e-QeKi!k?6 zyo@n?nRPdQPFp9)JWo&dm|T{G@U0yGxW6INsgp%)6hCwj>ssU3r7$yd1oJIQID6b7YNMblu&C@fP@8i20}MPv1}<+ki_)uE^$_*G~DJ>KP>I zVmoR0Tg})~jm|~bfAH6m-o)Cdwlhl7=bDP=>HZ9#DHXaFmia(uhX32uzK;Cc<@M