User Tools

Site Tools


en:iq-analyzerx:product_manual

iQ-Analyzer-X Manual

This manual is a living document and will be continuously updated. If you need to save the current version for some reason, please use the “Export to PDF” button. If you find anything missing or have suggestions, please let us know (support@image-engineering.de). We are happy to help!

What’s new in iQ-Analyzer-X?

The iQ-Analyzer-X is an all-new development. The most significant changes are:

  • Increased overall speed (start-up time, detection times, etc.) due to the C++ implementation
  • A versatile and customizable user interface
  • Automatic chart detection and custom chart support
  • Database storage for storing and accessing all previous results
  • Custom workflows for managing unique evaluation specifications
  • Side-by-side comparison of analysis results

System Requirements

The iQ-Analyzer-X is compatible with Windows 10. As you might work with large image data files, please consider a PC with reasonable performance standards.

The iQ-Analyzer-X uses the industry-standard OpenGL for some 3D plots. Please be aware that such plots are not visible if the graphics board of your PC does not support OpenGL.

UTT users only: To import UTT reference files (.xlsx) to the iQ-Analyzer-X database, you need an installation of MS Excel or MS Office on the PC.

Licensing

The latest release of iQ-Analyzer-X is available to download on the Image Engineering homepage. If no dongle is attached to your computer, iQ-Analyzer-X runs as the Free Version with limited functionality. With an active license (via USB Dongle), the software will start as the Pro Version. If you have an active maintenance package, you can use all updates released within your maintenance period.

Free Version

  • Install on unlimited devices
  • Configurable user interface
  • Analysis templates
  • Analyze RAW files
  • Configurable test result tables
  • Zoom function of the image
  • Use individual reference data
  • Save results to a database
  • Export results as XML or PDF
  • Maintenance Package and Priority Support

Pro Version

  • Install on unlimited devices
  • Configurable user interface
  • Analysis templates
  • Analyze RAW files
  • Configurable test result tables
  • Zoom function of the image
  • Use individual reference data
  • Save results to a database
  • Export results as XML or PDF
  • Maintenance Package and Priority Support

Installation and Database Setup

To install iQ-Analyzer-X, click on the executable and follow the instructions. If you launch iQ-Analyzer-X for the first time, a local database will initialize for your analysis results. The progress of initialization is displayed in a progress bar.

Note, that if you are considering using Open Database Connectivity (ODCB) in the future, that there is currently no migration tool to transfer the analysis data from a local to a remote server database! However, you can always switch back and forth between local and ODCB to get access to all of your analysis.

Open Database Connectivity (ODBC)

iQ-Analyzer-X provides an interface for ODBC, enabling you to run a database on a remote server accessible from multiple PCs in different locations. To use ODBC, you need to install a driver for your database first. We have verified that MySQL, MSSQL, and MariaDB work well with the ODBC connectivity of iQ-Analyzer-X. Once you have installed the driver on your operating system, you need to create a database on your OS with the “ODBC Datasources” tool.

After successfully creating the database, start the iQ-Analyzer-X and open the “Configuration” dialog. In the “General” tab is a section for the database configuration. Activate the “ODBC database” option. Now the dropdown menu for “Database name” is accessible. Choose the database you created from the dropdown menu. The database tries to establish a connection immediately. If it's the first time you connect to the database, you are asked to provide a folder where all images are saved permanently. If everything worked correctly, the database status shows a green check symbol, and you are ready to use your database.

Dongle

The USB dongle needs to be attached to your system to access the full functionality of iQ-Analyzer-X. The dongle keeps the information about your maintenance period, and the software shows a message before this period expires. Please contact our sales team if you want to extend the maintenance.

You can find general information about your dongle in the “General” tab under “Configure.”

Network License

A USB Dongle needs to be connected to the PC to run the iQ-Analyzer-X Pro Version. Since version 1.4, iQ-Analyzer-X also provides a network license feature. The USB dongle can be attached to a server, and the local PC does not need to have physical access to the dongle. With one USB dongle, you can have multiple concurrent with the network license. The management of the simultaneously running versions of iQ-Analyzer-X is performed with the help of user slots in a server file generated by the “MATRIX-Net” server program from “TechnoData Interware GmbH.”

The MATRIX-Net functional principle is shown in the diagram above. The server program running on a computer with the dongle generates an encoded server file. Each running version of the iQ-Analyzer-X “connects” with the server file and occupies a user slot released when the application is closed. The network protection via MATRIX-Net does not use network protocols and can thus be used in any network system.

Installation of the Network License

When installing the network license, you need the mxnet32.exe, which is located in the installation directory of your iQ-Analyzer-X version under “NetworkLicenseTool.” Connect the dongle to your dedicated server and run mxnet32.exe. This process opens the MATRIX-NET program (the MxNet server application) and must run on the server PC.

The MxNet server program can also be registered as a Windows service so that the program is started automatically during the boot-up of Windows. The advantage of a service over an Autostart entry is the ability to start even if there is no User-Login in Windows. You can directly register MxNet as a service by starting MxNet with the corresponding parameters. The following call-up parameters are available: mxnet32.exe -i (Install MxNET service) and mxnet32.exe -r (Uninstall MxNET service).

After starting the MATRIX-NET program, a dongle symbol is displayed in the taskbar.

Clicking on this icon opens the MATRIX-NET dialog.

Create a new entry in the Server file list. Enter a name for the program in the field “Application name.” The name can be anything you like, and it does not need to match the actual application name. The network licenses are managed using a .mx server file. You can create the server file yourself and enter its path under “Server-File,” or you can enter a full path with a .mx file and click “New Entry.” The file is then automatically generated. The name of the server file must always be entered with the absolute path and correspond to the naming conventions of the operating system.

After setting up and running the MATRIX-NET server, install iQ-Analyzer-X on the client PCs. On each computer, you need to enter the server file you just created in the “Dongle File Path” field in the “General” tab under “Configure.” You can also browse for the file. After providing the path, click connect. If the connection was successful, the status is shown in green as “CONNECTED.”

The “Network” tab shows information about the dongle, the total number of licenses, and the free slots.

MATRIX-NET Settings

REFRESH-TIME

In this field, the time interval for the refresh of the server file is set. The last refresh carried out is displayed in the “Last Refresh” field. The refresh period should usually be selected to be between 5 and 10 minutes.

USER-TIMEOUT

The User-TimeOut is the time limit after which the user is automatically removed from the server file. In the event of abnormal termination of the application (crash) on a client, this function ensures the release of the user slot in the server file, as this would otherwise remain occupied.

ACTIVE-USERS

This field is continuously updated and shows the total number of active users for the selected application. The “Active-Users” button allows you to display a detailed list of the active users. A user entry can be manually removed from this list. If your application is terminated abnormally on any terminal, you can either remove the user slot from the list or wait for the time out. When the user time out is reached, the user slot is automatically removed when the server file is refreshed. It is unnecessary to delete the user slot before the abnormally terminated application is restarted. The existing user slot will be found and refreshed automatically.

Important! Important! It is essential that the system time of the PC is synchronized in the network; otherwise, the “User-TimeOut” can not be correctly computed. The maximum allowed deviation of the system time between clients and server may not exceed the number of minutes selected in the MATRIX-NET server program in “Refresh-Time.” The following command can synchronize the clients’ system time with the server’s system time. This command can be implemented in the boot-up procedure of each client to make it an automatic function.

NET TIME \\<computername> /SET /YES

Getting started

This is a quick guide on how to run your first analysis in iQ-Analyzer-X. Example images are provided on the iQ-Analyzer-X download page.

The first time you launch iQ-Analyzer-X it, takes a moment to initialize the local database in which the future analysis will be saved. After the initialization is done, click on “New Analysis.”

The “Import Images” dialog will appear. You can either load single images with “Open Image Files” or all the images in a folder with “Open Image Folder.” For now, please open a single image. The software detects the test chart automatically and shows it in the “Chart” column. If there are problems with the automatic detection, the chart can also be selected manually with the dropdown menu in the “Chart” column.

If all charts are detected, click “Import.” The main window will appear with the “Input“ dock showing the imported images.

Apply your desired settings and the detection mode under “Configuration.” For your first analysis, the default values will be adequate. Click on “Start New Analysis” to launch the first image analysis. The results will be presented in the “Analysis results” tab when the analysis is completed. Switch through the different tabs to see the visualization of your measurements. You can also undock the tab from its container for a better view.

To save your analysis, click on “Save new analysis.”

Enter the details of your analysis and click on “Save Analysis.” A good description will help you find your analysis more quickly in the database.

Congratulations! You just performed your first image quality analysis with iQ-Analyzer-X.

Image Quality Analysis

General Workflow

The iQ-Analyzer-X detects the type of test chart automatically and provides the results accordingly. The basic concept requires that each analysis is only for one specific camera make and model. The analysis will be stored in a database, and several results of different cameras can be opened simultaneously for comparison. All necessary analysis settings are now in one place, and you can create custom settings and store them in the database.

GUI Overview

The GUI consists of several docks and windows that can be individually placed on your screen by drag and drop. To change the position of a window, click into the top row and drag it to your desired position. If you drag it onto another window, it will show appear as a tab. You can always go back to the original state by selecting “restore view to default” in the “view” menu. Most result graphs and image overviews can be zoomed in and out with the mouse wheel or move positions with click and drag.

In the default view, the GUI shows the “Toolbar” dock (1), the “Input” dock (2), and the “Analysis Results” tab (3). The “Toolbar” provides a shortcut to a few basic functions. The “Input” dock shows all imported images and lets you define the settings for your image analysis. The “Analysis Results” tab contains all the results and information about the currently active test image. The currently active image is highlighted in orange.

Meta Tab

The meta information of the currently active image under test is displayed here.

Image Tab

The current active test image with all ROIs detected is displayed here. This view is beneficial to check if the ROIs are in the correct location or any artifacts like reflections. It also highlights the corresponding targets when you hover over a line in its results plot. This feature makes it easy to see the target's connection and result. You can easily zoom in and out by using your mouse wheel, and the zoom will focus on the location of the pointer of your mouse.

Analysis Tab

This tab provides an overview of the images in your active analysis. If multiple analyses are open, the active analysis is the one with the highlighted text in the headline of its tab. The overview provides a simple way to switch between the test images.

Import Images

If you click on “New Analysis,” the “Import” dialog will pop up. You can either import multiple image files or an entire folder with images. iQ-Analyzer-X supports *.tif, *.bmp,*.jpg, *.png and raw files.

After opening the test images, they will appear in the “Import” dialog. If you have opened multiple image files, you can allocate the charts manually or automatically. Choose “Automatic detection” (individual) if the test images show different test charts and “global” if all images show the same test chart. To remove a test image, select it and click on “Remove selected images.” Note that only specific test charts are supported by iQ-Analyzer-X. Please refer to https://www.image-engineering.de/products/software/iq-analyzer-x for details. Open the dropdown menu in the “Chart” column to manually identify the chart and choose your layout. You can also assign a chart layout for multiple test images. Hold the “Control” key, select the test images you want to assign a chart for, and change the chart with the dropdown menu.

Please note that if you have an OECF chart, the software can only detect the layout and not the contrast or type of the chart. For example, if you import an image of the TE269 chart, the software cannot recognize whether it’s a TE269A, TE269B or TE269C. Therefore, you need to address the chart version by choosing the corresponding reference files in the “Import” dialog. This sequence also applies to chart TE264.

Most test charts will be delivered with a corresponding reference file that contains your chart's individually measured data. The reference file can be imported in the “Reference files” tab from the “Configure” menu, and this reference file can be allocated in the column “Reference.” If you do not have a reference file, you can also work with the provided sample data, which is less accurate and not recommended.

