Page History
Based on e-mail exchange between Mikhail, Gabriel, Jack, Faisal, Philip.
...
For composite detectors see EPIX10KA2M and EPIX10KAQUAD
Table of Contents |
---|
Pictures from Gabriel's presentation
Chris Kenney:
- sensor regular pixel size 100x100 µm²,
- shown on plot gap pixels 100x225 µm² and four central pixels 225x225 µm².
- See plot for composite detectors in EPIX10KA2M and EPIX10KAQUAD
Configuration objects for epix10ka
...
Each pixel value is represented over 16 bits; the lowest 14 bits (0 to 13) encode the 14-bit ADC value, and bit 14 encodes the gain mode as either High (bit14==1) or Medium/Low (bit14==0) !!! THIS IS WRONG. SHOULD BE bit14==1/0 for L/H,M !!!. The choice between Medium and Low is determined globally for the ASIC by the asic.trbit.
...
Calibration rows
Calibration rows
Each ASIC has (176+2 rows x 192 columns), the last two rows are the calibration rows. These rows are not connected to the sensor and are constructed without a pixel/sensor interface. They will be powered just like any other pixel in the ASIC, therefore, they see similar voltages, noise, etc just like other pixels.
...
wirebonds
#|||||||||#
#¯¯¯¯|¯¯¯¯#
...
Raw data
Code Block | ||||
---|---|---|---|---|
| ||||
Command: find_detector_runs MFX epix10ka # mfxx32516: nruns 3-377, MfxEndstation.0:Epix10ka.0, MfxEndstation.0:Epix10ka.1 # mfxx36916: runs 1-84, MfxEndstation.0:Epix10ka.1 |
...
Code Block | ||||
---|---|---|---|---|
| ||||
Camera1-AHL-H-Gain.txt Camera1-AHL-L-Gain.txt Camera1-AML-L-Gain.txt Camera1-AML-M-Gain.txt Camera1-FH-H-Gain.txt Camera1-FL-L-Gain.txt Camera1-FM-M-Gain.txt |
Archived in /reg/g/psdm/detector/gains/epix10k/2018-06-04-Camera1/
...
Code Block | ||||
---|---|---|---|---|
| ||||
#-------------------------------- # data bit 14 is moved here #1/0 for H,M/ trbitL # V / bit3 trbit 1/0 for # V / bit2H/M # V / bit3 V 1/0 Mfor F/A # V / Tbit2 1/0 for H,M/L # V / M mask # V / T test gain range index # V / / in calib files # V V # x111xx =28 - FH_H 0 # x011xx =12 - FM_M 1 # xx10xx = 8 - FL_L 2 # 1100xx0100xx =4816 - AHL_H 3 # 1000xx0000xx =32 0 - AML_M 4 # 0100xx1100xx =1648 - AHL_L 5 # 0000xx1000xx =32 0 - AML_L 6 #------- 1101xx =49 - AHL_FL 7 # 1001xx =33 - AML_FL 8 #-------------------------------- |
...
Data | config | asicPixelConfigArray | |||||
---|---|---|---|---|---|---|---|
Index | Gain mode | bit14 | trbit | bit3: ga | bit2: g | bit1: Mask | bit0: Test |
0 | FH_H | x | 1 | 1 | 1 |
1 | FM_M | x | 0 | 1 | 1 |
2 | FL_L | x | x | 1 | 0 |
3 | AHL_H |
0 | 1 | 0 | 0 |
4 | AML_M |
0 | 0 | 0 | 0 |
5 | AHL_L |
1 | 1 | 0 | 0 |
6 | AML_L |
1 | 0 | 0 | 0 |
7 |
AHL Forced L | 1 | 1 | 0 | 1 | |||
8 | AML Forced L | 1 | 0 | 0 | 1 | ||
pixel control bit array | 1<<5 =32 |
1<<4 =16 | 1<<3 =8 | 1<<2 =4 | Not used | Not used |
Gain correction formula
corrected = (raw - pedestals)/gain
Anchor MeetingWithGabriel MeetingWithGabriel
Meeting with Gabriel
On 2018-07-06 15:13 meeting with Gabriel.
Summary:
- control bit table is correct
- formula should include pedestals in stead of offset
- pedestals need to be generated and saved as txt file of shape (7, 1, 352, 384) under calib directory, for example:
/reg/d/psdm/MFX/mfxx32516/calib/Epix10ka::CalibV1/MfxEndstation.0:Epix10ka.0/pedestals/0-end.data - Gabriel on pedestal calibration:
- offsets and gain are calibrated not very often (say, once per month...)
- pedestals should be calibrated pretty often (once per hour...)
- pedestal calibration is implemented in AMI, using offsets,
- script works on dark runs accumulated for 5 gain modes
- + 2 gain modes are evaluated using combination of other 2 and offsets
- pedestal calibration procedure needs to be completed.
Calibration Details
See this page: https://confluence.slac.stanford.edu/display/ppareg/ePix10K+Calibration
Per panel calibration constants
Algorithm for xtc data with charge injection processing is developed by Gabriel and is wrapped in psana environment as CLI
Detector/app/epix10ka_offset_calibration
Similarly, dark run processing script is
Detector/app/epix10ka_pedestals_calibration
These commands will be available in releases > ana-1.3.58. See description using option "-h", e.g.
-hcommand>
epix10ka_offset_calibration
-hcommand>
epix10ka_pedestals_calibration
File naming convention in panel calibration repository
/reg/g/psdm/detector/gains/epix10k/panels/
- default repository <dir-repo>
, can be re-directed for test by option "-o <dir-name>
".
- directory for particular panel includes its long id<dir-repo>
/3791847426-0170080513-1879048214-0191557724-0003673288-2996154369-0218103833/,
Sub-directories for each panel:
offset
pedestals
plots
work
gain
# content will be provided by Philip
- file with aliases for long panel ids,<dir-repo>
/.aliases.txt
- directory for log files,<dir-repo>
/panels/logs/
Panel calibration file name: epix10ka_0001_20180514120622_mfxx32516_r1021_pedestals_AHL-H.dat
, where
epix10ka - detector type
0001
- panel id alias as specified in/reg/g/psdm/detector/gains/epix10k/panels/.aliases.txt
20180514120622
- run start time stamp in format '%Y%m%d%H%M%S'mfxx32516_r1021
- experiment and run for production of this constantspedestals
- constants typeAHL-H
- gain range (mode)
File with already processed arrays is saved as
/<panel-id>/work/epix10ka_0001_20180514120622_mfxx32516_r1021_sp02-df.npz<dir-repo>
with extra fields in name sp02
for charge injection spacing number of pixels.
Constants merging for multi-panel detectors
command> epix10ka_deploy_constants -h
shows description of command line options. This command with sufficient number of parameters (at least experiment, run, and detector name)
- combines gain mode and panel calibration files in arrays of shape (7, <number-of-panels>, 352, 384)
- deploys calibration files in the calib directory, e.g.
/reg/d/psdm/MFX/mfxx32516/calib/Epix10ka::CalibV1/MfxEndstation.0:Epix10ka.0/pixel_gain/0-end.data
/reg/d/psdm/MFX/mfxx32516/calib/Epix10ka::CalibV1/MfxEndstation.0:Epix10ka.0/pedestals/0-end.data
Pedestal Deployment Meeting Notes (8/2/18)
- script that is use to drive the daq with hutch python: /reg/g/pcds/pyps/mfx/dev/mfx/experiments/mfxls3416.py
- for epix, 5 gain ranges (3 fixed, 2 auto) generate 7 pedestals
- maybe have "all range" option, and fast "selected ranges" option.
- maybe "all range" at beginning of expt, but "selected ranges" during expt.
- jason thinks medium/low is the default
- in the "selected ranges" mode makepeds will reuse the current numbers for ranges that weren't selected.
- multi-panel epix10k should be the same as jungfrau (might need to massage
- the daq appropriately)
- mikhail/gabriel: data processing call in makepeds script
- silke/jason/dan: hutch python, makepeds wrapper
- /reg/g/pcds/engineering_tools/R1.2.9/scripts/makepeds calls makepeds_psana calls mikhail's stuff (jungfrau_ndarr_dark_proc)
References
...
Common mode correction
Anchor | ||||
---|---|---|---|---|
|
Added on 2020-06-04.
The value (raw - pedestals) can be corrected for common mode effect.
First image below shows one epix10ka segment non-corrected image of shape (352, 384). Vertical stripes presumably arising from this hardware effect.
The same median algorithm is applied as for Jungfrau, but separately for up- and down- part of the segment with parameters
cmpars=(<algorithm-id>, <mode>, <maximal-correction>), where
- algorithm-id is not used
- mode=0 - no correction, bit1=1 - in rows (is not useful for epix10ka), bit2=1 - in columns (the best for epix10ka)
- maximal-correction - maximal allowed correction in ADU
NOTE: currently mask on gain mode is not applied - all pixels are used to evaluate and correct for offset.
Examples of the command to get corrected image:
nda_cdata = det.calib(evt, cmpars=None) # default - cm pars from calib directory/system
Meeting with Gabriel
On 2018-07-06 15:13 meeting with Gabriel.
Summary:
- control bit table is correct
- formula should include pedestals in stead of offset
- pedestals need to be generated and saved as txt file of shape (7, 1, 352, 384) under calib directory, for example:
/reg/d/psdm/MFX/mfxx32516/calib/Epix10ka::CalibV1/MfxEndstation.0:Epix10ka.0/pedestals/0-end.data - Gabriel on pedestal calibration:
- offsets and gain are calibrated not very often (say, once per month...)
- pedestals should be calibrated pretty often (once per hour...)
- pedestal calibration is implemented in AMI, using offsets,
- script works on dark runs accumulated for 5 gain modes
- + 2 gain modes are evaluated using combination of other 2 and offsets
- pedestal calibration procedure needs to be completed.
Calibration Details
See this page: https://confluence.slac.stanford.edu/display/ppareg/ePix10K+Calibration
Per panel calibration constants
Algorithm for xtc data with charge injection processing is developed by Gabriel and is wrapped in psana environment as CLI
Detector/app/epix10ka_offset_calibration
Similarly, dark run processing script is
Detector/app/epix10ka_pedestals_calibration
These commands will be available in releases > ana-1.3.58. See description using option "-h", e.g.
-hcommand>
epix10ka_offset_calibration
-hcommand>
epix10ka_pedestals_calibration
File naming convention in panel calibration repository
/reg/g/psdm/detector/gains/epix10k/panels/
- default repository <dir-repo>
, can be re-directed for test by option "-o <dir-name>
".
- directory for particular panel includes its long id<dir-repo>
/3791847426-0170080513-1879048214-0191557724-0003673288-2996154369-0218103833/,
Sub-directories for each panel:
offset
pedestals
plots
work
gain
# content will be provided by Philip
- file with aliases for long panel ids,<dir-repo>
/.aliases.txt
- directory for log files,<dir-repo>
/panels/logs/
Panel calibration file name: epix10ka_0001_20180514120622_mfxx32516_r1021_pedestals_AHL-H.dat
, where
epix10ka - detector type
0001
- panel id alias as specified in/reg/g/psdm/detector/gains/epix10k/panels/.aliases.txt
20180514120622
- run start time stamp in format '%Y%m%d%H%M%S'mfxx32516_r1021
- experiment and run for production of this constantspedestals
- constants typeAHL-H
- gain range (mode)
File with already processed arrays is saved as
/<panel-id>/work/epix10ka_0001_20180514120622_mfxx32516_r1021_sp02-df.npz<dir-repo>
with extra fields in name sp02
for charge injection spacing number of pixels.
Constants merging for multi-panel detectors
command> epix10ka_deploy_constants -h
shows description of command line options. This command with sufficient number of parameters (at least experiment, run, and detector name)
- combines gain mode and panel calibration files in arrays of shape (7, <number-of-panels>, 352, 384)
- deploys calibration files in the calib directory, e.g.
/reg/d/psdm/MFX/mfxx32516/calib/Epix10ka::CalibV1/MfxEndstation.0:Epix10ka.0/pixel_gain/0-end.data
/reg/d/psdm/MFX/mfxx32516/calib/Epix10ka::CalibV1/MfxEndstation.0:Epix10ka.0/pedestals/0-end.data
Pedestal Deployment Meeting Notes (8/2/18)
- script that is use to drive the daq with hutch python: /reg/g/pcds/pyps/mfx/dev/mfx/experiments/mfxls3416.py
- for epix, 5 gain ranges (3 fixed, 2 auto) generate 7 pedestals
- maybe have "all range" option, and fast "selected ranges" option.
- maybe "all range" at beginning of expt, but "selected ranges" during expt.
- jason thinks medium/low is the default
- in the "selected ranges" mode makepeds will reuse the current numbers for ranges that weren't selected.
- multi-panel epix10k should be the same as jungfrau (might need to massage
- the daq appropriately)
- mikhail/gabriel: data processing call in makepeds script
- silke/jason/dan: hutch python, makepeds wrapper
- /reg/g/pcds/engineering_tools/R1.2.9/scripts/makepeds calls makepeds_psana calls mikhail's stuff (jungfrau_ndarr_dark_proc)
List of known detectors on 2018-11-12
command> find_detector_names
Code Block |
---|
#== type 0022 epix10ka
'DetLab.0:Epix10ka.0': 'epix10ka_0000',\
'MecTargetChamber.0:Epix10ka.0': 'epix10ka_0001',\
'MecTargetChamber.0:Epix10ka.1': 'epix10ka_0002',\
'MfxEndstation.0:Epix10ka.0': 'epix10ka_0003',\
'MfxEndstation.0:Epix10ka.1': 'epix10ka_0004',\
'MfxEndstation.0:Epix10ka.2': 'epix10ka_0005',\ |
Composite detectors
EPIX10KA2M and EPIX10KAQUAD - composite detectors made of epix10ka panels.
References
- https://github.com/slaclab/cac/tree/master/psana/epix10ka - scripts from Faisal
- https://pswww.slac.stanford.edu/apps/portal/index.php?exper_id=1107 - under Workflow -> Batch Processing - batch processing
- /reg/d/psdm/MFX/mfxx32516/results/abunimeh/2 - experimental and jupyter notebook scripts
- ePix10K Calibration, by Gabriel Blaj
...
- EPIX10KA2M and EPIX10KAQUAD
- Jungfrau and Epix10ka Calibration
- 2021-09-28 learn about existence of presentation 2019-10-02-ePix10K-500um-Sensor-Geometry.pdf