voxcity.simulator_gpu.solar.volumetric
======================================

.. py:module:: voxcity.simulator_gpu.solar.volumetric

.. autoapi-nested-parse::

   Volumetric radiative flux calculation for palm-solar.

   Computes 3D radiation fields at each grid cell, not just at surfaces.
   Based on PALM's radiation_volumetric_flux feature.

   Key outputs:
   - skyvf_vol: Volumetric sky view factor at each (i, j, k)
   - swflux_vol: Omnidirectional volumetric SW flux at each (i, j, k)
   - swflux_reflected_vol: Reflected radiation from surfaces at each (i, j, k)
   - shadow_top: Shadow height for each solar direction

   Reflected radiation mode:
   - When include_reflections=True, the volumetric flux includes radiation
     reflected from buildings, ground, and tree surfaces
   - Reflections are traced from each surface element to volumetric grid cells
   - Uses Beer-Lambert attenuation through vegetation



Classes
-------

.. toctree::
   :hidden:

   /autoapi/voxcity/simulator_gpu/solar/volumetric/VolumetricFluxMode
   /autoapi/voxcity/simulator_gpu/solar/volumetric/VolumetricFluxCalculator

.. autoapisummary::

   voxcity.simulator_gpu.solar.volumetric.VolumetricFluxMode
   voxcity.simulator_gpu.solar.volumetric.VolumetricFluxCalculator