If all charts are adequately detected, and the reference files are also correct, click “Import.” The images will appear in the “Input” dock.

Raw Images

If your images are raw files, activate the checkbox “Import files are RAW files” before clicking “Open…”. In this instance, the following dialog for raw file import appears where you can provide information about the raw file structure.

If you have many differently structured raw files, you can save your settings for future analysis. To save a setting, you need to provide a name in the top dropdown menu. Once you have a name, the “Save” and “Save new” buttons are available. “Save” will overwrite your setting, while “Save new” will create a new setting in the database. You can access your saved settings via the dropdown menu.

Video Files

Your operating system needs to know the video codec to open video files and import frames from it. It might be necessary that you install the required codec first before using this function. If you are having trouble importing a video, please follow this link.

To import frames from a video, open the “Import” dialog. Click on “Import from Video Files.” Click on “Open Video file(s)” in the upcoming window and select the videos from which you want to take frames. Double-click on the video file you wish to process if you have chosen multiple videos. The video starts to play. Pause it by pressing “Play.” Now you can go through the video frame by frame. Go to a frame you would like to import and click “Take image(s).” With “Image Count,” you can define the number of images you want to take from that position on forward. The images you take immediately appear in the “Import” dialog. Once you are finished, click close and proceed with the chart detection.

Analysis Template (Image Sequence Analysis)

With analysis templates, image sequences with different apertures or ISO settings can be compared utilizing resolution evaluation. It is also possible to calculate the average of an image sequence or identify the image with the best resolution based on the MTF. You can create templates containing multiple groups, for example, one group for a range of ISO settings and one for a range of aperture settings. Templates are saved to the database and can be selected in the dropdown menu in the “Import” dialog.

Example ISO Sequence with three images:

We create a template for three images captured with different ISO settings in this example.

Click the key symbol to access the template settings.

Add a new template. Change the template name to “ISO Measurement Series,” for example.

Name the Image Group “ISO group1.” Increase the image count to three. As “Type,” select “ISO Range.” Choose “MTF50” as measurement and “Center” as a group from the dropdown menu. The additional result plot then displays the MTF 50 values of the Siemens stars in the center over the ISO Range.

Change the ISO value in the column “Rule” to the corresponding properties of your images. In our case, it is 100, 400, and 800. You can change the value by double-clicking on the field and entering the ISO value.

After entering all ISO values, click on the key symbol again to leave the editing mode. Select the three images for analysis and move them to the placeholders.



 **Note that the ISO settings of your image in the EXIF data have to match the ISO value you provided.** If the value matches, the image will be highlighted green; if not, it will be red. **Tipp: You can drag and drop all images at once. Select all available images and drop them into the first placeholder.**

