What is pyXSIM?

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.

The Heritage of pyXSIM

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.

Installing pyXSIM

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

Getting Help

There are a number of ways to get help with pyXSIM.

Documentation

Documentation for pyXSIM lives at http://hea-www.cfa.harvard.edu/~jzuhone/pyxsim.

Mailing List

There's a Google Group to get help with pyXSIM and discuss related matters.

GitHub Issues Page

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.

Slack Channel at the yt Project

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.