Welcome >  Operation Center (OC) >  Consolidated Laser Ranging Data Format (CRD) - Version 2.0

Consolidated Laser Ranging Data Format (CRD) - Version 2.0

The ILRS Operation Center (OC) checks the following fields of the Consolidated Laser Ranging Data Format (CRD) for Normal Points and Full-Rate data.

General Checks

→ Unknown record (Note: Empty lines will also lead to this error.)
→ File is empty
→ No H8 record found in a single/multi pass file.
→ No 11 record found. (only NPT)
→ No 10 record found. (only FRD)
→ More than one satellite found!
→ Dataset contains non-ascii characters

H1 - Format Header

1 - 2 A2 Record Type (='H1' or 'h1')
A4 'CRD' or 'crd' (Consolidated Ranging Data format) → not in [ 'CRD', 'crd' ]
I2 Format Version (currently = 1) → in [ 0 ]
→ not in [ 1 ]
I4 Year of file production → not in [ 1950 , ... , 2100 ]
I2 Month of file production → not in [ 1 , ... , 12 ]
I2 Day of file production → not in [ 1 , ... , 31 ]
I2 Hour of file production → not in [ 1 , ... , 23 ]
Additional Checks
→ There are not 7 parameters in record H1
→ Date of file production must be valid
→ No H1 record found in a single/multi pass file
→ More than one H1 record found in a single pass file
→ H1 record is not allowed within session between H4 and H8 record

H2 - Station Header

1 - 2 A2 Record Type (='H2' or 'h2')
A10 Station name from official list → Station name does not match official station name
I4 Crustal Dynamics Project Pad Identifier    
I2 Crustal Dynamics Project 2-digit system number    
I2 Crustal Dynamics Project 2-digit    
I2 Station Epoch Time Scale → not in [ 3 , 4 , 7 ]
I2 Station network New in v2.0 → not in [ `na`, `ILRS`, `EUROLAS`, `NASA`, `WPLTN`]
Additional Checks
→ There are not 7 parameters in record H2
→ SOD number ( Crustal Dynamics Project Pad Identifier, Crustal Dynamics Project 2-digit system number and Crustal Dynamics Project 2-digit ) not found in offical list
→ No H2 record found in a single/multi pass file
→ More than one H2 record found in a single pass file
→ SOD and station name are not from the same station
→ H2 record is not allowed within session between H4 and H8 record

H3 - Target Header

1 - 2 A2 Record Type (='H3' or 'h3')
A10 Target name from official list (e.g. ajisai,lageos1) → Target name not found in official list
      → Target name should be in lowercase
I8 ILRS satellite identifier (based on COSPAR ID) → ILRS satellite identifier not found in official list
      → ILRS satellite does not fit to satellite name
I4 SIC (Satellite Identification Code) → SIC not found in official list
      → SIC does not fit to satellite name
I8 NORAD ID → NORAD id not found in official list (na is allowed for n.a.)
      → NORAD id does not fit to satellite name
