This is a data package repository that process orders obtained from department of Rural Development 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.
All the data is available in the (flow/writeTxt_/output/) folder and it contains the following files
-
mahrural2024-*.pdf.en.txt: Orders in Marathi.
-
mahrural2024-*.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.
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.
If you want to make changes and regenerate data you have two choices
- Use GitHub codespaces (WIP).
- 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.
- Git with Git LFS
- Python 3.7+
- Poetry
- make
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.
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.
To install Poetry, visit the Poetry website and follow installation instructions for your operating system:
On Unix based make
should come pre-installed, on Windows use winget
to install make
, follow instructions here.
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.
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/mahrural2024.git
Navigate to the project directory:
cd mahrural2024
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
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 !!