Further marx parameters

marx accepts a large number of parameters. Only a small fraction of those is needed by the average marx user and those parameters are explained in detail in this manual. For each parameter, Index links to the section that explains its use.

However, many parameters are only required for calibration purposes. These parameters are listed here with a short (or longer) explanation. Their defaults point to a file with calibration information that is shipped with marx or they set a parameter of the the Chandra geometry. Those parameters typically should not be changed from their default value. Other parameters are only of historical interest (e.g. dNumRays optimizes marx for computers with less then 50 MB of memory).

Parameters can be set on the command line. All parameters not set in this way will be read from a parameter file. These files are plain text files and it should be easy to edit them in any text editor. If required, there is a detailed description of the format. See the description of marx for different ways to select a parameter file.

Parameter file

mode

(default: hl) mode for parameter file.

DataDirectory

(default: $MARX_DATA_DIR) directory for input data

Simulation control

dNumRays

(default: 100000) This parameter determines the number of rays per iteration which will be used. This parameter is only of historical interest. It was used for computers with less than about 50 MB of memory.

DumpToRayFile

(default: no) Output in MARX rayfile format?

SourceDistance

(default: 0) Source distance in meters (0 means infinite). marx can also simulate photons from a source at a finite distance. This functionality is useful for XRCF simulations where the X-ray source was not at infinity. Non-astronomical sources can be specified using the SourceDistance parameter which sets the distance between the source and the front aperture of the HRMA in meters.

DetOffsetY

(default: 0) Offset in mm from the nominal on-axis, in-focus SIM position.

For simulating flight behavior, the user should note that DetOffsetY=0 always as Y axis translation of the flight SIM is not permitted.

SAOSAC_Color_Rays

(default: no) This option is no longer supported

Output Vectors

Although users are encouraged to use the default settings for the marx output, the available options are listed below for completeness:

OutputVectors

(default: ETXYZ123DxyMPOabcdSrB) This parameter specifies a list of output files that marx writes. Each marx output file contains information on a given photon property (arrival time, energy, etc.) and each is \(N\) elements long where \(N\) is the number of detected photons.

This parameter is set to a string where each desired output file is represented as a string.

Filename Code Description
b_energy.dat B Detected energy of event [keV]
detector.dat D Chip ID (CCD for ACIS or MCP for HRC)
energy.dat E The true photon energy [keV]
marx.par Updated parameter file
mirror.dat M Reflection shell of the HRMA
obs.par Information summary for FITS header
pha.dat P The pulse height of the detected photon [PHA]
time.dat T Photon arrival time [sec]
xcos.dat 1 The X–axis direction cosine of the photon
xpixel.dat x The X–axis detection pixel
xpos.dat X The X–axis position of the photon [mm]
ycos.dat 2 The Y–axis direction cosine of the photon
ypixel.dat y The Y–axis detection pixel
ypos.dat Y The Y–axis position of the photon [mm]
zcos.dat 3 The Z–axis direction cosine of the photon
zpos.dat Z The Z–axis position of the photon [mm]
Additional HRC specific files
region.dat r Detection region on the HRC detector
hrc_u.dat The raw HRC U coordinate of the detected event
hrc_v.dat The raw HRC V coordinate of the detected event
Additional HETG specific files
order.dat O The diffraction order of the photon
Additional LETG specific files
ocoarse1.dat d The order of a photon diffracted by the coarse wire support structure of the LETG
ocoarse2.dat c The order of a photon diffracted by the coarse wire support structure of the LETG
ocoarse3.dat b The order of a photon diffracted by the coarse wire support structure of the LETG
ofine.dat a The order of a photon diffracted by the fine wire support structure of the LETG
order.dat O The primary diffraction order of the photon
Additional Aspect specific files
sky_ra.dat S The Sky X pixel value
sky_dec.dat S The Sky Y pixel value
sky_roll.dat S The sky roll angle

The following table describes the format of the binary output files (Length and Offset are given in bytes):

