Open eVision

https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us
Admin
Open eVision is a comprehensive machine vision software platform providing tools for image...
Tokens:1,767,812
Snippets:17,055
Trust Score:9.5
Update:2 months ago
Show doc for...
Tokens:
Raw
### Install Qt and QtCreator

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/03_Using/1_Starting_Up/1_Installing_Open_eVision/Installing_on_Linux.htm?TocPath=Using+Open+eVision%7CInstalling+Open+eVision%7C_____2

Install the necessary Qt development packages using apt.

```bash
# apt install qt5-default qtcreator
```

--------------------------------

### Install Open eVision via apt

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/03_Using/1_Starting_Up/1_Installing_Open_eVision/Installing_on_Linux.htm?TocPath=Using+Open+eVision%7CInstalling+Open+eVision%7C_____2

Use the apt package manager to install the deb packages for Open eVision, the Neo License Manager, and CodeMeter.

```bash
# apt install ./neo-linux-license-manager-(x86_64|arm64)-(version).deb ./open_evision-linux-(x86_64|arm64)-(version).deb ./codemeter-lite_7.40.4990.500_(amd64|arm64).deb
```

--------------------------------

### Install OpenGL dependencies

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/03_Using/1_Starting_Up/1_Installing_Open_eVision/Installing_on_Linux.htm?TocPath=Using+Open+eVision%7CInstalling+Open+eVision%7C_____2

Install additional packages required for the Neo License Manager and 3D Viewer functionality.

```bash
# apt install libglu1-mesa-dev freeglut3-dev mesa-common-dev
```

--------------------------------

### Install Open eVision via dnf or yum

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/03_Using/1_Starting_Up/1_Installing_Open_eVision/Installing_on_Linux.htm?TocPath=Using+Open+eVision%7CInstalling+Open+eVision%7C_____2

Use the dnf or yum package manager to install the rpm packages for Open eVision, the Neo License Manager, and CodeMeter.

```bash
# (dnf | yum) install ./neo-license-manager-(version).x86_64.rpm ./open_evision-(version).x86_64.rpm ./Codemeter-lite_7.40.4990-500.x86_64.rpm
```

--------------------------------

### EChecker.RelativeTolerance

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/echecker-relativetolerance.htm?TocPath=Reference%7CClasses%7CEChecker+Class%7C_____28

Property to get or set the relative tolerance factor for threshold image setup in .NET.

```APIDOC
## EChecker.RelativeTolerance

### Description
Gets or sets the current tolerance factor used for threshold image setup.

### Signature
float RelativeTolerance { get; set; }
```

--------------------------------

### Get and Set Relative Tolerance in C++

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/echecker-relativetolerance.htm

Methods to retrieve and modify the relative tolerance factor for threshold image setup.

```C++
float GetRelativeTolerance()
void SetRelativeTolerance(float f32RelativeTolerance)
```

--------------------------------

### Display Command Line Help

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/15_Neo_Licensing_System/Using_the_Offline_Command_Line.htm?TocPath=Getting+Started%7C_____22

Lists all available commands and arguments for the Neo License Manager.

```bash
> NeoLicenseManagerCL.exe Help
Here are the available commands and their arguments:
ListContainers [-filter (dongle|software)]
ListLicenses [-sn SERIAL]
ApplyLicense -path PATH
CreateSoftwareContainer
GetFingerprint -sn SERIAL -path PATH
CheckStatus
Report -path PATH
Activate -t NEO_TICKET_ID -sn SERIAL
Reactivate -t NEO_TICKET_ID -sn SERIAL
RequestActivationFile -fingerprintPath PATH -outPath PATH -t NEO_TICKET_ID
RequestReactivationFile -fingerprintPath PATH -outPath PATH -t NEO_TICKET_ID
RequestEmergencyActivation
```

--------------------------------

### Create a Software Container

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/15_Neo_Licensing_System/Using_the_Offline_Command_Line.htm?TocPath=Getting+Started%7C_____22

Initializes a new software container for license storage.

```bash
> NeoLicenseManagerCL.exe CreateSoftwareContainer
Software container 130-3245488904 has been created.
```

--------------------------------

### Configure Search Parameters and Read QR Code

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/14_EasyQRCode/Tuning_the_Search_Parameters.htm?TocPath=Resources%7CCode+Snippets%7CEasyQRCode%7C_____3

Demonstrates how to initialize the reader, set search constraints, and extract decoded data from a QR code.

```C++
////////////////////////////////////////////////////
// This code snippet shows how to read a QR code  //
// and retrieve the decoded data after setting a  //
// number of search parameters.                   //
////////////////////////////////////////////////////

// Image constructor
EImageBW8 srcImage;

// QR code reader constructor
EQRCodeReader reader;

// ...

// Set the source image
reader.SetSearchField(srcImage);

// Set the search parameters
reader.SetMaximumVersion(7);
reader.SetMinimumIsotropy(0.9f);

// Set the searched models
std::vector<EQRCodeModel> models;
models.push_back(EQRCodeModel_Model2);
reader.SetSearchedModels(models);

// Read
std::vector<EQRCode> qrCodes = reader.Read();

// Retrieve the decoded string in best guess mode of the first QR code found
string decodedString = qrCodes[0].GetDecodedString(EByteInterpretationMode_Auto);
```

```.NET
////////////////////////////////////////////////////
// This code snippet shows how to read a QR code  //
// and retrieve the decoded data after setting a  //
// number of search parameters.                   //
////////////////////////////////////////////////////

// Image constructor
EImageBW8 srcImage= new EImageBW8();

// QR code reader constructor
EQRCodeReader reader= new EQRCodeReader ();

// ...

// Set the source image
reader.SearchField = srcImage;

// Set the search parameters
reader.MaximumVersion = 7;
reader.MinimumIsotropy = 0.9f;

// Set the searched models
reader.SearchedModels = new EQRCodeModel[] {EQRCodeModel.Model2};

// Read
EQRCode [] qrCodes = reader.Read();

// Retrieve the decoded string in best guess mode of the first QR code found
string decodedString = qrCodes[0].GetDecodedString(EByteInterpretationMode.Auto);
```

--------------------------------

### Get and Set ROI Height in C#

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/ebaseroi-height.htm

Access the Height property to get or set the vertical dimension of an ROI.

```csharp
int Height
{ get; set; }
```

--------------------------------

### Apply License File

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/15_Neo_Licensing_System/Using_the_Offline_Command_Line.htm?TocPath=Getting+Started%7C_____22

Activates the license on the target system using the generated license activation file.

