On 2012-08-12 18:03-0500 Maurice LeBrun wrote: > On Sunday, August 12, 2012 at 12:59:53 (-0700) Alan W. Irwin writes: > > "path_includes_zero" usually does describe the mathematical meaning, > > but that term is ambiguous for the special case when the hue range > > ends with zero or 360 since both path alternatives in that case > > include zero (or 360). To avoid ambiguity, how about dropping all > > special meaning from the name and using "alt_hue_path" instead (with > > appropriate docbook and doxygen documentation of exactly what that > > means in a mathematical sense)? > > Sounds good.
Thanks, Maurice. Andrew, if you agree with this idea as well, I would be willing to do the rev ==> alt_hue_path name change wherever plscmap1l, plscmap1la, PLControlPt, or cmap1cp occurs in our code base (i.e, src, bindings, and examples, and also in the doxygen documentation that occurs in the C code). This change, although a bit time consuming, is pretty straightforward, and gives me a chance to contribute something to PLplot again. Note I would leave the corresponding rev ==> alt_hue_path docbook documentation changes to someone else who I assume would also make additional plscmap1l and plscmap1la documentation changes based on what Phil has said and also include the exact mathematical definition of a change in hue. That is currently expressed in C (see src/plctrl.c) as dh = plsc->cmap1cp[n + 1].h - plsc->cmap1cp[n].h; if ( plsc->cmap1cp[n].rev ) dh = ( dh > 0 ) ? dh - 360 : dh + 360; but should be reexpressed more generally in the docbook documentation since not everyone understands C. Alan __________________________ Alan W. Irwin Astronomical research affiliation with Department of Physics and Astronomy, University of Victoria (astrowww.phys.uvic.ca). Programming affiliations with the FreeEOS equation-of-state implementation for stellar interiors (freeeos.sf.net); the Time Ephemerides project (timeephem.sf.net); PLplot scientific plotting software package (plplot.sf.net); the libLASi project (unifont.org/lasi); the Loads of Linux Links project (loll.sf.net); and the Linux Brochure Project (lbproject.sf.net). __________________________ Linux-powered Science __________________________ ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ _______________________________________________ Plplot-devel mailing list Plplot-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/plplot-devel