Implement GMT themes (sets of GMT defaults)

cmake/ConfigUserAdvancedTemplate.cmake

@@ -236,6 +236,7 @@
 #add_definitions(-DUSE_COMMON_LONG_OPTIONS) 	# Turn on testing of upcoming long-option syntax for common GMT options
 #add_definitions(-DUSE_MODULE_LONG_OPTIONS) 	# Turn on testing of upcoming long-option syntax for module options
 #add_definitions(-DEXPORT_GMTLIB)				# Turn on to access normally un-exported or static gmtlib functions from external tools
+#add_definitions(-DNO_THEMES) 	                # Turn off implementation of GMT_THEME for debugging
 
 #set (CMAKE_C_FLAGS "-Wall -Wdeclaration-after-statement ${CMAKE_C_FLAGS}") # recommended even for release build
 #set (CMAKE_C_FLAGS "-Wextra ${CMAKE_C_FLAGS}")            # extra warnings

doc/examples/anim02/anim02.sh

@@ -24,10 +24,10 @@ cat << EOF > main.sh
 gmt begin
 	width=\$(gmt math -Q \${MOVIE_WIDTH} 0.5i SUB =)
 	gmt grdimage topo.nc -I+a\${MOVIE_COL0}+nt2 -JM\${width} -Cmain.cpt \
-		-BWSne -B1 -X0.35i -Y0.3i --FONT_ANNOT_PRIMARY=9p
+		-BWSne -B1 -X0.4i -Y0.3i --FONT_ANNOT_PRIMARY=9p
 	gmt plot -Sc0.8i -Gwhite -Wthin <<< "256.25 35.6"
 	gmt plot -Sv0.1i+e -Gred -Wthick <<< "256.25 35.6 \${MOVIE_COL1} 0.37i"
 gmt end
 EOF
 # 3. Run the movie
-gmt movie main.sh -C3.5ix4.167ix72 -Nanim02 -Tangles.txt -Sbpre.sh -D6 -Zs $opt
+gmt movie main.sh -C3.7ix4.167ix72 -Nanim02 -Tangles.txt -Sbpre.sh -D6 -Zs $opt

doc/examples/anim05/anim05.sh

@@ -22,7 +22,7 @@ cat << EOF > main.sh
 gmt begin
 	let k=\${MOVIE_FRAME}+1
 	gmt greenspline @Table_5_11.txt -R0/6.5/0/6.5 -I0.05 -Sc -Gt.nc -Z1 -Cn\${k} -Emisfit.txt
-	gmt grdcontour t.nc -C25 -A50 -Baf -BWsNE -JX4i -Gl3.6/6.5/4.05/0.75 -Xc -Y0.4i
+	gmt grdcontour t.nc -C25 -A50 -Baf -BWsNE -JX4i -Gl3.6/6.5/4.05/0.75 -Xc -Y0.6i
 	gmt plot misfit.txt -Ct.cpt -Sc0.15c -Wfaint -i0,1,4
 	printf "%2.2d" \$k | gmt text -F+cTR+jTR+f18p -Dj0.1i -Gwhite -W0.25p
 	gmt colorbar -Ct.cpt -DJBC+e -Bxaf -By+l"misfit"

doc/examples/ex01/ex01.sh

@@ -2,10 +2,9 @@
 #		GMT EXAMPLE 01
 #
 # Purpose:	Make two contour maps based on the data in the file osu91a1f_16.nc
-# GMT modules:	set, subplot, grdcontour, coast
+# GMT modules:	subplot, grdcontour, coast
 #
 gmt begin ex01
-	gmt set MAP_GRID_CROSS_SIZE_PRIMARY 0 FONT_ANNOT_PRIMARY 10p
 	gmt subplot begin 2x1 -A -M0.5c -Blrtb -Bafg -T"Low Order Geoid" -Fs16c/0 -Rg -JH16c
 		gmt coast -JH? -Glightbrown -Slightblue -c0,0
 		gmt grdcontour @osu91a1f_16.nc -C10 -A50+f7p -Gd10c -Ln -Wcthinnest,- -Wathin,- -T+d8p/2p+l

doc/examples/ex02/ex02.sh

@@ -10,11 +10,11 @@ gmt begin ex02
 		gmt subplot set 0,0 -Ce3c
 		gmt grd2cpt @HI_topo_02.nc -Crelief -Z
 		gmt grdimage @HI_topo_02.nc -I+a0
