Illumina InterOp Documentation


The Illumina InterOp libraries are a set of common routines used for reading and writing InterOp metric files. These metric files are binary files produced during a run providing detailed statistics about a run. In a few cases, the metric files are produced after a run during secondary analysis (index metrics) or for faster display of a subset of the original data (collapsed quality scores).

We now support an interface to Python 3.6 to 3.11 (see contents below)


There are a wide number of platforms that Illumina supports and releases. The stance has always been to keep SAV backwards compatible with prior releases. This means that these common InterOp libraries need to be backwards compatible as well. There is one exception to this rule: GA systems have been excluded and are not supported with these common InterOp libraries.

NextSeq 1k/2k is supported.

Table of Contents

Content Description
Install Describes how to install Illumina InterOp from binaries and the source code
Applications Describes applications that transform binary InterOp data into text
Examples How to examples showing how to use the Illumina InterOp C++ API
Modules Short descriptions of the most useful code in the Illumina InterOp API
Source Code Git repository hosted on
Issues Have a question? Need a feature? Found a bug? Interact with the developers here.
Performance Computation performance of the code
Changes Changes between releases of the source code
FormatsDescription of the binary formats for each InterOp file
Python Step by step tutorial using the Python binding

List of InterOp Metric Files

Filename Description
CorrectedIntMetricsOut.bin Per tile per cycle per channel average intensity values
ErrorMetricsOut.bin Per tile per cycle percente of incorrect calls for aligned clusters
ExtractionMetricsOut.bin Per tile per cycle per channel 90th percentile of intensity and FWHM values
ImageMetricsOut.bin Per tile per cycle per channel pixel value percentile for thumbnail autocontrast
QMetricsOut.bin Per tile per cycle subsampled basecall quality score histogram
TileMetricsOut.bin Per tile information about density, cluster count, passed filter, percent aligned
IndexMetricsOut.bin Per tile per lane index sequence information
QMetrics2030Out.bin Per tile per cycle Q20/Q30 scores
QMetricsByLaneOut.bin Per tile per cycle Q-score histogram per lane
EmpiricalPhasingMetricOut.bin Phasing weights per tile per cycle
ExtendedTileMetricsOut.bin Per tile occupancy metrics
SummaryRunMetricsOut.bin Per run summary metrics

Known Limitations

There are several known limitations to the current library:

  1. You cannot build a shared library on Windows. Our CMake build script disallows it for good reason, it currently does not work. You can still use a static library on Windows. There is one caveat, you can build a shared library for the SWIG bindings, e.g. C#.
  2. Microsoft .Net less than v4.0.30319 is currently not supported (Same for Mono)
  3. MinGW cannot compile the code when ENABLE_BACKWARDS_COMPATIBILITY=ON
  4. We do not support Mono on Windows
  5. If both Visual Studio and Mono are installed, the build script will only use Visual Studio for C#
  6. We do not support 32-bit builds
  7. MinGW W64 4.9.x and prior will not link properly
  8. Visual Studio 12 2013 is not supported for the C# Bindings (Results in heap corruption)

SAV Analysis Tab

The following images were generated using the applications provided by the InterOp package. See Examples for more information.