zhyang-dev/openfoam
1
0
Fork 0
mirror of https://develop.openfoam.com/Development/openfoam.git synced 2025-11-28 03:28:01 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

STYLE: adjust comments in quaternion

Browse Source 
- make I/O operators global (non-member)
This commit is contained in:
Mark Olesen
2019-04-26 10:27:53 +02:00
committed by Andrew Heather
parent 661d1f53df
commit 5f40a738d3
3 changed files with 57 additions and 71 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
src/OpenFOAM/primitives/quaternion/quaternion.C
View File

@ -2,7 +2,7 @@
========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration |
\\ / A nd |
\\ / A nd | Copyright (C) 2019 OpenCFD Ltd.
\\/ M anipulation |
-------------------------------------------------------------------------------
| Copyright (C) 2011-2016 OpenFOAM Foundation
@ -153,12 +153,8 @@ Foam::quaternion Foam::pow(const quaternion& q, const scalar power)
Foam::Istream& Foam::operator>>(Istream& is, quaternion& q)
{
// Read beginning of quaternion
is.readBegin("quaternion");
is >> q.w() >> q.v();
// Read end of quaternion
is.readEnd("quaternion");
is.check(FUNCTION_NAME);

70
src/OpenFOAM/primitives/quaternion/quaternion.H
View File

@ -2,7 +2,7 @@
========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration |
\\ / A nd |
\\ / A nd | Copyright (C) 2019 OpenCFD Ltd.
\\/ M anipulation |
-------------------------------------------------------------------------------
| Copyright (C) 2011-2016 OpenFOAM Foundation
@ -49,20 +49,13 @@ SourceFiles
namespace Foam
{
// Forward declaration of friend functions and operators
class quaternion;
Istream& operator>>(Istream& is, quaternion&);
Ostream& operator<<(Ostream& os, const quaternion& C);
/*---------------------------------------------------------------------------*\
Class quaternion Declaration
\*---------------------------------------------------------------------------*/
class quaternion
{
// private data
// Private Data
//- Scalar part of the quaternion ( = cos(theta/2) for rotation)
scalar w_;
@ -107,13 +100,13 @@ public:
};
// Member constants
// Member Constants
//- Rank of quaternion is 1
static constexpr direction rank = 1;
// Static data members
// Static Data Members
static const char* const typeName;
@ -134,7 +127,7 @@ public:
inline quaternion(const vector& d, const scalar theta);
//- Construct a rotation quaternion given the direction d
// and cosine angle cosTheta and a if d is normalized
//- and cosine angle cosTheta and a if d is normalized
inline quaternion
(
const vector& d,
@ -146,28 +139,24 @@ public:
inline explicit quaternion(const scalar w);
//- Construct a pure imaginary quaternion given the vector part,
// the scalar part = 0
//- the scalar part = 0
inline explicit quaternion(const vector& v);
//- Return the unit quaternion (versor) from the given vector
// (w = sqrt(1 - |sqr(v)|))
//- (w = sqrt(1 - |sqr(v)|))
static inline quaternion unit(const vector& v);
//- Construct a quaternion given the three Euler angles
inline quaternion
(
const rotationSequence rs,
const vector& angles
);
//- Construct from three Euler angles
inline quaternion(const rotationSequence rs, const vector& angles);
//- Construct a quaternion from a rotation tensor
//- Construct from a rotation tensor
inline explicit quaternion(const tensor& rotationTensor);
//- Construct from Istream
quaternion(Istream&);
explicit quaternion(Istream& is);
// Member functions
// Member Functions
// Access
@ -181,9 +170,10 @@ public:
inline tensor R() const;
//- Return a vector of euler angles corresponding to the
// specified rotation sequence
//- specified rotation sequence
inline vector eulerAngles(const rotationSequence rs) const;
//- Return the quaternion normalized by its magnitude
inline quaternion normalized() const;
@ -195,6 +185,7 @@ public:
//- Vector part of the quaternion ( = axis of rotation)
inline vector& v();
//- Normalize the quaternion by its magnitude
inline void normalize();
@ -213,26 +204,22 @@ public:
inline quaternion invTransform(const quaternion& q) const;
// Member operators
// Member Operators
inline void operator=(const quaternion&);
inline void operator+=(const quaternion&);
inline void operator-=(const quaternion&);
inline void operator*=(const quaternion&);
inline void operator/=(const quaternion&);
inline void operator=(const quaternion& q);
inline void operator+=(const quaternion& q);
inline void operator-=(const quaternion& q);
inline void operator*=(const quaternion& q);
inline void operator/=(const quaternion& q);
inline void operator=(const scalar);
//- Change scalar portion
inline void operator=(const scalar s);
inline void operator=(const vector&);
//- Change vector portion
inline void operator=(const vector& v);
inline void operator*=(const scalar);
inline void operator/=(const scalar);
// IOstream operators
friend Istream& operator>>(Istream& is, quaternion&);
friend Ostream& operator<<(Ostream& os, const quaternion& C);
inline void operator*=(const scalar s);
inline void operator/=(const scalar s);
};
@ -284,6 +271,9 @@ inline bool contiguous<quaternion>() {return true;}
// * * * * * * * * * * * * * * * Global Operators * * * * * * * * * * * * * //
Istream& operator>>(Istream& is, quaternion& q);
Ostream& operator<<(Ostream& os, const quaternion& q);
inline bool operator==(const quaternion& q1, const quaternion& q2);
inline bool operator!=(const quaternion& q1, const quaternion& q2);
inline quaternion operator+(const quaternion& q1, const quaternion& q2);

2
src/OpenFOAM/primitives/quaternion/quaternionI.H
View File

@ -2,7 +2,7 @@
========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration |
\\ / A nd |
\\ / A nd | Copyright (C) 2019 OpenCFD Ltd.
\\/ M anipulation |
-------------------------------------------------------------------------------
| Copyright (C) 2011-2016 OpenFOAM Foundation