European Commission - ROMC website

This page describes the ROMC filenaming and formatting specifications.

ROMC file naming convention

Measurement results files must follow a <MES>_<MOD>-<EXP>.mes naming convention, where:

<MES>
<MOD>
<EXP>

An example of the <MES>_<MOD>-<EXP>.mes filenaming scheme would be "brf1_raytran-HET01_DIS_UNI_NIR_50.mes", where the measurement identifier <MES> is "brf1", the model identifier <MOD> is "raytran" and the experiment identifier <EXP> is "HET01_DIS_UNI_NIR_50". A comprehensive overview of permissible measurement, model and experiment identifiers is given below:

List of permissible measurement identifiers <MES>

#	Measurement description	Measurement identifier
1	Absorption by the foliage	fabs
2	BRF in the cross plane (perpendicular to the principal plane)	brfop
3	BRF in the cross plane for single-scattered radiation collided by the leaves	brfop_co_sgl
4	BRF in the cross plane for multiple-scattered (two or more scattering events) radiation	brfop_mlt
5	BRF in the cross plane for single-scattered radiation collided by the soil	brfop_uc_sgl
6	BRF in the principal plane (total)	brfpp
7	BRF in the principal plane for single-scattered radiation collided by the leaves	brfpp_co_sgl
8	BRF in the principal plane for multiple-scattered (two or more scattering events) radiation	brfpp_mlt
9	BRF in the principal plane for single-scattered radiation collided by the soil	brfpp_uc_sgl
10	Spectral albedo (Directional Hemispherical Reflectance, DHR)	brf1
11	Total transmission through the medium at the lower boundary level (direct + diffuse radiation reaching the soil level)	ftran
12	GASP goniometer BRFs (total BRFs along the principal and orthogonal planes)	gonio

RT model identifier tags <MOD>

The RT model identifier tag is the 'name' of the model that was used to perform the RT simulations contained within the measurement results file. It is identical tot he one that you provide when registering a new model. RT models names are case-insensitive alphanumeric strings of up to 10 characters that must be unique within the context of the ROMC. A full list of model lists within ROMC can be obtained by following the 'Model list' link in the 'My Models' menu on the left-hand navigation menu. If your model's name has already been taken up by someone - just add a number or your initials as extension, or, a version number - as long as the name is less than 10 characters.

List of permissible experiment identifier <EXP>

Experiment identifiers are provided on the web pages that describe the individual test cases. They are not listed here because there are too many of them. Experiment identifiers are composed of a variety of identifier tags, describing the structural and spectral properties of the scene (test case), as well as, the illumination conditions for the RT model simulations, among others. The general format of the <EXP> experiment identifier tag is: A_B_C_D_E where A - E are a series of alphanumeric strings containing two to three characters that are separated by the underscore symbol '_'. An example of such an experiment identifier is: HET01_DIS_UNI_NIR_50. The following table shows a selection of identifier tags that are used to make up the experiment identification tag :

