State population files from Histogram analysis

State population files are ASCII files with the extension .txt. They are usually found in the main/histogram_analysis folder.

Table of contents

  1. Description
  2. File name
  3. Structure

Description

State population files are data-specific and contain methods, parameters and results of state population analysis.

They are created in the /histogram_analysis analysis sub-folder after state population analysis and when exporting results from the Project management area 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 Histogram analysis, and is appended with an extension depending on the Method settings:

  • _[Ddd]_gauss if populations are calculated with Gaussian fitting, where [Ddd] is the data type written in the file
  • _[Ddd]_thresh if populations are calculated with thresholding

Data types supported in state population 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]

The data type is appended with a first extension _[Ttt] if a particular subgroup of molecules was analyzed, with [Ttt] the corresponding molecule tag. A second extension _discr is added when state populations determined from state trajectories are written in the file.


Structure

Method settings

The first lines in file are dedicated to the method settings and depends on how populations are calculated.

For population calculated with thresholding, threshold positions and limits of each state populations are given such as:

Thresholds:

- population [j]: from	[...]	to	[...]

with [j] the state index.

For population calculated with Gaussian fitting, the fitting equation and starting fit parameters are given such as:

Fitting equation:

Starting fit parameters with FWHM = o * 2*sqrt(2*ln(2)):
- Gaussian [j]:	A_[j]=[...]	mu_[j]=[...]	FWHM_[j]=[...]

with A_[j], mu_[j], FWHM_[j] containing the starting guess for the amplitude, mean and full width at half maximum of the [j]th Gaussian component.

If method settings include BOBA-FRET, bootstrapping parameters are given such as:

Bootstraping parameters:

Analysis results

The next lines contain the results of the state population analysis and depends on how populations are calculated.

For population analysis with thresholds, state relative populations are written at:

Relative occurences:

If method include BOBA-FRET, bootstrap means and standard deviations of relative populations are written instead and at:

Bootstrap mean (relative occurences):
Bootstrap standard deviation (relative occurences):

and relative populations for each bootstrap sample is recorded in a column-wise fashion, such as:

  • column sample containing sample indexes
  • columns population [j] containing the relative population of state [j]
Bootstrap samples (relative occurences):
sample	population 1	population 2	population 3	
1	7.213219e-01	1.704264e-01	1.082517e-01	
2	6.873816e-01	1.948943e-01	1.177242e-01	
3	7.742181e-01	1.596652e-01	6.611676e-02	

For population analysis with Gaussian fitting, Gaussian parameters and relative populations from the fit are written in a column-wise fashion with:

  • column Gaussian containing the Gaussian components index
  • columns A, mu, FWHM containing the amplitudes, means and full widths at half maximum of Gaussian components in the mixture
  • column relative occurence containing the state relative population
Fit parameters:
Gaussian	A	mu	FWHM	relative occurence
1	1.748954e-01	-7.565527e-03	7.943746e-02	6.315490e-01
2	1.747060e-02	1.590892e-01	5.012021e-01	3.684510e-01

If method include BOBA-FRET, bootstrap means and standard deviations of Gaussian parameters and relative populations are written instead, such as:

Bootstrap mean:
Gaussian	A	mu	FWHM	relative occurence
1	1.742200e-01	-7.892227e-03	7.939498e-02	6.270481e-01
2	1.799302e-02	1.632702e-01	5.146596e-01	3.729519e-01

Bootstrap standard deviation:
Gaussian	A	mu	FWHM	relative occurence
1	1.596279e-02	2.501341e-03	4.625068e-03	4.822357e-02
2	3.537184e-03	2.178907e-02	1.126754e-01	4.822357e-02

and fit parameters and relative populations for each bootstrap sample is recorded in a column-wise fashion, such as:

  • column sample containing sample indexes
  • columns A_[j], mu_[j], FWHM_[j] containing the amplitudes, means and full widths at half maximum of the [j]th Gaussian components in the mixture
  • columns relocc_[j] containing the state relative population of the [j]th Gaussian components in the mixture
Bootstrap samples:
sample	A_1	mu_1	FWHM_1	relocc_1	A_2	mu_2	FWHM_2	relocc_2
1	1.636259e-01	-4.350341e-03	8.568204e-02	6.282864e-01	1.745914e-02	1.834205e-01	4.978150e-01	3.717136e-01
2	1.618894e-01	-7.044866e-03	8.539515e-02	6.143356e-01	1.440769e-02	2.036760e-01	6.708602e-01	3.856644e-01
3	1.703852e-01	-7.264723e-03	7.297065e-02	5.679364e-01	2.628222e-02	1.760318e-01	3.740112e-01	4.320636e-01