== [=#virtual_measurement_input '''Virtual measurement input file'''] ==

The virtual measurement input file comprises all information required to setup virtual sites within the model domain. Therefore, different global attributes as well as variables are mandatory. Please note, each attribute and variable name is in the format ''name<id>'', where id is an integer number running from 1 to [#num_vm number of stations].  
The following global attributes must be present in the virtual setup file.

||='''Global attributes'''  =||='''Type''' =||='''Explanation / Remarks'''  =||
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#num_vm '''number_of_stations''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
NC_INT
}}}
{{{#!td
Number of considered sites. 
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#origin_x2 '''origin_x<id>''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
NC_FLOAT
}}}
{{{#!td
Origin ''x''-coordinate of the measurement site in UTM.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#origin_y2 '''origin_y<id>''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
NC_FLOAT
}}}
{{{#!td
Origin ''y''-coordinate of the measurement site in UTM.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#site '''site<id>''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
NC_CHAR
}}}
{{{#!td
Name of the site. The name of the site will be used to name the final NetcDF files. 
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#featuretype '''featureType<id>''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
NC_CHAR
}}}
{{{#!td
Type of the measurement. Allowed strings are: ''timeSeries'', ''timeSeriesProfile'', and ''trajectory''. 
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#soilsample '''soil_sample<id>''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
NC_BYTE
}}}
{{{#!td
Bit value indicating that at the current site also soil quantities should be sampled ( = 1 ). If no soil quantities are sampled this value should be 0.  
}}}

\\\\
In the following, the required dimensions/variables will be listed. Please note, NetCDF dimensions of the coordinate variables ''E_UTM'', ''N_UTM'', and ''height_above_origin'' depend on the [#featuretype type] of the measurement. For ''timeseries'', the observation is a stationary one with a fixed number of locations. The number of fixed coordinates (e.g. several sensors at a mast) is stored in the dimension station<id>. For ''timeSeriesProfile'' or ''trajectory'', however, the coordinate variables depend on the dimensions ''tray<id>'' and ''ntime<id>'', being the number of trajectories and the maximum number of timesteps measured for a trajectory, according to the '''[UC]2 data standard'''.

||='''Variables'''  =||='''Type''' =||='''Explanation / Remarks'''  =||
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#eutm '''E_UTM<id>''' (station<id>) or (tray<id>,ntime<id>)]
}}}
{{{#!td style="vertical-align:top;width: 50px"
NC_FLOAT
}}}
{{{#!td
UTM easting coordinate of the measurement location(s). 
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#nutm '''N_UTM<id>''' (station<id>) or (tray<id>,ntime<id>)]
}}}
{{{#!td style="vertical-align:top;width: 50px"
NC_FLOAT
}}}
{{{#!td
UTM northing coordinate of the measurement location(s). 
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#zag '''z<id>''' (station<id>) or (tray<id>,ntime<id>)]
}}}
{{{#!td style="vertical-align:top;width: 50px"
NC_FLOAT
}}}
{{{#!td
Sensor height above sea level. The relative measurement height calculates from {{{z-station_h}}}. 
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#station_h '''station_h<id>''' (station<id>) or (tray<id>,ntime<id>)]
}}}
{{{#!td style="vertical-align:top;width: 50px"
NC_FLOAT
}}}
{{{#!td
Surface altitude with respect to sea level.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#measured_variables '''measured_variables<id>'''(num_vars<id>,10)]
}}}
{{{#!td style="vertical-align:top;width: 50px"
NC_CHAR
}}}
{{{#!td
List of character strings (length = 10) with variable names. 
}}}

For an example input file, please see [[attachment:vm_driver|here]].