-		gmt colorbar -DJRM+o1.5c/0+mc -I0.3 -Bx2+lTOPO -By+lkm
+		gmt colorbar -DJRM+o1c/0+mc -I0.3 -Bx2+lTOPO -By+lkm
 
 		gmt subplot set 1,0 -Ce3c
 		gmt makecpt -Crainbow -T-2/14/2
 		gmt grdimage @HI_geoid_02.nc
-		gmt colorbar -DJRM+o1.5c/0+e+mc -Bx2+lGEOID -By+lm
+		gmt colorbar -DJRM+o1c/0+e+mc -Bx2+lGEOID -By+lm
 	gmt subplot end
 gmt end show

doc/examples/ex09/ex09.sh

@@ -10,5 +10,5 @@ gmt begin ex09
 	gmt plot @ridge_09.txt -Wthicker
 	gmt plot @fz_09.txt -Wthinner,-
 	# Take label from segment header and plot near coordinates of last record of each track
-	gmt convert -El @tracks_09.txt | gmt text -F+f10p,Helvetica-Bold+a50+jRM+h -D-4p
+	gmt convert -El @tracks_09.txt | gmt text -F+f10p,Helvetica-Bold+a50+jRM+h -D-4p -Ghoneydew
 gmt end show

doc/examples/ex16/ex16.sh

@@ -6,7 +6,6 @@
 # Unix progs:	rm
 #
 gmt begin ex16
-	gmt set FONT_ANNOT_PRIMARY 9p FONT_TITLE 18p,Times-Roman
 	gmt subplot begin 2x2 -M0.1c -Fs8c/0 -R0/6.5/-0.2/6.5 -Jx1c -SCb -SRl+t -Bwesn -T"Gridding of Data"
 		gmt surface @Table_5_11.txt -I0.2 -Graws0.nc
 		gmt contour @Table_5_11.txt -C@ex_16.cpt -I -B+t"contour (triangulate)" -c0,0

doc/examples/ex19/ex19.sh

@@ -16,9 +16,9 @@ gmt begin ex19
 		gmt grdimage lon.nc -Clon.cpt -nl
 		gmt coast -Q
 		gmt coast -Dc -A5000 -Wthinnest
-		echo "0 20 16TH INTERNATIONAL" | gmt text -F+f32p,Helvetica-Bold,red=thinner
+		echo "0 20 17TH INTERNATIONAL" | gmt text -F+f32p,Helvetica-Bold,red=thinner
 		echo "0 -10 GMT CONFERENCE" | gmt text -F+f32p,Helvetica-Bold,red=thinner
-		echo "0 -30 Honolulu, Hawaii, April 1, 2020" | gmt text -F+f18p,Helvetica-Bold,green=thinnest
+		echo "0 -30 Honolulu, Hawaii, April 1, 2021" | gmt text -F+f18p,Helvetica-Bold,green=thinnest
 		#   Then show example of color patterns and placing a PostScript image
 		gmt coast -Dc -A5000 -Gp86+fred+byellow+r100 [email protected]+r100 -c1,0
 		echo "0 30 SILLY USES OF" | gmt text -F+f32p,Helvetica-Bold,lightgreen=thinner
@@ -30,9 +30,9 @@ gmt begin ex19
 		gmt grdimage lat.nc -Clat.cpt -nl
 		gmt coast -Q
 		gmt coast -Dc -A5000 -Wthinnest
-		echo "0 20 16TH INTERNATIONAL" | gmt text -F+f32p,Helvetica-Bold,red=thinner
+		echo "0 20 17TH INTERNATIONAL" | gmt text -F+f32p,Helvetica-Bold,red=thinner
 		echo "0 -10 GMT CONFERENCE" | gmt text -F+f32p,Helvetica-Bold,red=thinner
-		echo "0 -30 Honolulu, Hawaii, April 1, 2020" | gmt text -F+f18p,Helvetica-Bold,green=thinnest
+		echo "0 -30 Honolulu, Hawaii, April 1, 2021" | gmt text -F+f18p,Helvetica-Bold,green=thinnest
 	gmt subplot end
 gmt end show
 rm -f lat.nc lon.nc lat.cpt lon.cpt

doc/examples/ex22/ex22.sh

