BobLd / simple-docstrum

A step-by-step C# implementation of the Docstrum algorithm

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

A step-by-step C# implementation of the Docstrum algorithm for pdf documents

How to run C# code in Jupyter Lab / How Install .NET Interactive

https://devblogs.microsoft.com/cesardelatorre/using-ml-net-in-jupyter-notebooks/

https://devblogs.microsoft.com/dotnet/net-interactive-is-here-net-notebooks-preview-2/ (if the previous fails when installing)

Description

Version 2 is the latest update and handles rotated words/lines/paragraphs. This is the version implemenented in PdfPig.

rotated example

Link to original paper: The Document Spectrum for Page Layout Analysis by Lawrence O'Gorman

From Performance Comparison of Six Algorithms for Page Segmentation: The Docstrum algorithm by O'Gorman is a bottom-up approach based on nearest-neighborhood clustering of connected components extracted from the document image. After noise removal, the connected components are separated into two groups, one with dominant characters and another one with characters in titles and section heading, using a character size ratio factor fd. Then, K nearest neighbors are found for each connected component. Then, text-lines are found by computing the transitive closure on within-line nearest neighbor pairings using a threshold ft. Finally, text-lines are merged to form text blocks using a parallel distance threshold fpa and a perpendicular distance threshold fpe. - wiki

Variables used in structural block determination

The variables can be accessed by using the GetStructuralBlockingParameters() function.

public static bool GetStructuralBlockingParameters(PdfLine i, PdfLine j, double epsilon,
    out double angularDifference, out double normalisedOverlap, out double perpendicularDistance)
    {
      ...
    }

From the original paper by O'Gorman:

Fig. 8 - Structural block determination

Fig. 8. Variables used in structural block determination. The two text lines, represented by segments i and j, are to be tested here to determine if they should be grouped into the same block. Their angular difference is θij. The overlap length of segment i on segment j is pj, (and that is normalized to obtain the overlap parameter). The parallel distance between i and j is daij = pj in this case. The perpendicular distance betwen i and j is deij.

Results

0.0 Open pdf document

raw

0.1 Extract words and preprocess

words

1. Estimate within-line and between-line spacing

1.1 Within-line (between words) spacing

1.2 Between-line spacing

2. Get lines

lines

3. Get paragraphs blocks

paragraphs

About

A step-by-step C# implementation of the Docstrum algorithm

License:MIT License


Languages

Language:Jupyter Notebook 100.0%