{{ :en:iq-analyzerx:analysis_template_iso_red_green.png?nolink |

Click “Import” after finishing the allocation of the images and analyze the images. A new tab will be added to “Resolution” called “Image Series,” which shows the MTF over the ISO value.

Average Measurement

Measurement type “Average” can be helpful for measurements that have a significant variance due to the measurement setup. With this option, the average values of the numerical results are calculated, and the plots are adjusted. You can calculate the average of the whole image sequence or only a few images by selecting them in the “Input Dock.” In the following example, only two images are selected from the ” Average “ group, so the plots and numerical results show only the average of the MTF of these two images.

Best Of Measurement

The “Best of” measurement determines the image with the best resolution based on the MTF. An additional “Image Series” tab is displayed, highlighting the image with the best performance. The image is also highlighted in the “Overview” area.

Analyze Images

All imported images are listed in the “Input dock” under “Images.” You can either add, remove or remove all images by selecting the image and pressing the corresponding button.

Under “Settings,” you can define the settings you want to apply to your analysis. You can change and save your analysis settings in the configuration tab under “Configure.”

Under “Detection,” you can choose between three modes.

  • Automatic Mode
  • Semi-automatic Mode
  • Manual Mode

If the automatic detection does not work correctly, you can try semi-automatic detection, which shows the detected ROIs in a dialog that is adjustable. In the “manual mode,” the ROIs are placed on the image independently of its content, and the ROI's sizes and positions depend on the principle layout of the assigned chart type.

{{ :en:iq-analyzerx:seminadmanualdetection.png?nolink |

If you have a test image that contains multiple metrics, such as the TE42-LL, you can select the corresponding ROIs for one metric in the “Group Display” section. Click on the entries in the list to turn them on or off. Once you have selected the desired ROIs, you can change their size and position. To change the size of a single ROI, grab it on the circle markers. Grab it in the center with a left mouse click and drag it to change its position.

If several ROIs are out of their desired position, you can also adjust the parent bounding box's size and shape. This adjustment moves all interior ROIs depending on their relative position to this box.

If you only want to change the position of the ROIs, disable the handles by deactivating “Display inner ROI pins.” This option gives you a better view, and it is easier to drag the ROIs.

Rotation or lens distortion can be compensated with the sliders on the bottom right

.

To get a better view, you can enlarge the size of the window or zoom in and out with the scroll wheel. If you have multiple test images with similar content, it's possible to copy the ROIs from one image to another. To do so, select the image which you want to copy the ROIs from with “Previous image” or “Next Image,” click on “Copy ROIs,” then select the image you want to paste the ROIs to and click on “Paste ROIs.” If you're going to apply your adjustments to all images in the stack, click on “Spread ROIs.” With “Save as template” you can save the ROIs for an analysis in a new iQ-Analyzer-X session. The template applies only to the same chart type.

If all targets are correctly detected, press ok to start the analysis. The results show up in the “Analysis Results” Tab.

Messages regarding the analysis of the active session are logged in the “Information” dialog. You can open the dialog by pressing the triangle on the bottom right.

There are two options for running an analysis, “Start New Analysis” and “Update Analysis.” If you, for example, want to analyze the already imported images with different settings, you can update your analysis by pressing “Update Analysis.” All results will be updated accordingly. Meanwhile, “Start Analysis” will create a new analysis in a separate tab. If you have two or more analyses opened simultaneously, the currently active analysis tab is highlighted with a brighter text.

Save Analysis

Click on “Save new analysis” in the toolbar to save the results. Enter the information about the analysis in the dialog. All fields except “Short name” need to be filled out to make the “Save analysis” button available. Note: If you want to compare two different cameras, you need to analyze each camera, and it is not recommended to mix the results of other cameras in one analysis. Once the camera model and make are saved with the analysis, they are available in the dropdown menu for future evaluations.

Open Analysis

Click on “Open analysis” to load an already existing analysis. In the “Open analysis” dialog, several filters can be applied to help you find your desired evaluation.

Comparison of Analysis

To compare two analysis, you need to save at least one of them first into your database. With the button “Append to view” in the “Open Analysis” dialog you can than integrate the results of the selected analysis to the currently active one.

Update Analysis

To save changes in an already existing analysis, press on “Update analysis in DB” in the toolbar. You can still change the analysis name, serial number, and the short name in the upcoming dialog.

Database

With the installation of the iQ-Analyzer-X, a local database is set up where all analysis results can be saved. The database allocates a specific ID to every newly saved analysis. The ID is the main criteria for the database to distinguish between your analysis results. There can be two analyses with the same name but having different IDs. Please refer to the chapter "Configuration" for further information and the database settings.

Results

The results are provided numerical and in graphical representations. The plots that appear depend on the chart you are using. If you analyzed multiple images, the plots and the numerical results show the results of the marked image. To display the results of more images at once, select them using the Ctrl key.

Some of the result plots offer advanced options. You can access these options with the “Key” button.

If a legend is shown with a plot, you can click on the legend to view or hide the legend's entries in the plot. Only Q1 and Q2 are shown in the graph in the example below, and all the other legend entries are hidden.

Zoom in or out of the plot using the mouse wheel. Change the plot's position by simply clicking and dragging.

The corresponding numerical results are shown in the table below the graphs. You can define the measurements you would like to include in the table by checking them in the dropdown menu on the right side. Click on “All” to include all measurements.

The results that belong together are marked in the same color.

Resolution

Image resolution is the ability of a digital camera to reproduce the details of a scene. Resolution is an essential image quality attribute related to the overall image quality perceived by a human observer. Various factors influence image resolution, including the lens quality, alignment of the components, ideal focusing, exposure time, a sensor with optical components in front of it (low pass filter, IR filter, etc.), and aperture. All of these components are responsible for reproducing the details of objects within a scene.

iQ-Analyzer-X provides three methods, each with different characteristics, to measure resolution. These include Siemens Star, Slanted Edge, and Dead Leaves. The result in each case is a Spatial Frequency Response (SFR) or Modulation Transfer Function (MTF).

Graphical Results

The MTF10 and Nyquist frequency are the default camera measurements represented with the orange dotted line shown in the graphs.

All SFRs

SFRs of all selected resolution measurements such as slanted edge, Siemens star, or Dead Leaves are shown in one graph in this tab. If there are multiple targets for one measurement in the chart, the average will be displayed. The targets used for the results will be highlighted orange in the “Image” tab.

Siemensstar

The SFR of a single Siemens star or all Siemens stars can be displayed in this plot. With “Type,” you can choose if the SFR is weighted with the viewing conditions to retrieve a vSFR and vMTF. The viewing conditions can be edited in the "Viewing conditions" tab. If you choose a vSFR, the graph's Contrast Sensitivity Function is added as a painted gray line.

The overview shows a circle for every Siemens star in the chart, divided into eight segments. The MTF10, MTF25, or MTF50 are calculated for each segment, giving you an excellent look at the resolution differences depending on the direction. The single circles show the percentage of how close the MTF10, MTF25, and MTF50 are to the Nyquist frequency. The circle's outline represents 100 percent of the Nyquist frequency, whereas the center represents zero percent. So the closer the MTFx curve is to the outline, the better.

Dead Leaves

For the SFR plot, please refer to "Siemensstar".

Slanted Edge

For the SFR plot, please refer to "Siemensstar".

The “Profile” plot shows the edge spread function of the slanted edges in digital value over the position. The edge spread function plot is a valuable tool to identify sharpening in the image.

Numerical Results

ISO: Shows the ISO setting of the camera if available.

FILE: Shows the Filename.

GROUPS: If you captured a test chart with multiple targets, for example, the TE42 LL, targets might be grouped, and the results will show the group's average if you select “Show All” under “Data” in the graph.

EDGES: The identifier of the slanted edge.

MTF 10, MTF 25, MTF 50: The MTF values refer to the spatial frequencies that reach a particular modulation. For example, the MTF10 shows the spatial frequency that still reaches a modulation of 10%, whereas the MTF25 shows the spatial frequency that reaches 25%. The frequency is expressed in LP/PH (line pairs/picture height).

VMTF SET1-SET3: This measurement is similar to visual noise and quantifies how well a human observer can recognize noise. The visual MTF implicates the three defined viewing condition sets. The calculated and the ideal MTF are multiplied with the contrast sensitivity function (CSF) and depend on the viewing condition sets for visual noise. The two integrals are divided. When multiplied by 100, you get the visual MTF (vMTF) percentage.

Edge modulation: The modulation of the slanted edge in the linearized image. The value should be close but not necessarily equal to the modulation of the target.

Edge width (0-100%) and Edge width (10-90%) in px: The edge width is specified for 0-100% and 10-90% of the maximum modulation of the edge. It is the distance in pixel between two points in the edge profile with a certain modulation. The example below shows the edge width for 10 to 90%. The y-axis is the intensity in digital values for an 8-bit image from 0 to 255. The x-axis represents the position related to the edge. So value 0 is the position of the maximum of the first derivative of the edge profile. For example, a value of 4 indicates that 4 pixels are right of the edge. Therefore a value of -4 means 4 pixels are left of the edge. The left always represents the low intensity, and the right the high-intensity side of the edge.

Maximum digital value: Indicates the average DV of the bright part of the edge.

Minimum digital value: Indicates the average DV of the dark part of the edge.

Overshoot and Undershoot: These metrics are calculated based on the edge profile and specify the undershoot and overshoot resulting from sharpening in the image. It is defined as (max_over-max)/max*100 for overshoot and the opposite way for undershooting.

Fit error (px): An ideal line along the edges has to be determined for the SFR-Edge approach. The fit error shows how well this line has been fitted into the real image data—the lower the value, the better the fit.

OECF

The Opto Electronic Conversion Function (OECF) can be determined with a grayscale target in a test chart. The OECF describes how a digital camera transfers the luminance of a scene into digital values in the image.

The test chart needs to be illuminated homogeneously to determine the OECF. In ISO 15739:2013, the digital value of the test chart background should be equal to 118. The OECF gray patches are also applied for Noise related and Dynamic Range measurements.

Graphical Results

The OECF + SNR plot shows the optical-electronic transfer function and the SNR for the R, G, B channels, and Y. In the “Data” drop-down menu, you can define the parameter and scale for the x-axis.

The visual noise graph shows the visibility of noise determined over the luminance values according to ISO 15739. The curves named Delta L*, Delta u*, and Delta v* show the share of the individual parameters to the overall visual noise. The visual noise depends on the viewing condition set in the configuration menu. You can exhibit visual noise for the three viewing conditions with the “Type” drop-down menu in the upper left corner.

Visual Noise Polar: The polar plot shows the visual noise over the gray patches in polar coordinates.

Numerical Results

OECF+SNR

SNR is defined as the ratio of the signal value to the standard deviation of the signal value. iQ-Analyzer-X calculates a Y (luminance) image and uses this for further calculations. The results are also indicated as digital values [DV]. The results differ depending on the ISO 15739 version due to the varying calculation of noise and exposure. ISO 15739:2003 applies the three noise patches in the chart layout, and ISO 15739:2013 measures noise within the OECF patches. The following calculations are based on ISO 15739:2013. For the chart-based OECF, the reference luminance (Lref) shall be determined as the luminance corresponding to a digital level of 245 on the OECF function. The total, fixed pattern, and temporal signal-to-noise ratios are measured at the luminance that is 13% of the luminance at the reference exposure:

{L_SNR} = 0.13*L_REF

LREF: Luminance corresponding to the digital value of 245

R_REF = S^-1(I)

RREF : Log luminance value at the reference luminance.

S-1: The inverse of the camera OECF curve, S

I: digital value = 245

SNR total: Total noise means all unwanted variations captured by a single exposure.

Total standard deviation: Standard deviation of the total noise for a single image and multiple images when analyzing “n” images.

The signal-to-noise ratio is determined by:

SNR_total = L_SNR*gain_incremental/{sigma_total}

sigma_total = sqrt{{sigma_y}^2+{C_1 sigma_{R-Y}}^2+{C_2 sigma_{B-Y}}^2}

sigma_total = sqrt{ {1/n} sum{i=1}{n}{sigma^2}total,i}

SNR Total (dB): SNR TOTAL is specified in dB.

SNR Fixed Pattern: Fixed pattern noise is unwanted constant variations for every exposure.

Standard deviation Fixed Pattern: The standard deviation of the fixed pattern noise.

The ISO standard camera fixed pattern SNR is determined by:

SNR_FP = L_SNR*gain_incremental/{sigma_fp}

sigma_fp = sqrt{ {sigma^2}_ave - {n/(n-1)} {sigma^2}_diff }

σfp: Standard deviation of the fixed pattern noise.

σave: Standard deviation of the code value of the average of “n” images.

σdiff: The average standard deviation of the code values of all the differences between the average and the individual images that make up the average.

Multiple images are required to calculate the fixed pattern noise.

SNR Temporal: Temporally varying noise is random noise due to the sensor dark current, photon shot noise, analog processing, and quantization, which differs from one image to the other. If you have captured a minimum of eight images in a single session, the temporal SNR will be calculated. The temporal SNR is determined by measuring the standard deviation of the difference between each image and the average image and applying a correction to assess the actual level of the temporal noise.

Temporal Standard deviation: The standard deviation of the temporal noise.

SNR_temp = L_SNR*gain_incremental/{sigma_temp}

sigma_temp = sqrt{{n/(n-1)} {sigma^2}_diff }

σtemp: Standard deviation of the temporal noise.

σdiff: Average standard deviation of the code values of all the differences between the average and the individual images that make up the average.


Mean Visual Noise: The numerical value for Visual Noise is a weighted sum of the standard deviation of each channel in the CIE-Luv color space. To give further insight into the noise characteristics, we also provide the visual noise metric for all three viewing conditions, which can be specified in the settings.

Max Visual Noise: The maximum visual noise.

Mean Delta L*: Mean standard deviation in CIE L*.

Max Delta L*: Maximum standard deviation in CIE L*.

Mean Delta u*: Mean standard deviation in CIE u*.

Max Delta u*: Maximum standard deviation in CIE u*.

Mean Delta v*: Mean standard deviation in CIE v*.

Max Delta v*: Maximum standard deviation in CIE v*.


Dynamic range: The dynamic range is provided in f-stops, densities, and dB. It applies to ISO 15739:2013 and the outdated version ISO 15739:2003. The ISO DSC (Digital Still Camera) dynamic range is the ratio of the maximum unclipped luminance level Lsat to the minimum luminance level that can be reproduced with a signal-to-noise ratio of at least 1, Lmin.

ISO.DSC.dynamicrange = L_sat/L_min

L_min = L_(SNR=threshold)

The default threshold is SNR=1.

If the threshold cannot be reached, a 2.0 density “black reference” calculates the dynamic range to avoid black level clipping problems.

The value for Lmin shall be calculated as

L_min = {sigma_total(2.0)}/gain_incremental

sigma_total(2.0) = sqrt{{1/n} sum{i=1}{n}{sigma^2total,i} }

σtotal (2.0): The black total noise measured at a density of 2.0.

Dynamic Range (DV): The dynamic range, stated in digital values, shows the difference between the mean digital value of the brightest and the darkest patch. This option is helpful to see at which black or white level the camera clips.

Temporal Dynamic Range: The temporal dynamic range is only available when using the new version of ISO 15739 standard, ISO 15739:2013. If the threshold cannot be reached, a 2.0 density “black reference” calculates the dynamic range to avoid black level clipping problems.

The value for Lmin shall be calculated as

L_min = {sigma_temp(2.0)}/gain_incremental

The black temporal noise is derived by measuring the standard deviation of the difference between each image and the average image and then applying a correction to determine the actual level of the temporal noise:

sigma_temp(2.0) = sqrt{n/(n-1)sigma^2_diff}

σtemp (2.0): Standard deviation of the temporal noise.

σdiff: Average standard deviation of the code values of all three differences of the average and the individual images that make up the average.


WB DV: White balance stated in digital values. The mean difference between red-green and blue-green. As the chart is perfect gray, the ideal would be 0.

WB CIE: Average of the CIE-C (chrominance) values


There are three different definitions outlined in the ISO standard. The idea is to measure the light intensity on the sensor leading to a specific result in the image:

ISO SAT: Saturation-based ISO speed; the ISO speed is calculated on the light intensity that is needed to reach saturation.

ISO SN10: Noise-based ISO speed; the ISO speed is calculated on the light intensity that is needed to reach a signal-to-noise ratio of 10 (first acceptable).

ISO SN40: Noise-based ISO speed; the ISO speed is calculated on the light intensity that is needed to reach a signal-to-noise ratio of 40 (first excellent).

Color

Camera color characterization is an essential step in the color image processing pipeline. It evaluates how the camera module translates RGB raw data from the sensor to the desired color space. Improper color calibration and characterization can lead to false-color reproduction, thereby hurting an image's overall image quality. The color reproduction is usually described with the Delta E metric, which represents the color difference of the color in the test image to its reference color. Note that there are different formulas for the calculation of Delta E. Therefore, you also need to state the applied formula.

Graphical Results

Delta Tables

The “Delta tables” tab shows a color-coded square for each color patch in the test image. These squares also exhibit the numerical parameter value selected in the drop-down menu. You can choose between Delta E, Delta L, Delta C, Delta H, and visual noise. The scaling of the color coding can be adjusted under “Visualization” in the “Configure” dialog.

“Visual Comparison” compares the color in the test image and the color of your reference.

Delta 3D Plots

This plot shows the Delta values in 3D bars. You can change the perspective by using the different camera positions or dragging the plot with your mouse. In case of negative values, it makes sense to use the bottom camera views.

Color Space Plot

The calculated colors of the image and the reference are displayed in the CIE xyY color space, where x and y are the chromaticity coordinates, and Y is the luminance. The colors of the image under test are represented by a sphere and the reference colors by a cube. Click on the geometries to see its CIE x, y, and Y values.

Numerical Results

The mean and maximum values are stated for different groups, defined in the reference file. A group can, for example, contain only the skin, color, or neutral tones. “General” groups all patches.

Delta E: The iQ-Analyzer-X calculates Delta E from two Lab data sets, the reference, and the image sample set. You can choose between three methods for calculating Delta E under “Analysis Settings,” with the most common calculation being CIE1976.

Delta E = sqrt{Delta L^2 + Delta a^2 + Delta b^2}

Delta L = L_reference-L_sample

Delta a = a_reference-a_sample

Delta b = b_reference-b_sample

If you express the Lab in polar coordinates, you get LCH, where L is the luminance, C the chrominance, and H the hue. Delta E indicates the overall difference between reference and sample. It might also be interesting to look at the difference between Luminance Delta L and Hue Delta H to get more detailed information about the deviation.

Delta L = L_reference-L_sample

Delta C = C_reference-C_sample

Delta H = sqrt{Delta a^2 + Delta b^2 - Delta C^2}

CIE1994:

Delta E = sqrt{({Delta L}/{K_L S_L})^2 + ({Delta C}/{K_C S_C})^2 - ({Delta H}/{K_H S_H})^2 }

In iQ-Analyzer-X, the following parameters for graphics and photography are used.

kL = kC = kH = 1
SL = 1
SC = 1 + 0.045 Csample
SH = 1 + 0.015 Csample

CIE2000 1:1:1 :

Delta E = sqrt{({Delta L}/{K_L S_L})^2 + ({Delta C}/{K_C S_C})^2 - ({Delta H}/{K_H S_H})^2 + R_t ({Delta H}/{K_H S_H}) ({Delta C}/{K_C S_C})  }

Compared to CIE1994, the rotation term is added as the fourth element and only takes effect in the blue region.

Delta L*: Delta Luminance is based on CIE LCH color space.

Delta H*: Delta Hue is based on CIE LCH color space.

Delta C*: Delta Chrominance is based on CIE LCH color space.

VN SET1-3: Visual Noise is described in ISO 15739. It correlates much better with the human perception of noise than a standard SNR measurement and is stated for three viewing conditions.

Shading

The shading results show how uniform a camera reproduces a test image of a flat field, meaning a surface with uniform intensity. This test can be an image of a uniform test chart like the TE255 or an image of a light source with a uniform opening like the CAL series.

Graphical Results

The “2D plot” shows the shading measurements over the field of the test image. The field is a line drawn from the center of the test image to the corner, with the image center being field=0 and the corner being field=1. All shading ROIs are mapped to the field along their radius.

This plot shows the Visual Noise in the shading ROIs over the field.

The “Contour” plot shows the uniformity over the columns and rows of the ROIs as an interpolated color-coded image. The contour lines are automatically fitted between the “minimum value” and “maximum value,” these can be changed under “Visualization.” The scaling of the color coding can be changed in the “Visualization” settings.

The “3D Plot” shows the uniformity over the columns and rows of the ROIs as an interpolated color-coded 3D rendering. The scaling of the color coding can be changed in the “Visualization” settings.

The “Color Ratio” plot shows the ratio of blue and red over the green channel and is, therefore, suitable to show color shading in the image.

  • “Shading - mean of patch” is based on the average ratio in a single patch.
  • “Shading - mean” is the average of all B/G and R/G ratios.
  • “Shading - max” is the maximum of all B/G and R/G ratios.

Numerical Results

Shading(f-stop): The maximum shading of luminance Y in f-stops.

Shading(%): The maximum (in percent) shading of luminance Y visible in the image. This value is calculated with Y as a weighted sum of R, G, and B, which is not affected by the linearization.

Shading[%] = {(Y_max-Y_min}/Y_max)*100

CIE Delta L: The absolute average shading of luminance based on CIE Delta L.

Delta L = L_max-L_min

CIE Delta Eab: CIE ∆Eab expresses the maximum color shading over the image field as the maximum color difference. It conforms to the Chrominance Non-Uniformity defined in ISO 17957:2015 and the Color Uniformity defined in IEEE P1858 Standard for Camera Phone Image Quality (CPIQ). In contrast to the ∆E calculation used for color reproduction, the calculation of ∆Eab is done without luminance L*. So you get information only about differences in colors, without luminance.

CIE Delta C: CIE ∆C is the maximum color shading related to a defined reference value.

R/G(DV): The average green and red channel ratio in digital values.

B/G(DV): The average ratio of a blue and green channel in digital values.

Delta SNR(dB): The maximum Delta of SNR over all ROIs.

Delta VN Set1-3: The maximum Delta of Visual Noise overall ROIs.

Distortion

Image distortion occurs when the straight lines of a scene appear to be deformed or curved unnaturally in an image. There are three types of lens distortion called barrel, pincushion, and waveform, also known as mustache distortion. It is important to know that distortion occurs differently depending on the lens system and whether the lens can or cannot be removed from the camera. The iQ-Analyzer-X uses test patterns, crosses, or points distributed over the entire image field with a known position. The center location of the crosses or points is detected with sub-pixel precision and referred to as the target position.

Graphical Results

The “Distortion” plot shows the Lens Geometric Distortion or Chromatic Aberration over the image field. The image field is the radial distance from the image center to the image corner, mapped from zero to one. A detected point in the corner has a value near one and a detected point in the center near zero.

The “2D plot” shows the Lens Geometric Distortion or Chromatic Aberration over the rows and columns of the detected grid, typically crosses, points, or black and white markers. The color shows the intensity of the Lens Geometric Distortion or Chromatic Aberration in percent. The color map is shown on the right side of the graph; adjust its limits in the settings under visualization.

The “Grid plot” shows the detected ROIs as red spheres versus a grid with the expected locations. The farther the sphere is off from its location in the grid, the higher the distortion.

The “Quiver” plot shows the distortion by a vector pointing to its direction.

Note: In the “Quiver” plots, the length of the arrows does not reflect absolute and comparable values but only the directions. The arrows are scaled so that they can be seen clearly, and they only reflect the relative distortion or CA values to each other.

The “Quiver CA” plot also shows vectors for the chromatic aberration of red and blue.

The “TV Distortion” plot shows the pixel coordinates of the markers used to calculate the TV distortion.

Numerical Results

Line Geometric Distortion (LGD) according to ISO 17850

LGD is defined as below.

Line GD Horizontal:

LineGD~h_i = (delim{|}{B_i-A_i}{|}/2*V)*100%

LineGD h: Line Geometric Distortion in the horizontal direction

A: Maximum height of the line grid pattern of the output image in pixels

B: Minimum height of the line grid pattern of the output image in pixels

V: Number of pixels of the short side of the frame of the output image

i: Suffix presenting each picture height

Line GD Vertical:

LineGD~v_i = (delim{|}{beta_i-alpha_i}{|}/2*V)*100%

LineGD v: Line Geometric Distortion in the vertical direction

α: Maximum width of the line grid pattern of the output image in pixels

β: Minimum width of the line grid pattern of the output image in pixels

V: Number of pixels of the short side of the frame of the output image

i: Suffix presenting each picture width

Line GD Total:

delim{|}{LineGD~total_i}{|} = sqrt{ (LineGD~v_i)^2+(LineGD~h_i)^2}


TV Distortion

The results of distortion calculation are shown as EBU-TV-Distortion and SMIA-TV-Distortion (SMIA = Standard Mobile Imaging Architecture). The SMIA definition has been widely adopted in the mobile imaging industry.

EBU(%): EBU TV distortion is the change of image height from the center to the edge of the image, expressed as a percentage of the actual height in the center.

EBU_TVDistortion = {Delta H}/H~*100

SMIA(%): SMIA defines distortion as the ratio of the absolute image height at the edges of the image to the image height in the center.

SMIA_TVDistortion = {A-B}/B~*100

A = {A_1+A_2}/2


Lens Geometric Distortion (LGD) according to IEEE P1858, similar to ISO 17850

LGD is defined as:

LGD = {H prime-H}/H~*100

H' = Actual dot distance from the center of the image

H = Expected dot position

The geometric distortion for a grid position is the delta between the radial distance of the actual grid position H' and the radial distance to the ideal grid position H, divided by the ideal grid position H.

For each detected point in the grid, the LGD is calculated.

H'< H indicates negative distortion → barrel distortion.

H'> H indicates positive distortion → pincushion distortion.

LGD mean: The average geometric lens distortion of all grid positions.

LGD worst: The maximum LGD of all grid positions.

LGD worst(fit): The worst LGD value fitted to a polynomial, which degree is defined in the “Distortion” settings.


Chromatic Aberration (CA)

CA G/R mean: The average pixel distance between the green and red channels.

CA G/R max: The mean value of the ten largest distances between green and red.

CA G/B mean: The average pixel distance between the green and blue channels.

CA G/B max: The mean value of the ten largest distances between green and blue.


Longitudinal Chromatic Aberration (LCA)

LCA Total: Mean value of the longitudinal chromatic aberration.

LCA Horizontal: Longitudinal chromatic aberration in the horizontal direction measured on the center cross (horizontal line of the cross).

LCA Vertical: Longitudinal chromatic aberration in the vertical direction measured on the center cross (the vertical line of the cross).

Export Results

The results can be exported as a *.xml or *.pdf file from the “File” menu. In the *.xml file, all numerical results will be saved. You can use this file to create your custom report. The *.pdf export provides basic layout adjustments and an option for which measurements will be included.

In the “General” tab under “Configuration,” a custom logo and your company name can be inserted to appear in the .pdf report.

Configure

General

Database configuration

Select the database that you want to use to save your data.

Local image root directory

This is the path where the images of your analysis are stored. You can choose a different folder by clicking “Browse…”.

Remote OBDC database connection

Is not available yet.

Database status

You can check the database status and reconnect it in case of any changes.

User Interface

“Disable high DPI scaling” prevents font and window sizes in iQ-Analyzer-X from being scaled excessively large on certain screen sizes/pixel resolutions and the set scale factor in Windows. With the “disable check mark,” you can disable this excessive scaling and save screen space.

Language

Set your preferred language here.

PDF Export

Set your company name and logo and include them in your exported *.pdf reports.

Log

Set the username that will appear in the log.

Dongle Configuration

Displays information about the local or network dongle currently in use.

Analysis Settings

In the “Analysis Settings” menu, you can define the measurements and parameters for your image analysis. The settings can be saved to the database to make a repeating application easy. To apply the settings to your analysis, you need to select them in advance in the input dock.

Analysis tab

In this tab, you can define the measurements carried out when you start an analysis. Please note that all measurements might not be available, depending on your chart.

Resolution tab

Three different methods for measuring resolution can be applied with iQ-Analyzer-X - Siemens star, slanted edge, and dead leaves. All of the methods have the same options for linearization.

Source: Depending on your chart, you can choose between local, global, and no linearization.

  • Local: The gray patches close to your measurement target are used. Example: In the TE268 (25 Siemens stars), each star is linearized with the local gray patches around each star.
  • Global: A single set of gray patches is used for linearization. For example, in a TE42V2 or the TE268 target, the OECF patches in the center are used.

Method:

  • Profile: If you choose “Profile,” the image will be linearized based on the color space of your image (e.g., sRGB).
  • The “OECF” setting takes the measured OECF into account.

OECF method:

  • Data range: The entire data range is used for the calculation (e.g., 0…255 for 8bit images)
  • Image range: The gray patches' minimum and maximum digital value is used.
  • Normalized image range: If black and white reference patches are available, these are used to normalize the modulation.
  • MTF: An older approach where the black value is subtracted from the image to achieve a de-facto normalization.

See this paper for details: https://www.image-engineering.de/library/conference-papers/862-linearization-and-normalization-in-spatial-frequency-response-measurement

Polynomial fitting: Defines the degree of the polynomial fitting curve for the OECF.

Siemens Star

Maximum frequency: You can choose what frequency iQ-Analyzer-X calculates the modulation. The value is provided as a percentage of the Nyquist frequency. So if the Nyquist frequency is 1000 LP/PH and you set the maximum frequency to 125%, iQ-Analyzer-X will analyze the radii that equal frequencies lower than 1250 LP/PH. The edge of the Siemens star defines the lower frequency limit.

Slanted Edge
  • Polynomial fitting: The degree of polynomial fit for linearization can be adjusted.
  • Max. Frequency: See Siemens star.
  • Edge Profile Source: You can choose between original or linearized data.
  • Color Channel: You can choose if the SFR for RGBY or only Y should be measured.
Dead Leaves

Analysis Method: You can choose between three different calculation methods for Dead Leaves - Core, Direct, and Cross. Cross is the recommended method as it is robust against noise's impact. Please refer to this paper on our website for more detailed information about the differences.

Derived values

Here you can specify the parameters you want to show in the results. These are values that are calculated based on an SFR.

OECF tab

Saturation definition

Variance: Saturation calculation is based on the variance of the DVs.

Dynamic range SNR threshold

The dynamic range is the difference between the illumination needed to reach saturation and the minimum illumination defined by a specified SNR value. The standard value for ISO 15739 is SNR = 1. This value may lead to problems due to signal processing and noise reduction, as an SNR of 1 is never reached, and thus, the threshold might be increased. We have good experience using a threshold of three, and a threshold change should be reported if deviating from the ISO standard.

Color tab

Color difference formula

The iQ-Analyzer-X calculates Delta E from two Lab data sets, the reference, and the image sample set. You can choose between CIE1976, CIE1994, and CIE2000 1:1:1 formula for calculating Delta E, with the most common being CIE1976. A more detailed description of the details is in the “Results” section.

White Point

You can choose if the white point required for transforming XYZ to Lab is taken from the camera profile or the image.

Relative patch size

You can limit the size of the analyzed patches if large patches cause trouble in the detection.

Offset correction
  • None: No correction of the data.
  • L*: Patch results are corrected by the offset in L* between the average of all patches for the reference and image data. This average will compensate for a general over/under exposure.
  • C*: Patch results are corrected by the offset in C* between the average of all patches for the reference and image data. This average will compensate for a general saturation increase (or decrease).
  • L* + C*: Both are applied.
Color space

Defines the color space applied for the measurement of Delta E. If your image contains a profile, you can apply it by choosing “Embedded Profile.”

Absolute color difference

Activate this check box if you want to get results with absolute values. Absolute values only represent the number of color differences but not the direction.

Shading tab

Normalization

“Brightest” sets the coordinates with the maximum luminance as a reference for normalization (reference = max. luminance = 0). This option makes sense if your brightest patch shows an offset to the image center due to misalignment of the lens to the sensor. “Center” applies to the center of the image for normalization (reference = center = 0).

Polynom fitting

“Polynom fitting” defines the polynomial degree that is fitted to the data.

Patch Size

“Patch Size” defines the size of the shading ROIs in pixels.

Patch distribution

“Patch distribution” defines the number of columns and rows of the shading measurements.

Distribution type

“Fixed Sizes” takes the “Patch Size” and the “Patch Distribution” value to generate the grid with the shading ROIs. “Seamless” creates a grid that leaves no empty spaces between the shading ROIs.

  • “Number columns” defines the number of columns of the seamless grid.
  • “Number rows” defines the number of rows of the seamless grid.
Margin (all four borders)

This value sets the size of a margin in pixels around the test image. Setting a margin makes sense if your image contains regions at the edge which you do not want to include in the shading measurement.

Note: As an ROI in the image center is required for shading measurements, only odd numbers are available for the rows and columns.

Distortion tab

In “Polynom fitting,” you can define the degree of the polynomial of the fitting algorithm for distortion calculation.

Viewing conditions tab

As the visual perception of noise depends on the viewing conditions, they need to be specified for the measurement of Visual Noise. You can either select “Fixed resolution and distance” or “Fixed height of output” for each condition.

Visualization

In this tab you can specify the color coding of the scaling bar in some of the result plots.

Color - Delta plots thresholds

For delta E, L, C, H and VN you can scale the color mapping for the graphical results. Either enter a relative limit in percent from the maximum (dark red) or an absolute value.

  • “Minimum Yellow” defines the lowest value which is still yellow.
  • “Maximum Yellow” defines the highest value which is still yellow.
  • “Maximum Red” defines the the highest value which is still red.
  • “Dark Red” defines the value from which the plot will be dark red.

Shading - Shading min/max values

Only the “Contour Plot” and the “3D Plot” are affected by these settings.

  • “Data” defines the parameter which you can change the minimum and maximum value for.
  • The “Minimum Value” is plotted blue.
  • The “Maximum Value” is plotted yellow.

The plots update as soon as the minimum or maximum value is changed.

Distortion - Display limits

  • “Maximum limit for geometric distortion (2D plot)” defines the maximum distortion value for the color map in the 2D plot.
  • “Maximum limit for chromatic aberration” defines the maximum value of chromatic aberration for the color map in the 2D plot.

Reference Files

For most of the image engineering charts either a reference file or measurement data will be provided. If you have only the measurement data, you need to create the reference file yourself. Please refer to “Creating and Editing Reference Files” for instructions.

The reference file contains luminance, density and/or color measurements of your chart. In this tab you can import the reference file and add it to the database. If you do not have a reference file for some reason you can also work with the provided example reference data, which is less accurate and not recommended. You can allocate the reference file to your chart before your analysis in the "Import" dialog. Note, that for UTT reference files an MS Excel Version needs to be installed on your computer.

Click on “Import” and select the reference file you want to import. In the upcoming dialog you can see information about file and edit the serial number and description by double-click on it.

A successful import shows the message below.

To review the reference files which have been already imported, select your chart in the dropdown menu. Note, that you can still edit the serial number and the description of the reference file by double-clicking on the according field. This makes it easier to assign the reference to an image in the import dialog.

Creating and Editing Reference Files

In some cases, you need to create the reference files yourself or update it with your own measurements.

Currently, there are two file formats for reference files which can be imported in iQ-Analyzer-X, Excel (.xlsx) and the proprietary format (.ref). The Excel format is exclusively for UTT and .ref for all other charts. If one of these files is provided with your chart, you can import them into the database without making any changes. Some of our charts are delivered with a .pdf acceptance protocol containing all measurements. In that case, you need to create the .ref file manually. Note, that the .ref file is in YAML format, which is a standard markup language.

To create or update a reference file you first need to make a copy of the according example reference file from the reference's folder.

C:\Program Files\Image Engineering\iQ-Analyzer-X 1.X.X\resources\references

Open the copied file and update it with the measurements of your chart. Depending on your chart, the reference file might contain color, density, luminance values or multiple metrics. Note, that it is important to keep the formatting of the file as it is, otherwise the software might not be able to read it. The best way to do that, is, to select the value you want to change and then type in the new value.

In addition to the color, density or luminance values, you can edit the following entries in the file header:

Name: The name of the container. A reference file can contain multiple container, which include all required information for a certain metric like OECF, Resolution, etc.

SerialNumber: Provide the serial of your chart. It makes it easier to find the according reference file during image import. You can still change the serial number in the “Reference Files” tab after it was imported.

FileType: FileType can be Color, Density or Luminance. In most cases, you do not need to change it. However, you may want to work with luminance instead of density or vice versa. In this case, change the value accordingly.

CreationDate: The creation date of this reference file. Be sure to keep the formatting.

ValidFor: The validity of this reference file in days. “CreationDate” and “ValidFor” provides the required information for iQ-Analyzer-X to calculate the expiration date of your reference data.

Description: Add a description. It makes it easier to find the according reference file during image import. You can still change the description in the “Reference Files” tab after it was imported.

All other entries in the header of the file must not be changed!

This is an example of an edited .ref file for a TE269 V2.

After editing your reference file, save it and import it into the database as explained above.

UTT

The UTT Version of iQ-Analyzer-X is designed to analyze the Universal Test Target (UTT) according to ISO 19264:2017 and Metamorfoze Guideline and provides an insight into the complete image quality of all types of high end cameras and scanners.

The UTT target is available in the DIN sizes A4 to A0. The formats A3 to A0 consist of tiles with the same layout. A3 is one tile, A2 consists of two tiles, A1 of four tiles and A0 of eight tiles. The A4 format has a slightly modified design, which has only two gray scales and one set of color patches.

ROIs on the UTT

Lines: The yellow marked areas are used to test for “dead lines” or banding that can occur during the scanning process.

Resolution: The nine red marked areas are used for resolution measurements with a slanted edge.

Gray Scales: The blue marked areas are the four gray scales used for tonal reproduction, white balance, gain modulation and noise measurement.

Color patches: The two black marked areas are used for color measurements.

Shading + Distortion: All white and gray boxes in the green marked background, which are fully visible and not hidden by a target, are taken into account for shading and distortion measurement.

Specification

The specification files define limits for acceptable results. The definition of the levels is based on different applications like, for example, Artwork, Unique Library, Non-Unique Library and others. iQ-Analyzer-X already contains several specifications as Metamorfoze and ISO19264 in different variations. Metamorfoze, Metamorfoze light and Metamorfoze extra light are the three levels defined in Metamorfoze Guideline. Metamorfoze is the strictest level, Metamorfoze extra light the one with the highest tolerances. For details, please also refer to Metamorfoze Preservation Imaging Guideline. ISO19264:2017 is present in Level A, B or C. For more information about the differences, please refer to the ISO Standard.

It is also an option to create your custom specification. To do so, copy the UTT Tolerance Sample from C:\Program Files\Image Engineering\iQ-Analyzer-X 1.X.X\resources\specifications to a local folder. Open the file as a .txt file in a common editor.

In the text file you can change the upper and lower limits as well as the upper and lower tolerance for each measurement. It is important that you do not change the format and spacing in the file. Best practice is to select the limit/tolerance value you want to edit and type in the desired one. In the example above, we changed the upper limit in Tonal Reproduction for Delta L* in patch 01 from 2 to 3.

The tolerance values provide an additional classification. For example, your device under test can be outside the specification but still in tolerance. The tolerance is displayed as a yellow area in the plots and results inside the tolerance but out of specification are marked yellow in the overview. If you do not want to add a tolerance, just assign the same values as for upper and lower limit. Please also change the current name and the description under “General” as this will be the information you see in the “Import” dialog. After editing the .txt file, save it and import it into the database in the “Specifications” tab under “Configure”. It is now available when you import your next UTT test image.

UTT Analysis

The UTT chart analysis works similar to the image quality analysis as described in section Image Quality Analysis, but there are some differences. The reference file for your chart, which contains the measurement data, is provided in .xlsx format and will be converted to a readable format for the software automatically during import into the database. For this conversion you need an installation of MS Excel or the MS Office on the PC. If you do not have the required software installed, please contact our technical support team. How to import the reference file, change serial number and description is described in section Reference Files. If you use an unmeasured chart please select the “Example from chart file” in the “UTT Import” dialog.

Additionally to the reference file of your chart, you need to select a specifications file, which contains the specification you want to apply. Some specifications are already provided. If you want to add a specification to the database, open the “Configure” dialog and select the “Specifications” tab. Click “Import” and select the desired specification file.

The specification file is now saved in the database and can be allocated in the “UTT Import” dialog.

To start an UTT analysis, click on “New UTT Analysis”, which opens the “UTT Import” dialog.

In the “UTT Import” dialog you can define the chart, specification, reference, color profile and the rotation of the image. Note, that there is no autodetect for the chart layout and you need to assign it

After the import, you can run the analysis as described in section Analyze Images.

Note, that for a proper detection, the UTT chart has either to be cropped exactly or the environment has to be nearly homogeneous. Most suitable is a homogeneous white, gray or black background.

UTT Results

After the UTT Analysis is finished, the results and an overview are provided. This overview contains a classification of the analyzed parameters like Tonal Reproduction, Noise, Color, Resolution, Shading, Distortion, Lines, based on the applied specifications.

The result is out of the limits that are specified in the selected specification (Metamorfoze, ISO 19264, …)

The result is within the limits that are specified in the selected specification (Metamorfoze, ISO Level A, …)

The result is out of specification but within tolerance

The numerical results are displayed in the UTT Results tab. Results within the specification are white, results outside the specification are red, and results to which the specification is not applied are grayed out.

Resolution

Resolution is measured on the slanted edges of the UTT Chart. The slanted edges of the tiles have the following naming.

All graphs except SFR show a green area, which illustrates the specification limits. If the bars are in the green area they are within specification. Bars out of specification are highlighted in red.

Graphical Results

The MTF 10 and MTF 50 plots shows the results for each slanted edge.The percentage on the y-axis represents the percentage of the Nyquist Frequency, which is the maximum frequency the device under test can properly capture. The Nyquist Frequency depends on the pixel resolution of your device. If the bar is not in the green area, meaning the specification, it changes its color to red. A bar can represent the average of the horizontal, vertical or both edges.

The Sampling Efficiency is the ratio of the limiting resolution, MTF10, and the Nyquist Frequency. If the MTF 10, the spatial frequency at 10% modulation, equals the Nyquist Frequency, the Sampling Efficiency ist 100%.

The Max Modulation equals one in an unsharpened image. If sharpening is applied in the image processing of your device, the modulation might be higher. However, it should not exceed the limit defined in the specification.

Color Misregistration is the shift of the color channels to each other in px. It might be visible in the scan causing a colored slanted edge. The bars in the graph show the highest Misregistration for either the horizontal, the vertical or all edges.

The SFR tab shows all the SFR curves obtained from the slanted edges. In the advanced graph settings, which you can access by clicking the key symbol, you can group the curves to get a better overview.

Numerical Results

MTF10: The ratio of the spatial frequency with a modulation greater or equal 10% to the Nyquist Frequency in percent.

MTF50: The ratio of the spatial frequency with a modulation greater or equal 50% to the Nyquist Frequency in percent.

Min_Sampling_Efficiency: If the limiting frequency at 10% modulation equals Nyquist frequency, the sampling efficiency ist 100%. The Min_Sampling_Efficiency reflects the lowest Sampling Efficiency of the horizontal, the vertical or all edges.

Max_Modulation: Max_Modulation should be 1 for an unsharpened image. If sharpening is applied in the image processing the modulation might be higher. It should not exceed the limit defined in the specification.

Max_MisRegistration: Color Misregistration is the shift of color channels to each other in px. All four edges of a slanted edge patch are analyzed and the maximum value is taken as result.

Color

For the Color Results please refer to the chapter color.

Shading

Shading describes the loss of intensity relative to a specified referrence in the image. It is measured in all white and gray boxes which are completely present and can be detected by the software. In the image below, the detected boxes are marked with a red or blue edge. As you can see some of the targets cover the boxes and thus prevent them from beeing detected.

Shading is calculated as the Delta L* in deviation from the mean Delta L* for each box and for white and gray boxes separately.

Delta L = L - L_average

Graphical Results

The contour plot shows the Delta L* of the white or the gray boxes of the grid in the UTT chart. X(ROI rows) and Y(ROI columns) represent the rows and columns of the grid, the color indicates the value of the deviation in Delta L*, which can be positive or negative. No deviation is shown in the color gray.

The 3D plot shows the Delta L* of the white or the gray boxes of the grid in the UTT chart in a three dimensional view.

Numerical Results

Max_Delta_Gray is the maximum deviation in Delta L* of all gray boxes.

Max_Delta_White is the maximum deviation in Delta L* of all white boxes.

Distortion

Distortion is, like shading, measured based on all white and gray boxes which are completely present and can be detected.

The inbetween distance of the horizontal and the vertical lines is measured in each box (Dist). From there the average distance of all horizontal and all vertical lines of the boxes is determined with sub-pixel accuracy (Dist_mean). The distortion is then calculated as the ratio of the distance of each line to the mean distance in percent.

Distortion[%] = 100* ({Dist - Dist_mean}/ Dist_mean)

Graphical Results

The plot shows the distortion in a color coded image. The scaling of the color coding can be adjusted in the “Visualization” tab in the “Configuration” dialog. The rows and columns on the Y- and X-Axis represent the white and gray boxes. Note, that only for boxes, which are completly visible, a distortion value can be obtained.

Numerical Results

Max_Distortion: Max_Distortion is the highest distortion found in all measurements.

Tonal Reproduction

The Tonal Reproduction is measured on the four gray scales in the chart and can also be referred to as the opto-electronic conversion function. It describes the response of the device under test to the input signal. To achieve an accurate reproduction, the L* values of the sample should be as close as possible to the L* values of the reference.

Graphical Results

The plot displays the tonal reproduction of the gray scales in L* of the sample over L* of the reference. The tile and its four gray scales can be selected by using the dropdown menus. The tolerance range, which is defined in the specifications, is displayed in green. Values that are outside the tolerance range are circled in red.

Numerical Results

Delta_C: The Delta C in between the sample and the reference of a certain gray patch.

Delta_E: The Delta E in between the sample and the reference of a certain gray patch.

Lab_L: L* value of the sample.

Additional information regarding L*a*b*, LCh, Delta E, Delta L, Delta C, Delta H: If you express the L*a*b* color space in polar coordinates you get the LCh space, where L is the luminance, C the chrominance (saturation) and H the hue (color tone). For each of these coordinates a delta can be determined. The calculation method is defined in the specifications.

White Balance

White balancing is the adjustment of the color channel gains or image processing to achieve a visually neutral reproduction of the input image. It is measured as Delta C between sample and reference on the gray scales on the UTT chart.

This plot shows the adjustment to keep the gray scale neutral. It shows Delta C over L* of the gray scales. At best Delta C is 0. The tolerance range, that is defined in the specifications, is displayed in green. Values that are outside the tolerance range are outlined with a red circle.

Gain Modulation

Gain Modulation describes the reproduction of the tone values of the sample compared to the reference and is measured on the gray scales. If, between two gray patches, Delta L* of sample and reference is equal, the Gain Modulation equals 100%, meaning there is no modulation. A common example for Gain Modulation is an applied gamma curve.

Example:

UTT L* a* b* Delta L Delta E
Sample gray patch 1 92.59 -0.88 -0.12
Sample gray patch 2 89.82 -0.74 0.82 2.77 2.93
Reference gray patch 1 95 0 0
Reference gray patch 2 92 0 0 3 3

Gain Modulation based on Delta L* is: 2.77 / 3.00 = 0.92 → 92% (OK)

Gain Modulation based on Delta E is: 2.93 / 3.00 = 0.98 → 98% (OK)

Graphical Results

The plot shows the gain modulation based on Delta E or Delta L*. The tolerance range, that is defined in the specifications, is displayed in green. Values that are outside the tolerance range are outlined with a red circle.

Numerical Results

Gain_Modulation_E: Gain Modulation based on Delta E.

Gain_Modulation_L: Gain Modulation based on Delta L.

Noise

Noise is the degradation of a captured image caused by disturbances that have no relation to the actual image content, the image signal. It can be introduced to a system by the sensor, the quantization or the image processing. Noise is measured on the single steps of the gray scales. Which kind of Noise is measured depends on the specification you apply. In case of the Metamorfoze specification, Noise equals the standard deviation of L* of the sample. ISO19264:2017 contains Noise as “Visual Noise” which takes into acount the Contrast Sensitivity Function and thus the human perception of Noise. For a proper noise measurement its important that the gray scales are free from dust, dirt or scratches.

Graphical Results

This plot shows the Visual Noise over L* of the gray patches of the sample.

Numerical Results

STD_Dev_DV: This is the standard deviation of Y in digital values in a certain gray patch.

Visual_Noise: Visual Noise is described in ISO 15739 . It correlates much better with the human perception of noise than a common SNR measurement.

Lines

The Lines measurement is useful to identify unwanted stripe patterns or so called banding in an image. It is measured on the white, gray and black horizontal and vertical lines. Before the measurement these lines are corrected for shading.

The relative intensity of the white, black and gray lines at the upper-horizontal and left-vertical border of each tile over its position is shown in this plot. The specified tolerance is displayed in green and values out of specification are marked with a red circle.

Export of Results

You can either export the results as .xml file or as .pdf. If you select .pdf, choose “UTT Overview” as the template, if you only want to include the overview page in your report, choose “UTT Full” if you want to export the entire results.

The .xml file includes all measurements as numerical values.

UTT Settings

Depending on the standard you want to apply, you might need to change the UTT settings. For example, the Metamorfoze standards require CIE 1976 as the color difference formula and “Gain Modulation Expanded” has to be deactivated. For ISO19264 “Gain Modulation Expanded” has to be activated, and the color difference formula is CIE2000 SL1.

Standard Gain Modulation Expanded Color Difference Formula
ISO19264 on CIE2000 SL1
Metamorfoze off CIE 1976

Save SFR Curves

Activate this option to save all SFR curves to the database.

Color Difference Formula

Select the Color Difference Formula you want to apply for the calculation of Delta E, Delta L and other metrics. More details about the formulas are stated in the Color section.

Color Space

This setting only applies, if you have selected “Embedded profile” as color profile during image import, but the color profile could not be read. In that case, the selected color space is used for the analysis.

Gain Modulation Expanded

If selected, the L* spacing of two patches is used to calculate the gain modulation instead of a one-step spacing.

Automation

Two options are available to automize the process of image quality analysis, “Hot folders” or “Command Line”. A “Hot Folder” is a folder in which you can copy your test images to process them. All images in the folder are queued and then processed using the analysis settings you set for the folder. Use “Command Line” in the Windows Command Line Interface(CLI) to execute specific commands. A more convenient way to use command lines is to create a batch file. iQ-Analyzer-X provides a dialog to generate a simple batch file so that you do not need to start from scratch.

Hot Folders

To create a “Hot Folder” go to the “Automation” tab in the “Configuration” dialog. Click on the “Settings” tab to show a list of the “Observed folders” and their settings.

You can add and remove folders from the “Observed folders” list in the “Settings” tab. Each folder can have its individual configuration. For example, one folder could be for TE269 analysis and another one for TE42LL, each with different analysis settings. To change the configuration of a folder, select it in the list. The selected folder will be highlighted. Note that you must first select an “Output” option to make further settings. You can choose between “Export XML”, “Export PDF” and “Save analysis automatically” as an output. “Save analysis automatically” saves the analysis in the connected database. All required settings are available once the checkbox is activated.

Provide information about the test images in the “Meta data” section.

This information is used to save the analysis into the database or to name the PDF/XML file. Provide as much information as possible will help you find the analysis later in the database. Note that you do not need to enter a real manufacturer or device model. You can also come up with names that fit your concept. If you check “Choose the above parameters from EXIF whenever possible”, the software uses EXIF data if available. If your test images contain a UTT chart, activate the UTT checkbox, to make the UTT settings available.

If all required information is provided, change to the “Activity log” or “Jobs” tab to activate the “Hot folder” with the “Activate” button.

Once the hot folder is activated, all images copied here are analyzed subsequently. The results are saved either into your database if you have selected “Save analysis automatically” or in a subfolder called “output” if you selected “Export XML” or “Export PDF”. While the hot folder is activated, the main window of the software disappears and reappears as soon as it is deactivated. For convenience, it is also possible to activate the “Hot folders” directly at start up of iQ-Analyzer-X by activating the according checkbox.

The next start of the software, only the “Automation” tab shows up and the “Hot folder” is active straight away. Deactivate the “Hot Folder” to close the software after you finished.

If you have plenty of images to process, we recommend zipping the image files first. Copy this zip file to the hot folder to process all images in the container.

Command Line

Create a batch file

The advantage of creating a batch file is, that you can process multiple commands with a simple double-click. In the “Command Line” tab under “Automation” you can create a batch file, which you can use to develop more complex procedures. The batch file can be edited with a normal text editor. Note, that the all commands need to be in the same row to be processed properly.

First load an example image, which is similar to the ones you want to process. Then enter all required information in the “Output” and “Available settings” section and in the “Analysis Information” and the “Image Information” tab. If you are done, click on “Create batch file”. You can now save the file in your desired location.

The commands in the list below are available to extend the functionality of your batch file. You can either use the regular command with ”- -“ or a short command with a single ”-“ before it. Some commands, e.g. “reference”, require an ID as argument. The IDs are shown in brackets in the according dropdown menu entry of the command line tab.

Command Short command Available Arguments Description Example
chart c “TheChartname” The captured chart on all images
--chart="TE42_V2_16_9"
database “local”, “YourDatabaseName” The name of the database
--database="local"
manufacturer m “YourManufacturer” or “Unknown” The name of the camera manufacturer
--manufacturer="ExampleManufacturer"
model - “YourModel” The model of the camera
--model="ExampleModel"
name - “YourAnalysisName” The name of the analysis
--name="TE42LL_Lowlight_Test"
orientation o 0, 90, 180, 270 The image orientation of UTT charts in degrees
--orientation=180
pdf p “YourResultPDFPath+FileName” Export result as PDF file
--pdf="C:/Users/Documents/TE42v2_16_9_mobilephone4_Report.pdf"
preferExif i - Prefer EXIF meta data for analysis
--preferExif
profile l “Embedded profile”, “Adobe RGB”, “sRGB”, “ECI RGB V2”, “Display P3”, “BT.2020” The color profile of UTT charts
--profile="Adobe RGB"
reference r “YourReferenceID” The reference ID of a chart
--reference="5"
save v - Save analysis to database
--save
serial - “YourSerial” The serial number of the camera
--serial="123456"
settingsID s settings ID as integer number Defines the settings set used for this analysis by it's ID
--settingsID=1
shortname v “YourShortName” The short name of the analysis
--shortname="ExampleShortname"
specification - “YourSpecificationID” The specification ID to be used with UTT charts
--specification="4"
template t “Default” Define the template for PDF export
--template="Default"
utt u - Make UTT analysis
--utt
xml x “YourResultXMLPath+FileName” Export result as XML file
--xml="C:/Users/User/Documents/Images/TE42v2_16_9_mobilephone4_Results.xml"

Example Batch Files

This is a simple batch file created with iQ-Analyzer-X which runs an analysis on a .jpg image of a TE42V2 and saves a .xml and .pdf file with the results. Note, that the path to iQ-Analyzer-X.exe and the path to the image need to be in the same row.

"C:/Program Files/Image Engineering/iQ-Analyzer-X 1.5.0/iQ-Analyzer-X.exe" "C:/Users/User/Documents/TE42/TE42v2_16_9_mobilephone4.jpg" 
--settingsID=1 
--reference="7" 
--template="Default" 
--chart="TE42_V2_16_9" 
--xml="C:/Users/User/Documents/TE42/TE42v2_16_9_mobilephone4.xml" 
--pdf="C:/Users/User/Documents/TE42/TE42v2_16_9_mobilephone4.pdf"
--manufacturer="ExampleManufacturer" 
--model="ExampleModel" 
--name="ExampleName" 
--serial="ExampleSerial" 
--shortname="ExampleShortname" 
--preferExif

This is a batch file which runs an analysis on multiple .jpg images of a TE42V2 and saves a .xml and .pdf file with the results.

"I:/iQ-Analyzer-NG/iQ-Anaylzer-src/iQ-AnalyzerNG/Analyzer_GUI/release/iQ-Analyzer-X.exe" 
"C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.JPG"
"C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.JPG" 
"C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.JPG" 
"C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.JPG" 
"C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.JPG" 
"C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.JPG" 
"C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.JPG" 
"C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.JPG" 
"C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.JPG" 
"C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.JPG" 
"C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.JPG" 
"C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.JPG" 

--settingsID=1
--settingsID=2 
--settingsID=3 
--settingsID=2 
--settingsID=2 
--settingsID=1 
--settingsID=3 
--settingsID=4 
--settingsID=2 
--settingsID=1 
 
--reference="-1" 
--template="Default" 
--xml="C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.xml" 
--pdf="C:/Users/User/Documents/IE/iQ-Analyzer Bilder/TE42/canm200_te42v2_iso1600.pdf"
--manufacturer="Canon" 
--model="EOS 200D" 
--name="canm200_te42v2_iso1600.JPG" 
--serial="56786543" 
--shortname="Automationtest" 
--preferExif 

When you double-click the batch file, a notification will appear shortly, that iQ-Analyzer-X is starting from the command line. Both iQ-Analyzer-X and the CLI start now. You can observe the processing of the images in the iQ-Analyzer-X window. When the analysis is finished, the CLI and the iQ-Analyzer X window close automatically.

Abbreviations

DV - Digital Value

LCA - Longitudinal Chromatic Aberration

LGD - Lens Geometric Distortion

MTF - Modulation Transfer Function

OECF - Opto Electronic Conversion Function

ROI - Region of Interest

SFR - Spatial Frequency Response

SNR - Signal-to-Noise Ratio

Troubleshooting

In case of any technical issues please contact the image engineering support.

Phone
+49 2273 99 99 1-60
Email
support@image-engineering.de

Please remember to provide your version number. If you are having trouble analysing an image it would be great if you can also send the concerned image along with the iQ-Analyzer.log file. The file is located here:

C:\Users\YourUserName\AppData\Roaming\Image Engineering\iQ-Analyzer-X

Thanks for your help!

Regulations

End user license agreement (EULA)

1 PREAMBLE

This Agreement governs the relationship between Licensee, a Business Entity, (hereinafter: Licensee) and Image Engineering GmbH & Co. KG, a duly registered company in whose principal place of business is Im Gleisdreieck 5, 50169 Kerpen-Horrem, Germany (hereinafter: Image Engineering). This Agreement sets the terms, rights, restrictions and obligations on using iQ-Analyzer-X (hereinafter: The Software) created and owned by Image Engineering, as detailed herein.

2 SOFTWARE PROTECTION

Image Engineering maintains its right to protect its intellectual property by using modern advances in software protection against un-authorized use and software piracy.

Along with The Software, Licensee of the professional version will receive a dongle that will serve as a security measure to enable Licensee’s use of The Software (hereinafter: Dongle). In order to use The Software, the Dongle must at all times while using the software remain connected to the hardware on which The Software is installed. Licensee acknowledges and agrees that The Software will not function properly if Dongle is removed from such hardware.

3 LICENSE GRANT

Image Engineering hereby grants Licensee a limited, non-assignable and non-sub licensable, perpetual, commercial, non-exclusive license, all in accordance with the terms set forth and other legal restrictions set forth in 3rd party software used while running the Software.

4 PERMITTED USES

4.1 INSTALLATION

Licensee may install and use the number of copies of The Software that Licensee has purchased or has been granted a license for. If The Software is protected by Dongle, Licensee may install unlimited number of copies of The Software but only use The Software on the hardware with the attached Dongle.

4.2 SERVER DEPLOYMENT

Licensee may install one copy of the professional version of The Software on an internal file server for purposes of downloading and installing The Software on licensed computers within the same internal network.

4.3 BACKUP AND ARCHIVAL COPIES

Licensee may make copies of the professional version of The Software solely for backup or archival purposes. Licensee agrees to maintain records of the location and use of each copy, in whole or in part. Each copy of The Software is copyrighted but unpublished by Image Engineering. Licensee agrees to reproduce and apply the copyright notice and proprietary notice of Image Engineering to all copies made hereunder, in whole or in part and in any form, of The Software.

4.4 PUBLISHING

Licensee may use and publish the output of The Software to 3rd parties.

5 PROHIBITED USES

5.1 REVERSE ENGINEERING

Licensee is not permitted to decompile, disassemble, reverse engineer, or otherwise attempt to derive the source code for any version of The Software.

5.2 TRANSFER TO A 3RD PARTY

Licensee is not permitted to rent, lease or redistribute The Software. Licensee may not provide or otherwise make available The Software or any copy in whole or in part, whether modified or unmodified, to any person other than employees of Licensee without the prior explicit written consent of Image Engineering.

6 PROPRIETARY RIGHTS

Licensee is not permitted to alter, remove or circumvent the intellectual property right notices on the software product including the documentation, particularly the copyright notices or trademarks. Licensee is permitted to share the information how and where to download The Software on Image Engineering’s website. But Licensee is not permitted to share the software with other people except those necessary to install the software on Licensee’s computer nor is he allowed to distribute the software in any way. Licensee recognizes that Image Engineering regards The Software as its proprietary information and as confidential trade secrets of great value. Licensee further agrees to treat the Licensed Programs with at least the same degree of care with which Licensee treats its own confidential information and in no event with less care than is reasonably required to protect the confidentiality of The Software.

7 TERM AND TERMINATION

7.1 TERM This License Agreement is effective upon installation of The Software and will continue in force until terminated.

7.2 TERMINATION

a) Licensee Right of Termination: Licensee may terminate the Agreement at any time by destroying all copies of The Software and in case of the professional version additionally the Dongle.

b) Image Engineering Right of Termination: Image Engineering may terminate this Agreement if Licensee violates any of the terms and conditions of this Agreement and fails to correct such violation within ten (10) days after receiving written notice thereof from Image Engineering.

c) Effect of Termination: In the event of termination, Licensee will immediately discontinue use of The Software. Within one (1) month after termination of this Agreement, Licensee will furnish a certificate to Image Engineering which certifies that, through its best effort and to the best of its knowledge, the original and all copies, in whole or in part and in any form, of The Software have been destroyed.

8 PAYMENT

In consideration of the License granted under clause 3 “License Grant”, Licensee shall pay Image Engineering a fee for the professional version of The Software, via any mean which Image Engineering may deem adequate. Failure to perform payment shall construe as material breach of this Agreement. License fees do not include any shipping, duties, bank fees, sales, use, excise or similar taxes due.

9 UPGRADES, UPDATES AND FIXES

Image Engineering may provide Licensee, from time to time, with Upgrades, Updates or Fixes, as detailed herein and according to his sole discretion. Licensee hereby warrants keeping The Software up-to-date and installing all relevant updates and fixes, and may, at his sole discretion, purchase upgrades, according to the rates set by Image Engineering. Nothing in this Agreement shall require Image Engineering to provide Updates or Fixes.

9.1 UPGRADE

For the purpose of this license, an Upgrade shall be a material amendment in The Software, which contains new features and or major performance improvements and shall be marked as a new version number. For example, should Licensee purchase The Software under version 1x.x, an upgrade shall commence under number 2.0.0.

9.2 UPDATE

For the purpose of this license, an update shall be a minor amendment in The Software, which may contain new features or minor improvements and shall be marked as a new sub-version number. For example, should Licensee purchase The Software under version 1.1.x, an upgrade shall commence under number 1.2.0.

9.3 FIX

For the purpose of this license, a fix shall be a minor amendment in The Software, intended to remove bugs or alter minor features which impair The Software's functionality. A fix shall be marked as a new sub-sub-version number. For example, should Licensee purchase The Software under version 1.1.1, an upgrade shall commence under number 1.1.2.

10 MAINTENANCE

By purchasing The Software, Licensee is granted a one-year standard membership in the Maintenance program (hereinafter: The Maintenance) at no extra charge. The Maintenance is not automatically extended. The optional extension of The Maintenance will involve additional costs. If the maintenance is not extended within three (3) months after the day of expiration, an additional re-entry fee of sixty percent (60%) of the maintenance costs is applied within the first twelve (12) months after the initial expiration date. Once the maintenance has been expired for over twelve (12) months, one hundred percent (100%) of the maintenance will be applied in addition to the maintenance costs. In the event that the maintenance has been expired over twenty-four (24) months, re-entry can only be offered if a new license of the iQ-Analyzer-X is purchased.

10.1 STANDARD MAINTENANCE

Standard Maintenance includes following privileges at no additional charge:

a) Upgrades of The Software according to clause 9.1 “Upgrade” (if The Maintenance has expired, upgrades of The Software must be purchased under the usual conditions without any discount)