```bash
> NeoLicenseManagerCL.exe ApplyLicense -path "mylicensefile.lif"
```

--------------------------------

### Get and Set ReplaceByAverage in C++

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/epointcloudfilter-replacebyaverage.htm

Access the replacement behavior using the Get and Set methods in the Euresys::Open_eVision_22_12::Easy3D namespace.

```C++
bool GetReplaceByAverage() const
void SetReplaceByAverage(bool replaceByAverage)
```

--------------------------------

### Get and Set Picking Distance Threshold in C#

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/e3dviewer-pickingdistancethreshold.htm

Use this property to get or set the picking distance threshold for 3D point operations.

```C#
float PickingDistanceThreshold
{ get; set; }
```

--------------------------------

### Start Neo License Manager via script

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/03_Using/1_Starting_Up/1_Installing_Open_eVision/Installing_on_Linux.htm?TocPath=Using+Open+eVision%7CInstalling+Open+eVision%7C_____2

Execute the Neo License Manager script directly if the desktop entry is unavailable.

```bash
# /opt/euresys/neo_license_manager_X_Y/NeoLicenseManager
```

--------------------------------

### Get and Set WorldToMapMatrix in C++

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/ezmap-worldtomapmatrix.htm

Access the rigid transformation matrix using the Get and Set methods within the Euresys::Open_eVision_22_12::Easy3D namespace.

```C++
const E3DTransformMatrix& GetWorldToMapMatrix() const
void SetWorldToMapMatrix(const E3DTransformMatrix& matrix)
```

--------------------------------

### Configuring and Running E3DMatcher

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/03_Using/6_3D_Processing/5_Easy3DMatch/Alignment_and_Comparison_E3DMatcher.htm?TocPath=Using+Open+eVision%7C3D+Processing+Tools%7CEasy3DMatch+-+3D+Alignment+and+Comparison%7C_____4

Demonstrates the full workflow for setting up a reference, configuring comparison parameters, and executing a match operation.

```C#
////////////////////////////////////////////////////
// This code snippet shows how to set the options //
// when matching two elements with E3DMatcher.    //
////////////////////////////////////////////////////
 
// load the reference golden scan and set reference
E3DMatcher matcher = new E3DMatcher();
EPointCloud reference = new EPointCloud();
float azimuthReference = 0.0f, elevationReference = 90.0f;
reference.Load("...");
matcher.SetReference(reference, azimuthReference, elevationReference);
 
// use advanced comparison mode
matcher.ComparisonDistanceMode = EComparisonDistanceMode.Advanced;


// ignore shadows
matcher.EnableMissingPointAsAnomaly = false;


// set thresholds
float distanceThresh = 0.2f, areaThresh = 1.0f;
float hystDistanceThresh = 1.5f, hystAreaThresh = 0.5f;
matcher.SetAnomalyThresholds(distanceThresh, areaThresh);
matcher.SetAnomalyHysteresis(hystDistanceThresh, hystAreaThresh);  // defined relatively to base thresholds
 
// retrieve reference poses (reference must have been set)
EZMap8[] referencePoseProjections;
matcher.RetrieveReferencePosesProjections(out referencePoseProjections);

// set ROI on the left half of the object
float originX = 0.0f, originY = 0.0f, width = referencePoseProjections[0].Width / 2, height = referencePoseProjections[0].Height / 2;
ERectangleRegion roiRegion = new ERectangleRegion(originX, originY, width, height);
matcher.SetComparisonROI(roiRegion);

// set No Extra material on the whole object
originX = 0.0f; originY = 0.0f; width = referencePoseProjections[0].Width / 2; height = referencePoseProjections[0].Height / 2;
ERectangleRegion noExtraMatRegion = new ERectangleRegion(originX, originY, width, height);
matcher.SetComparisonNoExtraMaterial(roiRegion);
 
// prepare data structures (optional)
matcher.PrepareReference();
 
// load the sample and perform comparison
EPointCloud sample = new EPointCloud();
float azimuthSample = 0.0f, elevationSample = -90.0f;
sample.Load("...");
E3DMatch match = matcher.Match(sample, azimuthSample, elevationSample);
E3DAnomaly[] anomalies = match.Anomalies;


// TODO: if (anomalies.Length != 0):an anomaly was detected: inspect the sample manually? throw it away?
 
// get cloud to inspect it manually
EPointCloud visualisationCloud = new EPointCloud();
matcher.GetComparisonPointCloud(visualisationCloud);
```

--------------------------------

### Read QR Code and Retrieve String

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/14_EasyQRCode/Retrieving_the_Decoded_String__Simple_.htm?TocPath=Resources%7CCode+Snippets%7CEasyQRCode%7C_____4

Shows the basic workflow of initializing the reader, setting the source image, and extracting the decoded string from the first detected QR code.

```cpp
////////////////////////////////////////////////////
// This code snippet shows how to read a QR code  //
// and retrieve the decoded string.               //
////////////////////////////////////////////////////


// Image constructor
EImageBW8 srcImage;

// QR code reader constructor
EQRCodeReader reader;

// ...

// Set the source image
reader.SetSearchField(srcImage);

// Read
std::vector<EQRCode> qrCodes = reader.Read();

// Retrieve the data of the first QR code found in best guess mode
string decodedString = qrCodes[0].GetDecodedString(EByteInterpretationMode_Auto);
```

```csharp
////////////////////////////////////////////////////
// This code snippet shows how to read a QR code  //
// and retrieve the decoded string.               //
////////////////////////////////////////////////////

// Image constructor
EImageBW8 srcImage = new EImageBW8();

// QR code reader constructor
EQRCodeReader reader = new EQRCodeReader();

// ...

// Set the source image
reader.SearchField = srcImage;

// Read
EQRCode [] qrCodes = reader.Read();

// Retrieve the data of the first QR code found in best guess mode
string decodedString = qrCodes[0].GetDecodedString(EByteInterpretationMode.Auto);
```

--------------------------------

### Read QR Code with EasyQRCode

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/14_EasyQRCode/Automatic_Reading_of_a_QR_Code.htm?TocPath=Resources%7CCode+Snippets%7CEasyQRCode%7C_____1

Demonstrates the initialization of the reader and the execution of the read operation to retrieve decoded QR code data.

```cpp
////////////////////////////////////////////////////
// This code snippet shows how to read a QR code  //
// and retrieve the decoded data.                 //
////////////////////////////////////////////////////

// Image constructor
EImageBW8 srcImage;

// QR code reader constructor
EQRCodeReader reader;

// ...

// Set the source image
reader.SetSearchField(srcImage);

// Read
std::vector<EQRCode> qrCodes = reader.Read();
```

