= Virtual flight parameters =

[[TracNav(doc/app/partoc|nocollapse)]]
\\\\

With revision ??? an interface for virtual flight measurements is available in PALM. Virtual flights are performed according to the methods described in Schröter et al. (2000) and Sühring and Raasch (2013). 

All parts of the related code are modularized in module virtual_flight_mod. In this context, a new Fortran NAMELIST flight_par was added, containing all related steering parameters. The flight module is automatically activated if a flight_par is set in the parameter file (_p3d). 

NAMELIST group name: [=#flight_par '''flight_par''']\\
----


[=#mode '''Mode:]\\
||='''Parameter Name'''  =||='''[../fortrantypes FORTRAN]\\[../fortrantypes Type]'''  =||='''Default\\Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#flight_angle '''flight_angle''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
R (100)
}}}
{{{#!td style="vertical-align:top;width: 75px"
100*45.0
}}}
{{{#!td
Horizontal flight angle (in degrees) describing the flight direction. 
For example, if [#flight_angle flight_angle] = 0.0 (180.0), the aircraft moves parallel to the x-axis in positive (negative) x-direction, respectively. If [#flight_angle flight_angle] = 90.0 (270.0), the aircraft moves parallel to the y-axis in positive (negative) y-direction, respectively. Please note, the parameters has only an effect if the respective [#leg_mode leg_mode] is in 'cyclic'-mode, else the flight direction is determined directly by [#x_start x_start], [#x_end x_end], [#y_start y_start] and [#y_end y_end]. \\
[#flight_angle flight_angle] must be within the range between 0 and 360.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#flight_end '''flight_end''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
R
}}}
{{{#!td style="vertical-align:top;width: 75px"
9999999.9
}}}
{{{#!td
End time of virtual flight measurement.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#flight_begin '''flight_begin''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
R
}}}
{{{#!td style="vertical-align:top;width: 75px"
0.0
}}}
{{{#!td
Start time of virtual flight measurement.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#leg_mode '''leg_mode''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
C (100)
}}}
{{{#!td style="vertical-align:top;width: 75px"
100*'cyclic'
}}}
{{{#!td
Flight mode, either 'cyclic' or 'return'. In case of 'cyclic', the sensor keep moving further if the end-position (see [#x_end x_end] and [#y_end y_end]) is reached, i.e. the sensor moves cyclically through the model domain. Instead, in case of 'return', the sensor turns around at the end-position and flies back, where it turns around again at the start-position and so on, i.e. the sensor only moves between start- and end-position until [#flight_end flight_end] is reached.    
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#flight_level '''flight_level''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
R (100)
}}}
{{{#!td style="vertical-align:top;width: 75px"
100*100.0
}}}
{{{#!td
Flight level in meter. Please note, level is given with respect to sea level, not with respect to the underlying terrain. 
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#max_elev_change '''max_elev_change''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
R (100)
}}}
{{{#!td style="vertical-align:top;width: 75px"
100*0.0
}}}
{{{#!td
Maximum possible elevation change in case [#rate_of_climb rate_of_climb] is not equal to zero. If the maximum elevation change is reached, the virtual aircraft start descending until the original start level is reached again. For longer flights, the sensor moves vertically between [#flight_level flight_level] and [#flight_level flight_level] + [#max_elev_change max_elev_change]. Please note, [#flight_level flight_level] + [#max_elev_change max_elev_change] must not exceed the top of the model domain.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#rate_of_climb '''rate_of_climb''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
R (100)
}}}
{{{#!td style="vertical-align:top;width: 75px"
100*0.0
}}}
{{{#!td
Vertical speed of the aircraft in meter per second.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#speed_agl '''speed_agl''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
R (100)
}}}
{{{#!td style="vertical-align:top;width: 75px"
100*25.0
}}}
{{{#!td
Horizontal speed of the aircraft above ground level in meter per second.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#x_end '''x_end''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
R (100)
}}}
{{{#!td style="vertical-align:top;width: 75px"
100* \\
999999999.0
}}}
{{{#!td
End-position of the flight leg along x in meter. Please note, this parameter has only an effect if [#leg_mode leg_mode]='return'.
In case [#leg_mode leg_mode]='cyclic', the aircraft moves cyclically through the model domain.
Moreover, [#x_end x_end] must be <= [#x_start x_start] in case of [#leg_mode leg_mode]='return'.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#x_start '''x_start''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
R (100)
}}}
{{{#!td style="vertical-align:top;width: 75px"
100* \\
999999999.0
}}}
{{{#!td
Start-position of the flight leg along x in meter. 
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#y_end '''y_end''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
R (100)
}}}
{{{#!td style="vertical-align:top;width: 75px"
100* \\
999999999.0
}}}
{{{#!td
End-position of the flight leg along y in meter. Please note, this parameter has only an effect if [#leg_mode leg_mode]='return'.
In case [#leg_mode leg_mode]='cyclic', the aircraft moves cyclically through the model domain. 
Moreover, [#y_end y_end] must be <= [#y_start y_start] in case of [#leg_mode leg_mode]='return'.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 150px"
[=#y_start '''y_start''']
}}}
{{{#!td style="vertical-align:top;width: 50px"
R (100)
}}}
{{{#!td style="vertical-align:top;width: 75px"
100* \\
999999999.0
}}}
{{{#!td
Start-position of the flight leg along y in meter. 
}}}