Rectools

Added
- `Debias` mechanism for classification, ranking and auc metrics. New parameter `is_debiased` to `calc_from_confusion_df`, `calc_per_user_from_confusion_df` methods of classification metrics, `calc_from_fitted`, `calc_per_user_from_fitted` methods of auc and rankning (`MAP`) metrics, `calc_from_merged`, `calc_per_user_from_merged` methods of ranking (`NDCG`, `MRR`) metrics. ([152](https://github.com/MobileTeleSystems/RecTools/pull/152))
- `nbformat >= 4.2.0` dependency to `[visuals]` extra ([169](https://github.com/MobileTeleSystems/RecTools/pull/169))
- `filter_interactions` method of `Dataset` ([177](https://github.com/MobileTeleSystems/RecTools/pull/177))
- `on_unsupported_targets` parameter to `recommend` and `recommend_to_items` model methods ([177](https://github.com/MobileTeleSystems/RecTools/pull/177))
- Use nmslib-metabrainz for Python 3.11 and upper ([180](https://github.com/MobielTeleSystems/RecTools/pull/180))

Fixed
- `display()` method in `MetricsApp` ([169](https://github.com/MobileTeleSystems/RecTools/pull/169))
- `IntraListDiversity` metric computation in `cross_validate` ([177](https://github.com/MobileTeleSystems/RecTools/pull/177))
- Allow warp-kos loss for LightFMWrapperModel ([175](https://github.com/MobileTeleSystems/RecTools/pull/175))

Removed
- [Breaking] `assume_external_ids` parameter in `recommend` and `recommend_to_items` model methods ([177](https://github.com/MobileTeleSystems/RecTools/pull/177))

Added
- Extended Theory&Practice RecSys baselines tutorial ([139](https://github.com/MobileTeleSystems/RecTools/pull/139))
- `MetricsApp` to create plotly scatterplot widgets for metric-to-metric trade-off analysis ([140](https://github.com/MobileTeleSystems/RecTools/pull/140), [#154](https://github.com/MobileTeleSystems/RecTools/pull/154))
- `Intersection` metric ([148](https://github.com/MobileTeleSystems/RecTools/pull/148))
- `PartialAUC` and `PAP` metrics ([149](https://github.com/MobileTeleSystems/RecTools/pull/149))
- New params (`tol`, `maxiter`, `random_state`) to the `PureSVD` model ([130](https://github.com/MobileTeleSystems/RecTools/pull/130))
- Recommendations data quality metrics: `SufficientReco`, `UnrepeatedReco`, `CoveredUsers` ([155](https://github.com/MobileTeleSystems/RecTools/pull/155))
- `r_precision` parameter to `Precision` metric ([155](https://github.com/MobileTeleSystems/RecTools/pull/155))

Fixed
- Used `rectools-lightfm` instead of pure `lightfm` that allowed to install it using `poetry>=1.5.0` ([165](https://github.com/MobileTeleSystems/RecTools/pull/165))
- Added restriction to `pytorch` version for MacOSX + x86_64 that allows to install it on such platforms ([142](https://github.com/MobileTeleSystems/RecTools/pull/142))
- `PopularInCategoryModel` fitting for multiple times, `cross_validate` compatibility, behaviour with empty category interactions ([163](https://github.com/MobileTeleSystems/RecTools/pull/163))

Added
- Warm users/items support in `Dataset` ([77](https://github.com/MobileTeleSystems/RecTools/pull/77))
- Warm and cold users/items support in `ModelBase` and all possible models ([77](https://github.com/MobileTeleSystems/RecTools/pull/77), [#120](https://github.com/MobileTeleSystems/RecTools/pull/120), [#122](https://github.com/MobileTeleSystems/RecTools/pull/122))
- Warm and cold users/items support in `cross_validate` ([77](https://github.com/MobileTeleSystems/RecTools/pull/77))
- [Breaking] Default value for train dataset type and params for user and item dataset types in `DSSMModel` ([122](https://github.com/MobileTeleSystems/RecTools/pull/122))
- [Breaking] `n_factors` and `deterministic` params to `DSSMModel` ([122](https://github.com/MobileTeleSystems/RecTools/pull/122))
- Hit Rate metric ([124](https://github.com/MobileTeleSystems/RecTools/pull/124))
- Python `3.11` support (without `nmslib`) ([126](https://github.com/MobileTeleSystems/RecTools/pull/126))
- Python `3.12` support (without `nmslib` and `lightfm`) ([126](https://github.com/MobileTeleSystems/RecTools/pull/126))

Changed
- Changed the logic of choosing random sampler for `RandomModel` and increased the sampling speed ([120](https://github.com/MobileTeleSystems/RecTools/pull/120))
- [Breaking] Changed the logic of `RandomModel`: now the recommendations are different for repeated calls of recommend methods ([120](https://github.com/MobileTeleSystems/RecTools/pull/120))
- Torch datasets to support warm recommendations ([122](https://github.com/MobileTeleSystems/RecTools/pull/122))
- [Breaking] Replaced `include_warm` parameter in `Dataset.get_user_item_matrix` to pair `include_warm_users` and `include_warm_items` ([122](https://github.com/MobileTeleSystems/RecTools/pull/122))
- [Breaking] Renamed torch datasets and `dataset_type` to `train_dataset_type` param in `DSSMModel` ([122](https://github.com/MobileTeleSystems/RecTools/pull/122))
- [Breaking] Updated minimum versions of `numpy`, `scipy`, `pandas`, `typeguard` ([126](https://github.com/MobileTeleSystems/RecTools/pull/126))
- [Breaking] Set restriction `scipy < 1.13` ([126](https://github.com/MobileTeleSystems/RecTools/pull/126))

Removed
- [Breaking] `return_external_ids` parameter in `recommend` and `recommend_to_items` model methods ([77](https://github.com/MobileTeleSystems/RecTools/pull/77))
- [Breaking] Python `3.7` support ([126](https://github.com/MobileTeleSystems/RecTools/pull/126))

Added
- `VisualApp` and `ItemToItemVisualApp` widgets for visual comparison of recommendations ([80](https://github.com/MobileTeleSystems/RecTools/pull/80), [#82](https://github.com/MobileTeleSystems/RecTools/pull/82), [#85](https://github.com/MobileTeleSystems/RecTools/pull/85), [#115](https://github.com/MobileTeleSystems/RecTools/pull/115))
- Methods for conversion `Interactions` to raw form and for getting raw interactions from `Dataset` ([69](https://github.com/MobileTeleSystems/RecTools/pull/69))
- `AvgRecPopularity (Average Recommendation Popularity)` to `metrics` ([81](https://github.com/MobileTeleSystems/RecTools/pull/81))
- Added `normalized` parameter to `AvgRecPopularity` metric ([89](https://github.com/MobileTeleSystems/RecTools/pull/89))
- Added `EASE` model ([107](https://github.com/MobileTeleSystems/RecTools/pull/107))

Changed
- Loosened `pandas`, `torch` and `torch-light` versions for `python >= 3.8` ([58](https://github.com/MobileTeleSystems/RecTools/pull/58))

Fixed
- Bug in `Interactions.from_raw` method ([58](https://github.com/MobileTeleSystems/RecTools/pull/58))
- Mistakes in formulas for Serendipity and MIUF in docstrings ([115](https://github.com/MobileTeleSystems/RecTools/pull/115))
- Examples reproducibility on Google Colab ([115](https://github.com/MobileTeleSystems/RecTools/pull/115))

Added
- Ability to pass internal ids to `recommend` and `recommend_to_items` methods and get internal ids back ([70](https://github.com/MobileTeleSystems/RecTools/pull/70))
- `rectools.model_selection.cross_validate` function ([71](https://github.com/MobileTeleSystems/RecTools/pull/71), [#73](https://github.com/MobileTeleSystems/RecTools/pull/73))

Changed
- Loosened `lightfm` version, now it's possible to use 1.16 and 1.17 ([72](https://github.com/MobileTeleSystems/RecTools/pull/72))

Fixed
- Small bug in `LastNSplitter` with incorrect `i_split` in info ([70](https://github.com/MobileTeleSystems/RecTools/pull/70))

Added
- LightFM wrapper inference speed benchmark ([60](https://github.com/MobileTeleSystems/RecTools/pull/60))
- iALS with features quality benchmark ([60](https://github.com/MobileTeleSystems/RecTools/pull/60))

Changed
- Updated attrs version ([56](https://github.com/MobileTeleSystems/RecTools/pull/56))
- Optimized inference for vector models with EUCLIDEAN distance using `implicit` library topk method ([57](https://github.com/MobileTeleSystems/RecTools/pull/57))
- Changed features processing example ([60](https://github.com/MobileTeleSystems/RecTools/pull/60))