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
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]
nmtotal[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