Offset Length Interpretation
0 4 Magic number: 0x83 0x13 0x89 0x8D
4 1 Data type: - “A” : 8 bit signed integer (character) - “I” : 16 bit signed integer - “J” : 32 bit signed integer - “E” : 32 bit float - “D” : 64 bit float
5 15 Data column name. If the length of the name is less than 15 characters, it will be padded with 0. If the name is 15 characters, there will be no padding.
20 4 Number of Rows
24 4 Number of Columns, if 0 it is a vector
28 4 Reserved
32 N Data

For example, the command:

unix% marx OutputVectors="ETXYZP"

would run a marx simulation but only print out vectors containing the energy, time, focal plane position, and detector pulse height for the detected photons.

These native binary vectors provide convenient access to the individual properties of detected photons. For example, to create an ASCII file containing only the times and pulse heights for a set of detected photons, we can use:

unix% marx --dump point/time.dat point/pha.dat > list.txt
unix% more list.txt
#            TIME             PHA
    3.199424e+00             241
    3.702556e+00             302
    3.722314e+00             256
    4.840378e+00             257
    5.336663e+00             284
    6.659723e+00             345
    7.989861e+00             255
    1.041432e+01             260
    1.131393e+01             279
    1.195770e+01             270
    1.259386e+01             332
    1.346374e+01             237
    1.532549e+01             322

In this example, the marx simulation directory was assumed to be named point. Alternatively, for IDL users, read_marx_file can be used to read these binary output vectors into internal IDL variables. These direct means of accessing the properties of detected photons can be much more efficient than reading individual columns from the equivalent FITS events file, especially for large simulations.

XRCF Shutter Control

Shutters1

(default: 0000) mirror 1 shutter bitmap (0 == open, 1 == closed)

Shutters3

(default: 0000) mirror 3 shutter bitmap (0 == open, 1 == closed)

Shutters4

(default: 0000) mirror 4 shutter bitmap (0 == open, 1 == closed)

Shutters6

(default: 0000) mirror 6 shutter bitmap (0 == open, 1 == closed)

HRMA Setup

FocalLength

(default: 10070) Mirror Focal Length

HRMA_Use_WFold

(default: yes) Use WFold scattering tables?

HRMA_Use_Blur

(default: yes) Use HRMA Blur factors

HRMA_Use_Scale_Factors

(default: yes) Use Effarea scale factors?

HRMA_Use_Struts

(default: yes) Use HRMA struts?

HRMA_Ideal

(default: no) Assume perfect reflection from HRMA

WFold_P1_File

(default: hrma/scat_p1_M.bin) wfold filename for HRMA

WFold_H1_File

(default: hrma/scat_h1_M.bin) wfold filename for HRMA

WFold_P3_File

(default: hrma/scat_p3_M.bin) wfold filename for HRMA

WFold_H3_File

(default: hrma/scat_h3_M.bin) wfold filename for HRMA

WFold_P4_File

(default: hrma/scat_p4_M.bin) wfold filename for HRMA

WFold_H4_File

(default: hrma/scat_h4_M.bin) wfold filename for HRMA

WFold_P6_File

(default: hrma/scat_p6_M.bin) wfold filename for HRMA

WFold_H6_File

(default: hrma/scat_h6_M.bin) wfold filename for HRMA

HRMAOptConst

(default: hrma/iridium.dat) optical const filename for HRMA

HRMAOptConstScale

(default: 1.0) Scale factor for HRMA opt constants

HRMAVig

(default: 1.0) HRMA Vignetting factor

HRMA_Yaw

(default: 0.0) HRMA Yaw (arcmin)

HRMA_Pitch

(default: 0.0) HRMA Pitch (arcmin)

HRMA_Geometry_File

(default: hrma/EKCHDOS06.rdb) HRMA rdb geometry file

P1Blur

(default: 0.303427) HRMA P1 Blur angle (arcsec)

H1Blur

