FAQ: Difference between revisions

No change in size ,  16 November 2011
no edit summary
No edit summary
Line 139: Line 139:
* a profiler
* a profiler
* broadcasting enabled for all built-in binary elementwise operators
* broadcasting enabled for all built-in binary elementwise operators
=What documentation exists for Octave?=
Besides the current wiki, there are other important sources of documentation and help for Octave.
==What documentation exists for Octave?==
The Octave distribution includes a 650+ page manual that is also distributed under the terms of the GNU GPL. It is available on the web at http://www.octave.org/docs.html and you will also find there instructions on how to order a paper version.
The complete text of the Octave manual is also available using the GNU Info system via the GNU Emacs, info, or xinfo programs, or by using the <tt>doc</tt> command to start the GNU info browser directly from the Octave prompt.
If you have problems using this documentation, or find that some topic is not adequately explained, indexed, or cross-referenced, please report it on http://bugs.octave.org.
==Getting additional help==
If you can't find an answer to your question, the help@octave.org mailing list is available for questions related to using, installing, and porting Octave that are not adequately answered by the Octave manual or by this document.
==User community==
To subscribe to the list, go to http://www.octave.org/archive.html and follow the link to the subscription page for the list.
Please do not send requests to be added or removed from the mailing list, or other administrative trivia to the list itself.
An archive of old postings to the help-octave mailing list is maintained on http://www.octave.org/archive.html.
You will also find some user advice and code spread over the web. Good starting points are the Octave Wiki http://wiki.octave.org and Octave-Forge http://octave.sourceforge.net
We also have [http://www.octave.org/chat.html an IRC chat room].
==I think I have found a bug in Octave.==
“I think I have found a bug in Octave, but I'm not sure. How do I know, and who should I tell?”
First, see the section [http://www.octave.org/bugs.html on bugs and bug reports in the Octave manual]. When you report a bug, make sure to describe the type of computer you are using, the version of the operating system it is running, and the version of Octave that you are using. Also provide enough code and configuration details of your operating system so that the Octave maintainers can duplicate your bug.
=How can I obtain Octave?=
==Source code==
Source code is available on the Octave development site, where you are sure to get the latest version.
* http://www.octave.org/download.html
* ftp://ftp.octave.org/pub/octave/
Since Octave is distributed under the terms of the GPL, you can get Octave from a friend who has a copy, or from the Octave website.
==Pre-compiled binary packages==
The Octave project does not distribute binary packages, but other projects do. For an up-to-date listing of packagers, see:
* http://www.octave.org/download.html
* [[Compile From Source]]
As of today, Octave binaries are available at least on Debian, Ubuntu, RedHat, Suse and Fedora GNU/Linuxen, Mac OS X, Windows' 98, 2000 and XP, Vista, and 7.
==How do I get a copy of Octave for (some other platform)?==
Octave currently runs on Unix-like systems, Mac OS X, and Windows. It should be possible to make Octave work on other systems as well. If you are interested in porting Octave to other systems, please contact [mailto:maintainers@octave.org the maintainers' mailing list].
=Installation Issues and Problems=
Octave 3.4 requires approximately 1.3 GB of disk storage to unpack and compile from source (considerably less if you don't compile with debugging symbols). Once installed, Octave requires approximately 355 MB of disk space (again, considerably less if you don't compile with debugging symbols, approximately 50 MB).
==What else do I need?==
To compile Octave, you will need a recent version of GNU Make. You will also need GCC 4.3 or later, although GCC 4.4 or later is recommended.
'''You must have GNU Make to compile octave'''. Octave's Makefiles use features of GNU Make that are not present in other versions of make. GNU Make is very portable and easy to install.
==Can I compile Octave with another C++ compiler?==
Yes, but development is done primarily with GCC, so you may hit some incompatibilities. Octave is intended to be portable to any standard conforming compiler. If you have difficulties that you think are bugs, please report them to the http://bugs.octave.org bug tracker, or ask for help on the [mailto:help@octave.org mailing list].


=Coding=
=Coding=
Line 226: Line 298:


Octave includes LSODE and DASSL for solving systems of stiff ordinary differential and differential-algebraic equations. These functions are built in to the interpreter.
Octave includes LSODE and DASSL for solving systems of stiff ordinary differential and differential-algebraic equations. These functions are built in to the interpreter.
=What documentation exists for Octave?=
Besides the current wiki, there are other important sources of documentation and help for Octave.
==What documentation exists for Octave?==
The Octave distribution includes a 650+ page manual that is also distributed under the terms of the GNU GPL. It is available on the web at http://www.octave.org/docs.html and you will also find there instructions on how to order a paper version.
The complete text of the Octave manual is also available using the GNU Info system via the GNU Emacs, info, or xinfo programs, or by using the <tt>doc</tt> command to start the GNU info browser directly from the Octave prompt.
If you have problems using this documentation, or find that some topic is not adequately explained, indexed, or cross-referenced, please report it on http://bugs.octave.org.
==Getting additional help==
If you can't find an answer to your question, the help@octave.org mailing list is available for questions related to using, installing, and porting Octave that are not adequately answered by the Octave manual or by this document.
==User community==
To subscribe to the list, go to http://www.octave.org/archive.html and follow the link to the subscription page for the list.
Please do not send requests to be added or removed from the mailing list, or other administrative trivia to the list itself.
An archive of old postings to the help-octave mailing list is maintained on http://www.octave.org/archive.html.
You will also find some user advice and code spread over the web. Good starting points are the Octave Wiki http://wiki.octave.org and Octave-Forge http://octave.sourceforge.net
We also have [http://www.octave.org/chat.html an IRC chat room].
==I think I have found a bug in Octave.==
“I think I have found a bug in Octave, but I'm not sure. How do I know, and who should I tell?”
First, see the section [http://www.octave.org/bugs.html on bugs and bug reports in the Octave manual]. When you report a bug, make sure to describe the type of computer you are using, the version of the operating system it is running, and the version of Octave that you are using. Also provide enough code and configuration details of your operating system so that the Octave maintainers can duplicate your bug.
=How can I obtain Octave?=
==Source code==
Source code is available on the Octave development site, where you are sure to get the latest version.
* http://www.octave.org/download.html
* ftp://ftp.octave.org/pub/octave/
Since Octave is distributed under the terms of the GPL, you can get Octave from a friend who has a copy, or from the Octave website.
==Pre-compiled binary packages==
The Octave project does not distribute binary packages, but other projects do. For an up-to-date listing of packagers, see:
* http://www.octave.org/download.html
* [[Compile From Source]]
As of today, Octave binaries are available at least on Debian, Ubuntu, RedHat, Suse and Fedora GNU/Linuxen, Mac OS X, Windows' 98, 2000 and XP, Vista, and 7.
==How do I get a copy of Octave for (some other platform)?==
Octave currently runs on Unix-like systems, Mac OS X, and Windows. It should be possible to make Octave work on other systems as well. If you are interested in porting Octave to other systems, please contact [mailto:maintainers@octave.org the maintainers' mailing list].
=Installation Issues and Problems=
Octave 3.4 requires approximately 1.3 GB of disk storage to unpack and compile from source (considerably less if you don't compile with debugging symbols). Once installed, Octave requires approximately 355 MB of disk space (again, considerably less if you don't compile with debugging symbols, approximately 50 MB).
==What else do I need?==
To compile Octave, you will need a recent version of GNU Make. You will also need GCC 4.3 or later, although GCC 4.4 or later is recommended.
'''You must have GNU Make to compile octave'''. Octave's Makefiles use features of GNU Make that are not present in other versions of make. GNU Make is very portable and easy to install.
==Can I compile Octave with another C++ compiler?==
Yes, but development is done primarily with GCC, so you may hit some incompatibilities. Octave is intended to be portable to any standard conforming compiler. If you have difficulties that you think are bugs, please report them to the http://bugs.octave.org bug tracker, or ask for help on the [mailto:help@octave.org mailing list].


==How does Octave solve linear systems?==
==How does Octave solve linear systems?==