-/*******************************************************************************
+/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Module: FGState.cpp
Author: Jon Berndt
--------------------------------------------------------------------------------
11/17/98 JSB Created
-********************************************************************************
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
INCLUDES
-*******************************************************************************/
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
#ifdef FGFS
# include <simgear/compiler.h>
-# ifdef FG_HAVE_STD_INCLUDES
-# include <cmath>
-# else
+# include <math.h>
+#else
+# if defined(sgi) && !defined(__GNUC__)
# include <math.h>
+# else
+# include <cmath>
# endif
-#else
-# include <cmath>
+#endif
+
+#ifdef _MSC_VER
+#define snprintf _snprintf
#endif
#include "FGState.h"
-#include "FGFDMExec.h"
-#include "FGAtmosphere.h"
-#include "FGFCS.h"
-#include "FGAircraft.h"
-#include "FGTranslation.h"
-#include "FGRotation.h"
-#include "FGPosition.h"
-#include "FGAuxiliary.h"
-#include "FGOutput.h"
-
-/*******************************************************************************
-************************************ CODE **************************************
-*******************************************************************************/
-
-
-FGState::FGState(FGFDMExec* fdex) : mTb2l(3,3),
- mTl2b(3,3),
- mTs2b(3,3),
-vQtrn(4) {
+
+static const char *IdSrc = "$Id$";
+static const char *IdHdr = ID_STATE;
+
+/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+MACROS
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
+
+#define RegisterVariable(ID,DEF) coeffdef[#ID] = ID; paramdef[ID] = DEF
+
+/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+CLASS IMPLEMENTATION
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
+
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+//
+// For every term registered here there must be a corresponding handler in
+// GetParameter() below that retrieves that parameter. Also, there must be an
+// entry in the enum eParam definition in FGJSBBase.h. The ID is what must be used
+// in any config file entry which references that item.
+
+FGState::FGState(FGFDMExec* fdex)
+{
FDMExec = fdex;
- adot = bdot = 0.0;
a = 1000.0;
sim_time = 0.0;
dt = 1.0/120.0;
+ ActiveEngine = -1;
+
+ Aircraft = FDMExec->GetAircraft();
+ Translation = FDMExec->GetTranslation();
+ Rotation = FDMExec->GetRotation();
+ Position = FDMExec->GetPosition();
+ FCS = FDMExec->GetFCS();
+ Output = FDMExec->GetOutput();
+ Atmosphere = FDMExec->GetAtmosphere();
+ Aerodynamics = FDMExec->GetAerodynamics();
+ GroundReactions = FDMExec->GetGroundReactions();
+ Propulsion = FDMExec->GetPropulsion();
+
+ RegisterVariable(FG_TIME, " time " );
+ RegisterVariable(FG_QBAR, " qbar " );
+ RegisterVariable(FG_WINGAREA, " wing_area " );
+ RegisterVariable(FG_WINGSPAN, " wingspan " );
+ RegisterVariable(FG_CBAR, " cbar " );
+ RegisterVariable(FG_ALPHA, " alpha " );
+ RegisterVariable(FG_ALPHADOT, " alphadot " );
+ RegisterVariable(FG_BETA, " beta " );
+ RegisterVariable(FG_ABETA, " |beta| " );
+ RegisterVariable(FG_BETADOT, " betadot " );
+ RegisterVariable(FG_PHI, " roll_angle " );
+ RegisterVariable(FG_THT, " pitch_angle " );
+ RegisterVariable(FG_PSI, " heading_angle " );
+ RegisterVariable(FG_PITCHRATE, " pitch_rate " );
+ RegisterVariable(FG_ROLLRATE, " roll_rate " );
+ RegisterVariable(FG_YAWRATE, " yaw_rate " );
+ RegisterVariable(FG_AEROQ, " aero_pitch_rate ");
+ RegisterVariable(FG_AEROP, " aero_roll_rate " );
+ RegisterVariable(FG_AEROR, " aero_yaw_rate " );
+ RegisterVariable(FG_CL_SQRD, " Clift_sqrd " );
+ RegisterVariable(FG_MACH, " mach " );
+ RegisterVariable(FG_ALTITUDE, " altitude " );
+ RegisterVariable(FG_BI2VEL, " BI2Vel " );
+ RegisterVariable(FG_CI2VEL, " CI2Vel " );
+ RegisterVariable(FG_ELEVATOR_POS, " elevator_pos " );
+ RegisterVariable(FG_AILERON_POS, " aileron_pos " );
+ RegisterVariable(FG_RUDDER_POS, " rudder_pos " );
+ RegisterVariable(FG_SPDBRAKE_POS, " speedbrake_pos " );
+ RegisterVariable(FG_SPOILERS_POS, " spoiler_pos " );
+ RegisterVariable(FG_FLAPS_POS, " flaps_pos " );
+ RegisterVariable(FG_GEAR_POS, " gear_pos " );
+ RegisterVariable(FG_ELEVATOR_CMD, " elevator_cmd " );
+ RegisterVariable(FG_AILERON_CMD, " aileron_cmd " );
+ RegisterVariable(FG_RUDDER_CMD, " rudder_cmd " );
+ RegisterVariable(FG_SPDBRAKE_CMD, " speedbrake_cmd " );
+ RegisterVariable(FG_SPOILERS_CMD, " spoiler_cmd " );
+ RegisterVariable(FG_FLAPS_CMD, " flaps_cmd " );
+ RegisterVariable(FG_THROTTLE_CMD, " throttle_cmd " );
+ RegisterVariable(FG_GEAR_CMD, " gear_cmd " );
+ RegisterVariable(FG_THROTTLE_POS, " throttle_pos " );
+ RegisterVariable(FG_MIXTURE_CMD, " mixture_cmd " );
+ RegisterVariable(FG_MIXTURE_POS, " mixture_pos " );
+ RegisterVariable(FG_MAGNETO_CMD, " magneto_cmd " );
+ RegisterVariable(FG_STARTER_CMD, " starter_cmd " );
+ RegisterVariable(FG_ACTIVE_ENGINE, " active_engine " );
+ RegisterVariable(FG_HOVERB, " height/span " );
+ RegisterVariable(FG_PITCH_TRIM_CMD, " pitch_trim_cmd " );
+ RegisterVariable(FG_LEFT_BRAKE_CMD, " left_brake_cmd " );
+ RegisterVariable(FG_RIGHT_BRAKE_CMD," right_brake_cmd ");
+ RegisterVariable(FG_CENTER_BRAKE_CMD," center_brake_cmd ");
+ RegisterVariable(FG_ALPHAH, " h-tail alpha " );
+ RegisterVariable(FG_ALPHAW, " wing alpha " );
+ RegisterVariable(FG_LBARH, " h-tail arm " );
+ RegisterVariable(FG_LBARV, " v-tail arm " );
+ RegisterVariable(FG_HTAILAREA, " h-tail area " );
+ RegisterVariable(FG_VTAILAREA, " v-tail area " );
+ RegisterVariable(FG_VBARH, " h-tail volume " );
+ RegisterVariable(FG_VBARV, " v-tail volume " );
+ RegisterVariable(FG_SET_LOGGING, " data_logging " );
+
+ Debug(0);
+}
+
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
- coeffdef["FG_QBAR"] = 1 ;
- coeffdef["FG_WINGAREA"] = 2 ;
- coeffdef["FG_WINGSPAN"] = 4 ;
- coeffdef["FG_CBAR"] = 8 ;
- coeffdef["FG_ALPHA"] = 16 ;
- coeffdef["FG_ALPHADOT"] = 32 ;
- coeffdef["FG_BETA"] = 64 ;
- coeffdef["FG_BETADOT"] = 128 ;
- coeffdef["FG_PITCHRATE"] = 256 ;
- coeffdef["FG_ROLLRATE"] = 512 ;
- coeffdef["FG_YAWRATE"] = 1024 ;
- coeffdef["FG_MACH"] = 2048 ;
- coeffdef["FG_ALTITUDE"] = 4096 ;
- coeffdef["FG_BI2VEL"] = 8192 ;
- coeffdef["FG_CI2VEL"] = 16384 ;
- coeffdef["FG_ELEVATOR_POS"] = 32768L ;
- coeffdef["FG_AILERON_POS"] = 65536L ;
- coeffdef["FG_RUDDER_POS"] = 131072L ;
- coeffdef["FG_SPDBRAKE_POS"] = 262144L ;
- coeffdef["FG_SPOILERS_POS"] = 524288L ;
- coeffdef["FG_FLAPS_POS"] = 1048576L ;
- coeffdef["FG_ELEVATOR_CMD"] = 2097152L ;
- coeffdef["FG_AILERON_CMD"] = 4194304L ;
- coeffdef["FG_RUDDER_CMD"] = 8388608L ;
- coeffdef["FG_SPDBRAKE_CMD"] = 16777216L ;
- coeffdef["FG_SPOILERS_CMD"] = 33554432L ;
- coeffdef["FG_FLAPS_CMD"] = 67108864L ;
- coeffdef["FG_THROTTLE_CMD"] = 134217728L ;
- coeffdef["FG_THROTTLE_POS"] = 268435456L ;
- coeffdef["FG_HOVERB"] = 536870912L ;
- coeffdef["FG_PITCH_TRIM_CMD"] = 1073741824L ;
+FGState::~FGState()
+{
+ Debug(1);
}
-/******************************************************************************/
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-FGState::~FGState(void) {}
+double FGState::GetParameter(eParam val_idx) {
+ double scratch;
+
+ switch(val_idx) {
+ case FG_TIME:
+ return sim_time;
+ case FG_QBAR:
+ return Translation->Getqbar();
+ case FG_WINGAREA:
+ return Aircraft->GetWingArea();
+ case FG_WINGSPAN:
+ return Aircraft->GetWingSpan();
+ case FG_CBAR:
+ return Aircraft->Getcbar();
+ case FG_LBARH:
+ return Aircraft->Getlbarh();
+ case FG_LBARV:
+ return Aircraft->Getvbarh();
+ case FG_HTAILAREA:
+ return Aircraft->GetHTailArea();
+ case FG_VTAILAREA:
+ return Aircraft->GetVTailArea();
+ case FG_VBARH:
+ return Aircraft->Getvbarh();
+ case FG_VBARV:
+ return Aircraft->Getvbarv();
+ case FG_ALPHA:
+ return Translation->Getalpha();
+ case FG_ALPHAW:
+ return Translation->Getalpha() + Aircraft->GetWingIncidence();
+ case FG_ALPHADOT:
+ return Translation->Getadot();
+ case FG_BETA:
+ return Translation->Getbeta();
+ case FG_ABETA:
+ return fabs(Translation->Getbeta());
+ case FG_BETADOT:
+ return Translation->Getbdot();
+ case FG_PHI:
+ return Rotation->Getphi();
+ case FG_THT:
+ return Rotation->Gettht();
+ case FG_PSI:
+ return Rotation->Getpsi();
+ case FG_PITCHRATE:
+ return Rotation->GetPQR(eQ);
+ case FG_ROLLRATE:
+ return Rotation->GetPQR(eP);
+ case FG_YAWRATE:
+ return Rotation->GetPQR(eR);
+ case FG_AEROP:
+ return Rotation->GetAeroPQR(eP);
+ case FG_AEROQ:
+ return Rotation->GetAeroPQR(eQ);
+ case FG_AEROR:
+ return Rotation->GetAeroPQR(eR);
+ case FG_CL_SQRD:
+ if (Translation->Getqbar() > 0.00)
+ scratch = Aerodynamics->GetvLastFs(eLift)/(Aircraft->GetWingArea()*Translation->Getqbar());
+ else
+ scratch = 0.0;
+ return scratch*scratch;
+ case FG_ELEVATOR_POS:
+ return FCS->GetDePos();
+ case FG_AILERON_POS:
+ return FCS->GetDaPos();
+ case FG_RUDDER_POS:
+ return FCS->GetDrPos();
+ case FG_SPDBRAKE_POS:
+ return FCS->GetDsbPos();
+ case FG_SPOILERS_POS:
+ return FCS->GetDspPos();
+ case FG_FLAPS_POS:
+ return FCS->GetDfPos();
+ case FG_ELEVATOR_CMD:
+ return FCS->GetDeCmd();
+ case FG_AILERON_CMD:
+ return FCS->GetDaCmd();
+ case FG_RUDDER_CMD:
+ return FCS->GetDrCmd();
+ case FG_SPDBRAKE_CMD:
+ return FCS->GetDsbCmd();
+ case FG_SPOILERS_CMD:
+ return FCS->GetDspCmd();
+ case FG_FLAPS_CMD:
+ return FCS->GetDfCmd();
+ case FG_MACH:
+ return Translation->GetMach();
+ case FG_ALTITUDE:
+ return Position->Geth();
+ case FG_BI2VEL:
+ if(Translation->GetVt() > 0)
+ return Aircraft->GetWingSpan()/(2.0 * Translation->GetVt());
+ else
+ return 0;
+ case FG_CI2VEL:
+ if(Translation->GetVt() > 0)
+ return Aircraft->Getcbar()/(2.0 * Translation->GetVt());
+ else
+ return 0;
+ case FG_THROTTLE_CMD:
+ if (ActiveEngine < 0) return FCS->GetThrottleCmd(0);
+ else return FCS->GetThrottleCmd(ActiveEngine);
+ case FG_THROTTLE_POS:
+ if (ActiveEngine < 0) return FCS->GetThrottlePos(0);
+ else return FCS->GetThrottlePos(ActiveEngine);
+ case FG_MAGNETO_CMD:
+ if (ActiveEngine < 0) return Propulsion->GetEngine(0)->GetMagnetos();
+ else return Propulsion->GetEngine(ActiveEngine)->GetMagnetos();
+ case FG_STARTER_CMD:
+ if (ActiveEngine < 0) {
+ if (Propulsion->GetEngine(0)->GetStarter()) return 1.0;
+ else return 0.0;
+ } else {
+ if (Propulsion->GetEngine(ActiveEngine)->GetStarter()) return 1.0;
+ else return 0.0;
+ }
+ case FG_MIXTURE_CMD:
+ if (ActiveEngine < 0) return FCS->GetMixtureCmd(0);
+ else return FCS->GetMixtureCmd(ActiveEngine);
+ case FG_MIXTURE_POS:
+ if (ActiveEngine < 0) return FCS->GetMixturePos(0);
+ else return FCS->GetMixturePos(ActiveEngine);
+ case FG_HOVERB:
+ return Position->GetHOverBMAC();
+ case FG_PITCH_TRIM_CMD:
+ return FCS->GetPitchTrimCmd();
+ case FG_GEAR_CMD:
+ return FCS->GetGearCmd();
+ case FG_GEAR_POS:
+ return FCS->GetGearPos();
+ default:
+ cerr << "FGState::GetParameter() - No handler for parameter " << paramdef[val_idx] << endl;
+ return 0.0;
+ }
+ return 0;
+}
-//***************************************************************************
-//
-// Reset: Assume all angles READ FROM FILE IN DEGREES !!
-//
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+double FGState::GetParameter(string val_string) {
+ return GetParameter(coeffdef[val_string]);
+}
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-bool FGState::Reset(string path, string acname, string fname) {
- string resetDef;
- float U, V, W;
- float phi, tht, psi;
- float latitude, longitude, h;
+eParam FGState::GetParameterIndex(string val_string)
+{
+ return coeffdef[val_string];
+}
- resetDef = path + "/" + acname + "/" + fname;
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
- ifstream resetfile(resetDef.c_str());
+void FGState::SetParameter(eParam val_idx, double val)
+{
+ int i;
- if (resetfile) {
- resetfile >> U;
- resetfile >> V;
- resetfile >> W;
- resetfile >> latitude;
- resetfile >> longitude;
- resetfile >> phi;
- resetfile >> tht;
- resetfile >> psi;
- resetfile >> h;
- resetfile.close();
+ switch(val_idx) {
+ case FG_ELEVATOR_POS:
+ FCS->SetDePos(val);
+ break;
+ case FG_AILERON_POS:
+ FCS->SetDaPos(val);
+ break;
+ case FG_RUDDER_POS:
+ FCS->SetDrPos(val);
+ break;
+ case FG_SPDBRAKE_POS:
+ FCS->SetDsbPos(val);
+ break;
+ case FG_SPOILERS_POS:
+ FCS->SetDspPos(val);
+ break;
+ case FG_FLAPS_POS:
+ FCS->SetDfPos(val);
+ break;
+ case FG_THROTTLE_POS:
+ if (ActiveEngine == -1) {
+ for (i=0; i<Propulsion->GetNumEngines(); i++) {
+ FCS->SetThrottlePos(i,val);
+ }
+ } else {
+ FCS->SetThrottlePos(ActiveEngine,val);
+ }
+ break;
+ case FG_MIXTURE_POS:
+ if (ActiveEngine == -1) {
+ for (i=0; i<Propulsion->GetNumEngines(); i++) {
+ FCS->SetMixturePos(i,val);
+ }
+ } else {
+ FCS->SetMixturePos(ActiveEngine,val);
+ }
+ break;
- FDMExec->GetPosition()->SetLatitude(latitude*DEGTORAD);
- FDMExec->GetPosition()->SetLongitude(longitude*DEGTORAD);
- FDMExec->GetPosition()->Seth(h);
+ case FG_ELEVATOR_CMD:
+ FCS->SetDeCmd(val);
+ break;
+ case FG_AILERON_CMD:
+ FCS->SetDaCmd(val);
+ break;
+ case FG_RUDDER_CMD:
+ FCS->SetDrCmd(val);
+ break;
+ case FG_SPDBRAKE_CMD:
+ FCS->SetDsbCmd(val);
+ break;
+ case FG_SPOILERS_CMD:
+ FCS->SetDspCmd(val);
+ break;
+ case FG_FLAPS_CMD:
+ FCS->SetDfCmd(val);
+ break;
+ case FG_THROTTLE_CMD:
+ if (ActiveEngine == -1) {
+ for (i=0; i<Propulsion->GetNumEngines(); i++) {
+ FCS->SetThrottleCmd(i,val);
+ }
+ } else {
+ FCS->SetThrottleCmd(ActiveEngine,val);
+ }
+ break;
+ case FG_MIXTURE_CMD:
+ if (ActiveEngine == -1) {
+ for (i=0; i<Propulsion->GetNumEngines(); i++) {
+ FCS->SetMixtureCmd(i,val);
+ }
+ } else {
+ FCS->SetMixtureCmd(ActiveEngine,val);
+ }
+ break;
+ case FG_MAGNETO_CMD:
+ if (ActiveEngine == -1) {
+ for (i=0; i<Propulsion->GetNumEngines(); i++) {
+ Propulsion->GetEngine(i)->SetMagnetos((int)val);
+ }
+ } else {
+ Propulsion->GetEngine(ActiveEngine)->SetMagnetos((int)val);
+ }
+ break;
+ case FG_STARTER_CMD:
+ if (ActiveEngine == -1) {
+ for (i=0; i<Propulsion->GetNumEngines(); i++) {
+ if (val < 0.001)
+ Propulsion->GetEngine(i)->SetStarter(false);
+ else if (val >= 0.001)
+ Propulsion->GetEngine(i)->SetStarter(true);
+ }
+ } else {
+ Propulsion->GetEngine(ActiveEngine)->SetStarter(true);
+ }
+ break;
+ case FG_ACTIVE_ENGINE:
+ ActiveEngine = (int)val;
+ break;
- Initialize(U, V, W, phi*DEGTORAD, tht*DEGTORAD, psi*DEGTORAD,
- latitude*DEGTORAD, longitude*DEGTORAD, h);
+ case FG_LEFT_BRAKE_CMD:
+ FCS->SetLBrake(val);
+ break;
+ case FG_CENTER_BRAKE_CMD:
+ FCS->SetCBrake(val);
+ break;
+ case FG_RIGHT_BRAKE_CMD:
+ FCS->SetRBrake(val);
+ break;
+ case FG_GEAR_CMD:
+ FCS->SetGearCmd(val);
+ break;
+ case FG_GEAR_POS:
+ FCS->SetGearPos(val);
+ break;
+ case FG_SET_LOGGING:
+ if (val < -0.01) Output->Disable();
+ else if (val > 0.01) Output->Enable();
+ else Output->Toggle();
+ break;
- return true;
- } else {
- cerr << "Unable to load reset file " << fname << endl;
+ default:
+ cerr << "Parameter '" << val_idx << "' (" << paramdef[val_idx] << ") not handled" << endl;
+ }
+}
+
+//***************************************************************************
+//
+// Reset: Assume all angles READ FROM FILE IN DEGREES !!
+//
+
+bool FGState::Reset(string path, string acname, string fname)
+{
+ string resetDef;
+ string token="";
+
+ double U, V, W;
+ double phi, tht, psi;
+ double latitude, longitude, h;
+ double wdir, wmag, wnorth, weast;
+
+# ifndef macintosh
+ resetDef = path + "/" + acname + "/" + fname + ".xml";
+# else
+ resetDef = path + ";" + acname + ";" + fname + ".xml";
+# endif
+
+ FGConfigFile resetfile(resetDef);
+ if (!resetfile.IsOpen()) return false;
+
+ resetfile.GetNextConfigLine();
+ token = resetfile.GetValue();
+ if (token != string("initialize")) {
+ cerr << "The reset file " << resetDef
+ << " does not appear to be a reset file" << endl;
return false;
+ } else {
+ resetfile.GetNextConfigLine();
+ resetfile >> token;
+ cout << "Resetting using: " << token << endl << endl;
+ }
+
+ while (token != string("/initialize") && token != string("EOF")) {
+ if (token == "UBODY") resetfile >> U;
+ if (token == "VBODY") resetfile >> V;
+ if (token == "WBODY") resetfile >> W;
+ if (token == "LATITUDE") resetfile >> latitude;
+ if (token == "LONGITUDE") resetfile >> longitude;
+ if (token == "PHI") resetfile >> phi;
+ if (token == "THETA") resetfile >> tht;
+ if (token == "PSI") resetfile >> psi;
+ if (token == "ALTITUDE") resetfile >> h;
+ if (token == "WINDDIR") resetfile >> wdir;
+ if (token == "VWIND") resetfile >> wmag;
+
+ resetfile >> token;
}
+
+
+ Position->SetLatitude(latitude*degtorad);
+ Position->SetLongitude(longitude*degtorad);
+ Position->Seth(h);
+
+ wnorth = wmag*ktstofps*cos(wdir*degtorad);
+ weast = wmag*ktstofps*sin(wdir*degtorad);
+
+ Initialize(U, V, W, phi*degtorad, tht*degtorad, psi*degtorad,
+ latitude*degtorad, longitude*degtorad, h, wnorth, weast, 0.0);
+
+ return true;
}
//***************************************************************************
// Initialize: Assume all angles GIVEN IN RADIANS !!
//
-void FGState::Initialize(float U, float V, float W,
- float phi, float tht, float psi,
- float Latitude, float Longitude, float H) {
- FGColumnVector vUVW(3);
- FGColumnVector vLocalVelNED(3);
- FGColumnVector vEuler(3);
- float alpha, beta;
- float qbar, Vt;
+void FGState::Initialize(double U, double V, double W,
+ double phi, double tht, double psi,
+ double Latitude, double Longitude, double H,
+ double wnorth, double weast, double wdown)
+{
+ double alpha, beta;
+ double qbar, Vt;
+ FGColumnVector3 vAeroUVW;
- FDMExec->GetPosition()->SetLatitude(Latitude);
- FDMExec->GetPosition()->SetLongitude(Longitude);
- FDMExec->GetPosition()->Seth(H);
+ Position->SetLatitude(Latitude);
+ Position->SetLongitude(Longitude);
+ Position->Seth(H);
- FDMExec->GetAtmosphere()->Run();
+ Atmosphere->Run();
+
+ vLocalEuler << phi << tht << psi;
+ Rotation->SetEuler(vLocalEuler);
- if (W != 0.0)
- alpha = U*U > 0.0 ? atan2(W, U) : 0.0;
+ InitMatrices(phi, tht, psi);
+
+ vUVW << U << V << W;
+ Translation->SetUVW(vUVW);
+
+ Atmosphere->SetWindNED(wnorth, weast, wdown);
+
+ vAeroUVW = vUVW + mTl2b*Atmosphere->GetWindNED();
+
+ if (vAeroUVW(eW) != 0.0)
+ alpha = vAeroUVW(eU)*vAeroUVW(eU) > 0.0 ? atan2(vAeroUVW(eW), vAeroUVW(eU)) : 0.0;
else
alpha = 0.0;
- if (V != 0.0)
- beta = U*U+W*W > 0.0 ? atan2(V, (fabs(U)/U)*sqrt(U*U + W*W)) : 0.0;
+ if (vAeroUVW(eV) != 0.0)
+ beta = vAeroUVW(eU)*vAeroUVW(eU)+vAeroUVW(eW)*vAeroUVW(eW) > 0.0 ? atan2(vAeroUVW(eV), (fabs(vAeroUVW(eU))/vAeroUVW(eU))*sqrt(vAeroUVW(eU)*vAeroUVW(eU) + vAeroUVW(eW)*vAeroUVW(eW))) : 0.0;
else
beta = 0.0;
- vUVW << U << V << W;
- FDMExec->GetTranslation()->SetUVW(vUVW);
-
- vEuler << phi << tht << psi;
- FDMExec->GetRotation()->SetEuler(vEuler);
-
- FDMExec->GetTranslation()->SetAB(alpha, beta);
+ Translation->SetAB(alpha, beta);
Vt = sqrt(U*U + V*V + W*W);
- FDMExec->GetTranslation()->SetVt(Vt);
+ Translation->SetVt(Vt);
- qbar = 0.5*(U*U + V*V + W*W)*FDMExec->GetAtmosphere()->GetDensity();
- FDMExec->GetTranslation()->Setqbar(qbar);
+ Translation->SetMach(Vt/Atmosphere->GetSoundSpeed());
- InitMatrices(phi, tht, psi);
+ qbar = 0.5*(U*U + V*V + W*W)*Atmosphere->GetDensity();
+ Translation->Setqbar(qbar);
vLocalVelNED = mTb2l*vUVW;
- FDMExec->GetPosition()->SetvVel(vLocalVelNED);
+ Position->SetvVel(vLocalVelNED);
}
-/******************************************************************************/
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
void FGState::Initialize(FGInitialCondition *FGIC) {
- float tht,psi,phi;
- float U, V, W, h;
- float latitude, longitude;
-
+ double tht,psi,phi;
+ double U, V, W, h;
+ double latitude, longitude;
+ double wnorth,weast, wdown;
+
latitude = FGIC->GetLatitudeRadIC();
longitude = FGIC->GetLongitudeRadIC();
h = FGIC->GetAltitudeFtIC();
tht = FGIC->GetThetaRadIC();
phi = FGIC->GetPhiRadIC();
psi = FGIC->GetPsiRadIC();
-
- Initialize(U, V, W, phi, tht, psi, latitude, longitude, h);
+ wnorth = FGIC->GetWindNFpsIC();
+ weast = FGIC->GetWindEFpsIC();
+ wdown = FGIC->GetWindDFpsIC();
+
+ Position->SetSeaLevelRadius( FGIC->GetSeaLevelRadiusFtIC() );
+ Position->SetRunwayRadius( FGIC->GetSeaLevelRadiusFtIC() +
+ FGIC->GetTerrainAltitudeFtIC() );
+
+ // need to fix the wind speed args, here.
+ Initialize(U, V, W, phi, tht, psi, latitude, longitude, h, wnorth, weast, wdown);
}
-/******************************************************************************/
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
bool FGState::StoreData(string fname) {
ofstream datafile(fname.c_str());
if (datafile) {
- datafile << (FDMExec->GetTranslation()->GetUVW())(1);
- datafile << (FDMExec->GetTranslation()->GetUVW())(2);
- datafile << (FDMExec->GetTranslation()->GetUVW())(3);
- datafile << FDMExec->GetPosition()->GetLatitude();
- datafile << FDMExec->GetPosition()->GetLongitude();
- datafile << (FDMExec->GetRotation()->GetEuler())(1);
- datafile << (FDMExec->GetRotation()->GetEuler())(2);
- datafile << (FDMExec->GetRotation()->GetEuler())(3);
- datafile << FDMExec->GetPosition()->Geth();
+ datafile << Translation->GetUVW(eU);
+ datafile << Translation->GetUVW(eV);
+ datafile << Translation->GetUVW(eW);
+ datafile << Position->GetLatitude();
+ datafile << Position->GetLongitude();
+ datafile << Rotation->GetEuler(ePhi);
+ datafile << Rotation->GetEuler(eTht);
+ datafile << Rotation->GetEuler(ePsi);
+ datafile << Position->Geth();
datafile.close();
return true;
} else {
}
}
-/******************************************************************************/
-
-float FGState::GetParameter(string val_string) {
- return GetParameter(coeffdef[val_string]);
-}
-
-/******************************************************************************/
-
-int FGState::GetParameterIndex(string val_string) {
- return coeffdef[val_string];
-}
-
-/******************************************************************************/
-//
-// NEED WORK BELOW TO ADD NEW PARAMETERS !!!
-//
-float FGState::GetParameter(int val_idx) {
- switch(val_idx) {
- case FG_QBAR:
- return FDMExec->GetTranslation()->Getqbar();
- case FG_WINGAREA:
- return FDMExec->GetAircraft()->GetWingArea();
- case FG_WINGSPAN:
- return FDMExec->GetAircraft()->GetWingSpan();
- case FG_CBAR:
- return FDMExec->GetAircraft()->Getcbar();
- case FG_ALPHA:
- return FDMExec->GetTranslation()->Getalpha();
- case FG_ALPHADOT:
- return Getadot();
- case FG_BETA:
- return FDMExec->GetTranslation()->Getbeta();
- case FG_BETADOT:
- return Getbdot();
- case FG_PITCHRATE:
- return (FDMExec->GetRotation()->GetPQR())(2);
- case FG_ROLLRATE:
- return (FDMExec->GetRotation()->GetPQR())(1);
- case FG_YAWRATE:
- return (FDMExec->GetRotation()->GetPQR())(3);
- case FG_ELEVATOR_POS:
- return FDMExec->GetFCS()->GetDePos();
- case FG_AILERON_POS:
- return FDMExec->GetFCS()->GetDaPos();
- case FG_RUDDER_POS:
- return FDMExec->GetFCS()->GetDrPos();
- case FG_SPDBRAKE_POS:
- return FDMExec->GetFCS()->GetDsbPos();
- case FG_SPOILERS_POS:
- return FDMExec->GetFCS()->GetDspPos();
- case FG_FLAPS_POS:
- return FDMExec->GetFCS()->GetDfPos();
- case FG_ELEVATOR_CMD:
- return FDMExec->GetFCS()->GetDeCmd();
- case FG_AILERON_CMD:
- return FDMExec->GetFCS()->GetDaCmd();
- case FG_RUDDER_CMD:
- return FDMExec->GetFCS()->GetDrCmd();
- case FG_SPDBRAKE_CMD:
- return FDMExec->GetFCS()->GetDsbCmd();
- case FG_SPOILERS_CMD:
- return FDMExec->GetFCS()->GetDspCmd();
- case FG_FLAPS_CMD:
- return FDMExec->GetFCS()->GetDfCmd();
- case FG_MACH:
- return FDMExec->GetTranslation()->GetMach();
- case FG_ALTITUDE:
- return FDMExec->GetPosition()->Geth();
- case FG_BI2VEL:
- return FDMExec->GetAircraft()->GetWingSpan()/(2.0 * FDMExec->GetTranslation()->GetVt());
- case FG_CI2VEL:
- return FDMExec->GetAircraft()->Getcbar()/(2.0 * FDMExec->GetTranslation()->GetVt());
- case FG_THROTTLE_CMD:
- return FDMExec->GetFCS()->GetThrottleCmd(0);
- case FG_THROTTLE_POS:
- return FDMExec->GetFCS()->GetThrottlePos(0);
- case FG_HOVERB:
- return FDMExec->GetPosition()->GetHOverB();
- case FG_PITCH_TRIM_CMD:
- return FDMExec->GetFCS()->GetPitchTrimCmd();
- }
- return 0;
-}
-
-/******************************************************************************/
-
-void FGState::SetParameter(int val_idx, float val) {
- switch(val_idx) {
- case FG_ELEVATOR_POS:
- FDMExec->GetFCS()->SetDePos(val);
- break;
- case FG_AILERON_POS:
- FDMExec->GetFCS()->SetDaPos(val);
- break;
- case FG_RUDDER_POS:
- FDMExec->GetFCS()->SetDrPos(val);
- break;
- case FG_SPDBRAKE_POS:
- FDMExec->GetFCS()->SetDsbPos(val);
- break;
- case FG_SPOILERS_POS:
- FDMExec->GetFCS()->SetDspPos(val);
- break;
- case FG_FLAPS_POS:
- FDMExec->GetFCS()->SetDfPos(val);
- break;
- case FG_THROTTLE_POS:
- FDMExec->GetFCS()->SetThrottlePos(-1,val);
- }
-}
-
-/******************************************************************************/
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-void FGState::InitMatrices(float phi, float tht, float psi) {
- float thtd2, psid2, phid2;
- float Sthtd2, Spsid2, Sphid2;
- float Cthtd2, Cpsid2, Cphid2;
- float Cphid2Cthtd2;
- float Cphid2Sthtd2;
- float Sphid2Sthtd2;
- float Sphid2Cthtd2;
+void FGState::InitMatrices(double phi, double tht, double psi) {
+ double thtd2, psid2, phid2;
+ double Sthtd2, Spsid2, Sphid2;
+ double Cthtd2, Cpsid2, Cphid2;
+ double Cphid2Cthtd2;
+ double Cphid2Sthtd2;
+ double Sphid2Sthtd2;
+ double Sphid2Cthtd2;
thtd2 = tht/2.0;
psid2 = psi/2.0;
CalcMatrices();
}
-/******************************************************************************/
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
void FGState::CalcMatrices(void) {
- float Q0Q0, Q1Q1, Q2Q2, Q3Q3;
- float Q0Q1, Q0Q2, Q0Q3, Q1Q2;
- float Q1Q3, Q2Q3;
+ double Q0Q0, Q1Q1, Q2Q2, Q3Q3;
+ double Q0Q1, Q0Q2, Q0Q3, Q1Q2;
+ double Q1Q3, Q2Q3;
Q0Q0 = vQtrn(1)*vQtrn(1);
Q1Q1 = vQtrn(2)*vQtrn(2);
Q1Q3 = vQtrn(2)*vQtrn(4);
Q2Q3 = vQtrn(3)*vQtrn(4);
- mTb2l(1,1) = Q0Q0 + Q1Q1 - Q2Q2 - Q3Q3;
- mTb2l(1,2) = 2*(Q1Q2 + Q0Q3);
- mTb2l(1,3) = 2*(Q1Q3 - Q0Q2);
- mTb2l(2,1) = 2*(Q1Q2 - Q0Q3);
- mTb2l(2,2) = Q0Q0 - Q1Q1 + Q2Q2 - Q3Q3;
- mTb2l(2,3) = 2*(Q2Q3 + Q0Q1);
- mTb2l(3,1) = 2*(Q1Q3 + Q0Q2);
- mTb2l(3,2) = 2*(Q2Q3 - Q0Q1);
- mTb2l(3,3) = Q0Q0 - Q1Q1 - Q2Q2 + Q3Q3;
-
- mTl2b = mTb2l;
- mTl2b.T();
+ mTl2b(1,1) = Q0Q0 + Q1Q1 - Q2Q2 - Q3Q3;
+ mTl2b(1,2) = 2*(Q1Q2 + Q0Q3);
+ mTl2b(1,3) = 2*(Q1Q3 - Q0Q2);
+ mTl2b(2,1) = 2*(Q1Q2 - Q0Q3);
+ mTl2b(2,2) = Q0Q0 - Q1Q1 + Q2Q2 - Q3Q3;
+ mTl2b(2,3) = 2*(Q2Q3 + Q0Q1);
+ mTl2b(3,1) = 2*(Q1Q3 + Q0Q2);
+ mTl2b(3,2) = 2*(Q2Q3 - Q0Q1);
+ mTl2b(3,3) = Q0Q0 - Q1Q1 - Q2Q2 + Q3Q3;
+
+ mTb2l = mTl2b;
+ mTb2l.T();
}
-/******************************************************************************/
-
-void FGState::IntegrateQuat(FGColumnVector vPQR, int rate) {
- static FGColumnVector vlastQdot(4);
- static FGColumnVector vQdot(4);
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+void FGState::IntegrateQuat(FGColumnVector3 vPQR, int rate) {
vQdot(1) = -0.5*(vQtrn(2)*vPQR(eP) + vQtrn(3)*vPQR(eQ) + vQtrn(4)*vPQR(eR));
vQdot(2) = 0.5*(vQtrn(1)*vPQR(eP) + vQtrn(3)*vPQR(eR) - vQtrn(4)*vPQR(eQ));
vQdot(3) = 0.5*(vQtrn(1)*vPQR(eQ) + vQtrn(4)*vPQR(eP) - vQtrn(2)*vPQR(eR));
vQdot(4) = 0.5*(vQtrn(1)*vPQR(eR) + vQtrn(2)*vPQR(eQ) - vQtrn(3)*vPQR(eP));
-
vQtrn += 0.5*dt*rate*(vlastQdot + vQdot);
vQtrn.Normalize();
vlastQdot = vQdot;
}
-/******************************************************************************/
-
-FGColumnVector FGState::CalcEuler(void) {
- static FGColumnVector vEuler(3);
-
- if (mTb2l(3,3) == 0) vEuler(ePhi) = 0.0;
- else vEuler(ePhi) = atan2(mTb2l(2,3), mTb2l(3,3));
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
- vEuler(eTht) = asin(-mTb2l(1,3));
+FGColumnVector3& FGState::CalcEuler(void) {
+ if (mTl2b(3,3) == 0.0) mTl2b(3,3) = 0.0000001;
+ if (mTl2b(1,1) == 0.0) mTl2b(1,1) = 0.0000001;
- if (mTb2l(1,1) == 0.0) vEuler(ePsi) = 0.0;
- else vEuler(ePsi) = atan2(mTb2l(1,2), mTb2l(1,1));
+ vEuler(ePhi) = atan2(mTl2b(2,3), mTl2b(3,3));
+ vEuler(eTht) = asin(-mTl2b(1,3));
+ vEuler(ePsi) = atan2(mTl2b(1,2), mTl2b(1,1));
if (vEuler(ePsi) < 0.0) vEuler(ePsi) += 2*M_PI;
return vEuler;
}
-/******************************************************************************/
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-FGMatrix FGState::GetTs2b(float alpha, float beta) {
- float ca, cb, sa, sb;
+FGMatrix33& FGState::GetTs2b(void)
+{
+ double ca, cb, sa, sb;
+
+ double alpha = Translation->Getalpha();
+ double beta = Translation->Getbeta();
ca = cos(alpha);
sa = sin(alpha);
cb = cos(beta);
sb = sin(beta);
- mTs2b(1,1) = -ca*cb;
+ mTs2b(1,1) = ca*cb;
mTs2b(1,2) = -ca*sb;
- mTs2b(1,3) = sa;
- mTs2b(2,1) = -sb;
+ mTs2b(1,3) = -sa;
+ mTs2b(2,1) = sb;
mTs2b(2,2) = cb;
mTs2b(2,3) = 0.0;
- mTs2b(3,1) = -sa*cb;
+ mTs2b(3,1) = sa*cb;
mTs2b(3,2) = -sa*sb;
- mTs2b(3,3) = -ca;
+ mTs2b(3,3) = ca;
return mTs2b;
}
-/******************************************************************************/
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+FGMatrix33& FGState::GetTb2s(void)
+{
+ float alpha,beta;
+ float ca, cb, sa, sb;
+
+ alpha = Translation->Getalpha();
+ beta = Translation->Getbeta();
+
+ ca = cos(alpha);
+ sa = sin(alpha);
+ cb = cos(beta);
+ sb = sin(beta);
+
+ mTb2s(1,1) = ca*cb;
+ mTb2s(1,2) = sb;
+ mTb2s(1,3) = sa*cb;
+ mTb2s(2,1) = -ca*sb;
+ mTb2s(2,2) = cb;
+ mTb2s(2,3) = -sa*sb;
+ mTb2s(3,1) = -sa;
+ mTb2s(3,2) = 0.0;
+ mTb2s(3,3) = ca;
+
+ return mTb2s;
+}
+
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+void FGState::ReportState(void) {
+ char out[80], flap[10], gear[12];
+
+ cout << endl << " JSBSim State" << endl;
+ snprintf(out,80," Weight: %7.0f lbs. CG: %5.1f, %5.1f, %5.1f inches\n",
+ FDMExec->GetMassBalance()->GetWeight(),
+ FDMExec->GetMassBalance()->GetXYZcg(1),
+ FDMExec->GetMassBalance()->GetXYZcg(2),
+ FDMExec->GetMassBalance()->GetXYZcg(3));
+ cout << out;
+ if( FCS->GetDfPos() <= 0.01)
+ snprintf(flap,10,"Up");
+ else
+ snprintf(flap,10,"%2.0f",FCS->GetDfPos());
+ if(FCS->GetGearPos() < 0.01)
+ snprintf(gear,12,"Up");
+ else if(FCS->GetGearPos() > 0.99)
+ snprintf(gear,12,"Down");
+ else
+ snprintf(gear,12,"In Transit");
+ snprintf(out,80, " Flaps: %3s Gear: %12s\n",flap,gear);
+ cout << out;
+ snprintf(out,80, " Speed: %4.0f KCAS Mach: %5.2f\n",
+ FDMExec->GetAuxiliary()->GetVcalibratedKTS(),
+ GetParameter(FG_MACH) );
+ cout << out;
+ snprintf(out,80, " Altitude: %7.0f ft. AGL Altitude: %7.0f ft.\n",
+ Position->Geth(),
+ Position->GetDistanceAGL() );
+ cout << out;
+ snprintf(out,80, " Angle of Attack: %6.2f deg Pitch Angle: %6.2f deg\n",
+ GetParameter(FG_ALPHA)*radtodeg,
+ Rotation->Gettht()*radtodeg );
+ cout << out;
+ snprintf(out,80, " Flight Path Angle: %6.2f deg Climb Rate: %5.0f ft/min\n",
+ Position->GetGamma()*radtodeg,
+ Position->Gethdot()*60 );
+ cout << out;
+ snprintf(out,80, " Normal Load Factor: %4.2f g's Pitch Rate: %5.2f deg/s\n",
+ Aircraft->GetNlf(),
+ GetParameter(FG_PITCHRATE)*radtodeg );
+ cout << out;
+ snprintf(out,80, " Heading: %3.0f deg true Sideslip: %5.2f deg\n",
+ Rotation->Getpsi()*radtodeg,
+ GetParameter(FG_BETA)*radtodeg );
+ cout << out;
+ snprintf(out,80, " Bank Angle: %5.2f deg\n",
+ Rotation->Getphi()*radtodeg );
+ cout << out;
+ snprintf(out,80, " Elevator: %5.2f deg Left Aileron: %5.2f deg Rudder: %5.2f deg\n",
+ GetParameter(FG_ELEVATOR_POS)*radtodeg,
+ GetParameter(FG_AILERON_POS)*radtodeg,
+ GetParameter(FG_RUDDER_POS)*radtodeg );
+ cout << out;
+ snprintf(out,80, " Throttle: %5.2f%c\n",
+ FCS->GetThrottlePos(0)*100,'%' );
+ cout << out;
+
+ snprintf(out,80, " Wind Components: %5.2f kts head wind, %5.2f kts cross wind\n",
+ FDMExec->GetAuxiliary()->GetHeadWind()*fpstokts,
+ FDMExec->GetAuxiliary()->GetCrossWind()*fpstokts );
+ cout << out;
+
+ snprintf(out,80, " Ground Speed: %4.0f knots , Ground Track: %3.0f deg true\n",
+ Position->GetVground()*fpstokts,
+ Position->GetGroundTrack()*radtodeg );
+ cout << out;
+
+}
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+// The bitmasked value choices are as follows:
+// unset: In this case (the default) JSBSim would only print
+// out the normally expected messages, essentially echoing
+// the config files as they are read. If the environment
+// variable is not set, debug_lvl is set to 1 internally
+// 0: This requests JSBSim not to output any messages
+// whatsoever.
+// 1: This value explicity requests the normal JSBSim
+// startup messages
+// 2: This value asks for a message to be printed out when
+// a class is instantiated
+// 4: When this value is set, a message is displayed when a
+// FGModel object executes its Run() method
+// 8: When this value is set, various runtime state variables
+// are printed out periodically
+// 16: When set various parameters are sanity checked and
+// a message is printed out when they go out of bounds
+
+void FGState::Debug(int from)
+{
+ if (debug_lvl <= 0) return;
+
+ if (debug_lvl & 1) { // Standard console startup message output
+ if (from == 0) { // Constructor
+
+ }
+ }
+ if (debug_lvl & 2 ) { // Instantiation/Destruction notification
+ if (from == 0) cout << "Instantiated: FGState" << endl;
+ if (from == 1) cout << "Destroyed: FGState" << endl;
+ }
+ if (debug_lvl & 4 ) { // Run() method entry print for FGModel-derived objects
+ }
+ if (debug_lvl & 8 ) { // Runtime state variables
+ }
+ if (debug_lvl & 16) { // Sanity checking
+ }
+}