```csharp
////////////////////////////////////////////////////
// This code snippet shows how to read a QR code  //
// and retrieve the decoded data.                 //
////////////////////////////////////////////////////

// Image constructor
EImageBW8 srcImage= new EImageBW8();

// QR code reader constructor
EQRCodeReader reader= new EQRCodeReader ();

// ...

// Set the source image
reader.SearchField = srcImage;

// Read
EQRCode [] qrCodes = reader.Read();
```

--------------------------------

### ESupervisedSegmenterBlob.Label

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/esupervisedsegmenterblob-label.htm?TocPath=Reference%7CClasses%7CESupervisedSegmenterBlob+Class%7C_____5

Gets the label of the blob.

```APIDOC
## ESupervisedSegmenterBlob.Label

### Description
Gets the label associated with the blob.

### Signature
`string Label { get; }`

### Namespace
Euresys.Open_eVision_22_12.EasyDeepLearning
```

--------------------------------

### Initialize()

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/easy-initialize.htm

Initializes the Open eVision library. This method must be called to prepare the environment for use.

```APIDOC
## Initialize

### Description
Initializes the Open eVision library.

### Signature
- **C++**: `void Initialize()`
- **.NET**: `void Initialize()`

### Namespace
- **C++**: `Euresys::Open_eVision_22_12`
- **.NET**: `Euresys.Open_eVision_22_12`
```

--------------------------------

### EOCR2DatabaseCharacter.Bitmap

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/eocr2databasecharacter-bitmap.htm?TocPath=Reference%7CClasses%7CEOCR2DatabaseCharacter+Class%7C_____1

Gets the bitmap associated with the character.

```APIDOC
## EOCR2DatabaseCharacter.Bitmap

### Description
Gets the bitmap associated with the character.

### Signature
`Euresys.Open_eVision_22_12.EImageBW8 Bitmap { get; }`

### Namespace
Euresys.Open_eVision_22_12
```

--------------------------------

### Configure and Save EasyFind Parameters

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/06_EasyFind/setting-search-parameters-easyfind.htm

Demonstrates setting search constraints and saving the model file using C++ and .NET APIs.

```C++
//////////////////////////////////////////////////////////
// This code snippet shows how to tune pattern finding  //
// search parameters and save them into a file.         //
//////////////////////////////////////////////////////////

// Image constructor
EImageBW8 pattern;

// EPatternFinder constructor
EPatternFinder finder;

// ...

// Learn the pattern
finder.Learn(&pattern);

// Set the maximum number of occurrences
finder.SetMaxInstances(5);

// Set the rotation tolerances
finder.SetAngleTolerance(20.f);

// Set the minimum score
finder.SetMinScore(0.70f);

// Save the finding context into a model file
finder.Save("myModel.fnd");
```

```.NET
//////////////////////////////////////////////////////////
// This code snippet shows how to tune pattern finding  //
// search parameters and save them into a file.         //
//////////////////////////////////////////////////////////

// Image constructor
EImageBW8 pattern= new EImageBW8();

// EPatternFinder constructor
EPatternFinder finder= new EPatternFinder();

// ...

// Learn the pattern
finder.Learn(pattern);

// Set the maximum number of occurrences
finder.MaxInstances= 5;

// Set the rotation tolerances
finder.AngleTolerance= 20.0f;

// Set the minimum score
finder.MinScore= 0.70f;

// Save the finding context into a model file
finder.Save("myModel.fnd");
```

--------------------------------

### Read QR Code and Retrieve Information

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/14_EasyQRCode/Retrieving_Information_of_a_QR_Code.htm

Demonstrates initializing the reader, setting the source image, and accessing properties of the detected QR code.

```cpp
////////////////////////////////////////////////////
// This code snippet shows how to read a QR code  //
// and retrieve the associated information.       //
////////////////////////////////////////////////////

// Image constructor
EImageBW8 srcImage;

// QR code reader constructor
EQRCodeReader reader;

// ...

// Set the source image
reader.SetSearchField(srcImage);
// Read
std::vector<EQRCode> qrCodes = reader.Read();

// Retrieve version, model and position information
// of the first QR code found, if one was found
if (qrCodes.size() > 0)
{
    int version = qrCodes[0].GetVersion();
    EQRCodeModel model = qrCodes[0].GetModel();
    EQRCodeGeometry geometry = qrCodes[0].GetGeometry();
}
```

```csharp
////////////////////////////////////////////////////
// This code snippet shows how to read a QR code  //
// and retrieve the associated information.       //
////////////////////////////////////////////////////

// Image constructor
EImageBW8 srcImage= new EImageBW8();

// QR code reader constructor
EQRCodeReader reader= new EQRCodeReader ();

// ...
// Set the source image
reader.SearchField = srcImage;

// Read
EQRCode [] qrCodes = reader.Read();

// Retrieve version, model and position information
// of the first QR code found, if one was found
if (qrCodes.Length > 0)
{
    uint version = qrCodes[0].Version;
    EQRCodeModel model = qrCodes[0].Model;
    EQRCodeGeometry geometry = qrCodes[0].Geometry;
}
```

--------------------------------

### EMatcher.PatternHeight

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/ematcher-patternheight.htm

Gets the height of the learned pattern.

```APIDOC
## EMatcher.PatternHeight

### Description
Gets the height of the learned pattern.

### Signature
int PatternHeight { get; }

### Namespace
Euresys.Open_eVision_22_12
```

--------------------------------

### EWorldShape::SetupUnwarp

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/eworldshape-setupunwarp.htm?TocPath=Reference%7CClasses%7CEWorldShape+Class%7C_____59

Prepares a lookup table for fast image unwarping. This method should be called whenever the optical setup is changed.

```APIDOC
## EWorldShape::SetupUnwarp

### Description
Prepares a lookup table for fast image unwarping. This function records the row pitch of the provided source image to optimize the unwarping process.

### Method
void SetupUnwarp(EUnwarpingLut* lookupTable, EROIBW8* sourceImage, BOOL interpolate)
void SetupUnwarp(EUnwarpingLut* lookupTable, EROIC24* sourceImage, BOOL interpolate)

### Parameters
- **lookupTable** (EUnwarpingLut*) - Pointer to the lookup table.
- **sourceImage** (EROIBW8* or EROIC24*) - Pointer to the source image or ROI.
- **interpolate** (BOOL) - Interpolation mode. Default value is FALSE.

### Remarks
This function must be called each time the system is re-calibrated. Subsequent calls to EWorldShape::Unwarp must use images with the same row pitch as the source image supplied here.
```

