[InessaPawson]

Moves the “NumPy for MATLAB users” page from the NumPy user guide into numpy/numpy-tutorials.

Part of the work on addressing numpy/numpy#33233.

A follow-up PR in numpy/numpy will replace the original page with a redirect stub.

[InessaPawson]

@bsipocz I pushed 6f0ca89 to make the Python examples executable and removed the page from ignore_testing to test the page with the CI test suite. Please note that the snippets inside the list-table rows stay static.

Tested locally with jupytext --to notebook, pytest --nbval-lax (3 cells pass), myst start.

[InessaPawson]

@bsipocz While porting I noticed several issues in the guide. I’m keeping this PR as a straight migration, will address those in a follow-up.

[melissawm]

Thanks @InessaPawson ! Left some optional comments 😄

[melissawm]

Would it be too difficult to test making these tables scrollable? They are ok as they are, but the long paragraphs may be more readable if they have a bit more space on the page. Not sure which solution would be best but I'd love to be able to compare if it's not too much trouble!

[melissawm]

I think these emoticons don't translate as well anymore and people are more used to emojis, can we replace them?

[rossbar]

+1 from me - AIUI this is essentially just copying over the numpy-for-matlab-users article from the numpy user guide over here.

I also generally agree with @bsipocz that it'd be worthwhile to actually convert the code snippets into something that is actually executable¹, but that can be done in follow-up. It makes sense to me to have a single PR that leaves the content as-is and just deals with the move/translation between sites.

Thanks @InessaPawson

Footnotes

1. the very first column is a good example: info is a numpy fn, so should be np.info, whereas help is a Python fn. ↩

[rossbar]

One final thought - I think adding the "Migration Guide" subheading is fine, but I also wouldn't be opposed to making this a top-level document (i.e. one that shows up on the nav bar). Something else that could be worried about in follow-up!