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

ILRS-AC

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

Consolidated Laser Ranging Data Format (CRD) - Version 1.0

This documentation is related to format version 1.0 of CRD (PDF-Version)!

The documentation for format version 2.0 of CRD can be found here!

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

--- Important Notice ---
Since 15 August 2019, additional quality checks have been carried out by the ILRS OCs!
The new quality checks will be applied on data which have a production date (H1 record) larger than '2019-08-15 00:00:00'. The are highlight with ^New!

General Checks

EGL000	→ Unknown record (Note: Empty lines will also lead to this error.)
EGL003	→ File is empty
EGL009	→ No H8 record found in a single/multi pass file.
EGL015	→ No 11 record found. (only NPT)
EGL016	→ No 10 record found. (only FRD)
EGL017	→ More than one satellite found!
EGL018	→ Dataset contains non-ascii characters
EGL020	→ Satellite orbit does not fit to CPFs orbit (Possible reason: Mislabled pass)
WGL020	→ No CPFs found for calculating orbit fit
WGL021	→ No XYZ station coordiantes found for calculating orbit fit
WGL022	→ 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)	EH1021	→ not in [ 'CRD', 'crd' ]
8 - 9	I2	Format Version (currently = 1)	WH1031	→ in [ 0 ]
			EH1031	→ not in [ 1 ]
11 - 14	I4	Year of file production	EH1041	→ not in [ 1950 , ... , 2100 ]
16 - 17	I2	Month of file production	EH1051	→ not in [ 1 , ... , 12 ]
19 - 20	I2	Day of file production	EH1061	→ not in [ 1 , ... , 31 ]
22 - 23	I2	Hour of file production	EH1071	→ not in [ 1 , ... , 23 ]
Additional Checks
EH1001	→ Wrong pattern of record (spaces at wrong positions) or record length not exact 23 characters
EH1002	→ Date of file production must be valid
EH1003	→ No H1 record found in a single/multi pass file
EH1004	→ More than one H1 record found in a single pass file
EH1005	→ 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	EH2021	→ 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	EH2061^OLD	→ not in [ 0 , ... , 99 ]
			EH2061^NEW	→ not in [ 3 , 4 , 7 ]
Additional Checks
EH2001	→ Wrong pattern of record (spaces at wrong positions) or record length not exact 27 characters
EH2002	→ 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
EH2003	→ No H2 record found in a single/multi pass file
EH2004	→ More than one H2 record found in a single pass file
EH2005	→ SOD and station name are not from the same station
EH2006	→ 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)	EH3021	→ Target name not found in official list
			WH3021	→ Target name should be in lowercase
15 - 22	I8	ILRS satellite identifier (based on COSPAR ID)	EH3031	→ ILRS satellite identifier not found in official list
			EH3032	→ ILRS satellite does not fit to satellite name
25 - 27	I4	SIC (Satellite Identification Code)	EH3041	→ SIC not found in official list
			EH3042	→ SIC does not fit to satellite name
29 - 36	I8	NORAD ID	EH3051	→ NORAD id not found in official list (na is allowed for n.a.)
			EH3052	→ NORAD id does not fit to satellite name
38	I1	Spacecraft epoch time scale (transponder only)	EH3061	→ not in [ 0, 1, 2 ]
40	I1	Target type	EH3071	→ not in [ 1, 2, 3, 4 ]
Additional Checks
EH3001	→ Wrong pattern of record (spaces at wrong positions) or record length not exact 40 characters
EH3002	→ More than one H3 record found in a single pass file
EH3003	→ SOD and station name are not from the same station
EH3004	→ H3 record is not allowed within session between H4 and H8 record
EH3022	→ 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	EH4021	→ not in [ 0, 1, 2 ]
			EH4022	→ Data type != 1 for normal points
			EH4023	→ Data type != 0 for full-rate data
