[SciPy-user] examples in docs

[josef.pktd at gmail.com]

On Tue, May 5, 2009 at 2:43 PM, Rob Falck <robfalck at gmail.com> wrote:
> That looks good.  I apologize for not adding the documentation myself.
>
> On Tue, May 5, 2009 at 2:17 PM, <josef.pktd at gmail.com> wrote:
>>
>> On Tue, May 5, 2009 at 12:27 PM, Pauli Virtanen <pav at iki.fi> wrote:
>> > Tue, 05 May 2009 11:46:01 -0400, josef.pktd wrote:
>> >
>> >> Rob Falck just pointed out a nice set of examples for fmin_slsqp at
>> >> http://projects.scipy.org/scipy/attachment/ticket/570/slsqp_test.py.
>> >>
>> >> What's the best way to include them in the docs? the tutorial?
>> >
>> > The tutorial, I'd say.
>> >
>> >> Is there a way to include or link to examples that are too long for a
>> >> docstring?
>> >
>> > Add a label like
>> >
>> > .. _tutorial-sqlsp:
>> >
>> > at the relevant point in the tutorial, and refer it to as
>> >
>> >        More examples :ref:`in the tutorial <tutorial-sqlsp>`
>> >
>> > or :ref:`tutorial-sqlsp` in the docstring, or something along these
>> > lines.
>> >
>>
>> I did this, but mostly cut and paste:
>>
>>
>> http://docs.scipy.org/scipy/docs/scipy.optimize.slsqp.fmin_slsqp/#scipy-optimize-fmin-slsqp
>>
>> http://docs.scipy.org/scipy/docs/scipy-docs/tutorial/optimize.rst/#tutorial-sqlsp
>>
>> Maybe someone who knows more about fmin_slsqp can edit it.
>>
>> One more question:
>> http://docs.scipy.org/scipy/docs/scipy-docs/tutorial/optimize.rst
>> does a literal include of some files in the examples subdirectory. I
>> didn't find a way to display and edit them in the docs editor.
>> If we include more sample scripts, it might be good, to find a way to
>> add and edit them through the doc editor. Right now the relatively
>> long example script that I pasted looks a bit ugly in the tutorial
>> text.

Thanks for checking.

Do you have a brief description available?
Without looking at it more carefully I got a bit confused about the
relationship to least squares. From the description in the fortran
file it looks like a minimizer of an objective function and not a
least squares minimizer. Is iterative least squares just the algorithm
or is there a closer relationship to LS?

Josef

PS we prefer bottom posting.