Major geoplot update (as well as palettes and colrspace)

[Ben Jann]

A major update to geoplot is available from SSC. To install the update, type

. ssc install geoplot, replace
. ssc install palettes, replace
. ssc install colrspace, replace

Please make sure to update all three packages; geoplot will not be fully functional with older version of palettes and colrspace. Furthermore, the moremata package is required, so possibly also type

. ssc install moremata, replace

Over the last weeks I implemented various additional features and also did quite some housekeeping. An implication of this is that some of the default behavior changed, possibly breaking old do-files (sorry for that; I'll try to avoid such changed in future). One important change in default behavior is that geoframe create no longer makes the created frame the current frame; specify option current for old behavior.

Some highlights of the new version are as follows (see changes after 02nov2023 at https://github.com/benjann/geoplot for more complete information):

• geoplot has repeatable option glegend() to generate multiple legends in a flexible way, possibly including symbols generated by layertype symbol; some additional predefined symbol shapes are also provided
• geoplot has a repeatable inset() option to create insets; this is similar to zoom(), but much easier to use in most cases
• various projections are now provided by geoframe project; geoplot has a project() option to apply projections on the fly
• geoplot has options background(), grid(), and tissot() to add a background, grid lines, and Tissot's indicatrices; there is also option axes to turn Stata's coordinate system on
• geoplot now supports syntax layer || layer || ... in addition to (layer) (layer) ...
• geoframe can now convert GeoJSON to Stata format
• geframe create can now directly read from ESRI or GeoJSON source files, possibly directly from a zipfile or an online location
• and many more smaller or larger changes and additions ...

Main changes in palettes/colrspace (see changes after 02jun2022 at https://github.com/benjann/palettes and changes after 30may2022 at https://github.com/benjann/colrspace):

• Stata 18 colors are now provided as palette st and named colors stc1, ..., stc15, stblue, stgreen, stred, styellow. You do not need to have Stata 18 to use these colors, but in Stata 18 st is the new default palette.
• for convenience, opacity and intensity operators can now be applied directly to palette names in colorpalette; for example, you could type colorpalette Set1%50 to obtain palette Set1 with 50% opacity
• colorpalette has a new iconvert() option to resolve intensity multipliers and a new torder() option to determine the order in which color transformations are applied
• colorpalette and colrspace no longer choke on special colorstyle specifications such as none, bg, fg, ., or =

ben