Wrap fitcircle

[willschlitzer]

This pull request wraps the module fitcircle.

Preview at https://pygmt-dev--1550.org.readthedocs.build/en/1550/api/generated/pygmt.fitcircle.html

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 adding new functionality, add an example to docstrings or tutorials.

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

[seisman]

Please rewrap these lines to ~88 characters per line.

[seisman]

Suggested change

	- ``norm=2`` (L2 norm) approximates the minimization of the sum of squares of
	cosines of cosines of angular distances. It creates a 3 by 3 matrix of sums of
	squares of components of the data vectors. The eigenvectors of this matrix give
	the mean and pole locations. This method may be more subject to roundoff errors
	when there are thousands of data. The pole is given by the eigenvector
	corresponding to the smallest eigenvalue; it is the least-well represented factor
	in the data and is not easily estimated by either method.
	- ``norm=2`` (L2 norm) approximates the minimization of the sum of squares of
	cosines of angular distances. It creates a 3 by 3 matrix of sums of squares of
	components of the data vectors. The eigenvectors of this matrix give the mean and
	pole locations. This method may be more subject to roundoff errors when there are
	thousands of data. The pole is given by the eigenvector corresponding to the
	smallest eigenvalue; it is the least-well represented factor in the data and is
	not easily estimated by either method.

[seisman]

Suggested change

	:func:`pygmt.fitcircle`twice, once for each ``norm``.
	:func:`pygmt.fitcircle` twice, once for each ``norm``.

[seisman]

Suggested change

	raise GMTValueError(norm, description="norm", choices={1, 2})
	raise GMTValueError(norm, description="norm", choices=[1, 2])

[seisman]

Suggested change

	small_circle
	Attempt to fit a small circle instead of a great circle. The pole will be
	constrained to lie on the great circle connecting the pole of the best-fit great
	circle and the mean location of the data. Optionally set the desired fixed
	latitude of the small circle [Default will determine the optimal latitude].
	small_circle
	Attempt to fit a small circle instead of a great circle. The pole will be
	constrained to lie on the great circle connecting the pole of the best-fit great
	circle and the mean location of the data. If ``True``, the latitude of the small
	circle is determined automatically. Alternatively, pass a float to fix the
	latitude of the small circle to that value. [Default is ``False``, i.e., fit a
	great circle.]

[seisman]

Could you please add an inline example for it?

[willschlitzer]

I'm guessing this branch is too old and out of date, given the length review process. Probably makes more sense for a fresh start.

[seisman]

I think this PR is very close to final. Starting a new PR doesn't help