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

Consolidated Laser Ranging Data Format (CRD) - Version 1.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
→ Satellite orbit does not fit to CPFs orbit (Possible reason: Mislabled pass)
→ No CPFs found for calculating orbit fit
→ No XYZ station coordiantes found for calculating orbit fit
→ No NPT/FRD data found for calculating orbit fit

H1 - Format Header

1 - 2 A2 Record Type (='H1' or 'h1')
4 - 6 A4 'CRD' or 'crd' (Consolidated Ranging Data format) → not in [ 'CRD', 'crd' ]
8 - 9 I2 Format Version (currently = 1) → in [ 0 ]
→ not in [ 1 ]
11 - 14 I4 Year of file production → not in [ 1950 , ... , 2100 ]
16 - 17 I2 Month of file production → not in [ 1 , ... , 12 ]
19 - 20 I2 Day of file production → not in [ 1 , ... , 31 ]
22 - 23 I2 Hour of file production → not in [ 1 , ... , 23 ]
Additional Checks
→ Wrong pattern of record (spaces at wrong positions) or record length not exact 23 characters
→ 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')
4 - 13 A10 Station name from official list → Station name does not match official station name
15 - 18 I4 Crustal Dynamics Project Pad Identifier    
20 - 21 I2 Crustal Dynamics Project 2-digit system number    
23 - 24 I2 Crustal Dynamics Project 2-digit    
26 - 27 I2 Station Epoch Time Scale → not in [ 0 , ... , 99 ]
→ not in [ 3 , 4 , 7 ]
Additional Checks
→ Wrong pattern of record (spaces at wrong positions) or record length not exact 27 characters
→ 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')
4 - 13 A10 Target name from official list (e.g. ajisai,lageos1) → Target name not found in official list
      → Target name should be in lowercase
15 - 22 I8 ILRS satellite identifier (based on COSPAR ID) → ILRS satellite identifier not found in official list
      → ILRS satellite does not fit to satellite name
25 - 27 I4 SIC (Satellite Identification Code) → SIC not found in official list
      → SIC does not fit to satellite name
29 - 36 I8 NORAD ID → NORAD id not found in official list (na is allowed for n.a.)
      → NORAD id does not fit to satellite name
38 I1 Spacecraft epoch time scale (transponder only) → not in [ 0, 1, 2 ]
40 I1 Target type → not in [ 1, 2, 3, 4 ]
Additional Checks
→ Wrong pattern of record (spaces at wrong positions) or record length not exact 40 characters
→ 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')
4 - 5 I2 Data type → not in [ 0, 1, 2 ]
      → Data type != 1 for normal points
      → Data type != 0 for full-rate data