(default: 0.0051428) HRMA H1 Blur angle (arcsec)

P3Blur

(default: 0.0951899) HRMA P3 Blur angle (arcsec)

H3Blur

(default: 0.0713614) HRMA H3 Blur angle (arcsec)

P4Blur

(default: 0.178899) HRMA P4 Blur angle (arcsec)

H4Blur

(default: 0.0101367) HRMA H4 Blur angle (arcsec)

P6Blur

(default: 0.151085) HRMA P6 Blur angle (arcsec)

H6Blur

(default: 0.0239287) HRMA H6 Blur angle (arcsec)

H1ScatFactor

(default: 3.2451338) Scattering Fudge Factor for H1

P1ScatFactor

(default: 2.8420331) Scattering Fudge Factor for P1

H3ScatFactor

(default: 2.4618956) Scattering Fudge Factor for H3

P3ScatFactor

(default: 1.7305226) Scattering Fudge Factor for P3

H4ScatFactor

(default: 2.9027099) Scattering Fudge Factor for H4

P4ScatFactor

(default: 1.0077613) Scattering Fudge Factor for P4

H6ScatFactor

(default: 2.0209803) Scattering Fudge Factor for H6

P6ScatFactor

(default: 2.1199425) Scattering Fudge Factor for P6

HRMA_Cap_X

(default: 10079.771554) HRMA Cap X position (mm)

HRMA_P1H1_XOffset

(default: -3.277664) HRMA P1H1 X offset (mm)

HRMA_P3H3_XOffset

(default: -0.257891) HRMA P3H3 X offset (mm)

HRMA_P4H4_XOffset

(default: 0.733315) HRMA P4H4 X offset (mm)

HRMA_P6H6_XOffset

(default: -0.541755) HRMA P6H6 X offset (mm)

PointingOffsetY

(default: 0) Optical-Axis/Pointing Y Misalignment (arcsec)

PointingOffsetZ

(default: 0) Optical-Axis/Pointing Z Misalignment (arcsec)

EA mirror setup

MirrorRadius1

(default: 600) Mirror 1 radius (mm)

MirrorRadius3

(default: 480) Mirror 3 radius (mm)

MirrorRadius4

(default: 425) Mirror 4 radius (mm)

MirrorRadius6

(default: 310) Mirror 6 radius (mm)

MirrorVig

(default: 0.9) HRMA Vignetting factor

MirrorUseEA

(default: yes) Use effective area for HRMA?

MirrorEAFile

(default: ea-mirror/Ae_s1346.dat) mirror effective filename

MirrorBlur

(default: yes) Perform mirror blur?

MirrorBlurFile

(default: ea-mirror/mirr-ee.bin) mirror blur filename

Grating Setup and Control

Further parameters for the grating setup and control are discussed in detail in Grating Efficiency and in Facet Period Variations and Misalignments.

HEGRowlandDiameter

(default: 8632.48) HEG Rowland Torus Diameter (mm)

MEGRowlandDiameter

(default: 8632.48) MEG Rowland Torus Diameter (mm)

LEGRowlandDiameter

(default: 8637.0) LEG Rowland Torus Diameter (mm)

GratingOptConsts

(default: grating/optical-constants.dat) optical constants filename

Use_This_Order

(default: 0) If non-zero, diffract into this plus/minus order

HETG Efficiency Table Model Parameters

HETG_Sector1_File

(default: grating/hetgmp1D1996-11-01marxsectorN0002.tbl) HETG sector file for shell 1

HETG_Sector3_File

(default: grating/hetgmp3D1996-11-01marxsectorN0002.tbl) HETG sector file for shell 3

HETG_Sector4_File

(default: grating/hetgmp4D1996-11-01marxsectorN0003.tbl) HETG sector file for shell 4

HETG_Sector6_File

(default: grating/hetgmp6D1996-11-01marxsectorN0003.tbl) HETG sector file for shell 6

HETG_Shell1_File

