This tutorial breaks the RGS response into its physical factors: effective area, mirror PSF, exposure map, line-spread function (LSF/RMF) and PI order selection. The same factors then answer three questions: how a monochromatic point source at any position lands on the detector; how an extended source is built from point sources; and, in reverse, which sky positions, which lines and what fractions feed one channel of one strip.
Labels: verified from the algorithm documentation of rgsrmfgen-1.17 shipped with SAS 20.0.0, or from accepted project products; derived computed directly from the grating geometry; schematic the LSF/PSF shapes, bad-column position and N132D model in the interactive figures are teaching toys, not calibration data.
RGS is a slitless dispersive spectrometer. The grazing-incidence mirror focuses the light; on the way to focus about half of the converging beam is intercepted by the reflection grating array (RGA), which deflects it by wavelength onto a row of nine CCDs. The rest continues to EPIC-MOS. Each detected photon carries two positions and one energy:
Take the target reference point as the origin and write the sky offset as (ξ, η) in arcmin. In observation o the dispersion direction has position angle φo on the sky, set by the spacecraft roll. The source offsets along and across the dispersion are
A different roll rotates (ΔD, ΔX) for the same sky point while the source spectrum stays the same. Multi-roll fusion rests on exactly this.
In the grating equation
the incidence angle α follows the ray direction. A source displaced by ΔD along the dispersion rotates the whole converging beam by the same angle, so α changes by ΔD. The pipeline converts β to wavelength for the reference position, so the photon is recorded at
For RGS α ≈ 1.58° and the groove density is about 646 lines/mm (d ≈ 15 490 Å), so in first order κ ≈ 15 490 × 0.0275 × 2.91×10−4 ≈ 0.124 Å per arcmin. At O VII 21.6 Å, a 1′ offset equals 0.124 Å, about 3.3 eV, or a line-of-sight velocity of about 1 700 km/s. The sign depends on how the DISP axis is defined; it is taken positive below.
Treat one voxel of the sky cube as a monochromatic point source at (ΔD, ΔX) with energy E. The expected counts in observation o, strip k and dispersion channel b are
To is the exposure in seconds inside the good time intervals (the EXPOSURE of the PHA file) and F(E) the photon flux. The algorithm page of rgsrmfgen writes the response R as a product of two kinds of factor verified:
The cross-dispersion “acceptance” and the order-selection efficiency are
The factors are explained one by one below and then combined in the interactive bench.
Mirror collecting area × fraction intercepted by the gratings × grating efficiency of order m, times the time-dependent effective-area correction (dyneffareacorr, interpolated by observation date from Chebyshev parameters in the calibration files). Over a few arcmin, as for N132D, off-axis vignetting of the mirror is small, so A can be treated as a function of E alone. The CCD quantum efficiency q enters Q separately, per read-out node, because it belongs to the CCD where the photon lands.
The mirror PSF ψ is two-dimensional. After the gratings its two directions play completely different roles:
So there is no stand-alone 2-D PSF file that “sends photons to a place on the CCD” and can be used directly: half of it is already part of the LSF.
Lm describes how photons of energy E are spread over dispersion channels β, peaking at βm(E, ΔD). When the source moves along the dispersion, the whole LSF shifts in β with almost no change of shape. At 21.6 Å a FWHM of 0.062 Å is about 1.7 eV, finer than the roughly 5 eV of XRISM Resolve, provided the source is a point.
The exposure map comes from rgsfilter/rgsproc. It contains the live-time fraction within the good time intervals, bad pixels and columns, the gaps between CCDs and the read-out node structure, on the detector (β, x) grid. When the source moves along the dispersion the line shifts in β but a bad column does not, so the same bad column blocks different wavelengths. This is why the ARF cannot be written as a function of E alone: the ARF produced with witharffile=yes already folds in the exposure map and strip acceptance at the reference position, and is valid for that one source position only.
Bookkeeping: To enters once; ε is a fraction between 0 and 1. The project's earlier probe tests already count it this way.
Different orders overlap at the same β: 21.6 Å in first order and 10.8 Å in second order land at the same place. Their photon energies differ by a factor of two (0.574 keV versus 1.148 keV), which the CCD can separate. The selection region in the (β, PI) plane is curved, the “banana”; Pm is the fraction of the CCD energy redistribution ρ that falls inside it. For a selected first-order spectrum the other orders have P close to, but not exactly, zero.
| Physical factor | When the source moves along the dispersion | When the source moves across the dispersion | Calibration file (CCF) |
|---|---|---|---|
| Mirror area, grating efficiency Am(E) | essentially unchanged | essentially unchanged | XRT2/3_XAREAEF, RGS1_EFFAREACORR |
| LSF Lm (incl. dispersion part of mirror PSF) | shifts in β | unchanged | RGS1_LINESPREADFUNC, XRT2/3_XPSF |
| Cross-dispersion PSF ψX | unchanged | shifts relative to the fixed strips; acceptance changes | RGS1_CROSSPSF |
| Exposure map ε (bad columns, gaps, nodes) | does not move; blocks different wavelengths | does not move | RGS1_BADPIX etc., via rgsfilter |
| CCD quantum efficiency q | does not move (belongs to the CCD) | does not move | RGS1_QUANTUMEF |
| PI order selection Pm | does not move | does not move | RGS1_REDIST |
CCF names are those present in a standard calibration set; only files whose role is unambiguous are listed, and the grating-geometry parameter file is not broken out.
Photon counts are linear in source brightness. An extended source is every voxel treated as the monochromatic point source of section 1, then summed:
Discretized, this is a matrix product \(\mathbf C_{o,k}=\mathbf G_{o,k}\,\mathbf s\): s holds the amplitudes of each spectral component in each voxel, and each column of G is the count spectrum of “this component at this position” folded through the response of section 1. The project's 27-path operator is G sampled at the centres of a 3×3 grid.
rgsrmfgen with withangdist=yes (and the XSPEC convolution model rgsxsrc) provides the standard treatment: a one-dimensional angular distribution p(ΔD) along the dispersion is convolved into the narrow LSF. According to the documentation the distribution has the same shape at all energies and is rescaled to channels by order and central energy verified. This amounts to assuming
It requires one spectrum for the whole source (no velocity field, no line-ratio variation), and evaluates the cross-dispersion acceptance at the reference position. Because angdist is convolved into the LSF while the exposure map is still applied where photons land, bad columns are handled correctly. One caution: do not convolve the mirror PSF a second time. p(ΔD) should be the intrinsic brightness of the source, since the mirror PSF is already in the point-source LSF; switch off withmirrorpsf only if p is taken from an image that already contains the PSF.
The voxel-by-voxel sum (the integral at the start of this section) makes none of these assumptions: every voxel can have its own spectrum, velocity and line ratios, and the cross-dispersion acceptance follows its true position. The price is that G gains a column per voxel and component, and each column needs one point-source response.
Sky brightness (schematic). Arrow: dispersion direction +ΔD; dashed band: the sky region of the selected strip; thin grid: the common 3×3 sky grid (0.75′).
Read the sum of section 2 backwards. For observation o, strip k and channel b, the fraction contributed by sky position (ξ, η) and energy E is
For a line of rest wavelength λℓ, only sky positions that satisfy
can send photons into channel λb. On the sky this is a narrow band perpendicular to the dispersion direction, about 0.5′ wide (0.062 Å / 0.124 Å per arcmin). Each line has its own band; the bands are parallel and offset by (λi−λr)/κ ≈ 1.65′ and (λf−λr)/κ ≈ 4.0′. Across the dispersion the bands are cut by the strip (plus the wings of ψX). A velocity field bends the bands, because v changes with position. The continuum comes from all positions, each contributing its continuum at λb−κΔD.
Three more sources of counts lie outside the sky cube and need separate bookkeeping:
The bench below draws two rolls for the same channel. The bands have different directions in the two rolls; only where they intersect are the position and velocity consistent with both observations. That is the geometric meaning of multi-roll fusion.
The 27-path operator of the reference observation 0210681301 samples Ro,k at the nine centres of a common 3×3 sky grid: the source position given to rgsrmfgen is moved through a private source list while the three extraction strips stay fixed, giving 9 positions × 3 strips verified (accepted probes of the reference observation). It is not a “point sources only” approximation. Building an extended source from point-source responses is exactly the linear sum; the limits are that each cell is represented by its centre (within-cell integration is not yet validated) and that every position needs its own rgsrmfgen run (about one minute and about 29 MB per file on our machine). With several rolls, the same nine sky cells map through each observation's φo to their own (ΔD, ΔX): 3 observations × 3 strips × 9 cells = 81 paths (not yet run).
The factor table of section 1 points to a shortcut: only A·L moves with the source, while ε, q, the ψX acceptance and P stay on the detector. In principle, then, no new response is needed along ΔD: shift the LSF and multiply by the detector factors; only a few positions along ΔX are needed. This rests on three acceptance tests proposed, not yet run:
rgsrmfgen output, and measure the shift invariance and the deviations at bad columns and gaps.withangdist, compared with the emulator's integral in the single-spectrum case.Once these pass, a cube of any resolution and any roll can use the same emulator for mocks and fits. Reproducing the pipeline does not remove calibration uncertainty: the effective area (a few per cent), the LSF wings and, above all, the pointing and wavelength zero point of each observation remain nuisance parameters. The last matters most for velocities: a 1″ pointing error is about 2 mÅ, or about 30 km/s.
At O VII 21.6 Å the first-order RGS LSF for a point source is about 1.7 eV FWHM, already finer than the roughly 5 eV of Resolve. The 1.5–2′ extent of N132D broadens it to about 5–7 eV, the Resolve scale, and within one roll position and velocity are degenerate. The aim of multi-roll fusion is to use the fact that the position term rotates between rolls while the velocity term does not, to decompose the extended-source broadening back into a spatial distribution and a velocity field and approach point-source resolution. Also, to our knowledge the Resolve gate valve has not been opened, so Resolve has almost no effective area below about 1.7 keV and the O VII band still relies on RGS.
| Content | Status | Basis |
|---|---|---|
| Factor structure of the response (narrow/broad LSF, ε×ψX acceptance, q, PI selection, angdist behaviour) | verified | rgsrmfgen-1.17 algorithm documentation shipped with SAS 20.0.0 |
| Central-source areas in the three strips, 2.29 / 42.18 / 3.17 cm² | verified | accepted probes of reference observation 0210681301 |
| κ ≈ 0.124 Å per arcmin, velocity–position and eV conversions | derived | grating equation with nominal α and d |
| LSF/PSF shapes, bad-column position and N132D model in the benches | schematic | teaching toys; not for quantitative conclusions |
| White-box emulator and its three tests | proposed | awaiting acceptance |