Add 3D pixel coordinates (generic)

Summary

Computes 3D pixel center coordinates in lab-frame axes.

Metadata

• Module ID: PixelCoordinates3D

• Module path: /home/runner/work/MoDaCor/MoDaCor/src/modacor/modules/technique_modules/scattering/pixel_coordinates_3d.py

• Module version: 20260103.1

• Keywords: geometry, coordinates, detector

Required data keys

• signal

Modifies

• coord_x: signal, uncertainties

• coord_y: signal, uncertainties

• coord_z: signal, uncertainties

Required arguments

• det_coord_z_source

• det_coord_x_source

• det_coord_y_source

• pixel_pitch_slow_source

• pixel_pitch_fast_source

Default configuration

{
  "basis_fast": [
    1.0,
    0.0,
    0.0
  ],
  "basis_normal": [
    0.0,
    0.0,
    1.0
  ],
  "basis_slow": [
    0.0,
    1.0,
    0.0
  ],
  "det_coord_x_source": null,
  "det_coord_x_uncertainties_sources": {},
  "det_coord_x_units_source": null,
  "det_coord_y_source": null,
  "det_coord_y_uncertainties_sources": {},
  "det_coord_y_units_source": null,
  "det_coord_z_source": null,
  "det_coord_z_uncertainties_sources": {},
  "det_coord_z_units_source": null,
  "pixel_pitch_fast_source": null,
  "pixel_pitch_fast_uncertainties_sources": {},
  "pixel_pitch_fast_units_source": null,
  "pixel_pitch_slow_source": null,
  "pixel_pitch_slow_uncertainties_sources": {},
  "pixel_pitch_slow_units_source": null
}

Argument specification

Argument	Type	Required	Default	Description
basis_fast	tuple	No	[1.0, 0.0, 0.0]	Basis vector for the fast detector axis.
basis_normal	tuple	No	[0.0, 0.0, 1.0]	Basis vector for the detector normal.
basis_slow	tuple	No	[0.0, 1.0, 0.0]	Basis vector for the slow detector axis.
det_coord_x_source	str or NoneType	Yes	-	IoSources key for detector x-coordinate signal.
det_coord_x_uncertainties_sources	dict	No	{}	Uncertainty sources for detector x-coordinate.
det_coord_x_units_source	str or NoneType	No	-	IoSources key for detector x-coordinate units.
det_coord_y_source	str or NoneType	Yes	-	IoSources key for detector y-coordinate signal.
det_coord_y_uncertainties_sources	dict	No	{}	Uncertainty sources for detector y-coordinate.
det_coord_y_units_source	str or NoneType	No	-	IoSources key for detector y-coordinate units.
det_coord_z_source	str or NoneType	Yes	-	IoSources key for detector z-coordinate signal.
det_coord_z_uncertainties_sources	dict	No	{}	Uncertainty sources for detector z-coordinate.
det_coord_z_units_source	str or NoneType	No	-	IoSources key for detector z-coordinate units.
pixel_pitch_fast_source	str or NoneType	Yes	-	IoSources key for fast-axis pixel pitch signal.
pixel_pitch_fast_uncertainties_sources	dict	No	{}	Uncertainty sources for fast-axis pixel pitch.
pixel_pitch_fast_units_source	str or NoneType	No	-	IoSources key for fast-axis pixel pitch units.
pixel_pitch_slow_source	str or NoneType	Yes	-	IoSources key for slow-axis pixel pitch signal.
pixel_pitch_slow_uncertainties_sources	dict	No	{}	Uncertainty sources for slow-axis pixel pitch.
pixel_pitch_slow_units_source	str or NoneType	No	-	IoSources key for slow-axis pixel pitch units.