pygmt.Figure.psconvert

Figure.psconvert(self, **kwargs)[source]

Convert [E]PS file(s) to other formats.

Converts one or more PostScript files to other formats (BMP, EPS, JPEG, PDF, PNG, PPM, SVG, TIFF) using GhostScript.

If no input files are given, will convert the current active figure (see pygmt.figure). In this case, an output name must be given using parameter F.

Full option list at https://www.generic-mapping-tools.org/gmt/latest/psconvert.html

Aliases:

  • A = crop
  • E = dpi
  • F = prefix
  • T = fmt
Parameters:
A : str or bool

Adjust the BoundingBox and HiResBoundingBox to the minimum required by the image content. Append u to first remove any GMT-produced time-stamps. Default is True.

C : str

Specify a single, custom option that will be passed on to GhostScript as is.

E : int

Set raster resolution in dpi. Default = 720 for PDF, 300 for others.

F : str

Force the output file name. By default output names are constructed using the input names as base, which are appended with an appropriate extension. Use this option to provide a different name, but without extension. Extension is still determined automatically.

I : bool

Enforce gray-shades by using ICC profiles.

Q : str

Set the anti-aliasing options for graphics or text. Append the size of the subsample box (1, 2, or 4) [4]. Default is no anti-aliasing (same as bits = 1).

T : str

Sets the output format, where b means BMP, e means EPS, E means EPS with PageSize command, f means PDF, F means multi-page PDF, j means JPEG, g means PNG, G means transparent PNG (untouched regions are transparent), m means PPM, s means SVG, and t means TIFF [default is JPEG]. To bjgt you can append - in order to get a grayscale image. The EPS format can be combined with any of the other formats. For example, 'ef' creates both an EPS and a PDF file. The 'F' creates a multi-page PDF file from the list of input PS or PDF files. It requires the F option.