Changes between Version 247 and Version 248 of doc/app/initialization_parameters
- Timestamp:
- Oct 21, 2014 2:37:59 PM (10 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
doc/app/initialization_parameters
v247 v248 2634 2634 2635 2635 [=#canopy '''Canopy:]\\\\ 2636 '''Attention:''' Starting at revision 1485, the plant canopy model is fully modularized. Therefore, the plant canopy model is now steered using the new NAMELIST [../canpar# canopy_par], and no longer in NAMELIST {{{inipar}}}.2636 '''Attention:''' Starting at '''revision 1485''', the plant canopy model is fully modularized. Therefore, the plant canopy model is now steered using the new NAMELIST [../canpar# canopy_par], and no longer in NAMELIST {{{inipar}}}. 2637 2637 ||='''Parameter Name''' =||='''[../fortrantypes FORTRAN]\\[../fortrantypes Type]''' =||='''Default\\Value''' =||='''Explanation''' =|| 2638 2638 |---------------- … … 2649 2649 Canopy mode.\\\\ 2650 2650 Besides using the default value, that will create a horizontally homogeneous plant canopy that extends over the total horizontal extension of the model domain, the user may add code to the user interface (see [#3.5.1 3.5.1]) subroutine {{{user_init_plant_canopy}}} to allow further canopy modes.\\\\ 2651 The setting of '''canopy_mode''' becomes only active, if [#plant_canopy plant_canopy] has been set ''.T.'' and a non-zero [#drag_coefficient drag_coefficient] has been defined. 2651 The setting of '''canopy_mode''' becomes only active, if [#plant_canopy plant_canopy] has been set ''.T.'' and a non-zero [#drag_coefficient drag_coefficient] has been defined.\\\\ 2652 '''Attention:''' Starting at '''revision 1485''', steering parameters for the plant canopy model belong to the new NAMELIST [../canpar#canopy_mode canopy_par]. 2652 2653 }}} 2653 2654 |---------------- … … 2666 2667 It is assumed that solar radiation penetrates the canopy and warms the foliage which, in turn, warms the air in contact with it.\\\\ 2667 2668 '''Note:'''\\ 2668 Instead of using the value prescribed by [#surface_heatflux surface_heatflux], the near surface heat flux is determined from an exponential function that is dependent on the cumulative leaf_area_index (Shaw and Schumann (1992, Boundary Layer Meteorol., 61, 47-64)). 2669 Instead of using the value prescribed by [#surface_heatflux surface_heatflux], the near surface heat flux is determined from an exponential function that is dependent on the cumulative leaf_area_index (Shaw and Schumann (1992, Boundary Layer Meteorol., 61, 47-64)).\\\\ 2670 '''Attention:''' Starting at '''revision 1485''', steering parameters for the plant canopy model belong to the new NAMELIST [../canpar#cthf canopy_par]. 2669 2671 }}} 2670 2672 |---------------- … … 2680 2682 {{{#!td 2681 2683 Drag coefficient used in the {{{plant_canopy_model}}}.\\\\ 2682 This parameter has to be non-zero, if the parameter [#plant_canopy plant_canopy] is set ''.T.''. 2684 This parameter has to be non-zero, if the parameter [#plant_canopy plant_canopy] is set ''.T.''.\\\\ 2685 '''Attention:''' Starting at '''revision 1485''', steering parameters for the plant canopy model belong to the new NAMELIST [../canpar#canopy_drag_coeff canopy_par], and parameter '''drag_coefficient''' is renamed [../canpar#canopy_drag_coeff canopy_drag_coeff]. 2683 2686 }}} 2684 2687 |---------------- … … 2694 2697 {{{#!td 2695 2698 Surface value of the leaf area density (in m^2^/m^3^).\\\\ 2696 This parameter assigns the value of the leaf area density '''lad''' at the surface (k=0). Starting from this value, the leaf area density profile is constructed with [#lad_vertical_gradient lad_vertical_gradient] and [#lad_vertical_gradient_level lad_vertical_gradient_level]. 2699 This parameter assigns the value of the leaf area density '''lad''' at the surface (k=0). Starting from this value, the leaf area density profile is constructed with [#lad_vertical_gradient lad_vertical_gradient] and [#lad_vertical_gradient_level lad_vertical_gradient_level].\\\\ 2700 '''Attention:''' Starting at '''revision 1485''', steering parameters for the plant canopy model belong to the new NAMELIST [../canpar#lad_surface canopy_par]. 2697 2701 }}} 2698 2702 |---------------- … … 2708 2712 {{{#!td 2709 2713 Gradient(s) of the leaf area density (in m^2^/m^4^).\\\\ 2710 This leaf area density gradient holds starting from the height level defined by [#lad_vertical_gradient_level lad_vertical_gradient_level] (precisely: for all uv levels k where zu(k) > lad_vertical_gradient_level, lad(k) is set: lad(k) = lad(k-1) + dzu(k) * '''lad_vertical_gradient''') up to the level defined by [#pch_index pch_index]. Above that level lad(k) will automatically be set to 0.0. A total of 10 different gradients for 11 height intervals (10 intervals if lad_vertical_gradient_level(1) = 0.0) can be assigned. The leaf area density at the surface is assigned via [#lad_surface lad_surface]. 2714 This leaf area density gradient holds starting from the height level defined by [#lad_vertical_gradient_level lad_vertical_gradient_level] (precisely: for all uv levels k where zu(k) > lad_vertical_gradient_level, lad(k) is set: lad(k) = lad(k-1) + dzu(k) * '''lad_vertical_gradient''') up to the level defined by [#pch_index pch_index]. Above that level lad(k) will automatically be set to 0.0. A total of 10 different gradients for 11 height intervals (10 intervals if lad_vertical_gradient_level(1) = 0.0) can be assigned. The leaf area density at the surface is assigned via [#lad_surface lad_surface].\\\\ 2715 '''Attention:''' Starting at '''revision 1485''', steering parameters for the plant canopy model belong to the new NAMELIST [../canpar#lad_vertical_gradient canopy_par]. 2711 2716 }}} 2712 2717 |---------------- … … 2722 2727 {{{#!td 2723 2728 Height level from which on the gradient of the leaf area density defined by [#lad_vertical_gradient lad_vertical_gradient] is effective (in m).\\\\ 2724 The height levels have to be assigned in ascending order. The default values result in a leaf area density that is constant with height up to the top of the plant canopy layer defined by [#pch_index pch_index]. For the piecewise construction of temperature profiles see [#lad_vertical_gradient lad_vertical_gradient]. 2729 The height levels have to be assigned in ascending order. The default values result in a leaf area density that is constant with height up to the top of the plant canopy layer defined by [#pch_index pch_index]. For the piecewise construction of temperature profiles see [#lad_vertical_gradient lad_vertical_gradient].\\\\ 2730 '''Attention:''' Starting at '''revision 1485''', steering parameters for the plant canopy model belong to the new NAMELIST [../canpar#lad_vertical_gradient_level canopy_par]. 2725 2731 }}} 2726 2732 |---------------- … … 2736 2742 {{{#!td 2737 2743 Concentration of a passive scalar at the surface of a leaf (in K m/s).\\\\ 2738 This parameter is only of importance in cases in that both, [#plant_canopy plant_canopy] and [#passive_scalar passive_scalar], are set ''.T..'' The value of the concentration of a passive scalar at the surface of a leaf is required for the parametrisation of the sources and sinks of scalar concentration due to the canopy. 2744 This parameter is only of importance in cases in that both, [#plant_canopy plant_canopy] and [#passive_scalar passive_scalar], are set ''.T..'' The value of the concentration of a passive scalar at the surface of a leaf is required for the parametrisation of the sources and sinks of scalar concentration due to the canopy.\\\\ 2745 '''Attention:''' Starting at '''revision 1485''', steering parameters for the plant canopy model belong to the new NAMELIST [../canpar# canopy_par], and parameter '''leaf_surface_concentration''' is renamed [../canpar#leaf_surface_conc leaf_surface_conc]. 2739 2746 }}} 2740 2747 |---------------- … … 2750 2757 {{{#!td 2751 2758 Grid point index (scalar) of the upper boundary of the plant canopy layer.\\\\ 2752 Above '''pch_index''' the arrays of leaf area density and [#drag_coeffient drag_coeffient] are automatically set to zero in case of [#plant_canopy plant_canopy] = ''.T.''. Up to '''pch_index''' a leaf area density profile can be prescribed by using the parameters [#lad_surface lad_surface], [#lad_vertical_gradient lad_vertical_gradient] and [#lad_vertical_gradient_level lad_vertical_gradient_level]. 2759 Above '''pch_index''' the arrays of leaf area density and [#drag_coeffient drag_coeffient] are automatically set to zero in case of [#plant_canopy plant_canopy] = ''.T.''. Up to '''pch_index''' a leaf area density profile can be prescribed by using the parameters [#lad_surface lad_surface], [#lad_vertical_gradient lad_vertical_gradient] and [#lad_vertical_gradient_level lad_vertical_gradient_level].\\\\ 2760 '''Attention:''' Starting at '''revision 1485''', steering parameters for the plant canopy model belong to the new NAMELIST [../canpar#pch_index canopy_par]. 2753 2761 }}} 2754 2762 |---------------- … … 2769 2777 If '''plant_canopy''' and [#passive_scalar passive_scalar] are set ''.T.'', the canopy acts as an additional scalar source or sink, respectively. The source/sink strength depends on the scalar concentration at the leaf surface, which generally does not vary with time in PALM, and which can be specified with parameter [#leaf_surface_concentration leaf_surface_concentration].\\\\ 2770 2778 Additional heating by the plant canopy is taken into account, if the default value of parameter [#cthf cthf] is altered in the parameter file. In that case, the value of [#surface_heatflux surface_heatflux] specified in the parameter file is not used in the model. Instead, the near-surface heat flux is derived from an exponential function that depends on the cumulative leaf area index.\\\\ 2771 '''plant_canopy''' = ''.T.'' is only allowed with a non-zero [#drag_coefficient drag_coefficient]. 2779 '''plant_canopy''' = ''.T.'' is only allowed with a non-zero [#drag_coefficient drag_coefficient].\\\\ 2780 '''Attention:''' Starting at '''revision 1485''', steering parameter '''plant_canopy''' no longer exists. This FORTRAN {{{LOGICAL}}} is now automatically set to ''.TRUE.'' if the NAMELIST [../canpar# canopy_par] is included in the parameter file ({{{_p3d}}}). 2772 2781 }}} 2773 2782 |---------------- … … 2783 2792 {{{#!td 2784 2793 Scalar exchange coefficient for a leaf (dimensionless).\\\\ 2785 This parameter is only of importance in cases in that both, [#plant_canopy plant_canopy] and [#passive_scalar passive_scalar], are set ''.T.''. The value of the scalar exchange coefficient is required for the parametrisation of the sources and sinks of scalar concentration due to the canopy. 2794 This parameter is only of importance in cases in that both, [#plant_canopy plant_canopy] and [#passive_scalar passive_scalar], are set ''.T.''. The value of the scalar exchange coefficient is required for the parametrisation of the sources and sinks of scalar concentration due to the canopy.\\\\ 2795 '''Attention:''' Starting at '''revision 1485''', steering parameters for the plant canopy model belong to the new NAMELIST [../canpar# canopy_par], and parameter '''scalar_exchange_coefficient''' is renamed [../canpar#leaf_scalar_exch_coeff leaf_scalar_exch_coeff]. 2786 2796 }}} 2787 2797 |----------------
