load_ksol#

skfp.datasets.expansionrx.load_ksol(data_dir: str | PathLike | None = None, as_frame: bool = False, verbose: bool = False, force_update: bool = False) → DataFrame | tuple[list[str], ndarray]#

Load the KSOL dataset from the ExpansionRx-OpenADMET challenge.

The task is to predict the kinetic solubility (KSOL) of molecules [1] [2].

Tasks

1

Task type

regression

Total samples

7298

Recommended split

time

Recommended metric

MAE
Parameters:

  • data_dir ({None, str, path-like}, default=None) – Path to the root data directory. If None, currently set scikit-learn directory is used, by default $HOME/scikit_learn_data.

  • as_frame (bool, default=False) – If True, returns the raw DataFrame with columns: “SMILES”, “label”. Otherwise, returns SMILES as list of strings, and labels as a NumPy array (1D float vector).

  • verbose (bool, default=False) – If True, progress bar will be shown for downloading or loading files.

  • force_update (bool, default=False) – If True, always re-download the dataset from HuggingFace Hub, even if it is already present locally. If False, the dataset is downloaded only if it is not yet available locally.

Returns:

data – Depending on the as_frame argument, one of: - Pandas DataFrame with columns: “SMILES”, “label” - tuple of: list of strings (SMILES), NumPy array (labels)

Return type:

pd.DataFrame or tuple(list[str], np.ndarray)

References

Examples

>>> from skfp.datasets.expansionrx import load_ksol
>>> dataset = load_ksol()
>>> dataset  
(['Cc1c2ccncc2cc2c3cc(OCCN(C)C)ccc3n(C)c12', ..., 'CN(C)CCNc1nc(Nc2cncnc2)cc2c(-c3cncc(N4CCN(C)CC4)c3)cccc12'], \
array([121., ..., 251.]))