b) Telephone Support

c) E-Mail support

d) Attendance at regularly offered webinars

e) Supply of chart layout and a reference data files for one (1) custom-made chart per year (the manufacturing of the chart may involve additional costs). The chart layout is considered as “final with no additional modifications required” if the Licensee can analyse a set of images that was provided to Image Engineering showing the custom made chart for the creation process. Image Engineering might refuse additional modifications or provide these modifications on a payed basis only after the status “final” was reached.

10.2 ADVANCED MAINTENANCE

Advanced Maintenance includes following privileges at no additional charge:

a) Upgrades of The Software according to clause 9.1 “Upgrade” (if The Maintenance has expired, upgrades of The Software must be purchased under the usual conditions without any discount)

b) Telephone Support

c) E-Mail support

d) Attendance at regularly offered webinars

e) Supply of chart layout and a reference data files for up to five (5) custom-made charts per year (the manufacturing of the charts may involve additional costs). The chart layout is considered as “final with no additional modifications required” if the Licensee can analyse a set of images that was provided to Image Engineering showing the custom made chart for the creation process. Image Engineering might refuse additional modifications or provide these modifications on a payed basis only after the status “final” was reached.

f) Supply of reference data for up to five (5) individually measured charts.

g) Two (2) days training course with Licensee specific content. Online training courses and training courses at Image Engineering’s office are provided at no additional charge. For training courses at Licensee’s location, all travel and accommodation expenses shall be borne by Licensee.

