Changes between Version 190 and Version 191 of doc/app/parlist

Timestamp:

Jul 13, 2016 9:28:28 AM (9 years ago)

Author:

skrueger

Comment:

--

doc/app/parlist

@@ -16 +16 @@
 
 \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
-Jump to '''[#a A] [#b B] [#c C] [#d D] [#e E] [#f F] [#g G] [#h H] [#i I] J [#k K] [#l L] [#m M] [#n N] [#o O] [#p P] [#q Q] [#r R] [#s S] [#t T] [#u U] [#v V] [#w W] X Y [#z Z]'''
+Jump to '''[#a A] [#b B] [#c C] [#d D] [#e E] [#f F] [#g G] [#h H] [#i I] J [#k K] [#l L] [#m M] [#n N] [#o O] [#p P] [#q Q] [#r R] [#s S] [#t T] [#u U] [#v V] [#w W] X [#y Y] [#z Z]'''
 \\\\
 
 ||='''Parameter Name'''  =||='''NAMELIST \\ Group'''  =||='''Parameter \\ Class'''  =|| \
 ||='''[../fortrantypes FORTRAN] \\ [../fortrantypes Type]'''  =||='''Default \\ Value'''  =||='''Explanation'''  =||
+|| [../wind_turbine_par#air_dens air_dens] || wtm || || R || 1.225 || The air density (in kg/m^3^) is necessary to convert the aerodynamic torque of the rotor into a power (in W). ||
 || [../radpar#albedo albedo] || rrtmg ||  || R || 0.2 || Surface albedo. ||
 || [../radpar#albedo_lw_diff albedo_lw_diff] || rrtmg ||  || R || depends on \\ [../radpar#albedo_type albedo_type] || Surface albedo for longwave diffuse radiation for a solar angle of 60°. ||
@@ -151 +152 @@
 || [../parpar#dt_sort_particles dt_sort_particles] || lpm || || R || 0.0 || Temporal interval for sorting particles (in s). '''Not available from release 4.0 on.''' ||
 || [../parpar#dt_write_particle_data dt_write_particle] \\ [../parpar#dt_write_particle_data _data] || lpm || || R || 9999999.9 || Temporal interval for output of particle data (in s). ||
+|| [../wind_turbine_par#dtow dtow] || wtm || || R(100) || none || Diameter of the tower of the wind turbine used below the rotor. This parameter has to be non-zero if a tower should be included. The parameter needs to be specified for every turbine separately. ||
 || [../dvrpar#dvrp_directory dvrp_directory] || dvr || || C*80 || 'default' || Name of the directory into which data created by the dvrp software shall be saved. ||
 || [../dvrpar#dvrp_file dvrp_file] || dvr || || C*80 || 'default' || Name of the file into which data created by the dvrp software shall be output. ||
@@ -176 +178 @@
 || [../d3par#force_print_header force_print_header] || run || Data output || L || .F. || Steering of header output to the local file [../iofiles#RUN_CONTROL RUN_CONTROL]. ||
 || [../inipar#galilei_transformation galilei_transformation] [=#g] || ini || Mode || L || .F. || Application of a Galilei-transformation to the coordinate system of the model. ||
+|| [../wind_turbine_par#gear_eff gear_eff] || wtm ||  || R || 1.0 || Efficiency of the gear: Loss between rotor and generator. ||
+|| [../wind_turbine_par#gear_ratio gear_ratio] || wtm ||  || R || 97.0 || Gear ratio from rotor to generator. ||
+|| [../wind_turbine_par#gen_eff gen_eff] || wtm ||  || R || 0.944 || Electric efficiency of the generator. ||
 || [../dvrpar#groundplate_color groundplate_color] || dvr || || R(3) || 0.0, 0.6, 0.0 || Color of the ground plate. ||
 || [../inipar#humidity humidity] [=#h] || ini || Mode || L || .F. || Parameter to switch on the prognostic equation for specific humidity q. ||
 || [../lsmpar#hydraulic_conductivity hydraulic_conductivity] || lsm ||  || R || depends on [../lsmpar#veg_type veg_type] || Hydraulic conductivity of the soil at saturation (in m/s). ||
+|| [../wind_turbine_par#inertia_gen inertia_gen] || wtm || || R || 534.116 || Inertia of the generator (in kg/m^2^). ||
+|| [../wind_turbine_par#inertia_rot inertia_rot] || wtm || || R || 34784179.0 || Inertia of the rotor (in kg/m^2). ||
 || [../inipar#inflow_damping_height inflow_damping_height] || ini || Boundary conditions || R || from precursor run || Height below which the turbulence signal is used for turbulence recycling (in m). ||
 || [../inipar#inflow_damping_width inflow_damping_width] || ini || Boundary conditions || R || 0.1* [../inipar#inflow_damping_height inflow] \\ [../inipar#inflow_damping_height _damping_height] || Transition range within which the turbulence signal is damped to zero (in m). ||
@@ -215 +222 @@
 || [../d3par#mask_y_loop mask_y_loop] || run || Data output || R \\ (max_masks, \\ 3) || max_masks*100* \\ (/-1.0,-1.0,-1.0/) || Loop begin, end and stride for y-coordinates of mask locations for masks (in multiples of [../d3par#mask_scale_y mask_scale_y]). ||
 || [../d3par#mask_z_loop mask_z_loop] || run || Data output || R \\ (max_masks, \\ 3) || max_masks*100* \\ (/-1.0,-1.0,-1.0/) || Loop begin, end and stride for z-coordinates of mask locations for masks (in multiples of [../d3par#mask_scale_z mask_scale_z]). ||
+|| [../wind_turbine_par#max_miss max_miss] || wtm || || R || 0.08726 || Maximum tolerated yaw misalignment (in rad). ||
+|| [../wind_turbine_par#max_torque_gen max_torque_gen] || wtm ||  || R || 47402.91 || Maximum Torque of the generator (in Nm). ||
+|| [../wind_turbine_par#max_trq_rate max_trq_rate] || wtm ||  || R || 15000.0 || Maximum generator torque rate (in Nm/s). ||
 || [../inipar#mg_cycles mg_cycles] || ini || Numerics || I ||-1|| Number of cycles to be used with the multigrid scheme. ||
 || [../inipar#mg_switch_to_pe0_level mg_switch_to] \\ [../inipar#mg_switch_to_pe0_level _pe0_level] || ini || Numerics || I || see parameter \\ description || Grid level at which data shall be gathered on PE0. ||
 || [../lsmpar#min_canopy_resistance min_canopy_resistance] || lsm ||  || R || depends on [../lsmpar#veg_type veg_type] || Minimum canopy (i.e., stomatal) resistance (in s/m). ||
 || [../parpar#min_nr_particles min_nr_particles] || lpm || || I ||50|| Minimum number of particles for which memory is allocated at every grid cell. ||
+|| [../wind_turbine_par#min_miss min_miss] || wtm || || R || 0.008726 || Minimum yaw misalignment for which the actuator stops (in rad). ||
+|| [../wind_turbine_par#min_reg15 min_reg15] || wtm || || R || 70.16224 || Lower generator speed boundary of region 1.5 (in rad/s). ||
+|| [../wind_turbine_par#min_reg2 min_reg2] || wtm || || R || 91.21091 || Lower generator speed boundary of region 2 [rad/s]. ||
 || [../lsmpar#min_soil_resistance min_soil_resistance] || lsm ||  || R || 50.0 || Minimum soil resistance (in s/m). ||
 || [../inipar#mixing_length_1d mixing_length_1d] || ini || Initialization || C*20 || 'as_in_3d_model' || Mixing length used in the 1d-model. ||
@@ -226 +239 @@
 || [../inipar#most_method most_method] || ini || Boundary conditions || C*8 || 'lookup' || Parameter that defines how the Obukhov length is calculated when a constant_flux_layer is switched on. ||
 || [../lsmpar#n_vangenuchten n_vangenuchten] || lsm ||  || R || depends on [../lsmpar#soil_type soil_type] || Value of the coefficient n for the calculation of the hydraulic conductivity of soil in the parametrization after Van Genuchten. ||
+|| [../wind_turbine_par#nairfoils nairfoils] || wtm || || I || 8 || Number of airfoils of the used turbine model. ||
 || [../inipar#nc_const nc_const] || ini || Cloud physics || R || 70.0E6 || Cloud droplet number density (in m-3). ||
 || [../parpar#n1 n1] || lpm || || R || 100.0 || Parameter of initial aerosol spectrum. ||
@@ -243 +257 @@
 || [../inipar#nsor nsor] || run || Numerics || I ||20|| Number of iterations to be used with the SOR-scheme. ||
 || [../inipar#nsor_ini nsor_ini] || ini || Numerics || I ||100|| Initial number of iterations with the SOR algorithm. ||
+|| [../wind_turbine_par#nturbines nturbines] || wtm ||  || I || 1 || Number of the turbines to be included. Maximum is 100.||
 || [../inipar#nudging nudging] || ini || Mode || L || .F. || Parameter to switch on nudging with data from larger scale models or from measurements.  ||
 || [../parpar#number_of_particle_groups number_of] \\ [../parpar#number_of_particle_groups _particle_groups] || lpm || || I ||1|| Number of particle groups to be used. ||
@@ -251 +266 @@
 || [../inipar#ocean ocean] [=#o] || ini || Mode || L || .F. || Parameter to switch on ocean runs. ||
 || [../inipar#omega omega] || ini || Physics || R ||7,29E+00|| Angular velocity of the rotating system (in rad s^-1^). ||
+|| [../wind_turbine_par#omega_rot omega_rot] || wtm ||  || R(100) || 0.0 || Initial rotational speed for each turbine (in rad s^-1^). ||
 || [../inipar#omega_sor omega_sor] || ini || Numerics || R || 1.8 || Convergence factor to be used with the SOR-scheme. ||
 || [../inipar#outflow_damping_width outflow_damping] \\ [../inipar#outflow_damping_width _width] || ini || Boundary conditions || I || MIN(20, nx/2 or ny/2) || Width of the damping range in the vicinity of the outflow (gridpoints). ||
@@ -267 +283 @@
 || [../parpar#pdz pdz] || lpm || || R(10) || 10*(zu(2) - zu(1)) || Distance along z between particles within a particle source (in m). ||
 || [../inipar#phi phi] || ini || Physics || R || 55.0 || Geographical latitude (in degrees). ||
+|| [../wind_turbine_par#phi_yaw phi_yaw] || wtm ||  || R(100) || none || Yaw angle for each turbine in degrees. A positive yaw means a rotation of the rotor in clockwise direction within the xy-plane. ||
+|| [../wind_turbine_par#pitch_add pitch_add] || wtm ||  || R(100) || 0.0 || Pitch angle for a constant pitch angle (in degrees). ||
+|| [../wind_turbine_par#pitch_control pitch_control] || wtm ||  || L || .F. || Parameter to switch on the pitch control. ||
+|| [../wind_turbine_par#pitch_rate pitch_rate] || wtm ||  || R || 8.0 || Maximum pitch rate (in degree/s). ||
 || [../sppar#plot_spectra_level plot_spectra_level] || spec || || I(100) || No level || Vertical level(s) for which horizontal spectra are to be plotted (in grid points). ||
 || [../inipar#prandtl_number prandtl_number] || ini || Physics || R || 1.0 || Ratio of the eddy diffusivities for momentum and heat (K,,m,,/K,,h,,). ||
@@ -300 +320 @@
 || [../inipar#random_heatflux random_heatflux] || ini || Mode || L || .F. || Parameter to impose random perturbations on the internal two-dimensional near surface heat flux field ''shf.'' ||
 || [../parpar#random_start_position random_start_position] || lpm || || L || .F. || Initial position of the particles is varied randomly within certain limits. ||
+|| [../wind_turbine_par#rated_genspeed rated_genspeed] || wtm || || R || 121.6805 || Rated generator speed (in rad/s). ||
+|| [../wind_turbine_par#rated_power rated_power] || wtm ||  || R || 5296610.0 || Rated power of the wind turbine (in W). ||
 || [../inipar#rayleigh_damping_factor rayleigh_damping] \\ [../inipar#rayleigh_damping_factor _factor] || ini || Numerics || R || 0.0 and/or 0.01 || Factor for Rayleigh damping. ||
 || [../inipar#rayleigh_damping_height rayleigh_damping] \\ [../inipar#rayleigh_damping_height _height] || ini || Numerics || R || 2/3*zu(nz) || Height where the Rayleigh damping starts (in m). ||
+|| [../wind_turbine_par#rcx rcx] || wtm ||  || R(100) || none || Longitudinal position of the rotor center (in m). ||
+|| [../wind_turbine_par#rcy rcy] || wtm ||  || R(100) || none || Lateral position of the rotor center (in m). ||
+|| [../wind_turbine_par#rcz rcz] || wtm ||  || R(100) || none || Vertical position of the rotor center (in m). This represents the hub height of the turbine. ||
 || [../parpar#read_particles_from_restartfile read_particles_from] \\ [../parpar#read_particles_from_restartfile _restartfile] || lpm || || L || .T. || Read particle data from the previous run. ||
 || [../inipar#recycling_width recycling_width] || ini || Boundary conditions || R || 0.1*[../inipar#nx nx]*[../inipar#dx dx] || Distance of the recycling plane from the inflow boundary (in m). ||
@@ -310 +335 @@
 || [../lsmpar#residual_moisture residual_moisture] || lsm ||  || R || depends on [../lsmpar#soil_type soil_type] || Residual soil moisture content (in m³/m³). ||
 || [../d3par#restart_time restart_time] || run || Run steering || R || 9999999.9 || Simulated time after which a restart run is to be carried out (in s). ||
+|| [../wind_turbine_par#rnac rnac] || wtm || || R(100) || none || Radius of the nacelle for each turbine (in m). This parameter has to be non-zero if the nacelle should be included. ||
 || [../lsmpar#root_fraction root_fraction] || lsm ||  || R(4) || depends on [../lsmpar#veg_type veg_type] || Root distribution over the four soil layers. ||
 || [../inipar#roughness_length roughness_length] || ini || Boundary conditions || R || 0.1 || Roughness length (in m). ||
+|| [../wind_turbine_par#rr rr] || wtm || || R(100) || 63 || Radius of the rotor (in m). ||
 || [../parpar#s1 s1] || lpm || || R || 2.0 || Parameter of initial aerosol spectrum. ||
 || [../parpar#s2 s2] || lpm || || R || 2.0 || Parameter of initial aerosol spectrum. ||
@@ -329 +356 @@
 || [../d3par#section_yz section_yz] || run || Data output || I(100) || no section || Position of cross section(s) for output of 2d (yz) vertical cross sections (grid point index i). ||
 || [../parpar#seed_follows_topography seed_follows_topography] || lpm || || L || .F. || Heights of initial particles are interpreted relative to the given topography. ||
+|| [../wind_turbine_par#segment_length segment_length] || wtm ||  || R || 1.0 || Length of each rotor segment the rotor area is divided into, in tangential direction, as factor of the grid spacing. ||
+|| [../wind_turbine_par#segment_width segment_width] || wtm ||  || R || 0.5 || Length of each rotor segment the rotor area is divided into, in radial direction, as factor of the grid spacing. ||
 || [../d3par#skip_time_data_output skip_time_data_output] || run || Data output || R || 0.0 || No data output before this interval has passed (in s). ||
 || [../d3par#skip_time_data_output_av skip_time_data] \\ [../d3par#skip_time_data_output_av _output_av] || run || Data output || R || value of [../d3par#skip_time_data_output skip_time] \\ [../d3par#skip_time_data_output _data_output] || No output of temporally averaged 2d/3d data before this interval has passed (in s). ||
@@ -341 +370 @@
 || [../d3par#skip_time_do3d skip_time_do3d] || run || Data output || R || value of [../d3par#skip_time_data_output skip_time] \\ [../d3par#skip_time_data_output _data_output] || No output of instantaneous 3d volume data before this interval has passed (in s). ||
 || [../dvrpar#slicer_range_limits_dvrp slicer_range] \\ [../dvrpar#slicer_range_limits_dvrp _limits_dvrp] || dvr || || R(2,10) || 10*(-1,1) || Ranges of values to which a color table has to be mapped (units of the respective quantity). ||
+|| [../wind_turbine_par#slope2 slope2] || wtm ||  || R || 2.332287 || Slope constant for region 2. ||
 || [../sppar#spectra_direction spectra_direction] || spec || || C*2(10) || 10*' ' || Direction(s) along which spectra are to be calculated. ||
+|| [../wind_turbine_par#speed_control speed control] || wtm ||  || L || .F. || Parameter to switch on the speed control. ||
 || [../lsmpar#soil_moisture soil_moisture] || lsm ||  || R(4) || 4*0.0 || Soil moisture distribution over the four soil layers. ||
 || [../lsmpar#soil_temperature soil_temperature] || lsm ||  || R(5) || see description || Soil temperature distribution over the four soil layers (in K). ||
@@ -359 +390 @@
 || [../d3par#termination_time_needed termination_time] [=#t] \\ [../d3par#termination_time_needed _needed] || run || Run steering || R || 35.0 || CPU time needed for terminal actions at the end of a run in batch mode (in s). ||
 || [../dvrpar#threshold threshold] || dvr || || R(10) || 0.0 || Threshold value for which an isosurface is to be created by the dvrp software. ||
+|| [../wind_turbine_par#tilt tilt] || wtm ||  || R || 0.0 || Rotor tilt of the rotor plane (in degrees). ||
+|| [../wind_turbine_par#time_turbine_on time_turbine_on] || wtm ||  || R || 0.0 || Simulation time at which the turbines are switched on. ||
 || [../radpar#time_utc_init time_utc_init] || rrtmg ||  || R || 43200.0 || UTC time at model start in seconds starting from midnight. ||
 || [../inipar#timestep_scheme timestep_scheme] || ini || Numerics || C*20 || 'runge-kutta-3' || Time step scheme to be used for integration of the prognostic variables. ||
@@ -398 +431 @@
 || [../lsmpar#wilting_point wilting_point] || lsm ||  || R || depends on [../lsmpar#soil_type soil_type] || Soil moisture at permanent wilting point (in m³/m³). ||
 || [../parpar#write_particle_statistics write_particle] \\ [../parpar#write_particle_statistics _statistics] || lpm || || L || .F. || Switch on/off output of particle information. ||
+|| [../wind_turbine_par#yaw_control yaw_control] || wtm || || L || .F. || Parameter to switch on the yaw controller. ||
+|| [../wind_turbine_par#yaw_speed yaw_speed] || wtm ||  || R || 0.005236 || Speed of the yaw actuator (in rad/s). ||
 || [../lsmpar#z0_eb z0_eb] || lsm ||  || R || depends on [../lsmpar#veg_type veg_type] || Roughness length for momentum (in m). ||
 || [../lsmpar#z0h_eb z0h_eb] || lsm ||  || R || depends on [../lsmpar#veg_type veg_type] || Roughness length for heat (in m). ||