ridge-detector 0.1.4

A multi-scale ridge detector for identifying curvilinear structures in images

Multi-Scale Ridge Detector

If you find this project useful, please consider giving it a star so that more people can discover and benefit from it!

Overview

This repository contains the Python implementation of a multi-scale ridge detector designed for identifying and measuring curvilinear structures in images across various fields including medical imaging and remote sensing. For more detailed information, please refer to the following literature:

[1] Steger, Carsten. "An unbiased detector of curvilinear structures." IEEE Transactions on Pattern Analysis and Machine Intelligence, 20(2), pp. 113-125, 1998.

[2] Lindeberg, Tony. "Edge detection and ridge detection with automatic scale selection." International Journal of Computer Vision, 30, pp. 117-156, 1998.

[3] Sato, Yoshinobu, et. al. "Three-dimensional multi-scale line filter for segmentation and visualization of curvilinear structures in medical images." Medical Image Analysis, 2(2), pp. 143-168, 1998.

This Python implementation offers a multi-scale adaptation of the ImageJ ridge detection plugin. The detection is more accuracy compared to the ImageJ plugin (in almost all cases we have tested :)) and faster than another Python implementation ridge-detection.

Installation

Prerequisites

• Python 3.9 or higher
• Opencv & scikit-image

Install via pip:

pip install ridge-detector

or

 pip install git+https://github.com/lxfhfut/ridge-detector.git

Usage:

from ridge_detector import RidgeDetector
det = RidgeDetector(line_widths=[1, 2, 3],  # Line widths to detect (default: [1, 2])
                    low_contrast=100,  # Lower bound of intensity contrast (default: 100)
                    high_contrast=200,  # Higher bound of intensity contrast (default: 200)
                    min_len=5, # Ignore ridges shorter than this length (default: 5)
                    max_len=0, # Ignore ridges longer than this length, set to 0 for no limit (default: 0)
                    dark_line=True, # Set to True if detecting black ridges in white background, False otherwise (default: True)
                    estimate_width=True, # Estimate width for each detected ridge point (default: True)
                    extend_line=False, # Tend to preserve ridges near junctions if set to True (default: False)
                    correct_pos=False,  # Correct ridge positions with asymmetric widths if set to True (default: False)
                    )
det.detect_lines("path_to_image_or_image_data_in_numpy_array")
det.show_results()
det.save_results("directory_to_store_results")  # Save the detection results to the specified directory

Demonstrations

Original	Ridges & Widths	Binary Ridges	Binary Widths