Gestionnaire de fichiers

class offre_realisee.domain.port.file_system_handler.FileSystemHandler

abstract get_calendrier_scolaire(**kwargs) → DataFrame

Récupération des données de calendrier scolaire.

Parameters

**kwargs :

Keyword arguments supplémentaires passés à la fonction pandas read_parquet.

Returns

dfDataFrame

DataFrame du calendrier scolaire.

abstract get_daily_mesure_qs(date: date, dsp: str, mesure_type: MesureType, **kwargs) → DataFrame

Récupération des données de mesure QS par jour.

Parameters

datedate

Date des données de mesure QS.

dspstr

DSP des données de mesure QS.

mesure_typeMesureType

Le type de mesure (ponctualite, regularite).

suffix_by_agg: Dict[AggregationLevel, Callable]

Dictionnaire de fonction de génération de suffix basé sur la date et le calendrier scolaire.

**kwargsdict

Options complémentaires de lecture.

Returns

dfDataFrame

DataFrame d’offre réalisée par jour.

abstract get_daily_offre_realisee(date: date, dsp: str = '', ligne: str = '') → DataFrame

Récupération des données d’offre réalisée pour une date.

Parameters

datedate

Date pour laquelle nous voulons les données d’offre théorique.

dspstr

DSP pour laquelle les mesures de qualité de service doivent être calculées, par défaut à « « .

lignestr

Ligne pour laquelle les mesures de qualité de service doivent être calculées, par défaut à « « .

Returns

dfDataFrame

DataFrame d’offre réalisée.

abstract read_offre_realisee(**kwargs) → DataFrame

Récupération des données d’offre réalisée.

Parameters

**kwargs :

Keyword arguments supplémentaires passés à la fonction pandas read_parquet.

Returns

dfDataFrame

DataFrame d’offre réalisée.

abstract save_daily_mesure_qs(df_mesure_qs: DataFrame, date: date, dsp: str, mesure_type: MesureType) → None

Sauvegarde du DataFrame de mesure de Qualité de Service (QS).

Parameters

df_mesure_qsDataFrame

DataFrame que nous voulons sauvegarder.

datedate

Date des données de mesure QS.

dspstr

DSP des données de mesure QS.

mesure_typeMesureType

Le type de mesure (ponctualite, regularite).

abstract save_error_mesure_qs(df_mesure_qs: DataFrame, date: date, mesure_type: MesureType, dsp: str, ligne: str) → None

Sauvegarde du DataFrame de mesure de Qualité de Service (QS) en erreur.

Parameters

df_mesure_qsDataFrame

DataFrame que nous voulons sauvegarder.

datedate

Date des données de mesure QS.

mesure_typeMesureType

Le type de mesure (ponctualite, regularite).

dspstr

DSP des données de mesure QS.

lignestr

Ligne des données de mesure QS

abstract save_mesure_qs_by_aggregation(df_mesure_qs: DataFrame, suffix: str, date_range: tuple[date, date], dsp: str, aggregation_level: AggregationLevel, mesure_type: MesureType, periode_ete: tuple[str], list_journees_exceptionnelles: list[date], window_name: str = '', **kwargs) → None

Sauvegarde du DataFrame de mesure de Qualité de Service (QS).

Parameters

df_mesure_qsDataFrame

DataFrame que nous voulons sauvegarder.

suffix: str

Suffix de l’agrégation, par exemple “2024_01” pour une agrégation mensuelle.

date_rangeTuple[date, date]

Plage de dates pour l’agrégation.

dspstr

DSP à agréger.

aggregation_levelAggregationLevel

Niveau d’agrégation des données.

mesure_typeMesureType

Type de mesure à agréger (ponctualite ou regularite).

periode_etetuple[date, date]

Période d’été sous forme de tuple (début, fin) - Requis si l’aggregation concerne une period.

list_journees_exceptionnellesOptional[List[date]]

La liste des journées exceptionnelles à exclure (ex: émeutes, grèves…). Par défaut, cette liste est vide.

window_nameOptional[str]

Nom de la fenêtre d’aggregation, optionnel par défaut égal à « « 

**kwargsdict

Options complémentaires d’écriture.