The OSCAR project
The OSCAR project
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 our issue tracker or by sending an email to oscar@mathematik.uni-kl.de.
Using OSCAR requires a fairly recent C++ compiler supporting the C++17 standard. Suitable compilers include
Moreover, GNU make is required.
The following instructions assume that you are at least somewhat familiar with using a terminal interface.
sudo apt-get update
sudo apt-get install build-essentialThe LTS release Ubuntu 16.04 has reached end of life in April 2019, but still receives security updates until April 2021. In general we recommend that you upgrade to a more recent Ubuntu version.
If you wish to proceed with it anyway, you can install a newer compiler as follows.
Enter the following commands into a terminal (this will prompt for your password
and requires that you have permissions to administer your computer).
sudo apt-get install -y software-properties-common
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt update
sudo apt install g++-7 -y
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-7 60 --slave /usr/bin/g++ g++ /usr/bin/g++-7
sudo dnf install gcc-c++ makexcode-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.You can now follow the instructions for Ubuntu 18.04 or newer above.
To start bash in a later session, just search for bash
.
OSCAR requires at least Julia 1.3.1, but we recommend running it with the latest stable Julia release, which is 1.5.3 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.
WARNING: Windows users should not install the Julia version for Windows here, as Oscar does not currently work directly on Windows. Instead, please install the Linux version inside Windows Subsystem for Linux (WSL).
On macOS, you can also install it via Homebrew: brew install julia
The JILL project is a python package which allows installing and updating Julia on Linux, macOS – 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. (JILL also supports Windows, but as explained in step 1 above, OSCAR does not work under Windows directly, but rather requires the Windows Subsystem for Linux (WSL).)
For Linux users, it may also be tempting to install Julia via your distro package manager (e.g., apt, pac, dnf, …). We advise against this, as at least in the past these often provided outdated or broken Julia versions (e.g. with incorrect binary dependency versions, or with parts of Julia removed). Feel free to try this route, but if anything breaks, please consider installing Julia via one of the other methods listed above.
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) GAP, Hecke, Nemo, Polymake and Singular
Version 0.5.0 ...
... which comes with absolutely no warranty whatsoever
Type: '?Oscar' for more information
(c) 2019-2020 by The Oscar Development Team
julia>
Please have a look at
for some examples (as Jupyter notebooks).