pygmt.Figure.text¶

Figure.text(self, textfiles=None, x=None, y=None, text=None, angle=None, font=None, justify=None, **kwargs)¶

Plot or typeset text on maps

Used to be pstext.

Takes in textfile(s) or (x,y,text) triples as input.

Must provide at least textfiles or x, y, and text.

Aliases:

Parameters:

textfiles : str or list: A text data file name, or a list of filenames containing 1 or more records with (x, y[, font, angle, justify], text).
x, y : float or 1d arrays: The x and y coordinates, or an array of x and y coordinates to plot the text
text : str or 1d array: The text string, or an array of strings to plot on the figure
angle: int/float or bool: Set the angle measured in degrees counter-clockwise from horizontal. E.g. 30 sets the text at 30 degrees. If no angle is given then the input textfile(s) must have this as a column.
font : str or bool: Set the font specification with format “size,font,color” where size is text size in points, font is the font to use, and color sets the font color. E.g. “12p,Helvetica-Bold,red” selects a 12p red Helvetica-Bold font. If no font info is given then the input textfile(s) must have this information in one of its columns.
justify: str or bool: Set the alignment which refers to the part of the text string that will be mapped onto the (x,y) point. Choose a 2 character combination of L, C, R (for left, center, or right) and T, M, B for top, middle, or bottom. E.g., BL for lower left. If no justification is given then the input textfile(s) must have this as a column.
J : str: Required if this is the first plot command. Select map projection.
R : str or list: Required if this is the first plot command. 'xmin/xmax/ymin/ymax[+r][+uunit]'. Specify the region of interest.