11 SUPPORT

The Software is provided with limited support. Image Engineering shall provide support via electronic mail and on regular business days and hours, German time.

11.1 BUG NOTIFICATION

Licensee may provide Image Engineering of details regarding any bug, defect or failure in The Software promptly and with no delay from such event. Licensee shall comply with Image Engineering's request for information regarding bugs, defects or failures and furnish him with information, screenshots and try to reproduce such bugs, defects or failures.

11.2 FEATURE REQUEST

Licensee may request additional features in The Software, provided, however, that

a) Licensee shall waive any claim or right in such feature should feature be developed by Image Engineering;

b) Licensee shall be prohibited from developing the feature, or disclose such feature request, or feature, to any 3rd party directly competing with Image Engineering or any 3rd party which may be, following the development of such feature, in direct competition with Image Engineering;

c) Licensee warrants that feature does not infringe any 3rd party patent, trademark, trade-secret or any other intellectual property right;

d) Licensee developed, envisioned or created the feature solely by himself.

Image Engineering will consider such feature requests for future versions and shall only be bound to the development of such feature in case of a written additional agreement between Liecensee and Image Engineering. Such an agremement may be subject to additional costs.

12 REPLACEMENT POLICY FOR DAMAGED, LOST AND STOLEN DONGLES

12.1 DEFECTIVE DONGLE (LICENSEE WITH CURRENT MAINTENANCE)

