Histogram files

Histogram files are ASCII files with the extension .hist. They are usually found in the main/traces_procssing/histograms or main/histogram_analysis analysis folder.

Table of contents

  1. Description
  2. File name
  3. Structure

Description

The histogram files are written in ASCII format and contain data distributions of the corresponding single molecule state trajectory.

They are created in the /trace_processing/histograms analysis sub-folder when exported from module Trace processing, or in histogram_analysis when exported from module Histogram analysis.

They are created when:

  • exporting single molecule histograms in Export options of module Trace processing
  • exporting sample histograms along with analysis results in Export analysis results of module Histogram analysis

File name

The file is named by the user during the export process.

By default, the file is named after the project file loaded in Trace processing or Histogram analysis, and is appended with the extension _[Ddd], where [Ddd] is the data type written in the file.

When exporting from Histogram analysis, the data type is appended with the extension _[Ttt] if a particular subgroup of molecules was analyzed, with [Ttt] the corresponding molecule tag.

Data types supported in histogram files are:

  • I[i]-[L]: intensities in detection channel indexed [i] upon illumination with laser wavelength [L] nm
  • total[i]-[L]: summed intensities upon illumination with laser wavelength [L] nm (donor in detection channel indexed [i] in absence of acceptor)
  • FRET[D]to[A]: FRET from donor emitter detected in channel indexed [D] to acceptor emitter detected in channel indexed [A]
  • S[D]to[A]: stoichiometry associated to donor emitter detected in channel indexed [D] and acceptor emitter detected in channel indexed [A]

A second extension _discr is added to the file name when distributions of state trajectories are written in the file.

Structure

Histograms are organized column-wise with:

  • column [Ddd] containing binned data
  • column frequency count absolute histogram count
  • column probability histogram count normalized by the sum
  • column cumulative frequency count absolute cumulative histogram count
  • column cumulative probability cumulative histogram count normalized by the maximum
FRET		frequency count	probability	cumulative frequency count	cumulative probability
-7.000000e-02	0		0		0				0	
-6.000000e-02	1		2.500000e-04	1				2.500000e-04	
-5.000000e-02	2		5.000000e-04	3				7.500000e-04	
-4.000000e-02	6		1.500000e-03	9				2.250000e-03