Practical overview
When it fits
Use it when a document-image workflow needs table and cell boundaries represented in processed images and XML, especially when tables have different border styles.
Who it is for
- Document-processing teams preparing scanned pages for structured data workflows
- Computer-vision researchers exploring table detection and structure recognition
Documented uses
- Deskew document images before table processing
- Recognize cell layouts in bordered, unbordered and partially bordered tables
- Run table detection followed by structure recognition and save table and cell bounding boxes
Requirements & limits
The source code is public under the MIT license. The repository links to a Google Colab notebook and documents local Python scripts.
- The README lists PyTorch 1.7.0, Torchvision 0.8.1, CUDA 10.1 and PyYAML 5.1 as dependencies.
- The table-detection model is based on Detectron2, with a separate installation guide referenced by the project.
- Structure-recognition output includes XML bounding boxes for cells; the documented workflow does not specify cell-text extraction.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Run table structure recognition on a folder of table images
Process table images with a selected structure-recognition method and save processed images and cell bounding boxes.
Before you start
- Python 3
- PyTorch 1.7.0, Torchvision 0.8.1, CUDA 10.1 and PyYAML 5.1, as listed by the repository
- A folder of table images
Steps
Install the documented library dependencies.
Run the command below.
python3 tsr.pySet
--folderto the input image folder,--typetoborderd,unbordered,partiallyorpartially_color_inv,--img_outputto the processed-image output folder, and--xml_outputto the XML output folder.
Expected outcome
The workflow is documented to produce processed images and XML files containing cell bounding boxes.
Guide limitations
- The documented output is image processing and bounding-box data; the README does not describe extracting cell text.
- The dependency list and script instructions do not establish compatibility with other software versions.
Deskew document images before table processing
Apply the repository's image-alignment preprocessing to images in a folder.
Before you start
- Python 3
- A folder of document images
- The repository's listed dependencies: PyTorch 1.7.0, Torchvision 0.8.1, CUDA 10.1 and PyYAML 5.1
Steps
Run the command below.
python3 deskew.pySet
--folderto the input folder containing document images.Set
--outputto the destination folder for deskewed images.
Expected outcome
Deskewed images are written to the specified output folder.
Guide limitations
- This documented step covers image alignment preprocessing only, not table detection or structure recognition.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 17 October 2026
- Original website title
- Psarpei/Multi-Type-TD-TSR · Official homepage title · retained in its source language