--------------------------------

### ESamplePoint.IsOutlier

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/esamplepoint-isoutlier.htm

Gets the outlier status of the sample point.

```APIDOC
## ESamplePoint.IsOutlier

### Description
Gets the outlier status of the sample point.

### Signature
`bool IsOutlier { get; }`

### Namespace
Euresys.Open_eVision_22_12
```

--------------------------------

### ERectangleShape.CenterY

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/erectangleshape-centery.htm

Gets the ordinate of the origin point of the shape.

```APIDOC
## ERectangleShape.CenterY

### Description
Gets the ordinate of the origin point of the ERectangleShape.

### Signature
`float CenterY { get; }`

### Namespace
Euresys.Open_eVision_22_12
```

--------------------------------

### EPointCloud::PrepareSpacePartition

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/epointcloud-preparespacepartition.htm

Enables the build of the space partition and builds it immediately. The computation time depends on the number of points in the point cloud.

```APIDOC
## void PrepareSpacePartition()

### Description
Enables the build of the space partition (like EPointCloud) and builds it now instead of when it is first needed. The computation time of the space partition depends on the number of points in the point cloud.

### Namespace
Euresys::Open_eVision_22_12::Easy3D (C++) / Euresys.Open_eVision_22_12.Easy3D (C#)

### See Also
EPointCloud::EnableSpacePartition
```

--------------------------------

### Configure and Save EasyMatch Parameters

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/05_EasyMatch/setting-search-parameters-easymatch.htm?TocPath=Resources%7CCode+Snippets%7CEasyMatch%7C_____2

Demonstrates how to set search parameters and save the matching context to a file for both C++ and .NET APIs.

```C++
//////////////////////////////////////////////////////////
// This code snippet shows how to tune pattern matching //
// search parameters and save them into a file.         //
//////////////////////////////////////////////////////////

// Image constructor
EImageBW8 pattern;

// EMatcher constructor
EMatcher matcher;

// ...

// Learn the pattern
matcher.LearnPattern(&pattern);

// Set the maximum number of occurrences
matcher.SetMaxPositions(5);

// Set the rotation tolerances
matcher.SetMinAngle(-20.f);
matcher.SetMaxScale(20.f);

// Enable sub-pixel accuracy
matcher.SetInterpolate(true);

// Set the minimum score
matcher.SetMinScore(0.70f);

// Save the matching context into a model file
matcher.Save("myModel.mch");
```

```.NET
//////////////////////////////////////////////////////////
// This code snippet shows how to tune pattern matching //
// search parameters and save them into a file.         //
//////////////////////////////////////////////////////////

// Image constructor
EImageBW8 pattern= new EImageBW8();

// EMatcher constructor
EMatcher matcher= new EMatcher();

// ...

// Learn the pattern
matcher.LearnPattern(pattern);

// Set the maximum number of occurrences
matcher.MaxPositions= 5;

// Set the rotation tolerances
matcher.MinAngle= -20.0f;
matcher.MaxAngle= 20.0f;

// Enable sub-pixel accuracy
matcher.Interpolate= true;

// Set the minimum score
matcher.MinScore= 0.70f;

// Save the matching context into a model file
matcher.Save("myModel.mch");
```

--------------------------------

### EPoint.Y (.NET)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/epoint-y.htm?TocPath=Reference%7CClasses%7CEPoint+Class%7C_____26

Gets the Y coordinate of the EPoint object.

```APIDOC
## EPoint.Y

### Description
Gets the ordinate (Y coordinate) of the EPoint object.

### Signature
`float Y { get; }`

### Namespace
Euresys.Open_eVision_22_12
```

--------------------------------

### Initialize

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/easy-initialize.htm?TocPath=Reference%7CClasses%7CEasy+Class%7C_____15

Initializes the Open eVision library. This method must be called to prepare the environment for subsequent library operations.

```APIDOC
## Initialize

### Description
Initializes the Open eVision library.

### Signature
- **C++**: `void Initialize()`
- **C#**: `void Initialize()`

### Namespace
- **C++**: `Euresys::Open_eVision_22_12`
- **C#**: `Euresys.Open_eVision_22_12`
```

--------------------------------

### EIntegerRange.Size (.NET)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/eintegerrange-size.htm

Gets the size of the integer range.

```APIDOC
## EIntegerRange.Size

### Description
Gets the size of the integer range.

### Signature
`int Size { get; }`
```

--------------------------------

### E3DMatcher Minimal Sample

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/17_Easy3DMatch/E3DMatcher_Minimal_Sample.htm?TocPath=Resources%7CCode+Snippets%7CEasy3DMatch%7C_____6

Demonstrates the workflow for loading a reference, setting anomaly thresholds, and performing a comparison against a sample point cloud.

```C++
//////////////////////////////////////////////////// 
// This code snippet shows how to match a sample  // 
// with a golden scan reference.                  // 
//////////////////////////////////////////////////// 

// load the reference golden scan and set reference 
Easy3D::E3DMatcher matcher; 
Easy3D::EPointCloud reference; 
float azimuthReference = 0.f, elevationReference = 90.f; 
reference.Load(“…”); 
matcher.SetReference(reference, azimuthReference, elevationReference); 

// set thresholds 
float distanceThresh = .2f, areaThresh = 1.f; 
matcher.SetAnomalyThresholds(distanceThresh, areaThresh);

// prepare data structures (optional) 
matcher.PrepareReference(); 

// load the sample and perform comparison 
Easy3D::EPointCloud sample; 
float azimuthSample = 0.f, elevationSample = -90.f; 
sample.Load(“…”); 
Easy3D::E3DMatch match = matcher.Match(sample, azimuthSample, elevationSample); 
std::vector<Easy3D::E3DAnomaly> anomalies = match.GetAnomalies();

// TODO: if (anomalies.size() != 0u): an anomaly was detected: inspect the sample manually? throw it away? 

// get cloud to inspect it manually 
Easy3D::EPointCloud visualisationCloud; 
matcher.GetComparisonPointCloud(visualisationCloud); 
```

