Add replace option to subsample and rename function to sample

[gokceneraslan]

so that we can do sampling with replacement. It can be useful for bootstrap samples i.e. sc.pp.subsample(adata, n_obs=adata.n_obs, replace=True). We can also sample fractions > 1, but then it's not really subsampling.

[gokceneraslan]

Maybe we should make a new function called sc.pp.sample?

[ivirshup]

I'd like to merge this.

I think we could just rename the function, and deprecate subsample. I'd like the name sample more for this function if we could add a dim argument so users can subsample on the variable as well.

[ivirshup]

Looks good! Just a few minor comments.

[codecov]

Codecov Report

Attention: Patch coverage is 96.20253% with 3 lines in your changes missing coverage. Please review.

Project coverage is 76.37%. Comparing base (7131500) to head (396b21a).

Files with missing lines	Patch %	Lines
src/scanpy/_compat.py	91.66%	2 Missing ⚠️
src/scanpy/preprocessing/_simple.py	97.82%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #943      +/-   ##
==========================================
- Coverage   76.50%   76.37%   -0.13%     
==========================================
  Files         111      112       +1     
  Lines       12874    12927      +53     
==========================================
+ Hits         9849     9873      +24     
- Misses       3025     3054      +29     

Files with missing lines	Coverage Δ
src/scanpy/preprocessing/__init__.py	100.00% <100.00%> (ø)
src/scanpy/preprocessing/_deprecated/sampling.py	100.00% <100.00%> (ø)
src/scanpy/preprocessing/_simple.py	91.29% <97.82%> (+1.34%)	⬆️
src/scanpy/_compat.py	72.95% <91.66%> (-8.87%)	⬇️

... and 9 files with indirect coverage changes

---- 🚨 Try these New Features:

• Flaky Tests Detection - Detect and resolve failed and flaky tests