/martxc

MSFC ART-XC scripts

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

martxc astropy

martxc is a collection of data analysis and reduction tools for the X-ray telescope ART-XC.

Installation and updates

In a terminal, under the path in which you want to have the software installed, run the following commands:

git clone https://github.com/CTJChen/martxc
cd martxc
python setup.py install

Make sure to get the latest version by checking changelog.md. You can re-install or type the following under the orignally installed path to get the latest updates:

git pull
python setup.py install

Instructions and list of scripts

Most of the code works with "level 2" event lists generated with SIXTE. Some scripts for "level 2" ART-XC flight data re being tested.

martevt2img.py - converts an event list fits file to an image with designated RA and DEC pixel size and optional RA/DEC range parameters.

martexpmap.py - computes an exposure map based on an attitude file with designated RA and DEC pixel size and optional RA/DEC range parameters. Also works with products of martevt2img.py to make expsure maps with shared fits header keywords.

martmkarf.py - generate aperture and off-axis corrected auxillary response file.

martpoisson.py - a simplified script for adding background noise to a fits image. Requires prior knowledge on the background count rate per pixel (not a part of martxc).

martspecextract_raw.py - This script works only with the ART-XC PV phase data in its detector coordinates (no WCS support). It searches for the pixel with counts at least 100x the background and extract its spectrum and image in a 5 pixel radius circle. Background spectrum and image on a random non-source position is also extracted. Off-axis ARF correction is optional.

The python scripts should be executable, you can add the martxc path to your system PATH environment if necessary.

export PATH=/PATH_TO_MARTXC/:$PATH

After doing so, the following command will display the help doc of martevt2img.py:

martevt2img.py -h

See the example document for further instructions.

For any questions/issues/bugs, please report on this github repository or send an email to ctchen dot git @ gmail.

martxc uses the following python packages:

  • python 2.7+ or 3.2+ (with argparse included in the standard library).
  • numpy, scipy
  • astropy 3.1+

License

The is a free, open-source software under the AGPLv3.0 license. martxc is developed and maintained by Chien-Ting Chen at the NASA MSFC X-ray group.