```.NET
////////////////////////////////////////////////////
// This code snippet shows how to match a sample  //
// with a golden scan reference.                  //
////////////////////////////////////////////////////
 
// load the reference golden scan and set reference
E3DMatcher matcher = new E3DMatcher();
EPointCloud reference = new EPointCloud();
float azimuthReference = 0.0f, elevationReference = 90.0f;
reference.Load("...");
matcher.SetReference(reference, azimuthReference, elevationReference);
 
// set thresholds
float distanceThresh = 0.2f, areaThresh = 1.0f;
matcher.SetAnomalyThresholds(distanceThresh, areaThresh);

// prepare data structures (optional)
matcher.PrepareReference();
 
// load the sample and perform comparison
EPointCloud sample = new EPointCloud();
float azimuthSample = 0.0f, elevationSample = -90.0f;
sample.Load("...");
E3DMatch match = matcher.Match(sample, azimuthSample, elevationSample);
E3DAnomaly[] anomalies = match.Anomalies;

// TODO: if (anomalies.Length != 0): an anomaly was detected: inspect the sample manually? throw it away?
 
// get cloud to inspect it manually
EPointCloud visualisationCloud = new EPointCloud();
matcher.GetComparisonPointCloud(visualisationCloud);
```

--------------------------------

### EFrameShape.SizeY (C#)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/eframeshape-sizey.htm

Gets the Y-axis length of the frame.

```APIDOC
## float SizeY

### Description
Gets the Y-axis length of the frame. By default, this value is set to 100, representing either pixels or physical units depending on the field of view calibration.

### Namespace
Euresys.Open_eVision_22_12

### Returns
- **float**: The length of the Y-axis.
```

--------------------------------

### Perform pattern learning and finding with a DXF file

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/06_EasyFind/Learning_Using_a_DXF_File.htm

Demonstrates the workflow for loading a DXF model, learning the pattern, and executing the find operation.

```cpp
/////////////////////////////////////////////////////
// This code snippet shows how to perform          //
// pattern learning and finding operations         //
// using a DXF file.                               //
/////////////////////////////////////////////////////
// Image constructor
EImageBW8 srcImage;
// EPatternFinder constructor
EPatternFinder finder;
// EVectorModel constructor
EVectorModel myModel;
// Load the model from a dxf file
myModel.LoadDXF("myModel.dxf");
// Learn the model
finder.Learn(myModel);
// EFoundPattern constructor
std::vector<EFoundPattern> foundPattern;
// ...
// Perform the pattern finding
foundPattern = finder.Find(&srcImage);
```

```csharp
/////////////////////////////////////////////////////
// This code snippet shows how to perform          //
// pattern learning and finding operations         //
// using a DXF file.                               //
/////////////////////////////////////////////////////
// Image constructor
EImageBW8 srcImage = new EImageBW8();
// EPatternFinder constructor
EPatternFinder finder = new EPatternFinder();
// EVectorModel constructor
EVectorModel myModel = new EVectorModel();
// Load the model from a dxf file
myModel.LoadDXF("myModel.dxf");
// Learn the model
finder.Learn(myModel);
// EFoundPattern constructor
EFoundPattern[] foundPattern = null;
// ...
// Perform the pattern finding
foundPattern = finder.Find(srcImage);
```

--------------------------------

### EFrameShape.SizeX (C#)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/eframeshape-sizex.htm

Gets the X-axis length of the frame.

```APIDOC
## EFrameShape.SizeX

### Description
Gets the X-axis length of the frame.

### Signature
float SizeX { get; }

### Remarks
By default, the value is set to 100, representing pixels in uncalibrated fields of view or physical units in calibrated fields of view.
```

--------------------------------

### Profile Sampling with EasyImage in .NET

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/02_EasyImage/profile-sampling.htm

Demonstrates how to extract pixel data into a vector and modify pixels along a line segment in .NET.

```.NET
//////////////////////////////////////////////////////////////
// This code snippet shows how to set, retrieve and store   //
// the pixel values along a given line segment.             //
//////////////////////////////////////////////////////////////

// Image constructor
EImageBW8 srcImage= new EImageBW8();

// ...

// Vector constructor
EBW8Vector profile= new EBW8Vector();

// Get the image data along segment (10,512)-(500,40)
EasyImage.ImageToLineSegment(srcImage, profile, 10, 512, 500, 40);

// Set all these points to white (255) in the image
EBW8 white = new EBW8(255);
EasyImage.LineSegmentToImage(srcImage, white, 10, 512, 500, 40);
```

--------------------------------

### EFindFeaturePoint.Position (.NET)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/efindfeaturepoint-position.htm?TocPath=Reference%7CClasses%7CEFindFeaturePoint+Class%7C_____7

Gets the position of the feature point.

```APIDOC
## EFindFeaturePoint.Position

### Description
Gets the position of the feature point.

### Signature
`Euresys.Open_eVision_22_12.EPoint Position { get; }`

### Returns
- **EPoint** - The position of the feature point.
```

--------------------------------

### Easy.SetOemKey (.NET)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/easy-setoemkey.htm

Writes an OEM key value on a dongle using the .NET interface.

```APIDOC
## void SetOemKey(char[] key, Euresys.Open_eVision_22_12.EDongleType type, int dongleIndex)

### Description
Writes an OEM key value on a dongle. The length of the OEM key must be in [8, 64] characters.

### Parameters
- **key** (char[]) - The OEM key value to write.
- **type** (Euresys.Open_eVision_22_12.EDongleType) - The EDongleType for which you want to set the OEM key.
- **dongleIndex** (int) - The index of the dongle where the OEM key must be written.

## void SetOemKey(uint keyIndex, char[] key, Euresys.Open_eVision_22_12.EDongleType type, int dongleIndex)

### Description
Writes an OEM key value at a specific index on a dongle. This option is not compatible with Legacy.

### Parameters
- **keyIndex** (uint) - The index of the key in the array of keys, must be in [0, 11].
- **key** (char[]) - The OEM key value to write.
- **type** (Euresys.Open_eVision_22_12.EDongleType) - The EDongleType for which you want to set the OEM key.
- **dongleIndex** (int) - The index of the dongle where the OEM key must be written.
```

--------------------------------

### EDepthMapToMeshConverter.CalibrationModel

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/edepthmaptomeshconverter-calibrationmodel.htm

Property to get or set the ECalibrationModel in .NET.

```APIDOC
## .NET Property: CalibrationModel

### Description
Accesses the ECalibrationModel used for conversion.

### Signature
`Euresys.Open_eVision_22_12.Easy3D.ECalibrationModel CalibrationModel { get; set; }`
```

--------------------------------

### EC24PathVector.RawDataPtr (.NET)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/ec24pathvector-rawdataptr.htm

Gets a pointer to the vector data.

```APIDOC
## .NET Property: RawDataPtr

### Description
Gets a pointer to the underlying vector data.

### Signature
`IntPtr RawDataPtr { get; }`

### Namespace
Euresys.Open_eVision_22_12
```

