pygmt.surface: Add aliases for "C", "L", "M", and "T"

[jhtong33]

Description of proposed changes
adding T=''tensor in surface.py

Fixes #2222

Reminders

• Run make format and make check to make sure the code follows the style guide.
• Add tests for new features or tests that would have caught the bug that you're fixing.
• Add new public functions/methods/classes to doc/api/index.rst.
• Write detailed docstrings for all functions/methods.
• If wrapping a new module, open a 'Wrap new GMT module' issue and submit reasonably-sized PRs.
• If adding new functionality, add an example to docstrings or tutorials.
• Use underscores (not hyphens) in names of Python files and directories.

Slash Commands

You can write slash commands (/command) in the first line of a comment to perform
specific operations. Supported slash commands are:

• /format: automatically format and lint the code
• /test-gmt-dev: run full tests on the latest GMT development version

[welcome]

💖 Thanks for opening this pull request! 💖

Please make sure you read our contributing guidelines and abide by our code of conduct.

A few things to keep in mind:

• If you need help writing tests, take a look at the existing ones for inspiration. If you don't know where to start, let us know and we'll walk you through it.
• All new features should be documented. It helps to write the docstrings for your functions/classes before writing the code. This will help you think about your code design and results in better code.
• No matter what, we are really grateful that you put in the effort to do this! 🎉

[yvonnefroehlich]

Welcome 🙂 and great that you started working on this issue @JingHuiTong!

Please add the related issue number #2222 under Fixes # by editing your initial comment. Then this issue is automatically closed when this PR is merged.

Beside adding an alias for T to the alias list, we also need to add some documentation (docstrings) to explain the usage of this parameter. You may want to orientate yourself on the upstream GMT documentation at https://docs.generic-mapping-tools.org/dev/surface.html#t.

pygmt/pygmt/src/surface.py

Lines 55 to 71 in 8854774

	Parameters
	----------
	data : str or {table-like}
	Pass in (x, y, z) or (longitude, latitude, elevation) values by
	providing a file name to an ASCII data table, a 2D
	{table-classes}.
	x/y/z : 1d arrays
	Arrays of x and y coordinates and values z of the data points.
	{spacing}
	{region}
	outgrid : str
	Optional. The file name for the output netcdf file with extension .nc
	to store the grid in.

One tipp for further contributions, which are highly welcome 🚀: It is better to create a feature branch from the main branch of your personal fork, instead of directly pushing to the main branch.

[jhtong33]

May I add more alias -L -M -C? (Inspire by #1660)

[weiji14]

May I add more alias -L -M -C? (Inspire by #1660)

Sure! But you'll need to document each one 😁

[weiji14]

To fix the 'Style Checks', you can either write /format as a comment to have the automated bot format things automatically on GitHub, or do it manually as I mentioned just now in the video call 😉 Let us know if you have any other questions!

[weiji14]

Sorry, I meant /format in a GitHub comment, not git commit comment 😅

[jhtong33]

Ha! I know it after trying.

[weiji14]

Hi @JingHuiTong, hope you had a nice holiday break! Just one last suggestion, otherwise everything looks good to me!

Will wait for one or two other reviewers to approve before we merge this in, just to double check 😉

[michaelgrund]

Looks good except the minor comment and the merge conflicts.

[jhtong33]

/format

[welcome]

🎉🎉🎉 Congrats on merging your first pull request and welcome to the team! 🎉🎉🎉

Please open a new pull request to add yourself to the AUTHORS.md file. We hope that this was a good experience for you. Let us know if there is any way that the contributing process could be improved.

[weiji14]

Woohoo, thanks again @JingHuiTong! Definitely let us know if you're interested in contributing more stuff, I'm sure you've got plenty of fresh ideas :D