Orders of deparment of Revenue and Forest Department Government of Maharashtra

This is a data package repository that process orders obtained from department of Revenue and Forest Department Government of Maharasthra. The data is obtained by processing orders from Government of Maharashtra's Orders Website website.

The data package contains text files containting orders in original Marathi and translated to English. The text file do not contain the order appendix pages. The following operations are performed on all PDFs 1) OCR 2) Table Extraction 3) Para Extraction 4) Translation.

Accessing the data

All the data is available in the (flow/writeTxt_/output/) folder and it contains the following files

1. mahrev2024-*.pdf.en.txt: Orders in Marathi.

2. mahrev2024-*.pdf.mr.txt: Orders in English.

The data is currently not relased through PyPI once advanced informaion is extracted the data will be released on PyPI.

Data Processing

This is a data package repository - it contains all both the pipeline for generating data and the data generated. In a sense it is different from code repositories that only contain code and not the artifacts the code generates.

The data processing is broken down in series of Tasks, where each task processes the data created in the upstream task (links in the input folder) and generages new data stored in the output folder. The directory layout of this repository follows the ideas mentioned in this video: Principled Data Processing by Patrick Ball. There are 3 main top-level directories import, flow and export. A simple makefile orchestrates the document flow across these folders, run make help to find out more about the commands.

You can check out the template repository template.mahdept where each directory and sub-directory is explained.

Deverloper Notes

If you want to make changes and regenerate data you have two choices

1. Use GitHub codespaces (WIP).
2. Build locally, for this you will need at least 20 GB of space, as we store documents, intermediate data and final data locally. To minimize the space requirement it is recommended that you work only on the buildOrder/* and downstream tasks.

Local Development

Prerequisites

• Git with Git LFS
• Python 3.7+
• Poetry
• make

Installation

Git & Git LFS

To install Git, visit the Git website and follow the installation instructions for your operating system. For make sure Git-LFS stays enabled (default option). For othe platforms follow these instructions on Github.

Python

To install Python, visit the Python website and download the version of Python 3.x for your operating system. Follow the installation instructions for your operating system.

Poetry

To install Poetry, visit the Poetry website and follow installation instructions for your operating system:

Make

On Unix based make should come pre-installed, on Windows use winget to install make, follow instructions here.

Setup

Orgpedia repository makes heavy use of soft-links, soft-links are stored in the GitHub repository. On non-windows platforms this is not a problem for Windows you need to do two things 1) enable soft-links and 2) tell git about it.

Symlinks Setup On Windows

On Windows 11, make sure you have enabled deverloper mode this will automatically enable soft-links on your machine. On windows 10 soft-links were added in Build 14972 and only works on Administrator cmd prompt. More info at this link.

Next you need to tell git it should create soft-links when it sees them in the respository, check the Stack Overflow answer to know more about this. Execute the following command.

git config --global core.symlinks true

To setup the project, clone the repository using git (this is a large repository, will take several minutes):

git clone https://github.com/orgpedia/mahrev2024.git

Navigate to the project directory:

cd mahrev2024

Use poetry to install software dependencies(one time only):

make install

Import models and other data-packages required for the document flow (one time only), these will be downloaded in the import folders and it takes a long time.

make import

Generate Data

After this you should have all the files needed to generate the data. Make whatever changes you need to make and then execute

make flow

This will generate the data based on your changes. Currently, make does not track dependencies as a result the entire document flow is re-executed !!