Welcome to MARX’s documentation!

Current version of marx is 5.5.3.

Version 5.5.3 is identical to the previous version 5.5.2 except to a small tweak in the installation scripts that help when compiling marx on Apple’s ARM chips. See Downloading and Installing Marx for installation instructions.

Warning

This is the last release of the marx 5.x series. In the next release, we will introduce a better treatment of ACIS grades and sub-pixel positions. Also, we will remove a few tools that convert marx binary results into other formats. Going forward, the only supported tool for this purpose is marx2fits, followed by standard CIAO procedures to make images or extract spectra. We will remove all the IDL tools shipped with marx (e.g. make_image) and marx2dpde and marx2img.

marx is a suite of programs created and maintained by the MIT/CXC/HETG group group and is designed to enable the user to simulate the on-orbit performance of the Chandra X-ray Observatory. marx provides a detailed ray-trace simulation of how Chandra responds to a variety of astrophysical sources and can generate standard FITS event files and images as output. It contains detailed models for Chandra’s High Resolution Mirror Assembly (HRMA), the HETG and LETG gratings, and all the focal plane detectors.

If you publish any work that made use of marx, please cite the paper Raytracing with MARX: x-ray observatory design, calibration, and support (Davis et al. 2012, SPIE 8443, 84431A).

• MARX in brief
  • Highlights for each version of marx
  • Downloading and Installing Marx
  • Current caveats for MARX
  • Running marx simulations
  • Reporting a problem or issue
• Examples of MARX in use
  • Simulating a user-defined CCD spectrum with ACIS
  • Simulating pile-up in an ACIS CCD spectrum
  • Simulating a thermal plasma with the HETGS grating
  • HETG simulation of an extended source
  • Simulating an LETG/ACIS-S observation
  • Simulating two overlapping sources
  • Including background in a marx simulation
  • Replicating a Chandra Observation / Using ChaRT or SAOTrace
• Detailed information on MARX
  • Simulating ACIS Pileup with marx
  • Simulating Aspect with marx
  • Using Response Matrices with marx
  • Using marx with SAOSAC
  • The spectrum and the spatial shape of the X-ray source
  • The marx Models for the Spacecraft
  • Simulating ground calibration data
• marx accuracy and testing
  • Point Spread Function (PSF)
  • Flight grade distribution
  • Reproducing an input spectrum
  • Sources in marx
  • Coordinates on the sky and the chip
  • List of code used to run tests
• marx reference
  • MARX Frequently Asked Questions
  • The marx tool suite
  • Further marx parameters

Indices and tables

• Marx Parameters

• Index

• Search Page

Contributing to MARX

• Contributing code or documentation
• Making a release
  • Preparation
  • Source repro
  • Documentation repro
  • Get the word out