ewoksid14.timepix4#

Timepix4 Data Formats and Glossary#

Data Formats#

  • .bin: Raw UDP packets containing event payloads directly from the Timepix4 FPGA.

  • .t4r (Timepix4 Raw): Reordered, cleaned, and still-compressed Timepix4 packets.

  • .parquet: Event table.

Event Table#

Loaded from .bin or .t4r into a polars.DataFrame that contains fully decoded events with the following fields

  • x: Pixel column coordinate

  • y: Pixel row coordinate

  • toa48_ns: Time Of Arrival in nanoseconds

  • tot_ns: Time Over Threshold in nanoseconds

  • top: Boolean flag indicating whether the event was detected in the top of the detector.

  • pileup: Boolean flag indicating whether multiple events overlapped in the same pixel within the same frame (True = pileup detected).

Every row is an event, for example:

` shape: (189_934_708, 6) ┌─────────────┬───────────┬─────┬─────┬────────┬───────┐ │ toa48_ns    ┆ tot_ns    ┆ x   ┆ y   ┆ pileup ┆ top   │ │ ---         ┆ ---       ┆ --- ┆ --- ┆ ---    ┆ ---   │ │ f64         ┆ f64       ┆ i16 ┆ i16 ┆ bool   ┆ bool  │ ╞═════════════╪═══════════╪═════╪═════╪════════╪═══════╡ │ 1487.5      ┆ 1443.75   ┆ 222 ┆ 511 ┆ false  ┆ false │ │ 4303.125    ┆ 1442.1875 ┆ 222 ┆ 511 ┆ false  ┆ false │ │ -22.460938  ┆ 42.1875   ┆ 293 ┆ 258 ┆ false  ┆ false │ │ -3.90625    ┆ 39.0625   ┆ 313 ┆ 257 ┆ false  ┆ false │ │ 7118.359375 ┆ 1442.1875 ┆ 222 ┆ 511 ┆ false  ┆ false │ │ …           ┆ …         ┆ …   ┆ …   ┆ …      ┆ …     │ │ 3.0155e11   ┆ 229.6875  ┆ 228 ┆ 255 ┆ false  ┆ true  │ │ 3.0155e11   ┆ 148.4375  ┆ 218 ┆ 253 ┆ false  ┆ true  │ │ 3.0155e11   ┆ 115.625   ┆ 217 ┆ 253 ┆ false  ┆ true  │ │ 3.0155e11   ┆ 26.5625   ┆ 217 ┆ 252 ┆ false  ┆ true  │ │ 3.0155e11   ┆ 143.75    ┆ 218 ┆ 252 ┆ false  ┆ true  │ └─────────────┴───────────┴─────┴─────┴────────┴───────┘ `

Glossary#

  • t4r: Timepix4 Raw

  • TOA (Time Of Arrival): The time at which a particle or photon hits a pixel.

  • TOT (Time Over Threshold): Duration that the signal remained above the detection threshold; often proportional to the deposited energy.

  • top: Flag indicating the detector layer for the event (True = top of the detector).

  • pileup: Flag indicating overlapping events in the same pixel and frame (True = pileup detected).

  • DPX: Data-Driven Pixel

Modules

lazy

sequential

t4_camera

t4_hist

t4_info

t4_parameters

t4_plot

t4_plutils

t4_process

t4_profile

t4_write