This is the reference implementation for the EMVA1288 Standard for Measurement and Presentation of Specifications for Machine Vision Sensors and Cameras.

Please visit Emva1288 Website for information and latest releases of the standard.

To use the emva1288 package you need to have installed

• numpy
• opencv
• matplotlib
• lxml

For inexperienced windows users it is recommended to use a prepackaged python distribution that contains the required packages. One excellent option for Windows users is Python (x, y)

For the time being there is no installer for the package. Just copy the full repository and add it's path to your PYTHONPATH environment variable

The code is dvidided in 7 parts

This class takes an EMVA1288 descriptor file and loads its content into a python dictionary.

An EMVA1288 descriptor file is a file that contains the description of an EMVA1288 test including exposure times, photon count and corresponding images

An example of a descriptor file can be found at examples/EMVA1288_Descriptor_File.txt

This class takes a dictionary (product of parser.ParseEmvaDescriptorFile). Load the related images and reduce it's data to the minimum possible, preserving all relevant image data in as integers

This class takes a dictionary with image data (product of loader.LoadImageData), and transforms it into data that can be used for the EMVA1288 computations. It is important to note, that this is separate from LoadImageData because this step, produces float values that are not easily transportable (db, json, etc...) without loosing accuracy.

This class takes the data from data.Data1288 and compute the actual EMVA1288 values.

This class takes a results.Results1288 object and produces all the plots needed to create a reference datasheet of the EMVA1288 test

To use the code, you need to have a set of images that correspond to an EMVA1288 test. There are some sample image sets provided by the standard development group. Example datasets.

Download one or all of these datasets, extract its content, and use it as in the example shown below.

A simple example to obtain EMVA1288 results from a dataset is

import os
from emva1288 import parser, loader, data, results, plotting

dir_ = '/home/work/1288/datasets/'
fname = 'EMVA1288_ReferenceSet_001_CCD_12Bit/EMVA1288_Data.txt'

info = parser.ParseEmvaDescriptorFile(os.path.join(dir_, fname))
imgs = loader.LoadImageData(info.info)
dat = data.Data1288(imgs.data)
res = results.Results1288(dat.data)
res.results()
plot = plotting.Plotting1288(res)
plot.plot()
plot.show()