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.

Installing ROSALIA

Create a clean environment for ROSALIA

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

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

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: .. code-block:: sh

export ROSALIACACHE=/path/to/rosalia-cache

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