FalcoCV 1.2.0

Highlights

• LineFit and CircleFit — new metrology tools with ROI-driven caliper
  arrays, overlay/contour points mode, subpixel edge detection and robust
  outlier rejection.
• ShapeMatch geometry-only (model v4) — the fused native vote and geometry
  refinement are the only matcher path. ShapeMatch models v2/v3 are rejected
  and must be retrained.
• Non-blocking workflow execution — the Vision Editor runs workflows and
  RUN/AUTO on a background execution service instead of the GUI thread.
• Toolbox grouped by role — Acquisition, Processing, Inspection, 3D,
  Machine Learning and Logic, with per-group tool ordering.
• Communications — Omron and ADLINK USB-7250 validated on real hardware,
  Beckhoff ADS and Siemens S7 implemented, Modbus TCP and OPC UA clients and
  servers, and the dummy driver hidden from the designer.
• Reliability and UI — global wheel guard, Qt 6.12 ROI spin-box fix,
  Height Blobs visibility options and a compact ShapeMatch settings panel.

Breaking changes

• ShapeMatch models v2/v3 are no longer supported. Retrain existing jobs with
  model v4.
• The Features workflow port kind was removed; legacy metadata loads as an
  untyped (Any) port.
• The input points port was removed from LineFit/CircleFit. Use overlay or
  contour points instead.

Verification

• 893 passed, 8 skipped, 3 xfailed.
• Clean-checkout wheel and sdist built; wheel contents, falcocv self-test
  and the headless wheel smoke test pass.
• ShapeMatch 1005-frame gate: 0 lost / 0 extra, median 0.901 px.

Install

pip install --upgrade falcocv

FalcoCV 1.1.0

FalcoCV 1.1.0

This release focuses on industrial communications, HMI usability and 3D/depth analysis, with significant improvements to Shape Match and the workflow editor.

Highlights

Industrial communications

• New generic device, tag and quality runtime for HMI projects.
• Drivers for Omron, Beckhoff ADS, Siemens S7 and ADLINK DASK.
• Modbus TCP and OPC UA client support.
• New Modbus TCP and OPC UA server runtimes with explicit tag mappings.
• New Servers tab in the HMI Designer, integrated with project save, deploy and the HMI worker.
• Optional write verification with configurable retries.
• Local and live Signal Monitor for reading and writing tags.
• HMI widgets can be bound to communications tags.
• Native dependency diagnostics via falcocv native-deps.

HMI

• Communications editor integrated into the HMI Designer.
• HMI projects can be saved with incomplete configurations and completed later.
• Deploy prompt for unsaved changes and a recent-projects list.
• Runtime context available to Python Scripts and Blocks.
• New examples/demo_dashboard.hmi demo with result image, status, measurement, runtime log and an inspection cycle script.

Depth and 3D

• New .fcd depth container and TIFF conversion utility.
• Faster depth loading and point-cloud generation.
• PlaneFitter with a reusable plane model, fixed-Z ROIs, automatic Z margin and 3D overlays.
• New Height Blobs 3D tool for measuring regions above a reference plane.
• Improvements to 3D ROIs, 3D box editing and point-cloud visualisation.
• Point-cloud colors are generated only when needed.

Shape Match

• New manual feature editor with training mask.
• Automatic feature selection with spatial coverage.
• New training controls for Canny edges, minimum gradient and maximum feature count.
• New geometric matching mode, with hybrid mode available as the precision reference.
• Faster search and ROI-focused preprocessing.
• Validation documentation and known precision limits.

Workflow and editor

• Typed ports for images, planes and results; incompatible connections are no longer offered.
• Pattern Matcher has been renamed Template Match.
• Per-tool Run/Auto controls.
• Scrollable toolbox.
• Persistent window geometry, docks, splitters and table column widths.
• New View > Reset all views action.
• Improvements across PlaneFitter, Template Match, Shape Match and the 3D tools.

Documentation

• New guides for communications, depth, 3D conventions and the HMI context API.
• Updated screenshots for the Vision Editor, 3D viewer, HMI Designer and dashboard.

Upgrade notes

• Shape Match models created with 1.0.2 are not compatible and must be retrained.
• Jobs using the old Pattern Matcher must be updated to Template Match.
• New Shape Match tools use geometric matching by default; existing jobs keep hybrid matching when migrated.

Installation

python -m pip install falcocv==1.1.0

FalcoCV 1.0.2

FalcoCV 1.0.2

Tool errors

• Tools report failures through last_error; failed rows are shown in red with a tooltip.
• stop_on_error stops both the workflow and the run loop on the first failure.
• Configurable min_results for Shape Match, Pattern Matcher, Blob Detector, Edge Detection, Barcode Decoder and OCR.

OCR

• New min_results policy for text regions.
• Verify compares the recognized text with the expected text exactly, after optional trimming plus case, whitespace and accent normalization. There is no similarity threshold.
• Empty expected text, no recognized text and text mismatches are tool errors.

Measurement

• Fails when a configured source element is missing or has an incompatible type.
• Valid rows still produce partial results, and disabled rows are ignored.

Plane Fitter

• Reports missing input, missing depth data, missing or empty 3D point clouds, kernel errors, fits without inliers and invalid plane parameters.

Input validation

• Filters, Histogram, Image Calculator, Fixture Overlay, Classifier, Anomaly Detector and Python Script now fail on missing or invalid inputs.
• Classifier and Anomaly Detector fail when untrained or when inference raises.
• Image Calculator requires image B for enabled two-input operations.

Workflow

• Every run clears the previous inputs and outputs, so stale images cannot leak into the next cycle.
• The workflow keeps the first tool error when execution continues.

Other changes

• Blob Detector Outer/Nested modes and the rotated-ROI mask fix.
• Shape Match ROI-independent search and performance improvements.
• Workflow tree and Block configuration fixes; run loops stop on error.

Install

pip install falcocv==1.0.2

Models are downloaded on first use.

FalcoCV 1.0.1

FalcoCV 1.0.1

• Requires CPython 3.13.x (only supported version for this release).
• Windows x86_64 and Linux x86_64 cp313 wheels.
• Native kernel now uses the VC++ OpenMP runtime (vcomp140), avoiding a dependency on the non-redistributable libomp140 DLL.
• Tested from TestPyPI and PyPI: wheel install, falcocv self-test, demo job and web server.

PyPI: https://pypi.org/project/falcocv/1.0.1/

FalcoCV models v1

ONNX weights used by FalcoCV (EfficientNet-B0, ResNet18, PP-OCRv5).

They are not bundled in the wheel/sdist: the application downloads them on
first run with falcocv download-models into

• Windows: %APPDATA%\FalcoCV\models
• Linux: $XDG_DATA_HOME/FalcoCV/models (or ~/.local/share/FalcoCV/models)

See NOTICE.md for provenance, licenses and SHA-256 hashes.