@@ -2,12 +2,10 @@
 #		GMT EXAMPLE 22
 #
 # Purpose:	Automatic map of last month of world-wide seismicity
-# GMT modules:	set, coast, plot, legend
+# GMT modules:	coast, plot, legend
 # Unix progs:	cat, sed, awk, wget|curl
 #
 gmt begin ex22
-	gmt set FONT_ANNOT_PRIMARY 10p FONT_TITLE 18p FORMAT_GEO_MAP ddd:mm:ssF
-
 	# Get the data (-s silently) from USGS using the curl
 	# Hardwired here to the month of October, 2017
 	# SITE="https://earthquake.usgs.gov/fdsnws/event/1/query.csv"
@@ -81,7 +79,7 @@ gmt begin ex22
 
 	# OK, now we can actually run gmt legend.  We center the legend below the map.
 	# Trial and error shows that 1.7i is a good legend height:
-	gmt legend -DJBC+o0/1c+w18c/4.2c -F+p+glightyellow neis.legend
+	gmt legend -DJBC+o0/1c+w18c/4.2c -F+p+glightyellow neis.legend --FONT_ANNOT_PRIMARY=10p,Helvetica
 
 	rm neis.legend usgs_quakes_22.txt
 gmt end show

doc/examples/ex34/ex34.sh

@@ -5,7 +5,7 @@
 # GMT modules:  set, coast, makecpt, grdimage, subplot
 #
 gmt begin ex34
-	gmt set FORMAT_GEO_MAP dddF FONT_HEADING 24p
+	gmt set FONT_HEADING 24p
 	gmt makecpt -Cglobe -T-5000/5000
 	gmt subplot begin 2x1 -Fs11c/0 -M0.1c -JM11c -R-6/20/35/52 -SRl -SCb -Bwesn -T"Franco-Italian Union, 2042-45"
 		gmt coast -EFR,IT+gP300/8 -Glightgray -c1,0

doc/examples/ex37/ex37.sh

@@ -11,7 +11,7 @@ gmt begin ex37
 	# Prefix of two .nc files
 	G=grav.V18.par.surf.1km.sq
 	T=mb.par.surf.1km.sq
-	gmt set FONT_TITLE 14p GMT_FFT kiss
+	gmt set GMT_FFT kiss
 
 	gmt grdinfo @$T.nc -Ib > bbox
 	scl=1.4e-5

doc/examples/ex41/ex41.sh

@@ -5,7 +5,7 @@
 # GMT modules:  set, coast, legend, plot, makecpt
 #
 gmt begin ex41
-	gmt set FONT_ANNOT_PRIMARY 12p FONT_LABEL 12p
+	gmt set FONT_ANNOT_PRIMARY 12p,Helvetica FONT_LABEL 12p,Helvetica
 	gmt makecpt -Cred,orange,yellow,green,bisque,cyan,magenta,white,gray -T1/10/1 -N
 	gmt coast -R130W/50W/8N/56N -JM14c -Glightgray -Sazure1 -A1000 -Wfaint
 	gmt coast -EUS+glightyellow+pfaint -ECU+glightred+pfaint -EMX+glightgreen+pfaint -ECA+glightblue+pfaint

doc/examples/ex42/ex42.sh

@@ -2,28 +2,28 @@
 #               GMT EXAMPLE 42
 #
 # Purpose:      Illustrate Antarctica and stereographic projection
-# GMT modules:  makecpt, grdimage, coast, legend, colorbar, text, plot
+# GMT modules:  makecpt, grdimage, coast, legend, colorbar, set, text, plot
 # Unix progs:   [curl grdconvert]
 #
 gmt begin ex42
-	gmt set FONT_ANNOT_PRIMARY 12p FONT_LABEL 12p PROJ_ELLIPSOID WGS-84 FORMAT_GEO_MAP dddF
+	gmt set PROJ_ELLIPSOID WGS-84
 	# Data obtained via website and converted to netCDF thus:
 	# curl http://www.antarctica.ac.uk//bas_research/data/access/bedmap/download/bedelev.asc.gz
 	# gunzip bedelev.asc.gz
 	# grdconvert bedelev.asc BEDMAP_elevation.nc=ns -V
 	gmt makecpt -Cearth -T-7000/4000
 	gmt grdimage @BEDMAP_elevation.nc -Jx1:60000000 -Q
 	gmt coast -R-180/180/-90/-60 -Js0/-90/-71/1:60000000 -Bafg -Di -W0.25p
