pyXSIM is a Python package for simulating X-ray observations from astrophysical sources.
X-rays probe the high-energy universe, from hot galaxy clusters to compact objects such as neutron stars and black holes and many interesting sources in between. pyXSIM makes it possible to generate synthetic X-ray observations of these sources from a wide variety of models, whether from grid-based simulation codes such as FLASH, Enzo, and Athena, to particle-based codes such as Gadget and AREPO, and even from datasets that have been created "by hand", such as from NumPy arrays. pyXSIM also provides facilities for manipulating the synthetic observations it produces in various ways, as well as ways to export the simulated X-ray events to other software packages to simulate the end products of specific X-ray observatories.
pyXSIM is an implementation of the PHOX algorithm, developed for constructing mock X-ray observations from SPH datasets by Veronica Biffi and Klaus Dolag. There are two relevant papers:
Biffi, V., Dolag, K., Bohringer, H., & Lemson, G. 2012, MNRAS, 420, 3545
Biffi, V., Dolag, K., Bohringer, H. 2013, MNRAS, 428, 1395
pyXSIM had a previous life as the photon_simulator analysis module as a part of the
yt Project. pyXSIM still depends critically on yt to provide the
link between the simulation data and the algorithm for generating the X-ray photons. For
detailed information about the design of the algorithm in yt, check out
the SciPy 2014 Proceedings.
pyXSIM can be installed in a few different ways. The simplest way is via the conda package if you have the Anaconda Python Distribution:
[~]$ conda install -c conda-forge pyxsim
The second way to install pyXSIM is via pip. pip will attempt to download the dependencies and install them, if they are not already installed in your Python distribution:
[~]$ pip install pyxsim
Alternatively, to install into your Python distribution from source:
[~]$ python setup.py install
There are a number of ways to get help with pyXSIM.
Documentation for pyXSIM lives at http://hea-www.cfa.harvard.edu/~jzuhone/pyxsim.
There's a pyXSIM Google Group to get help and discuss related matters.
If you have a specific code issue that seems like a bug or have a feature or enhancement request, the best place to note it is on the GitHub issues page so that we can keep track of it.
The yt Project has a Slack team which has a pyXSIM channel. Sign up for the yt Slack team to get onto the channel and ask questions.