shesha 5.5.0.post2

SHESHA is the python part of the COMPASS platform designed to meet the need of high-performance for the simulation of AO systems

Table of Contents

• Table of Contents
  • Requirements
  • Installation of Anaconda/Miniconda
  • Installation of COMPASS via conda
  • Installation of SHESHA package for COMPASS
  • Test your installation
  • Run the simulation
  • More documentation (maybe not fully up-to-date)
  • Questions?

Requirements

• Linux distribution with wget and git installed
• Nvidia GPU card with CUDA toolkit >= 11.8 (Older versions could be available on request)

Installation of Anaconda/Miniconda

COMPASS binaries, which contain the optimized GPU code, can be installed via Anaconda. Then, you have to install Anaconda 3 or Miniconda 3 (python 3 is required).

We recommend Miniconda instead of Anaconda as it is much lighter, but it's up to you.

export CONDA_ROOT=$HOME/miniconda3
wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh -b -p $CONDA_ROOT

Don't forget to add your Miniconda or Anaconda directory to your PATH:

export PATH=$CONDA_ROOT/bin:$PATH

Installation of COMPASS via conda

Once Miniconda is installed, installing the COMPASS binaries is easy :

conda install -c compass compass -y

Note: conda main channel is compiled with CUDA 12. For previous version please have a look to the other channel and post an issue and we will try to provide it.

This command line will also install dependencies in your conda environment.

Installation of SHESHA package for COMPASS

First, you will need to set some environment variables:

export SHESHA_ROOT=$HOME/shesha
export PYTHONPATH=$SHESHA_ROOT:$PYTHONPATH
export PYTHONDONTWRITEBYTECODE=1

Finally, you can get the Shesha package of COMPASS. This python package is the user level of COMPASS. It also contains all the initialization functions.

git clone https://github.com/ANR-COMPASS/shesha.git $SHESHA_ROOT

Test your installation

Once the installation is complete, verify that everything is working fine :

cd $SHESHA_ROOT/tests
./checkCompass.sh

This test will basically launch fast simulation test cases and it will print if those cases have been correctly initialised.

Run the simulation

You are ready ! You can try it with one of our paramaters file:

cd $SHESHA_ROOT
ipython -i shesha/scripts/closed_loop.py data/par/par4bench/scao_sh_16x16_8pix.py

And if you want to launch the GUI:

cd $SHESHA_ROOT
ipython -i shesha/widgets/widget_ao.py

More documentation (maybe not fully up-to-date)

Project GitHub pages with a detailed user manual : https://anr-compass.github.io/compass/

doc auto-generated from code: http://shesha.readthedocs.io

wiki page of the COMPASS project: https://projets-lesia.obspm.fr/projects/compass/wiki/Wiki

Questions?

Please feel free to create an issue on Github for any questions and inquiries.