Fluorescence-Tools
diff --git a/‎.gitignore
+1 b/‎.gitignore
+1
diff --git a/‎.gitlab-ci.yml
+14-27 b/‎.gitlab-ci.yml
+14-27
diff --git a/‎conda-recipe/bld.bat
+9-5 b/‎conda-recipe/bld.bat
+9-5
diff --git a/‎conda-recipe/build.sh
-1 b/‎conda-recipe/build.sh
-1
diff --git a/‎conda-recipe/meta.yaml
+10-13 b/‎conda-recipe/meta.yaml
+10-13
diff --git a/‎examples/correlation/plot_filtered_correlation.py renamed to ‎examples/correlation/not_ready/plot_filtered_correlation.py b/‎examples/correlation/plot_filtered_correlation.py renamed to ‎examples/correlation/not_ready/plot_filtered_correlation.py
diff --git a/‎examples/correlation/plot_confocor3_two_ch_correlation.py
+121 b/‎examples/correlation/plot_confocor3_two_ch_correlation.py
+121
diff --git a/‎examples/correlation/plot_correlation_cr_filter.py
100755100644
-1 b/‎examples/correlation/plot_correlation_cr_filter.py
100755100644
-1
diff --git a/‎examples/correlation/plot_full_correlation.py
100755100644
+1-1 b/‎examples/correlation/plot_full_correlation.py
100755100644
+1-1
diff --git a/‎examples/correlation/plot_gated_correlation.py
100755100644 b/‎examples/correlation/plot_gated_correlation.py
100755100644
diff --git a/‎examples/correlation/plot_normal_correlation.py
100755100644
+8-9 b/‎examples/correlation/plot_normal_correlation.py
100755100644
+8-9
diff --git a/‎examples/correlation/plot_sliced_correlation.py
100755100644
+1-1 b/‎examples/correlation/plot_sliced_correlation.py
100755100644
+1-1
@@ -4,6 +4,7 @@ dist/
 doc/auto_examples
 tmp/
 .vscode
+.cache
 .vs
 .ipynb_checkpoints
 cmake-build-*/
 
@@ -2,23 +2,10 @@ variables:
   GIT_SSL_NO_VERIFY: "1"
 
 stages:
-#  - sync
   - build
   - test
   - deploy
 
-# github:push:
-#   stage: sync
-#   image: condaforge/mambaforge
-#   tags:
-#     - linux
-#   before_script:
-#     - git submodule update --init --recursive --remote
-#   script:
-#     - git switch -c ${CI_COMMIT_REF_NAME}
-#     - git push --force https://${GITHUB_TOKEN}@github.com/fluorescence-tools/imp.bff
-
-
 # general definitions
 .build: &build
   stage: build
@@ -47,21 +34,21 @@ conda:build:lnx:x86:
     - linux
     - x86_64
 conda:build:lnx:ppc64le:
-  <<: *conda_build_lnx
-  image:
-    entrypoint: [ "/bin/bash", "-i", "-c" ]
-    name: condaforge/linux-anvil-ppc64le
-  tags:
-    - linux
-    - ppc64le
+ <<: *conda_build_lnx
+ image:
+   entrypoint: [ "/bin/bash", "-i", "-c" ]
+   name: condaforge/linux-anvil-ppc64le
+ tags:
+   - linux
+   - ppc64le
 conda:build:lnx:aarch64:
-  <<: *conda_build_lnx
-  image:
-    entrypoint: [ "/bin/bash", "-i", "-c" ]
-    name: condaforge/linux-anvil-aarch64
-  tags:
-    - linux
-    - aarch64
+ <<: *conda_build_lnx
+ image:
+   entrypoint: [ "/bin/bash", "-i", "-c" ]
+   name: condaforge/linux-anvil-aarch64
+ tags:
+   - linux
+   - aarch64
 
 conda:build:osx:
   <<: *conda_build_posix
 
@@ -1,5 +1,4 @@
 cd %SRC_DIR%
-git submodule update --recursive --init --remote
 
 echo "Build app wrapper"
 :: build app wrapper
@@ -10,20 +9,25 @@ if errorlevel 1 exit 1
 rmdir b2 /s /q
 mkdir b2
 cd b2
-for /f %%A in ('python -c "import platform; print(platform.python_version())"') do set python_version=%%A
-echo Python version: %python_version%
+
+REM Call Python with the --version flag to get the version information
+for /f "tokens=2 delims= " %%v in ('%PYTHON% --version 2^>^&1') do set PYTHON_VERSION=%%v
+
+REM Extract only the numeric part of the version
+for /f "tokens=1-3 delims=." %%a in ("%PYTHON_VERSION%") do set PYTHON_VERSION_NUMERIC=%%a.%%b.%%c
+
+echo Python version: %PYTHON_VERSION_NUMERIC%
 cmake .. -G "NMake Makefiles" ^
  -DCMAKE_INSTALL_PREFIX="%LIBRARY_PREFIX%" ^
  -DCMAKE_PREFIX_PATH="%PREFIX%" ^
  -DBUILD_PYTHON_INTERFACE=ON ^
  -DCMAKE_BUILD_TYPE=Release ^
  -DCMAKE_LIBRARY_OUTPUT_DIRECTORY="%SP_DIR%" ^
  -DCMAKE_SWIG_OUTDIR="%SP_DIR%" ^
