GNU Octave Wiki: Difference between revisions

From Octave
Jump to navigation Jump to search
No edit summary
(→‎⚙️ Installing: Remove FontAwesome plugin.)
 
(256 intermediate revisions by 39 users not shown)
Line 1: Line 1:
The recommended way for installing Octave and Octave-Forge packages on GNU/Linux systems
[https://www.gnu.org/software/octave/ GNU Octave] is a high-level interpreted language, primarily intended for numerical computations. It provides capabilities for the numerical solution of linear and nonlinear problems, and for performing other numerical experiments. It also provides extensive graphics capabilities for data visualization and manipulation. The program is named after [https://en.wikipedia.org/wiki/Octave_Levenspiel Octave Levenspiel], a former professor of the principal author. GNU Octave is normally used through its interactive interface ([https://en.wikipedia.org/wiki/Command-line_interface CLI] and [https://en.wikipedia.org/wiki/Graphical_user_interface GUI]), but it can also be used to write non-interactive programs. The project was conceived around 1988 and at first it was intended to be a companion to a chemical reactor design course. The GNU Octave language is largely compatible to [https://en.wikipedia.org/wiki/MATLAB Matlab] so that most programs are easily portable. In addition, functions known from the C standard library and from UNIX system calls and functions are supported. C/C++ and Fortran code can be called from Octave by creating [https://octave.org/doc/interpreter/Getting-Started-with-Oct_002dFiles.html Oct-Files], or using Matlab compatible [https://octave.org/doc/interpreter/Mex_002dFiles.html Mex-Files].
is via each distribution package installation system.


More detailed instructions follow.
== ⚙️ [[:Category:Installation|Installing]] ==


=Debian and Debian-based (such as Ubuntu)=
Installation instructions for:
* [[Octave for GNU/Linux|GNU/Linux]], [[Octave for Android|Android]], and [[Octave for other Unix systems|other Unix systems]]
* [[Octave for macOS|macOS]]
* [[Octave for Microsoft Windows|Microsoft Windows]]


Either use {{Codeline|aptitude}} or {{Codeline|apt-get}}:
Get installers and sources from https://www.octave.org/download.


    # aptitude install octave<version> octave<version>-doc
{{Note|'''GNU Octave {{Release}}''' is the current stable release.}}


where {{Codeline|<version>}} must be substituted by the appropriate string.
Are you using an old version of Octave?  Check the [[Release History]] page to see how old it is.


The Octave-Forge packages are spread over many Debian packages. All Octave-Forge packages will probably be found with the command:
== ❓ Getting help ==


    $ aptitude search ?description\(octave-forge\)
* [[FAQ]]
* [https://docs.octave.org/quickref Octave Quick Reference PDF]
* [https://docs.octave.org/latest Full documentation]


For more details, see the [[Debian]] specific instructions page.
* [https://octave.discourse.group Octave Discourse] - Forum for Octave users and developers.
* [https://octave.org/support Other support options]


=== Troubleshooting ===
== 💡 [[:Category:Resources|Getting started]] 🔰 ==


At Ubuntu, broken packages install may cause a <span color="red">error: `pkg' undefined</span> error, previously reported as [https://bugs.launchpad.net/ubuntu/+source/octave3.2/+bug/465005 bug 465005]:
* [[Publications using Octave#Books|Books]]
* [[Video tutorials|Videos]]
* [[:Category:Resources|Tutorials and Examples]]


...
== 🔬 [[:Category:Development|Development]] ==
Setting up octave3.2 (3.2.2-2build1) ...
error: `pkg' undefined near line 0 column 1
dpkg: error processing octave3.2 (--configure):
  subprocess installed post-installation script returned error exit status 1
Processing triggers for libc-bin ...
ldconfig deferred processing now taking place
Processing triggers for menu ...
Errors were encountered while processing:
  octave3.2
E: Sub-process /usr/bin/dpkg returned an error code (1)


Fix this by complete reinstall:
We always need more help improving Octave and there are many ways [https://www.gnu.org/software/octave/get-involved.html you can contribute] (fixing bugs, developing new features, answering questions on [https://octave.discourse.group/ Octave Discourse], ...).


sudo apt-get --purge remove octave3.2
::* Get an overview about the [[:Category:Development|GNU Octave development]].
sudo apt-get --purge remove octave3.2-common
::* Take a look at our [[Projects|project ideas]] and [[Summer of Code - Getting Started | Summer of Code project
sudo apt-get install octave3.2
ideas]].
=Ubuntu 12.04=
The package can be obtained from the Software Center but the Octave package is old (3.2).  The most current stable version is available through a Personal Package Archive (PPA).  You will need to add the PPA to you system. Execute the following in a terminal:


    sudo apt-add-repository ppa:octave/stable
== 📦 [[:Category:Packages|Packages]] ==
    sudo apt-get update


If you need more information on adding a repository, visit [https://launchpad.net/~octave/+archive/stable GNU Octave Stable Releases] PPA. You can now install from the Software Center or a terminal.
* [https://docs.octave.org/latest/Installing-and-Removing-Packages.html Installing packages]
* [https://packages.octave.org Octave Packages] &mdash; collection of packages and toolboxes


To install Octave with documentation execute the following at in a terminal:
==  📝[[:Category:User Contributed Code|User Contributed Code]] ==


    sudo apt-get install octave octave-doc octave-info octave-htmldoc
* [[:Category:User Contributed Code|Category User Contributed Code]] &mdash; A compilation of user provided code (✏️ add yours!)


If you want to be able to build packages from Octave Forge, you will want liboctave-dev package:
== 🎓 [[:Category:Academia|Academia]] ==


    sudo apt-get install liboctave-dev
* [[Publications using Octave]] &mdash; A compilation of scientific publications making reference to GNU Octave (add yours!).


If you want Octave debugging symbols, use the following:
== 🌐 External Links ==


    sudo apt-get install octave-dbg
* [https://octave.org Octave Homepage]
=Fedora=
* [https://savannah.gnu.org/bugs/?group=octave Bug Tracker]
The packages can be installed using the yum command, they are:
* [https://savannah.gnu.org/task/?group=octave Task Tracker]
 
* [https://savannah.gnu.org/patch/?group=octave Patch Tracker]
*octave
* [https://savannah.gnu.org/hg/?group=octave Development Repository]
*octave-devel
*octave-forge
 
{{Codeline|octave-forge}} is recommended to all users, as it provides many extra functions. {{Codeline|octave-devel}} contains the octave headers and {{Path|mkoctfile}} script and is really only needed by users who are developing code that is to be dynamically linked to octave. {{Codeline|octave}} and {{Codeline|octave-forge}} can be installed with the command:
 
    # yum install octave-forge
 
By default, yum will most likely install blas and lapack as your matrix math libraries, but ATLAS is usually much faster. If you want to install atlas with octave, use the command
 
    # yum install octave-forge atlas
 
Note that if you are using an i386-compatible processor the base atlas package is not optimized for newer hardware. If you have newer hardware, you can get even better performance with the atlas-3dnow (AMD K6 processors), atlas-sse (Pentium III or newer), or atlas-sse2 (Pentium 4 or newer).
 
=Gentoo=
Octave is available through Gentoo's package management system, Portage:
 
    # emerge sync
    # emerge octave
    # emerge octave-forge (optional)
 
=Red Hat Enterprise=
 
Octave is available for Red Hat Enterprise Linux distributions through the [https://fedoraproject.org/wiki/EPEL EPEL] repository. This section applies to CentOS, Scientific Linux, and other Red Hat Enterprise rebuild distributions as well.
 
First, follow [https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F these instructions] to set up your system to install packages from EPEL. For example,
 
    # wget <nowiki>http://url/to/latest/epel-release-6-7.noarch.rpm</nowiki>
    # yum localinstall epel-release-6-7.noarch.rpm
 
Once the EPEL repository has been enabled, you can follow the rest of the [[#Fedora|instructions for Fedora]] to install Octave using yum.
 
Note that EPEL intentionally does not follow new releases as closely as other distributions. Consequently, the version of Octave provided by EPEL may be several months or years out of date. There are plans for the Octave maintainers to provide support and binary RPMs for enterprise GNU/Linux distributions, contact the [mailto:maintainers@octave.org maintainers mailing list] for more information.
 
=Red Hat=
 
GNU Octave is included with Red Hat. If you are still using an old version of Red Hat and want a newer version of GNU Octave, your best options are to consider updating your distribution to a recent Fedora release or compile octave from source.
 
Note that RH 7.x distributions (as well as Red Hat Enterprise Linux 2.1) have included an old version of GCC (pre 3.x). It is known that GCC 2.96 (included in RH7.3) can compile GNU Octave (as of version 2.1.57), but the resulting binary will be bad. Red Hat made available RPMs for GCC 3.1-5 through http://rhn.redhat.com (those RPMs may be available on other RPM repositories).
 
=SUSE Linux Enterprise and openSUSE=
Octave 3.6.2 is included in the science repository with SLE 11 SP2 and openSUSE 11.4, 12.1, 12.2
 
[http://download.opensuse.org/repositories/science/ OBS science]
 
For example, for openSUSE 12.2 you would do:
 
    # zypper ar http://download.opensuse.org/repositories/science/openSUSE_12.2/ science
    # zypper refresh
    # zypper install octave octave-devel
 
for other versions change the version number in the first command accordingly.
 
2012-08-21: arpack-ng and SuiteSparse 4.0 bindings which were broken before are again functional, if you have a previous version of the rpm's installed consider to update them.
 
[[Category:GNULinux]]
 
=Arch Linux=
 
Updated Octave's version is in the extra repository. It can be installed by typing:
 
    # pacman -S octave
 
[[Category:GNULinux]]
 
----

Latest revision as of 14:51, 4 March 2023

GNU Octave is a high-level interpreted language, primarily intended for numerical computations. It provides capabilities for the numerical solution of linear and nonlinear problems, and for performing other numerical experiments. It also provides extensive graphics capabilities for data visualization and manipulation. The program is named after Octave Levenspiel, a former professor of the principal author. GNU Octave is normally used through its interactive interface (CLI and GUI), but it can also be used to write non-interactive programs. The project was conceived around 1988 and at first it was intended to be a companion to a chemical reactor design course. The GNU Octave language is largely compatible to Matlab so that most programs are easily portable. In addition, functions known from the C standard library and from UNIX system calls and functions are supported. C/C++ and Fortran code can be called from Octave by creating Oct-Files, or using Matlab compatible Mex-Files.

⚙️ Installing[edit]

Installation instructions for:

Get installers and sources from https://www.octave.org/download.

Info icon.svg
GNU Octave 9.1.0 is the current stable release.

Are you using an old version of Octave? Check the Release History page to see how old it is.

❓ Getting help[edit]

💡 Getting started 🔰[edit]

🔬 Development[edit]

We always need more help improving Octave and there are many ways you can contribute (fixing bugs, developing new features, answering questions on Octave Discourse, ...).

📦 Packages[edit]

📝User Contributed Code[edit]

🎓 Academia[edit]

🌐 External Links[edit]