(default: grating/hetgmp1D1996-11-01greffN0004.dat) grating efficiency table for shell 1

HETG_Shell3_File

(default: grating/hetgmp3D1996-11-01greffN0004.dat) grating efficiency table for shell 3

HETG_Shell4_File

(default: grating/hetgmp4D1996-11-01greffN0004.dat) grating efficiency table for shell 4

HETG_Shell6_File

(default: grating/hetgmp6D1996-11-01greffN0004.dat) grating efficiency table for shell 6

HETG_Shell1_Vig

(default: 1.0) grating vignetting for shell 1

HETG_Shell3_Vig

(default: 1.0) grating vignetting for shell 3

HETG_Shell4_Vig

(default: 1.0) grating vignetting for shell 4

HETG_Shell6_Vig

(default: 1.0) grating vignetting for shell 6

HETG_Shell1_Theta

(default: 4.755) dispersion angle for shell 1 (degrees)

HETG_Shell3_Theta

(default: 4.755) dispersion angle for shell 3 (degrees)

HETG_Shell4_Theta

(default: -5.205) dispersion angle for shell 4 (degrees)

HETG_Shell6_Theta

(default: -5.205) dispersion angle for shell 6 (degrees)

HETG_Shell1_dTheta

(default: 1.5) shell 1 grating alignment error (sigma in arcmin)

HETG_Shell3_dTheta

(default: 1.5) shell 3 grating alignment error (sigma in arcmin)

HETG_Shell4_dTheta

(default: 1.5) shell 4 grating alignment error (sigma in arcmin)

HETG_Shell6_dTheta

(default: 1.5) shell 6 grating alignment error (sigma in arcmin)

HETG_Shell1_Period

(default: 0.400195) shell 1 grating period (um)

HETG_Shell3_Period

(default: 0.400195) shell 3 grating period (um)

HETG_Shell4_Period

(default: 0.200081) shell 4 grating period (um)

HETG_Shell6_Period

(default: 0.200081) shell 6 grating period (um)

HETG_Shell1_dPoverP

(default: 162e-6) shell 1 grating dP/P (rms)

HETG_Shell3_dPoverP

(default: 162e-6) shell 3 grating dP/P (rms)

HETG_Shell4_dPoverP

(default: 146e-6) shell 4 grating dP/P (rms)

HETG_Shell6_dPoverP

(default: 146e-6) shell 6 grating dP/P (rms)

LETG Efficiency Table Model Parameters

LETG_Eff_Scale_Factor

(default: 1.23456790) LETG Eff scaling factor

LETG_Sector1_File

(default: grating/LETG-1-facet.tbl) LETG sector file for shell 1

LETG_Sector3_File

(default: grating/LETG-3-facet.tbl) LETG sector file for shell 3

LETG_Sector4_File

(default: grating/LETG-4-facet.tbl) LETG sector file for shell 4

LETG_Sector6_File

(default: grating/LETG-6-facet.tbl) LETG sector file for shell 6

LETG_Shell1_File

(default: grating/letgD1996-11-01greffMARXpr001N0004.dat) grating efficiency table for shell 1

LETG_Shell3_File

(default: grating/letgD1996-11-01greffMARXpr001N0004.dat) grating efficiency table for shell 3

LETG_Shell4_File

(default: grating/letgD1996-11-01greffMARXpr001N0004.dat) grating efficiency table for shell 4

LETG_Shell6_File

(default: grating/letgD1996-11-01greffMARXpr001N0004.dat) grating efficiency table for shell 6

LETG_Shell1_Vig

(default: 1.0) grating vignetting for shell 1

LETG_Shell3_Vig

(default: 1.0) grating vignetting for shell 3

LETG_Shell4_Vig

(default: 1.0) grating vignetting for shell 4

LETG_Shell6_Vig

(default: 1.0) grating vignetting for shell 6

LETG_Shell1_Theta

(default: 0.07) dispersion angle for shell 1 (degrees)

LETG_Shell3_Theta