7 - 10 I4 Starting year → not in [ 1950, ..., 2100 ]
12 - 13 I2 Starting month → not in [ 1, ..., 12 ]
15 - 16 I2 Starting day → not in [ 1, ..., 31 ]
18 - 19 I2 Starting hour → not in [ 0, ..., 23 ]
21 - 22 I2 Starting minute → not in [ 0, ..., 59 ]
24 - 25 I2 Starting second → not in [ 0, ..., 59 ]
27 - 30 I4 Ending year → in [ -1 ]
→ not in [ 1950, ..., 2100 ]
32 - 33 I2 Ending month → in [ -1 ]
→ not in [ 1, ..., 12 ]
35 - 36 I2 Ending day → in [ -1 ]
→ not in [ 1, ..., 31 ]
38 - 39 I2 Ending hour → in [ -1 ]
→ not in [ 0, ..., 23 ]
41 - 42 I2 Ending minute → in [ -1 ]
→ not in [ 0, ..., 59 ]
44 - 45 I2 Ending second → in [ -1 ]
→ not in [ 0, ..., 59 ]
47 - 48 I2 A release flag to indicate the data release → not in [ 0, ..., 99 ]
50 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)
52 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)
54 I1 Receive amplitude correction applied indicator → not in [ 0, 1 ]
56 I1 Station system delay applied indicator → not in [ 0, 1 ]
58 I1 Spacecraft system delay appied indicator → not in [ 0, 1 ]
60 I1 Range type indicator → not in [ 0, 1, 2, 3, 4 ]
62 I1 Data quality alert indicator → not in [ 0, 1, 2 ]
Additional Checks
→ Wrong pattern of record (spaces at wrong positions) or record length not exact 62 characters
→ 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

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)    
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 [ > 0 ] ( -1: n.a.)
F10.2 Nominal Fire rate → not in [ 0, ..., 10000 ] ( -1: n.a.)
F10.2 Pulse energy → not in [ 0, ..., 1000 ] ( -1: n.a.)
F6.1 Pulse width → not in [ 0, ..., 10000 ] ( -1: n.a.)
F5.2 Beam divergence → not in [ 0, ..., 400 ] ( -1: n.a.)
I4 Number of pulses in outgoing semi-train → not in [ 0, ..., 1000 ] ( -1: n.a.)
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 [ > 0 ] ( -1: n.a.)
F6.2 Quantum efficiency → not in [ 0, ..., 100 ] ( -1: n.a.)
F5.1 Applied voltage → not in [ -1e6, ..., 1e6 ] ( -1: n.a.)
F5.1 Dark count → not in [ 0, ..., 1e6 ] ( -1: n.a.)
A10 Output pulse type    
F5.1 Output pulse width → not in [ 0, ..., 1e6 ] ( -1: n.a.)
F5.2 Spectral filter (nm) → not in [ 0, ..., 1064 ] ( -1: n.a.)
F5.1 % Transmission of spectral filter → not in [ 0, ..., 100 ] ( -1: n.a.)
F5.1 Spectral filter (arcsec) → not in [ 0, ..., 3600 ] ( -1: n.a.)
A10 External signal progressing    
Additional Checks
→ There must be 14 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 [ -5e5, ..., 5e5 ] ( -1: n.a.)
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 [ -1000, ..., 1000 ]
F11.2 Estimated station oscillator drift → not in [ -1000, ..., 1000 ]
F20.3 Estimated transponder UTC offset → not in [ -100, ..., 100 ]
F11.2 Estimated transponder oscillator UTC drift → not in [ -1e8, ..., 1e8 ]
F20.12 Transponder clock reference time → not in [ -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

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, ..., 10000 ]
→ 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 [ > 0 ]
Additional Checks
→ There must be 9 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, ..., 10000 ]
→ 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 ]
→ not in [ 0, ..., 300 ] (not applied for LLR)
I6 Number of raw ranges → not in [ >= 0 ]
→ not in [ 0, ..., 100000 ]
F9.1 Bin RMS from the mean of raw accepted time of flight → not in [ >= 0 ]
→ not in [ 0, ..., 6667 ]
F7.3 Bin skew from the mean of raw accepted time of flight → not in [ -2, ..., 2 ]
F7.3 Bin kurtosis from the mean of raw accepted time of flight → not in [ -2, ..., 3 ]
F9.1 Bin peak → not in [ -1000, ..., 1000 ]
F9.1 Return rate (%) → not in [ 0, ..., 100 ] ( -1: n.a.)
I1 Detector channel → not in [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
Additional Checks
→ There must be 13 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 [ 0, ..., 10000 ] ( -1: n.a.)
F6.4 Target center of mass correction → not in [ 0, ..., 100 ] ( -1: n.a.)
F5.2 Neutral density → not in [ 0, ..., 100 ] ( -1: n.a.)
F8.4 Time bias applied → not in [ -10, ..., 10 ] ( -1: n.a.)
Additional Checks
→ There must be 7 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 [ 600, ..., 1100 ]
→ not in [ 700, ..., 1100 ]
→ no station height available at EDC
F6.2 Surface temperature in degrees → not in [ 200, ..., 340 ]
→ not in [ 230, ..., 330 ]
F4.0 Relative humidity at surface in % → not in [ 0, ..., 100 ]
I1 Origin of values → not in [ 0, 1 ] ( -1: n.a.)
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 [ 0, ..., 100 ] ( -1: n.a.)
→ not in [ 0, ..., 33 ] ( -1: n.a.)
F5.1 Wind direction → not in [ -180 , ..., 360 ] ( -1: n.a.)
A4 Precipitation type    
I3 Visibility → not in [ 0, ..., 100 ] ( -1: n.a.)
F4.2 Sky clarity → not in [ 0, ..., 360 ] ( -1: n.a.)
→ not in [ 0, ..., 100 ] ( -1: n.a.)
I2 Atmospheric seeing → not in [ 0, ..., 100 ] ( -1: n.a.)
I2 Cloud cover (%) → not in [ 0, ..., 100 ] ( -1: n.a.)
Additional Checks
→ There must be 9 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 [ -180, ..., 360 ] ( -1: n.a.)
F8.4 Elevation in degree → not in [ 0, ..., 180 ] ( -1: n.a.)
→ not in [ 0, ..., 90 ] ( -1: n.a.)
I1 Direction flag → not in [ 0, 1, 2 ] ( -1: n.a.)
I1 Angle origin indicator → not in [ 0, 1, 2, 3 ]
I1 Refraction corrected → not in [ 0, 1 ]
Additional Checks
→ There must be 7 parameters in record

40 - Calibration Record

1 - 2 A2 Record Type (='40')
F18.12 Seconds of day → not in [ 0, ..., 86400 ]
→ not in [ 0, ..., 86400 ]
I1 Type of data → not in [ 0, 1, 2, 3, 4, 5 ]
→ 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 [ 0, ..., 1e8 ] ( -1: n.a.)
I8 Number of data points used → not in [ 0, ..., 1e8 ] ( -1: n.a.)
F7.3 One way target distance → not in [ 0, ..., 1e4 ] ( -1: n.a.)
F10.1 Calibration system delay → not in [ -1e5, ..., 1.5e6 ] ( -1: n.a.)
F8.1 Calibration delay shift → not in ] -1e4, ..., 1e8 [ ( -1: n.a.)
→ not in [ -6667, ..., 6667 ] ( -1: n.a.)
F6.1 Root mean square of raw system delay → not in [ 0, ..., 1e8 [ ( -1: n.a.)
→ not in [ 0, ..., 667 ] ( -1: n.a.)
F7.3 Skew of raw system delay → not in [ -2, ..., 2 ] ( -1: n.a.)
F7.3 Kurtosis of raw system delay → not in [ -2, ..., 3 ] ( -1: n.a.)
F6.1 System delay peak - mean value → not in [ -1000, ..., 1000 ] ( -1: n.a.)
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 ]
Additional Checks
→ There must be 16 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 [ 0, ..., 1e8 ]
→ not in [ 1e-3, ..., 667 ]
F7.3 Session skewness from the mean of raw → not in [ -2, ..., 2 ]
F7.3 Session kurtosis from the mean of raw → not in [ -2, ..., 5 ]
F6.1 Session peak → not in [ -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