A description of known limitations and issues for the  STPSF software with relevant advice for users. This documentation is written for  STPSF version 2.0.

---

Limitations 

Here, we highlight some of the STPSF limitations that may impact its use for some science applications. 

Detector-Level Effects

STPSF and Poppy do not model any detector effects such as geometric distortion, pixel MTF (modulation transfer function), intrapixel sensitivity variations, interpixel capacitance, or any noise sources. Detector noise contributions should be added separately using independent detector models. These effects are taken into account in other tools like STIPS .

Telescope Optical Path

As an approximation to the Roman primary mirror polishing errors, STPSF  uses the default Hubble Space Telescope (HST) optical path difference map. The Roman model will be updated once the relevant data are available.

Dispersed PSF

STPSF does not compute dispersed spectroscopic PSFs (e.g. for the Prism and Grism modes). The users are encouraged to compute monochromatic PSFs using  STPSF and then combine them with an appropriate dispersion model.

Aliasing

Simulated images of large fields of view (700-800 pixels) may contain aliasing artifacts. This could be mitigated by using a pupil image with a larger number pixels, although such a functionality is not yet supported.

PSF Sampling 

STPSF does not output evenly-supersampled PSF models on a odd supersampled pixel grid, i.e., evenly-supersampled PSF models will not be centered at the center of a pixel, but their center will be placed at the corner point between 4 supersampled pixels. A current work around is to not supersample the PSF model itself but to change the pixel scale of the WFI. For more information, we refer the reader to the online documentation and the STPSF Tutorials (Example 4).

Roman Coronagraph Instrument 

Regarding the STPSF  Roman coronagraph model, the current functionality is limited to the Shaped Pupil Coronagraph (SPC) observing modes, and these modes are only simulated with static, unaberrated wavefronts, without relay optics and without DM control.

---

Reporting and Fixing Issues 

Users interested in contributing to the ongoing development of STPSF  may clone or fork from the main Github repository.  Pull requests with code enhancements from the community are encouraged..

---

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

---