(default: 0.07) dispersion angle for shell 3 (degrees)

LETG_Shell4_Theta

(default: 0.07) dispersion angle for shell 4 (degrees)

LETG_Shell6_Theta

(default: 0.07) dispersion angle for shell 6 (degrees)

LETG_Shell1_dTheta

(default: 0.617) shell 1 grating alignment error (sigma in arcmin)

LETG_Shell3_dTheta

(default: 0.617) shell 3 grating alignment error (sigma in arcmin)

LETG_Shell4_dTheta

(default: 0.617) shell 4 grating alignment error (sigma in arcmin)

LETG_Shell6_dTheta

(default: 0.617) shell 6 grating alignment error (sigma arc min)

LETG_Shell1_Period

(default: 0.991216) shell 1 grating period (um)

LETG_Shell3_Period

(default: 0.991216) shell 3 grating period (um)

LETG_Shell4_Period

(default: 0.991216) shell 4 grating period (um)

LETG_Shell6_Period

(default: 0.991216) shell 6 grating period (um)

LETG_Shell1_dPoverP

(default: 78e-6) shell 1 grating dP/P (rms)

LETG_Shell3_dPoverP

(default: 78e-6) shell 3 grating dP/P (rms)

LETG_Shell4_dPoverP

(default: 78e-6) shell 4 grating dP/P (rms)

LETG_Shell6_dPoverP

(default: 78e-6) shell 6 grating dP/P (rms)

HEG Rectangular Grating Bar Model Parameters

HEGVig

(default: 0.93) HEG Grating Vignetting Factor

hegGold

(default: 0.0444) HEG gold thickness (um)

hegChromium

(default: 0.0111) HEG chromium thickness (um)

hegNickel

(default: 0) HEG nickel thickness (um)

hegPolyimide

(default: 0.978) HEG polyimide thickness (um)

hegPeriod

(default: 0.200081) HEG period (um)

hegdPoverP

(default: 146e-6) HEG dP/P

hegBarHeight

(default: 0.4896) HEG bar height (um)

hegBarWidth

(default: 0.1177) HEG bar width (um)

hegNumOrders

(default: 23) HEG num orders (2n+1)

hegTheta

(default: -5.205) HEG dispersion angle (degrees)

hegdTheta

(default: 1.5) HEG alignment error (sigma in arcmin)

MEG Rectangular Grating Bar Model Parameters

MEGVig

(default: 0.93) MEG Grating Vignetting Factor

megGold

(default: 0.0228) MEG gold thickness (um)

megChromium

(default: 0.0057) MEG chromium thickness (um)

megNickel

(default: 0.0) MEG nickel thickness (um)

megPolyimide

(default: 0.543) MEG polyimide thickness (um)

megPeriod

(default: 0.400141) MEG period (um)

megdPoverP

(default: 162e-6) MEG dP/P

megBarHeight

(default: 0.3780) MEG bar height (um)

megBarWidth

(default: 0.2161) MEG bar width (um)

megNumOrders

(default: 23) MEG num orders (2n+1)

megTheta

(default: 4.755) MEG dispersion angle (degrees)

megdTheta

(default: 1.5) MEG alignment error (sigma in arcmin)

LEG Rectangular Grating Bar Model Parameters

DetExtendFlag

(default: no) Should off-detector coordinates be computed?

LEGVig

(default: 0.8346) LEG Grating Vignetting Factor

legGold

(default: 0.0) LEG gold thickness (um)

legChromium

(default: 0) LEG chromium thickness (um)

legNickel

(default: 0) LEG nickel thickness (um)

legPolyimide

(default: 0.0) LEG polyimide thickness (um)

legPeriod

(default: 0.991216) LEG period (um)

legdPoverP

(default: 8.67592e-5) LEG dP/P

legBarHeight

(default: 0.4615) LEG bar height (um)

legBarWidth

(default: 0.5566) LEG bar width (um)

legTheta

