Changes between Version 30 and Version 31 of doc/app/radiation_parameters

Timestamp:

Oct 22, 2018 1:01:52 PM (6 years ago)

Author:

moh.hefny

Comment:

--

doc/app/radiation_parameters

@@ -208 +208 @@
 |----------------
 {{{#!td style="vertical-align:top"
+[=#mrt_nlevels '''mrt_nlevels''']
+}}}
+{{{#!td style="vertical-align:top"
+I
+}}}
+{{{#!td style="vertical-align:top"
+0
+}}}
+{{{#!td
+Number of vertical boxes above surface for which to calculate mean radiant temperature (MRT).
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#mrt_skip_roof '''mrt_skip_roof''']
+}}}
+{{{#!td style="vertical-align:top"
+L
+}}}
+{{{#!td style="vertical-align:top"
+.T.
+}}}
+{{{#!td
+Parameter to skip calculating mean radiant temperature (MRT) above the roof surfaces.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#mrt_include_sw '''mrt_include_sw''']
+}}}
+{{{#!td style="vertical-align:top"
+L
+}}}
+{{{#!td style="vertical-align:top"
+.T.
+}}}
+{{{#!td
+Parameter to include SW radiation into the mean radiant temperature (MRT) calculation. If you want to include [#rad_mrt_sw] in the output, then mrt_include_sw should set to TRUE.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
 [=#net_radiation '''net_radiation''']
 }}}
@@ -346 +385 @@
 |----------------
 {{{#!td style="vertical-align:top"
-[=#mrt_factors '''mrt_factors''']
+[=#raytrace_mpi_rma '''raytrace_mpi_rma''']
 }}}
 {{{#!td style="vertical-align:top"
@@ -355 +394 @@
 }}}
 {{{#!td
-Parameter to generate extra view factors for specific surfaces to calculate MRT during the post processing.
-
-Please note: if set to TRUE, then extra input file (MRT_TARGETS) is needed to set the ID of the surface as well as its coordinates. The model will write out unformated file contains all the mutually visible surfaces for each requested surface along with its type, coordinates, view factor, and transparency.
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#rma_lad_raytrace '''rma_lad_raytrace''']
-}}}
-{{{#!td style="vertical-align:top"
-L
-}}}
-{{{#!td style="vertical-align:top"
-.F.
-}}}
-{{{#!td
-Parameter to use One-sided communication (MPI-RMA) to access LAD array for raytracing.
-
-For large domain it is recommended to use MPI-RMA to access LAD array for raytracing instead of allocating the global array for each processor. This saves memory and allow for simulations of large domains.
-
-Please note: For Intel compiler, if you observe performance degradation with an MPI application that utilizes the RMA functionality (i.e. {{{rma_lad_raytrace = .TRUE.}}}), you are recommended to set {{{I_MPI_SCALABLE_OPTIMIZATION = 0}}} to get a performance gain.
+Parameter to use One-sided communication (MPI-RMA) to access LAD array and grid surfaces for raytracing.
+
+For large domain it is recommended to use MPI-RMA to access LAD array and a window of surfaces for raytracing instead of allocating the global arraies for each processor. This saves memory and allows for simulations of large domains.
+
+Please note:
+- When using fixed resolution discretization of view factors (i.e. {{{rad_angular_discretization = .TRUE.}}}), raytrace_mpi_rma MUST be set to .TRUE. when parallelization is applied. See [#rad_angular_discretization].
+- For Intel compiler, if you observe performance degradation with an MPI application that utilizes the RMA functionality (i.e. {{{rma_lad_raytrace = .TRUE.}}}), you are recommended to set {{{I_MPI_SCALABLE_OPTIMIZATION = 0}}} to get a performance gain.
 }}}
 |----------------
@@ -421 +447 @@
 RTM is usually set according to the existance of vertical urban/land surface or trees. If set to FALSE, no RTM is used even when there are vertical urban/land surface or trees in the domain. This simply means that all surfaces will receive radiation fluxes directly from the radiation model without considering other radiation processes such as reflections.
 }}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#rad_angular_discretization '''rad_angular_discretization''']
+}}}
+{{{#!td style="vertical-align:top"
+L
+}}}
+{{{#!td style="vertical-align:top"
+.T.
+}}}
+{{{#!td
+Parameter to use fixed resolution discretization of view factors for reflected radiation (as opposed to all mutually visible pairs).
+
+Please note:
+- When using fixed resolution discretization of view factors (i.e. {{{rad_angular_discretization = .TRUE.}}}), raytrace_mpi_rma MUST be set to .TRUE. when parallelization is applied. See [#raytrace_mpi_rma].
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#raytrace_discrete_azims '''raytrace_discrete_azims''']
+}}}
+{{{#!td style="vertical-align:top"
+I
+}}}
+{{{#!td style="vertical-align:top"
+80
+}}}
+{{{#!td
+Number of discretization steps for azimuth (out of 360 degrees) used to discretize surfaces to calculate the sky view factors, surface-surface view factor, and direct solar visibility for all surfaces.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#raytrace_discrete_elevs '''raytrace_discrete_elevs''']
+}}}
+{{{#!td style="vertical-align:top"
+I
+}}}
+{{{#!td style="vertical-align:top"
+40
+}}}
+{{{#!td
+Number of discretization steps for elevation  used to discretize surfaces to calculate the sky view factors, surface-surface view factor, and direct solar visibility for all surfaces.
+}}}