/
ModeCalc User Guide

ModeCalc User Guide

Table of Contents

 

 

 

 

 

 

MODECALC USER GUIDE

 

Introduction

ModeCalc is a GUI that provides a graphical shell for a Python sensor mode generator module. It only gets parameter lists from the Python file, populates its window with a control for each one, calls the Python file to get results, and displays the results. It's completely sensor independent.

 

Functionalities

  • It has 'exporters' to convert results of user generated modes to a file.

    • The resultant file can be saved in classic DevX ini format, or as shared settings format or as json file.

  • It can save the user's set of parameter values in a text file so the user can preserve it for later, share it, check it in to a repository, etc.

  • It has a text editor that's loaded with the Python source code of the module in use.

  • There's a Python Console window (like DevWareX) that shows print() output, error messages, etc.

Session

ModeCalc provides an option to load only one session i.e., either by loading the python sensor settings module file or saved json file at any one point of time. But user can clone the settings to a new one and modify it with multiple sets of parameters. So, in each tab in the main view user can maintain multiple settings for example, Linear, 2-exposure HDR, 3-exposure HDR, etc., and easily flip between them & save them all in one file.

User Launch

ModeCalc is part of the DevX release, it will be in the bin folder of the installation path. As the user launches it, will look like below.

ModeCalc Window

Once user loads the python module or saved json file from the session pane the ModeCalc window will appear as shown below. The ModeCalc window has multiple sub windows.

  • Parameters Pane

    • This pane is populated with the default values from the loaded python module.

    • Pane has multiple sections.

      • Sensor Config Overview: User can choose the sensor config related parameters and modify the values as per his requirements to generate the recommended output values.

 

Integration Time settings: Provides user an option to override the default value into a new value by clicking on the respective check boxes.

 

Advanced Clock Settings: Provides an option to override the divider and multiplier values.

 

AdvancedSensorModeSettings: Provides an option to override the values of Image width / height, FOV Values, Embedded Rows, DTR, STR, Stats values.

 

Advanced MIPI Timing: Provides option to choose the MIPI clock to be Continuous or Non-Continuous, MIPI Timing Margin values etc.

 

Advanced Shutter Settings: Provides user to override the advanced shutter related fields.

Notes Pane

Shows up the summary of the output values generated with the given set of the input parameters in Parameters pane. Covers the summary of the Clock Settings, MIPI Timings, Fine Integration Timing details, Delay Buffers, Frame Timing data.

 

Register Settings Pane

This pane gives the updated register values to be loaded into the sensor for a particular mode based on the input parameters provided by user in parameters pane. User can save these values either into an ini file or shared settings file. The details on how to save are provided in the Export window section.

 

Errors Pane

While overriding the default values to an any value in parameters pane, the errors pane shows up the error details & also gives info on the possible fix for the error.

 

 

ModeCalc Window’s top pane provides different functionalities to an user. Each of them are explained in detail in below sections.

  • Session

  • Modes

  • Export

  • Python

Session Window

This window provides user below functionalities.

  • New Session… : User can start the new session by providing the right python module.

  • Open session… : User can open a session by providing the proper json file, where in which both json file & python module file should be in same location.

  • Save session : To save the current session.

  • Save session As… : To save the session to proper json file name.

  • Recent Session Files : Shows the lists of recent sessions it may be either a python module file, json file or ini file.

Each of the session operations are shown below.

New session

Once user clicks new session, a window will pop up which lists the sensor part numbers which are previously loaded or user can select the new python module file by choosing the option “Browse for a file…”

Once the user selects the right python module and clicks ok, the ModeCalc window will look like below picture. This window will load all the default parameters for each of the controls from the python module and generates the output.