Release Notes
Last updated on October 1, 2024
New Features, Improvements and Bug Fixes in version 0.12.0¤
- Adding the support for Target Encoding, which is the default way to handle categorical features in binary classification problems.
- Significantly improving the
buildfunctions’ runtime and their memory consumption, especially for datasets with categorical features and missing values. - Significantly improving the runtime of the
auto_preprocessing,predictandpredict_probafunctions. - Fixing various problems concerning the handling of missing values.
- Fixing the problem where incorrect data was saved for validation purposes when calling the save function.
Improvements and Bug Fixes in version 0.11.2¤
- Solving a memory leak that happened sometimes during the various
buildandpartial_buildfunctions. - Improving the
buildfunction's runtime and their memory consumption.
Improvements and Bug Fixes in version 0.11.1¤
- Improving the
grid_searchruntime, when XGBoost, LightGBM and CatBoost are used. - The
get_coreset_sizefunction is no longer limited by license. - Fixing the problem preventing the build of the
CoresetTreeServiceDTRin some cases.
New Features, Improvements and Bug Fixes in version 0.11.0¤
- Adding logging capabilities to the library, to improve its debugging capabilities.
- Adding a verbose parameter to the various build and partial_build functions, to provide a better indication to the length of the operation.
- Adding the
get_hyperparameter_tuning_datafunction, which allows retrieving the data from the Coreset tree in such a format that allows runningGridSearchCV,BayesSearchCVand other hyperparameter tuning methods. - Improving the structure returned by
get_coreset. - Improving the
buildfunctions’ runtime and their memory consumption. - Fixing various problems when saving the Coreset tree.
New Features, Improvements and Bug Fixes in version 0.10.3¤
- Improving
grid_searchruntime, by improving its parallelism. The number of jobs run in parallel duringgrid_searchcan be controlled by defining then_jobsparameter passed to the function. - Fixing the problem when a Coreset tree was built with a
seq_column,grid_searchwithrefit=Truewould ignore the sequence-related parameters passed to the function. - Fixing the problem when a Coreset tree was built with a
seq_column,fitandgrid_searchwould not always select the optimal nodes from the Coreset tree.
New Features, Improvements and Bug Fixes in version 0.10.2¤
- Allowing to configure the
coreset_sizealso as a float, representing the ratio between each chunk and the resulting coreset. - Fixing the problem when the returned column types were incorrect in some cases when calling
get_coreset,fitorgrid_searchwithpreprocessing_stage=user.
New Features, Improvements and Bug Fixes in version 0.10.1¤
- Improving the
grid_searchtime for datasets with categorical features and missing values.
New Features, Improvements and Bug Fixes in version 0.10.0¤
- Adding an
enhancementparameter to thefit,grid_searchand the validation functions of theCoresetTreeServiceDTCandCoresetTreeServiceDTR. Setting a value of 1 to 3 for this parameter will enhance the default decision tree based training, which can improve the strength of the model, but will increase the training run time.
Bug Fixes in version 0.9.1¤
- Fixing the problem when a Coreset tree was built with a
seq_columnon a dataset including categorical features,predictandpredict_probawould sometimes fail.
New Features, Improvements and Bug Fixes in version 0.9.0¤
- Allowing to execute
get_coreset,fit,grid_searchand the validation functions on a subset of the data of the Coreset tree (such as certain date ranges), by defining a sequence column (seq_column), in theDataParamsstructure passed during the initialization of the class, which can then be used to filter the data. - Improving the
buildtime, by improving the parallelism of the Coreset Tree construction. The number of jobs run in parallel duringbuildcan be controlled by defining then_jobsparameter passed to the function.
New Features, Improvements and Bug Fixes in version 0.8.1¤
- Fixing a licensing issue.
New Features, Improvements and Bug Fixes in version 0.8.0¤
- An additional CoresetTreeService for all decision tree regression-based problems has been added to the library. This service can be used to create regression-based Coresets for all libraries including: XGBoost, LightGBM, CatBoost, Scikit-learn and others.
- Improving the default Coreset tree created when
chunk_sizeandcoreset_sizeare not provided during the initialization of the class. -
grid_searchwas extended to return a Pandas DataFrame with the score of each hyperparameter combination and fold. - Improving the
grid_searchtime.
New Features, Improvements and Bug Fixes in version 0.7.0¤
- Coresets can now be built when the dataset has missing values. The library will automatically handle them during the build process (as Coresets can only be built without missing values).
- Significantly improving the
predictandpredict_probatime for datasets with categorical features. predictandpredict_probawill now automatically preprocesses the data according to thepreprocessing_stageused to train the model.- Improving the automatic detection of categorical features.
- It is now possible to define the model class, used to train the model on the coreset, when initializing the CoresetTreeService class, using the
model_clsparameter. - Enhancing the
grid_searchfunction to run on unsupervised datasets. - Fixing the problem when
grid_searchwould fail afterremove_samplesorfilter_out_sampleswere called.
New Features, Improvements and Bug Fixes in version 0.6.0¤
- Replacing the
save_allparameter passed when initializing all classes, with thechunk_sample_ratioparameter, which indicates the size of the sample that will be taken and saved from each chunk on top of the Coreset for the validation methods. - Significantly improving the build time for datasets with categorical features.
grid_search,cross_validateandholdout_validateall receive now thepreprocessing_stageparameter, same as thefitfunction.fitreturns now the data inpreprocessing_stage=autoby default when Scikit-learn or XGBoost are used to train the model and inpreprocessing_stage=userby default when LightGBM or CatBoost are used to train the model.- Fixing the problem when both
modelandmodel_paramswere passed tofit,grid_search,cross_validateandholdout_validate,model_paramswere ignored. - Fixing the problem when a single Coreset was created for the entire dataset and
get_cleaning_sampleswas called withclass_size={"class XXX": "all"}, the returned result was faulty.
New Features and Improvements in version 0.5.0¤
- Coresets can now be built using categorical features. The library will automatically one-hot encode them during the build process (as Coresets can only be built with numeric features).
get_coresetcan now return the data according to three datapreprocessing_stage=original– The dataset as it is handed to the Coreset’s build function.preprocessing_stage=user– The dataset after any user defined data preprocessing (default).preprocessing_stage=auto– The dataset after any automatic data preprocessing done by the library, such as one-hot encoding and converting Boolean fields to numeric. The features (X), can also be returned as a sparse matrix or an array, controlled by thesparse_outputparameter (applicable only forpreprocessing_stage=auto).fitcan now return the data according to twopreprocessing_stage=autois the default when Scikit-learn is used to train the model.preprocessing_stage=useris the default when XGBoost, LightGBM or CatBoost are used to train the model.- Adding a new
auto_preprocessingfunction, allowing the user to preprocess the (test) data, as it was automatically done by the library during the Coreset’s build function. - Fixing the problem where the library’s Docstrings did not show up in some IDEs.
New Features and Improvements in version 0.4.0¤
- Adding support for Python 3.11.
- Allowing to create a CoresetTreeService, which can be used for both training and cleaning (
optimized_for=['cleaning', 'training']). - The CoresetTreeService can now handle datasets that do not fit into the device’s memory also for cleaning purposes (for training purposes this was supported from the initial release).
- The
get_important_samplesfunction was renamed toget_cleaning_samplesto improve the clarity of its purpose. - Adding hyperparameter tuning capabilities to the library with the introduction of the
grid_search()function, which works in a similar manner to Scikit-learn’s GridSearchCV class, only dramatically faster, as it utilizes the Coreset tree. Introducing also thecross_validate()andholdout_validate()functions, which can be used directly or as the validation method as part of thegrid_search()function. - Further improving the error messages for some of the data processing problems users encountered.
Bug Fixes in version 0.3.1¤
- build and build_partial now read the data in chunks in the size of chunk_size when the file format allows it (CSV, TSV), to reduce the memory footprint when building the Coreset tree.
New Features and Improvements in version 0.3.0¤
- An additional CoresetTreeService for all decision tree classification-based problems has been added to the library. This service can be used to create classification-based Coresets for all libraries including: XGBoost, LightGBM, CatBoost, Scikit-learn and others.
- Improving the results get_coreset returns in case the Coreset tree is not perfectly balanced.
- Improving the data handling capabilities, when processing the input data provided to the different build functions, such as supporting pandas.BooleanDtype and pandas.Series and returning clearer error messages for some of the data processing problems encountered.
New Features and Improvements in version 0.2.0¤
- Additional CoresetTreeServices for linear regression, K-Means, PCA and SVD have been added to the library.
- Significantly reducing the memory footprint by up to 50% especially during the various build and partial_build functions.
- Data is read in chunks in the size of
chunk_sizewhen the file format allows it (CSV, TSV), to reduce the memory footprint when building the Coreset tree. - Significantly improving the get_coreset time on large datasets.
- Significantly improving the save time and changing the default save format to pickle.
- Significantly improving the importance calculation when the number of data instances per class is lower than the number of features.
- Allowing to save the entire dataset and not just the selected samples, by setting the
save_allparameter during the initialization of the class. Whenoptimized_for='cleaning'save_allis True by default and whenoptimized_for='training'it is False by default. - Allowing to define certain columns in the dataset as properties (
props). Properties, won’t be used to compute the Coreset or train the model, but it is possible to filter_out_samples on them or to pass them in theselect_from_functionof get_important_samples.