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.42857% with 3 lines in your changes missing coverage. Please review.

Project coverage is 74.12%. Comparing base (7e3dd15) to head (ce02426).
Report is 2 commits behind head on main.

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

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #943      +/-   ##
==========================================
- Coverage   76.53%   74.12%   -2.42%     
==========================================
  Files         111      112       +1     
  Lines       12881    12937      +56     
==========================================
- Hits         9859     9589     -270     
- Misses       3022     3348     +326     

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	88.48% <98.03%> (-1.47%)	⬇️
src/scanpy/_compat.py	70.00% <91.66%> (-9.44%)	⬇️

... and 21 files with indirect coverage changes