Windows

The two options, in order of preference, are using Docker or compiling from source using the Windows bash shell.

Using Docker

Docker installs a self-contained Linux container (similar to a virtual machine) on your machine. The Atlas software runs entirely in the container, making it less dependent on the details of your system. This is a good option if you have trouble compiling the software yourself.

Install Docker (community version) for your system, then give the command:

sudo docker run -it jeffreyadams/atlasofliegroups:version1.1

This downloads the software and runs it, launching atlas and reading in all.at. The first time takes up to a few minutes; subsequent runs are much faster. To get the latest update:

sudo docker pull jeffreyadams/atlasofliegroups:version1.1

File Input and Output in Docker

Since Docker runs in a container, extra effort is required for file I/O. On Windows this is compounded by differences between the Linux and Windows filesystems. Use the -v flag to mount a host directory into the container:

sudo docker run -it -v C:\Users\you\files:/home/atlas/files jeffreyadams/atlasofliegroups:version1.1

Other Docker Commands

List the images Docker knows about:

sudo docker images
sudo docker image ls

List running containers:

sudo docker container ls

Kill a running container (replace container_id with the actual ID):

sudo docker container kill container_id

Remove containers that are no longer running:

sudo docker container prune

Compiling from Source

The best compilation option on Windows 10 and 11 is to use the Windows Subsystem for Linux (WSL) bash shell, which provides a Linux command-line environment based on Ubuntu.

If you haven't done so already, install the bash shell following the instructions from Microsoft. Once installed, open a bash window and install the necessary software:

sudo apt-get install git
sudo apt-get install make
sudo apt-get install g++
sudo apt-get install bison
sudo apt-get install libreadline-dev

Download the source code using git

For users who are not familiar with git, see Help with git. Choose a directory to store the source code, navigate there, then type:

git clone https://github.com/jeffreyadams/atlasofliegroups.git

This creates a subdirectory atlasofliegroups and stores the files there.

Compile

cd to the atlasofliegroups directory and type:

make

If all goes well you will have an executable file atlas. Give the command:

atlas

You should see something like:

This is 'atlas' (version 1.1, axis language version 1.0),
the Atlas of Lie Groups and Representations interpreter,
compiled on Dec 30 2021 at 16:01:25.   http://www.liegroups.org/

Congratulations! Once Atlas is running, the Linux instructions for After compiling, file I/O, and updating apply equally here.