DABAM (Data Base for Metrology) is an open-source database
containing metrology data for X-ray mirrors. It makes available metrology data
(mirror heights and slopes profiles) that can be used with simulations tools for calculating the effects of optical
surface errors in the performances of an optical instrument, such as a synchrotron beamline.
A typical case is the degradation of the intensity profile at the focal position in a beamline due to the mirror
This database for metrology (DABAM) aims to provide to the users of simulation tools the data of real mirrors.
An accompanying software dabam.py
is provided to allow simple access and processing of these data, calculate the most usual
statistical parameters, and also include the option of creating input files for most used simulation codes.
DABAM (end-user) utilization
Download the dabam.py file to your system
Open a terminal and copy/move dabam.py to that directory
enter, for example, python dabam.py 10 and you should get in the terminal something like:
Using: abscissas column index 0 (mirror coordinates)
ordinates column index 1 (profile heights)
File tmpHeader.txt containing metadata written to disk.
File tmpHeights.dat containing heights profile written to disk.
File tmpSlopes.dat written to disk.
File tmpPSD.dat written to disk.
File tmpHistoSlopes.dat written to disk.
---------- profile results -------------------------
Data File: dabam-010.dat
Metadata File: dabam-010.txt
Surface shape: plane
Scan length: 442.680 mm
Number of points: 435
Linear detrending: z'=8.5566e-07 x+3.93171e-08
Radius of curvature: 1168689.032 m
StDev of slopes profile: 0.233 urad
from PSD: 0.233 urad
from USER (metadata): 0.232 urad
Peak-to-valley: no detrend: 1.980 urad
with detrend: 2.062 urad
Skewness: 0.067, Kurtosis: 2.420
PSD power law fit: beta:0.342, Df: 2.329
StDev of heights profile: 6.199 nm
from PSD: 6.204 nm
from USER (metadata): 3.048 nm
Peak-to-valley: no detrend: 33.892 nm
with detrend: 18.704 nm
Skewness: 0.626, Kurtosis: -1.155
PSD power law fit: beta:2.657, Df: 1.172
What happenen? We asked to access the profile number 10 of the database. Python looked for the files
dabam-010.dat (with data) and
dabam-010.txt (with metaddata) and processed them in your computer creating the displayed information and a number of local files.
Some useful commands:
python dabam.py -h displays the help (all options).
python dabam.py -Y displays a summary of all profiles available in the database.
python dabam.py 10 -P "heights psd_h" loads the profile number 10 and makes a plot of the heights profile and heights power spectral density:
How to submit profiles to DABAM
Use this form. Note that this site may be blocked by some firewalls, like at the ESRF.
A paper has been submitted, and it will be available as soon as possible.
For developers that want to use DABAM in their codes, we provide dabam.py as a part of the python SR-xraylib package, available as
package (not alwatys updated) as well as in
github. If installed
in your system, use for example: python -m srxraylib.metrology.dabam 10
The "remote" data repository is http://ftp.esrf.eu/pub/scisoft/dabam/data/ but local access is also possible if data is downloaded. The master data is maintained at
https://github.com/srio/dabam which also contains some python tools to do simple optics simulations with DABAM profiles.
Please send comments, etc. to M. Sanchez del Rio