1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362
|
/******************************************************************************
*
* Project: MSG Native Reader
* Purpose: Basic types implementation.
* Author: Frans van den Bergh, fvdbergh@csir.co.za
*
******************************************************************************
* Copyright (c) 2005, Frans van den Bergh <fvdbergh@csir.co.za>
*
* SPDX-License-Identifier: MIT
****************************************************************************/
#ifndef MSG_BASIC_TYPES
#define MSG_BASIC_TYPES
#include <math.h>
namespace msg_native_format
{
const unsigned int SATELLITESTATUS_RECORD_LENGTH = 60134;
const unsigned int IMAGEACQUISITION_RECORD_LENGTH = 700;
const unsigned int CELESTIALEVENTS_RECORD_LENGTH =
326058; // should be 56258 according to ICD105 ??
const unsigned int IMAGEDESCRIPTION_RECORD_LENGTH = 101;
const unsigned int RADIOMETRICPROCESSING_RECORD_OFFSET =
SATELLITESTATUS_RECORD_LENGTH + IMAGEACQUISITION_RECORD_LENGTH +
CELESTIALEVENTS_RECORD_LENGTH + IMAGEDESCRIPTION_RECORD_LENGTH;
typedef int INTEGER; // 32 bits
typedef unsigned int UNSIGNED; // 32 bits
typedef unsigned short USHORT; // 16 bits
typedef unsigned char TIME_CDS_EXPANDED[10];
typedef unsigned char EBYTE; // enumerated byte
typedef unsigned char UBYTE; // enumerated byte
typedef float REAL;
typedef unsigned short int GP_SC_ID; // 16 bits, enumerated
typedef unsigned char GP_SC_CHAN_ID; // 8 bits, enumerated
typedef unsigned char GP_FAC_ID; // 8 bits, enumerated
typedef unsigned char GP_FAC_ENV; // 8 bits, enumerated
typedef unsigned int GP_SU_ID; // 32 bits, interval partition
typedef unsigned char GP_SVCE_TYPE; // 8 bits, enumerated
// all structures must be packed on byte boundaries
#pragma pack(1)
typedef struct
{
USHORT day;
UNSIGNED ms;
} TIME_CDS_SHORT;
typedef struct
{
unsigned char qualifier1;
unsigned char qualifier2;
unsigned char qualifier3;
unsigned char qualifier4;
} GP_CPU_ID;
typedef struct
{
char name[30];
char value[50];
} PH_DATA;
typedef struct
{
char name[30];
char size[16];
char address[16];
} PH_DATA_ID;
// 1.1.3.3 in MSG_native_format_1_5.doc
typedef struct
{
PH_DATA formatName;
PH_DATA formatDocumentName;
PH_DATA formatDocumentMajorVersion;
PH_DATA formatDocumentMinorVersion;
PH_DATA creationDateTime;
PH_DATA creatingCentre;
PH_DATA_ID dataSetIdentification[5];
UBYTE slack[1364]; // what is this? This is not in the documentation?
PH_DATA totalFileSize;
PH_DATA gort;
PH_DATA asti;
PH_DATA llos;
PH_DATA snit;
PH_DATA aiid;
PH_DATA ssbt;
PH_DATA ssst;
PH_DATA rrcc;
PH_DATA rrbt;
PH_DATA rrst;
PH_DATA pprc;
PH_DATA ppdt;
PH_DATA gplv;
PH_DATA apnm;
PH_DATA aarf;
PH_DATA uudt;
PH_DATA qqov;
PH_DATA udsp;
} MAIN_PROD_HEADER;
// 1.1.3.4
typedef struct
{
PH_DATA abid;
PH_DATA smod;
PH_DATA apxs;
PH_DATA avpa;
PH_DATA lscd;
PH_DATA lmap;
PH_DATA qdlc;
PH_DATA qdlp;
PH_DATA qqai;
PH_DATA selectedBandIds;
PH_DATA southLineSelectedRectangle;
PH_DATA northLineSelectedRectangle;
PH_DATA eastColumnSelectedRectangle;
PH_DATA westColumnSelectedRectangle;
} SECONDARY_PROD_HEADER;
// 1.1.3.7 and 1.1.3.8
typedef struct
{
UBYTE visirlineVersion;
GP_SC_ID satelliteId;
TIME_CDS_EXPANDED trueRepeatCycleStart;
INTEGER lineNumberInVisirGrid;
GP_SC_CHAN_ID channelId;
TIME_CDS_SHORT l10LineMeanAcquisitionTime;
EBYTE lineValidity;
EBYTE lineRadiometricQuality;
EBYTE lineGeometricQuality;
// actual line data not represented here
} SUB_VISIRLINE;
typedef struct
{
UBYTE headerVersionNo;
EBYTE packetType; // 2 = mission data
EBYTE subHeaderType; // 0 = no subheader, 1 = GP_PK_SH1, 2 = GP_PK_SH2
GP_FAC_ID sourceFacilityId;
GP_FAC_ENV sourceEnvId;
UBYTE sourceInstanceId;
GP_SU_ID sourceSUId;
GP_CPU_ID sourceCPUId;
GP_FAC_ID destFacilityId;
GP_FAC_ENV destEnvId;
USHORT sequenceCount;
UNSIGNED packetLength;
} GP_PK_HEADER;
typedef struct
{
UBYTE subHeaderVersionNo;
EBYTE checksumFlag;
UBYTE acknowledgement[4];
GP_SVCE_TYPE serviceType;
UBYTE serviceSubType;
TIME_CDS_SHORT packetTime;
GP_SC_ID spacecraftId;
} GP_PK_SH1;
// 7.2.5 in image data format
typedef struct
{
double cal_slope;
double cal_offset;
} CALIBRATION;
typedef struct
{
EBYTE radianceLinearisation[12];
EBYTE detectorEqualisation[12];
EBYTE onboardCalibrationResult[12];
EBYTE MPEFCalFeedback[12];
EBYTE MTFAdaption[12];
EBYTE straylightCorrectionFlag[12];
CALIBRATION level1_5ImageCalibration[12];
// rest of structure omitted for now
} RADIOMETRIC_PROCESSING_RECORD;
// 7.2.4
typedef struct
{
INTEGER numberOfLines;
INTEGER numberOfColumns;
REAL lineDirGridStep;
REAL columnDirGridStep;
EBYTE gridOrigin;
} REFERENCEGRID_VISIR;
typedef struct
{
INTEGER southernLinePlanned;
INTEGER northernLinePlanned;
INTEGER easternColumnPlanned;
INTEGER westernColumnPlanned;
} PLANNED_COVERAGE_VISIR;
typedef struct
{
INTEGER lowerSouthLinePlanned;
INTEGER lowerNorthLinePlanned;
INTEGER lowerEastColumnPlanned;
INTEGER lowerWestColumnPlanned;
INTEGER upperSouthLinePlanned;
INTEGER upperNorthLinePlanned;
INTEGER upperEastColumnPlanned;
INTEGER upperWestColumnPlanned;
} PLANNED_COVERAGE_HRV;
typedef struct
{
EBYTE typeOfProjection;
REAL longitudeOfSSP;
REFERENCEGRID_VISIR referencegrid_visir;
REFERENCEGRID_VISIR referencegrid_hrv;
PLANNED_COVERAGE_VISIR plannedCoverage_visir;
PLANNED_COVERAGE_HRV plannedCoverage_hrv;
// rest of record omitted, for now
} IMAGE_DESCRIPTION_RECORD;
typedef struct
{
UBYTE nominalImageScanning;
UBYTE reducedScan;
TIME_CDS_SHORT forwardScanStart;
TIME_CDS_SHORT forwardScanEnd;
} ACTUAL_SCANNING_SUMMARY_RECORD;
typedef struct
{
UBYTE nominalBehavior;
UBYTE radScanIrregularity;
UBYTE radStoppage;
UBYTE repeatCycleNotCompleted;
UBYTE gainChangeTookPlace;
UBYTE decontaminationTookPlace;
UBYTE noBBCalibrationAchieved;
UBYTE incorrectTemperature;
UBYTE invalidBBData;
UBYTE invalidAuxOrHKTMData;
UBYTE refocusingMechanismActuated;
UBYTE mirrorBackToReferencePos;
} RADIOMETER_BEHAVIOR_RECORD;
typedef struct
{
UNSIGNED plannedNumberOfL10Lines[12];
UNSIGNED numberOfMissingL10Lines[12];
UNSIGNED numberOfCorruptedL10Lines[12];
UNSIGNED numberOfReplacedL10Lines[12];
} RECEPTION_SUMMARY_STATS_RECORD;
typedef struct
{
UBYTE nominalImage;
UBYTE nonNominalBecauseIncomplete;
UBYTE nonNominalRadiometricQuality;
UBYTE nonNominalGeometricQuality;
UBYTE nonNominalTimeliness;
UBYTE incompleteL15;
} L15_IMAGE_VALIDITY_RECORD;
typedef struct
{
INTEGER southernLineActual;
INTEGER northernLineActual;
INTEGER easternColumnActual;
INTEGER westernColumnActual;
} ACTUAL_L15_COVERAGE_VISIR_RECORD;
typedef struct
{
INTEGER lowerSouthLineActual;
INTEGER lowerNorthLineActual;
INTEGER lowerEastColumnActual;
INTEGER lowerWestColumnActual;
INTEGER upperSouthLineActual;
INTEGER upperNorthLineActual;
INTEGER upperEastColumnActual;
INTEGER upperWestColumnActual;
} ACTUAL_L15_COVERAGE_HRV_RECORD;
typedef struct
{
GP_SC_ID satelliteId;
ACTUAL_SCANNING_SUMMARY_RECORD actualScanningSummary;
RADIOMETER_BEHAVIOR_RECORD radiometerBehavior;
RECEPTION_SUMMARY_STATS_RECORD receptionSummaryStats;
L15_IMAGE_VALIDITY_RECORD l15ImageValidity[12];
ACTUAL_L15_COVERAGE_VISIR_RECORD actualL15CoverageVisir;
ACTUAL_L15_COVERAGE_HRV_RECORD actualL15CoverageHrv;
} IMAGE_PRODUCTION_STATS_RECORD;
typedef struct
{
UBYTE trailerHeaderVersion;
IMAGE_PRODUCTION_STATS_RECORD imageProductionStats;
// skip the rest - only after actual line/col values
} TRAILER;
// disable byte-packing
#pragma pack()
// endian conversion routines
void to_native(GP_PK_HEADER &h);
void to_native(GP_PK_SH1 &h);
void to_native(SUB_VISIRLINE &v);
void to_native(RADIOMETRIC_PROCESSING_RECORD &r);
void to_native(IMAGE_DESCRIPTION_RECORD &r);
void to_native(ACTUAL_L15_COVERAGE_VISIR_RECORD &r);
void to_native(ACTUAL_L15_COVERAGE_HRV_RECORD &r);
// utility function, alters string fields permanently
void to_string(PH_DATA &d);
// unit tests on structures, returns true on success
// bool perform_type_size_check(void);
class Conversions
{
public:
static void convert_pixel_to_geo(double line, double column,
double &longitude, double &latitude);
static void convert_geo_to_pixel(double longitude, double latitude,
unsigned int &line, unsigned int &column);
static void compute_pixel_xyz(double line, double column, double &x,
double &y, double &z);
static double compute_pixel_area_sqkm(double line, double column);
static const double altitude; // from origin
static const double req; // earth equatorial radius
static const double rpol; // earth polar radius
static const double
dtp2; // square of the distance to the equatorial tangent point
static const double oblate; // oblateness of earth
static const double eccentricity2; // eccentricity squared
static const double ratio2; // (rpol/req)^2
static const double deg_to_rad;
static const double rad_to_deg;
static const double step; // pixel / line step in degrees
static const double nlines; // number of lines in an image
static const int CFAC; // Column scale factor
static const int LFAC; // Line scale factor
static const int COFF; // Column offset
static const int LOFF; // Line offset
static const double CFAC_scaled; // divided by 2^16
static const double LFAC_scaled;
};
} // namespace msg_native_format
#endif
|