.. index:: ! grdpaste
gmt grdpaste file_a.nc file_b.nc |-G|outfile.nc [ |-S| ] [ |SYN_OPT-V| ] [ |SYN_OPT-f| ] [ |SYN_OPT--| ]
grdpaste will combine file_a.nc and file_b.nc into outfile.nc by pasting them together along their common edge. Files file_a.nc and file_b.nc must have the same grid spacings and registration, and must have one edge in common. If in doubt, check with :doc:`grdinfo` and use :doc:`grdcut` and/or :doc:`grdsample` if necessary to prepare the edge joint. Note: For geographical grids, you may have to use -f to handle periodic longitudes unless the input grids are properly recognized as such via their meta-data. For stitching multiple grids, see :doc:`grdblend` instead.
- file_a.nc
- One of two files to be pasted together.
- file_b.nc
- The other of two files to be pasted together.
- -Goutfile.nc
- The name for the combined output. (See :ref:`Grid File Formats <grd_inout_full>`).
- -S
- Just prints a code number and a description of the sides at which the grids are pasted. No pasting actually happens. -G is ignored. This option is useful for externals that want to reimplement the grdpaste utility since it doesn't work form them (e.g. Julia and GMTMEX).
Suppose file_a.nc is 150E - 180E and 0 - 30N, and file_b.nc is 150E - 180E, -30S - 0, then you can make outfile.nc which will be 150 - 180 and -30S - 30N by:
gmt grdpaste file_a.nc file_b.nc -Goutfile.nc -V -fg
:doc:`gmt`, :doc:`grdblend`, :doc:`grdclip`, :doc:`grdcut`, :doc:`grdinfo`, :doc:`grdsample`