SOXS is a software suite which creates simulated X-ray observations of astrophysical sources with the mission concept X-ray Surveyor. The goal of SOXS is to provide a comprehensive set of tools to design source models and convolve them with simulated models of X-ray instruments, particularly of the Lynx mission concept.
There are two main entry points to SOXS: a command-line interface, and a Python interface. The former is simpler to use, but the latter has more power and flexibility. Both of these entry points are extensively documented with examples.
SOXS and its dependencies are installed as a standard Python package, and it is compatible
with Python 2.7 and 3.5. You may use pip
to install it (if you do not have pip, check
that your executable is not named pip3
, otherwise visit https://pip.pypa.io/ to download
it):
[~]$ pip install soxs
If the Python distribution is not "owned" by you on your machine you might have to call
sudo pip install soxs
. If you need to upgrade from a previous version of SOXS, issue
[sudo] pip install -U soxs
from the command line.
If you use Anaconda Python, you may
install SOXS using conda
:
[~]$ conda install -c jzuhone soxs
These methods install both the Python interface and the command-line scripts.
Alternatively, to install into your Python distribution from source:
[~]$ python setup.py install
There are a number of ways to get help with SOXS.
Documentation for SOXS lives at http://hea-www.cfa.harvard.edu/~jzuhone/soxs.
There's a SOXS 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.