- -DPYTHON_VERSION="%python_version%" ^
+ -DPYTHON_VERSION="%PYTHON_VERSION_NUMERIC%" ^
  -DBUILD_LIBRARY=ON
 nmake install
 
-
 :: Add wrappers to path for each Python command line tool
 :: (all files without an extension)
 cd %SRC_DIR%\bin
 
@@ -1,4 +1,3 @@
-git submodule update --recursive --init --remote
 mkdir b2 && cd b2
 
 if [[ "${target_platform}" == osx-* ]]; then
 
@@ -13,41 +13,37 @@ build:
   number: 1
   detect_binary_files_with_prefix: True  # [not win]
 
+requirements:
 requirements:
   build:
-    - python
-    - numpy
-    - doxygen
     - {{ compiler('c') }}
     - {{ compiler('cxx') }}
     - llvm-openmp        # [osx]
     - libgomp            # [linux]
     - pkg-config         # [not win]
-    - swig
-    - ninja
     - cmake
+    - ninja
     - make               # [linux]
-    - typing             # [py27]
+    - doxygen
+    - swig
+    - python
+    - numpy
   host:
-    - boost-cpp 1.78     # [py > 27]
-    - boost-cpp 1.69     # [py27]
+    - libboost-devel
     - hdf5
     - python
     - setuptools
     - typing             # [py27]
     - numpy
   run:
     - python
-    - tqdm               # [py > 27]
-    - tqdm <=4.14        # [py27]    
+    - tqdm
     - click
     - click-didyoumean
     - {{ pin_compatible('numpy') }}
     - scikit-image
-    - matplotlib
+    - matplotlib-base
     - hdf5
-    - typing             # [py27]
-    - importlib_metadata # [py27]
 
 test:
  imports:
@@ -64,3 +60,4 @@ about:
 extra:
   recipe-maintainers:
     - tpeulen
