voxcity.simulator_gpu.visibility.landmark
=========================================

.. py:module:: voxcity.simulator_gpu.visibility.landmark

.. autoapi-nested-parse::

   Landmark visibility calculation using Taichi GPU acceleration.

   This module emulates the functionality of voxcity.simulator.visibility.landmark
   with GPU-accelerated ray tracing.



Classes
-------

.. toctree::
   :hidden:

   /autoapi/voxcity/simulator_gpu/visibility/landmark/LandmarkVisibilityCalculator
   /autoapi/voxcity/simulator_gpu/visibility/landmark/SurfaceLandmarkVisibilityCalculator

.. autoapisummary::

   voxcity.simulator_gpu.visibility.landmark.LandmarkVisibilityCalculator
   voxcity.simulator_gpu.visibility.landmark.SurfaceLandmarkVisibilityCalculator


Functions
---------

.. autoapisummary::

   voxcity.simulator_gpu.visibility.landmark.mark_building_by_id
   voxcity.simulator_gpu.visibility.landmark.compute_landmark_visibility
   voxcity.simulator_gpu.visibility.landmark.compute_landmark_visibility_map


Module Contents
---------------

.. py:function:: mark_building_by_id(voxcity_grid_ori: numpy.ndarray, building_id_grid_ori: numpy.ndarray, ids: List[int], mark: int = -30) -> numpy.ndarray

   Mark specific buildings in voxel data with a marker value.

   :param voxcity_grid_ori: 3D voxel class array
   :param building_id_grid_ori: 2D array of building IDs in uv layout
   :param ids: List of building IDs to mark
   :param mark: Marker value to use

   :returns: Modified voxel_data copy


.. py:function:: compute_landmark_visibility(voxel_data: numpy.ndarray, target_value: int = -30, view_height_voxel: int = 0, colormap: str = 'viridis') -> numpy.ndarray

   VoxCity-compatible landmark visibility on raw voxel data.

   Matches `voxcity.simulator.visibility.landmark.compute_landmark_visibility`.

   .. rubric:: Notes

   - Uses Taichi GPU ray tracing underneath.
   - Returns a 2D map in uv layout, consistent with voxel_data.


.. py:function:: compute_landmark_visibility_map(domain, voxel_data: numpy.ndarray, landmark_value: int = -30, view_height_voxel: int = 0, **kwargs) -> numpy.ndarray

   Compute landmark visibility map.

   :param domain: Domain object
   :param voxel_data: 3D voxel class array with landmarks marked
   :param landmark_value: Voxel value marking landmarks
   :param view_height_voxel: Observer height in voxels
   :param \*\*kwargs: Additional parameters

   :returns: 2D visibility map