McXtrace logo

McXtrace - An X-ray ray-trace simulation package

ESRF; SAXSLAB Niels Bohr Institute DTU Physics


 Linux Installation (deb/rpm)
 Mac OSX Installation
 Unix Install (src code)
 Windows Installation

Project Status
 Project Partners
 Project People

Mailing list



Minutes of Meetings

McXtrace Art

About McXtrace



McXtrace: PSD_monitor_coh Component

[ Identification | Description | Input parameters | Output parameters | Links ]

The PSD_monitor_coh Component

Position-sensitive monitor with phase intergration.


  • Author: Erik Knudsen
  • Origin: Risoe
  • Date: March 13, 2010
  • Version: $Revision$


An (n times m) pixel PSD monitor taking phase into account.
As the i:th ray hits a pixel (j,k) in the monitor the intensity in that
pixel will be updated as a complex sum, i.e. P_i = P_{i-1} + p_i exp{-\phi_i}.

By setting ratio<1 the effective pixel area becomes a
fraction of the ideal (which is to divide the xwidth and yheight intervals into nx and ny abutting
subintervals). This reduces the monitor effective area by ratio^2.
If the centering flag is set - the monitor will treat all rays as if they hit a pixel
center. This behaves as if ratio -> 0, but at no cost in statistics.

Example: PSD_monitor_coh(xmin=-0.1, xmax=0.1, ymin=-0.1, ymax=0.1,
            nx=90, ny=90, filename="Output.psd")

Input parameters

Parameters in boldface are required; the others are optional.
Name Unit Description Default
nx m Number of pixel columns. 90
ny m Number of pixel rows. 90
filename m Name of file in which to store the detector images (the suffixes .abs and .arg will be added). 0
restore_xray - If set, the monitor does not influence the xray state. 0
xmin m Lower x bound of detector opening. -0.05
xmax m Upper x bound of detector opening. 0.05
ymin m Lower y bound of detector opening. -0.05
ymax m Upper y bound of detector opening. 0.05
xwidth m Width of detector. Overrides xmin,xmax. 0
yheight m Height of detector. Overrides ymin,ymax. 0
ratio ratio between pixel area and effective pixel area. 1
centering Treat all rays as if they hit the center of the pixel. 1
nowritefile 1 If set, monitor will skip writing to disk 0

Output parameters

Name Unit Description Default
PSD_N - Array of xray event counts.  
PSD_p2 - Array of second ms.  
PSD_phi - Array of xray complex weight counts (the argument consituttes the phase).  


[ Identification | Description | Input parameters | Output parameters | Links ]

Generated automatically by McDoc, Peter Willendrup <> / Tue Apr 28 09:59:35 2020

Last Modified: Tuesday, 28-Apr-2020 11:59:35 CEST
Search website mailinglist archive SVN repos McCode Trac