Implement GMT themes (sets of GMT defaults) (#3344)

* Add new GMT_THEME default setting

This will take the name of a separate .conf file that will override the current settings.

* Update names

* Create darkmode.conf

* Wrap up theme machinery

* Update gmt.conf.rst

* Update darkmode.conf

* Play with modern.conf

* Trial modern.conf

* Address comments

* use AvantGarde font

* Bold titles

* Update modern.conf

* Update modern.conf

* Implement auto scaling

* Update modern.conf

* Update gmt_plot.c

* Update gmt_map.c

* smaller offsets

* Let modern have modern defaults

* Update modern.conf

* Updates

* Leave gridlines black and lines with butt cap

* Update inverse and darkmode to be modern

* Move the auto-font-size function to gmt_init.c

* Allow --PAR-value overrides for auto scaling

* Update gmt_init.c

* Improve scripts in general

* Update scripts and fix internals

* Eliminate unneeded gmt set calls

* Update gmt_init.c

* Update gmt_init.c

* Use auto <--> NaN in gmt.conf parsing

* Update gmt_init.c

* Use NaN for undefined font size as well

* Eliminate unneeded MAP_AUTO_SCALE

* Update docs

* Update subplot.c

* Update psscale.c

* update undefined defaults at end of GMT_Parse_Common

That is when we are done parsing any --PAR=value options

* Fix subplot with WrStZ defaults under modern

HEre, if we have W and a panel should not be annotated and w is not selected, then it should be l if either W or l is in the defaults.  Some with b of S or b is in the default.

* Let MAP_ANNOT_MIN_SPACING join the auto-scaled items

Nominally 36p, it now is auto and will scale with the primary fontsize.

* Do not let gmtset expand auto to anything

* Fix vector shape init

* protect sides in psscale.

The resetting interfered with auto-annotation of colorbars.

* Update gmt_init.c

* Fix pstext to initialize default font

* Forgot to update the theme in gmtinit_conf_modern_override (#3508)

This function is called when modern theme is selected in classic or always in modern.  But it failed to actually set the GMT_THEME variable so in classic mode it reverted to classic before writing out the theme.

* Lengthen ticks and slightly increase font size

* Fix multiple addition of frame width

* Update gmt_init.c

* Update gmt_init.c

* Update inverse.conf

* Update gmt_init.c

* Fix auto setting for MAP_FRAME_WIDTH

* Update modern theme and add minimal theme (#4596)

* Change modern default MAP_FRAME_TYPE to fancy

* Make Helvetica default font for modern theme

* Remove return from gmtinit_conf_modern_override

* Fix typo

* Add minimal theme

* Make modern font heading and title bold

* Remove unfinished themes darkmode, inverse, movie

* Update doc/rst/source/gmt.conf.rst

Co-authored-by: Meghan Jones <[email protected]>

* Update src/gmt_init.c

Co-authored-by: Meghan Jones <[email protected]>

* Update doc/rst/source/cookbook/features.rst

Co-authored-by: Dongdong Tian <[email protected]>

* Update doc/examples/ex41/ex41.sh

Co-authored-by: Dongdong Tian <[email protected]>

* Remove MAP_ANNOT_MIN_SPACING auto-scaling (#4704)

* Update doc/scripts/GMT_TM.sh

* Add auto-scaling for new subtitle font as well

* Testing a GMT_THEME off solution (#4710)

* Testing a GMT_THEME off solution

Goal is to allow suers to override specifics in the theme settings without having the THEME be parsed again and overwrite the changes

* Update gmt_init.c

* Themes autoaxes (#4715)

* Aadd auto mode for GMT_MAP_AXES

The default choice may need to depend on view-angle, if azimuthal or cylindrical, etc.

* Handle polar and rotated schemes

* Update gmt_init.c

* Subplot axes (#4720)

* Better interplay between -S and MAP_FRAME_AXES

WHen -S is used for rows or cols then we should let it do its thing, not parse MAP_FRAME_AXES.  If not set then we do.

* Deal with subplot-specific gmt.conf settings

Must create a gmt.conf for a subplot if modern theme so that all fonts etc will be the same across all panels.

* Progress on auto axes and subplots

* COmments

* Fix delayed get_scale calls

* Update pslegend.c

* Update pslegend.c

* Update psscale.c

* Update pslegend.c

* Update GMT_legend.sh

* Use geometric mean of plot dimensions for reference, and delete temp files

* Allow testing of classic only via -DNO_THEMES

* Update gmt_map.c

* Update documentation for gmt themes (#4717)

* List all parameters alphabetically

* Start descriptions for themes and auto settings

* Complete auto scaling documentation

* Add FONT_SUBTITLE to tables

* Fix classic default

* Update auto scaling description

* Fix font settings

* Update FONT_SUBTITLE default

* Update MAP_TICK_PEN_PRIMARY default docs

* Update theme dependent defaults

* Fix a typo

* Format defaults documentation

* Move theme-settings to separate docs page

* Update auto scaling links

* Update auto scaling documentation

* Link themes table to gmt.conf keywords

* Add more links between auto, gmt.conf, and themes

* Fix formatting

* Update MAP_ANNOT_MIN_SPACING default

* Format doc/rst/source/cookbook/features.rst

* Update auto-scaling docs for unknown dimensions

* Update doc/scripts/GMT_dir_rose.sh

* Remove trailing whitespace

* Handle gmt set GMT_THEME classic in a modern session (#4726)

* Handle gmt set GMT_THEME classic in a modern session

Since modern defaults have been set, this PR will flag all the defaults that differ between classic and modern themes so they are updated.

* Update src/gmt_init.c

Co-authored-by: Meghan Jones <[email protected]>

* Update GMT_legend.sh test

* Add NO_THEMES definition to template

* Update GMT_Defaults_1b.sh test

* Update position for anim02.sh

* Update TMcontours.sh test

* Init frame_width before using it to init tick length

Fixes the problem with sphareacentroid.sh and possibly others

* Add auto scaling for MAP_ANNOT_MIN_SPACING

* Auto for MAP_POLAR_CAP (#4854)

* Let POLAR_CAP be auto under modern mode

* Update and add docs

* Update themes.conf files

* Add comments

* Update docs for MAP_POLAR_CAP=auto

Co-authored-by: Meghan Jones <[email protected]>

* Setup map before histogram autolegend

* Explore separate MAP_ANNOT_OBLIQUE settings for oblique and other projections (#4890)

* Explore separate MAP_ANNOT_OBLIQUE settings for oblique and other projections

This PR to be merged into gmt-themes sets MAP_ANNOT_OBLIQUE to be lon_horizontal,lat_horizontao,tick_extend but will reset this to the previous default anywhere unless the user manually changed the setting.

* UPdate

* Reset map_annot_oblique_set when we reset settings

* Update gmt_init.c

* Update gmt_init.c

* Update subplot tests

* Change warnings to debug messages

* Improve spacing for anim05.sh

* Use consistent font size for ex49.sh

* Update share/themes based on gmt_init.c

* Update gmt.conf.rst

* Update gmt-themes docs

* Update PS files for -B scripts

* Add cookbook theme

* Set GMT_THEME=cookbook for doc/scripts

* Update PostScript tests

* Update failing test

* Update failing test

* Update postscript files

* Update failing tests

* Update GMT_cycle_1.sh

* Update symbol_orientation PS files

Both differ from origs but are good. Origs updated.

* Update ps for ex23 and ex49

Co-authored-by: Meghan Jones <[email protected]>
Co-authored-by: Meghan Jones <[email protected]>
Co-authored-by: Dongdong Tian <[email protected]>

Author: 4 people

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/anim01/anim01.ps

@@ -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/anim02/anim02.ps

@@ -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/anim02/anim02.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/anim03/anim03.ps

@@ -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/anim05/anim05.ps

@@ -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/anim05/anim05.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/ex01/ex01.ps

@@ -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/ex01/ex01.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/ex02/ex02.ps

@@ -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/ex02/ex02.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/ex03/ex03.ps

@@ -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/ex04/ex04.ps

@@ -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/ex04/ex04c.ps

@@ -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/ex05/ex05.ps

@@ -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