bugGNU Octave - Bugs: bug #49360, move ode solver & option...

 
 

bug #49360: move ode solver & option documentation from old odepkg to octave core manual

Submitter:  Rik <rik5>
Submitted:  Sun 16 Oct 2016 05:01:53 PM UTC
   
 
Category:  Documentation Severity:  2 - Minor
Priority:  5 - Normal Item Group:  Documentation
Status:  Confirmed Assigned to:  None
Originator Name:  Open/Closed:  * Open
Release:  * dev Operating System:  * Any
Fixed Release:  None Planned Release:  None
* Mandatory Fields

Add a New Comment Rich Markup
   

Jump to the original submission

Fri 09 Dec 2022 08:46:21 PM UTC, comment #11: 

looking at this report, it appears that the main focus of the last TODO was moving necessary documentation from the old odepkg sources to the current octave docs.

the target should apparently be:
https://octave.org/doc/interpreter/Matlab_002dcompatible-solvers.html

but the old documentation is a bit harder to locate now for comparison as the bitbucket source was archived breaking the links below. I followed the path to recover the archive, but the plaintext files in the archive have all apparently been encoded, so someone more knowledgeable would have to determine how to pull those.

there is an outdated sourceforge repository (last update ~2016):
https://sourceforge.net/p/octave/odepkg/ci/default/tree/

that at least has that version of the texi documentation plus all of the solver example files available.

Seems the tasks for this involve
1) doing a side by side comparison of the current information in the octave doc and that odepkg documentation, determining what else should be ported over, and doing so.
2) stepping through all of the odepkg example functions to determine what should be moved into the documentation, or turned into demo's etc.

to avoid the risk of the other archive becoming less-than-accessible, I've attached the old SF archive here.

(file #54079)

Nicholas Jankowski <nrjank>
Group Member
Sat 20 Nov 2021 02:06:34 AM UTC, comment #10: 

@Nicholas: On the larger question of what there is of value in odepkg, there are still functions that are present there that should be transferred to Octave core in order to have the same set of base functions in core that Matlab does.

On the narrow question of the documentation, I haven't looked at this in years so I don't know.

Rik <rik5>
Group administrator
Fri 12 Nov 2021 03:15:05 AM UTC, comment #9: 

any change to the status of documentation for odeset? has everything of value been moved from the old odepkg? more to do? obviously the 2 year task has stretched out to 3, but maybe a to-do list would help it get chipped away at over the next 2-3.

Nicholas Jankowski <nrjank>
Group Member
Fri 28 Sep 2018 08:14:48 AM UTC, comment #8: 

Rik, I think your point of comment #5 was that there is lots of documentation in the odepkg for "odeset" with examples [1] (line 1011 to 1821), that can really be used in the Octave manual [2] as well.

By the change of comment #6 I wished the users to at least know what is allowed for the individual parameters.  The other transformation requires some review time, but might be as easy as a copy & paste when looking at them.

So maybe leave it open for another two years as project for the development branch ;-)

[1] https://bitbucket.org/odepkg/odepkg/src/5eba1b653be54c0bb383cf06f73f31e671a72816/doc/odepkg.texi?at=default&fileviewer=file-view-default#odepkg.texi-1011

[2] https://octave.org/doc/interpreter/Matlab_002dcompatible-solvers.html

Kai Torben Ohlhus <siko1056>
Group Member
Thu 27 Sep 2018 03:30:31 PM UTC, comment #7: 

Is this bug now complete or is there more to do?

Rik <rik5>
Group administrator
Wed 26 Sep 2018 02:49:58 PM UTC, comment #6: 

Some update on the options documentation:

   https://hg.savannah.gnu.org/hgweb/octave/rev/22f6cb277893

Kai Torben Ohlhus <siko1056>
Group Member
Mon 24 Oct 2016 06:48:30 PM UTC, comment #5: 

The remaining issue before closing this report is to transfer more of the texi documentation from odepkg in to either the individual m-files or to diffeq.txi.

Rik <rik5>
Group administrator
Mon 17 Oct 2016 04:13:37 PM UTC, comment #4: 
Carlo de Falco <cdf>
Group Member
Mon 17 Oct 2016 04:08:31 PM UTC, comment #3: 

Jacopo proposed adding documentation from odepkg to diffeq.txi.


> The relevant part are lines 754 to 1102 in
> https://sourceforge.net/p/octave/odepkg/ci/default/tree/doc/odepkg.texi



Rik <rik5>
Group administrator
Mon 17 Oct 2016 04:06:28 PM UTC, comment #2: 

Nir proposed some fix-ups.  See attached odeset.diff.

(file #38744)

Rik <rik5>
Group administrator
Mon 17 Oct 2016 10:06:09 AM UTC, comment #1: 


An initial documentation of odeset otpions was pushed here:

http://hg.savannah.gnu.org/hgweb/octave/file/abfb538acc59/scripts/ode/odeset.m

More extensive documentation is available in the odepkg manual
and should probably be moved in the Octave interpreter manual.

Carlo de Falco <cdf>
Group Member
Sun 16 Oct 2016 05:01:53 PM UTC, original submission:  

One of the goals of Octave is to be a viable replacement for Matlab.  However, odeset has 23 tunable parameters, but no explanation for any of them.  Octave is not a good replacement if we require the use of Matlab documentation in order to understand how to code for Octave.


Rik <rik5>
Group administrator

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

Attached Files
file #54079:  SF_octave-odepkg-20017c4feae68cac685dcb23e23855d2bdb0d43c.zip added by nrjank (554KiB - application/x-zip-compressed - outdated Source forge odepkg repo c.2016)
file #38744:  odeset.diff added by rik5 (4KiB - text/x-diff)

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by nrjank (Posted a comment)
  • -email is unavailable- added by siko1056 (Posted a comment)
  • -email is unavailable- added by rik5
  • -email is unavailable- added by cdf (Posted a comment)
  • -email is unavailable- added by rik5 (Submitted the item)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only group members can vote.

     

    Follow 13 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2022-12-09 nrjank StatusNeed Info Confirmed
    2022-12-09 nrjank Attached File- Added SF_octave-odepkg-20017c4feae68cac685dcb23e23855d2bdb0d43c.zip, #54079
        Summaryodeset lacks documentation for solver options move ode solver & option documentation from old odepkg to octave core manual
    2021-11-12 nrjank StatusPostponed Need Info
    2018-09-28 siko1056 StatusIn Progress Postponed
        Release4.4.1 dev
    2018-09-26 mtmiller Carbon-CopyRemoved 80942 -
    2018-09-26 siko1056 Release4.2.0 4.4.1
    2016-11-17 mtmiller Severity3 - Normal 2 - Minor
        Release4.2.0-rc2 4.2.0
    2016-10-17 rik5 StatusConfirmed In Progress
    2016-10-17 rik5 Attached File- Added odeset.diff, #38744
        Carbon-Copy- Added nir_krakauer

    Back to the top

    Powered by Savane 3.13-d3ae.
    Corresponding source code