Qstarz

labda.parsers.Qstarz

TO-DO...

from_csv

from_csv(
    path: Path | str,
    *,
    datetime_format: str | None = None,
    timezone: str | ZoneInfo | None = None
) -> Subject

Parses a QStarz file in CSV format into a LABDA's data object.

Warning

Due to the potentially inconsistent structure of legacy CSV files, achieving fully automated and accurate parsing with this parser is challenging. Consequently, errors might occur during the parsing process. Therefore, it is currently considered experimental.

Parameters:

Name	Type	Description	Default
path	Path | str	The path to the Qstarz file.	required
datetime_format	str | None	The strftime to parse time, e.g. "%d/%m/%Y". See strftime documentation for more info.	None
timezone	str | ZoneInfo | None	The timezone which the data comes from. If not provided, time will be timezone-naive.	None

Returns:

Name	Type	Description
Subject	Subject	The LABDA's data object.

Example

from labda.parsers import Qstarz

sbj = Qstarz.from_csv(
    "joel_miller.csv",
    datetime_format="%d/%m/%Y %H:%M:%S",
    timezone="America/Chicago",
)