#14493: Minor docs changes for functions like minimize() which have same handle 
in
Python and SAGE
---------------------------------+------------------------
       Reporter:  GaryMak        |        Owner:  mvngu
           Type:  enhancement    |       Status:  new
       Priority:  minor          |    Milestone:  sage-6.2
      Component:  documentation  |   Resolution:
       Keywords:                 |    Merged in:
        Authors:                 |    Reviewers:
Report Upstream:  N/A            |  Work issues:
         Branch:                 |       Commit:
   Dependencies:                 |     Stopgaps:
---------------------------------+------------------------
Description changed by kcrisman:

Old description:

> As a very inexperienced person in this field I found it very difficult
> from the existing docs to understand the difference in syntax between the
> python and sage functions "minimize" - and I imagine this applies to
> other function handles as well: though I will need some guidance as to
> which function specs I need to amend.

New description:

 As a very inexperienced person in this field I found it very difficult
 from the existing docs to understand the difference in syntax between the
 python and sage functions "minimize" - and I imagine this applies to other
 function handles as well: though I will need some guidance as to which
 function specs I need to amend.


 ----

 See [https://groups.google.com/forum/#!topic/sage-support/3mekDq5Stvk this
 sage-support discussion]:

 {{{
 vars = var('x y')
 def gg(x,y): return sin(x) + cos(y)
 minimize(gg,[0,0])
 }}}
 gives a TypeError, while
 {{{
 vars = var('x y')
 gg = sin(x) + cos(y)
 minimize(gg,[0,0])
 }}}
 doesn't, but
 {{{
 sage: def gg(x): return sin(x[0]) + cos(x[1])
 sage: minimize(gg,[0,0])
 Optimization terminated successfully.
           Current function value: -2.000000
           Iterations: 72
           Function evaluations: 139
 (-1.5707636272, 3.14159570731)
 }}}
 does.

 The relevant possibly confusing doc is
 
[http://www.sagemath.org/doc/reference/numerical/sage/numerical/optimize.html#sage.numerical.optimize.minimize
 here].

--

--
Ticket URL: <http://trac.sagemath.org/ticket/14493#comment:3>
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 unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.

Reply via email to