eccentricity_xld — 2D features op

Data kinds: contourfeature

Call: fullseye.apply(img, "eccentricity_xld", a=0.5, b=0.5) (the 2-D model is one image plus two scalar knobs a,b∈[0,1])

HALCON equivalent: eccentricity_xld (the HALCON reference is a useful guide to its meaning and parameters)

Usage

Fits an ellipse to the largest contour (with 5 or more points) using `cv2.fitEllipse and returns its eccentricity sqrt(1-(minor axis/major axis)^2) (0 = perfect circle, closer to 1 = more elongated). Corresponds to HALCON's eccentricity_xld` (Shape features derived from the ellipse parameters of contours or polygons.). Returns 0 if cv2 is unavailable or there are too few points.

> The detailed description below is the original text — the summary and the headings are translated.

`a, b` は未使用。

Detailed usage guide

gallery2d_features family guide

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

gallery2d_featurespy -3.11 examples/gallery2d_features.py

Ops the type connects to (they accept feature as input)

identity

Same category (features)

blob_count · area_frac · count_contours · total_length · vol_count · sk_euler · sk_entropy_feat · sk_blur_effect


*Provenance: ops.py — 2D operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.