Back to eSASS task descriptions

eSASS task: expmap

erosita/expmap-1.33+


Scope

This document provides a description of parameters and instructions for the correct usage of the EXPMAP task, which is part of eSASS (the eROSITA Science Analysis Software System).

Description

The EXPMAP eSASS task computes exposure maps for all-sky survey or pointed observations of one or several eROSITA telescopes energy bands.

Exposure maps will be created for all telescopes for which a full set of standard eSASS file extensions is provided in the input datasets. The output exposure maps will be binned according to the WCS keywords provided in the input template image. Depending on the command line parammeter setting, both single telescope and/or merged all-telescope exposure maps are created.

The exposure maps will contain the exposure time at each sky location in units of seconds. Energy dependent vignetting and/or area correction factors may be applied if desired. Bad pixels found either in the bad pixel extensions of the supplied event files or calibrated bad pixels only will be screened depending on the flag setting of the supplied event files, if requested.

Input Parameters

Input files

Output files

Example calls

expmap inputdatasets="events.fits" \
       templateimage="image.fits" \
       mergedmaps="expmap.fits" \
       emin=0.5 emax=2.0
This minimalistic call creates a merged, vignetted exposure map for the telescopes included in event file events.fits in the energy band from 0.5 to 2.0 keV.

expmap inputdatasets="events1.fits events2.fits" \
       templateimage="image.fits" \
       mergedmaps="expmap_b1.fits expmap_b2.fits expmap_b3.fits expmap_b4.fits" \
       emin="0.2 0.5 1.0 2.0" \
       emax="0.5 1.0 2.0 10.0" \
       gtitype="FLAREGTI"
Merged, vignetted exposure maps for the telescopes included in event file events.fits are created for each of the energy bands 0.2 to 0.5, 0.5 to 1.0, 1.0 to 2.0 and 2.0 to 10.0 keV are created.
expmap inputdatasets="events1.fits events2.fits" \
       templateimage="image.fits" \
       withsinglemaps="yes" \
       withmergedmaps="no" \
       singlemaps="expmap_b1t2.fits expmap_b2t2.fits expmap_b1t5.fits expmap_b2t5.fits" \
       emin="0.2 0.5" \
       emax="0.5 1.0" \
       gtitype="FLAREGTI"

Known Issues: