xpectra.load_external

xpectra.load_external(study_id, feature_columns, label_encoder, trust, pre=None)

One external augmentation pool (openspecy / simple / awi2024) from the norm route.

The combined route files carry all datasets; externals are selected by their study id and are never part of load_labeled. Returns (X, y, source) on the labeled feature grid, with labels already in the 6-group scheme encoded by label_encoder. source is the per-row source_study (finer than the dataset id only for openspecy), joined from the catalog DB; it falls back to the dataset id if the catalog is absent.

Parameters:

• study_id (str)

• feature_columns (list[str])

• label_encoder (Any)

• trust (TrustConfig)

• pre (PreprocessConfig | None)

Return type:

tuple[ndarray, ndarray, ndarray]