--------------------------------

### Learn a pattern using EasyFind

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/06_EasyFind/pattern-learning-easyfind.htm?TocPath=Resources%7CCode+Snippets%7CEasyFind%7C_____1

Initializes the necessary image, ROI, and finder objects to define and learn a pattern from a specific region of interest.

```C++
/////////////////////////////////////////////////////
// This code snippet shows how to learn a pattern  //
// defined by a region of interest (ROI).          //
/////////////////////////////////////////////////////

// Image constructor
EImageBW8 srcImage;

// ROI constructor
EROIBW8 pattern;

// EPatternFinder constructor
EPatternFinder finder;

// ...

// Attach the ROI to the source image
// and set its position
pattern.Attach(&srcImage);
pattern.SetPlacement(214, 52, 200, 200);

// Learn the pattern
finder.Learn(&pattern);
```

```.NET
/////////////////////////////////////////////////////
// This code snippet shows how to learn a pattern  //
// defined by a region of interest (ROI).          //
/////////////////////////////////////////////////////
 
// Image constructor
EImageBW8 srcImage= new EImageBW8();

// ROI constructor
EROIBW8 pattern= new EROIBW8();

// EPatternFinder constructor
EPatternFinder finder= new EPatternFinder();

// ...

// Attach the ROI to the source image
// and set its position
pattern.Attach(srcImage);
pattern.SetPlacement(214, 52, 200, 200);

// Learn the pattern
finder.Learn(pattern);
```

--------------------------------

### E3DBox.ZAxis (.NET)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/e3dbox-zaxis.htm?TocPath=Reference%7CClasses%7CE3DBox+Class%7C_____15

Gets the Z axis of the box.

```APIDOC
## E3DBox.ZAxis

### Description
Gets the Z axis of the box.

### Signature
`E3DPoint ZAxis { get; }`

### Namespace
Euresys.Open_eVision_22_12.Easy3D
```

--------------------------------

### Basic 3D Point Cloud Matching

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/03_Using/6_3D_Processing/5_Easy3DMatch/Alignment_and_Comparison_E3DMatcher.htm?TocPath=Using+Open+eVision%7C3D+Processing+Tools%7CEasy3DMatch+-+3D+Alignment+and+Comparison%7C_____4

Demonstrates the standard workflow for loading a reference scan, setting thresholds, and comparing a sample point cloud.

```C#
////////////////////////////////////////////////////
// This code snippet shows how to match a sample  //
// with a golden scan reference.                  //
////////////////////////////////////////////////////
 
// load the reference golden scan and set reference
E3DMatcher matcher = new E3DMatcher();
EPointCloud reference = new EPointCloud();
float azimuthReference = 0.0f, elevationReference = 90.0f;
reference.Load("...");
matcher.SetReference(reference, azimuthReference, elevationReference);
 
// set thresholds
float distanceThresh = 0.2f, areaThresh = 1.0f;
matcher.SetAnomalyThresholds(distanceThresh, areaThresh);

// prepare data structures (optional)
matcher.PrepareReference();
 
// load the sample and perform comparison
EPointCloud sample = new EPointCloud();
float azimuthSample = 0.0f, elevationSample = -90.0f;
sample.Load("...");
E3DMatch match = matcher.Match(sample, azimuthSample, elevationSample);
E3DAnomaly[] anomalies = match.Anomalies;

// TODO: if (anomalies.Length != 0): an anomaly was detected: inspect the sample manually? throw it away?
 
// get cloud to inspect it manually
EPointCloud visualisationCloud = new EPointCloud();
matcher.GetComparisonPointCloud(visualisationCloud);
```

--------------------------------

### EWedgeShape.InnerRadius (.NET)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/ewedgeshape-innerradius.htm

Gets the inner radius of the EWedgeShape.

```APIDOC
## float InnerRadius

### Description
Gets the inner radius of the EWedgeShape object.

### Namespace
Euresys.Open_eVision_22_12

### Property
- **float** - The inner radius value (Read-only).
```

--------------------------------

### Calculate a Calibration Model

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/03_Using/6_3D_Processing/3_Easy3DLaserLine/Object-Based_Calibration_Guidelines.htm

Demonstrates initializing a depth map, configuring the calibration generator, and computing the model.

```cpp
// Initialize a depth map from an image of a double truncated pyramid
                                        EDepthMap16 depth_map;depth_map.LoadImage("ctx1 calibration object.png");	// from Easy3D sample imagesdepth_map.SetZResolution(1.f / (1 << 5));		// 11.5 fixed point pixel format

// Initialize the calibration generatorEObjectBasedCalibrationGenerator calib_generator;calib_generator.SetCalibrationObjectType(EObjectBasedCalibrationType_TruncatedDoublePyramid, 40.f, 60.f, 10.f); // Type and size of the calibration object

// Compute the calibration modelEObjectBasedCalibrationModel calib_model;calib_model = calib_generator.Compute(depth_map);float error = calib_model.GetCalibrationError();

// Save the calibration modelcalib_model.Save("calib.model");.
```

--------------------------------

### EDeepLearningTool.Create (.NET)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/edeeplearningtool-create.htm?TocPath=Reference%7CClasses%7CEDeepLearningTool+Class%7C_____5

Factory method to open a deep learning tool in .NET.

```APIDOC
## EDeepLearningTool.Create (.NET)

### Description
Factory method to open a deep learning tool. Returns the corresponding deep learning tool.

### Signature
- EDeepLearningTool Create(string path)
- EDeepLearningTool Create(ESerializer serializer)

### Parameters
- **path** (string) - Path to a deep learning tool.
- **serializer** (ESerializer) - A serializer created for reading.
```

--------------------------------

### EWedge.OuterDiameter (C#)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/ewedge-outerdiameter.htm

Gets the outer diameter of the EWedge.

```APIDOC
## float OuterDiameter

### Description
Gets the nominal outer diameter of the EWedge object.

### Property
`float OuterDiameter { get; }`

### Namespace
Euresys.Open_eVision_22_12
```

--------------------------------

### Configure NVIDIA Jetson Repository

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/03_Using/5_Deep_Learning/1_EasyDeepLearning/Hardware_Support_CPU-GPU.htm

Configuration lines to add to the nvidia-l4t-apt-source.list file for JetPack SDK support.

```text
deb https://repo.download.nvidia.com/jetson/common r32.6 main  
deb https://repo.download.nvidia.com/jetson/t194 r32.6 main
```

--------------------------------

### EWedgeShape.OuterDiameter (C#)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/ewedgeshape-outerdiameter.htm