-	gmt colorbar -DJRM+w6.5c/0.5c+o1.5c/0+mc -F+p+i -Bxa1000+lELEVATION -By+lm
+	gmt colorbar -DJRM+w6.5c/0.5c+o1c/0+mc -F+p+i -Bxa1000+lELEVATION -By+lm
 	# GSHHG
 	gmt coast -Glightblue -Sroyalblue2 -X5c -Y12c
 	gmt coast -Glightbrown -A+ag -Bafg
-	gmt legend -DjLM+w4c+jRM+o1c/0 -F+p+i <<- EOF
-	H 18p,Times-Roman Legend
+	gmt legend -DjLM+w3.5c+jRM+o1c/0 -F+p+i <<- EOF
+	H 12 Legend
 	D 0.25c 1p
-	S 0.4c s 0.5c blue       0.25p 0.75c Ocean
-	S 0.4c s 0.5c lightblue  0.25p 0.75c Ice front
-	S 0.4c s 0.5c lightbrown 0.25p 0.75c Grounding line
+	S 0.4c s 0.3c blue       0.25p 0.75c Ocean
+	S 0.4c s 0.3c lightblue  0.25p 0.75c Ice front
+	S 0.4c s 0.3c lightbrown 0.25p 0.75c Grounding line
 	EOF
 	# Fancy line
 	gmt plot -R0/19/0/25 -Jx1c -B0 -W2p -X-6c -Y-13.5c <<- EOF

doc/examples/ex49/ex49.sh

@@ -13,7 +13,7 @@ gmt begin ex49
 	# Image depths with color-coded age contours
 	gmt makecpt -Cabyss -T-7000/0 -H > z.cpt
 	gmt makecpt -Chot -T0/100/10 -H > t.cpt
-	gmt grdimage depth_pixel.nc -JM15c -Cz.cpt -B -BWSne --FORMAT_GEO_MAP=dddF
+	gmt grdimage depth_pixel.nc -JM15c -Cz.cpt -B -BWSne --FORMAT_GEO_MAP=dddF --FONT_ANNOT_PRIMARY=12p
 	gmt plot -W1p @ridge_49.txt
 	gmt grdcontour age_pixel.nc -A+f14p -Ct.cpt -Wa0.1p+c -GL30W/22S/5E/13S
 	gmt colorbar -Cz.cpt -DjTR+w5c/0.4c+h+o0.75c/0.4c -Baf+u" km" -W0.001 -F+p1p+gbeige
@@ -42,7 +42,7 @@ gmt begin ex49
 	gmt plot ss.txt -W1p
 	gmt plot -Ss0.4c -Gblue modal.txt -Ey+p1p,blue
 	gmt plot -Ss0.1c -Gwhite modal.txt
-	gmt basemap -R0/100/0/6.5 -JX15c/-10c -Bxaf+u" Myr" -Byaf+u" km" -BWsNe
+	gmt basemap -R0/100/0/6.5 -JX15c/-10c -Bxaf+u" Myr" -Byaf+u" km" -BWsNe --FONT_ANNOT_PRIMARY=12p
 	gmt legend -DjRT+w6.5c+o0.25c -F+p1p+gbeige+s <<- EOF
 	S 0.5c - 0.9c - 4p,green 1c Parsons & Sclater (1977)
 	S 0.5c - 0.9c - 4p,white 1c Stein & Stein (1992)

doc/examples/ex50/ex50.sh

@@ -7,7 +7,6 @@
 
 gmt begin ex50
 	# Left column have all the PDFs
-	gmt set FONT_ANNOT_PRIMARY 10p,Helvetica,black
 	# Binomial distribution
 	gmt math -T0/8/1 0.25 8 T BPDF = p.txt
 	gmt plot -R-0.6/8.6/0/0.35 -JX7.5c/1.25c -Glightgreen p.txt -Sb0.8u -W0.5p -BWS -Bxa1 -Byaf

doc/rst/source/cookbook/features.rst

@@ -276,6 +276,73 @@ placed in a separate parameter file:
    scenarios into separate ``gmt.conf`` files will minimize headaches associated with
    micro-editing of illustrations.
 
