artist.data_parser.paint_calibration_parser

Attributes

log

A logger for the paint calibration data parser.

Classes

PaintCalibrationDataParser

Initialize the the paint calibration data parser.

Module Contents

artist.data_parser.paint_calibration_parser.log: A logger for the paint calibration data parser.

class artist.data_parser.paint_calibration_parser.PaintCalibrationDataParser(sample_limit: int | None = None, centroid_extraction_method: str = paint_mappings.UTIS_KEY)

Bases: artist.data_parser.calibration_data_parser.CalibrationDataParser

Initialize the the paint calibration data parser.

Parameters

sample_limitint | None: The number specifying the maximum number of samples to be loaded (default is None).
centroid_extraction_methodstr: The method by which the focal spot centroid was extracted (default is the centroid extracted by UTIS).

centroid_extraction_method

parse_data_for_reconstruction(heliostat_data_mapping: list[tuple[str, list[pathlib.Path], list[pathlib.Path]]], heliostat_group: artist.field.heliostat_group.HeliostatGroup, scenario: artist.scenario.scenario.Scenario, bitmap_resolution: torch.Tensor = torch.tensor([artist.util.index_mapping.bitmap_resolution, artist.util.index_mapping.bitmap_resolution]), device: torch.device | None = None) → tuple[torch.Tensor, torch.Tensor, torch.Tensor, torch.Tensor, torch.Tensor, torch.Tensor]

Extract measured fluxes and their respective calibration properties data.

Parameters

heliostat_data_mappinglist[tuple[str, list[pathlib.Path], list[pathlib.Path]]]: The mapping from heliostat to calibration data files.
heliostat_groupHeliostatGroup: The heliostat group.
scenarioScenario: The scenario.
bitmap_resolutiontorch.Tensor: The resolution of all bitmaps during reconstruction (default is torch.tensor([256,256])). Tensor of shape [2].
devicetorch.device | None: The device on which to perform computations or load tensors and models (default is None). If None, ARTIST will automatically select the most appropriate device (CUDA or CPU) based on availability and OS.

Returns

The measured flux density distributions.: Tensor of shape [number_of_active_heliostats, bitmap_resolution_e, bitmap_resolution_u].
torch.Tensor: The calibration focal spots. Tensor of shape [number_of_calibration_data_points, 4].
torch.Tensor: The incident ray directions. Tensor of shape [number_of_calibration_data_points, 4].
torch.Tensor: The motor positions. Tensor of shape [number_of_calibration_data_points, 2].
torch.Tensor: A mask with active heliostats and their replications. Tensor of shape [number_of_heliostats].
torch.Tensor: The target area mapping for the heliostats. Tensor of shape [number_of_active_heliostats].

_parse_calibration_data(heliostat_calibration_mapping: list[tuple[str, list[pathlib.Path]]], heliostat_names: list[str], target_area_names: list[str], power_plant_position: torch.Tensor, device: torch.device | None = None) → tuple[torch.Tensor, torch.Tensor, torch.Tensor, torch.Tensor, torch.Tensor]

Extract calibration data from PAINT calibration files.

Parameters

heliostat_calibration_mappinglist[tuple[str, list[pathlib.Path]]]: The mapping of heliostats and their calibration data files.
power_plant_positiontorch.Tensor: The power plant position. Tensor of shape [3].
heliostat_nameslist[str]: All possible heliostat names.
target_area_nameslist[str]: All possible target area names.
devicetorch.device | None: The device on which to perform computations or load tensors and models (default is None). If None, ARTIST will automatically select the most appropriate device (CUDA or CPU) based on availability and OS.

Returns

torch.Tensor: The calibration focal spots. Tensor of shape [number_of_calibration_data_points, 4].
torch.Tensor: The incident ray directions. Tensor of shape [number_of_calibration_data_points, 4].
torch.Tensor: The motor positions. Tensor of shape [number_of_calibration_data_points, 2].
torch.Tensor: A mask with active heliostats and their replications. Tensor of shape [number_of_heliostats].
torch.Tensor: The target area mapping for the heliostats. Tensor of shape [number_of_active_heliostats].