+    - khemmen
@@ -0,0 +1,121 @@
+"""
+=======================================
+Confocor3 two channel cross-correlation
+=======================================
+
+The raw FCS data format of the Zeiss Confocor3 is relatively simple.
+Zeiss Confocor3 raw files store time-difference between photons.
+A relatively small header is followed by a set of 32-bit integers that
+contain the time difference to the previous registered photon. Photons
+registered by different channels are stored in separate files.
+
+In this example two raw files of a Confocor3 are read and merged into
+a single photon stream. Next, the merged photon stream is used to compute
+the cross-correlation between the two channels.
+
+"""
+import pathlib
+import numpy as np
+
+import pylab as plt
+import tttrlib
+
+#%%
+# Reading data
+# ------------
+# The photon data registered by different detectors are saved in separate files.
+# Read the data of all channels that should be correlated into separate containers.
+fns = [str(p) for p in pathlib.Path('../../tttr-data/cz/fcs').glob('5a6ce6a348a08e3da9f7c0ab4ee0ce94_R1_P1_K1_Ch*.raw')]
+tttr_data = [tttrlib.TTTR(fn, 'CZ-RAW') for fn in fns]
+
+#%%
+# We combine the data in different files into a single TTTR container using the header
+# of first file as template.
+header = tttr_data[0].header
+channels = [t.routing_channels[0] for t in tttr_data]
+print("Used channels:", channels)
+
+#%%
+# You can check the count rates of the channels using the macro time resolution contained
+# in the header
+macro_time_resolution = header.macro_time_resolution
+count_rates = [len(t) / (t.macro_times[-1] * macro_time_resolution) for t in tttr_data]
+print("Count rates:", count_rates)
+
+#%%
+# Now we merge the data of the two detectors in a single container. The
+# marco times need to be sorted first.
+macro_times = np.concatenate([t.macro_times for t in tttr_data])
+routing_channels = np.concatenate([t.routing_channels for t in tttr_data])
+sorted_indices = np.argsort(macro_times)
+
+#%%
+# Using the sorted macro times we sort the routing channel numbers
+# and the macro times.
+routing_channels = routing_channels[sorted_indices]
+macro_times = macro_times[sorted_indices]
+
+#%%
+# Note: no micro time and no event type in the raw Confocor3 format.
+# Thus, we use ones for the micro time and the event type.
+micro_times = np.ones_like(macro_times, dtype=np.uint16)
+event_types = np.ones_like(macro_times, dtype=np.int8)
+
+#%%
+# Using the merged marcro times and channel numbers, we create a new
+# TTTR container.
+tttr_merged = tttrlib.TTTR()
+tttr_merged.set_header(header)
+tttr_merged.append_events(
+    macro_times=macro_times,
+    micro_times=micro_times,
+    routing_channels=routing_channels,
+    event_types=event_types
+)
+
+#%%
+# The container can be used for standard analysis, e.g., correlations.
+settings = {
+    "n_bins": 9,  # n_bins and n_casc defines the settings of the multi-tau
+    "n_casc": 19,  # correlation algorithm
+}
+
+# Create correlator
+# Caution: x-axis in units of macro time counter
+# tttrlib.Correlator is unaware of the calibration in the TTTR object
+correlator = tttrlib.Correlator(
+    channels=([1], [2]),
+    tttr=tttr_merged,
+    **settings
+)
+plt.semilogx(
+    correlator.x_axis,
+    correlator.correlation,
+    label="Corr(1,2)"
+)
+
+correlator = tttrlib.Correlator(
+    channels=([1], [1]),
+    tttr=tttr_merged,
+    **settings
+)
+plt.semilogx(
+    correlator.x_axis,
+    correlator.correlation,
+    label="Corr(1,1)"
+)
+
+correlator = tttrlib.Correlator(
+    channels=([2], [2]),
+    tttr=tttr_merged,
+    **settings
+)
+plt.semilogx(
+    correlator.x_axis,
+    correlator.correlation,
+    label="Corr(2,2)"
+)
+
+plt.ylim(1.032, 1.050)
+plt.show()
+
@@ -42,7 +42,6 @@
 # ``n_bins`` and ``n_casc`` define the settings of the multi-tau correlation steps.
 # If ``make_fine`` is set to false the micro time is not used for correlation.
 settings = {
-    "method": "default",
     "n_bins": 3,
     "n_casc": 27,
     "make_fine": False
 
@@ -58,7 +58,6 @@
 # times as time information, the default value of parameters ``make_fine``
 # when creating a new Correlator needs to by modified:
 full_corr_settings = {
-    "method": 'default',
     "n_casc": 37,  # n_bins and n_casc defines the settings of the multi-tau
     "n_bins": 7,  # correlation algorithm
     "make_fine": True  # Use the microtime information (also called "fine" correlation)
@@ -103,5 +102,6 @@
 ax.set_xlabel('corr. time (ms)')
 ax.set_ylabel('Correlation Amplitude')
 ax.legend()
+ax.set_ylim(0, 12)  # Set y-axis range to 0-12
 
 plt.show()
@@ -39,7 +39,6 @@
 
 # Correlator settings, if the same settings are used repeatedly it is useful to define them once
 settings = {
-    "method": "default",
     "n_bins": 7,  # n_bins and n_casc defines the settings of the multi-tau
     "n_casc": 27,  # correlation algorithm
     "make_fine": False  # Do not use the microtime information
@@ -64,8 +63,8 @@
 correlator.set_events(t1, w1, t2, w2)
 
 # scale the x-axis to have units in milliseconds (common unit in FCS)
-x = correlator.curve.x * (data.header.macro_time_resolution)
-y = correlator.curve.y
+x = correlator.x * data.header.macro_time_resolution
+y = correlator.y
 
 plt.semilogx(x, y, label="Gp/Gs")
 
@@ -82,8 +81,8 @@
 
 # no need to scale axis - correlator aware of macro time units
 plt.semilogx(
-    correlator.curve.x,
-    correlator.curve.y,
+    correlator.x,
+    correlator.y,
     label="Gp,Gs/Rp,Rs"
 )
 
@@ -95,8 +94,8 @@
 )
 
 plt.semilogx(
-    correlator.x_axis,
-    correlator.correlation,
+    correlator.x,
+    correlator.y,
     label="pR,sR"
 )
 
@@ -108,8 +107,8 @@
 )
 
 plt.semilogx(
-    correlator.x_axis,
-    correlator.correlation,
+    correlator.x,
+    correlator.y,
     label="pRsR,pGsG"
 )
 
 
@@ -44,7 +44,7 @@
 #%%
 # Next, we plan to split the TTTR data into separate data chunks. Here, chunk
 # the data into at least 5 seconds long pieces. The method ``get_ranges_by_time_window``
-# returns an one-dimensional array with the beginning and the end index of each
+# returns a one-dimensional array with the beginning and the end index of each
 # chunk. Later, we will use these start/stop indices to define TTTR slices
 # that will be correlated. To slice the data into time windows we use the
 # macro time calibration we computed previously. Note, the last chunk can
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,3 @@`
`1`		`-git submodule update --recursive --init --remote`
`2`	`1`	`mkdir b2 && cd b2`
`3`	`2`
`4`	`3`	`if [[ "${target_platform}" == osx-* ]]; then`