Data

Tools

Indexes

Applications

Experiments

Open Source Science

glyphnet-pytorch

Сracking Egyptologist's MNIST: PyTorch implementation of the Glyphnet model introduced in "A Deep Learning Approach to Ancient Egyptian Hieroglyphs Classification", Barucci et al., 2021.

https://github.com/alexeyev/glyphnet-pytorch

Science Score: 54.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ✓
    CITATION.cff file
    Found CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ✓
    Academic publication links
    Links to: ieee.org
  • ○
    Academic email domains
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (12.0%) to scientific vocabulary

Keywords

computer-vision deep-learning egyptian-hieroglyphics egyptology hieroglyph-recognition hieroglyphics inception
Last synced: 6 months ago · JSON representation ·

Repository

Сracking Egyptologist's MNIST: PyTorch implementation of the Glyphnet model introduced in "A Deep Learning Approach to Ancient Egyptian Hieroglyphs Classification", Barucci et al., 2021.

Basic Info
  • Host: GitHub
  • Owner: alexeyev
  • License: mit
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 62.5 KB
Statistics
  • Stars: 14
  • Watchers: 1
  • Forks: 4
  • Open Issues: 0
  • Releases: 0
Topics
computer-vision deep-learning egyptian-hieroglyphics egyptology hieroglyph-recognition hieroglyphics inception
Created over 4 years ago · Last pushed over 3 years ago
Metadata Files
Readme License Citation

README.md

glyphnet-pytorch

Python 3x

This repository presents a custom (non-official) PyTorch-based implementation of the Glyphnet classifier introduced in the work A Deep Learning Approach to Ancient Egyptian Hieroglyphs Classification, 2021 and applies it to the data accompanying the work "Automatic Egyptian Hieroglyph Recognition by Retrieving Images as Texts", 2013 (NB! Glyphnet paper uses a larger dataset).

what | a | pretty | bird | you | are ------------ | ------------- | ------------- | ------------- | ------------- | ------------- G17 | G26 | G25 | G4 | G5 | G43

We hope that this implementation of the model will encourage the further research in this direction.

UPDATE April 2022: the original AUTHORS' CODE is now available.

Requirements

Please see requirements.txt.

Quickstart

TL;DR: run prepare_data.sh, then main.py.

Setting everything up

An entry point is the script prepare_data.sh that downloads the dataset and splits it into train/test parts in a 'stratified' manner, i.e. keeping all labels with just a single image in the training set, yet preserving similar label counts distributions in each part of the dataset.

It should print

DEBUG:root:Labels total: 172
DEBUG:root:Labels seen just once: 37

before shutting down.

Training

Training script main.py uses standard hydra configuration mechanism; the parameters one can modify at the CLI call can be found in configs/....

bash python3 main.py model.epochs=10

How to cite

If you use the GlyphNet model, please cite the original work:

bibtex @article{barucci2021deep, title={A Deep Learning Approach to Ancient Egyptian Hieroglyphs Classification}, author={Barucci, Andrea and Cucci, Costanza and Franci, Massimiliano and Loschiavo, Marco and Argenti, Fabrizio}, journal={IEEE Access}, volume={9}, pages={123438--123447}, year={2021}, publisher={IEEE} }

If you use the dataset, please cite the original work:

bibtex @inproceedings{franken2013automatic, title={Automatic Egyptian hieroglyph recognition by retrieving images as texts}, author={Franken, Morris and van Gemert, Jan C}, booktitle={Proceedings of the 21st ACM international conference on Multimedia}, pages={765--768}, year={2013} }

Citing this repository is also appreciated:

bibtex @misc{glyphnetpytorch2021alekseev, title = {{alexeyev/glyphnet-pytorch: GlyphNet, PyTorch implementation}}, author = {Anton Alekseev}, year = {2021}, url = {https://github.com/alexeyev/glyphnet-pytorch}, language = {english} }

TODO

  • Add a practical usage scenario using data augmentation
  • Add an end-to-end image-to-prediction inference script using a pre-trained GlyphNet model

Notes

Owner

  • Name: Anton Alekseev
  • Login: alexeyev
  • Kind: user

Citation (CITATION.cff) 

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
  - family-names: Alekseev
    given-names: Anton
    orcid: https://orcid.org/0000-0001-6456-3329
title: "glyphnet-pytorch"
date-released: 2021-12-19

GitHub Events

Total
  • Watch event: 2
Last Year
  • Watch event: 2

Issues and Pull Requests

Last synced: 9 months ago

All Time
  • Total issues: 0
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 0
  • Total pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels