I am a bit confused by the documentation on the spherical draw option SPH for 2D histograms. The doucmentation (e.g. http://root.cern.ch/root/html/THistPainter.html#HP00) states: “The X coordinate is mapped on the latitude and the Y coordinate on the longitude.”
Here is an example with the two functions SphericalPlotWrong and SphericalPlotCorrect. It tries to generate a histogram such that each 2D bin corresponds to the same solid angle, i.e. the latitude bins will not be equidistant. In the wrong case (done as the documentation suggests) one immediately sees the non-equidistant bins along the longitude.
But my main question is: Is it really a documentation bug or an implementation bug? In other words. Could it be that the longitude/latitude mapping will be change in later versions of Root?