1 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3 Module: FGColumnVector3.cpp
4 Author: Originally by Tony Peden [formatted here by JSB]
6 Purpose: FGColumnVector3 class
9 ------------- Copyright (C) 1998 Tony Peden and Jon S. Berndt (jon@jsbsim.org) -
11 This program is free software; you can redistribute it and/or modify it under
12 the terms of the GNU Lesser General Public License as published by the Free Software
13 Foundation; either version 2 of the License, or (at your option) any later
16 This program is distributed in the hope that it will be useful, but WITHOUT
17 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
18 FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
21 You should have received a copy of the GNU Lesser General Public License along with
22 this program; if not, write to the Free Software Foundation, Inc., 59 Temple
23 Place - Suite 330, Boston, MA 02111-1307, USA.
25 Further information about the GNU Lesser General Public License can also be found on
26 the world wide web at http://www.gnu.org.
28 FUNCTIONAL DESCRIPTION
29 --------------------------------------------------------------------------------
32 --------------------------------------------------------------------------------
34 03/16/2000 JSB Added exception throwing
36 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
38 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
40 #include "FGColumnVector3.h"
50 static const char *IdSrc = "$Id$";
51 static const char *IdHdr = ID_COLUMNVECTOR3;
53 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
55 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
57 FGColumnVector3::FGColumnVector3(void)
59 data[0] = data[1] = data[2] = 0.0;
63 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
65 string FGColumnVector3::Dump(const string& delimiter) const
68 buffer << std::setw(18) << std::setprecision(16) << Entry(1) << delimiter;
69 buffer << std::setw(18) << std::setprecision(16) << Entry(2) << delimiter;
70 buffer << std::setw(18) << std::setprecision(16) << Entry(3);
74 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
76 ostream& operator<<(ostream& os, const FGColumnVector3& col)
78 os << col(1) << " , " << col(2) << " , " << col(3);
82 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
84 FGColumnVector3 FGColumnVector3::operator/(const double scalar) const
87 return operator*( 1.0/scalar );
89 cerr << "Attempt to divide by zero in method \
90 FGColumnVector3::operator/(const double scalar), \
91 object " << data[0] << " , " << data[1] << " , " << data[2] << endl;
92 return FGColumnVector3();
95 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
97 FGColumnVector3& FGColumnVector3::operator/=(const double scalar)
100 operator*=( 1.0/scalar );
102 cerr << "Attempt to divide by zero in method \
103 FGColumnVector3::operator/=(const double scalar), \
104 object " << data[0] << " , " << data[1] << " , " << data[2] << endl;
109 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
111 double FGColumnVector3::Magnitude(void) const
113 if (Entry(1) == 0.0 && Entry(2) == 0.0 && Entry(3) == 0.0)
116 return sqrt( Entry(1)*Entry(1) + Entry(2)*Entry(2) + Entry(3)*Entry(3) );
119 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
121 FGColumnVector3& FGColumnVector3::Normalize(void)
123 double Mag = Magnitude();
126 operator*=( 1.0/Mag );
131 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
132 // The bitmasked value choices are as follows:
133 // unset: In this case (the default) JSBSim would only print
134 // out the normally expected messages, essentially echoing
135 // the config files as they are read. If the environment
136 // variable is not set, debug_lvl is set to 1 internally
137 // 0: This requests JSBSim not to output any messages
139 // 1: This value explicity requests the normal JSBSim
141 // 2: This value asks for a message to be printed out when
142 // a class is instantiated
143 // 4: When this value is set, a message is displayed when a
144 // FGModel object executes its Run() method
145 // 8: When this value is set, various runtime state variables
146 // are printed out periodically
147 // 16: When set various parameters are sanity checked and
148 // a message is printed out when they go out of bounds
150 void FGColumnVector3::Debug(int from)
152 if (debug_lvl <= 0) return;
154 if (debug_lvl & 1) { // Standard console startup message output
156 if (debug_lvl & 2 ) { // Instantiation/Destruction notification
157 if (from == 0) cout << "Instantiated: FGColumnVector3" << endl;
158 if (from == 1) cout << "Destroyed: FGColumnVector3" << endl;
160 if (debug_lvl & 4 ) { // Run() method entry print for FGModel-derived objects
162 if (debug_lvl & 8 ) { // Runtime state variables
164 if (debug_lvl & 16) { // Sanity checking
166 if (debug_lvl & 64) {
167 if (from == 0) { // Constructor
168 cout << IdSrc << endl;
169 cout << IdHdr << endl;
174 } // namespace JSBSim