wolfhece.assets.pie.zones_asset

Module Contents

class wolfhece.assets.pie.zones_asset.PieZonesAsset(values: Sequence[float], center: tuple[float, float] = (0.0, 0.0), radius: float = 10.0, *, labels: Sequence[str] | None = None, colors: Sequence[tuple[int, int, int] | tuple[int, int, int, int]] | None = None, start_angle_deg: float = 90.0, clockwise: bool = False, sectors_as_independent_zones: bool = False, legend_visible: bool = True, legend_show_percent: bool = True, legend_show_value: bool = False, legend_offset_factor: float = 0.65, legend_position_mode: str = 'auto', legend_positions: Sequence[tuple[float, float] | None] | None = None, legend_text_color: tuple[int, int, int] = (0, 0, 0), fill_clock_animation: bool = False, fill_anim_speed: float = 1.0, smoothing: bool = True, border_enabled: bool = True, border_width: float = 1.0, border_color: tuple[int, int, int] = (25, 25, 25), store_fraction_in_z: bool = True, idx: str = 'pie_chart', parent=None, mapviewer=None)

Pie asset factory producing native Zones for mapviewer rendering.

DEFAULT_COLORS: tuple[tuple[int, int, int, int], Ellipsis] = ((41, 98, 255, 235), (0, 166, 118, 235), (255, 122, 69, 235), (138, 79, 255, 235), (255, 178, 0,...

model

center_x

center_y

radius

start_angle_deg

clockwise = False

sectors_as_independent_zones = False

legend_visible = True

legend_show_percent = True

legend_show_value = False

legend_offset_factor

legend_position_mode = 'auto'

legend_positions

legend_text_color

fill_clock_animation = False

fill_anim_speed

smoothing = True

border_enabled = True

border_width

border_color = (25, 25, 25)

store_fraction_in_z = True

idx = ''

parent = None

mapviewer = None

_colors

_normalize_legend_positions(positions: Sequence[tuple[float, float] | None] | None) → list[tuple[float, float] | None]

_to_rgba(color: tuple[int, Ellipsis]) → tuple[int, int, int, int]

_normalize_colors(colors: Sequence[tuple[int, int, int] | tuple[int, int, int, int]] | None) → list[tuple[int, int, int, int]]

_slice_color(idx: int) → tuple[int, int, int, int]

_legend_text(slc: wolfhece.assets.pie.distribution.PieSlice) → str

_legend_color_for_fill(rgba: tuple[int, int, int, int]) → tuple[int, int, int]

Return fixed legend text color for exterior positioning.

Legends are now outside pie sectors, so contrast with fill is irrelevant. Use the configured legend_text_color for consistency across all legend items.

_sector_centroid(slc: wolfhece.assets.pie.distribution.PieSlice) → tuple[float, float]

Centroid of a circular sector in world coordinates.

_slice_mid_angle_rad(slc: wolfhece.assets.pie.distribution.PieSlice) → float

_legend_alignment_for_x(x: float) → str

_legend_world_height(slc: wolfhece.assets.pie.distribution.PieSlice) → float

Legend text height in world units, scaled to slice size.

_legend_width_factor(legend_text: str) → float

Approximate width/height ratio of rendered legend text.

_legend_world_length(slc: wolfhece.assets.pie.distribution.PieSlice, legend_text: str) → float

_legend_bbox(x: float, y: float, width: float, height: float, alignment: str) → tuple[float, float, float, float]

_bbox_overlap_area(bbox1: tuple[float, float, float, float], bbox2: tuple[float, float, float, float]) → float

_bbox_circle_penalty(bbox: tuple[float, float, float, float]) → float

_auto_legend_radial_factor() → float

_auto_legend_layout(slices: Sequence[wolfhece.assets.pie.distribution.PieSlice]) → list[tuple[float, float, str, float, float]]

_legend_layout(slices: Sequence[wolfhece.assets.pie.distribution.PieSlice]) → list[tuple[float, float, str, float, float]]

_nb_arc_points(angle_delta_deg: float) → int

_sector_vertices(start_deg: float, end_deg: float, z_value: float) → list[wolfhece.PyVertexvectors.wolfvertex]

_configure_vector_style(vec: wolfhece.PyVertexvectors.vector, rgba: tuple[int, int, int, int], slc: wolfhece.assets.pie.distribution.PieSlice, legend_layout: tuple[float, float, str, float, float] | None = None) → None

to_zones() → wolfhece.PyVertexvectors.Zones

Build and return a native Zones object representing the pie chart.

add_to_mapviewer(mapviewer, id: str | None = None, ToCheck: bool = True) → wolfhece.PyVertexvectors.Zones

Build and add the pie as a vector object in a mapviewer.

wolfhece.assets.pie.zones_asset.build_pie_zones(values: Sequence[float], center: tuple[float, float], radius: float, **kwargs) → wolfhece.PyVertexvectors.Zones

Convenience function returning a pie chart as Zones.