Releases: Lightning-AI/torchmetrics
Minor patch release
[1.8.2] - 2025-09-03
Fixed
- Fixed
BinaryPrecisionRecallCurvenow returnsNaNfor precision when no predictions meet a threshold (#3227) - Fixed
precision_at_fixed_recallandrecall_at_fixed_precisionto correctly returnNaNthresholds when recall/precision conditions are not met (#3226)
Key Contributors
If we forgot someone due to not matching commit email with GitHub account, let us know :]
Full Changelog: v1.8.1...v1.8.2
Minor patch release
[1.8.1] - 2025-08-07
Changed
Fixed
- Fixed unintended
sigmoidnormalization inBinaryPrecisionRecallCurve(#3182)
Key Contributors
@iamkulbhushansingh, @PussyCat0700, @simonreise
If we forgot someone due to not matching commit email with GitHub account, let us know :]
Full Changelog: v1.8.0...v1.8.1
First video and vertex metrics
The upcoming TorchMetrics v1.8.0 release introduces three flagship metrics, each designed to address critical evaluation needs in real-world applications.
Video Multi-Method Assessment Fusion (VMAF) brings a perceptual video-quality score that closely mirrors human judgment, powering streaming services such as Netflix and YouTube to optimize encoding ladders for consistent viewer experiences and enabling video-restoration labs to quantify improvements achieved by denoising and super-resolution algorithms.
Continuous Ranked Probability Score (CRPS) enables comprehensive evaluation of full predictive distributions rather than point estimates; meteorological centers leverage CRPS to benchmark probabilistic precipitation and temperature forecasts, improving public weather alerts, while energy companies apply it to assess uncertainty in load-demand predictions and refine grid management and trading strategies.
Lip Vertex Error (LVE) measures the discrepancy between predicted and ground-truth lip landmarks to quantify audio-visual synchronization. Localization studios use LVE to validate lip-sync accuracy during film dubbing, while AR/VR developers integrate it into avatar pipelines to ensure natural mouth movements in real-time virtual meetings and social experiences.
[1.8.0] - 2025-07-23
Added
- Added
VMAFmetric to new video domain (#2991) - Added
CRPSin regression domain (#3024) - Added
aggregation_levelargument toDiceScore(#3018) - Added support for
reduction="none"toLearnedPerceptualImagePatchSimilarity(#3053) - Added support single
strinput for functional interface ofbert_score(#3056) - Enhance:
BERTScoreto evaluate hypotheses against multiple references (#3069) - Added
Lip Vertex Error (LVE)in multimodal domain (#3090) - Added
antialiasargument toFIDmetric (#3177) - Added
mixedinput format to segmentation metrics (#3176)
Changed
- Changed
data_rangeargument inPSNRmetric to be a required argument (#3178)
Removed
- Removed
zero_divisionargument fromDiceScore(#3018)
Key Contributors
@nkaenzig, @rittik9, @simonreise, @SkafteNicki
New Contributors
- @lantiga made their first contribution in #3054
- @AlexVerine made their first contribution in #3057
- @ZhiyuanChen made their first contribution in #3059
- @ahmedhshahin made their first contribution in #3101
- @gratus907 made their first contribution in #3103
- @cyyever made their first contribution in #3118
- @Armannas made their first contribution in #3124
- @alifa98 made their first contribution in #3128
- @simonreise made their first contribution in #3176
If we forgot someone due to not matching commit email with GitHub account, let us know :]
Full Changelog: v1.7.0...v1.8.0
Minor patch release
[1.7.4] - 2025-07-04
Changed
- Improved numerical stability of pearson's correlation coefficient (#3152)
Fixed
- Fixed: Ignore zero and negative predictions in retrieval metrics (#3160)
- Fixed SSIM
dist_reduce_fxwhenreduction=Nonefor distributed training (#3162, #3166) - Fixed attribute error (#3154)
- Fixed incorrect shape in
_pearson_corrcoef_update(#3168)
Key Contributors
@AymenKallala, @gratus907, @Isalia20, @rittik9
If we forgot someone due to not matching commit email with GitHub account, let us know :]
Full Changelog: v1.7.3...v1.7.4
Minor patch release
[1.7.3] - 2025-06-13
Fixed
- Fixed: ensure
WrapperMetricresetswrapped_metricstate (#3123) - Fixed
top_kinmulticlass_accuracy(#3117) - Fixed compatibility to COCO format for
pycocotools2.0.10 (#3131)
Key Contributors
If we forgot someone due to not matching commit email with GitHub account, let us know :]
Full Changelog: v1.7.2...v1.7.3
Minor patch release
[1.7.2] - 2025-05-27
Changed
- Enhance: improve performance of
_rank_data(#3103)
Fixed
- Fixed
UnboundLocalErrorinMatthewsCorrCoef(#3059) - Fixed MIFID incorrectly converts inputs to
bytedtype with custom encoders (#3064) - Fixed
ignore_indexinMultilabelExactMatch(#3085) - Fixed: disable non-blocking on MPS (#3101)
Key Contributors
@ahmedhshahin, @gratus907, @rittik9, @ZhiyuanChen
If we forgot someone due to not matching commit email with GitHub account, let us know :]
Full Changelog: v1.7.1...v1.7.2
Minor patch release
[1.7.1] - 2025-04-06
Changed
- Enhance Support Adding a
MetricCollectionto AnotherMetricCollectioninadd_metricsFunction (#3032)
Fixed
- Fixed absent class
MeanIOU(#2892) - Fixed detection IoU ignores predictions without ground truth (#3025)
- Fixed error raised in
MulticlassAccuracywhen top_k>1 (#3039)
Key Contributors
@Isalia20, @rittik9, @SkafteNicki
If we forgot someone due to not matching commit email with GitHub account, let us know :]
Full Changelog: v1.7.0...v1.7.1
More image metrics
The upcoming release of TorchMetrics is set to deliver a range of innovative features and enhancements across multiple domains, further solidifying its position as a leading tool for machine learning metrics. In the image domain, significant additions include the ARNIQA and DeepImageStructureAndTextureSimilarity metrics, which provide new insights into image quality and similarity. Additionally, the CLIPScore metric now supports more models and processors, expanding its versatility in image-text alignment tasks.
Beyond image analysis, the regression package welcomes the JensenShannonDivergence metric, offering a powerful tool for comparing probability distributions. The clustering package also sees a notable update with the introduction of the ClusterAccuracy metric, which helps evaluate the performance of clustering algorithms more effectively.
In the realm of classification, the Equal Error Rate (EER) metric has been added, providing a crucial measure for assessing the performance of classification models, particularly in scenarios where false positives and false negatives have different costs. Furthermore, the MeanAveragePrecision metric now includes a functional interface, enhancing its usability and flexibility for users.
These updates collectively enhance the capabilities of TorchMetrics, making it an even more comprehensive and indispensable resource for machine learning practitioners and researchers.
[1.7.0] - 2025-03-20
Added
- Additions to image domain:
- Added
JensenShannonDivergencemetric to regression package (#2992) - Added
ClusterAccuracymetric to cluster package (#2777) - Added
Equal Error Rate (EER)to classification package (#3013) - Added functional interface to
MeanAveragePrecisionmetric (#3011)
Changed
- Making
num_classesoptional forone-hotinputs inMeanIoU(#3012)
Removed
- Removed
Dicefrom classification (#3017)
Fixed
- Fixed edge case in integration between class-wise wrapper and metric tracker (#3008)
- Fixed
IndexErrorinMultiClassAccuracywhen usingtop_kwith single sample (#3021)
Key Contributors
@Isalia20, @LorenzoAgnolucci, @nathanpainchaud, @rittik9, @SkafteNicki
If we forgot someone due to not matching commit email with GitHub account, let us know :]
Full Changelog: v1.6.0...v1.7.0
Minor patch release
[1.6.3] - 2024-03-13
Fixed
- Fixed logic in how metric states referencing is handled in
MetricCollection(#2990) - Fixed integration between class-wise wrapper and metric tracker (#3004)
Key Contributors
If we forgot someone due to not matching commit email with GitHub account, let us know :]
Full Changelog: v1.6.2...v1.6.3
Minor patch release
[1.6.2] - 2024-02-28
Added
- Added
zero_divisionargument toDiceScorein segmentation package (#2860) - Added
cache_sessiontoDNSMOSmetric to control caching behavior (#2974) - Added
disableoption tonan_strategyin basic aggregation metrics (#2943)
Changed
- Make
num_classesoptional for classification in case of micro averaging (#2841) - Enhance
Clip_Scoreto calculate similarities between same modalities (#2875)
Fixed
- Fixed
DiceScorewhen there is zero overlap between predictions and targets (#2860) - Fixed
MeanAveragePrecisionforaverage="micro"when 0 label is not present (#2968) - Fixed corner-case in
PearsonCorrCoefwhen input is constant (#2975) - Fixed
MetricCollection.updategives identical results (#2944) - Fixed missing
kwargsinPITmetric for permutation wise mode (#2977) - Fixed multiple errors in the
_final_aggregationfunction forPearsonCorrCoef(#2980) - Fixed incorrect CLIP-IQA type hints (#2952)
Key Contributors
@baskrahmer, @czmrand, @rbedyakin, @rittik9, @SkafteNicki, @wooseopkim
If we forgot someone due to not matching commit email with GitHub account, let us know :]
Full Changelog: v1.6.1...v1.6.2