🖥
🖥
🖥
🖥
AugeLab Studio Manual
English
K
Comment on page

# Minimum Ellipse

## Minimum Ellipse Node Documentation

The `Minimum Ellipse` node in AugeLab Studio calculates the minimum enclosing ellipse for a given contour. It outputs the image with the enclosing ellipse drawn, the center coordinates of the ellipse, the major and minor axis radii, and the angle of rotation.

### Node Overview

The `Minimum Ellipse` node takes an image and a contour as inputs and provides the following outputs:
1. 1.
Image: The input image with the minimum enclosing ellipse drawn.
2. 2.
Center: The center coordinates of the minimum enclosing ellipse.
3. 3.
4. 4.
5. 5.
Angle: The angle of rotation of the minimum enclosing ellipse.

### Node Properties

• Node Title: Minimum Ellipse
• Node ID: OP_NODE_MIN_ELLIPSE

### Inputs

The `Minimum Ellipse` node has the following input sockets:
1. 1.
Image: The input image.
2. 2.
Contour: The contour for which the minimum enclosing ellipse is to be calculated.

### Outputs

The `Minimum Ellipse` node has the following output sockets:
1. 1.
Image: The input image with the minimum enclosing ellipse drawn.
2. 2.
Center: The center coordinates of the minimum enclosing ellipse.
3. 3.
4. 4.
5. 5.
Angle: The angle of rotation of the minimum enclosing ellipse.

### Node Interaction

1. 1.
Connect an image to the Image input socket of the `Minimum Ellipse` node.
2. 2.
Connect a contour to the Contour input socket of the `Minimum Ellipse` node.
3. 3.
Run the pipeline.
4. 4.
The output sockets will provide the image with the minimum enclosing ellipse drawn, the center coordinates of the ellipse, the major and minor axis radii, and the angle of rotation.

### Implementation Details

The `Minimum Ellipse` node uses the `cv2.fitEllipse` function from the OpenCV library to calculate the minimum enclosing ellipse for the given contour. The function returns the center coordinates, major and minor axis lengths, and the angle of rotation of the ellipse. The node then draws the minimum enclosing ellipse on the input image using the obtained parameters.

### Usage

1. 1.
Drag and drop the `Minimum Ellipse` node from the node library onto the canvas in AugeLab Studio.
2. 2.
Connect an image to the Image input socket of the `Minimum Ellipse` node.
3. 3.
Connect a contour to the Contour input socket of the `Minimum Ellipse` node.
4. 4.
Run the pipeline.
5. 5.
The output sockets of the `Minimum Ellipse` node will provide the image with the minimum enclosing ellipse drawn, the center coordinates of the ellipse, the major and minor axis radii, and the angle of rotation.
• The `Minimum Ellipse` node is useful for calculating the minimum enclosing ellipse for a given contour in an image.
• The node outputs the image with the minimum enclosing ellipse drawn, allowing you to visualize the ellipse.
• The center coordinates, major and minor axis radii, and the angle of rotation can be used for further analysis or calculations.
• Ensure that the input image and contour are correctly connected to the corresponding input sockets of the `Minimum Ellipse` node.
• The output socket Image provides the input image with the minimum enclosing ellipse drawn.
• The output socket Center provides the center coordinates of the minimum enclosing ellipse.
• The output socket Radius1 provides the major axis radius of the minimum enclosing ellipse.
• The output socket Radius2 provides the minor axis radius of the minimum enclosing ellipse.
• The output socket Angle provides the angle of rotation of the minimum enclosing ellipse.
That concludes the documentation for the `Minimum Ellipse` node in AugeLab Studio. Use this node to calculate the minimum enclosing ellipse for a contour in an image and extract the center coordinates, major and minor axis radii, and the angle of rotation for further analysis or visualization.