+
+.. _auto-scaling:
+
+Automatic GMT settings
+~~~~~~~~~~~~~~~~~~~~~~
+
+The **auto** flag for :doc:`GMT parameters </gmt.conf>` signals that suitable
+dimensions or settings will be automatically computed when the plot dimensions
+are known. The **auto** flag is supported for the following parameters:
+
+================================== ===============================================
+:term:`FONT_ANNOT_PRIMARY`         Primary annotation font [11.00p]
+:term:`FONT_ANNOT_SECONDARY`       Secondary annotation font [13.20p]
+:term:`FONT_HEADING`               Subplot heading font [30.80p]
+:term:`FONT_LABEL`                 Axis label font [15.40p]
+:term:`FONT_LOGO`                  Logo font [8.80p]
+:term:`FONT_SUBTITLE`              Plot subtitle font [19.80p]
+:term:`FONT_TAG`                   Tag/labeling font [17.60p]
+:term:`FONT_TITLE`                 Plot title font [24.20p]
+:term:`MAP_ANNOT_MIN_SPACING`      Minimum space between annotations [11.00p]
+:term:`MAP_ANNOT_OFFSET_PRIMARY`   Primary annotation offset from axis [3.30p]
+:term:`MAP_ANNOT_OFFSET_SECONDARY` Secondary annotation offset from axis [3.30p]
+:term:`MAP_FRAME_AXES`             Axes that are drawn and annotated
+:term:`MAP_FRAME_PEN`              Pen width of plain frame [1.65p]
+:term:`MAP_FRAME_WIDTH`            Width of fancy frame [3.30p]
+:term:`MAP_GRID_PEN_PRIMARY`       Pen width of primary gridline [0.28p]
+:term:`MAP_GRID_PEN_SECONDARY`     Pen width of secondary gridline [0.55p]
+:term:`MAP_HEADING_OFFSET`         Heading offset from subplot [17.60p]
+:term:`MAP_LABEL_OFFSET`           Label offset from annotations [6.60p]
+:term:`MAP_POLAR_CAP`              Appearance of gridlines near the poles
+:term:`MAP_TICK_LENGTH_PRIMARY`    Length of primary tick marks [2.2p/1.1p]
+:term:`MAP_TICK_LENGTH_SECONDARY`  Length of secondary tick marks [6.60p/1.65p]
+:term:`MAP_TICK_PEN_PRIMARY`       Pen width of primary tick marks [0.55p]
+:term:`MAP_TICK_PEN_SECONDARY`     Pen width of secondary tick marks [0.28p]
+:term:`MAP_TITLE_OFFSET`           Title offset from plot [13.20p]
+================================== ===============================================
+
+The reference dimensions listed in brackets are the values for a plot
+with a height and width of 25 cm.  Larger and smaller illustrations
+will see a linear magnification or attenuation of these dimensions. The primary
+annotation font size will be computed as::
+
+    size = (2/15) * (map_size_in_cm - 10) + 9 [in points]
+
+where :math:`map\_size\_in\_cm = sqrt(map\_height  x  map\_width)`.  All other
+items will have their reference sizes scaled by :math:`scale = size / 10`. In
+modern mode, if you do nothing then all of the above dimensions will be
+automatically set based on your plot dimensions.  However, you are free to
+override any of them using the methods described in the next section. **Note**:
+Selecting **auto** for font sizes and dimensions requires GMT to know the plot
+dimensions. If the plot dimensions are not available (e.g., :doc:`/pslegend`
+with **-Dx** and no **-R -J**), the settings will be updated using the nominal
+font sizes and dimensions for a 10 x 1 cm plot. **Note**: The particular scaling
+relationship is experimental in 6.2 and we reserve the right to adjust it
+pending further experimentation and user feedback.
+
+For **MAP_POLAR_CAP**, **auto** will determine a suitable *pc_lat* for your
+region for all azimuthal projections and a few others in which the geographic
+poles are plotted as points (Lambert Conic, Oblique Mercator, Hammer, Mollweide,
+Sinusoidal, and van der Grinten).
+
+For **MAP_FRAME_AXES**, **auto** will determine a suitable setting based on the
+projection, type of plot, perspective, etc. For example, GMT will determine the
+position of different quadrants for perspective and polar plots and select the
+equivalent of **WrStZ**. The default for non-perspective, non-polar plots using
+**MAP_FRAME_AXES**\ =\ **auto** is **WrStZ**.
+
 Changing GMT defaults
 ~~~~~~~~~~~~~~~~~~~~~