# Scan Tab

Process measurements from MAPIR light sensors

<figure><img src="/files/2UGjg4bLdznTUfh4fmG6" alt=""><figcaption></figcaption></figure>

## Opening Measurement Data <a href="#opening-measurement-data" id="opening-measurement-data"></a>

<figure><img src="/files/azxTWMC6b38EhI9Bsbi7" alt=""><figcaption></figcaption></figure>

Select an input folder containing csv files from the DAQ-M. You can provide any number of csv files, either unedited irradiance (raw) or processed measurements containing irradiance + reflectance data.&#x20;

{% hint style="info" %}
Only measurements with unique "File Name" rows will be available in the Scan tab. The File Name is how you identify the measurement in MCC. You can easily edit the csv files if you want to duplicate or edit the measurement names.&#x20;

If duplicate measurement File Name rows exist in the input folder then the last read measurement, and the one that contains irradiance + reflectance will be the one available.
{% endhint %}

When the data is finished loading the first measurement is displayed on the graph.

<figure><img src="/files/xVGbnh5MVh1RDCUioNZU" alt="" width="563"><figcaption></figcaption></figure>

Read further below on how to add multiple layers (scan measurements or filter bars), enable Reflectance mode and add markers to the reflectance signatures.

<figure><img src="/files/CXjrKdqSfNEB7GdJEij9" alt="" width="563"><figcaption></figcaption></figure>

## Navigating Scan Tab Menu Buttons

Here is a table identifying the interactive buttons above the Scan tab graph area:

|                                                   Button Icon                                                  |              Button Name              |            Function           |
| :------------------------------------------------------------------------------------------------------------: | :-----------------------------------: | :---------------------------: |
| <div><figure><img src="/files/CrLEvKeY9eqWY9hkFvw8" alt="" width="54"><figcaption></figcaption></figure></div> |               Shift Left              |        Shift Graph Left       |
| <div><figure><img src="/files/0xIa9Rk14juKnC6Q8dEE" alt="" width="54"><figcaption></figcaption></figure></div> |              Shift Right              |       Shift Graph Right       |
| <div><figure><img src="/files/4SUIZpbShoNvRg8NQABL" alt="" width="56"><figcaption></figcaption></figure></div> |                Zoom Out               |         Zoom Graph Out        |
| <div><figure><img src="/files/sFQRJqAVKzbDczQX7Jhu" alt="" width="55"><figcaption></figcaption></figure></div> |                Zoom In                |         Zoom Graph In         |
| <div><figure><img src="/files/auYDQ1HBHZ48XcO7bpcI" alt="" width="53"><figcaption></figcaption></figure></div> |     [Line Markers](#line-markers)     |      Show Filter Averages     |
| <div><figure><img src="/files/lA02cQ1ifpYSrO70A50G" alt="" width="53"><figcaption></figcaption></figure></div> | [Reflectance Mode](#reflectance-mode) | Toggle Irradiance/Reflectance |
| <div><figure><img src="/files/kqjApqam6zgvvhGac3OM" alt="" width="54"><figcaption></figcaption></figure></div> |   [Layers](#adjusting-graph-layers)   |       Show Layers Window      |
| <div><figure><img src="/files/3gFOpJzQq5roPih0NBh3" alt="" width="51"><figcaption></figcaption></figure></div> |       [Index](#index-ndvi-table)      |       Show Index Window       |
| <div><figure><img src="/files/l88fgjNeqFmlFTqUWhke" alt="" width="49"><figcaption></figcaption></figure></div> |     [Save](#exporting-saving-data)    |       Save Visible Data       |

## Adjusting Graph Layers

When scan data is opened the first measurement is added to the graph. To open the graph layers window click the Layers button. A new small window will open. You can add more layers as desired:

<figure><img src="/files/WkgbAKh9qi7viBQaJU6s" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/tFwQqo3mtGmPIOhPJ7ci" alt="" width="563"><figcaption></figcaption></figure>

### Title:

Enter a custom title here which will be added to the top of the graph. The title will also be used in naming the exported data when saved.

### Add Layer Button

Click the (+) Add Layer button to add a new layer to the layer panel below.

### Layer Panel

The lower region of the window shows the current layers that exist, each represented by a row of buttons and drop-down options.

<figure><img src="/files/Gqe0cpSDDzCqT8edfin1" alt=""><figcaption></figcaption></figure>

### Layer Number

The layer number in the panel

### Layer Visible Button

Toggle the eyeball visibility button to hide/show the layer on the graph.

### Layer Type Drop-down

Choose the type of data to display:

* Scan: a light sensor measurement from the input data
* Filters:  the transmission bands for the Survey3 filter options

### Layer Type Name Drop-down

The options in the second drop-down depend on the layer type:

* Scan: the File Name from the input measurement data
* Filters: the name of the Survey3 camera filter

### Layer Configuration Window Button

Opens the [Layer Configuration Window](#layer-configuration-window)

### X Close Button

Deletes the layer and removes it from the graph and table

## Layer Configuration Window

<figure><img src="/files/wWHpgJYAtsiEG7VqrZzA" alt="" width="375"><figcaption></figcaption></figure>

### Line Color

The background color in the large line color button matches the color used for the plotted line on the graph. Clicking the large colored button brings up the color picking window. Select a color and the Ok button to update the line color.

### Layer Reflectance Button

Toggle the layer reflectance button to apply reflectance correction to the irradiance measurement data.

### Reflectance Target Model

Choose which model the scanned reference reflectance target was that you used.

### Reflectance Scan Name

Choose the File Name for the measurement of the reflectance target. If the input data contained reflectance data that you want to use then chose the \[FROM FILE] option in the reflectance scan name drop-down.

## Shifting and Zooming on the Graph

Once data is plotted on the graph you can zoom in and out and the graph axis and view will adjust accordingly. Once zoomed in you can use the left/right arrows to shift the graph from side to side.

<figure><img src="/files/hpAzqSJtsjBv74SteRVp" alt="" width="563"><figcaption></figcaption></figure>

## Line Markers

The line marker button places dots on every plotted measurement line. The dots are located within each of the Survey3 filter transmission bands. The dot represents the weighted average peak of the filter's transmission of light in that region of the spectrum. These marker locations more closely represent the average pixel intensity (irradiance/reflectance) of each image channel.

<figure><img src="/files/DHHUHXa2WOKnFWx6iyoG" alt="" width="563"><figcaption></figcaption></figure>

## Reflectance Mode

Toggle the Reflectance Mode light bulb button from grey (disabled) to green (reflectance on, enabled) to red (reflectance off, disabled). When reflectance mode is off, the default irradiance mode is enabled.

<figure><img src="/files/OAOpImXV42Wh7pvB4xrH" alt="" width="563"><figcaption></figcaption></figure>

## Index (NDVI) Table

When the main graph's [reflectance mode](#reflectance-mode) is on, any visible measurement that has its own reflectance applied will also show up in the Scan Index table.

<figure><img src="/files/6erCmZ8YxCTPBfhjCrYX" alt="" width="563"><figcaption></figcaption></figure>

The Index Table processes each measurement scan at the weighted average locations shown by the [line markers](#line-markers). The marker data points are used in [24 index formulas](/mapir-camera-control-mcc/multispectral-index-formulas.md) and the computed values are shown in the table.&#x20;

<figure><img src="/files/S5q5CpwqkCdyHEzwVbIJ" alt=""><figcaption></figcaption></figure>

The "\_1" and "\_2" in the index formula names reference the NIR1 and NIR2 camera filters, meaning those NIR channels were used in that formula. "\_1" for NIR1 and "\_2" for NIR2.

### The computed values shown should closely match the results you would obtain when using a [Survey3 multispectral camera](https://www.mapir.camera/pages/survey3-cameras) for reflectance measurements.

## Exporting/Saving Data

All visible data will be exported when the save button is pressed. If the layer has reflectance turned on then the exported data will include the reflectance data. The reflectance data will also be used to produce new values in the exports. The current graph plot and index table will also be saved. All files are named based on the graph title entered. See below for an example output.

### Exported Saved Scan Data CSV:

<figure><img src="/files/0uZFuLa5tLP5yZSnuCXJ" alt=""><figcaption><p>A small sampling of the output data, much more not shown</p></figcaption></figure>

### Exported Saved Scan Graph PNG:

<figure><img src="/files/kWJxu2vNLVB1SPTCUK7W" alt=""><figcaption></figcaption></figure>

### Exported Scan Index Table CSV:

<figure><img src="/files/2RsFLLFKZdVgLWuPXUWL" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mapir.gitbook.io/mapir-camera-control-mcc/interface-tabs/scan-tab.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.