[AGIPD] Feat: lit-pixel counter

This implements lit-pixel counter.

This depends on !982 (merged)

Description

This implements the lit-pixel counter, which computes the number of lit-pixels per image & module. This metric is needed for SPI hit-finder algorithm.

This records the computed metric in files together with corrected data.

The algorithm is implemented as analysis addon.

How Has This Been Tested?

It was tested by processing run 56 in proposal 7076

% extra-data-validate .
Checking run directory: .
Progress: 208/208 [##################################################]
0 problems
No problems found

File structure

CORR-R0056-AGIPD15-S00012.h5
├INDEX
│ ├SPB_DET_AGIPD1M-1
│ │ ├CORR
│ │ │ └15CH0:output
│ │ │   └image
│ │ │     ├count        [uint64: 10]
│ │ │     └first        [uint64: 10]
│ │ ├DET
│ │ │ └15CH0:xtdf       -> /INDEX/SPB_DET_AGIPD1M-1/CORR/15CH0:output
│ │ └LITPX
│ │   └15CH0:output
│ │     └litpx
│ │       ├count        [uint64: 10]
│ │       └first        [uint64: 10]
│ ├flag [int32: 10]
│ ├origin       [int32: 10]
│ ├timestamp    [uint64: 10]
│ └trainId      [uint64: 10]
├INSTRUMENT
│ └SPB_DET_AGIPD1M-1
│   ├CORR
│   │ └15CH0:output
│   │   └image
│   │     ├blShift      [float32: 3510]
│   │     ├cellId       [uint16: 3510]
│   │     ├data [int16: 3510 × 512 × 128]
│   │     ├gain [uint8: 3510 × 512 × 128]
│   │     ├mask [uint32: 3510 × 512 × 128]
│   │     ├pulseId      [uint64: 3510]
│   │     └trainId      [uint64: 3510]
│   ├DET
│   │ └15CH0:xtdf       -> /INSTRUMENT/SPB_DET_AGIPD1M-1/CORR/15CH0:output
│   └LITPX
│     └15CH0:output
│       └litpx
│         ├cellId       [uint16: 3510]
│         ├litPixels    [int64: 3510]
│         ├pulseId      [uint64: 3510]
│         ├totalIntensity       [int64: 3510]
│         ├trainId      [uint64: 3510]
│         └unmaskedPixels       [int64: 3510]
└METADATA
  ├creationDate [ASCII string: 1]
  ├daqLibrary   [ASCII string: 1]
  ├dataFormatVersion    [ASCII string: 1]
  ├dataSources
  │ ├dataSourceId       [ASCII string: 3]
  │ ├deviceId   [ASCII string: 3]
  │ └root       [ASCII string: 3]
  ├karaboFramework      [ASCII string: 1]
  ├proposalNumber       [uint32: 1]
  ├runNumber    [uint32: 1]
  ├sequenceNumber       [uint32: 1]
  └updateDate   [ASCII string: 1]

List of sources in the file

CORR-R0056-AGIPD15-S00012.h5/METADATA/dataSources/dataSourceId
      dtype: ASCII string
      shape: 3
   maxshape: 3
     layout: Contiguous

sample data:
[b'INSTRUMENT/SPB_DET_AGIPD1M-1/CORR/15CH0:output/image' b'INSTRUMENT/SPB_DET_AGIPD1M-1/DET/15CH0:xtdf/image'
 b'INSTRUMENT/SPB_DET_AGIPD1M-1/LITPX/15CH0:output/litpx']

0 attributes:

Types of changes

• New feature (non-breaking change which adds functionality)

Checklist:

Reviewers

@schmidtp @ahmedk