1 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
7 Purpose: Encapsulates the landing gear elements
10 ------------- Copyright (C) 1999 Jon S. Berndt (jsb@hal-pc.org) -------------
12 This program is free software; you can redistribute it and/or modify it under
13 the terms of the GNU Lesser General Public License as published by the Free Software
14 Foundation; either version 2 of the License, or (at your option) any later
17 This program is distributed in the hope that it will be useful, but WITHOUT
18 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
19 FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
22 You should have received a copy of the GNU Lesser General Public License along with
23 this program; if not, write to the Free Software Foundation, Inc., 59 Temple
24 Place - Suite 330, Boston, MA 02111-1307, USA.
26 Further information about the GNU Lesser General Public License can also be found on
27 the world wide web at http://www.gnu.org.
29 FUNCTIONAL DESCRIPTION
30 --------------------------------------------------------------------------------
33 --------------------------------------------------------------------------------
35 01/30/01 NHP Extended gear model to properly simulate steering and braking
37 /%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
39 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
45 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
47 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
49 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
51 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
53 static const char *IdSrc = "$Id$";
54 static const char *IdHdr = ID_LGEAR;
56 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
58 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
60 FGLGear::FGLGear(Element* el, FGFDMExec* fdmex, int number) :
64 Element *force_table=0;
66 Element *dampCoeffRebound=0;
69 kSpring = bDamp = bDampRebound = dynamicFCoeff = staticFCoeff = rollingFCoeff = maxSteerAngle = 0;
70 sSteerType = sBrakeGroup = sSteerType = "";
73 eDampTypeRebound = dtLinear;
75 name = el->GetAttributeValue("name");
76 sContactType = el->GetAttributeValue("type");
77 if (sContactType == "BOGEY") {
78 eContactType = ctBOGEY;
79 } else if (sContactType == "STRUCTURE") {
80 eContactType = ctSTRUCTURE;
82 eContactType = ctUNKNOWN;
85 if (el->FindElement("spring_coeff"))
86 kSpring = el->FindElementValueAsNumberConvertTo("spring_coeff", "LBS/FT");
87 if (el->FindElement("damping_coeff")) {
88 dampCoeff = el->FindElement("damping_coeff");
89 if (dampCoeff->GetAttributeValue("type") == "SQUARE") {
91 bDamp = el->FindElementValueAsNumberConvertTo("damping_coeff", "LBS/FT2/SEC2");
93 bDamp = el->FindElementValueAsNumberConvertTo("damping_coeff", "LBS/FT/SEC");
97 if (el->FindElement("damping_coeff_rebound")) {
98 dampCoeffRebound = el->FindElement("damping_coeff_rebound");
99 if (dampCoeffRebound->GetAttributeValue("type") == "SQUARE") {
100 eDampTypeRebound = dtSquare;
101 bDampRebound = el->FindElementValueAsNumberConvertTo("damping_coeff_rebound", "LBS/FT2/SEC2");
103 bDampRebound = el->FindElementValueAsNumberConvertTo("damping_coeff_rebound", "LBS/FT/SEC");
106 bDampRebound = bDamp;
107 eDampTypeRebound = eDampType;
110 if (el->FindElement("dynamic_friction"))
111 dynamicFCoeff = el->FindElementValueAsNumber("dynamic_friction");
112 if (el->FindElement("static_friction"))
113 staticFCoeff = el->FindElementValueAsNumber("static_friction");
114 if (el->FindElement("rolling_friction"))
115 rollingFCoeff = el->FindElementValueAsNumber("rolling_friction");
116 if (el->FindElement("max_steer"))
117 maxSteerAngle = el->FindElementValueAsNumberConvertTo("max_steer", "DEG");
118 if (el->FindElement("retractable"))
119 isRetractable = ((unsigned int)el->FindElementValueAsNumber("retractable"))>0.0?true:false;
122 force_table = el->FindElement("table");
123 while (force_table) {
124 force_type = force_table->GetAttributeValue("type");
125 if (force_type == "CORNERING_COEFF") {
126 ForceY_Table = new FGTable(Exec->GetPropertyManager(), force_table);
128 cerr << "Undefined force table for " << name << " contact point" << endl;
130 force_table = el->FindNextElement("table");
133 sBrakeGroup = el->FindElementValue("brake_group");
135 if (maxSteerAngle == 360) sSteerType = "CASTERED";
136 else if (maxSteerAngle == 0.0) sSteerType = "FIXED";
137 else sSteerType = "STEERABLE";
139 Element* element = el->FindElement("location");
140 if (element) vXYZ = element->FindElementTripletConvertTo("IN");
141 else {cerr << "No location given for contact " << name << endl; exit(-1);}
143 if (sBrakeGroup == "LEFT" ) eBrakeGrp = bgLeft;
144 else if (sBrakeGroup == "RIGHT" ) eBrakeGrp = bgRight;
145 else if (sBrakeGroup == "CENTER") eBrakeGrp = bgCenter;
146 else if (sBrakeGroup == "NOSE" ) eBrakeGrp = bgNose;
147 else if (sBrakeGroup == "TAIL" ) eBrakeGrp = bgTail;
148 else if (sBrakeGroup == "NONE" ) eBrakeGrp = bgNone;
149 else if (sBrakeGroup.empty() ) {eBrakeGrp = bgNone;
150 sBrakeGroup = "NONE (defaulted)";}
152 cerr << "Improper braking group specification in config file: "
153 << sBrakeGroup << " is undefined." << endl;
156 if (sSteerType == "STEERABLE") eSteerType = stSteer;
157 else if (sSteerType == "FIXED" ) eSteerType = stFixed;
158 else if (sSteerType == "CASTERED" ) eSteerType = stCaster;
159 else if (sSteerType.empty() ) {eSteerType = stFixed;
160 sSteerType = "FIXED (defaulted)";}
162 cerr << "Improper steering type specification in config file: "
163 << sSteerType << " is undefined." << endl;
166 RFRV = 0.7; // Rolling force relaxation velocity, default value
167 SFRV = 0.7; // Side force relaxation velocity, default value
169 Element* relax_vel = el->FindElement("relaxation_velocity");
171 if (relax_vel->FindElement("rolling")) {
172 RFRV = relax_vel->FindElementValueAsNumberConvertTo("rolling", "FT/SEC");
174 if (relax_vel->FindElement("side")) {
175 SFRV = relax_vel->FindElementValueAsNumberConvertTo("side", "FT/SEC");
179 State = Exec->GetState();
180 LongForceLagFilterCoeff = 1/State->Getdt(); // default longitudinal force filter coefficient
181 LatForceLagFilterCoeff = 1/State->Getdt(); // default lateral force filter coefficient
183 Element* force_lag_filter_elem = el->FindElement("force_lag_filter");
184 if (force_lag_filter_elem) {
185 if (force_lag_filter_elem->FindElement("rolling")) {
186 LongForceLagFilterCoeff = force_lag_filter_elem->FindElementValueAsNumber("rolling");
188 if (force_lag_filter_elem->FindElement("side")) {
189 LatForceLagFilterCoeff = force_lag_filter_elem->FindElementValueAsNumber("side");
193 LongForceFilter = Filter(LongForceLagFilterCoeff, State->Getdt());
194 LatForceFilter = Filter(LatForceLagFilterCoeff, State->Getdt());
196 WheelSlipLagFilterCoeff = 1/State->Getdt();
198 Element *wheel_slip_angle_lag_elem = el->FindElement("wheel_slip_filter");
199 if (wheel_slip_angle_lag_elem) {
200 WheelSlipLagFilterCoeff = wheel_slip_angle_lag_elem->GetDataAsNumber();
203 WheelSlipFilter = Filter(WheelSlipLagFilterCoeff, State->Getdt());
208 useFCSGearPos = false;
211 // Add some AI here to determine if gear is located properly according to its
212 // brake group type ??
214 State = Exec->GetState();
215 Aircraft = Exec->GetAircraft();
216 Propagate = Exec->GetPropagate();
217 Auxiliary = Exec->GetAuxiliary();
218 FCS = Exec->GetFCS();
219 MassBalance = Exec->GetMassBalance();
221 WOW = lastWOW = false;
223 FirstContact = false;
224 StartedGroundRun = false;
225 TakeoffReported = LandingReported = false;
226 LandingDistanceTraveled = TakeoffDistanceTraveled = TakeoffDistanceTraveled50ft = 0.0;
227 MaximumStrutForce = MaximumStrutTravel = 0.0;
228 SideForce = RollingForce = 0.0;
229 SinkRate = GroundSpeed = 0.0;
231 vWhlBodyVec = MassBalance->StructuralToBody(vXYZ);
233 vLocalGear = Propagate->GetTb2l() * vWhlBodyVec;
235 compressLength = 0.0;
241 TirePressureNorm = 1.0;
259 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
267 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
269 FGColumnVector3& FGLGear::Force(void)
271 double t = Exec->GetState()->Getsim_time();
272 dT = State->Getdt()*Exec->GetGroundReactions()->GetRate();
275 vMoment.InitMatrix();
277 if (isRetractable) ComputeRetractionState();
281 vWhlBodyVec = MassBalance->StructuralToBody(vXYZ); // Get wheel in body frame
282 vLocalGear = Propagate->GetTb2l() * vWhlBodyVec; // Get local frame wheel location
284 gearLoc = Propagate->GetLocation().LocalToLocation(vLocalGear);
285 compressLength = -Exec->GetGroundCallback()->GetAGLevel(t, gearLoc, contact, normal, cvel);
287 // The compression length is measured in the Z-axis, only, at this time.
289 if (compressLength > 0.00) {
293 // [The next equation should really use the vector to the contact patch of
294 // the tire including the strut compression and not the original vWhlBodyVec.]
296 vWhlVelVec = Propagate->GetTb2l() * (Propagate->GetPQR() * vWhlBodyVec);
297 vWhlVelVec += Propagate->GetVel() - cvel;
298 compressSpeed = vWhlVelVec(eZ);
300 InitializeReporting();
301 ComputeBrakeForceCoefficient();
302 ComputeSteeringAngle();
304 ComputeSideForceCoefficient();
305 ComputeVerticalStrutForce();
307 // Compute the forces in the wheel ground plane.
309 double sign = RollingWhlVel>0?1.0:(RollingWhlVel<0?-1.0:0.0);
310 RollingForce = ((1.0 - TirePressureNorm) * 30 + vLocalForce(eZ) * BrakeFCoeff) * sign;
311 SideForce = vLocalForce(eZ) * FCoeff;
313 // Transform these forces back to the local reference frame.
315 vLocalForce(eX) = RollingForce*CosWheel - SideForce*SinWheel;
316 vLocalForce(eY) = SideForce*CosWheel + RollingForce*SinWheel;
318 // Transform the forces back to the body frame and compute the moment.
320 vForce = Propagate->GetTl2b() * vLocalForce;
322 // Lag and attenuate the XY-plane forces dependent on velocity. This code
323 // uses a lag filter, C/(s + C) where "C" is the filter coefficient. When
324 // "C" is chosen at the frame rate (in Hz), the jittering is significantly
325 // reduced. This is because the jitter is present *at* the execution rate.
326 // If a coefficient is set to something equal to or less than zero, the
327 // filter is bypassed.
329 if (LongForceLagFilterCoeff > 0) vForce(eX) = LongForceFilter.execute(vForce(eX));
330 if (LatForceLagFilterCoeff > 0) vForce(eY) = LatForceFilter.execute(vForce(eY));
332 if ((fabs(RollingWhlVel) <= RFRV) && RFRV > 0) vForce(eX) *= fabs(RollingWhlVel)/RFRV;
333 if ((fabs(SideWhlVel) <= SFRV) && SFRV > 0) vForce(eY) *= fabs(SideWhlVel)/SFRV;
335 // End section for attentuating gear jitter
337 vMoment = vWhlBodyVec * vForce;
339 } else { // Gear is NOT compressed
342 compressLength = 0.0;
344 // No wheel conditons
345 RollingWhlVel = SideWhlVel = WheelSlip = 0.0;
347 // Return to neutral position between 1.0 and 0.8 gear pos.
348 SteerAngle *= max(GetGearUnitPos()-0.8, 0.0)/0.2;
354 ReportTakeoffOrLanding();
356 // Require both WOW and LastWOW to be true before checking crash conditions
357 // to allow the WOW flag to be used in terminating a scripted run.
358 if (WOW && lastWOW) CrashDetect();
365 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
367 void FGLGear::ComputeRetractionState(void)
369 double gearPos = GetGearUnitPos();
370 if (gearPos < 0.01) {
374 } else if (gearPos > 0.99) {
383 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
385 void FGLGear::ComputeSlipAngle(void)
387 // Transform the wheel velocities from the local axis system to the wheel axis system.
388 RollingWhlVel = vWhlVelVec(eX)*CosWheel + vWhlVelVec(eY)*SinWheel;
389 SideWhlVel = vWhlVelVec(eY)*CosWheel - vWhlVelVec(eX)*SinWheel;
391 // Calculate tire slip angle.
392 WheelSlip = atan2(SideWhlVel, fabs(RollingWhlVel))*radtodeg;
394 // Filter the wheel slip angle
395 if (WheelSlipLagFilterCoeff > 0) WheelSlip = WheelSlipFilter.execute(WheelSlip);
398 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
399 // Compute the steering angle in any case.
400 // This will also make sure that animations will look right.
402 void FGLGear::ComputeSteeringAngle(void)
404 double casterLocalFrameAngleRad = 0.0;
405 double casterAngle = 0.0;
407 switch (eSteerType) {
409 SteerAngle = degtorad * FCS->GetSteerPosDeg(GearNumber);
415 // This is not correct for castering gear. Should make steer angle parallel
416 // to the actual velocity vector of the wheel, given aircraft velocity vector
419 casterLocalFrameAngleRad = acos(vWhlVelVec(eX)/vWhlVelVec.Magnitude());
420 casterAngle = casterLocalFrameAngleRad - Propagate->GetEuler(ePsi);
423 cerr << "Improper steering type membership detected for this gear." << endl;
427 SinWheel = sin(Propagate->GetEuler(ePsi) + SteerAngle);
428 CosWheel = cos(Propagate->GetEuler(ePsi) + SteerAngle);
431 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
432 // Reset reporting functionality after takeoff
434 void FGLGear::ResetReporting(void)
436 if (Propagate->GetDistanceAGL() > 200.0) {
437 FirstContact = false;
438 StartedGroundRun = false;
439 LandingReported = false;
440 TakeoffReported = true;
441 LandingDistanceTraveled = 0.0;
442 MaximumStrutForce = MaximumStrutTravel = 0.0;
446 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
448 void FGLGear::InitializeReporting(void)
450 // If this is the first time the wheel has made contact, remember some values
451 // for later printout.
455 SinkRate = compressSpeed;
456 GroundSpeed = Propagate->GetVel().Magnitude();
457 TakeoffReported = false;
460 // If the takeoff run is starting, initialize.
462 if ((Propagate->GetVel().Magnitude() > 0.1) &&
463 (FCS->GetBrake(bgLeft) == 0) &&
464 (FCS->GetBrake(bgRight) == 0) &&
465 (FCS->GetThrottlePos(0) > 0.90) && !StartedGroundRun)
467 TakeoffDistanceTraveled = 0;
468 TakeoffDistanceTraveled50ft = 0;
469 StartedGroundRun = true;
473 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
474 // Takeoff and landing reporting functionality
476 void FGLGear::ReportTakeoffOrLanding(void)
478 double deltaT = State->Getdt()*Exec->GetGroundReactions()->GetRate();
481 LandingDistanceTraveled += Auxiliary->GetVground()*deltaT;
483 if (StartedGroundRun) {
484 TakeoffDistanceTraveled50ft += Auxiliary->GetVground()*deltaT;
485 if (WOW) TakeoffDistanceTraveled += Auxiliary->GetVground()*deltaT;
489 && Auxiliary->GetVground() <= 0.05
491 && Exec->GetGroundReactions()->GetWOW())
493 if (debug_lvl > 0) Report(erLand);
498 && (Propagate->GetDistanceAGL() - vLocalGear(eZ)) > 50.0
499 && !Exec->GetGroundReactions()->GetWOW())
501 if (debug_lvl > 0) Report(erTakeoff);
504 if (lastWOW != WOW) PutMessage("GEAR_CONTACT: " + name, WOW);
507 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
508 // Crash detection logic (really out-of-bounds detection)
510 void FGLGear::CrashDetect(void)
512 if ( (compressLength > 500.0 ||
513 vForce.Magnitude() > 100000000.0 ||
514 vMoment.Magnitude() > 5000000000.0 ||
515 SinkRate > 1.4666*30 ) && !State->IntegrationSuspended())
517 PutMessage("Crash Detected: Simulation FREEZE.");
518 State->SuspendIntegration();
522 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
523 // The following needs work regarding friction coefficients and braking and
524 // steering The BrakeFCoeff formula assumes that an anti-skid system is used.
525 // It also assumes that we won't be turning and braking at the same time.
526 // Will fix this later.
527 // [JSB] The braking force coefficients include normal rolling coefficient +
528 // a percentage of the static friction coefficient based on braking applied.
530 void FGLGear::ComputeBrakeForceCoefficient(void)
534 BrakeFCoeff = ( rollingFCoeff*(1.0 - FCS->GetBrake(bgLeft)) +
535 staticFCoeff*FCS->GetBrake(bgLeft) );
538 BrakeFCoeff = ( rollingFCoeff*(1.0 - FCS->GetBrake(bgRight)) +
539 staticFCoeff*FCS->GetBrake(bgRight) );
542 BrakeFCoeff = ( rollingFCoeff*(1.0 - FCS->GetBrake(bgCenter)) +
543 staticFCoeff*FCS->GetBrake(bgCenter) );
546 BrakeFCoeff = ( rollingFCoeff*(1.0 - FCS->GetBrake(bgCenter)) +
547 staticFCoeff*FCS->GetBrake(bgCenter) );
550 BrakeFCoeff = ( rollingFCoeff*(1.0 - FCS->GetBrake(bgCenter)) +
551 staticFCoeff*FCS->GetBrake(bgCenter) );
554 BrakeFCoeff = rollingFCoeff;
557 cerr << "Improper brake group membership detected for this gear." << endl;
562 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
563 // Compute the sideforce coefficients using Pacejka's Magic Formula.
565 // y(x) = D sin {C arctan [Bx - E(Bx - arctan Bx)]}
567 // Where: B = Stiffness Factor (0.06, here)
568 // C = Shape Factor (2.8, here)
569 // D = Peak Factor (0.8, here)
570 // E = Curvature Factor (1.03, here)
572 void FGLGear::ComputeSideForceCoefficient(void)
575 FCoeff = ForceY_Table->GetValue(WheelSlip);
577 double StiffSlip = Stiffness*WheelSlip;
578 FCoeff = Peak * sin(Shape*atan(StiffSlip - Curvature*(StiffSlip - atan(StiffSlip))));
582 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
583 // Compute the vertical force on the wheel using square-law damping (per comment
584 // in paper AIAA-2000-4303 - see header prologue comments). We might consider
585 // allowing for both square and linear damping force calculation. Also need to
586 // possibly give a "rebound damping factor" that differs from the compression
589 void FGLGear::ComputeVerticalStrutForce(void)
591 double springForce = 0;
592 double dampForce = 0;
594 springForce = -compressLength * kSpring;
596 if (compressSpeed >= 0.0) {
598 if (eDampType == dtLinear) dampForce = -compressSpeed * bDamp;
599 else dampForce = -compressSpeed * compressSpeed * bDamp;
603 if (eDampTypeRebound == dtLinear)
604 dampForce = -compressSpeed * bDampRebound;
606 dampForce = compressSpeed * compressSpeed * bDampRebound;
609 vLocalForce(eZ) = min(springForce + dampForce, (double)0.0);
611 // Remember these values for reporting
612 MaximumStrutForce = max(MaximumStrutForce, fabs(vLocalForce(eZ)));
613 MaximumStrutTravel = max(MaximumStrutTravel, fabs(compressLength));
616 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
618 double FGLGear::GetGearUnitPos(void)
620 // hack to provide backward compatibility to gear/gear-pos-norm property
621 if( useFCSGearPos || FCS->GetGearPos() != 1.0 ) {
622 useFCSGearPos = true;
623 return FCS->GetGearPos();
628 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
630 void FGLGear::bind(void)
632 string property_name;
633 string base_property_name;
634 base_property_name = CreateIndexedPropertyName("gear/unit", GearNumber);
635 if (eContactType == ctBOGEY) {
636 property_name = base_property_name + "/slip-angle-deg";
637 Exec->GetPropertyManager()->Tie( property_name.c_str(), &WheelSlip );
638 property_name = base_property_name + "/WOW";
639 Exec->GetPropertyManager()->Tie( property_name.c_str(), &WOW );
640 property_name = base_property_name + "/wheel-speed-fps";
641 Exec->GetPropertyManager()->Tie( property_name.c_str(), &RollingWhlVel );
642 property_name = base_property_name + "/z-position";
643 Exec->GetPropertyManager()->Tie( property_name.c_str(), (FGLGear*)this,
644 &FGLGear::GetZPosition, &FGLGear::SetZPosition);
645 property_name = base_property_name + "/compression-ft";
646 Exec->GetPropertyManager()->Tie( property_name.c_str(), &compressLength );
647 property_name = base_property_name + "/side_friction_coeff";
648 Exec->GetPropertyManager()->Tie( property_name.c_str(), &FCoeff );
651 if( isRetractable ) {
652 property_name = base_property_name + "/pos-norm";
653 Exec->GetPropertyManager()->Tie( property_name.c_str(), &GearPos );
658 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
660 void FGLGear::Report(ReportType repType)
662 if (fabs(TakeoffDistanceTraveled) < 0.001) return; // Don't print superfluous reports
666 cout << endl << "Touchdown report for " << name << " (WOW at time: "
667 << Exec->GetState()->Getsim_time() << " seconds)" << endl;
668 cout << " Sink rate at contact: " << SinkRate << " fps, "
669 << SinkRate*0.3048 << " mps" << endl;
670 cout << " Contact ground speed: " << GroundSpeed*.5925 << " knots, "
671 << GroundSpeed*0.3048 << " mps" << endl;
672 cout << " Maximum contact force: " << MaximumStrutForce << " lbs, "
673 << MaximumStrutForce*4.448 << " Newtons" << endl;
674 cout << " Maximum strut travel: " << MaximumStrutTravel*12.0 << " inches, "
675 << MaximumStrutTravel*30.48 << " cm" << endl;
676 cout << " Distance traveled: " << LandingDistanceTraveled << " ft, "
677 << LandingDistanceTraveled*0.3048 << " meters" << endl;
678 LandingReported = true;
681 cout << endl << "Takeoff report for " << name << " (Liftoff at time: "
682 << Exec->GetState()->Getsim_time() << " seconds)" << endl;
683 cout << " Distance traveled: " << TakeoffDistanceTraveled
684 << " ft, " << TakeoffDistanceTraveled*0.3048 << " meters" << endl;
685 cout << " Distance traveled (over 50'): " << TakeoffDistanceTraveled50ft
686 << " ft, " << TakeoffDistanceTraveled50ft*0.3048 << " meters" << endl;
687 cout << " [Altitude (ASL): " << Exec->GetPropagate()->GetAltitudeASL() << " ft. / "
688 << Exec->GetPropagate()->GetAltitudeASLmeters() << " m | Temperature: "
689 << Exec->GetAtmosphere()->GetTemperature() - 459.67 << " F / "
690 << RankineToCelsius(Exec->GetAtmosphere()->GetTemperature()) << " C]" << endl;
691 cout << " [Velocity (KCAS): " << Exec->GetAuxiliary()->GetVcalibratedKTS() << "]" << endl;
692 TakeoffReported = true;
697 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
698 // The bitmasked value choices are as follows:
699 // unset: In this case (the default) JSBSim would only print
700 // out the normally expected messages, essentially echoing
701 // the config files as they are read. If the environment
702 // variable is not set, debug_lvl is set to 1 internally
703 // 0: This requests JSBSim not to output any messages
705 // 1: This value explicity requests the normal JSBSim
707 // 2: This value asks for a message to be printed out when
708 // a class is instantiated
709 // 4: When this value is set, a message is displayed when a
710 // FGModel object executes its Run() method
711 // 8: When this value is set, various runtime state variables
712 // are printed out periodically
713 // 16: When set various parameters are sanity checked and
714 // a message is printed out when they go out of bounds
716 void FGLGear::Debug(int from)
718 if (debug_lvl <= 0) return;
720 if (debug_lvl & 1) { // Standard console startup message output
721 if (from == 0) { // Constructor - loading and initialization
722 cout << " " << sContactType << " " << name << endl;
723 cout << " Location: " << vXYZ << endl;
724 cout << " Spring Constant: " << kSpring << endl;
726 if (eDampType == dtLinear)
727 cout << " Damping Constant: " << bDamp << " (linear)" << endl;
729 cout << " Damping Constant: " << bDamp << " (square law)" << endl;
731 if (eDampTypeRebound == dtLinear)
732 cout << " Rebound Damping Constant: " << bDampRebound << " (linear)" << endl;
734 cout << " Rebound Damping Constant: " << bDampRebound << " (square law)" << endl;
736 cout << " Dynamic Friction: " << dynamicFCoeff << endl;
737 cout << " Static Friction: " << staticFCoeff << endl;
738 if (eContactType == ctBOGEY) {
739 cout << " Rolling Friction: " << rollingFCoeff << endl;
740 cout << " Steering Type: " << sSteerType << endl;
741 cout << " Grouping: " << sBrakeGroup << endl;
742 cout << " Max Steer Angle: " << maxSteerAngle << endl;
743 cout << " Retractable: " << isRetractable << endl;
744 cout << " Relaxation Velocities:" << endl;
745 cout << " Rolling: " << RFRV << endl;
746 cout << " Side: " << SFRV << endl;
750 if (debug_lvl & 2 ) { // Instantiation/Destruction notification
751 if (from == 0) cout << "Instantiated: FGLGear" << endl;
752 if (from == 1) cout << "Destroyed: FGLGear" << endl;
754 if (debug_lvl & 4 ) { // Run() method entry print for FGModel-derived objects
756 if (debug_lvl & 8 ) { // Runtime state variables
758 if (debug_lvl & 16) { // Sanity checking
760 if (debug_lvl & 64) {
761 if (from == 0) { // Constructor
762 cout << IdSrc << endl;
763 cout << IdHdr << endl;
768 } // namespace JSBSim