If a Dongle fails or becomes defective, it may be replaced as follows:

a) There are no fees for the replacement of a defective Dongle unless the defect is caused by force or careless or improper use of the Dongle.

b) Licensee shall return the defective Dongle to Image Engineering by registered mail as soon as possible, but not later than three (3) months after express written declaration of damage. Once the Dongle has been received by Image Engineering, a replacement Dongle will be issued with the corresponding license to authorize the software products that are covered under the current maintenance contract for the Dongle being replaced.

c) If Licensee fails to return the defective Dongle within the allotted time period, Image Engineering, in its sole discretion, may refuse the replacement.

12.2 DEFECTIVE DONGLE (LICENSEE WITH EXPIRED MAINTENANCE)

If a Dongle fails or becomes defective, it may be replaced as follows:

a) Licensee shall pay Image Engineering a fee of 200.00 EUR for the replacement of a defective Dongle.

b) Licensee shall contact Image Engineering for a sales quotation for a replacement Dongle. The sales quotation is to be used to generate a purchase order for the necessary amount plus any applicable costs, i.e. taxes and shipping. the purchase order or required form of payment

c) Licensee shall return the defective Dongle to Image Engineering by registered mail as soon as possible together with the purchase order or required form of payment. Once the Dongle and purchase order have been received by Image Engineering, a replacement Dongle will be issued with the corresponding license to authorize the software products that are covered under the current maintenance contract for the Dongle being replaced.