Gets the outer diameter of the EWedgeShape.

```APIDOC
## float OuterDiameter

### Description
Gets the outer diameter of the EWedgeShape.

### Signature
`float OuterDiameter { get; }`

### Remarks
A EWedgeShape is fully defined knowing its nominal position (its center coordinates), its nominal radius (diameter), its breadth, the angular position from where it extents, its angular amplitude, and its outline tolerance.
```

--------------------------------

### EWedge.OuterRadius (.NET/C#)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/ewedge-outerradius.htm?TocPath=Reference%7CClasses%7CEWedge+Class%7C_____28

Gets the outer radius of the EWedge.

```APIDOC
## float OuterRadius { get; }

### Description
Gets the outer radius of the EWedge object.

### Return Value
- **float**: The outer radius value.
```

--------------------------------

### List Neo Licenses

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/15_Neo_Licensing_System/Using_the_Offline_Command_Line.htm?TocPath=Getting+Started%7C_____22

Displays all licenses currently present on the system.

```bash
> NeoLicenseManagerCL.exe ListLicenses
Licenses on container 130-3613949292 (software):
     Open eVision EasyOCR
```

--------------------------------

### EWedgeShape.Breadth (C#)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/ewedgeshape-breadth.htm

Gets the breadth of the EWedgeShape instance.

```APIDOC
## float Breadth

### Description
Gets the breadth of the EWedgeShape.

### Signature
`float Breadth { get; }`

### Namespace
Euresys.Open_eVision_22_12
```

--------------------------------

### Line Fitting Measurement

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/07_EasyGauge/line-fitting.htm?TocPath=Resources%7CCode+Snippets%7CEasyGauge%7C_____2

Demonstrates the workflow for configuring a line gauge, performing a measurement on an image, and saving the gauge context.

```C++
////////////////////////////////////////////////////////////////////
// This code snippet shows how to create a line measurement tool, //
// adjust the transition parameters, set the nominal gauge        //
// position, perform the measurement and retrieve the result.     //
////////////////////////////////////////////////////////////////////

// Image constructor
EImageBW8 srcImage;

// ELineGauge constructor
ELineGauge lineGauge;

// Adjust the transition parameters
lineGauge.SetTransitionType(ETransitionType_Bw);
lineGauge.SetTransitionChoice(ETransitionChoice_NthFromEnd);
lineGauge.SetTransitionIndex(2);

// Set the line fitting gauge position,
// length (50 units) and orientation (20°)
EPoint center(256.f, 256.f);
ELine line(center, 50.f, 20.f);
lineGauge.SetLine(line);

// Measure
lineGauge.Measure(&srcImage);

// Get the origin and end point coordinates of the fitted line
EPoint originPoint = lineGauge.GetMeasuredLine().GetOrg();
EPoint endPoint = lineGauge.GetMeasuredLine().GetEnd();

// Save the point gauge measurement context
lineGauge.Save("myLineGauge.gge");
```

```.NET
////////////////////////////////////////////////////////////////////
// This code snippet shows how to create a line measurement tool, //
// adjust the transition parameters, set the nominal gauge        //
// position, perform the measurement and retrieve the result.     //
////////////////////////////////////////////////////////////////////

// Image constructor
EImageBW8 srcImage= new EImageBW8();

// ELineGauge constructor
ELineGauge lineGauge= new ELineGauge();

// Adjust the transition parameters
lineGauge.TransitionType= ETransitionType.Bw;
lineGauge.TransitionChoice= ETransitionChoice.NthFromEnd;
lineGauge.TransitionIndex= 2;

// Set the line fitting gauge position,
// length (50 units) and orientation (20°)
EPoint center= new EPoint(256.0f, 256.0f);
ELine line= new ELine(center, 50.0f, 20.0f);
lineGauge.Line= line;

// Measure
lineGauge.Measure(srcImage);

// Get the origin and end point coordinates of the fitted line
EPoint originPoint = lineGauge.MeasuredLine.Org;
EPoint endPoint = lineGauge.MeasuredLine.End;

// Save the point gauge measurement context
lineGauge.Save("myLineGauge.gge");
```

--------------------------------

### Select Licensing Models

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/15_Neo_Licensing_System/Selecting_the_Licensing_Model_OeV_only.htm?TocPath=Getting+Started%7C_____19

Call this function before any other Open eVision function to specify the required licensing models.

```C++
Preconfiguration::SelectLicensingModels(ELicensingModel model)
```

--------------------------------

### EWedgeShape.OuterDiameter (C#)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/ewedgeshape-outerdiameter.htm?TocPath=Reference%7CClasses%7CEWedgeShape+Class%7C_____33

Gets the outer diameter of the EWedgeShape.

```APIDOC
## float OuterDiameter { get; }

### Description
Gets the outer diameter of the EWedgeShape.

### Return Value
- **float** - The outer diameter value.
```

--------------------------------

### Create EDeepLearningTool in C++

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/edeeplearningtool-create.htm

Factory methods to open a deep learning tool using either a file path or an ESerializer instance.

```cpp
EDeepLearningTool* Create(  
const std::string& _path_  
)
```

```cpp
EDeepLearningTool* Create(  
ESerializer* _serializer_  
)
```

--------------------------------

### EWedgeShape.InnerDiameter (.NET)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/ewedgeshape-innerdiameter.htm?TocPath=Reference%7CClasses%7CEWedgeShape+Class%7C_____25

Gets the inner diameter of the EWedgeShape.

```APIDOC
## float InnerDiameter

### Description
Gets the inner diameter of the EWedgeShape.

### Signature
`float InnerDiameter { get; }`

### Namespace
Euresys.Open_eVision_22_12
```

--------------------------------

### ESupervisedSegmenterMetrics.BlobDetectionPrecision (.NET)

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/esupervisedsegmentermetrics-blobdetectionprecision.htm?TocPath=Reference%7CClasses%7CESupervisedSegmenterMetrics+Class%7C_____8

Gets the blob detection precision property.

```APIDOC
## float BlobDetectionPrecision

### Description
Gets the precision for blob detection given the current classification threshold. The precision is defined as the proportion of detected defective blobs that match ground truth defective blobs.

### Signature
`float BlobDetectionPrecision { get; }`

### Namespace
Euresys.Open_eVision_22_12.EasyDeepLearning
```

--------------------------------

### Create and Train a Classifier in .NET

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/03b_EasyDeepLearning/Creating_a_Dataset_and_Training_a_Classifier.htm?TocPath=Resources%7CCode+Snippets%7CDeep+Learning+Tools%7C_____1

