GMT powered automatic maps

plot.automap

class Map(gmtversion='newest', **kwargs)[source]

Undocumented.

lat

float, optional

lon

float, optional

radius

float, optional

width

float, default: 20.0

height

float, default: 14.0

margins

list of float objects, default: []

illuminate

bool, default: True

skip_feature_factor

float, default: 0.02

show_grid

bool, default: False

show_topo

bool, default: True

show_scale

bool, default: False

show_topo_scale

bool, default: False

show_center_mark

bool, default: False

show_rivers

bool, default: True

show_plates

bool, default: False

show_boundaries

bool, default: False

illuminate_factor_land

float, default: 0.5

illuminate_factor_ocean

float, default: 0.25

color_wet

tuple of 3 int objects, default: (216, 242, 254)

color_dry

tuple of 3 int objects, default: (172, 208, 165)

color_boundaries

tuple of 3 int objects, default: (1, 1, 1)

topo_resolution_min

float, default: 40.0

minimum resolution of topography [dpi]

topo_resolution_max

float, default: 200.0

maximum resolution of topography [dpi]

replace_topo_color_only

FloatTile, optional

replace topo color while keeping topographic shading

topo_cpt_wet

str, default: 'light_sea'

topo_cpt_dry

str, default: 'light_land'

axes_layout

str, optional

custom_cities

list of City objects, default: []

gmt_config

dict of str objects, default: {}

comment

str, optional

save(outpath, resolution=75.0, oversample=2.0, size=None, width=None, height=None, psconvert=False)[source]

Save the image.

Save the image to outpath. The format is determined by the filename extension. Formats are handled as follows: '.eps' and '.ps' produce EPS and PS, respectively, directly with GMT. If the file name ends with '.pdf', GMT output is fed through gmtpy-epstopdf to create a PDF file. For any other filename extension, output is first converted to PDF with gmtpy-epstopdf, then with pdftocairo to PNG with a resolution oversampled by the factor oversample and finally the PNG is downsampled and converted to the target format with convert. The resolution of rasterized target image can be controlled either by resolution in DPI or by specifying width or height or size, where the latter fits the image into a square with given side length. To save transparency use psconvert=True.