#157 Description of precision parameter

4.1.3
closed
Mark Miesfeld
rxMath (3)
5
2013-07-09
2009-09-01
Walter
No

The text that describes precision is not quite correct.

My suggestion:
If a value is not specified, the precision of the calling Rexx activity
or 16, watever is smaller, is used.

precision
The precision of the calculation.
If a value is not specified, the precision of the calling Rexx activity
is used.

And I can't get rxcalcarctan to fail,
even with an explicit precision of 30!

So this sentence should be dropped:

If the precision exceeds 16 digits, the call will fail.

As this description is repeated again and again I would point to a common
paragraph 'see precison of result'

and should this text coming out from MathLoadFuncs('some text') be updated?
(actually a code change, I guess)

rxmath 1.1 - REXX mathematical function package
(c) Copyright RexxLanguage Association 2005.
All Rights Reserved.

Shouldn't this read 2005-2009 ?
The package was changed after all!

Discussion

  • Walter
    Walter
    2009-09-01

    While further investigating I found a typo: proces (instead of process!)
    Existing code that used the previous proces to load external functions:

    and I'd like to ask a question:
    How is the argiment's precision treated?
    Is it rounded to the caller's setting of Numeric Digits?

    I'd rather test against a spec (instead of experimenting further)

     
  • Walter
    Walter
    2009-09-01

    Sorry, one more observation:
    The doc for RxCalcSinH says:
    Returns the hyperbolic sine of number, expressed in radians.
    radians is incorrect in this context!!!

    From Wikipedia (and my university days :-)
    A ray through the origin intercepts the hyperbola in the point ....
    where x is the area between the ray, its mirror image with respect to the -axis,
    and the hyperbola

     
  • Erich
    Erich
    2013-05-31

    To fix documentation bugs #157 and #162 this patch changes the following file in /docs/branches/4.1.3/trunk/rxmath and /docs/branches/4.1/trunk/rxmath:
    rxmath.xml

    (for a patch for path /docs/trunk/rxmath see follow-on post)

    --- rxmath.xml
    Corrected typo "proces" in "Existing code that used the previous proces"
    As MATHERRNO is no longer used by current code base, deleted paragraph describing "the variable MATHERRNO is set with additional information"
    (16x) As new code no longer fails for precision>16, replaced "If the precision exceeds 16 digits, the call will fail." with "Precision is limited to 16 digits."
    (3x) Removed incorrect statement for hyperbolic functions: ", expressed in radians"
    (7x) Corrected 'D', 'R', 'G' part of syntax diagram to correctly show 'D' as being default

     
    Attachments
  • Erich
    Erich
    2013-05-31

    To fix documentation bugs #157 and #162 this patch changes the following files in /docs/trunk/rxmath:
    intro.xml
    funcs.xml

    --- intro.xml
    Corrected typo "proces" in "Existing code that used the previous proces"
    As MATHERRNO is no longer used by current code base, deleted paragraph describing "the variable MATHERRNO is set with additional information"

    --- funcs.xml
    (16x) As new code no longer fails for precision>16, replaced "If the precision exceeds 16 digits, the call will fail." with "Precision is limited to 16 digits."
    (3x) Removed incorrect statement for hyperbolic functions: ", expressed in radians"
    (7x) Corrected 'D', 'R', 'G' part of syntax diagram to correctly show 'D' as being default

     
    Attachments
  • Walter Pachl
    Walter Pachl
    2013-05-31

    could you add some sentence about grade Units?

    The grad, also called grade, gradian, or gon, is 1/400 of a turn, so a right angle is 100 grads. It is a decimal subunit of the quadrant. A kilometre was historically defined as a centi-grad of arc along a great circle of the Earth, so the kilometer is the decimal analog to the sexagesimal nautical mile. The grad is used mostly in triangulation.

    Walter

     
  • Mark Miesfeld
    Mark Miesfeld
    2013-06-04

    • status: open --> pending
    • assigned_to: Mark Miesfeld
    • Group: --> 4.1.3
     


Anonymous


Cancel   Add attachments