(default: 0.07) LEG dispersion angle (degrees)

legdTheta

(default: 1.4) LEG alignment error (sigma in arcmin)

legNumOrders

(default: 41) LEG num orders (2n+1)

legFineNumOrders

(default: 19) LETG Fine Grating num orders (2n+1)

legFinePeriod

(default: 25.4) LEG fine period (um)

legFineBarWidth

(default: 2.5) LEG fine bar width (um)

legFineBarHeight

(default: 2.5) LEG fine bar height (um)

legCoarseNumOrders

(default: 121) LETG Coarse Grating num orders (2n+1)

legCoarsePeriod

(default: 2000) LEG Coarse period (um)

legCoarseBarHeight

(default: 26.0) LEG Coarse bar height (um)

legCoarseBarWidth

(default: 68.0) LEG Coarse bar width (um)

ACIS Model Parameters

ACIS_Exposure_Time

(default: 3.2) ACIS exposure time (sec)

ACIS_Frame_Transfer_Time

(default: 0.041) ACIS frame transfer time (sec)

ACIS_Gain_Map_File

(default: acis/acisD1999-12-10gain_marxN0001_110.fits) This parameter is currently not used; its value will be ignored.

ACIS_eV_Per_PI

(default: 14.6) eV per PI bin

ACIS-S Model Parameters

ACIS-S0-QEFile

(default: acis/s0_w168c4r_eff_898_release.dat) ACIS Chip 4 QE filename

ACIS-S0-FilterFile

(default: acis/acis_s_xray_trans_1198.dat) ACIS Chip 4 OBF filename

ACIS-S1-QEFile

(default: acis/s1_w140c4r_eff_898_release.dat) ACIS Chip 5 QE filename

ACIS-S1-FilterFile

(default: acis/acis_s_xray_trans_1198.dat) ACIS Chip 5 OBF filename

ACIS-S2-QEFile

(default: acis/s2_w182c4r_eff_898_release.dat) ACIS Chip 6 QE filename

ACIS-S2-FilterFile

(default: acis/acis_s_xray_trans_1198.dat) ACIS Chip 6 OBF filename

ACIS-S3-QEFile

(default: acis/s3_w134c4r_eff_898_release.dat) ACIS Chip 7 QE filename

ACIS-S3-FilterFile

(default: acis/acis_s_xray_trans_1198.dat) ACIS Chip 7 OBF filename

ACIS-S4-QEFile

(default: acis/s4_w457c4_eff_898_release.dat) ACIS Chip 8 QE filename

ACIS-S4-FilterFile

(default: acis/acis_s_xray_trans_1198.dat) ACIS Chip 8 OBF filename

ACIS-S5-QEFile

(default: acis/s5_w201c3r_eff_898_release.dat) ACIS Chip 9 QE filename

ACIS-S5-FilterFile

(default: acis/acis_s_xray_trans_1198.dat) ACIS Chip 9 OBF filename

ACIS-I Model Parameters

ACIS-I0-QEFile

(default: acis/i0_w203c4r_eff_898_release.dat) ACIS Chip 0 QE filename

ACIS-I0-FilterFile

(default: acis/acis_i_xray_trans_1198.dat) ACIS Chip 0 OBF filename

ACIS-I1-QEFile

(default: acis/i1_w193c2_eff_898_release.dat) ACIS Chip 1 QE filename

ACIS-I1-FilterFile

(default: acis/acis_i_xray_trans_1198.dat) ACIS Chip 1 OBF filename

ACIS-I2-QEFile

(default: acis/i2_w158c4r_eff_898_release.dat) ACIS Chip 2 QE filename

ACIS-I2-FilterFile

(default: acis/acis_i_xray_trans_1198.dat) ACIS Chip 2 OBF filename

ACIS-I3-QEFile

(default: acis/i3_w215c2r_eff_898_release.dat) ACIS Chip 3 QE filename

ACIS-I3-FilterFile

