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.

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.

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.

@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.

OK. Assiging the pygmt/io.py PR to @yogirajh007

Hi Dongdong, Thanks for the update. I noticed that #4824 has now been closed as completed. Since the pygmt/io.py task was assigned to me earlier, should I still continue working on it, or has that task already been completed? Thanks!

…

On Fri, Aug 14, 2026 at 3:36 PM Dongdong Tian ***@***.***> wrote: Closed #4824 <#4824> as completed. — Reply to this email directly, view it on GitHub <#4824?email_source=notifications&email_token=BGG3S6EG62ULFPTI7GQ2A635J3QD5A5CNFSNUABQM5UWIORPF5TWS5BNNB2WEL2JONZXKZKFOZSW45CON52GSZTJMNQXI2LPNYXTEOJUGUYTOMBTGU4TBJTSMVQXG33OU5RW63LNMVXHJJLFOZSW45FMMZXW65DFOJPWG3DJMNVQ#event-29451703590>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BGG3S6DPC6JWKWVDHCYTXTT5J3QD5AVCNFSNUABEKJSXA33TNF2G64TZHM4DKMZVGIZDKMJ3JFZXG5LFHM2TCNBYGEZDAOJYG2QXMAQ> . You are receiving this because you commented.Message ID: ***@***.***>

@Johnkothapalli

@Johnkothapalli Thanks for providing help. The task has been completed.

Navigation Menu

Repository navigation

Deprecated parameters that are planned to be removed in PyGMT 0.20.0 #4824

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Deprecated parameters that are planned to be removed in PyGMT 0.20.0 #4824

Description

Activity

Johnkothapalli commented on Aug 14, 2026

yogirajh007 commented on Aug 14, 2026

seisman commented on Aug 14, 2026

Johnkothapalli commented on Aug 14, 2026

seisman commented on Aug 14, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions