voxcity.simulator_gpu.visibility.LandmarkVisibilityCalculator
=============================================================

.. py:class:: voxcity.simulator_gpu.visibility.LandmarkVisibilityCalculator(domain)

   GPU-accelerated Landmark Visibility calculator.

   Computes visibility of landmark buildings from observation points
   throughout the domain.


   .. py:attribute:: domain


   .. py:attribute:: nx


   .. py:attribute:: ny


   .. py:attribute:: nz


   .. py:attribute:: dx


   .. py:attribute:: dy


   .. py:attribute:: dz


   .. py:method:: set_landmarks_from_positions(positions: numpy.ndarray)

      Set landmark positions directly.

      :param positions: Array of shape (n_landmarks, 3) with (x, y, z) coordinates



   .. py:method:: set_landmarks_from_voxel_value(voxel_data: numpy.ndarray, landmark_value: int = -30)

      Set landmark positions from voxel data based on a marker value.

      :param voxel_data: 3D voxel class array
      :param landmark_value: Voxel value marking landmarks



   .. py:method:: compute_visibility_map(voxel_data: numpy.ndarray = None, view_height_voxel: int = 0, tree_k: float = 0.6, tree_lad: float = 1.0) -> numpy.ndarray

      Compute landmark visibility map.

      :param voxel_data: 3D voxel class array (optional if domain has masks)
      :param view_height_voxel: Observer height in voxels above ground
      :param tree_k: Tree extinction coefficient
      :param tree_lad: Leaf area density

      :returns: 2D array with 1 where landmark is visible, 0 otherwise, nan for invalid