Identifier tag	Valid strings	Tag meaning
A	HOMxx	HOMogeneous case, scene number xx
A	HETxx	HETerogeneous case, scene number xx
A	ARTxx	ARTificial target, scene number xx
B	DIS	DIScrete scatterers
B	TUR	DIScrete scatterers
B	NAC	Non-anodised Aluminium Cubes target
C	UNI	UNIform leaf angle distribution function
C	PLA	PLAnophile leaf angle distribution function
C	ERE	EREctophile leaf angle distribution function
D	RED	RED wavelength (650 nm)
D	NIR	Near-InfraRed wavelength (860 nm)
D	NR1	Purist Corner (theoretical wavelength where objects do not absorb)
D	zzz	value of the illumination azimuth angle in degree (padded with zeros on left if need be)
E	yy	value of the illumination zenith angle in degree (padded with zeros on left if need be

ROMC file format description

Results files contain the results from RT model simulations for a given measurement and experiment (test case). Two different types of results files are possible, and the format of these files must adhere strictly to the standards defined in the following table in order to facilitate post-processing:

BRF measurements (<MES> = brfpp*, brfop* & gonio in first table on this page (rows #2 - 10 & 12)):

Header line content	# columns in file	Ratio of filtered rays **
Header line format	integer	real

Body lines content	SZA [rad]	VZA [rad]*	SAA - VAA*	BRF	Std. Dev. BRF**
Body lines format	real	real	real	real	real

*: if not defined (i.e. measurement #10: brf1) set to -1.0000000.
**: if available, otherwise set to -1.0000000.

where

SZA: Solar Zenith Angle (as indicated on the experimental description page)
SAA: Solar Azimuth Angle (as indicated on the experimental description page)
VZA: Viewing Zenith Angle (as indicated on the experimental description page)
VAA: Viewing Azimuth Angle (0 radians for backward scattering in the principal plane, i.e., the hot-spot location, PI radians for forward scattering in the principal plane. For the orthogonal plane: PI/2 and 3PI/2 radians.
Check the angular definitions section).
Ratio of filtered rays: The number of rays that perform the measurement divided by the total number of incident rays (for ray-tracing RT models only).
Std. Dev. BRF: Indication of the uncertainty in the BRF estimate as estimated from the radiative transfer model itself

A real is defined as having 6 digits after the decimal point, e.g., 1.000000.

Example 1: The file "gonio_<MOD>-ART01_NAC_000_70.mes" contains 1 header line and 17 body lines. The following example shows such a file (where the BRF values are not realistic but arbitrarily assigned).


17	5	1.000000
1.221730	0.174532	0.000000	0.415942	0.001405 
1.221730	0.436332	0.000000	2.027264	0.228883	
1.221730	0.436332	3.141590	0.001220	0.001001 
1.221730	0.436332	4.712389	0.126703	0.000093 
1.221730	0.436332	1.570796	0.119312	0.000033 
1.221730	0.610865	0.000000	0.368913	0.000468 
1.221730	0.698131	0.000000	0.467574	0.000813 
1.221730	0.785398	0.000000	12.12233	0.001234 
1.221730	0.785398	3.141590	0.245187	0.001760 
1.221730	0.785398	4.712389	0.411052	0.000642 
1.221730	0.785398	1.570796	0.382978	0.000053 
1.221730	0.087266	0.000000	0.361543	0.000730 
1.221730	1.047198	3.141590	0.185165	0.025572 
1.221730	1.047198	1.570796	0.328869	0.000146 
1.221730	1.308997	3.141590	0.370315	0.135204 
1.221730	1.308997	1.570796	0.203645	0.000052 
1.221730	1.483530	3.141590	3.249039	0.117942

Example 2:

The file "brfpp_uc_sgl_<MOD>-<EXP>.mes" contains 1 header line and 75 body lines. The following example shows such a file (having a hot-spot occurring around 20 degree).


76	5	1.000000
0.349066	1.309000	0.000000	0.0318550	-1.000000
0.349066	1.274090	0.000000	0.0331900	-1.000000
0.349066	1.239180	0.000000	0.0348060	-1.000000
0.349066	1.204280	0.000000	0.0363330	-1.000000
0.349066	1.169370	0.000000	0.0375620	-1.000000
0.349066	1.134460	0.000000	0.0385920	-1.000000
0.349066	1.099560	0.000000	0.0397190	-1.000000
0.349066	1.064650	0.000000	0.0410810	-1.000000
0.349066	1.029740	0.000000	0.0423890	-1.000000
0.349066	0.994838	0.000000	0.0435390	-1.000000
0.349066	0.959931	0.000000	0.0447860	-1.000000
0.349066	0.925025	0.000000	0.0462140	-1.000000
0.349066	0.890118	0.000000	0.0478770	-1.000000
0.349066	0.855211	0.000000	0.0495160	-1.000000
0.349066	0.820305	0.000000	0.0511630	-1.000000
0.349066	0.785398	0.000000	0.0529240	-1.000000
0.349066	0.750492	0.000000	0.0548090	-1.000000
0.349066	0.715585	0.000000	0.0567510	-1.000000
0.349066	0.680678	0.000000	0.0587880	-1.000000
0.349066	0.645772	0.000000	0.0609030	-1.000000
0.349066	0.610865	0.000000	0.0630250	-1.000000
0.349066	0.575959	0.000000	0.0651330	-1.000000
0.349066	0.541052	0.000000	0.0672560	-1.000000
0.349066	0.506145	0.000000	0.0693480	-1.000000
0.349066	0.471239	0.000000	0.0713570	-1.000000
0.349066	0.436332	0.000000	0.0733290	-1.000000
0.349066	0.401426	0.000000	0.0753520	-1.000000
0.349066	0.366519	0.000000	0.0780020	-1.000000
0.349066	0.331613	0.000000	0.0781930	-1.000000
0.349066	0.296706	0.000000	0.0760380	-1.000000
0.349066	0.261799	0.000000	0.0746460	-1.000000
0.349066	0.226893	0.000000	0.0733490	-1.000000
0.349066	0.191986	0.000000	0.0720180	-1.000000
0.349066	0.157080	0.000000	0.0705980	-1.000000
0.349066	0.122173	0.000000	0.0692120	-1.000000
0.349066	0.087266	0.000000	0.0678060	-1.000000
0.349066	0.052360	0.000000	0.0664120	-1.000000
0.349066	0.017453	0.000000	0.0649570	-1.000000
0.349066	0.017453	3.141590	0.0635900	-1.000000
0.349066	0.052360	3.141590	0.0622220	-1.000000
0.349066	0.087266	3.141590	0.0608960	-1.000000
0.349066	0.122173	3.141590	0.0595980	-1.000000
0.349066	0.157080	3.141590	0.0583490	-1.000000
0.349066	0.191986	3.141590	0.0570660	-1.000000
0.349066	0.226893	3.141590	0.0558280	-1.000000
0.349066	0.261799	3.141590	0.0546520	-1.000000
0.349066	0.296706	3.141590	0.0535960	-1.000000
0.349066	0.331613	3.141590	0.0525710	-1.000000
0.349066	0.366519	3.141590	0.0516000	-1.000000
0.349066	0.401426	3.141590	0.0507040	-1.000000
0.349066	0.436332	3.141590	0.0498600	-1.000000
0.349066	0.471239	3.141590	0.0490250	-1.000000
0.349066	0.506145	3.141590	0.0482400	-1.000000
0.349066	0.541052	3.141590	0.0475100	-1.000000
0.349066	0.575959	3.141590	0.0467890	-1.000000
0.349066	0.610865	3.141590	0.0460820	-1.000000
0.349066	0.645772	3.141590	0.0454600	-1.000000
0.349066	0.680678	3.141590	0.0448800	-1.000000
0.349066	0.715585	3.141590	0.0444000	-1.000000
0.349066	0.750492	3.141590	0.0439090	-1.000000
0.349066	0.785398	3.141590	0.0435120	-1.000000
0.349066	0.820305	3.141590	0.0429350	-1.000000
0.349066	0.855211	3.141590	0.0422260	-1.000000
0.349066	0.890118	3.141590	0.0414320	-1.000000
0.349066	0.925025	3.141590	0.0405360	-1.000000
0.349066	0.959931	3.141590	0.0395850	-1.000000
0.349066	0.994838	3.141590	0.0385190	-1.000000
0.349066	1.029740	3.141590	0.0371720	-1.000000
0.349066	1.064650	3.141590	0.0357990	-1.000000
0.349066	1.099560	3.141590	0.0343750	-1.000000
0.349066	1.134460	3.141590	0.0329370	-1.000000
0.349066	1.169370	3.141590	0.0313050	-1.000000
0.349066	1.204280	3.141590	0.0297510	-1.000000
0.349066	1.239180	3.141590	0.0283090	-1.000000
0.349066	1.274090	3.141590	0.0266780	-1.000000
0.349066	1.309000	3.141590	0.0255550	-1.000000

Fraction of transmitted or absorbed radiation (fabs & ftran measurements # 1 and 11):

Content	Percentage of radiation [%]
Body Line Format	real

(one single value per file)