7 - 10	I4	Starting year	EH4031	→ not in [ 1950, ..., 2100 ]
12 - 13	I2	Starting month	EH4041	→ not in [ 1, ..., 12 ]
15 - 16	I2	Starting day	EH4051	→ not in [ 1, ..., 31 ]
18 - 19	I2	Starting hour	EH4061	→ not in [ 0, ..., 23 ]
21 - 22	I2	Starting minute	EH4071	→ not in [ 0, ..., 59 ]
24 - 25	I2	Starting second	EH4081	→ not in [ 0, ..., 59 ]
27 - 30	I4	Ending year	WH4091^NEW	→ in [ -1 ]
			EH4091	→ not in [ 1950, ..., 2100 ]
32 - 33	I2	Ending month	WH4101^NEW	→ in [ -1 ]
			EH4101	→ not in [ 1, ..., 12 ]
35 - 36	I2	Ending day	WH4111^NEW	→ in [ -1 ]
			EH4111	→ not in [ 1, ..., 31 ]
38 - 39	I2	Ending hour	WH4121^NEW	→ in [ -1 ]
			EH4121	→ not in [ 0, ..., 23 ]
41 - 42	I2	Ending minute	WH4131^NEW	→ in [ -1 ]
			EH4131	→ not in [ 0, ..., 59 ]
44 - 45	I2	Ending second	WH4141^NEW	→ in [ -1 ]
			EH4141	→ not in [ 0, ..., 59 ]
47 - 48	I2	A release flag to indicate the data release	EH4151	→ not in [ 0, ..., 99 ]
50	I1	Tropospheric refraction correction applied indicator	EH4161	→ not in [ 0, 1 ]
			EH4162	→ is set but no record 12 was found (File production data in H1 >= 2015-01-01)
			WH4162	→ is set but no record 12 was found (File production data in H1 < 2015-01-01)
52	I1	Center of mass correction applied indicator	EH4171	→ not in [ 0, 1 ]
			EH4172	→ is set but no record 12 was found (File production data in H1 >= 2015-01-01)
			WH4172	→ is set but no record 12 was found (File production data in H1 < 2015-01-01)
54	I1	Receive amplitude correction applied indicator	EH4181	→ not in [ 0, 1 ]
56	I1	Station system delay applied indicator	EH4191	→ not in [ 0, 1 ]
58	I1	Spacecraft system delay appied indicator	EH4201	→ not in [ 0, 1 ]
60	I1	Range type indicator	EH4211	→ not in [ 0, 1, 2, 3, 4 ]
62	I1	Data quality alert indicator	EH4221	→ not in [ 0, 1, 2 ]
Additional Checks
EH4001	→ Wrong pattern of record (spaces at wrong positions) or record length not exact 62 characters
EH4002	→ Starting date is not valid
EH4003	→ Ending date is not valid
EH4004	→ No H4 record found in a single/multi pass file
EH4005	→ More than one H4 record found in a single pass file
EH4006	→ H4 record is not allowed within session between H4 and H8 record
EH4007	→ Difference between starting date and ending date > 1 day
EH4008	→ Starting date is greater than ending date
EH4009	→ 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
EH8001	→ No H8 record found in a single/multi pass file
EH8002	→ More than one H8 record found in a single pass file
EH8003	→ Sum of H4 an H8 must be one for a single pass file
EH8004	→ Sum of H4 an H8 must be equal for a multi pass file
EH8005	→ 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
EH9001	→ H9 record is not allowed within session between H4 and H8 record
EH9002	→ H9 must be after H8 record
EH9003	→ H9 record must be at the end of file
EH9004	→ No H9 record found
EH9005	→ More than one H9 record found

C0 - System Configuration Record

1 - 2	A2	Record Type (='C0' or 'c0')
	I1	Detail type (='0')	EC0021	→ not in [ 0 ]
	F10.3	Transmit wavelength (ns)	WC0031	→ 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
