Navigation path

LEft

Formats
  

Additional tools

 

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 stringsTag 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 up

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 not defined (i.e. measurement #10: brf1) set to -1.000000.
**: 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
(one single value per file)

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