\contentsline {chapter}{\numberline {1}Introduction}{3}
\contentsline {section}{\numberline {1.1}{\bf MARX\penalty \@M \ }}{3}
\contentsline {section}{\numberline {1.2}Purpose of {\bf MARX\penalty \@M \ }}{3}
\contentsline {section}{\numberline {1.3}Organization of this Guide}{4}
\contentsline {section}{\numberline {1.4}Obtaining help and additional information}{5}
\contentsline {subsection}{\numberline {1.4.1}marxhelp}{5}
\contentsline {subsection}{\numberline {1.4.2}marxnews}{5}
\contentsline {section}{\numberline {1.5}{\bf MARX\penalty \@M \ }home page on World Wide Web}{5}
\contentsline {section}{\numberline {1.6}{\bf MARX\penalty \@M \ }information via FTP}{5}
\contentsline {section}{\numberline {1.7}Acknowledgements}{6}
\contentsline {chapter}{\numberline {2}Overview of Functionality}{7}
\contentsline {section}{\numberline {2.1}Introduction}{7}
\contentsline {section}{\numberline {2.2}Simulation Control}{7}
\contentsline {section}{\numberline {2.3}Source Models}{7}
\contentsline {subsection}{\numberline {2.3.1}Source Spectral Models}{9}
\contentsline {subsubsection}{\numberline {2.3.1.1}General}{9}
\contentsline {subsubsection}{\numberline {2.3.1.2}Flat}{9}
\contentsline {subsubsection}{\numberline {2.3.1.3}User Supplied}{9}
\contentsline {subsection}{\numberline {2.3.2}Source Spatial Models}{9}
\contentsline {subsubsection}{\numberline {2.3.2.1}POINT Source}{9}
\contentsline {subsubsection}{\numberline {2.3.2.2}LINE Source}{10}
\contentsline {subsubsection}{\numberline {2.3.2.3}GAUSS Source}{10}
\contentsline {subsubsection}{\numberline {2.3.2.4}BETA Source}{10}
\contentsline {subsubsection}{\numberline {2.3.2.5}DISK Source}{10}
\contentsline {subsection}{\numberline {2.3.3}USER Source}{10}
\contentsline {subsubsection}{\numberline {2.3.3.1}user\_open\_source}{11}
\contentsline {subsubsection}{\numberline {2.3.3.2}user\_close\_source}{12}
\contentsline {subsubsection}{\numberline {2.3.3.3}user\_create\_ray}{12}
\contentsline {subsubsection}{\numberline {2.3.3.4}Compiling a User-Defined Source}{13}
\contentsline {subsubsection}{\numberline {2.3.3.5}Examples of User-Defined Sources}{13}
\contentsline {subsection}{\numberline {2.3.4}Source Temporal Models}{14}
\contentsline {section}{\numberline {2.4}HRMA model}{14}
\contentsline {section}{\numberline {2.5}Grating Modules}{15}
\contentsline {subsection}{\numberline {2.5.1}Intersection with the Rowland Torus}{15}
\contentsline {subsection}{\numberline {2.5.2}Diffraction of the Ray}{18}
\contentsline {subsection}{\numberline {2.5.3}Grating Efficiency}{20}
\contentsline {subsection}{\numberline {2.5.4}Grating Blur and Alignment Errors}{20}
\contentsline {section}{\numberline {2.6}Shutters}{20}
\contentsline {subsection}{\numberline {2.6.1}XRCF}{21}
\contentsline {subsection}{\numberline {2.6.2}HRC}{21}
\contentsline {section}{\numberline {2.7}Drake Flat}{21}
\contentsline {section}{\numberline {2.8}Detector Models}{21}
\contentsline {subsection}{\numberline {2.8.1}ACIS-I}{21}
\contentsline {subsection}{\numberline {2.8.2}ACIS-S}{21}
\contentsline {subsection}{\numberline {2.8.3}HRC-I}{21}
\contentsline {subsection}{\numberline {2.8.4}HRC-S}{21}
\contentsline {section}{\numberline {2.9}Pileup Simulations}{21}
\contentsline {section}{\numberline {2.10}Future Development}{21}
\contentsline {chapter}{\numberline {3}{\bf MARX\penalty \@M \ }Calibration}{23}
\contentsline {section}{\numberline {3.1}Overview}{23}
\contentsline {section}{\numberline {3.2}{\bf MARX\penalty \@M \ }Data Files}{23}
\contentsline {subsection}{\numberline {3.2.1}MirrorType=EA-MIRROR data files:}{23}
\contentsline {subsection}{\numberline {3.2.2}MirrorType=HRMA data files:}{23}
\contentsline {subsection}{\numberline {3.2.3}Grating Data Files:}{24}
\contentsline {subsection}{\numberline {3.2.4}ACIS-S Data Files:}{24}
\contentsline {subsection}{\numberline {3.2.5}HRC-S Data Files:}{24}
\contentsline {section}{\numberline {3.3}Comparison to XRCF}{24}
\contentsline {section}{\numberline {3.4}Updates}{24}
\contentsline {chapter}{\numberline {4}Installing {\bf MARX\penalty \@M \ }}{25}
\contentsline {section}{\numberline {4.1}Introduction}{25}
\contentsline {section}{\numberline {4.2}Obtaining {\bf MARX\penalty \@M \ }}{25}
\contentsline {section}{\numberline {4.3}Compiling {\bf MARX\penalty \@M \ }}{27}
\contentsline {subsection}{\numberline {4.3.1}Building the main suite}{27}
\contentsline {subsection}{\numberline {4.3.2}Building {\tt marxrsp}}{27}
\contentsline {subsection}{\numberline {4.3.3}Compiling {\tt USER} Source Models}{28}
\contentsline {section}{\numberline {4.4}Running {\bf MARX\penalty \@M \ }}{28}
\contentsline {section}{\numberline {4.5}Testing your Distribution}{29}
\contentsline {section}{\numberline {4.6}Portability}{30}
\contentsline {section}{\numberline {4.7}Speed}{30}
\contentsline {section}{\numberline {4.8}Known Bugs and Limitations}{30}
\contentsline {chapter}{\numberline {5}The {\bf MARX\penalty \@M \ }Tool Suite}{31}
\contentsline {section}{\numberline {5.1}Introduction}{31}
\contentsline {section}{\numberline {5.2}Alphabetical List of Routines}{31}
\contentsline {subsection}{\numberline {5.2.1}\tt bestfocus}{31}
\contentsline {subsection}{\numberline {5.2.2} \tt dumpwfold}{32}
\contentsline {subsection}{\numberline {5.2.3} \tt fitsdump}{33}
\contentsline {subsection}{\numberline {5.2.4} \tt geff}{33}
\contentsline {subsection}{\numberline {5.2.5} \tt marx}{34}
\contentsline {subsubsection}{\numberline {5.2.5.1}Example 1}{34}
\contentsline {subsubsection}{\numberline {5.2.5.2}Example 2}{35}
\contentsline {subsubsection}{\numberline {5.2.5.3}Example 3}{35}
\contentsline {subsubsection}{\numberline {5.2.5.4}Example 4}{36}
\contentsline {subsubsection}{\numberline {5.2.5.5}Example 5}{36}
\contentsline {subsection}{\numberline {5.2.6} \tt marx2dpde}{36}
\contentsline {subsubsection}{\numberline {5.2.6.1}Example 1}{36}
\contentsline {subsubsection}{\numberline {5.2.6.2}Example 2}{37}
\contentsline {subsection}{\numberline {5.2.7} \tt marx2fits}{37}
\contentsline {subsection}{\numberline {5.2.8} \tt marx2img}{37}
\contentsline {subsubsection}{\numberline {5.2.8.1}Example 1}{39}
\contentsline {subsubsection}{\numberline {5.2.8.2}Example 2}{39}
\contentsline {subsubsection}{\numberline {5.2.8.3}Example 3}{40}
\contentsline {subsection}{\numberline {5.2.9} \tt marxcat}{40}
\contentsline {subsection}{\numberline {5.2.10} \tt marxrsp}{41}
\contentsline {subsection}{\numberline {5.2.11}\tt pileup}{42}
\contentsline {subsection}{\numberline {5.2.12}\tt plist}{42}
\contentsline {subsection}{\numberline {5.2.13}\tt pset}{42}
\contentsline {subsection}{\numberline {5.2.14}\tt pwhich}{43}
\contentsline {subsection}{\numberline {5.2.15}\tt rfl}{43}
\contentsline {subsection}{\numberline {5.2.16}\tt rspdump}{44}
\contentsline {section}{\numberline {5.3}IDL Routines}{44}
\contentsline {subsection}{\numberline {5.3.1}\tt get\_hetg\_spect}{45}
\contentsline {subsection}{\numberline {5.3.2}\tt get\_letg\_spect}{45}
\contentsline {subsection}{\numberline {5.3.3}\tt make\_image}{46}
\contentsline {subsection}{\numberline {5.3.4}\tt read\_marx\_file}{47}
\contentsline {subsection}{\numberline {5.3.5}\tt tg\_extract}{47}
\contentsline {section}{\numberline {5.4}Scripts}{48}
\contentsline {subsection}{\numberline {5.4.1}\tt check\_marx\_effarea}{48}
\contentsline {subsection}{\numberline {5.4.2}\tt check\_marx\_psf}{49}
\contentsline {subsection}{\numberline {5.4.3}\tt xspec2marx}{49}
\contentsline {chapter}{\numberline {6}Running {\bf MARX\penalty \@M \ }Simulations}{51}
\contentsline {section}{\numberline {6.1}Introduction}{51}
\contentsline {section}{\numberline {6.2}System Setup}{51}
\contentsline {section}{\numberline {6.3}The {\bf MARX\penalty \@M \ }Parameter File}{52}
\contentsline {section}{\numberline {6.4}Simulation Control}{53}
\contentsline {subsection}{\numberline {6.4.1}Exposure Time}{53}
\contentsline {subsection}{\numberline {6.4.2}Output Directory}{53}
\contentsline {subsection}{\numberline {6.4.3}Output Vectors}{53}
\contentsline {section}{\numberline {6.5}Instrument Configuration}{54}
\contentsline {subsection}{\numberline {6.5.1}Mirror Choice}{54}
\contentsline {subsection}{\numberline {6.5.2}Grating Choice}{54}
\contentsline {subsection}{\numberline {6.5.3}Detector Choice}{54}
\contentsline {subsection}{\numberline {6.5.4}Focus Position}{55}
\contentsline {section}{\numberline {6.6}Source Definition}{55}
\contentsline {subsection}{\numberline {6.6.1}Source Position}{55}
\contentsline {subsection}{\numberline {6.6.2}Source Spectrum}{55}
\contentsline {subsection}{\numberline {6.6.3}Source Spatial Distribution}{56}
\contentsline {section}{\numberline {6.7}Running the Simulation}{56}
\contentsline {section}{\numberline {6.8}{\bf MARX\penalty \@M \ }Output files}{58}
\contentsline {subsection}{\numberline {6.8.1}Binary Output Vectors}{58}
\contentsline {subsection}{\numberline {6.8.2}FITS Events Files}{59}
\contentsline {subsection}{\numberline {6.8.3}FITS Images}{59}
\contentsline {subsection}{\numberline {6.8.4}{\bf MARX\penalty \@M \ }Rayfiles}{60}
\contentsline {section}{\numberline {6.9}Creating Input Spectra in XSPEC}{60}
\contentsline {section}{\numberline {6.10}Sample Sessions}{61}
\contentsline {subsection}{\numberline {6.10.1}An Off--axis Point Source}{61}
\contentsline {chapter}{\numberline {7}Simulating Pileup}{63}
\contentsline {chapter}{\numberline {8}Working with Simulated Data}{65}
\contentsline {section}{\numberline {8.1}Using FTOOLS}{65}
\contentsline {section}{\numberline {8.2}Using IDL}{65}
\contentsline {chapter}{\numberline {9}Using {\bf MARX\penalty \@M \ }with SAOSAC}{67}
\contentsline {section}{\numberline {9.1}Overview}{67}
\contentsline {section}{\numberline {9.2}Using SAOSAC Rayfiles in {\bf MARX\penalty \@M \ }}{67}
\contentsline {section}{\numberline {9.3}Using {\bf MARX\penalty \@M \ }Rayfiles in SAOSAC}{67}
\addvspace {13pt}
\contentsline {chapter} {\Large \bf Appendixes}{}
\addvspace {5pt}
\contentsline {chapter}{\numberline {A}{\bf MARX\penalty \@M \ }Parameters}{69}
\contentsline {section}{\numberline {A.1}Parameter List by Module}{69}
\contentsline {subsection}{\numberline {A.1.1}Simulation Control}{69}
\contentsline {subsection}{\numberline {A.1.2}Source}{70}
\contentsline {subsection}{\numberline {A.1.3}Mirror}{70}
\contentsline {subsection}{\numberline {A.1.4}HETG}{71}
\contentsline {subsection}{\numberline {A.1.5}LETG}{72}
\contentsline {subsection}{\numberline {A.1.6}ACIS}{72}
\contentsline {subsection}{\numberline {A.1.7}HRC}{72}
\contentsline {subsection}{\numberline {A.1.8}Drake Flat}{73}
\contentsline {section}{\numberline {A.2}Sample Parameter File}{73}
\contentsline {chapter}{\numberline {B}Sample FITS Headers}{77}
\contentsline {section}{\numberline {B.1}Primary Header}{77}
\contentsline {section}{\numberline {B.2}Good Time Interval Extension Header}{79}
\contentsline {section}{\numberline {B.3}Events Binary Table Extension Header}{79}
\contentsline {section}{\numberline {B.4}Parameter File Extension Header}{82}
\contentsline {chapter}{\numberline {C}Acronyms}{83}