Deprecated parameters that are planned to be removed in PyGMT 0.20.0

[seisman]

Many deprecated parameters are planned to be removed in v0.20.0. Better to work on them in separate PRs so that we can have separated entries in the changelog.

Use grep -r "# TODO(PyGMT.*)" --include="*.py" . or grep -r 'remove_version="v0.20.0"' --include="*.py" . to find related files.

• ./pygmt/clib/session.py @seisman Session.virtualfile_in: Remove the deprecated parameter 'required_z'/'required_data'/'extra_arrays' [Deprecated since 0.16.0] #4828
• ./pygmt/io.py pygmt.load_dataarray: Remove the deprecated function [Deprecated since v0.16.0] #4837
• ./pygmt/tests/test_io.py pygmt.load_dataarray: Remove the deprecated function [Deprecated since v0.16.0] #4837
• ./pygmt/tests/test_clib_virtualfile_in.py @seisman Session.virtualfile_in: Remove the deprecated parameter 'required_z'/'required_data'/'extra_arrays' [Deprecated since 0.16.0] #4828
• ./pygmt/src/grdview.py Figure.grdview: Remove the deprecated parameters '*pen'/'drapegrid' #4830
• ./pygmt/src/wiggle.py Figure.wiggle: Remove the deprecated parameters 'fillpositive'/'fillnegative' [Deprecated since 0.18.0] #4831
• ./pygmt/src/histogram.py Figure.histogram: Remove the deprecated parameter barwidth [Deprecated since 0.18.0] #4827
• ./pygmt/src/velo.py Figure.velo: Remove deprecated parameter 'uncertaintyfill' [Deprecated since 0.18.0] #4835
• ./pygmt/src/inset.py Figure.inset: Remove deprecated parameter margin [Deprecated since 0.18.0] #4826
• ./pygmt/src/grdfill.py pygmt.grdfill: Remove the deprecated '*fill' parameters [Deprecated since 0.18.0] #4836
• ./pygmt/src/select.py pygmt.select: Remove the deprecated parameters mask/gridmask [Deprecated since 0.18.0] #4825
• ./pygmt/src/x2sys_cross.py pygmt.x2sys_cross: Remove the deprecated parameter 'trackvalues' [Deprecated since 0.18.0] #4834
• ./pygmt/src/grdlandmask.py pygmt.grdlandmask: Remove the deprecated parameters 'maskvalue'/'bordervalues' [Deprecated since 0.18.0] #4833
• ./pygmt/src/surface.py pygmt.surface: Remove the deprecated parameter 'maxradius' [Deprecated since 0.18.0] #4832
• ./pygmt/src/meca.py Figure.meca: Remove the deprecated parameters 'label'/'*fill' #4829

Help is wanted. An example RP is at #4825.

[Johnkothapalli]

I’ll take the pygmt/src/histogram.py item in a focused PR, removing the deprecated �arwidth compatibility decorator and its now-unused import, following #4825/#4826.

[yogirajh007]

Hi! I’d like to take the pygmt/io.py and pygmt/tests/test_io.py item. I plan to remove the deprecated pygmt.io.load_dataarray function, its tests, and its top-level export, following the pattern established by #4825–#4830. I’ll keep the PR limited to this subtask. Please let me know if someone is already working on it.