(default: acis/acis_i_xray_trans_1198.dat) ACIS Chip 3 OBF filename

HRC-I Model Parameters

The blur parameters were extracted from http://cxc.harvard.edu/twiki/bin/view/HrcCal/DetectorPSF . The (Xctr,Yctr) are offset at runtime such that (G1Xctr,G1Yctr)=(0,0).

HRC-I-BlurG1FWHM

(default: 13.8994) HRC-I Gauss1 FWHM (1/4 pixels)

HRC-I-BlurG1Xctr

(default: 64.1124) HRC-I Gauss1 Xctr (1/4 pixels)

HRC-I-BlurG1Yctr

(default: 64.5285) HRC-I Gauss1 Yctr (1/4 pixels)

HRC-I-BlurG1Amp

(default: 15.7528) HRC-I Gauss1 Amp

HRC-I-BlurG2FWHM

(default: 4.25636) HRC-I Gauss2 FWHM (1/4 pixels)

HRC-I-BlurG2Xctr

(default: 61.35) HRC-I Gauss2 Xctr (1/4 pixels)

HRC-I-BlurG2Yctr

(default: 64.178) HRC-I Gauss2 Yctr (1/4 pixels)

HRC-I-BlurG2Amp

(default: 5.19162) HRC-I Gauss2 Amp

HRC-I-BlurL1FWHM

(default: 10.8269) HRC-I Lorentz1 FWHM (1/4 pixels)

HRC-I-BlurL1Xctr

(default: 73.3361) HRC-I Lorentz1 Xctr (1/4 pixels)

HRC-I-BlurL1Yctr

(default: 63.9927) HRC-I Lorentz1 Yctr (1/4 pixels)

HRC-I-BlurL1Amp

(default: 0.978579) HRC-I Lorentz1 Amp

HRC-I-BlurL1Rmax

(default: 256) HRC-I Lorentz1 Rmax (1/4 pixels)

HRC-I-QEFile

(default: hrc/mcp_qe_i.v2.2.dat) HRC-I QE File

HRC-I-UVISFile

(default: hrc/uvis_i.v4.dat) HRC-I UV/IS file for region 0

HRC-S Model Parameters

The blur parameters were extracted from http://cxc.harvard.edu/twiki/bin/view/HrcCal/DetectorPSF . The (Xctr,Yctr) are offset at runtime such that (G1Xctr,G1Yctr)=(0,0).

HRC-S-BlurG1FWHM

(default: 13.900) HRC-S Gauss1 FWHM (1/4 pixels)

HRC-S-BlurG1Xctr

(default: 64.110) HRC-S Gauss1 Xctr (1/4 pixels)

HRC-S-BlurG1Yctr

(default: 64.530) HRC-S Gauss1 Yctr (1/4 pixels)

HRC-S-BlurG1Amp

(default: 15.750) HRC-S Gauss1 Amp

HRC-S-BlurG2FWHM

(default: 4.2560) HRC-S Gauss2 FWHM (1/4 pixels)

HRC-S-BlurG2Xctr

(default: 67.420) HRC-S Gauss2 Xctr (1/4 pixels)

HRC-S-BlurG2Yctr

(default: 64.110) HRC-S Gauss2 Yctr (1/4 pixels)

HRC-S-BlurG2Amp

(default: 5.1920) HRC-S Gauss2 Amp

HRC-S-BlurL1FWHM

(default: 10.820) HRC-S Lorentz1 FWHM (1/4 pixels)

HRC-S-BlurL1Xctr

(default: 53.030) HRC-S Lorentz1 Xctr (1/4 pixels)

HRC-S-BlurL1Amp

(default: 0.9790) HRC-S Lorentz1 Amp

HRC-S-BlurL1Yctr

(default: 63.880) HRC-S Lorentz1 Yctr (1/4 pixels)

HRC-S-BlurL1Rmax

(default: 256.000) HRC-S Lorentz1 Rmax (1/4 pixels)

HRC-S-QEFile0

