# RawAnalyser

> Python tool for raw image analysis: clipping, gamma, vignette, and Bayer pixel inspection.

- HTML page: https://antoineboucher.info/CV/blog/projects/rawanalyser/
- Language: en
- Translation (fr): https://antoineboucher.info/CV/blog/fr/projects/rawanalyser/index.md
- Published: 2021-09-06
- Updated: 2021-09-06
- Author: Antoine Boucher (https://antoineboucher.info/CV/index-en.html)[here](https://github.com/antoinebou12/RawAnalyser)

# RawAnalyser
RawAnalyser is a Python tool for analyzing raw images: black and white clipping detection, gamma calculation, and flatness with vignette detection (Algolux).

## Prerequisites
You need to have Python 2.7 installed and the following libraries:
- json
- time
- numpy
- scipy
- pyqt5
- argparse
- argcomplete
- watchdog
- logging
- colorama
- plotly
- matplotlib

## Usage
1. Run the RawAnalyser script: 
```bash
python RawAnalyser.py <pathfolder> <pointfile> --func <clipping,gamma,vignette,histogram,noHist,basic, default all> --bl <black level, default 1024> --vignette <pathvignette>
```
2. Start the GUI:
```bash
python GUI.py
```
3. Check the value of the pixel and the color with the bayer pattern:
```bash
python RawPixel.pt input<file> x y  --bitdepth <8,10,16,default 16>
```

## Scripts Description

### RawAnalyser.py
Checks black and white clipping levels in a raw image. Takes a folder path and a JSON file with the region of interest and gray patches.

#### points.json
The JSON file specifying the region of interest. An example of its structure is as follows:
```json
{
    "last_y": 798,
    "last_x": 1353,
    "gray_first_y": 691,
    "gray_first_x": 606,
    "first_x": 603,
    "first_y": 315,
    "gray_last_x": 1347,
    "gray_last_y": 795
}
```

### GUI.py
A GUI script for image selection. It allows you to select the region of interest and the gray patches in a raw or TIFF file, which are then saved in a JSON file. It also constantly checks for new files in the raw folder.

### RawPixel.py
A script to inspect the value of a specific pixel and determine its color using the Bayer pattern.

### 20MPto5MP.py
Converts 20-megapixel images to 5-megapixel images for the OV20880 sensor.

#### Camera
Example of camera sensor information:

```text
Camera: OV2740
Resolution: (1088, 1928)
ImageType: BINARY16U
Sensor value: 10 bit
Bayer pattern: 'bggr'
```