OSCAR is currently under heavy development, so all parts change continuously. If you encounter any trouble while following the steps outlined below, feel free to contact us via GitHub discussion, our issue tracker, or by sending an email to oscar@mathematik.uni-kl.de.
The following instructions assume that you are at least somewhat familiar with using a terminal interface.
xcode-select --install
, then press enter.The xcode-select command requires the command line developer tools. Would you like to install the tools now?. Confirm this by clicking
Install.
/Library/Developer/CommandLineTools/usr/bin/
exists and
contains executables such as clang
and clang++
,
the C and C++ compiler.sudo apt-get update
sudo apt-get install build-essential
sudo dnf install gcc-c++ make
OSCAR requires at least Julia 1.6.0, but we recommend running it with the latest stable Julia release, which is 1.8.5 at the time this is written.
There are several ways to install Julia:
By downloading it from the Julia homepage, and following their platform specific instructions.
The juliaup and JILL projects are external packages which allow installing and updating Julia – this is in particular handy for experienced users who may want to install multiple Julia versions in parallel; but also for beginners it can be convenient as it allows updating the installed Julia version quite easily.
To then install OSCAR, just start julia and run
using Pkg
Pkg.add("Oscar")
This will run for a few minutes. From then on, you can start Julia, then type using Oscar
and press enter to use OSCAR. The result should look something like this:
julia> using Oscar
----- ----- ----- - -----
| | | | | | | | | |
| | | | | | | |
| | ----- | | | |-----
| | | | |-----| | |
| | | | | | | | | |
----- ----- ----- - - - -
...combining (and extending) ANTIC, GAP, Polymake and Singular
Version 0.11.3 ...
... which comes with absolutely no warranty whatsoever
Type: '?Oscar' for more information
(c) 2019-2023 by The OSCAR Development Team
julia>
Please have a look at
for some examples (as Jupyter notebooks).
If you are a GAP user and have installed loaded OSCAR in a Julia session as
described above, you can at any time switch back and forth between the Julia prompt
and a GAP prompt, by using the command GAP.prompt()
:
julia> x = 1 1 julia> GAP.prompt() gap> Julia.x; 1 gap> G := SymmetricGroup(3); Sym( [ 1 .. 3 ] ) gap> quit; # or press Ctrl-D julia> GAP.Globals.G GAP: Sym( [ 1 .. 3 ] )
IJulia can be installed by following its installation page. Note that in some cases, IJulia must be “built” explicitly, see the trouble shooting page. If you try to open an existing notebook (stored in a “.ipynb” file), it might refer to an older Julia version, resulting in a “Kernel error”; the solution is then to select a different kernel from the menu.
If you are using OSCAR in the Windows Subsystem for Linux, you will require a browser in your subsystem. This can be a probem as the default subsystem is Ubuntu and Ubuntu installs browsers via snap which is disabled for subsystems. To circumvent this problem, please see how to install browsers via deb.