voxcity.visualizer.renderer.PyVistaRenderer
===========================================

.. py:class:: voxcity.visualizer.renderer.PyVistaRenderer

   Renderer that uses PyVista to produce multi-view images from meshes or VoxCity.


   .. py:method:: render_city(city: voxcity.models.VoxCity, projection_type: str = 'perspective', distance_factor: float = 1.0, output_directory: str = 'output', voxel_color_map: str|dict = 'default', *, rotation: bool = False, rotation_frames_per_segment: int = 60, rotation_close_loop: bool = False, rotation_file_prefix: str = 'city_rotation', image_size: tuple[int, int] | None = None, fixed_scene_bounds_real: tuple[tuple[float,float,float], tuple[float,float,float]] | None = None, building_sim_mesh=None, building_value_name: str = 'svf_values', building_colormap: str = 'viridis', building_vmin=None, building_vmax=None, building_nan_color: str = 'gray', building_opacity: float = 1.0, render_voxel_buildings: bool = False, ground_sim_grid=None, ground_dem_grid=None, ground_z_offset: float | None = None, ground_view_point_height: float | None = None, ground_colormap: str = 'viridis', ground_vmin=None, ground_vmax=None)

      Render city to static images with optional simulation overlays.

      :param city: VoxCity object to render
      :type city: VoxCity
      :param projection_type: "perspective" or "orthographic"
      :type projection_type: str
      :param distance_factor: Camera distance multiplier
      :type distance_factor: float
      :param output_directory: Directory to save rendered images
      :type output_directory: str
      :param voxel_color_map: Color mapping for voxel classes
      :type voxel_color_map: str or dict
      :param rotation: If True, generate rotating isometric frames instead of multi-view snapshots.
      :type rotation: bool
      :param rotation_frames_per_segment: Number of frames between each isometric anchor when rotation=True.
      :type rotation_frames_per_segment: int
      :param rotation_close_loop: If True, returns smoothly to the starting anchor when rotation=True.
      :type rotation_close_loop: bool
      :param rotation_file_prefix: Filename prefix for rotation frames when rotation=True.
      :type rotation_file_prefix: str
      :param image_size: Static rendering output image size (width, height). If None, uses default.
      :type image_size: (int, int) or None
      :param building_sim_mesh: Building mesh with simulation results
      :type building_sim_mesh: trimesh.Trimesh, optional
      :param building_value_name: Metadata key for building values
      :type building_value_name: str
      :param building_colormap: Colormap for building values
      :type building_colormap: str
      :param building_vmin: Color scale limits for buildings
      :type building_vmin: float, optional
      :param building_vmax: Color scale limits for buildings
      :type building_vmax: float, optional
      :param building_nan_color: Color for NaN values
      :type building_nan_color: str
      :param building_opacity: Building mesh opacity
      :type building_opacity: float
      :param render_voxel_buildings: Whether to render voxel buildings when building_sim_mesh is provided
      :type render_voxel_buildings: bool
      :param ground_sim_grid: Ground-level simulation grid
      :type ground_sim_grid: np.ndarray, optional
      :param ground_dem_grid: DEM grid for ground surface positioning
      :type ground_dem_grid: np.ndarray, optional
      :param ground_z_offset: Height offset for ground surface
      :type ground_z_offset: float, optional
      :param ground_view_point_height: Alternative height parameter
      :type ground_view_point_height: float, optional
      :param ground_colormap: Colormap for ground values
      :type ground_colormap: str
      :param ground_vmin: Color scale limits for ground
      :type ground_vmin: float, optional
      :param ground_vmax: Color scale limits for ground
      :type ground_vmax: float, optional