EC0001	→ The record length must be 4 characters
EC0002	→ 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')	EC1021	→ not in [ 0 ]
	A4	Laser configuration id (unique within the file)	WC1031	→ not found in record C0
	A4	Laser type (e.g. Nd-Yag)
	F10.2	Primary wavelength (nm)	WC1051	→ not in [ > 0 ] ( -1: n.a.)
	F10.2	Nominal Fire rate	~~WC1061~~	~~→ not in [ 0, ..., 10000 ] ( -1: n.a.)~~ (removed from QC on 2023-03-20)
	F10.2	Pulse energy	WC1071	→ not in [ 0, ..., 1000 ] ( -1: n.a.)
	F6.1	Pulse width	WC1081	→ not in [ 0, ..., 10000 ] ( -1: n.a.)
	F5.2	Beam divergence	WC1091	→ not in [ 0, ..., 400 ] ( -1: n.a.)
	I4	Number of pulses in outgoing semi-train	WC1101	→ not in [ 0, ..., 1000 ] ( -1: n.a.)
Additional Checks
EC1001	→ There must be 10 parameters in record

C2 - Detector Configuration Record

1 - 2	A2	Record Type (='C2' or 'c2')
	I1	Detail type (='0')	EC2021	→ not in [ 0 ]
	A4	Detector configuration id (unque within the file)	WC2031	→ not found in record C0
	A10	Detector type
	F10.3	Applicable wavelength (nm)	WC2051	→ not in [ > 0 ] ( -1: n.a.)
	F6.2	Quantum efficiency	WC2061	→ not in [ 0, ..., 100 ] ( -1: n.a.)
	F5.1	Applied voltage	WC2071	→ not in [ -1e6, ..., 1e6 ] ( -1: n.a.)
	F5.1	Dark count	WC2081	→ not in [ 0, ..., 1e6 ] ( -1: n.a.)
	A10	Output pulse type
	F5.1	Output pulse width	WC2101	→ not in [ 0, ..., 1e6 ] ( -1: n.a.)
	F5.2	Spectral filter (nm)	WC2111	→ not in [ 0, ..., 1064 ] ( -1: n.a.)
	F5.1	% Transmission of spectral filter	WC2121	→ not in [ 0, ..., 100 ] ( -1: n.a.)
	F5.1	Spectral filter (arcsec)	WC2131	→ not in [ 0, ..., 3600 ] ( -1: n.a.)
	A10	External signal progressing
Additional Checks
EC2001	→ There must be 14 parameters in record

C3 - Timing System Configuration Record

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

C4 - Transponder (Clock) Configuration Record

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

00 - Comment Record

