Simulation Tools

The Simulation Tools Handbook provides documentation for the tools and resources used to plan observations and simulate imaging data from the Roman Wide Field Instrument (WFI). These resources include exposure time calculators, image simulators, and other utilities that support the planning of Roman observations. All tools presented here are maintained by the Roman Science Operations Center (SOC) at the Space Telescope Science Institute.


Software Freeze: To ensure a stable user experience, most Roman tools will not be updated during the Call for Proposals period. Users will be notified if any urgent fixes are released.




A graphic of a tablet that has plots and images of stars. The background behind the tablet has the WFI logo and other various decorative shapes.







The Simulation Tools Documentation Ecosystem

For most elements described in the Simulation Tools Handbook, three main types of documentation are available, each offering a different perspective on the simulation tools:

  1. User Guides are presented here in the RDox Simulation Tools Handbook. These guides provide practical instructions for getting started with the tools and applying them to scientific projects.

  2. Code Repositories are hosted on GitHub, including example notebooks. These repositories are useful for reviewing source code and exploring basic usage examples.

  3. Developer Documentation are maintained on ReadTheDocs and updated as the code evolves. This documentation includes the most current installation instructions, detailed parameter descriptions, and other technical information.

The Table of the Status and Locations of Simulation Tools Documentation provides a concise overview of each tool and catalogs the available documentation for quick reference.


Table of the Status and Locations of Simulation Tools Documentation 

Simulation Tool

Tool Description

Roman User's Guide

Code Repository

Developer Documentation

STPSF

generates PSF from optical models

(tick) STPSF for Roman in RDox

(tick) STPSF on Github

(tick) STPSF on readthedocs

STIPS

fast simulator of astronomical scenes for full frame Level 2 (L2) data products

(tick) STIPS in RDox

(tick) STIPS on Github

(tick) STIPS on readthedocs

Roman I-Sim

image simulator of Level 1 (L1) and Level 2 (L2) data products

(tick) Roman I-Sim - The Roman Image Simulator

(tick) Roman I-Sim on Github

(tick) Roman I-Sim on readthedocs

Pandeia

exposure time calculator;

high precision, small area astronomical scenes

(tick) Pandeia for Roman in RDox

(error) Not available

(tick) Pandeia on STScI Outerspace

Simulation Development Utilities: 

pysiaf

transformation tool between instrument, observatory, and sky coordinates

(tick) pySIAF for Roman in RDox

(tick) pySIAF on GitHub

(tick)  pySIAF on readthedocs

synphot

synthetic photometry for input astronomical object

(tick) stsynphot for Roman in RDox

(tick)  stsynphot on GitHub

(tick)  stsynphot on readthedocs




Which Roman Simulation Tool Should I Use? 

This section is designed to help users navigate the Simulation Tools maintained by the SOC by outlining a simplified set of potential use cases. It is organized around broad scientific and technical tasks, such as simulating a PSF or calculating signal-to-noise ratios, which are further broken down into specific use cases to guide users toward the most appropriate workflows for their objectives. Note that the optimal workflow may involve using multiple tools.

The Nancy Grace Roman Space Telescope differs notably from prior missions such as HST and JWST through its wide field of view (0.28 square degrees) and focal plane array, which contains 18 individual detectors (see Introduction to the WFI). These characteristics make Roman particularly well-suited for large-scale astronomical surveys. As a result, simulating certain datasets can be more complex and may produce substantially larger data volumes compared with simulators developed for other missions.

While outside the scope of the SOC Simulation Tools, users interested in simulating WFI spectroscopic data can find additional information in the documentation maintained by the Science Support Center (SSC) at IPAC.

I want to simulate an individual Point Spread Function ... 


The WFI Point Spread Function (PSF) can be simulated using STPSF . This tool is designed to simulate individual PSFs on a specified detector with high fidelity. STPSF simulates only one PSF at a time and allows for detailed characterization of the field-dependent WFI PSF.  

I want to simulate an astronomical scene...


Understanding the impact of the PSF on the ability, for example, to distinguish astronomical sources or to measure galaxy shapes can be conducted using either  Pandeia or STIPS ; the best tool to use depends on the size and complexity of the astronomical scene. A scientific use case trying to understand the impact of the WFI PSF on an extended object will either need to: 

  • Use Pandeia to produce a scene simulation at the scale of a few arcseconds, or
  • Use Roman I-Sim to perform an astronomical scene simulation on detector scales, or
  • Although both tools above rely on STPSF for PSF modeling, users may alternatively prefer to perform their own convolution of extended object (e.g., a Sersic profile, or any other model) with an appropriate STPSF output.

STIPS can take user-generated catalogs that contain a mix of objects (point sources and/or extended objects), from the level of a full Roman detector to the full 18 detector FOV, and uses STPSF  models to quickly simulate WFI images.  STIPS can also include some instrumental properties such as instrumental background and noise.

For similar high-fidelity scene simulations formatted to work with the Roman STScI pipelines (unlike STIPS which does not conform to Roman datamodels), Roman I-Sim can also be used, albeit with longer runtimes.

For users interested in exploring the benefits and impacts of dithered observations, we recommend using Roman I-Sim to produce products that can be processed by the Roman STScI pipeline for combining observations. 

I want to calculate the signal-to-noise ratio... 


Pandeia offers the ability to perform signal-to-noise ratio (SNR) calculations for an input number of exposures for astronomical scenes of a few arc seconds across containing sources with user-specified properties. The ETC Web Interface also offers easy-to-use functionalities through a browser to facilitate the design of astronomical scenes and observations.

Note that effects related to the location of the source within a detector are currently not modeled in  Pandeia . If sources need to include detector location effects, then the user is advised to generate PSFs with STPSF and then apply any additional detector effects to achieve the desired accuracy.

STIPS uses  STPSF  models and  Pandeia background estimates to simulate L2 images for complex astronomical scenes. These images can be analyzed in order to estimate SNR over larger, more complex astronomical scenes. Note that  STIPS uses a grid of 9 PSFs for each detector, so if users want to understand field-dependent effects in greater detail, then they may want to consider using STPSF outputs and convolving with their source properties.

I want to estimate exposure times... 


Pandeia offers the ability to estimate the exposure time for a target signal-to-noise ratio and for astronomical scenes of a few arc seconds across containing sources with user-specified properties. The ETC Web Interface also offers easy-to-use functionalities through a browser to facilitate the design of astronomical scenes and observations.

A complex scene could be many things, but largely we consider complex scenes to be larger than a few arcseconds and contain too many sources to input manually.  STIPS will use STPSF  models and  Pandeia background estimates to simulate L2 images for complex astronomical scenes that can be analyzed by the user to measure SNR. Users may first want to use the Roman ETC to get a sense of reasonable exposure times for their simulations.




Software Versions Used in this Documentation

  • This documentation is written for  STPSF version 2.1.0 (released in June 2025).
  • This documentation is written for STIPS version 2.3.0 (released on June 27, 2025).
  • This documentation is written for  Pandeia version 2025.9 (released on September 15, 2025).
  • This documentation is written for Roman I-Sim version 0.11.2 (released on November 19, 2025)..





For additional questions not answered in this article, please contact the Roman Help Desk.




Latest Update

 

Added section about What Simulation Tool Should I Use? to this page. 

Publication

 

Initial publication of the article.