I1 Spacecraft epoch time scale (transponder only) → not in [ 0, 1, 2 ]
I1 Target class New in v2.0 → not in [ 0, 1, 2, 3, 4, 5]
I2 Target location/dynamics New in v2.0 → not in [ na, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
Additional Checks
→ There are not 8 parameters in record H3
→ More than one H3 record found in a single pass file
→ SOD and station name are not from the same station
→ H3 record is not allowed within session between H4 and H8 record
→ GLONASS satellites are not processed because auf Russian sanctions since 2022-03-04

H4 - Session (Pass) Header

1 - 2 A2 Record Type (='H4' or 'h4')
I2 Data type → not in [ 0, 1, 2 ]
      → Data type != 1 for normal points
      → Data type != 0 for full-rate data
I4 Starting year → not in [ 1950, ..., 2100 ]
I2 Starting month → not in [ 1, ..., 12 ]
I2 Starting day → not in [ 1, ..., 31 ]
I2 Starting hour → not in [ 0, ..., 23 ]
I2 Starting minute → not in [ 0, ..., 59 ]
I2 Starting second → not in [ 0, ..., 59 ]
I4 Ending year → not in [ na, 1950, ..., 2100 ]
I2 Ending month → not in [ na, 1, ..., 12 ]
I2 Ending day → not in [ na, 1, ..., 31 ]
I2 Ending hour → not in [ na, 0, ..., 23 ]
I2 Ending minute → not in [ na, 0, ..., 59 ]
I2 Ending second → not in [ na, 0, ..., 59 ]
I2 A release flag to indicate the data release → not in [ 0, ..., 99 ]
I1 Tropospheric refraction correction applied indicator → not in [ 0, 1 ]
→ is set but no record 12 was found
(File production data in H1 >= 2015-01-01)
→ is set but no record 12 was found
(File production data in H1 < 2015-01-01)
I1 Center of mass correction applied indicator → not in [ 0, 1 ]
→ is set but no record 12 was found
(File production data in H1 >= 2015-01-01)
→ is set but no record 12 was found
(File production data in H1 < 2015-01-01)
I1 Receive amplitude correction applied indicator → not in [ 0, 1 ]
I1 Station system delay applied indicator → not in [ 0, 1 ]
I1 Spacecraft system delay appied indicator → not in [ 0, 1 ]
I1 Range type indicator → not in [ 0, 1, 2, 3, 4 ]
I1 Data quality alert indicator → not in [ 0, 1, 2 ]
Additional Checks
→ There are not 22 parameters in record H4
→ Starting date is not valid
→ Ending date is not valid
→ No H4 record found in a single/multi pass file
→ More than one H4 record found in a single pass file
→ H4 record is not allowed within session between H4 and H8 record
→ Difference between starting date and ending date > 1 day
→ Starting date is greater than ending date
→ File production date in H1 is smaller than the starting date

H5 - Prediction Header New in v2.0

1 - 2 A2 Record Type (='H5' or 'h5') New in v2.0
I2 Prediction Type New in v2.0 → not in [ 0, 1, 2 ]
I2 Year of Century from CPF/TLE New in v2.0 → not in [ 0, ..., 99 ]
A6/A12 Date and Time New in v2.0 → Invalid date and time of CPF [MMDDHH]
A3 Prediction Provider New in v2.0 → Invalid prediction provider of CPF [PPP]
I5 Sequence number New in v2.0 → Invalid sequence number of CPF
→ Invalid sequence number of TLE
Additional Checks
→ There are not 6 parameters in record H5

H8 - End of Session (Pass) Footer

1 - 2 A2 Record Type (='H8' or 'h8')
Additional Checks
→ No H8 record found in a single/multi pass file
→ More than one H8 record found in a single pass file
→ Sum of H4 an H8 must be one for a single pass file
→ Sum of H4 an H8 must be equal for a multi pass file
→ H8 record is not allowed outside of session only between H4 and H8 record

H9 - End of File Footer

1 - 2 A2 Record Type (='H9' or 'h9')
Additional Checks
→ H9 record is not allowed within session between H4 and H8 record
→ H9 must be after H8 record
→ H9 record must be at the end of file
→ No H9 record found
→ More than one H9 record found

C0 - System Configuration Record

1 - 2 A2 Record Type (='C0' or 'c0')
I1 Detail type (='0') → not in [ 0 ]
F10.3 Transmit wavelength (ns) → not in [ 1064, 532, 266 ] (rounded int)
A4 System configuration id (unique within the file)    
A4 component A configuration id (e.g. laser configuration id)    
A4 component B configuration id (e.g. detector configuration id)    
A4 component C configuration id (e.g. local timeing system configuration id)    
A4 component D configuration id (e.g. transponder configuration id)    
A4 component E configuration id (e.g. software configuration id) New in v2.0    
A4 component F configuration id (e.g. meteorologial configuration id) New in v2.0    
A4 component G configuration id (e.g. calibration target configuration id) New in v2.0    
Additional Checks
→ The record length must be 4 characters
→ There must be at least one C0-record in file

C1 - Laser Configuration Record

1 - 2 A2 Record Type (='C1' or 'c1')
I1 Detail type (='0') → not in [ 0 ]
A4 Laser configuration id (unique within the file) → not found in record C0
A4 Laser type (e.g. Nd-Yag)    
F10.2 Primary wavelength (nm) → not in [ na, > 0 ]
F10.2 Nominal Fire rate → not in [ na, 0, ..., 10000 ]
F10.2 Pulse energy → not in [ na, 0, ..., 1000 ]
F6.1 Pulse width → not in [ na, 0, ..., 10000 ]
F5.2 Beam divergence → not in [ na, 0, ..., 400 ]
I4 Number of pulses in outgoing semi-train → not in [ na, 0, ..., 1000 ]
Additional Checks
→ There must be 10 parameters in record

C2 - Detector Configuration Record

1 - 2 A2 Record Type (='C2' or 'c2')
I1 Detail type (='0') → not in [ 0 ]
A4 Detector configuration id (unque within the file) → not found in record C0
A10 Detector type    
F10.3 Applicable wavelength (nm) → not in [ na, > 0 ]
F6.2 Quantum efficiency → not in [ na, 0, ..., 100 ]
F5.1 Applied voltage → not in [ na, -1e4, ..., 1e4 ]
F5.1 Dark count → not in [ na, 0, ..., 1e3 ]
A10 Output pulse type    
F5.1 Output pulse width → not in [ na, 0, ..., 1e6 ]
F5.2 Spectral filter (nm) → not in [ na, 0, ..., 1064 ]
F5.1 % Transmission of spectral filter → not in [ na, 0, ..., 100 ]
F5.1 Spectral filter (arcsec) → not in [ na, 0, ..., 3600 ]
A10 External signal progressing    
F6.1 Amplifier Gain New in v2.0 → not in [ na, > 0 ]
F6.1 Amplifier Bandwidth (kHz) New in v2.0 → not in [ na, > 0 ]
I2 Amplifier in Use New in v2.0 → not in [ na, 0, 1 ]
Additional Checks
→ There must be 17 parameters in record

C3 - Timing System Configuration Record

1 - 2 A2 Record Type (='C3' or 'c3')
I1 Detail type (='0') → not in [ 0 ]
A4 Timing configuration id (unque within the file) → not found in record C0
A20 Time source    
A20 Frequency source    
A20 Timer    
A20 Timer Serial Number    
F6.3 Epoch delay correction → not in [ na, -5e5, ..., 5e5 ]
Additional Checks
→ There must be 8 parameters in record

C4 - Transponder (Clock) Configuration Record

1 - 2 A2 Record Type (='C4' or 'c4')
I1 Detail type (='0') → not in [ 0 ]
A4 Transponder configuration id (unque within the file) → not found in record C0
F20.3 Estimated station UTC offset → not in [ na, -1000, ..., 1000 ]
F11.2 Estimated station oscillator drift → not in [ na, -1000, ..., 1000 ]
F20.3 Estimated transponder UTC offset → not in [ na, -100, ..., 100 ]
F11.2 Estimated transponder oscillator UTC drift → not in [ na, -1e8, ..., 1e8 ]
F20.12 Transponder clock reference time → not in [ na, -100, ..., 100 ]
I1 Station clock offset and drift applied indicator → not in [ 0, 1, 2, 3 ]
I1 Spacecraft clock offset and drift applied indicator → not in [ 0, 1, 2, 3 ]
I1 Spacecraft time simplified → not in [ 0, 1 ]
Additional Checks
→ There must be 11 parameters in record

C5 - Software Configuration Record New in v2.0

1 - 2 A2 Record Type (='C5' or 'c5') New in v2.0
I1 Detail type (='0') New in v2.0 → not in [ 0 ]
A4 Software configuration id (unque within the file) New in v2.0 → not found in record C0
A20 Tracking Software in measurement path New in v2.0    
A40 Tracking Software Version(s) New in v2.0    
A20 Processing Software in measurement path New in v2.0    
A40 Processing Software Version(s) New in v2.0    
Additional Checks
→ There must be 7 parameters in record

C6 - Meteorological Instumentation Configuration Record New in v2.0

1 - 2 A2 Record Type (='C6' or 'c6') New in v2.0
I1 Detail Type (='0') New in v2.0 → not in [ 0 ]
A4 Meteorological Configuration ID (unque within the file) New in v2.0 → not found in record C0
A10 Pressure Sensor Manufacturer New in v2.0    
A10 Pressure Sensor Model New in v2.0    
A10 Pressure Sensor Serial Number New in v2.0    
A10 Temperatur Sensor Manufacturer New in v2.0    
A10 Temperatur Sensor Model New in v2.0    
A10 Temperatur Sensor Serial Number New in v2.0    
A10 Humidity Sensor Manufacturer New in v2.0    
A10 Humidity Sensor Model New in v2.0    
A10 Humidity Sensor Serial Number New in v2.0    
Additional Checks
→ There must be 12 parameters in record

C7 - Calibration Configuration Record New in v2.0

1 - 2 A2 Record Type (='C7' or 'c7') New in v2.0
I1 Detail Type (='0') New in v2.0 → not in [ 0 ]
A4 Calibration Configuration ID (unque within the file) New in v2.0 → not found in record C0
A10 Target Name or ID New in v2.0    
A10 Surveyed target distance New in v2.0    
A10 Survey error (mm) New in v2.0    
A10 Sum of all constant delays (electronic, geometric, optical) that are not included in the time of flight measurements (m, one way) New in v2.01    
A10 Pulse Energy (mJ): record when this field changed by 10% New in v2.0    
A10 Processing Software Name New in v2.0    
A10 Processing Software Version New in v2.0    
Additional Checks
→ There must be 10 parameters in record

00 - Comment Record

1 - 2 A2 Record Type (='00')
A80 Free format ASCII comments → more than 80 characters in line

10 - Range Record (Full rate, Sampled Engineering/Quicklook)

1 - 2 A2 Record Type (='10')
F18.12 Seconds of day → not in [ 0, ..., 86400 [
F18.12 Time of flight → not in [ 0, ..., 3 ]
A4 System configuration id → not found in record C0
I1 Epoch event → not in [ 0, 1, 2, 3, 4, 5, 6 ]
I1 Filter flag → not in [ 0, 1, 2 ]
I1 Detector channel → not in [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
I1 Stop number → not in [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
I5 Receive amplitude → not in [ na, > 0 ]
I5 Transmit amplitude New in v2.0 → not in [ na, > 0 ]
Additional Checks
→ There must be 10 parameters in record
→ Record 10 is not allowed in NPT files

11 - Range Record (Normal Point)

1 - 2 A2 Record Type (='11')
F18.12 Seconds of day → not in [ 0, ..., 86400 [
F18.12 Time of flight → not in [ 0, ..., 3 ]
A4 System configuration id → not found in record C0
I1 Epoch event → not in [ 0, 1, 2, 3, 4, 5, 6 ]
F6.1 Normal point window length → not in [ 0, ..., 300 ] (not applied for LLR)
I6 Number of raw ranges → not in [ na, 0, ..., 100000 ]
F9.1 Bin RMS from the mean of raw accepted time of flight → not in [ na, 0, ..., 6667 ]
F7.3 Bin skew from the mean of raw accepted time of flight → not in [ na, -2, ..., 2 ]
F7.3 Bin kurtosis from the mean of raw accepted time of flight → not in [ na, -2, ..., 3 ]
F9.1 Bin peak → not in [ na, -1000, ..., 1000 ]
F9.1 Return rate (%) → not in [ na, 0, ..., 100 ]
I1 Detector channel → not in [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
F5.1 Signal to Noise Ratio New in v2.0 → not in [ na, > 0 ]
Additional Checks
→ There must be 14 parameters in record
→ Record 11 is not allowed in FRD files

12 - Range Supplement Record

1 - 2 A2 Record Type (='12')
F18.12 Seconds of day → not in [ 0, ..., 86400 [
A4 System configuration id → not found in record C0
F6.1 Tropospheric refraction correction → not in [ na, 0, ..., 10000 ]
F6.4 Target center of mass correction → not in [ na, 0, ..., 100 ]
F5.2 Neutral density → not in [ na, 0, ..., 100 ]
F8.4 Time bias applied → not in [ na, -10, ..., 10 ]
F20.15 Range Rate New in v2.0    
Additional Checks
→ There must be 8 parameters in record

20 - Meteorological Record

1 - 2 A2 Record Type (='20')
F18.12 Seconds of day → not in [ 0, ..., 86400 [
F7.2 Surface pressure → not in [ na, 700, ..., 1100 ] or variable
→ no station height available at EDC
F6.2 Surface temperature in degrees → not in [ na, 240, ..., 330 ]
F4.0 Relative humidity at surface in % → not in [ na, 0, ..., 100 ]
I1 Origin of values → not in [ na, 0, 1 ]
Additional Checks
→ There must be 6 parameters in record
→ There must at least one meterolgical record

21 - Meteorological Supplement Record

1 - 2 A2 Record Type (='21')
F18.12 Seconds of day → not in [ 0, ..., 86400 [
F5.1 Wind speed → not in [ na, 0, ..., 33 ]
F5.1 Wind direction → not in [ na, -180 , ..., 360 ]
A5 Weather conditions (two-digit SYNOP/WMO "present weather" code, or "rain", "snow", "fog", "mist", "clear", "na", etc.)
--- Changed field in v2.0 ---
   
I3 Visibility → not in [ na, 0, ..., 100 ]
F4.2 Sky clarity → not in [ na, 0, ..., 100 ]
I2 Atmospheric seeing → not in [ na, 0, ..., 100 ]
I2 Cloud cover (%) → not in [ na, 0, ..., 100 ]
F6.2 Sky Temerature (K) New in v2.0 → not in [ na, 220, ..., 300 ]
Additional Checks
→ There must be 10 parameters in record

30 - Pointing Angle Record

1 - 2 A2 Record Type (='30')
F18.12 Seconds of day → not in [ 0, ..., 86400 [
F8.4 Azimuth in degree → not in [ na, -180, ..., 360 ]
F8.4 Elevation in degree → not in [ na, 0, ..., 90 ]
I1 Direction flag → not in [ na, 0, 1, 2 ]
I1 Angle origin indicator → not in [ na, 0, 1, 2, 3 ]
I1 Refraction corrected → not in [ na, 0, 1 ]
F10.7 Azimuth Rate [deg/s] New in v2.0 → not in [ na, -20, ..., 20 ]
F10.7 Elevation Rate [deg/s] New in v2.0 → not in [ na, -20, ..., 20 ]
Additional Checks
→ There must be 9 parameters in record

40 - Calibration Record

1 - 2 A2 Record Type (='40')
F18.12 Seconds of day → not in [ 0, ..., 86400 ]
I1 Type of data → not in [ 0, 1, 2, 3, 4, 5 ]
A4 System configuration id → not found in record C0
I8 Number of data points recorded → not in [ na, 0, ..., 1e8 ]
I8 Number of data points used → not in [ na, 0, ..., 1e8 ]
F7.3 One way target distance → not in [ na, 0, ..., 1e4 ]
F10.1 Calibration system delay → not in [ na, -1e5, ..., 1e6 ]
F8.1 Calibration delay shift → not in [ na, -6667, ..., 6667 ]
F6.1 Root mean square of raw system delay → not in [ na, 0, ..., 667 ]
F7.3 Skew of raw system delay → not in [ na, -2, ..., 2 ]
F7.3 Kurtosis of raw system delay → not in [ na, -2, ..., 3 ]
F6.1 System delay peak - mean value → not in [ na, -1000, ..., 1000 ]
I1 Calibration type indicator → not in [ 0, 1, 2, 3, 4, 5 ]
I1 Calibration shift type indicator → not in [ 0, 1, 2, 3, 4 ]
I1 Detector channel → not in [ 0, ..., 9 ]
I1 Calibration Span New in v2.0 → not in [ 0, 1, 2, 3, 4 ]
F5.1 Return Rate New in v2.0 → not in [ na, 0, ..., 100 ]
Additional Checks
→ There must be 18 parameters in record

41 - Calibration Detail Record New in v2.0

1 - 2 A2 Record Type (='41')
F18.12 Seconds of day → not in [ 0, ..., 86400 ]
Type of data → not in [ 0, 1, 2, 3, 4, 5 ]
A4 System configuration id → not found in record C0
I8 Number of data points recorded → not in [ na, 0, ..., 1e8 ]
I8 Number of data points used → not in [ na, 0, ..., 1e8 ]
F7.3 One way target distance → not in [ na, 0, ..., 1e4]
F10.1 Calibration system delay → not in [ na, -1e5, ..., 1e6 ]
F8.1 Calibration delay shift → not in [ na, -6667, ..., 6667]
F6.1 Root mean square of raw system delay → not in [ na, 0, ..., 667 ]
F7.3 Skew of raw system delay → not in [ na, -2, ..., 2 ]
F7.3 Kurtosis of raw system delay → not in [ na, -2, ..., 3 ]
F6.1 System delay peak - mean value → not in [ na, -1000, ..., 1000 ]
I1 Calibration type indicator → not in [ 0, 1, 2, 3, 4, 5 ]
I1 Calibration shift type indicator → not in [ 0, 1, 2, 3, 4 ]
I1 Detector channel → not in [ 0, ..., 9 ]
I1 Calibration Span → not in [ 0, 1, 2, 4, 5 ]
F5.1 Return Rate → not in [ na, 0, ..., 100 ]
Additional Checks
→ There must be 18 parameters in record

42 - Calibration "Shot" Record New in v2.0

1 - 2 A2 Record Type (='42')
F18.12 Seconds of day → not in [ 0, ..., 86400 ]
F18.12 Time of flight in seconds (two way)
A4 System configuration id
A4 Calibration configuration ID (unique within the file)
F7.3 Sum of all time or point angle varying electronic and geometric terms needed to compute calibration (m, one way); must be present to compute system delay
I1 Type of data → not in [ 0, 1, 2, 3, 4, 5 ]
I1 Calibration Type Indicator → not in [ 0, 1, 2, 3, 4, 5, 6 ]
I1 Filter Flag → not in [ 0, 1, 2 ]
I1 Detector channel → not in [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
I1 Stop Number → not in [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
I1 Calibration Span → not in [ 0, 1, 2, 3, 4, 5 ]
I5 Receive Amplitude
I5 Transmit Amplitude
Additional Checks
→ There must be 15 parameters in record

50 - Session (Pass) Statistics Record

1 - 2 A2 Record Type (='50')
A4 System configuration id → not found in record C0
F6.1 Session RMS from the mean of raw → not in [ na, 1e-3, ..., 667 ]
F7.3 Session skewness from the mean of raw → not in [ na, -2, ..., 2 ]
F7.3 Session kurtosis from the mean of raw → not in [ na, -2, ..., 5 ]
F6.1 Session peak → not in [ na, -1000, ..., 1000 ]
I1 Data quality assessment indicator → not in [ 0, 1, 2, 3, 4, 5 ]
Additional Checks
→ There must be 7 parameters in record
→ This record must exist if 11 record(s) exist

60 - Compatibility Record

1 - 2 A2 Record Type (='60')
A4 System configuration id → not found in record C0
I1 System change indicator → not in [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
I1 System configuration indicator → not in [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
Additional Checks
→ There must be 4 parameters in record

90 - User Defined Record

1 - 2 A2 Record Type (='9x')

Find more topics on the central web site of the Technical University of Munich: www.tum.de