Changes between Initial Version and Version 1 of doc/app/iofiles/pids/vm

Timestamp:

Jul 2, 2019 1:33:26 PM (6 years ago)

Author:

scharf

Comment:

created own page for virtual measurement input file

doc/app/iofiles/pids/vm

@@ +1 @@
+== [=#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].  
+
+||='''Global attributes'''  =||='''Type''' =||='''Explanation / Remarks'''  =||
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#num_vm '''number_of_stations<id>''']
+}}}
+{{{#!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"
+[=#filename '''filename<id>''']
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_CHAR
+}}}
+{{{#!td
+Name of the file where the original observational data is stored. 
+}}}
+|----------------
+{{{#!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 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 only 1 value necessary for sufficient description of the coordinates. 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>''' (1) 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>''' (1) 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 '''height_above_origin<id>''' (1) or (tray<id>,ntime<id>)]
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td
+Height above the surface.  
+}}}
+|----------------
+{{{#!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:example_vmeas|here]].