d) If Licensee fails to return the defective Dongle within the allotted time period, Image Engineering, in its sole discretion, may refuse the replacement.

12.3 LOST OR STOLEN DONGLE

If a Dongle is lost or stolen the following shall apply:

a) Licensee shall contact Image Engineering without undue delay to notify Image Engineering that the Dongle is no longer in its possession.

b) Licensee shall pay Image Engineering a penalty fee in the amount of ten (10) percent of the current list price of the lost or stolen license without any discount plus any applicable costs, i.e. taxes and shipping.

c) When Image Engineering receives the penalty fee payment, the replacement Dongle will be shipped to the Licensee.

d) If a Dongle reported as lost or stolen is found after the replacement Dongle has been shipped to Licensee, Licensee shall return it to Image Engineering without undue delay.

e) If a Dongle reported as lost or stolen is used again for any reason at any location, Licensee shall pay Image Engineering a penalty fee in the amount of two hundred (200) percent of the current list price of the license in use without any discount.

13 LIABILITY

The Software is provided under an “AS-IS” basis. Image Engineering shall never, and without any limit, be liable for any damage, cost, expense or any other payment (including, without limitation, incidental, direct, indirect, special or consequential damages, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) incurred by Licensee as a result of Software’s actions, failure, bugs and/or any other interaction between The Software and Licensee’s end-equipment, computers, other software or any 3rd party, end-equipment, computer or services. Moreover, Image Engineering shall never be liable for any defect in source code written by Licensee when relying on The Software.

