Adding append_polydata method

[beroda]

Overview

This PR originates from comments #4227 (comment) and #4227 (comment).

Since #4227 replaced vtkAppendPolyDataFilter by DataSetFilters.merge in PolyDataFilters.merge to greatly improve performance and coherence with other merging operations, points ordering is altered and can cause some users to face issues.

This PR is not a roll-back of #4227 since it simply adds a PolyDataFilter.append_polydata method re-implementing vtkAppendPolyDataFilter.

A note regarding this change of behavior for 0.39.0 is also added in the documentation of PolyDataFilters.merge for users experiencing the same issues.

Details

import pyvista as pv
sp0 = pv.Sphere()
sp1 = sp0.translate((1, 0, 0))
appended = sp0.append_polydata(sp1)
appended.plot()

# Support for *args
sp2 = sp0.translate((-1, 0, 0))
appended = sp0.append_polydata(sp1, sp2)
appended.plot()

[codecov]

Codecov Report

Merging #4489 (dbb37b2) into main (4d75788) will increase coverage by 0.00%.
The diff coverage is 100.00%.

@@           Coverage Diff           @@
##             main    #4489   +/-   ##
=======================================
  Coverage   95.65%   95.66%           
=======================================
  Files         107      107           
  Lines       21035    21048   +13     
=======================================
+ Hits        20122    20135   +13     
  Misses        913      913           

[tkoyama010]

Thank you for adding this. Please hold off merging until we merge #4486 and resolve the conflict with it.

[banesullivan]

Well done! Thank you!