artist.data_parser.stral_scenario_parser
========================================

.. py:module:: artist.data_parser.stral_scenario_parser


Attributes
----------

.. autoapisummary::

   artist.data_parser.stral_scenario_parser.log


Functions
---------

.. autoapisummary::

   artist.data_parser.stral_scenario_parser.extract_stral_deflectometry_data


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

.. py:data:: log

   A logger for the stral data loader.


.. py:function:: extract_stral_deflectometry_data(stral_file_path: pathlib.Path, device: torch.device | None = None) -> tuple[torch.Tensor, torch.Tensor, list[torch.Tensor], list[torch.Tensor]]

   Extract deflectometry data from a ``STRAL`` file.

   Parameters
   ----------
   stral_file_path : pathlib.Path
       The file path to the ``STRAL`` data that will be converted.
   device : torch.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 facet translation vectors.
       Tensor of shape [number_of_facets, 4].
   torch.Tensor
       The facet canting vectors.
       Tensor of shape [number_of_facets, 2, 4].
   list[torch.Tensor]
       The surface points per facet.
   list[torch.Tensor]
       The surface normals per facet.