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

Reply via email to