1 - 2	A2	Record Type (='00')
	A80	Free format ASCII comments	E00021	→ 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	E10021	→ not in [ 0, ..., 86400 [
	F18.12	Time of flight	E10031^OLD	→ not in [ 0, ..., 10000 ]
			E10031^NEW	→ not in [ 0, ..., 3 ]
	A4	System configuration id	E10041	→ not found in record C0
	I1	Epoch event	W10051	→ not in [ 0, 1, 2, 3, 4, 5, 6 ]
	I1	Filter flag	W10061	→ not in [ 0, 1, 2 ]
	I1	Detector channel	E10071	→ not in [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
	I1	Stop number	E10081	→ not in [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
	I5	Receive amplitude	W10091	→ not in [ > 0 ]
Additional Checks
E10001	→ There must be 9 parameters in record
E10002	→ Record 10 is not allowed in NPT files

11 - Range Record (Normal Point)

1 - 2	A2	Record Type (='11')
	F18.12	Seconds of day	E11021	→ not in [ 0, ..., 86400 [
	F18.12	Time of flight	E11031^OLD	→ not in [ 0, ..., 10000 ]
			E11031^NEW	→ not in [ 0, ..., 3 ]
	A4	System configuration id	E11041	→ not found in record C0
	I1	Epoch event	W11051	→ not in [ 0, 1, 2, 3, 4, 5, 6 ]
	F6.1	Normal point window length	W11061^OLD	→ not in [ >= 0 ]
			E11061^NEW	→ not in [ 0, ..., 300 ] (not applied for LLR)
	I6	Number of raw ranges	W11071^OLD	→ not in [ >= 0 ]
			W11071^NEW	→ not in [ 0, ..., 100000 ]
	F9.1	Bin RMS from the mean of raw accepted time of flight	W11081^OLD	→ not in [ >= 0 ]
			W11081^NEW	→ not in [ 0, ..., 6667 ]
	F7.3	Bin skew from the mean of raw accepted time of flight	W11091^NEW	→ not in [ -2, ..., 2 ]
	F7.3	Bin kurtosis from the mean of raw accepted time of flight	W11101^NEW	→ not in [ -2, ..., 3 ]
	F9.1	Bin peak	W11111^NEW	→ not in [ -1000, ..., 1000 ]
	F9.1	Return rate (%)	W11121	→ not in [ 0, ..., 100 ] ( -1: n.a.)
	I1	Detector channel	E11131	→ not in [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ]
Additional Checks
E11001	→ There must be 13 parameters in record
E11002	→ Record 11 is not allowed in FRD files

12 - Range Supplement Record

1 - 2	A2	Record Type (='12')
	F18.12	Seconds of day	E12021	→ not in [ 0, ..., 86400 [
	A4	System configuration id	E12031	→ not found in record C0
	F6.1	Tropospheric refraction correction	W12041^NEW	→ not in [ 0, ..., 10000 ] ( -1: n.a.)
	F6.4	Target center of mass correction	W12051^NEW	→ not in [ 0, ..., 100 ] ( -1: n.a.)
	F5.2	Neutral density	W12061^NEW	→ not in [ 0, ..., 100 ] ( -1: n.a.)
	F8.4	Time bias applied	W12071^NEW	→ not in [ -10, ..., 10 ] ( -1: n.a.)
Additional Checks
E12001	→ There must be 7 parameters in record

20 - Meteorological Record

--- Important Notice ---
Since 8 September 2021, an additional quality check has been carried out by the ILRS OCs!
The new quality check for the surface pressure uses now station-dependent limits which are related to the station height.


	tolerance_level = 50.0 bar

	expected_surface_pressure = -0.1051 * site_height_in_m + 1015.6793

	min_limit_surface_pressure = expected_surface_pressure - tolerance_level

	max_limit_surface_pressure = expected_surface_pressure + tolerance_level

1 - 2	A2	Record Type (='20')
	F18.12	Seconds of day	E20021	→ not in [ 0, ..., 86400 [
	F7.2	Surface pressure	E20031^OLD	→ not in [ 600, ..., 1100 ]
			E20031^NEW	→ not in [ 700, ..., 1100 ]
			E20032^NEW	→ no station height available at EDC
	F6.2	Surface temperature in degrees	E20041^OLD	→ not in [ 200, ..., 340 ]
			E20041^NEW	→ not in [ 230, ..., 330 ]
	F4.0	Relative humidity at surface in %	E20051	→ not in [ 0, ..., 100 ]
	I1	Origin of values	W20061	→ not in [ 0, 1 ] ( -1: n.a.)
Additional Checks
E20001	→ There must be 6 parameters in record
E20002	→ There must at least one meterolgical record

21 - Meteorological Supplement Record

1 - 2	A2	Record Type (='21')
	F18.12	Seconds of day	E21021	→ not in [ 0, ..., 86400 [
	F5.1	Wind speed	W21031^OLD	→ not in [ 0, ..., 100 ] ( -1: n.a.)
			W21031^NEW	→ not in [ 0, ..., 33 ] ( -1: n.a.)
	F5.1	Wind direction	E21041	→ not in [ -180 , ..., 360 ] ( -1: n.a.)
	A4	Precipitation type
	I3	Visibility	W21061	→ not in [ 0, ..., 100 ] ( -1: n.a.)
	F4.2	Sky clarity	W21071^OLD	→ not in [ 0, ..., 360 ] ( -1: n.a.)
			W21071^NEW	→ not in [ 0, ..., 100 ] ( -1: n.a.)
	I2	Atmospheric seeing	W21081	→ not in [ 0, ..., 100 ] ( -1: n.a.)
	I2	Cloud cover (%)	W21091	→ not in [ 0, ..., 100 ] ( -1: n.a.)
Additional Checks
E21001	→ There must be 9 parameters in record

30 - Pointing Angle Record

1 - 2	A2	Record Type (='30')
	F18.12	Seconds of day	E30021	→ not in [ 0, ..., 86400 [
	F8.4	Azimuth in degree	W30031	→ not in [ -180, ..., 360 ] ( -1: n.a.)
	F8.4	Elevation in degree	W30041^OLD	→ not in [ 0, ..., 180 ] ( -1: n.a.)
			W30041^NEW	→ not in [ 0, ..., 90 ] ( -1: n.a.)
	I1	Direction flag	W30051	→ not in [ 0, 1, 2 ] ( -1: n.a.)
	I1	Angle origin indicator	W30061	→ not in [ 0, 1, 2, 3 ]
	I1	Refraction corrected	W30071	→ not in [ 0, 1 ]
Additional Checks
E30001	→ There must be 7 parameters in record

40 - Calibration Record

1 - 2	A2	Record Type (='40')
	F18.12	Seconds of day	W40021^OLD	→ not in [ 0, ..., 86400 ]
			E40021^NEW	→ not in [ 0, ..., 86400 ]
	I1	Type of data	W40031^OLD	→ not in [ 0, 1, 2, 3, 4, 5 ]
			E40031^NEW	→ not in [ 0, 1, 2, 3, 4, 5 ]
	A4	System configuration id	E40041	→ not found in record C0
	I8	Number of data points recorded	W40051	→ not in [ 0, ..., 1e8 ] ( -1: n.a.)
	I8	Number of data points used	W40061	→ not in [ 0, ..., 1e8 ] ( -1: n.a.)
	F7.3	One way target distance	W40071	→ not in [ 0, ..., 1e4 ] ( -1: n.a.)
	F10.1	Calibration system delay	E40081	→ not in [ -1e5, ..., 1.5e6 ] ( -1: n.a.)
	F8.1	Calibration delay shift	E40091^OLD	→ not in ] -1e4, ..., 1e8 [ ( -1: n.a.)
			E40091^NEW	→ not in [ -6667, ..., 6667 ] ( -1: n.a.)
	F6.1	Root mean square of raw system delay	E40101^OLD	→ not in [ 0, ..., 1e8 [ ( -1: n.a.)
			E40101^NEW	→ not in [ 0, ..., 667 ] ( -1: n.a.)
	F7.3	Skew of raw system delay	E40111^NEW	→ not in [ -2, ..., 2 ] ( -1: n.a.)
	F7.3	Kurtosis of raw system delay	E40121^NEW	→ not in [ -2, ..., 3 ] ( -1: n.a.)
	F6.1	System delay peak - mean value	E40131^NEW	→ not in [ -1000, ..., 1000 ] ( -1: n.a.)
	I1	Calibration type indicator	W40141	→ not in [ 0, 1, 2, 3, 4, 5 ]
	I1	Calibration shift type indicator	W40151	→ not in [ 0, 1, 2, 3, 4 ]
	I1	Detector channel	W40161	→ not in [ 0, ..., 9 ]
Additional Checks
E40001	→ There must be 16 parameters in record

50 - Session (Pass) Statistics Record

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

60 - Compatibility Record

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

90 - User Defined Record

1 - 2

Record Type (='9x')