This page describes the ROMC filenaming and formating specifications.
| ROMC file naming convention |
Measurement results files must follow a <MES>_<MOD>-<EXP>.mes naming convention,
where:- <MES> defines the identification label of the measurement that is contained within the results file
- <MOD> identifies the RT model that was used to perform the simulation and generate the measurement results file
- <EXP> identifies the experiment that was performed. This tag contains information as to the structural and spectral properties of the test case as well as the illumination conditions for the simulations.
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 | fabs | |
| 2 | (perpendicular to the principal plane) | brfop |
| 3 | brfop_co_sgl | |
| 4 | brfop_mlt | |
| 5 | brfop_uc_sgl | |
| 6 | (total) | brfpp |
| 7 | brfpp_co_sgl | |
| 8 | brfpp_mlt | |
| 9 | brfpp_uc_sgl | |
| 10 | (Directional Hemispherical Reflectance, DHR) | brf1 |
| 11 | (direct + diffuse radiation reaching the soil level) | ftran |
| 12 | (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 | # rows | # columns in file | Ratio of filtered rays ** | ||
| Header line format | integer | integer | real | ||
| Body lines content | SZA [rad] | VZA [rad]* | SAA - VAA [rad]* | BRF | Std. Dev. BRF ** |
| Body lines format | real | real | real | real | real |
**: if available, otherwise set to -1.000000.
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.141593 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.141593 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.141593 0.185165 0.025572
1.221730 1.047198 1.570796 0.328869 0.000146
1.221730 1.308997 3.141593 0.370315 0.135204
1.221730 1.308997 1.570796 0.203645 0.000052
1.221730 1.483530 3.141593 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.30900 0.00000 0.0318550 -1.00000
0.349066 1.27409 0.00000 0.0331900 -1.00000
0.349066 1.23918 0.00000 0.0348060 -1.00000
0.349066 1.20428 0.00000 0.0363330 -1.00000
0.349066 1.16937 0.00000 0.0375620 -1.00000
0.349066 1.13446 0.00000 0.0385920 -1.00000
0.349066 1.09956 0.00000 0.0397190 -1.00000
0.349066 1.06465 0.00000 0.0410810 -1.00000
0.349066 1.02974 0.00000 0.0423890 -1.00000
0.349066 0.994838 0.00000 0.0435390 -1.00000
0.349066 0.959931 0.00000 0.0447860 -1.00000
0.349066 0.925025 0.00000 0.0462140 -1.00000
0.349066 0.890118 0.00000 0.0478770 -1.00000
0.349066 0.855211 0.00000 0.0495160 -1.00000
0.349066 0.820305 0.00000 0.0511630 -1.00000
0.349066 0.785398 0.00000 0.0529240 -1.00000
0.349066 0.750492 0.00000 0.0548090 -1.00000
0.349066 0.715585 0.00000 0.0567510 -1.00000
0.349066 0.680678 0.00000 0.0587880 -1.00000
0.349066 0.645772 0.00000 0.0609030 -1.00000
0.349066 0.610865 0.00000 0.0630250 -1.00000
0.349066 0.575959 0.00000 0.0651330 -1.00000
0.349066 0.541052 0.00000 0.0672560 -1.00000
0.349066 0.506145 0.00000 0.0693480 -1.00000
0.349066 0.471239 0.00000 0.0713570 -1.00000
0.349066 0.436332 0.00000 0.0733290 -1.00000
0.349066 0.401426 0.00000 0.0753520 -1.00000
0.349066 0.366519 0.00000 0.0780020 -1.00000
0.349066 0.331613 0.00000 0.0781930 -1.00000
0.349066 0.296706 0.00000 0.0760380 -1.00000
0.349066 0.261799 0.00000 0.0746460 -1.00000
0.349066 0.226893 0.00000 0.0733490 -1.00000
0.349066 0.191986 0.00000 0.0720180 -1.00000
0.349066 0.157080 0.00000 0.0705980 -1.00000
0.349066 0.122173 0.00000 0.0692120 -1.00000
0.349066 0.0872660 0.00000 0.0678060 -1.00000
0.349066 0.0523600 0.00000 0.0664120 -1.00000
0.349066 0.0174530 0.00000 0.0649570 -1.00000
0.349066 0.0174530 3.14159 0.0635900 -1.00000
0.349066 0.0523600 3.14159 0.0622220 -1.00000
0.349066 0.0872660 3.14159 0.0608960 -1.00000
0.349066 0.122173 3.14159 0.0595980 -1.00000
0.349066 0.157080 3.14159 0.0583490 -1.00000
0.349066 0.191986 3.14159 0.0570660 -1.00000
0.349066 0.226893 3.14159 0.0558280 -1.00000
0.349066 0.261799 3.14159 0.0546520 -1.00000
0.349066 0.296706 3.14159 0.0535960 -1.00000
0.349066 0.331613 3.14159 0.0525710 -1.00000
0.349066 0.366519 3.14159 0.0516000 -1.00000
0.349066 0.401426 3.14159 0.0507040 -1.00000
0.349066 0.436332 3.14159 0.0498600 -1.00000
0.349066 0.471239 3.14159 0.0490250 -1.00000
0.349066 0.506145 3.14159 0.0482400 -1.00000
0.349066 0.541052 3.14159 0.0475100 -1.00000
0.349066 0.575959 3.14159 0.0467890 -1.00000
0.349066 0.610865 3.14159 0.0460820 -1.00000
0.349066 0.645772 3.14159 0.0454600 -1.00000
0.349066 0.680678 3.14159 0.0448800 -1.00000
0.349066 0.715585 3.14159 0.0444000 -1.00000
0.349066 0.750492 3.14159 0.0439090 -1.00000
0.349066 0.785398 3.14159 0.0435120 -1.00000
0.349066 0.820305 3.14159 0.0429350 -1.00000
0.349066 0.855211 3.14159 0.0422260 -1.00000
0.349066 0.890118 3.14159 0.0414320 -1.00000
0.349066 0.925025 3.14159 0.0405360 -1.00000
0.349066 0.959931 3.14159 0.0395850 -1.00000
0.349066 0.994838 3.14159 0.0385190 -1.00000
0.349066 1.02974 3.14159 0.0371720 -1.00000
0.349066 1.06465 3.14159 0.0357990 -1.00000
0.349066 1.09956 3.14159 0.0343750 -1.00000
0.349066 1.13446 3.14159 0.0329370 -1.00000
0.349066 1.16937 3.14159 0.0313050 -1.00000
0.349066 1.20428 3.14159 0.0297510 -1.00000
0.349066 1.23918 3.14159 0.0283090 -1.00000
0.349066 1.27409 3.14159 0.0266780 -1.00000
0.349066 1.30900 3.14159 0.0255550 -1.00000
Fraction of transmitted or absorbed radiation (fabs & ftran measurements # 1 and 11):
| Content | Percentage of radiation [%] |
| Body Line Format | real |
A real is defined as having 6 digits after the decimal point, e.g., 1.000000.
Example:
The file "ftran_<MOD>-<EXP>.mes" contains one line:26.502224