include warning in np.resize() docs
include warning in np.resize() docs

I find it counterintuitive that resizing a numpy array does NOT consider dimensions independent, but simply takes the first N elements of the input array that fit into the output array. I was expecting something more like `cv2.resize()` where axes are treated separately, and some form of interpolation is applied to each dimension.

numpy resizes an old 5x5x2 array into a new array with new = np.resize(old, (4, 4, 2)) by simply copying the first 4 * 4 * 2 entries from old into new. (e.g. old[0, 4, :] becomes new[1, 0, :])
This is a problem if we would like simple interpolation, or if different axes represent different entities. (If the above example is an image, the top right most pixel would get warped all the way to the left, which is most likely not the intention)

In response to my issue #11478: 'resize() is unintuitive by not treating axes separately?'
A warning in the docs might prevent some confusion.

For a discussion on the issue and a possible solution, see <https://github.com/numpy/numpy/issues/11478>
seberg/numpy,MSeifert04/numpy,mattip/numpy,jakirkham/numpy,ahaldane/numpy,ahaldane/numpy,gfyoung/numpy,grlee77/numpy,pbrod/numpy,gfyoung/numpy,WarrenWeckesser/numpy,MSeifert04/numpy,simongibbons/numpy,mhvk/numpy,pbrod/numpy,mhvk/numpy,madphysicist/numpy,WarrenWeckesser/numpy,ahaldane/numpy,madphysicist/numpy,rgommers/numpy,shoyer/numpy,seberg/numpy,pizzathief/numpy,pdebuyl/numpy,mattip/numpy,WarrenWeckesser/numpy,rgommers/numpy,endolith/numpy,grlee77/numpy,ahaldane/numpy,shoyer/numpy,rgommers/numpy,numpy/numpy,MSeifert04/numpy,simongibbons/numpy,numpy/numpy,shoyer/numpy,endolith/numpy,anntzer/numpy,mhvk/numpy,MSeifert04/numpy,charris/numpy,jorisvandenbossche/numpy,seberg/numpy,endolith/numpy,pdebuyl/numpy,ahaldane/numpy,pdebuyl/numpy,anntzer/numpy,anntzer/numpy,jakirkham/numpy,numpy/numpy,madphysicist/numpy,pbrod/numpy,grlee77/numpy,pizzathief/numpy,rgommers/numpy,jorisvandenbossche/numpy,simongibbons/numpy,mhvk/numpy,charris/numpy,pbrod/numpy,pizzathief/numpy,madphysicist/numpy,abalkin/numpy,abalkin/numpy,simongibbons/numpy,anntzer/numpy,mattip/numpy,grlee77/numpy,shoyer/numpy,mhvk/numpy,shoyer/numpy,jakirkham/numpy,WarrenWeckesser/numpy,madphysicist/numpy,mattip/numpy,abalkin/numpy,charris/numpy,numpy/numpy,jakirkham/numpy,simongibbons/numpy,charris/numpy,WarrenWeckesser/numpy,jorisvandenbossche/numpy,seberg/numpy,pbrod/numpy,pizzathief/numpy,pizzathief/numpy,gfyoung/numpy,pdebuyl/numpy,endolith/numpy,grlee77/numpy,jorisvandenbossche/numpy,MSeifert04/numpy,jorisvandenbossche/numpy,jakirkham/numpy