#12120: Improve documentation of numerical_approx()
---------------------------------+------------------------------------------
       Reporter:  saraedum       |         Owner:  mvngu                        
    
           Type:  enhancement    |        Status:  needs_review                 
    
       Priority:  trivial        |     Milestone:  sage-5.3                     
    
      Component:  documentation  |    Resolution:                               
    
       Keywords:  beginner       |   Work issues:                               
    
Report Upstream:  N/A            |     Reviewers:  Eviatar Bach, Karl-Dieter 
Crisman
        Authors:  Julian Rueth   |     Merged in:                               
    
   Dependencies:                 |      Stopgaps:                               
    
---------------------------------+------------------------------------------

Old description:

> In a class on computer algebra, students were surprised by the behavior
> of the N() function. Here are some minimal examples that should
> illustrate the issues we ran into:
>
> {{{
> sage: x=N(pi,digits=3); x
> 3.14
> sage: y=N(3.14,digits=3); y
> 3.14
> sage: x==y
> False
> }}}
>
> {{{
> sage: N(pi,digits=1)
> 3.2
> }}}
>
> {{{
> sage: N(pi-3,prec=2)
> 0.00
> }}}
>
> Imo, none of these is a bug, but I believe that the documentation should
> be improved.

New description:

 In a class on computer algebra, students were surprised by the behavior of
 the N() function. Here are some minimal examples that should illustrate
 the issues we ran into:

 {{{
 sage: x=N(pi,digits=3); x
 3.14
 sage: y=N(3.14,digits=3); y
 3.14
 sage: x==y
 False
 }}}

 {{{
 sage: N(pi,digits=1)
 3.2
 }}}

 {{{
 sage: N(pi-3,prec=2)
 0.00
 }}}

 Imo, none of these is a bug, but I believe that the documentation should
 be improved.

 ----

 Apply [attachment:trac_12120_numerical_approx.patch] and
 [attachment:trac_12120-review.patch] to the Sage library.

--

Comment (by kcrisman):

 Patchbot: apply trac_12120_numerical_approx.patch and
 trac_12120-review.patch

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12120#comment:16>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica, 
and MATLAB

-- 
You received this message because you are subscribed to the Google Groups 
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/sage-trac?hl=en.

Reply via email to