Demonstrates the workflow for dataset preparation and classifier training using the .NET API, including explicit object disposal.

```csharp
//////////////////////////////////////////////////////////////
// This code snippet shows how to create a dataset, train a //
// classifier and get the best performance metrics obtained //
// during the training.                                     //
//////////////////////////////////////////////////////////////

// Creating dataset and classifier objects
EClassificationDataset dataset= new EClassificationDataset();
EClassificationDataset trainingDataset= new EClassificationDataset();
EClassificationDataset validationDataset= new EClassificationDataset();
EClassifier classifier= new EClassifier();

// Adding images using a glob pattern
dataset.AddImages("*good*.png", "good");
dataset.AddImages("*defective*.png", "defective");

// Enabling data augmentation on the dataset
dataset.EnableDataAugmentation= true;

// Rotation of up to 90°
dataset.MaxRotationAngle= 90.0F;

// Enabling horizontal flips
dataset.EnableHorizontalFlip= true;

// Splitting the dataset with 80% of images for the training dataset
// and 20% for the validation dataset
dataset.SplitDataset(trainingDataset, validationDataset, 0.8F);

// Training the classifier for 50 epochs
classifier.Train(trainingDataset, validationDataset, 50);
classifier.WaitForTrainingCompletion();

// Get the best metrics obtained on the validation dataset
EClassificationMetrics bestMetrics = classifier.GetValidationMetrics(classifier.BestEpoch);

// Dispose of objects
dataset.Dispose();
trainingDataset.Dispose();
validationDataset.Dispose();
classifier.Dispose();
```

--------------------------------

### ESupervisedSegmenter.Scale

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/esupervisedsegmenter-scale.htm?TocPath=Reference%7CClasses%7CESupervisedSegmenter+Class%7C_____15

Property to get or set the down-scaling factor in .NET.

```APIDOC
## .NET Property: Scale

### Description
Gets or sets the down-scaling factor applied to images before processing. The value must be between 0 and 1.

### Signature
float Scale { get; set; }
```

--------------------------------

### ESupervisedSegmenter.ForceGrayscale

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/esupervisedsegmenter-forcegrayscale.htm?TocPath=Reference%7CClasses%7CESupervisedSegmenter+Class%7C_____6

Property to get or set the ForceGrayscale value in .NET.

```APIDOC
## .NET: ForceGrayscale

### Description
Property to get or set whether the ESupervisedSegmenter converts all images to grayscale.

### Signature
bool ForceGrayscale { get; set; }
```

--------------------------------

### Sample pixels along a path in .NET

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/02_EasyImage/path-sampling.htm?TocPath=Resources%7CCode+Snippets%7CEasyImage%7CVector+Operations%7C_____1

Demonstrates path sampling in .NET, including accessing specific pixel values from the resulting path vector.

```.NET
//////////////////////////////////////////////////////////////
// This code snippet shows how to retrieve and store the    //
// pixel values along a given path together with the        //
// corresponding pixel coordinates.                         //
//////////////////////////////////////////////////////////////

// Image constructor
EImageBW8 srcImage= new EImageBW8();

// ...

// Vector constructor
EBW8PathVector path= new EBW8PathVector();
EBW8 bw8= new EBW8(128);

// Path definition
path.Empty();
for (int i = 0; i < 100; i++)
{
  EBW8Path p;
  p.X = (short)i;
  p.Y = (short)i;
  p.Pixel = bw8;
  path.AddElement(p);
}

// Get the image data along the path
EasyImage.ImageToPath(srcImage, path);
int pixel = path.GetElement(20).Pixel.UINT32Value;
```

--------------------------------

### ESupervisedSegmenter.ClassificationThreshold

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/esupervisedsegmenter-classificationthreshold.htm?TocPath=Reference%7CClasses%7CESupervisedSegmenter+Class%7C_____3

Property to get or set the classification threshold in .NET.

```APIDOC
## ESupervisedSegmenter.ClassificationThreshold

### Description
Gets or sets the classification threshold for determining whether an image contains blobs with a label different than the background.

### Signature
`float ClassificationThreshold { get; set; }`
```

--------------------------------

### ESupervisedSegmenter.Capacity

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/reference/esupervisedsegmenter-capacity.htm

Property to get or set the capacity of the ESupervisedSegmenter in .NET.

```APIDOC
## .NET Property: Capacity

### Description
Gets or sets the capacity of the ESupervisedSegmenter. A higher capacity allows the segmenter to learn more information but results in slower processing speeds.

### Signature
`Euresys.Open_eVision_22_12.EasyDeepLearning.ESupervisedSegmenterCapacity Capacity { get; set; }`
```

--------------------------------

### Using EObjectTemplateMatcher in .NET

Source: https://documentation.euresys.com/Products/OPEN_EVISION/OPEN_EVISION_22_12/en-us/Content/05_Resources/02_Code_Snippets/04_EasyObject/Using_the_Object_Template_Matcher.htm?TocPath=Resources%7CCode+Snippets%7CEasyObject%7C_____5

Demonstrates the workflow for encoding images, building a template, and performing alignment and matching using the .NET API.

```csharp
///////////////////////////////////////////////////////////////
// This code snippet shows how to use EObjectTemplateMatcher //
// for alignment and template matching                       //
///////////////////////////////////////////////////////////////

// Encode the template image
EImageEncoder encoder = new EImageEncoder();
ECodedImage2 coded_img = new ECodedImage2();

EImageBW8 template_img = new EImageBW8();
encoder.Encode(template_img, coded_img);

EObjectSelection object_select = new EObjectSelection();
object_select.AddObjects(coded_img);

// Initialize EObjectTemplateMatcher
EObjectTemplateMatcher object_matcher = new EObjectTemplateMatcher();
object_matcher.EnableAlignment = true; // optional
object_matcher.MaximumDistance = 60;   // optional

// set the template
object_matcher.BuildTemplate(object_select);

// Encode the test image
EImageBW8 test_img = new EImageBW8();
encoder.Encode(test_img, coded_img);

// Build a selection of test objects
object_select.Clear();
object_select.AddObjects(coded_img);
object_select.RemoveUsingUnsignedIntegerFeature(EFeature.Area, 10, ESingleThresholdMode.Less);  // optional filter

// Perform the alignment and the matching
object_matcher.SortSelection(object_select);

// Get the number of matches
int num = object_matcher.NumberOfPairedObjects;

// Retrieve the template indexes for each selection object
int[] template_indexes = object_matcher.TemplateIndexes;
```
Tokens:
Raw