![]() |
Earth Explorer Mission CFI Software Orbit Software User Manual |
![]() |
00001 //-------------------------------------------------------------------- 00002 // CVS Info: $Id: OrbitData.h,v 1.7 2009/03/30 08:51:40 expcfi Exp $ 00003 //-------------------------------------------------------------------- 00004 00009 00010 #ifndef __EECFI_ORBITDATA__ 00011 #define __EECFI_ORBITDATA__ 00012 00013 //--INCLUDE----------------------------------------------------------- 00014 #include "DataHandlingData.h" 00015 #include "LibData.h" 00016 00017 //--NAMESPACES-------------------------------------------------------- 00018 using namespace std; 00019 00020 namespace EECFI 00021 { 00022 //------------------------------------------------------ 00023 // CONSTANT DATA 00024 //------------------------------------------------------ 00026 #define XOCFI_NUM_CHECK_PARAMS 6 00027 00028 //------------------------------------------------------ 00029 // DATA ENUMERATION 00030 // Enumeration values are defined in an equivalent way to the C library 00031 // except for the prefix that has been changed from XX_ to XXCFI_ 00032 //------------------------------------------------------ 00033 00035 typedef enum 00036 { 00037 XOCFI_ORBIT_EXTRA_DEP_NODAL_PERIOD = 0, 00038 XOCFI_ORBIT_EXTRA_DEP_UTC_CURRENT_ANX, 00039 XOCFI_ORBIT_EXTRA_DEP_ORBIT_NUMBER, 00040 XOCFI_ORBIT_EXTRA_DEP_SEC_SINCE_ANX, 00041 XOCFI_ORBIT_EXTRA_DEP_MEAN_KEPL_A, 00042 XOCFI_ORBIT_EXTRA_DEP_MEAN_KEPL_E, 00043 XOCFI_ORBIT_EXTRA_DEP_MEAN_KEPL_I, 00044 XOCFI_ORBIT_EXTRA_DEP_MEAN_KEPL_RA, 00045 XOCFI_ORBIT_EXTRA_DEP_MEAN_KEPL_W, 00046 XOCFI_ORBIT_EXTRA_DEP_MEAN_KEPL_M, 00047 XOCFI_ORBIT_EXTRA_NUM_DEP_ELEMENTS 00048 } OrbitExtraModelMKODependantEnum; 00049 00051 typedef enum 00052 { 00053 XOCFI_ORBIT_EXTRA_GEOC_LONG = 0, 00054 XOCFI_ORBIT_EXTRA_GEOD_LAT, 00055 XOCFI_ORBIT_EXTRA_GEOD_ALT, 00056 XOCFI_ORBIT_EXTRA_GEOC_LONG_D, 00057 XOCFI_ORBIT_EXTRA_GEOD_LAT_D, 00058 XOCFI_ORBIT_EXTRA_GEOD_ALT_D, 00059 XOCFI_ORBIT_EXTRA_GEOC_LONG_2D, 00060 XOCFI_ORBIT_EXTRA_GEOD_LAT_2D, 00061 XOCFI_ORBIT_EXTRA_GEOD_ALT_2D, 00062 XOCFI_ORBIT_EXTRA_RAD_CUR_PARALLEL_MERIDIAN, 00063 XOCFI_ORBIT_EXTRA_RAD_CUR_ORTHO_MERIDIAN, 00064 XOCFI_ORBIT_EXTRA_RAD_CUR_ALONG_GROUNDTRACK, 00065 XOCFI_ORBIT_EXTRA_NORTH_VEL, 00066 XOCFI_ORBIT_EXTRA_EAST_VEL, 00067 XOCFI_ORBIT_EXTRA_MAG_VEL, 00068 XOCFI_ORBIT_EXTRA_AZ_VEL, 00069 XOCFI_ORBIT_EXTRA_NORTH_ACC, 00070 XOCFI_ORBIT_EXTRA_EAST_ACC, 00071 XOCFI_ORBIT_EXTRA_GROUNDTRACK_ACC, 00072 XOCFI_ORBIT_EXTRA_AZ_ACC, 00073 XOCFI_ORBIT_EXTRA_SAT_ECLIPSE_FLAG, 00074 XOCFI_ORBIT_EXTRA_SZA, 00075 XOCFI_ORBIT_EXTRA_MLST, 00076 XOCFI_ORBIT_EXTRA_TLST, 00077 XOCFI_ORBIT_EXTRA_TRUE_SUN_RA, 00078 XOCFI_ORBIT_EXTRA_TRUE_SUN_DEC, 00079 XOCFI_ORBIT_EXTRA_TRUE_SUN_SEMIDIAM, 00080 XOCFI_ORBIT_EXTRA_MOON_RA, 00081 XOCFI_ORBIT_EXTRA_MOON_DEC, 00082 XOCFI_ORBIT_EXTRA_MOON_SEMI_DIAM, 00083 XOCFI_ORBIT_EXTRA_MOON_AREA_LIT, 00084 XOCFI_ORBIT_EXTRA_OSC_KEPL_A, 00085 XOCFI_ORBIT_EXTRA_OSC_KEPL_E, 00086 XOCFI_ORBIT_EXTRA_OSC_KEPL_I, 00087 XOCFI_ORBIT_EXTRA_OSC_KEPL_RA, 00088 XOCFI_ORBIT_EXTRA_OSC_KEPL_W, 00089 XOCFI_ORBIT_EXTRA_OSC_KEPL_M, 00090 XOCFI_ORBIT_EXTRA_ORBIT_RAD, 00091 XOCFI_ORBIT_EXTRA_RADIAL_ORB_VEL, 00092 XOCFI_ORBIT_EXTRA_TRANS_ORB_VEL, 00093 XOCFI_ORBIT_EXTRA_ORB_VEL_MAG, 00094 XOCFI_ORBIT_EXTRA_RA_SAT, 00095 XOCFI_ORBIT_EXTRA_DEC_SAT, 00096 XOCFI_ORBIT_EXTRA_EARTH_ROTATION_ANGLE, 00097 XOCFI_ORBIT_EXTRA_RA_SAT_D, 00098 XOCFI_ORBIT_EXTRA_RA_SAT_2D, 00099 XOCFI_ORBIT_EXTRA_OSC_TRUE_LAT, 00100 XOCFI_ORBIT_EXTRA_OSC_TRUE_LAT_D, 00101 XOCFI_ORBIT_EXTRA_OSC_TRUE_LAT_2D, 00102 XOCFI_ORBIT_EXTRA_NUM_INDEP_ELEMENTS 00103 00104 } OrbitExtraModelMKOIndependantEnum; 00105 00107 typedef enum 00108 { 00109 // model independant 00110 XOCFI_ORBIT_EXTRA_NO_RESULTS = 0, 00111 XOCFI_ORBIT_EXTRA_GEOLOCATION = 1, 00112 XOCFI_ORBIT_EXTRA_GEOLOCATION_D = 2, 00113 XOCFI_ORBIT_EXTRA_GEOLOCATION_2D = 4, 00114 XOCFI_ORBIT_EXTRA_GEOLOCATION_EXTRA = 8, 00115 XOCFI_ORBIT_EXTRA_EARTH_FIXED_D = 16, 00116 XOCFI_ORBIT_EXTRA_EARTH_FIXED_2D = 32, 00117 XOCFI_ORBIT_EXTRA_SUN = 64, 00118 XOCFI_ORBIT_EXTRA_MOON = 128, 00119 XOCFI_ORBIT_EXTRA_OSCULATING_KEPLER = 256, 00120 XOCFI_ORBIT_EXTRA_INERTIAL_AUX = 512, 00121 // model dependant 00122 XOCFI_ORBIT_EXTRA_DEP_ANX_TIMING = 1024, 00123 XOCFI_ORBIT_EXTRA_DEP_MEAN_KEPLER = 2048, 00124 XOCFI_ORBIT_EXTRA_ALL_RESULTS = 4095 00125 00126 }OrbitExtraChoiceEnum; 00127 00129 typedef enum 00130 { 00131 XOCFI_SAT_DEFAULT = XLCFI_SAT_DEFAULT, 00132 XOCFI_SAT_DEFAULT1 = XLCFI_SAT_DEFAULT1, 00133 XOCFI_SAT_DEFAULT2 = XLCFI_SAT_DEFAULT2, 00134 XOCFI_SAT_DEFAULT3 = XLCFI_SAT_DEFAULT3, 00135 XOCFI_SAT_DEFAULT4 = XLCFI_SAT_DEFAULT4, 00136 XOCFI_SAT_DEFAULT5 = XLCFI_SAT_DEFAULT5, 00137 XOCFI_SAT_DEFAULT6 = XLCFI_SAT_DEFAULT6, 00138 XOCFI_SAT_DEFAULT7 = XLCFI_SAT_DEFAULT7, 00139 XOCFI_SAT_DEFAULT8 = XLCFI_SAT_DEFAULT8, 00140 XOCFI_SAT_DEFAULT9 = XLCFI_SAT_DEFAULT9, 00141 XOCFI_SAT_ERS1 = XLCFI_SAT_ERS1, 00142 XOCFI_SAT_ERS2 = XLCFI_SAT_ERS2, 00143 XOCFI_SAT_ENVISAT = XLCFI_SAT_ENVISAT, 00144 XOCFI_SAT_METOP1 = XLCFI_SAT_METOP1, 00145 XOCFI_SAT_METOP2 = XLCFI_SAT_METOP2, 00146 XOCFI_SAT_METOP3 = XLCFI_SAT_METOP3, 00147 XOCFI_SAT_CRYOSAT = XLCFI_SAT_CRYOSAT, 00148 XOCFI_SAT_ADM = XLCFI_SAT_ADM, 00149 XOCFI_SAT_GOCE = XLCFI_SAT_GOCE, 00150 XOCFI_SAT_SMOS = XLCFI_SAT_SMOS, 00151 XOCFI_SAT_TERRASAR = XLCFI_SAT_TERRASAR, 00152 XOCFI_SAT_EARTHCARE = XLCFI_SAT_EARTHCARE, 00153 XOCFI_SAT_SWARM_A = XLCFI_SAT_SWARM_A, 00154 XOCFI_SAT_SWARM_B = XLCFI_SAT_SWARM_B, 00155 XOCFI_SAT_SWARM_C = XLCFI_SAT_SWARM_C, 00156 XOCFI_SAT_SENTINEL_1A = XLCFI_SAT_SENTINEL_1A, 00157 XOCFI_SAT_SENTINEL_1B = XLCFI_SAT_SENTINEL_1B 00158 } SatIdOrbitEnum; 00159 00161 typedef enum 00162 { 00163 XOCFI_TIME_UNDEF = XLCFI_TIME_UNDEF, 00164 XOCFI_TIME_TAI = XLCFI_TIME_TAI, 00165 XOCFI_TIME_UTC = XLCFI_TIME_UTC, 00166 XOCFI_TIME_UT1 = XLCFI_TIME_UT1, 00167 XOCFI_TIME_GPS = XLCFI_TIME_GPS 00168 } TimeRefOrbitEnum; 00169 00171 typedef enum 00172 { 00173 XOCFI_SEL_FILE = 0, 00174 XOCFI_SEL_TIME, 00175 XOCFI_SEL_ORBIT, 00176 XOCFI_SEL_DEFAULT 00177 } InitModeEnum; 00178 00180 typedef enum 00181 { 00182 XOCFI_ORBIT_INIT_UNKNOWN_MODE = -1, 00183 XOCFI_ORBIT_INIT_AUTO = XDCFI_AUTO, 00184 XOCFI_ORBIT_INIT_ORBIT_CHANGE_MODE = XDCFI_ORBIT_CHANGE, 00185 XOCFI_ORBIT_INIT_STATE_VECTOR_MODE = XDCFI_STATE_VECTOR, 00186 XOCFI_ORBIT_INIT_OSF_MODE = XDCFI_OSF_TYPE, 00187 XOCFI_ORBIT_INIT_POF_MODE = XDCFI_POF_TYPE, 00188 XOCFI_ORBIT_INIT_ROF_MODE = XDCFI_ROF_TYPE, 00189 XOCFI_ORBIT_INIT_DORIS_MODE = XDCFI_DORIS_TYPE, 00190 XOCFI_ORBIT_INIT_POF_N_DORIS_MODE = XDCFI_POF_N_DORIS_TYPE, 00191 XOCFI_ORBIT_INIT_OEF_OSF_MODE = XDCFI_OEF_OSF_TYPE, 00192 XOCFI_ORBIT_INIT_OEF_POF_MODE = XDCFI_OEF_POF_TYPE, 00193 XOCFI_ORBIT_INIT_TLE_MODE = XDCFI_TLE_TYPE, 00194 XOCFI_ORBIT_INIT_STATE_VECTOR_PRECISE_MODE, 00195 XOCFI_ORBIT_INIT_POF_PRECISE_MODE, 00196 XOCFI_ORBIT_INIT_ROF_PRECISE_MODE, 00197 XOCFI_ORBIT_INIT_DORIS_PRECISE_MODE, 00198 XOCFI_ORBIT_INIT_OEF_POF_PRECISE_MODE, 00199 XOCFI_ORBIT_INIT_POF_N_DORIS_PRECISE_MODE, 00200 XOCFI_ORBIT_INIT_MAX_VALUE 00201 00202 } OrbitInitModeEnum; 00203 00205 typedef enum 00206 { 00207 XOCFI_INTERPOL_MODEL_DEFAULT = 0 00208 } InterpolModelEnum; 00209 00211 typedef enum 00212 { 00213 XOCFI_PROPAG_MODEL_MEAN_KEPL = 0, 00214 XOCFI_PROPAG_MODEL_SPOT = 1, 00215 XOCFI_PROPAG_MODEL_TLE = 2, 00216 XOCFI_PROPAG_MODEL_PRECISE = 3, 00217 XOCFI_PROPAG_MODEL_AUTO = 10, 00218 XOCFI_PROPAG_MODEL_DOUBLE = 100 00219 } PropagModelEnum; 00220 00222 typedef enum 00223 { 00224 XOCFI_NOSUNSYNC_DRIFT = 0, 00225 XOCFI_NOSUNSYNC_INCLINATION, 00226 XOCFI_NOSUNSYNC_USE_SIM_MODEL = 10 00227 } NoSunSychronousModeEnum; 00228 00230 typedef enum 00231 { 00232 XOCFI_OSV_PRECISE_NO = 1, 00233 XOCFI_OSV_PRECISE_MINUTE, 00234 XOCFI_OSV_PRECISE_TEN_SECONDS 00235 00236 } OsvPreciseEnum; 00237 00239 typedef enum 00240 { 00241 XOCFI_REF_FILETYPE_OSF = 1, 00242 XOCFI_REF_FILETYPE_OEF_OSF, 00243 XOCFI_REF_FILETYPE_POF, 00244 XOCFI_REF_FILETYPE_OEF_POF, 00245 XOCFI_REF_FILETYPE_DORIS_NAV, 00246 XOCFI_REF_FILETYPE_ROF, 00247 XOCFI_REF_FILETYPE_DORIS_PREM, 00248 XOCFI_REF_FILETYPE_DORIS_PREC 00249 00250 } RefFiletypeEnum; 00251 00253 typedef enum 00254 { 00255 XOCFI_NO_PHASE_INCREMENT = 0, 00256 XOCFI_PHASE_INCREMENT = 1 00257 } GenOsfPhaseIncrementEnum; 00258 00260 typedef enum 00261 { 00262 XOCFI_FIT_TLE = 0, 00263 XOCFI_ONE_TLE_PER_OSV 00264 } TLEFitModeEnum; 00265 00267 typedef enum 00268 { 00269 XOCFI_SEARCH_FORWARD = 1, 00270 XOCFI_SEARCH_BACKWARD = -1 00271 } GenOsfSearchDirectionEnum; 00272 00273 //------------------------------------------------------ 00274 // DATA STRUCTURES 00275 //------------------------------------------------------ 00276 00278 class ANXExtra 00279 { 00280 public: 00281 long absOrbit; 00282 double tAnx; 00283 double tNod; 00284 00286 ANXExtra() 00287 { 00288 absOrbit = -1; 00289 tAnx = -1; 00290 tNod = -1; 00291 }; 00292 00294 ANXExtra( long absOrb, double timeAnx, double timeNod ) 00295 { 00296 absOrbit = absOrb; 00297 tAnx = timeAnx; 00298 tNod = timeNod; 00299 } 00300 00301 }; 00302 00304 class ValidityTime 00305 { 00306 public: 00307 long timeRef; 00308 double start; 00309 double stop; 00310 00312 ValidityTime() 00313 { 00314 timeRef = -1; 00315 start = -1; 00316 stop = -1; 00317 } 00318 00320 ValidityTime( long timeReference, double startVal, double stopVal ) 00321 { 00322 timeRef = timeReference; 00323 start = startVal; 00324 stop = stopVal; 00325 } 00326 }; 00327 00329 class OrbitInfo 00330 { 00331 public: 00332 long absOrbit; 00333 long relOrbit; 00334 long cycle; 00335 long phase; 00336 00338 OrbitInfo() 00339 { 00340 absOrbit = -1; 00341 relOrbit = -1; 00342 cycle = -1; 00343 phase = -1; 00344 } 00345 00347 OrbitInfo( long absoluteOrbit, long relativeOrbit, long cycleOrbit, 00348 long phaseOrbit) 00349 { 00350 absOrbit = absoluteOrbit; 00351 relOrbit = relativeOrbit; 00352 cycle = cycleOrbit; 00353 phase = phaseOrbit; 00354 } 00355 00356 }; 00357 00359 class StateVectorInfo 00360 { 00361 public: 00362 double pos[3]; 00363 double vel[3]; 00364 double acc[3]; 00365 00367 StateVectorInfo() 00368 { 00369 pos[0] = 0.; vel[1] = 0.; acc[2] = 0.; 00370 pos[0] = 0.; vel[1] = 0.; acc[2] = 0.; 00371 pos[0] = 0.; vel[1] = 0.; acc[2] = 0.; 00372 } 00373 00375 StateVectorInfo( double *posIn, double *velIn, double *accIn ) 00376 { 00377 pos[0] = posIn[0]; vel[1] = velIn[1]; acc[2] = accIn[2]; 00378 pos[0] = posIn[0]; vel[1] = velIn[1]; acc[2] = accIn[2]; 00379 pos[0] = posIn[0]; vel[1] = velIn[1]; acc[2] = accIn[2]; 00380 } 00381 }; 00382 00384 class StateVectorExtraInfo 00385 { 00386 public: 00387 double modelDep[XOCFI_ORBIT_EXTRA_NUM_DEP_ELEMENTS]; 00388 double modelIndep[XOCFI_ORBIT_EXTRA_NUM_INDEP_ELEMENTS]; 00389 00391 StateVectorExtraInfo() 00392 { 00393 int i; 00394 for ( i = 0 ; i < XOCFI_ORBIT_EXTRA_NUM_DEP_ELEMENTS ; i++ ) 00395 modelDep[i] = 0.; 00396 for ( i = 0 ; i < XOCFI_ORBIT_EXTRA_NUM_INDEP_ELEMENTS ; i++ ) 00397 modelIndep[i] = 0.; 00398 } 00399 00401 StateVectorExtraInfo( double *model, double *extra ) 00402 { 00403 int i; 00404 for ( i = 0 ; i < XOCFI_ORBIT_EXTRA_NUM_DEP_ELEMENTS ; i++ ) 00405 modelDep[i] = model[i]; 00406 for ( i = 0 ; i < XOCFI_ORBIT_EXTRA_NUM_INDEP_ELEMENTS ; i++ ) 00407 modelIndep[i] = extra[i]; 00408 } 00409 }; 00410 00412 class AnxInfo 00413 { 00414 public: 00415 double anxTai; 00416 double anxUtc; 00417 double anxUt1; 00418 double anxPos[3]; 00419 double anxVel[3]; 00420 double kepl[6]; 00421 double tNod; 00422 }; 00423 00425 class RefOrbitInfo 00426 { 00427 public: 00428 long driftMode; 00429 double inclination; 00430 long repCycle; 00431 long cycleLength; 00432 double AnxLong; 00433 double mlst; 00434 double mlstDrift; 00435 }; 00436 00438 class OsfRecords 00439 { 00440 public: 00441 OrbitInfo missionInfo; 00442 RefOrbitInfo refOrbitinfo; 00443 AnxInfo anxInfo; 00444 }; 00445 00447 class OrbitalInfo 00448 { 00449 public: 00450 long absOrbit; 00451 long repCycle; 00452 long cycLength; 00453 double mlstDrift; 00454 double mlst; 00455 double phasing; 00456 double utcAnx; 00457 double posAnx[3]; 00458 double velAnx[3]; 00459 double meanKep[6]; 00460 double oscKep[6]; 00461 double nodalPeriod; 00462 }; 00463 00464 } // closing namespace 00465 00466 #endif