Skip to content

leonlenk/LaTeX_OCR

Repository files navigation

LaTeX-OCR: Handwriting to LaTeX OCR Project

LaTeX-OCR Welcome to LaTeX-OCR, an open-source implementation of a photomath style scan-and-render LaTeX OCR model! We use the power of PyTorch to scan your handwritten math, whether it be on tablet or paper, and convert it to LaTeX code. No more typing out complex equations - just write it down, scan it, and let LaTeX-OCR do the rest.

Samples

image

image

From top to bottom: Ground truth, predicted LaTeX.

On test samples from the CRHOME 2013 handwritten digit competition:

image

image

From a tablet handwritten validation image:

image

image

Features

  • Handwriting Recognition: Uses a deep learning model trained on a large dataset of handwritten mathematical symbols and equations.
  • LaTeX Conversion: Converts recognized handwriting into LaTeX code, ready to be used in your documents.
  • Open-Source: All the details of our implementation can be found in this repository.

Installation

To get started with Hand2LaTeX, you'll need to have Python 3.6+ and PyTorch 1.0+ installed. To finetune your own model, follow the instructions below to set up the dataset.

  1. Go to Kaggle's Handwritten Mathematical Expressions and download the dataset. Move archive.zip into the LaTeX_OCR directory.
  2. Run the following:
conda create -n latexocr python==3.11
conda activate latexocr
pip install -r requirements.txt
bash ./setup.sh

You should see all checks passed after running setup.sh. 4. Images can be found in img_data, and image name / label pairs are in img_data/labels.csv.

Todo:

Not yet implemented:

  • RCNN + TrOCR segmentation-OCR pipeline.
  • Model distillation and quantization.
  • Rearrange code structure to a python package.

Usage

To begin, run train_TrOCR.ipynb in scripts. Scroll down to the "Validation on REAL Handwritten Digits" header to run the model on your own validation images.

Training the Model

Call python scripts/train_TrOCR.py with the --gpu flag to indicate which GPU to use. Default is 0.

Contributing

Contributions to LaTeX-OCR are welcome! Whether it's bug reports, feature requests, or new code, we appreciate all help.

License

LaTeX-OCR is licensed under the MIT License. See LICENSE for more details.

Acknowledgements

We thank Professor Bolei Zhou as well as all the members of ACM AI.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •