Skip to content
README.md 4.65 KiB
Newer Older
Valentina Fioretti's avatar
Valentina Fioretti committed
	
<!-- PROJECT LOGO -->
<br />
<p align="CENTER">
Valentina Fioretti's avatar
Valentina Fioretti committed
  <a href="https://www.ict.inaf.it/gitlab/proton_response_matrix/xmm-newton-proton-response-files">
Valentina Fioretti's avatar
Valentina Fioretti committed
    <img src="./logos/AHEAD2020_logo.png" alt="AHEAD2020_logo" height="130">
     <img src="./logos/HORIZON2020_logo.png" alt="HORIZON_logo" height="130">
     <img src="./logos/INAF_logo.png" alt="INAF_logo" height="130">
Valentina Fioretti's avatar
Valentina Fioretti committed
  </a>
  <h3 align="center">XMM-Newton proton response files</h3>
Valentina Fioretti's avatar
Valentina Fioretti committed

Valentina Fioretti's avatar
Valentina Fioretti committed
</p>
Valentina Fioretti's avatar
Valentina Fioretti committed
<!-- TABLE OF CONTENTS -->
## Table of Contents
Valentina Fioretti's avatar
Valentina Fioretti committed

Valentina Fioretti's avatar
Valentina Fioretti committed
* [About the Project](#about-the-project)
Valentina Fioretti's avatar
Valentina Fioretti committed
  * [Documentation](#documentation)
Valentina Fioretti's avatar
Valentina Fioretti committed
  * [Built with](#built-with)
Valentina Fioretti's avatar
Valentina Fioretti committed
  * [Download](#download)
Valentina Fioretti's avatar
Valentina Fioretti committed
* [Usage](#usage)
Valentina Fioretti's avatar
Valentina Fioretti committed
  * [Validity ranges](#validity-ranges)
Valentina Fioretti's avatar
Valentina Fioretti committed
* [License](#license)
* [Contact](#contact)
* [Acknowledgements](#acknowledgements)
Valentina Fioretti's avatar
Valentina Fioretti committed
<!-- ABOUT THE PROJECT -->
## About The Project
Valentina Fioretti's avatar
Valentina Fioretti committed

Valentina Fioretti's avatar
Valentina Fioretti committed
AHEAD2020 · Horizon 2020 Research and Innovation Programme · GA 871158
Valentina Fioretti's avatar
Valentina Fioretti committed
WP 9.8 "Understanding the interaction between soft protons and X-ray mirrors"
Valentina Fioretti's avatar
Valentina Fioretti committed

Valentina Fioretti's avatar
Valentina Fioretti committed
* Authors: V.Fioretti(1), T. Mineo(2), R. Amato(2), S. Lotti(3), C. Macculi(3), S. Molendi(4), F. Gastaldello(4), G. Lanzuisi(1), M. Cappi(1), M. Dadina(1), S. Ettori(1)
Valentina Fioretti's avatar
Valentina Fioretti committed
(1)INAF OAS Bologna, (2)INAF IASF Palermo, (3)INAF IAPS Roma, (4)INAF IASF Milano 
Valentina Fioretti's avatar
Valentina Fioretti committed

Valentina Fioretti's avatar
Valentina Fioretti committed
* Description: The proton response matrix for the XMM-Newton telescope is composed by a Redistribution Matrix File (RMF)
Valentina Fioretti's avatar
Valentina Fioretti committed
mapping the proton energy space (from 2 to 300 keV) into detector pulse height and an Auxiliary Response File (ARF) 
Valentina Fioretti's avatar
Valentina Fioretti committed
collecting the grasp of the optics, the filter transmission efficiency and the detector quantum efficiency. A PATTERN selection of 0 (only events that generate 1 pixel or Singles counts) is used.
Valentina Fioretti's avatar
Valentina Fioretti committed

Valentina Fioretti's avatar
Valentina Fioretti committed
* The files are formatted according to the NASA OGIP (Office of Guest Investigators Program) calibration database (caldb) format, and they are tested with the NASA HEASARC XSPEC analysis software tool.
Valentina Fioretti's avatar
Valentina Fioretti committed

Valentina Fioretti's avatar
Valentina Fioretti committed
### Documentation

Valentina Fioretti's avatar
Valentina Fioretti committed
The detailed description of the activity, including the verification and validation, can be found in the [WP 9.8 Technical Note](https://www.ict.inaf.it/gitlab/proton_response_matrix/xmm-newton-proton-response-files/-/blob/main/docs/AHEAD2020_WP9.8_SOFTPROTONS_report_FINAL_v1.2.pdf).
Valentina Fioretti's avatar
Valentina Fioretti committed
### Built with
Valentina Fioretti's avatar
Valentina Fioretti committed
The current release of the proton response files is based on:
Valentina Fioretti's avatar
Valentina Fioretti committed
* Geant4 v10.4 [Agostinelli et al. NIMPA, 506, 250, 2003; Allison et al. ITNS, 53, 270, 2006; Allison et al. NIMPA, 835, 186, 2016]
Valentina Fioretti's avatar
Valentina Fioretti committed
* BoGEMMS v2.1 [Fioretti et al., Proc. SPIE, 106993J 2018]
Valentina Fioretti's avatar
Valentina Fioretti committed
* Ray-tracing Monte Carlo code [Mineo et al., Exp. Astr., 44, 287, 2017] 

Valentina Fioretti's avatar
Valentina Fioretti committed
### Download

Official releases of the response files can be downloaded [here](https://www.ict.inaf.it/gitlab/proton_response_matrix/xmm-newton-proton-response-files/-/releases).

Valentina Fioretti's avatar
Valentina Fioretti committed

Valentina Fioretti's avatar
Valentina Fioretti committed
<!-- USAGE -->
## Usage
Valentina Fioretti's avatar
Valentina Fioretti committed

Valentina Fioretti's avatar
Valentina Fioretti committed
* The RMF and ARF files can be loaded with any X-ray analysis software compliant with the NASA caldb format.
* Since the accuracy of the Geant4 modeling of the proton stopping power degrades below 1 keV (20% at 1 keV reported in the Geant4 Physics Reference Manual), the energy redistribution is modelled from 1 keV to the upper threshold of the instrument X-ray RMF.
Valentina Fioretti's avatar
Valentina Fioretti committed
* contrary to the X-ray ARFs, the proton ARF stores the grasp, in cm2 sr. For this reason, the input proton model obtained by deconvolving the observed spectrum with the response files is in units of protons/s/keV/sr.
* The spectra obtained from the response files are normalized for the simulated detection area, stored in the header of the response files. This area can be different from the actual detection area and the observed spectra must be corrected in order to be normalized for the simulated and not the in-flight observation area.
Valentina Fioretti's avatar
Valentina Fioretti committed
* The response files are available for three optical filters: 
  * thin: 0.16 um of polyimide and 0.04 um of aluminium
  * medium: 0.16 um of polyimide and 0.08 um of aluminium
  * thick: 0.33 um of polypropylene, and 0.11 um of aluminium, and 0.045 um of tin
Valentina Fioretti's avatar
Valentina Fioretti committed
  
### Validity ranges

Due to biases at the boundary of the RMF modeling, induced by features in the interpolation because of limited statistics in the simulation, the spectral analysis must be performed within the following intervals:
* MOS: 1.5 - 11.5 keV
Valentina Fioretti's avatar
Valentina Fioretti committed
* PN: 1.5 - 19.5 keV
Valentina Fioretti's avatar
Valentina Fioretti committed
<!-- LICENSE -->
## License
Valentina Fioretti's avatar
Valentina Fioretti committed

Valentina Fioretti's avatar
Valentina Fioretti committed
* Copyright (C) 2022 INAF - see [LICENSE.rst](https://www.ict.inaf.it/gitlab/proton_response_matrix/xmm-newton-proton-response-files/-/blob/main/LICENSE/LICENSE.rst)
Valentina Fioretti's avatar
Valentina Fioretti committed

Valentina Fioretti's avatar
Valentina Fioretti committed
<!-- CONTACT -->
## Contact
Valentina Fioretti's avatar
Valentina Fioretti committed

Valentina Fioretti's avatar
Valentina Fioretti committed
Valentina Fioretti (INAF OAS Bologna) - valentina.fioretti<at>inaf.it
Valentina Fioretti's avatar
Valentina Fioretti committed
Project Link: [https://ahead.iaps.inaf.it/](https://ahead.iaps.inaf.it/)
Valentina Fioretti's avatar
Valentina Fioretti committed
<!-- ACKNOWLEDGEMENTS -->
## Acknowledgements
The research leading to these results has received funding from the European Union’s Horizon 2020 Programme under the AHEAD2020 project (grant agreement n. 871158).