diff --git a/applications/test/vector/Test-vector.C b/applications/test/vector/Test-vector.C
index 65e995ae4a..497dea43d1 100644
--- a/applications/test/vector/Test-vector.C
+++ b/applications/test/vector/Test-vector.C
@@ -1,37 +1,97 @@
+/*---------------------------------------------------------------------------*\
+ ========= |
+ \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
+ \\ / O peration |
+ \\ / A nd | Copyright (C) 2018 OpenCFD Ltd.
+ \\/ M anipulation |
+-------------------------------------------------------------------------------
+License
+ This file is part of OpenFOAM.
+
+ OpenFOAM is free software: you can redistribute it and/or modify it
+ under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
+ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with OpenFOAM. If not, see .
+
+Application
+ Test-vector
+
+Description
+ Some simple tests for vector
+
+\*---------------------------------------------------------------------------*/
+
#include "vector.H"
#include "IOstreams.H"
using namespace Foam;
-int main()
+void printInfo(const vector& vec)
{
- Info<< vector::zero << endl
- << vector::one << endl
- << vector::dim << endl
- << vector::rank << endl;
+ Info<< "vector : " << vec << nl
+ << "magSqr : " << magSqr(vec) << nl;
- vector d(0.5, 0.5, 0.5);
- d /= mag(d);
+ Info<< "component"
+ << " max:" << cmptMax(vec)
+ << " sum:" << cmptSum(vec)
+ << " prod:" << cmptProduct(vec)
+ << " mag:" << cmptMag(vec)
+ << nl << nl;
+}
- vector dSmall = (1e-100)*d;
- dSmall /= mag(dSmall);
- Info<< (dSmall - d) << endl;
+void doTest(vector& vec1, vector& vec2)
+{
+ Info<<"normalised(vector1): " << normalised(vec1) << nl;
+ Info<<"vector1: " << vec1 << nl;
+ vec1.normalise();
+ Info<<"normalised: " << vec1 << nl;
- d *= 4.0;
+ vector vecsmall((1e-100 * vec1));
- Info<< d << endl;
+ Info<<"small: " << vecsmall << nl;
+ Info<<"small normalised: " << normalised(vecsmall) << nl;
+ Info<<"small diff: " << (vecsmall.normalise() - vec1) << nl;
- Info<< d + d << endl;
+ vec1 *= 4.0;
- Info<< magSqr(d) << endl;
+ Info<< "scalar mult: " << vec1 << nl;
+ Info<< "addition : " << (vec1 + vec1) << nl;
+
+ printInfo(vec1);
+ printInfo(vec2);
+
+ Info<< "min of " << vec1 << " and " << vec2 << " = "
+ << min(vec1, vec2) << nl << nl;
+}
+
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+// Main program:
+
+int main(int argc, char *argv[])
+{
+ Info<<"normalised: " << vector(1,2,3).normalise() << nl;
+ Info<<"normalised: " << vector(VSMALL,VSMALL,VSMALL).normalise() << nl;
+ Info<<"normalised: " <<
+ vector(ROOTVSMALL,ROOTVSMALL,ROOTVSMALL).normalise() << nl;
+
+ {
+ vector vec1(0.5, 0.5, 0.5);
+ vector vec2(0.5, 0.51, -0.5);
+
+ doTest(vec1, vec2);
+ }
- vector d2(0.5, 0.51, -0.5);
- Info<< cmptMax(d2) << " "
- << cmptSum(d2) << " "
- << cmptProduct(d2) << " "
- << cmptMag(d2)
- << endl;
- Info<< min(d, d2) << endl;
return 0;
}
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
diff --git a/src/OpenFOAM/primitives/Vector/Vector.H b/src/OpenFOAM/primitives/Vector/Vector.H
index 8929027e03..73fed4132d 100644
--- a/src/OpenFOAM/primitives/Vector/Vector.H
+++ b/src/OpenFOAM/primitives/Vector/Vector.H
@@ -3,7 +3,7 @@
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration |
\\ / A nd | Copyright (C) 2011-2016 OpenFOAM Foundation
- \\/ M anipulation |
+ \\/ M anipulation | Copyright (C) 2018 OpenCFD Ltd.
-------------------------------------------------------------------------------
License
This file is part of OpenFOAM.
@@ -48,6 +48,7 @@ SourceFiles
namespace Foam
{
+// Forward Declarations
template class List;
/*---------------------------------------------------------------------------*\
@@ -84,34 +85,48 @@ public:
//- Construct initialized to zero
inline Vector(const Foam::zero);
- //- Construct given VectorSpace of the same rank
+ //- Copy construct from VectorSpace of the same rank
template
- inline Vector(const VectorSpace, Cmpt2, 3>&);
+ inline Vector(const VectorSpace, Cmpt2, 3>& vs);
- //- Construct given three components
+ //- Construct from three components
inline Vector(const Cmpt& vx, const Cmpt& vy, const Cmpt& vz);
//- Construct from Istream
- inline Vector(Istream&);
+ inline Vector(Istream& is);
// Member Functions
- // Access
+ //- Access to the vector x component
+ inline const Cmpt& x() const;
- inline const Cmpt& x() const;
- inline const Cmpt& y() const;
- inline const Cmpt& z() const;
+ //- Access to the vector y component
+ inline const Cmpt& y() const;
+
+ //- Access to the vector z component
+ inline const Cmpt& z() const;
+
+ //- Access to the vector x component
+ inline Cmpt& x();
+
+ //- Access to the vector y component
+ inline Cmpt& y();
+
+ //- Access to the vector z component
+ inline Cmpt& z();
+
+
+ //- Normalise the vector by its magnitude
+ inline Vector& normalise();
- inline Cmpt& x();
- inline Cmpt& y();
- inline Cmpt& z();
//- Return *this (used for point which is a typedef to Vector.
inline const Vector& centre
(
const Foam::List>&
) const;
+
};
diff --git a/src/OpenFOAM/primitives/Vector/VectorI.H b/src/OpenFOAM/primitives/Vector/VectorI.H
index 518a398dc5..764ddaf130 100644
--- a/src/OpenFOAM/primitives/Vector/VectorI.H
+++ b/src/OpenFOAM/primitives/Vector/VectorI.H
@@ -3,7 +3,7 @@
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration |
\\ / A nd | Copyright (C) 2011-2016 OpenFOAM Foundation
- \\/ M anipulation |
+ \\/ M anipulation | Copyright (C) 2018 OpenCFD Ltd.
-------------------------------------------------------------------------------
License
This file is part of OpenFOAM.
@@ -115,12 +115,30 @@ template
inline const Foam::Vector& Foam::Vector::centre
(
const Foam::List>&
-)const
+) const
{
return *this;
}
+template
+inline Foam::Vector& Foam::Vector::normalise()
+{
+ const scalar s(Foam::mag(*this));
+
+ if (s < ROOTVSMALL)
+ {
+ *this = Zero;
+ }
+ else
+ {
+ *this /= s;
+ }
+
+ return *this;
+}
+
+
// * * * * * * * * * * * * * * * Global Operators * * * * * * * * * * * * * //
namespace Foam
diff --git a/src/OpenFOAM/primitives/Vector2D/Vector2D.H b/src/OpenFOAM/primitives/Vector2D/Vector2D.H
index 58546c6933..620b8b1df6 100644
--- a/src/OpenFOAM/primitives/Vector2D/Vector2D.H
+++ b/src/OpenFOAM/primitives/Vector2D/Vector2D.H
@@ -3,7 +3,7 @@
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration |
\\ / A nd | Copyright (C) 2011-2016 OpenFOAM Foundation
- \\/ M anipulation |
+ \\/ M anipulation | Copyright (C) 2018 OpenCFD Ltd.
-------------------------------------------------------------------------------
License
This file is part of OpenFOAM.
@@ -78,31 +78,38 @@ public:
//- Construct initialized to zero
inline Vector2D(const Foam::zero);
- //- Construct given VectorSpace
- inline Vector2D(const VectorSpace, Cmpt, 2>&);
+ //- Copy construct from VectorSpace of the same rank
+ inline Vector2D(const VectorSpace, Cmpt, 2>& vs);
- //- Construct given two components
+ //- Construct from two components
inline Vector2D(const Cmpt& vx, const Cmpt& vy);
//- Construct from Istream
- inline Vector2D(Istream&);
+ inline Vector2D(Istream& is);
// Member Functions
- // Access
+ //- Access to the vector x component
+ inline const Cmpt& x() const;
- inline const Cmpt& x() const;
- inline const Cmpt& y() const;
+ //- Access to the vector y component
+ inline const Cmpt& y() const;
- inline Cmpt& x();
- inline Cmpt& y();
+ //- Access to the vector x component
+ inline Cmpt& x();
+
+ //- Access to the vector y component
+ inline Cmpt& y();
- // Operators
+ //- Normalise the vector by its magnitude
+ inline Vector2D& normalise();
+
+
+ //- Perp dot product (dot product with perpendicular vector)
+ inline scalar perp(const Vector2D& b) const;
- //- Perp dot product (dot product with perpendicular vector)
- inline scalar perp(const Vector2D& b) const;
};
diff --git a/src/OpenFOAM/primitives/Vector2D/Vector2DI.H b/src/OpenFOAM/primitives/Vector2D/Vector2DI.H
index 3148e7d0af..3c5fcdb7d3 100644
--- a/src/OpenFOAM/primitives/Vector2D/Vector2DI.H
+++ b/src/OpenFOAM/primitives/Vector2D/Vector2DI.H
@@ -3,7 +3,7 @@
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration |
\\ / A nd | Copyright (C) 2011-2016 OpenFOAM Foundation
- \\/ M anipulation |
+ \\/ M anipulation | Copyright (C) 2018 OpenCFD Ltd.
-------------------------------------------------------------------------------
License
This file is part of OpenFOAM.
@@ -70,6 +70,7 @@ inline const Cmpt& Foam::Vector2D::x() const
return this->v_[X];
}
+
template
inline const Cmpt& Foam::Vector2D::y() const
{
@@ -83,6 +84,7 @@ inline Cmpt& Foam::Vector2D::x()
return this->v_[X];
}
+
template
inline Cmpt& Foam::Vector2D::y()
{
@@ -90,6 +92,22 @@ inline Cmpt& Foam::Vector2D::y()
}
+template
+inline Foam::Vector2D& Foam::Vector2D::normalise()
+{
+ const scalar s(Foam::mag(*this));
+
+ if (s < ROOTVSMALL)
+ {
+ *this = Zero;
+ }
+ else
+ {
+ *this /= s;
+ }
+}
+
+
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
namespace Foam
diff --git a/src/OpenFOAM/primitives/VectorSpace/VectorSpace.H b/src/OpenFOAM/primitives/VectorSpace/VectorSpace.H
index 940294b8e7..3c1eac359e 100644
--- a/src/OpenFOAM/primitives/VectorSpace/VectorSpace.H
+++ b/src/OpenFOAM/primitives/VectorSpace/VectorSpace.H
@@ -49,33 +49,32 @@ SourceFiles
namespace Foam
{
-// Forward declaration of friend functions and operators
+// Forward declarations
template class VectorSpace;
template
Istream& operator>>
(
- Istream&,
- VectorSpace