Welcome to Roman / ROSALIA’s documentation!

ROSALIA (Roman Sky Analyst for Low surface brightness Imaging & Astronomy) is a NASA pipeline to model the sky background level on astronomical images obtained with Nancy Grace Roman Space Telescope and its direct predecessor, the legendary Hubble Space Telescope. In particular ROSALIA is focused on the prediction and calibration of stray-light in the Roman Wide Field Instrument, one of the main contaminants in ultra deep low surface brightness observations, and the main source of gradients of parasitic light for space telescopes.

ROSALIA combines the information from existing photometric catalogs (Gaia, 2MASS, WISE) with precise optical and payload ray-tracing models of the Roman Space Telescope, allowing to generate images of stray-light and other components of the sky-background for user-defined observational conditions.

ROSALIA is funded through a NASA Grant (D.14 Roman 2022), ROSES/Nancy Grace Roman Space Telescope Research and Support Participation Opportunities.

Check out the How to use section for further information how to use ROSALIA to analyze your images. In install we describe how to set up ROSALIA in your machine.

Note

Space is hard, and this project is under active development. The predicted sky background levels by ROSALIA might not be exact and it is not recommended to use it blindly. But we keep pushing everyday to make it better, and our team is happy to assist with your particular project. We will be including more functions and tutorials in the very near future. ROSALIA is a Roman Wide Field Science project that needs your help to improve! If you find a useful capability that could be added, a problem to be resolved, or any other idea, contact us.

Contents

• What is ROSALIA?
• Installation
  • Preparing your system
  • Installing ROSALIA
• Stray Light
  • In-field vs. out-field stray-light
  • Quickstart: Stray Light Analysis Example with ROSALIA
  • Case study: Calibrating stray-light with a bright star
• Zodiacal Light
  • Modeling the Zodiacal light background with ROSALIA
• In-field Stars
  • Modelling scattered emission (PSF) from stars inside Roman Field of View
• Solar System Objects
  • Are there any major Solar System Objects (SSOs) in my Roman images?
  • How far are the Solar System planets from WFI?
  • Are there any asteroids in my Roman images?
• Additional Tools
  • Finding the nominal position angle
  • Planning offset observations
  • Transforming ASDF to FITS
  • Generating some mock Roman / WFI observations
  • Estimating the surface brigthness limit of Roman WFI observations
• How to use
  • ROSALIA - From the command line
  • ROSALIA - From Python
• Roman Research Nexus
  • How to use ROSALIA in the Roman Research Nexus
• Roman Commissioning Stray-light Activities
  • Selecting the stray-light regions
  • Selecting the calibration sources and sky pointings
  • Updating the Astronomer Proposal Tool submission file
• Who is ROSALIA?
• ROSALIA package
  • Submodules
  • rosalia.albedo module
  • rosalia.astrometry module
  • rosalia.attitude module
  • rosalia.constants module
  • rosalia.correct module
  • rosalia.detectors module
  • rosalia.gaia module
  • rosalia.horizons module
  • rosalia.irsa module
  • rosalia.ndi module
  • rosalia.plots module
  • rosalia.psf module
  • rosalia.render module
  • rosalia.roman module
  • rosalia.sky module
  • rosalia.skysurf module
  • rosalia.sso module
  • rosalia.telescopes module
  • rosalia.tests module
  • rosalia.utils module
  • Module contents
• API
  • rosalia