Various fixes for heterogeneous utilities

[fwyzard]

PR description:

Add missing #includes under DataFormats/SoATemplate.

Implement alpaka::atomicInc variants:

• deduce the limit from the type;
• saturate to the limit instead of wrapping to 0.

Fix a typo in the documentation.

PR validation:

None.

If this PR is a backport please specify the original PR and why you need to backport that PR. If this PR will be backported please specify to which release cycle the backport is meant for:

To be backported to 15.0.x for data taking.

[cmsbuild]

cms-bot internal usage

[fwyzard]

type bugfix

[fwyzard]

enable gpu

[fwyzard]

please test

[cmsbuild]

+code-checks

Logs: https://cmssdt.cern.ch/SDT/code-checks/cms-sw-PR-47605/44115

• There are other open Pull requests which might conflict with changes you have proposed:
  • File DataFormats/SoATemplate/interface/SoACommon.h modified in PR(s): New constructor for the SoAView and aggregate method for Collections #47306
  • File DataFormats/SoATemplate/interface/SoALayout.h modified in PR(s): New constructor for the SoAView and aggregate method for Collections #47306

[cmsbuild]

A new Pull Request was created by @fwyzard for master.

It involves the following packages:

• DataFormats/SoATemplate (heterogeneous)
• HeterogeneousCore/AlpakaCore (heterogeneous)
• HeterogeneousCore/AlpakaInterface (heterogeneous)

@fwyzard, @makortel can you please review it and eventually sign? Thanks.
@makortel, @missirol, @mmusich, @rovere this is something you requested to watch as well.
@antoniovilela, @mandrenguyen, @rappoccio, @sextonkennedy you are the release manager for this.

cms-bot commands are listed here

[makortel]

On host parallel backends (that we don't use at the moment) this line is not thread safe (actually, strictly speaking with the default Grids hierarchy level this line is not thread safe even with host serial backend if the same address is accessed concurrently from multiple kernels). To guarantee thread safety on host the load from address would have to be atomic.

[fwyzard]

I see.
I will have to think how it can be implemented in a portable way, or specialised for the various backends.