Add Average Precision to metrics

[thibaultdvx]

Fixes #8085.

Description

Average Precision is very similar to ROCAUC, so I was very much inspired by the ROCAUC implementation.
More precisely, I created:

• AveragePrecisionMetric and compute_average_precision in monai.metrics,
• a handler called AveragePrecision in monai.handlers,
• three unittest modules: test_compute_average_precision.py, test_handler_average_precision.py and test_handler_average_precision_dist.py.

I also modified the docs to mention Average Precision.

Types of changes

• Non-breaking change (fix or new feature that would not break existing functionality).
• Breaking change (fix or new feature that would cause existing functionality to change).
• New tests added to cover the changes.
• Integration tests passed locally by running ./runtests.sh -f -u --net --coverage.
• Quick tests passed locally by running ./runtests.sh --quick --unittests --disttests.
• In-line docstrings updated.
• Documentation updated, tested make html command in the docs/ folder.

[thibaultdvx]

/build

[thibaultdvx]

hi @KumoLiu, could you please have a look at this PR?

[KumoLiu]

Thanks for the pr, overall looks good to me.

[ericspod]

Looks good to me too, I had a minor comment and it would be nice to combine the last 2 test files, it would be better to have fewer test files if possible.

[ericspod]

Hi @thibaultdvx we've updated our tests with a directory structure, if you could please look over comments and update where your test files are we can come back to this PR. Thanks!

[thibaultdvx]

Hi @ericspod @KumoLiu, sorry for the absence. I got work and forgot this PR. I'll get right on it!

[thibaultdvx]

@ericspod @KumoLiu ready for review. I don't understand the failing in CI tests, but I'm not sure it is related to my PR.

[ericspod]

Hi @thibaultdvx I'm going to merge recent changes into your branch and see if that sorts the test issues, I don't think it was related to PR either.

[ericspod]

I think this is good to go now, @KumoLiu if you could please trigger blossom, thanks.

[KumoLiu]

/build

[KumoLiu]

Hi @thibaultdvx, please help fix the format issue: https://github.com/Project-MONAI/MONAI/actions/runs/13406057032/job/37446075381?pr=8089
Then I will help trigger the test again, thanks!

[KumoLiu]

/build