(default: hrc/mcp_qe_s.v3.dat) HRC QE File for MCP 0

HRC-S-QEFile1

(default: hrc/mcp_qe_s.v3.dat) HRC QE File for MCP 1

HRC-S-QEFile2

(default: hrc/mcp_qe_s.v3.dat) HRC QE File for MCP 2

HRC-S-UVISFile0

(default: hrc/uvis_s1.v4.dat) HRC UV/IS file for region 0

HRC-S-UVISFile1

(default: hrc/uvis_s2.v4.dat) HRC UV/IS file for region 1

HRC-S-UVISFile2

(default: hrc/uvis_s56.v4.dat) HRC UV/IS file for region 2

HRC-S-UVISFile3

(default: hrc/uvis_s34.v4.dat) HRC UV/IS file for region 3

HESF Model Parameters

HRC-HESF

(default: yes) Use HESF (AKA Drake Flat) (yes/no)

HESFOffsetX

(default: 26.3) the HESF X offset of lower plate (mm)

HESFOffsetZ

(default: -5.359) the HESF Z offset of lower plate (mm)

HESFGapY1

(default: 28.7) the HESF Gap Offset Y1

HESFGapY2

(default: 36.7) the HESF Gap Offset Y2

HESFN

(default: 2) the number of HESF facets

HESFLength

(default: 294.0) length of HESF plate

HESFCrWidth

(default: 15.7) HESF Chromium strip width

HESFOptConstCr

(default: hrc/chromium.dat) the Chromium Optical constant filename for the HESF

HESFOptConstC

(default: hrc/carbon.dat) the Carbon Optical constant filename for the HESF

HESFHeight1

(default: 22.3) the height of HESF 1 (mm)

HESFTheta1

(default: 4.5) the angle of HESF 1 (degrees)

HESFHeight2

(default: 50.0) the height of HESF 2 (mm)

HESFTheta2

(default: 7) the angle of HESF 2 (degrees)

HESFHeight3

(default: 0) the height of HESF 3 (mm)

HESFTheta3

(default: 0) the angle of HESF 3 (degrees)

HESFHeight4

(default: 0) the height of HESF 4 (mm)

HESFTheta4

(default: 0) the angle of HESF 4 (degrees)

Flat Field Model Parameters

FF_MinY

(default: -25) FlatField Aperture min Y value (mm)

FF_MaxY

(default: 25) FlatField Aperture max Y value (mm)

FF_MinZ

(default: -25) FlatField Aperture min Z value (mm)

FF_MaxZ

(default: 25) FlatField Aperture max Z value (mm)

FF_XPos

(default: 10000) FlatField Aperture X location (mm)

Dither/Aspect Parameters

The most important parameters that control the dither model are described in Simulating Aspect with marx. In the following we list parameters that control the internal marx dither model, if selected by DitherModel. All default values are chosen for ACIS observations. See Table 5.4 in the Observatory Guide for the values that are appropriate for HRC observations. marx also offers the possiblity to dither the roll angle, but this is not done in normal Chandra operations. (Note that marx calls the directions “RA” and “Dec”, while the linked table calls it “pitch” and “yaw”. The difference is historic, the marx implementation correctly applies the values as pitch and yaw angle despite the name.)

DitherAmp_RA

(default: 8) Amplitude for RA dither (arcsec)

DitherAmp_Dec

(default: 8) Amplitude for Dec dither (arcsec)

DitherAmp_Roll

(default: 0) Amplitude for Roll dither (arcsec)

DitherPeriod_RA

(default: 1000) Period for RA dither (sec)

DitherPeriod_Dec

(default: 707) Period for Dec dither (sec)

DitherPeriod_Roll

(default: 1e5) Period for Roll dither (sec)

DitherPhase_RA

(default: 0) Phase for RA dither (radians)

DitherPhase_Dec

(default: 0) Phase for Dec dither (radians)

DitherPhase_Roll

(default: 0) Phase for Roll dither (radians)