jamesdolezal/slideflow: Slideflow 1.1.0-rc1

Major Features and Improvements Uncertainty quantification (UQ) Estimation of uncertainty via dropout Models can now estimate uncertainty via dropout, by setting uq=True for a ModelParams. Uncertainty is saved as the tile-level and patient-level in predictions files. Heatmaps using UQ models will display heatmaps of uncertainty by default DatasetFeatures built with UQ models now store tile-level uncertainty in DatasetFeatures.uncertainty. SlideMap includes a new function to visualize uncertainty on UMAPs, SlideMap.label_by_uncertainty(). Updated normalizers New reinhard_fast algorithm New normalizer strategy designed for computational efficiency. The reinhard_fast strategy is based on the standard reinhard normalizer with the brightness normalization step removed. This results in up to 10-fold speed improvements. New option to fit normalizers to a dataset Previously, normalizers could only be fit to a single image, which is manually specified by the user using normalizer_source, or defaulting to an internal image stored at norm/norm_tile.jpg By setting normalizer_source='dataset', a normalizer can be fit to the entire training dataset, rather than an arbitrary single image. Vectorized normalizers The reinhard and reinhard_fast normalizers have been optimized with vectorized implementation, improving normalization speed to >12,000 img/sec Normalizer logging To improve normalizer consistency when applying models to new datasets, normalizer fit parameters are now logged in the model parameters file, params.json, via the key norm_fit Blur augmentation Random gaussian blur augmentation can now be performed during training, in both Tensorflow and PyTorch backends. Enable blur augmentation by adding 'b' to the augment parameter for a set of ModelParams. Blur augmentation is now used by default. Model updates New architectures EfficientNet architectures are now supported, including EfficientNetV2B0, EfficientNetV2B1, EfficientNetV2B2, EfficientNetV2B3, EfficientNetV2S, EfficientNetV2M, and EfficientNetV2L Hidden layer improvements Hidden layers now include batch normalization post-ReLU Dropout Dropout layers now enabled for the PyTorch backend Training improvements Adds a new save_model argument to P.train(), allowing models to not be saved after training is finished. Validation splits and IDs are now logged during training mixed_precision is now an argument for P.train() instead of a project-wide setting. New regularization Adds new l1, l1_dense, l2, and l2_dense parameters in ModelParams to enable more granular control over regularization. Bug Fixes and Other Changes Predictions are now generated using a Pandas DataFrame backend Revamped errors, moved to slideflow.errors The active backend (Tensorflow or PyTorch) is now logged in models' params.json Improvements to Neptune logging Fixed bug with PDF generation during tile extraction Removed several verbose arguments for functions, which were no longer being used. Instead, control logging verbosity via the SF_LOGGING_LEVEL environmental variable. Minor documentation update