Installation

Preparing your system

ROSALIA is based on multiple packages, including Astropy, Astroquery, Romanisim, NumPy, SciPy, Matplotlib among many others. The easiest way to install all the dependencies is through a package manager like Conda or Mamba. If you have a Conda/Mamba package manager already installed in your system, skip to the following section. If you do not have a package manager, follow the Conda installation instructions at the Space Telescope *stenv* environment webpage.

There are many versions of Conda managers. We recommend using free Miniforge <https://github.com/conda-forge/miniforge> with mamba as the package manager. You can install Miniforge by following the instructions at the Miniforge GitHub repository. As a summary, use the following commands:

Downloading Miniforge for Linux

wget -O Miniforge3.sh "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"

Downloading Miniforge for MacOS

curl -fsSLo Miniforge3.sh "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-$(uname -m).sh"

This will download a Miniforge.sh file. Run it to install Miniforge:

bash Miniforge3.sh -b -p "${HOME}/conda"

To finish the installation, run the following scripts:

source "${HOME}/conda/etc/profile.d/conda.sh"
# For mamba support also run the following command
source "${HOME}/conda/etc/profile.d/mamba.sh"

That is it! You can activate your Miniforge installation with:

conda activate

Installing ROSALIA

Create a clean environment for ROSALIA

conda create -n rosalia python=3.12 conda-forge::astromatic-swarp conda-forge::gnuastro

After the new environment is created, we can activate it.

conda activate rosalia

Once in a clean conda environment, we can install ROSALIA. The preferred method to install it is through pip.

pip install rosalia-wfi

ROSALIA needs a series of cache files to work. If they are not installed, most of the functions will work, but you won’t be able to estimate the surface brightness of the stray light, which is one of the main functionalities of ROSALIA. To install the cache files, download the following folder:

ROSALIA Cache,

Then, extract the contents of the downloaded file and move the resulting folder to a location of your choice. Finally, set the environment variable ROSALIACACHE to point to the location of the extracted folder. For example, if you extracted the folder to /path/to/rosalia-cache, you can set the environment variable as follows:

export ROSALIACACHE=/path/to/rosalia-cache

CRDS installation

ROSALIA relies on the CRDS package to access the calibration reference files for the Roman Space Telescope. CRDS is installed by default as a ROSALIA dependency, but it needs to be configured to work properly. If - for any reason - it is not installed, you can manually install CRDS with:

pip install crds

To configure CRDS, we need to set the environment variable CRDS_PATH to point to a directory where CRDS can store its cache files. For example, you can create a directory called crds_cache in your home directory and set the environment variable as follows:

export CRDS_PATH=$HOME/crds_cache
export CRDS_SERVER_URL=https://roman-crds.stsci.edu

That is it! We are ready to start analyzing Roman Space Telescope images.