Download and Installation

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.

Step 1: Install prerequisites

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.

Ubuntu 18.04 "Bionic" or newer; Debian 10 "Buster" or newer 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 update
sudo apt-get install build-essential
Ubuntu 16.04 "Xenial"

The 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

Fedora 28 or newer Enter the following commands into a terminal (this will prompt for your password and requires that you have permissions to administer your computer).
sudo dnf install gcc-c++ make
Other Linux distributions Please install a supported C/C++ compiler for your Linux distribution, as described above.
macOS 10.12 or newer On macOS, you need to install the Xcode command line tools, as explained in the following instructions.
  1. Install Xcode via the App Store.
  2. Launch a Terminal and enter the command xcode-select —install, then press enter.
  3. A window will appear asking you: The xcode-select command requires the command line developer tools. Would you like to install the tools now?. Confirm this by clicking Install.
  4. Wait for this to complete; it needs to download about 130 MB of data.
  5. You can verify that everything worked verifying the /Library/Developer/CommandLineTools/usr/bin/ exists and contains executables such as clang and clang++, the C and C++ compiler.
macOS 10.11 or older Unfortunately the Xcode versions available for older macOS versions do not support C++17. We recommend updating to macOS 10.12 or later, and Xcode 9.2 or later. If this is not an option and you are an experienced user, you might be able to get things working by installing a newer C/C++ compiler through some other means, e.g. via Homebrew. However, we cannot provide support for this.
Windows 10 We currently only support Windows 10 or newer using Windows Subsystem for Linux (WSL).
  1. Search for "Turn Windows features on or off"
  2. On the left panel, select "Turn Windows features on or off"
  3. Select "Windows subsystem for Linux" and press "Ok"
  4. Click "Restart the PC"
  5. Click the Windows store icon (shopping bag)
  6. Search for "Ubuntu" in the store - it's free!
  7. Select "Ubuntu" and "Get" the app
  8. Click "Launch" and follow the prompts

You can now follow the instructions for Ubuntu 18.04 or newer above.

To start bash in a later session, just search for bash.

Step 2: Install Julia 1.3.1 or newer

Install Julia 1.3.1 or newer by downloading it from the Julia homepage, and following their platform specific instructions.

Step 3: Install OSCAR

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.2.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)

Edit this page Contact webmaster Imprint Privacy policy © 2018-2020 The OSCAR Group