![]() |
Earth Observation Mission CFI Software Lib Software User Manual |
![]() |
00001 //-------------------------------------------------------- 00002 // Earth Observation Mission CFI Software. Version 4.13 00003 //-------------------------------------------------------- 00004 00005 //-------------------------------------------------------------------- 00006 // CVS Info: $Id: LibData.h,v 1.30 2014-02-26 13:00:48 paat Exp $ 00007 //-------------------------------------------------------------------- 00008 00013 00014 #ifndef __EECFI_LIBDATA__ 00015 #define __EECFI_LIBDATA__ 00016 00017 //--INCLUDE----------------------------------------------------------- 00018 #include <vector> 00019 #include "DataHandlingData.h" 00020 #include "LibDllExport.h" 00021 00022 //--NAMESPACES-------------------------------------------------------- 00023 using namespace std; 00024 00025 namespace EECFI 00026 { 00027 00028 //------------------------------------------------------ 00029 // CONSTANTS 00030 //------------------------------------------------------ 00032 #define MCFI_PI 3.14159265358979323846 00033 00034 //------------------------------------------------------ 00035 // DATA ENUMERATION 00036 // Enumeration values are defined in an equivalent way to the C library 00037 // except for the prefix that has been changed from XX_ to XXCFI_ 00038 //------------------------------------------------------ 00039 00041 typedef enum 00042 { 00043 XLCFI_SAT_DEFAULT = 0, 00044 XLCFI_SAT_DEFAULT1 = 1, 00045 XLCFI_SAT_DEFAULT2 = 2, 00046 XLCFI_SAT_DEFAULT3 = 3, 00047 XLCFI_SAT_DEFAULT4 = 4, 00048 XLCFI_SAT_DEFAULT5 = 5, 00049 XLCFI_SAT_DEFAULT6 = 6, 00050 XLCFI_SAT_DEFAULT7 = 7, 00051 XLCFI_SAT_DEFAULT8 = 8, 00052 XLCFI_SAT_DEFAULT9 = 9, 00053 XLCFI_SAT_ERS1 = 11, 00054 XLCFI_SAT_ERS2 = 12, 00055 XLCFI_SAT_ENVISAT = 21, 00056 XLCFI_SAT_METOP1 = 31, 00057 XLCFI_SAT_METOP2 = 32, 00058 XLCFI_SAT_METOP3 = 33, 00059 XLCFI_SAT_CRYOSAT = 41, 00060 XLCFI_SAT_ADM = 51, 00061 XLCFI_SAT_GOCE = 61, 00062 XLCFI_SAT_SMOS = 71, 00063 XLCFI_SAT_TERRASAR = 81, 00064 XLCFI_SAT_EARTHCARE = 91, 00065 XLCFI_SAT_SWARM_A = 101, 00066 XLCFI_SAT_SWARM_B = 102, 00067 XLCFI_SAT_SWARM_C = 103, 00068 XLCFI_SAT_SENTINEL_1A = 110, 00069 XLCFI_SAT_SENTINEL_1B = 111, 00070 XLCFI_SAT_SENTINEL_2 = 112, 00071 XLCFI_SAT_SENTINEL_3 = 113, 00072 XLCFI_SAT_SEOSAT = 120, 00073 XLCFI_SAT_SENTINEL_1C = 125, 00074 XLCFI_SAT_SENTINEL_2A = 126, 00075 XLCFI_SAT_SENTINEL_2B = 127, 00076 XLCFI_SAT_SENTINEL_2C = 128, 00077 XLCFI_SAT_SENTINEL_3A = 129, 00078 XLCFI_SAT_SENTINEL_3B = 130, 00079 XLCFI_SAT_SENTINEL_3C = 131, 00080 XLCFI_SAT_JASON_CSA = 132, // AN-531 00081 XLCFI_SAT_JASON_CSB = 133, // AN-531 00082 XLCFI_SAT_METOP_SG_A1 = 134, // AN-530 00083 XLCFI_SAT_METOP_SG_A2 = 135, // AN-530 00084 XLCFI_SAT_METOP_SG_A3 = 136, // AN-530 00085 XLCFI_SAT_METOP_SG_B1 = 137, // AN-530 00086 XLCFI_SAT_METOP_SG_B2 = 138, // AN-530 00087 XLCFI_SAT_METOP_SG_B3 = 139, // AN-530 00088 XLCFI_SAT_SENTINEL_5P = 140, // AN-502 00089 XLCFI_SAT_BIOMASS = 141, // AN-601 00090 XLCFI_SAT_SENTINEL_5 = 142, // AN-639 00091 XLCFI_SAT_SAOCOM_CS = 143, // AN-640 00092 XLCFI_SAT_GENERIC = 200, 00093 // AN-353 00094 XLCFI_SAT_GENERIC_GEO = 300, 00095 XLCFI_SAT_MTG = 301, 00096 // END AN-353 00097 XLCFI_SAT_GENERIC_MEO = 400 // AN-550 00098 } SatIdEnum; 00099 00100 00102 typedef enum 00103 { 00104 XLCFI_TIMEMOD_AUTO = -2, 00105 XLCFI_TIMEMOD_USER = -1, 00106 XLCFI_TIMEMOD_NONE = 0, 00107 XLCFI_TIMEMOD_IERS_B_PREDICTED = 1, 00108 XLCFI_TIMEMOD_IERS_B_RESTITUTED, 00109 XLCFI_TIMEMOD_FOS_PREDICTED, 00110 XLCFI_TIMEMOD_FOS_RESTITUTED, 00111 XLCFI_TIMEMOD_DORIS_PRELIMINARY, 00112 XLCFI_TIMEMOD_DORIS_PRECISE, 00113 XLCFI_TIMEMOD_DORIS_NAVIGATOR, 00114 XLCFI_TIMEMOD_OSF, 00115 XLCFI_TIMEMOD_IERS_A_ONLY_PREDICTION, 00116 XLCFI_TIMEMOD_IERS_A_PREDICTION_AND_FORMULA, 00117 XLCFI_TIMEMOD_IERS_B_AND_A_ONLY_PREDICTION 00118 } TimeModelEnum; 00119 00120 00122 typedef enum 00123 { 00124 XLCFI_TIME_UNDEF = -1, 00125 XLCFI_TIME_TAI, 00126 XLCFI_TIME_UTC, 00127 XLCFI_TIME_UT1, 00128 XLCFI_TIME_GPS 00129 } XLTimeRefEnum; 00130 00131 00133 typedef enum 00134 { 00135 XLCFI_PROC = 0 00136 } TimeProcEnum; 00137 00139 typedef enum 00140 { 00141 XLCFI_TRANS_STD = 0, 00142 XLCFI_TRANS_ENVI_GS = 11, 00143 XLCFI_TRANS_CRYO_GS = 21, 00144 XLCFI_TRANS_CRYO_TM = 22, 00145 XLCFI_TRANS_CRYO_TM_SIRAL = 23, 00146 XLCFI_TRANS_SMOS_TM = 31, 00147 XLCFI_TRANS_GENERIC_GPS_SEC = 41, 00148 XLCFI_TRANS_GENERIC_GPS_WEEK = 42 00149 } TimeTransEnum; 00150 00151 00171 typedef enum 00172 { 00173 XLCFI_ASCII_UNDEF = -1, 00174 XLCFI_ASCII_STD = 11, 00175 XLCFI_ASCII_STD_REF = 12, 00176 XLCFI_ASCII_STD_MICROSEC = 13, 00177 XLCFI_ASCII_STD_REF_MICROSEC = 14, 00178 XLCFI_ASCII_COMPACT = 21, 00179 XLCFI_ASCII_COMPACT_REF = 22, 00180 XLCFI_ASCII_COMPACT_MICROSEC = 23, 00181 XLCFI_ASCII_COMPACT_REF_MICROSEC = 24, 00182 XLCFI_ASCII_ENVI = 31, 00183 XLCFI_ASCII_ENVI_REF = 32, 00184 XLCFI_ASCII_ENVI_MICROSEC = 33, 00185 XLCFI_ASCII_ENVI_REF_MICROSEC = 34, 00186 XLCFI_ASCII_CCSDSA = 41, 00187 XLCFI_ASCII_CCSDSA_REF = 42, 00188 XLCFI_ASCII_CCSDSA_MICROSEC = 43, 00189 XLCFI_ASCII_CCSDSA_REF_MICROSEC = 44, 00190 XLCFI_ASCII_CCSDSA_COMPACT = 51, 00191 XLCFI_ASCII_CCSDSA_COMPACT_REF = 52, 00192 XLCFI_ASCII_CCSDSA_COMPACT_MICROSEC = 53, 00193 XLCFI_ASCII_CCSDSA_COMPACT_REF_MICROSEC = 54 00194 } TimeAsciiEnum; 00195 00196 00198 typedef enum // Flag to indicate the grade of a derivative 00199 { 00200 XLCFI_NO_DER = 0, 00201 XLCFI_DER_1ST, 00202 XLCFI_DER_2ND, 00203 XLCFI_ITER_NO_DER, 00204 XLCFI_ITER_DER_1ST, 00205 XLCFI_NO_ITER_NO_DER, 00206 XLCFI_NO_ITER_DER_1ST 00207 } DerivEnum; 00208 00209 00211 typedef enum // It defines a coordinate system 00212 { 00213 XLCFI_CS_UNDEF = 0, 00214 XLCFI_CS_BM2000 = 1, 00215 XLCFI_CS_HM2000, 00216 XLCFI_CS_GM2000, 00217 XLCFI_CS_MOD, 00218 XLCFI_CS_TOD, 00219 XLCFI_CS_PEF, 00220 XLCFI_CS_EF, 00221 XLCFI_CS_LIF, 00222 XLCFI_CS_BM1950, 00223 XLCFI_CS_GALACTIC, 00224 XLCFI_CS_SAT_ACT_REF, 00225 XLCFI_CS_QUASI_MEAN_DATE, 00226 XLCFI_CS_PSE_TRUE_DATE, 00227 XLCFI_CS_TOPOCENTRIC, 00228 XLCFI_CS_SAT_REF, 00229 XLCFI_CS_SAT_REL_REF 00230 } CoordinateSystemEnum; // Updated for AN-509 00231 00233 typedef enum 00234 { 00235 XLCFI_CS_SAT_ORBITAL_REF = 0, 00236 XLCFI_CS_SAT_NOMINAL_ATT, 00237 XLCFI_CS_SAT_ATT, 00238 XLCFI_CS_INSTR_ATT 00239 } XLAttitudeFrameEnum; // AN-509 00240 00242 typedef enum 00243 { 00244 XLCFI_KEPLER_MEAN = 1, 00245 XLCFI_KEPLER_OSC 00246 } KeplerModeEnum; 00247 00249 typedef enum 00250 { 00251 XLCFI_MODE_FLAG_LOCATION = 0, 00252 XLCFI_MODE_FLAG_DIRECTION 00253 } ModeFlagEnum; 00254 00256 typedef enum 00257 { 00258 XLCFI_MERCURY = 1, 00259 XLCFI_VENUS, 00260 XLCFI_EM_BAR, 00261 XLCFI_MARS, 00262 XLCFI_JUPITER, 00263 XLCFI_SATURN, 00264 XLCFI_URANUS, 00265 XLCFI_NEPTUNE 00266 } PlanetEnum; 00267 00269 typedef enum 00270 { 00271 XLCFI_FK4 = 0, 00272 XLCFI_FK5 00273 } StarCatalogEnum; 00274 00275 00277 typedef enum 00278 { 00279 XLCFI_ANGLE_TYPE_TRUE_LAT_TOD = 1, 00280 XLCFI_ANGLE_TYPE_MEAN_LAT_TOD, 00281 XLCFI_ANGLE_TYPE_TRUE_LAT_GM2000, 00282 XLCFI_ANGLE_TYPE_TRUE_LAT_EF 00283 } AngleTypeEnum; 00284 00286 typedef enum 00287 { 00288 XLCFI_MODEL_DEFAULT, 00289 XLCFI_MODEL_CONFIG 00290 } ModelSetsEnum; 00291 00293 typedef enum 00294 { 00295 XLCFI_MODEL_TYPE_EARTH, 00296 XLCFI_MODEL_TYPE_SUN, 00297 XLCFI_MODEL_TYPE_MOON, 00298 XLCFI_MODEL_TYPE_PLANET, 00299 XLCFI_MODEL_TYPE_STAR, 00300 XLCFI_MODEL_TYPE_NUTATION, 00301 XLCFI_MODEL_TYPE_PRECESSION, 00302 XLCFI_MODEL_TYPE_CONSTANTS, 00303 XLCFI_MODEL_TYPE_LIGHT_PROPAGATION, //AN-553 00304 XLCFI_NUM_MODEL_TYPES_ENUM 00305 } ModelTypesEnum; 00306 00308 typedef enum 00309 { 00310 XLCFI_MODEL_EARTH_DEFAULT 00311 } ModelEarthEnum; 00312 00313 00315 typedef enum 00316 { 00317 XLCFI_MODEL_SUN_DEFAULT, 00318 XLCFI_MODEL_SUN_TRAVEL_TIME /* AN-517 */ 00319 } ModelSunEnum; 00320 00321 00323 typedef enum 00324 { 00325 XLCFI_MODEL_MOON_DEFAULT 00326 } ModelMoonEnum; 00327 00328 00330 typedef enum 00331 { 00332 XLCFI_MODEL_PLANETS_DEFAULT 00333 } ModelPlanetsEnum; 00334 00335 00337 typedef enum 00338 { 00339 XLCFI_MODEL_STAR_DEFAULT 00340 } ModelStarEnum; 00341 00342 00344 typedef enum 00345 { 00346 XLCFI_MODEL_NUTATION_DEFAULT 00347 } ModelNutationEnum; 00348 00349 00351 typedef enum 00352 { 00353 XLCFI_MODEL_PRECESSION_DEFAULT 00354 } ModelPrecessionEnum; 00355 00357 typedef enum 00358 { 00359 XLCFI_MODEL_CONSTANTS_DEFAULT 00360 } ModelConstantsEnum; 00361 00363 typedef enum 00364 { 00365 XLCFI_MODEL_LIGHT_PROPAGATION_DISABLED, 00366 XLCFI_MODEL_LIGHT_PROPAGATION_RECEIVER, 00367 XLCFI_MODEL_LIGHT_PROPAGATION_TRANSMITTER 00368 } ModelLightPropagationEnum; //AN-553 00369 00371 typedef enum 00372 { 00373 XLCFI_NO_BULLETIN = -1, 00374 XLCFI_BULLETIN_B, 00375 XLCFI_BULLETIN_A, 00376 XLCFI_BULLETIN_B_AND_A 00377 } XLBulletinTypeEnum; 00378 00380 typedef enum 00381 { 00382 XLCFI_FORMULA_ENABLED, 00383 XLCFI_FORMULA_DISABLED 00384 } IersFormulaFlagEnum; 00385 00386 /* AN-518 */ 00388 typedef enum 00389 { 00390 XLCFI_INTERPOL_SLERP 00391 } QuaternionsInterpolationAlgoEnum; 00392 00393 //------------------------------------------------------ 00394 // DATA STRUCTURES 00395 //------------------------------------------------------ 00396 00398 class XL_DECL TimeInterval 00399 { 00400 public: 00401 long timeRef; 00402 double startTime; 00403 double stopTime; 00404 00406 TimeInterval() 00407 {timeRef = -1, startTime = 0, stopTime = 0;}; 00408 00410 TimeInterval(long ref, double start, double stop) 00411 {timeRef = ref, startTime = start, stopTime = stop;}; 00412 }; 00413 00415 class XL_DECL OrbitInterval 00416 { 00417 public: 00418 long startOrbit; 00419 long stopOrbit; 00420 00422 OrbitInterval() {startOrbit = 0, stopOrbit = 0;}; 00423 00425 OrbitInterval(long start, long stop) 00426 {startOrbit = start, stopOrbit = stop;}; 00427 }; 00428 00430 class XL_DECL TimeData 00431 { 00432 public: 00433 double taiTime; 00434 double ut1Time; 00435 double tai_utc; 00436 double tai_ut1; 00437 double tai_gps; 00438 }; 00439 00441 class XL_DECL LeapSecondInfo 00442 { 00443 public: 00444 long flag; 00445 double utcTime; 00446 }; 00447 00449 class XL_DECL LaunchInertialFrameConfig 00450 { 00451 public: 00452 long enabledFlag; 00453 double longitude; 00454 double utcTime; 00455 00456 LaunchInertialFrameConfig() 00457 { 00458 utcTime = 0; /* AN-341 */ 00459 enabledFlag = 0L; /* AN-341 */ 00460 longitude = 0; /* AN-341 */ 00461 } 00462 }; 00463 00465 class XL_DECL TimeCorrelationData 00466 { 00467 public: 00468 long iersBulletinType; 00469 long iersFormulaFlag; 00470 long predictionFirstRecord; 00471 PolarMotionFormula polarMotionFormula; 00472 TimeCorrelationFormula timeCorrelationFormula; 00473 vector<TimeData> timeCorrVector; 00474 vector<PolarMotionParams> polarMotionParams; 00475 LeapSecondInfo leapSecond; 00476 LaunchInertialFrameConfig launchInertialFrameConfig; 00477 00479 TimeCorrelationData() 00480 { 00481 iersBulletinType = XLCFI_NO_BULLETIN; 00482 iersFormulaFlag = XLCFI_FORMULA_DISABLED; 00483 predictionFirstRecord = 0L; 00484 } 00485 00487 TimeCorrelationData(long bulType, long iersFormula, long predFirst, 00488 PolarMotionFormula &polarForm, TimeCorrelationFormula &timeForm, 00489 vector<TimeData> &timData, vector<PolarMotionParams> &polarData, 00490 LeapSecondInfo &leapInfo ) 00491 { 00492 iersBulletinType = bulType; 00493 iersFormulaFlag = iersFormula; 00494 predictionFirstRecord = predFirst; 00495 polarMotionFormula = polarForm; 00496 timeCorrelationFormula = timeForm; 00497 timeCorrVector = timData; 00498 polarMotionParams = polarData; 00499 leapSecond = leapInfo; 00500 } 00501 00503 TimeCorrelationData(long bulType, long iersFormula, long predFirst, 00504 PolarMotionFormula &polarForm, TimeCorrelationFormula &timeForm, 00505 vector<TimeData> &timData, vector<PolarMotionParams> &polarData, 00506 LeapSecondInfo &leapInfo, LaunchInertialFrameConfig &launchInertialFrameCfg ) 00507 { 00508 iersBulletinType = bulType; 00509 iersFormulaFlag = iersFormula; 00510 predictionFirstRecord = predFirst; 00511 polarMotionFormula = polarForm; 00512 timeCorrelationFormula = timeForm; 00513 timeCorrVector = timData; 00514 polarMotionParams = polarData; 00515 leapSecond = leapInfo; 00516 launchInertialFrameConfig = launchInertialFrameCfg; /* AN-341 */ 00517 } 00518 }; 00519 00521 class XL_DECL Kepler 00522 { 00523 public: 00524 long mode; 00525 long cs; 00526 double a; 00527 double e; 00528 double i; 00529 double ra; 00530 double w; 00531 double m; 00532 }; 00533 00535 class XL_DECL Topocentric 00536 { 00537 public: 00538 double azim; 00539 double elev; 00540 double range; 00541 double azimDer; 00542 double elevDer; 00543 double rangeDer; 00544 }; 00545 00547 class XL_DECL ModelData 00548 { 00549 public: 00550 long earthModel; 00551 long sunModel; 00552 long moonModel; 00553 long planetModel; 00554 long starModel; 00555 long nutationModel; 00556 long precessionModel; 00557 long constantsModel; 00558 long lightPropagationModel; 00559 00560 /* Earth shape and gravity */ 00561 double re; 00562 double mu; 00563 double j2; 00564 double j3; 00565 double j4; 00566 00567 double majorAxis; 00568 double minorAxis; 00569 double ecc; 00570 double flat; 00571 00572 /* Earth rotation */ 00573 double gcoef0; 00574 double gcoef1; 00575 double gcoef2; 00576 00577 double gcoefSim0; 00578 double gcoefSim1; 00579 double gcoefSim2; 00580 00581 /* constants */ 00582 double au; 00583 }; 00584 00586 class XL_DECL GeoidCalcOutputs 00587 { 00588 public: 00589 double undulation; 00590 }; // AN-425 00591 00593 class XL_DECL QuaternionsInterpolationCfg 00594 { 00595 public: 00596 QuaternionsInterpolationAlgoEnum algo; 00597 }; // AN-518 00598 00599 00600 00601 } // closing namespace 00602 00603 #endif