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.
Simulation Tools Handbook Table of Contents
The Simulation Tools Handbook contains the following articles:
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:
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.
Code Repositories are hosted on GitHub, including example notebooks. These repositories are useful for reviewing source code and exploring basic usage examples.
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 | |||
STIPS | fast simulator of astronomical scenes for full frame Level 2 (L2) data products | |||
Roman I-Sim | image simulator of Level 1 (L1) and Level 2 (L2) data products | |||
Pandeia | exposure time calculator; high precision, small area astronomical scenes |
| ||
Simulation Development Utilities: | ||||
pysiaf | transformation tool between instrument, observatory, and sky coordinates | |||
synphot | synthetic photometry for input astronomical object | |||
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 ...
I want to simulate an astronomical scene...
I want to calculate the signal-to-noise ratio...
I want to estimate exposure times...
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.
