sf_quant.data.load_scores_by_date

sf_quant.data.load_scores_by_date(date_: date, names: list[str] = None) → DataFrame

Load a Polars DataFrame of scores data for a single date.

Parameters

date_datetime.date

Date of the data frame.

nameslist of str, optional

List of signal names to filter the data frame by. If None (default), all signal names are included.

Returns

polars.DataFrame

A DataFrame containing scores data on the specified date.

Examples

>>> import sf_quant as sf
>>> import datetime as dt
>>> date_ = dt.date(2024, 1, 3)
>>> df = sf.data.load_scores_by_date(
...     date_=date_,
...     names=["momentum"]
... )
>>> df.head()
shape: (5, 4)
┌────────────┬─────────┬─────────────┬───────────┐
│ date       ┆ barrid  ┆ signal_name ┆ score     │
│ ---        ┆ ---     ┆ ---         ┆ ---       │
│ date       ┆ str     ┆ str         ┆ f64       │
╞════════════╪═════════╪═════════════╪═══════════╡
│ 2022-01-03 ┆ USA3871 ┆ momentum    ┆ 0.324434  │
│ 2022-01-03 ┆ USBDIJ1 ┆ momentum    ┆ 1.239903  │
│ 2022-01-03 ┆ USA91R1 ┆ momentum    ┆ -0.019291 │
│ 2022-01-03 ┆ USBFCZ1 ┆ momentum    ┆ 0.17957   │
│ 2022-01-03 ┆ USAA181 ┆ momentum    ┆ 0.227943  │
└────────────┴─────────┴─────────────┴───────────┘