14 WARRANTY

Considerable time, effort and expense have gone into the development of The Software, and it has been thoroughly tested and used. However, except as otherwise specifically provided herein, no warranty is made on its accuracy or reliability. It is the responsibility of the Licensee to verify the results obtained from The Software. In the event The Software is found to be defective, Image Engineering's only obligation is to remedy the defect. Image Engineering will in no event have obligations or liabilities for incidental or consequential damages associated with the use of The Software.

14.1 INTELLECTUAL PROPERTY

Image Engineering hereby warrants that The Software does not violate or infringe any 3rd party claims in regards to intellectual property, patents and/or trademarks and that to the best of its knowledge no legal action has been taken against it for any infringement or violation of any 3rd party intellectual property rights.

14.2 NO-WARRANTY

The Software is provided without any warranty. Image Engineering hereby disclaims any warranty that The Software shall be error free, without defects or code which may cause damage to Licensee’s computers or to Licensee, and that The Software shall be functional. Licensee shall be solely liable to any damage, defect or loss incurred as a result of operating The Software and undertake the risks contained in running The Software on Licensee’s computer system(s).

14.3 PRIOR INSPECTION

Licensee hereby states that he inspected The Software thoroughly and found it satisfactory and adequate to his needs, that it does not interfere with his regular operation and that it does meet the standards and scope of his computer systems and architecture. Licensee found that The Software interacts with his environment and that it does not infringe any of End User License Agreement of any software Licensee may use in performing his services. Licensee hereby waives any claims regarding The Software's incompatibility, performance, results and features, and warrants that he inspected The Software.

15 NO REFUNDS

Licensee warrants that he inspected The Software according to clause 14.3 “Prior Inspection” and that it is adequate to his needs. Accordingly, as The Software is intangible goods, Licensee shall not be, ever, entitled to any refund, rebate, compensation or restitution for any reason whatsoever, even if The Software contains material flaws.

16 INDEMNIFICATION

Licensee hereby warrants to hold Image Engineering harmless and indemnify Image Engineering for any lawsuit brought against it in regards to Licensee’s use of The Software in means that violate, breach or otherwise circumvent this license, Image Engineering's intellectual property rights or Image Engineering's title in The Software. Image Engineering shall promptly notify Licensee in case of such legal action and request Licensee’s consent prior to any settlement in relation to such lawsuit or claim.

17 GOVERNING LAW, JURISDICTION

Licensee hereby agrees not to initiate class-action lawsuits against Image Engineering in relation to this license and to compensate Image Engineering for any legal fees, cost or attorney fees should any claim brought by Licensee against Image Engineering be denied, in part or in full. The governing law for this agreement shall be the law of Germany with the place of jurisdiction being Cologne, Germany.

18 SEVERABILITY

If any provision or provisions of this Agreement shall be held to be invalid, illegal, unenforceable or in conflict with the law of any jurisdiction, the validity, legality and enforceability of the remaining provisions shall not in any way be affected or impaired thereby.

Trademarks

Microsoft® and Windows® are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.

Third party tools

The iQ-Analyzer-X uses open source as well as commercial software and libraries.


Armadillo
Armadillo C++ Linear Algebra Library is licensed under the Apache License 2.0
Copyright 2008-2020 Conrad Sanderson
Copyright 2008-2016 National ICT Australia (NICTA)
Copyright 2017-2020 Arroyo Consortium
Copyright 2017-2020 Data61, CSIRO
This product includes software developed by Conrad Sanderson
This product includes software developed at National ICT Australia (NICTA)
This product includes software developed at Arroyo Consortium
This product includes software developed at Data61, CSIRO


Dlib
Boost Software License - Version 1.0 - August 17th, 2003
Permission is hereby granted, free of charge, to any person or organization obtaining a copy of the software and accompanying documentation covered by this license (the “Software”) to use, reproduce, display, distribute, execute, and transmit the Software, and to prepare derivative works of the Software, and to permit third-parties to whom the Software is furnished to do so, all subject to the following:

The copyright notices in the Software and this entire statement, including the above license grant, this restriction and the following disclaimer, must be included in all copies of the Software, in whole or in part, and all derivative works of the Software, unless such copies or derivative works are solely in the form of machine-executable object code generated by a source language processor.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


dcraw
Copyright © 1997-2015 by Dave Coffin
This is free software. Web site of the author: http://www.dechifro.org/index.html
The documentation can be found here: http://www.dechifro.org/dcraw/dcraw.1.html


ExifTool
Copyright © 2003-2020 by Phil Harvey
This is free software. It is licensed under the same terms as Perl itself: https://dev.perl.org/licenses
The documentation can be found here: https://exiftool.org
You can download the complete source code here: https://github.com/exiftool/exiftool


libexif
The libexif C EXIF library
Is licensed under the GNU LESSER GENERAL PUBLIC LICENSE Version 2.1 (LGPL).


Little CMS
Little CMS Open Source Color Engine
License: MIT License
To the question, Is this software really free? as long as you abide by the licensing conditions, yes. It is free under the MIT license agreement. You can use Little CMS in your commercial apps, too. The license requires a pointer referencing the copyright, so you can add a file in your distribution disk saying that your product uses Little CMS, and the copyright notice. That’s all. Of course, if you use the package and can improve on it, then your contribution will be welcome, but please note this is not required. However, you should consider the maintenance overhead of keeping your own custom version of Little CMS, versus the advantages you might get from participating in the community, such as bugfixes and extensions that others may make on top of yours.


OpenCV
License Agreement For Open Source Computer Vision Library (3-clause BSD License)

Copyright (C) 2000-2020, Intel Corporation, all rights reserved.
Copyright (C) 2009-2011, Willow Garage Inc., all rights reserved.
Copyright (C) 2009-2016, NVIDIA Corporation, all rights reserved.
Copyright (C) 2010-2013, Advanced Micro Devices, Inc., all rights reserved.
Copyright (C) 2015-2016, OpenCV Foundation, all rights reserved.
Copyright (C) 2015-2016, Itseez Inc., all rights reserved.
Copyright (C) 2019-2020, Xperience AI, all rights reserved.
Third party copyrights are property of their respective owners.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  • Neither the names of the copyright holders nor the names of the contributors may be used to endorse or promote products derived from this software without specific prior written permission.

This software is provided by the copyright holders and contributors “as is” and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall copyright holders or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.


QsLog
Copyright © 2014, Razvan Petru
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  • The name of the contributors may not be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
The source code is available here:
https://github.com/victronenergy/QsLog


Qt
The Qt framework is licensed under the commercial Qt license.


Qwt
The Qwt library contains GUI Components and utility classes which are primarily useful for programs with a technical background. Beside a framework for 2D plots it provides scales, sliders, dials, compasses, thermometers, wheels and knobs to control or display values, arrays, or ranges of type double.
Qwt is distributed under the terms of the Qwt License, Version 1.0.


QwtPolar
The QwtPolar library contains classes for displaying values on a polar coordinate system.
QwtPolar is distributed under the terms of the Qwt License, Version 1.0.


TensorFlow
C API for TensorFlow.
Licensed under the Apache License, Version 2.0


en/iq-analyzerx/product_manual.txt · Last modified: 2022/08/17 07:29 by kelbers