Releases: cgohlke/ptufile
v2025.11.8
Read and write PicoQuant PTU and related files
Ptufile is a Python library to
- read data and metadata from PicoQuant PTU and related files (PHU, PCK, PCO, PFS, PUS, PQRES, PQDAT, SPQR, and BIN), and
- write TCSPC histograms to T3 image mode PTU files.
PTU files contain time correlated single photon counting (TCSPC) measurement data and instrumentation parameters.
Changes
- Fix reading files with negative TTResult_NumberOfRecords.
- Remove cache argument from PtuFile.read_records (breaking).
- Add cache_records property to PtuFile to control caching behavior.
- Derive PqFileError from ValueError.
- Factor out BinaryFile base class.
- Build ABI3 wheels.
v2025.9.9
Read and write PicoQuant PTU and related files
Ptufile is a Python library to
- read data and metadata from PicoQuant PTU and related files (PHU, PCK, PCO, PFS, PUS, PQRES, PQDAT, and SPQR), and
- write TCSPC histograms to T3 image mode PTU files.
PTU files contain time correlated single photon counting (TCSPC) measurement data and instrumentation parameters.
Changes
- Log error when decoding image with invalid line or frame masks.
v2025.7.30
Read and write PicoQuant PTU and related files
Ptufile is a Python library to
- read data and metadata from PicoQuant PTU and related files (PHU, PCK, PCO, PFS, PUS, PQRES, PQDAT, and SPQR), and
- write TCSPC histograms to T3 image mode PTU files.
PTU files contain time correlated single photon counting (TCSPC) measurement data and instrumentation parameters.
Changes
- Add option to specify pixel time for decoding images.
- Add functions to read and write PicoQuant BIN files.
- Drop support for Python 3.10.
v2025.5.10
Read and write PicoQuant PTU and related files
Ptufile is a Python library to
- read data and metadata from PicoQuant PTU and related files (PHU, PCK, PCO, PFS, PUS, PQRES, PQDAT, and SPQR), and
- write TCSPC histograms to T3 image mode PTU files.
PTU files contain time correlated single photon counting (TCSPC) measurement data and instrumentation parameters.
Changes
- Mark Cython extension free-threading compatible.
- Support Python 3.14.
v2025.2.20
Read and write PicoQuant PTU and related files
Ptufile is a Python library to
- read data and metadata from PicoQuant PTU and related files (PHU, PCK, PCO, PFS, PUS, PQRES, PQDAT, and SPQR), and
- write TCSPC histograms to T3 image mode PTU files.
PTU files contain time correlated single photon counting (TCSPC) measurement data and instrumentation parameters.
Changes
- Rename PqFileMagic to PqFileType (breaking).
- Rename PqFile.magic to PqFile.type (breaking).
- Add PQDAT and SPQR file types.
v2025.2.12
Read and write PicoQuant PTU and related files
Ptufile is a Python library to
- read data and metadata from PicoQuant PTU and related files (PHU, PCK, PCO, PFS, PUS, and PQRES), and
- write TCSPC histograms to T3 image mode PTU files.
PTU files contain time correlated single photon counting (TCSPC) measurement data and instrumentation parameters.
Changes
- Add options to specify file open modes to PqFile and PtuFile.read_records.
- Add convenience properties to PqFile and PtuFile.
- Cache records read from file.
v2025.1.13
Read and write PicoQuant PTU and related files
Ptufile is a Python library to
- read data and metadata from PicoQuant PTU and related files (PHU, PCK, PCO, PFS, PUS, and PQRES), and
- write TCSPC histograms to T3 image mode PTU files.
PTU files contain time correlated single photon counting (TCSPC) measurement data and instrumentation parameters.
Changes
- Fall back to file size if TTResult_NumberOfRecords is zero (#2).
v2024.12.28
Read and write PicoQuant PTU and related files
Ptufile is a Python library to
- read data and metadata from PicoQuant PTU and related files (PHU, PCK, PCO, PFS, PUS, and PQRES), and
- write TCSPC histograms to T3 image mode PTU files.
PTU files contain time correlated single photon counting (TCSPC) measurement data and instrumentation parameters.
Changes
- Add imwrite function to encode TCSPC image histogram in T3 PTU format.
- Add enums for more PTU tag values.
- Add PqFile.datetime property.
- Read TDateTime tag as datetime instead of struct_time (breaking).
- Rename PtuFile.type property to record_type (breaking).
- Fix reading PHU missing HistResDscr_HWBaseResolution tag.
- Warn if tags are not 8-byte aligned in file.
v2024.12.20
Read PicoQuant PTU and related files
Ptufile is a Python library to read image and metadata from PicoQuant PTU and related files: PHU, PCK, PCO, PFS, PUS, and PQRES. PTU files contain time correlated single photon counting (TCSPC) measurement data and instrumentation parameters.
Changes
- Support bi-directional sinusoidal scanning (WIP).
v2024.11.26
Read PicoQuant PTU and related files
Ptufile is a Python library to read image and metadata from PicoQuant PTU and related files: PHU, PCK, PCO, PFS, PUS, and PQRES. PTU files contain time correlated single photon counting (TCSPC) measurement data and instrumentation parameters.
Changes
- Support bi-directional scanning (FLIMbee scanner).
- Drop support for Python 3.9.