Figure.meca: Plot focal mechanisms on maps #3829

This issue serves as the central tracker for the implementation of the Figure.meca method.

• GMT doc: https://docs.generic-mapping-tools.org/6.5/supplements/seis/meca.html
• PyGMT doc: https://www.pygmt.org/dev/api/generated/pygmt.Figure.meca.html#pygmt.Figure.meca

Options

Checked: Implemented; Unchecked: To be implemented/discussed and help wanted; Strikethrough: Won't implement.

• input file
• -J: projection
• -R: region
• -S:
  • convention code a|c|m|d|z|p|x|y|t: Determined by parameters convention/component or based on the column names for dict/pandas.DataFrame ( Initially implemented in Wrap meca #516, but refactored in Refactor Figure.meca() to better determine the data format code #1002 and Figure.meca: Add the private _FocalMechanismConvention class to simplify codes #3551)
  • scale
  • +a<angle>
  • +f<font>
  • +j<justify>]
  • +l
  • +m
  • +o<dx>[/<dy>]
  • +s<ref>
• -A
  • +g[<fill>]
  • +o[<dx>/<dy>]
  • +p<pen>
  • +s[<symbol>]<size>]
• -B: frame
• -C: cmap
• -D<depmin>/<depmax>
• -E<fill>: extension_fill
• -Fa[<size>[/<Psymbol>[<Tsymbol>]]]
• -Fe<fill>
• -Fg<fill>
• -Fr<fill>
• -Fp[<pen>]
• -Ft[<pen>]
• -Fz[<pen>]
• -G<fill>: compression_fill
• -H[<scale>]
• -I[<intens>]
• -L<pen>
• -N: no_clip
• -T[<nplane>][+p<pen>]
• -U: Use Figure.timestamp
• -V: verbose
• -W: pen
• -X/-Y: Use Figure.shift_origin
• -c: panel
• -d
• -e
• -h
• -i
• -p: perspective
• -q
• -t: transparency
• -:
• --PAR=<value>: Use pygmt.config

Input format

The input data should contain the following lines ([] means optional):

lon lat depth focal_parameters [size] [scale] [intens] [transp [transp2]] [plot_lon plot_lat] [event_label]

Columns like size/scale/intense/transp depends on the availability of some options. Currently, they're not supported yet.

Progresses

• Initial feature implementation PR Wrap meca #516
• All functionality are implemented
• Add a tutorial/gallery Figure.timestamp: Improve documentation and gallery example #2434
• Docstrings are complete and easy to read
• Full type hints