Data

Tools

Indexes

Applications

Experiments

Open Source Science

py-microdots

A modern Python library to work with Anoto dot patterns.

https://github.com/cheind/py-microdots

Science Score: 67.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
    Found 3 DOI reference(s) in README
  • ✓
    Academic publication links
    Links to: zenodo.org
  • ○
    Academic email domains
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (10.1%) to scientific vocabulary
Last synced: 7 months ago · JSON representation ·

Repository

A modern Python library to work with Anoto dot patterns.

Basic Info
  • Host: GitHub
  • Owner: cheind
  • License: mit
  • Language: Python
  • Default Branch: develop
  • Homepage:
  • Size: 206 KB
Statistics
  • Stars: 11
  • Watchers: 3
  • Forks: 4
  • Open Issues: 0
  • Releases: 0
Created over 3 years ago · Last pushed over 2 years ago
Metadata Files
Readme License Citation

README.md

DOI

py-microdots

This repository provides py-microdots, a Python library for encoding and decoding 2D locations based on the Anoto dot pattern approach.

The Anoto grid pattern encodes a unique 2D position for every possible 6x6 sub-array of dots. Assuming a grid resolution of 0.3 mm, this coding remains unique over the area of Europe and Asia. For clarity, the dots are significantly scaled up and nominal grid lines are shown.

Paper / Cite

This implementation is based on my personal research on the Anoto coding. My findings are published in the following paper

@InProceedings{cheind2023microdots, author="Heindl, Christoph", title="py-microdots: Position Encoding in the Euclidean Plane Based on the Anoto Codec", booktitle="Intelligent Computing. Computing Conference SAI", year="2023", publisher="Springer Nature Switzerland", pages="219--235", isbn="978-3-031-37963-5" }

A pre-print of the report is available here.

Features

py-microdots offers the following features

  • Decoding of position coordinates, section coordinates and pattern rotations.
  • Encoding support including section coordinates
  • Drawing routines
  • Generalized interface that supports tailored coding variants (e.g. 4x4 codes)

Scope

The focus of this library is depicted in the following diagram

py-microdots focuses on encoding and decoding of bit-matrices and does not come with image processing or plotting capabilites.

Example

```python

Import the library

import microdots as mdots

Use the default embodiment with A4 sequence fixed (see paper)

codec = mdots.anoto6x6a4_fixed

Generate a bit-matrix for section (10,2)

G = codec.encode_bitmatrix(shape=(9, 16), section=(10, 2))

Render dots

import matplotlib.pyplot as plt

fig, ax = plt.subplots() mdots.drawdots(G, gridsize=1.0, show_grid=True, ax=ax) fig.savefig("dots.pdf") plt.close(fig)

Decode a partial matrix

S = G[3 : 3 + 6, 7 : 7 + 6]

pos = codec.decodeposition(S) sec = codec.decodesection(S, pos=pos)

To decode the rotation, use an extended matrix

R = G[3 : 3 + 8, 7 : 7 + 8] rot = codec.decode_rotation(R) print("pos:", pos, "sec:", sec, "rot:", rot)

> pos: (7, 3) sec: (10, 2) rot: 0

```

Owner

  • Name: Christoph Heindl
  • Login: cheind
  • Kind: user
  • Location: Austrian area

I am a computer scientist working at the interface of perception, robotics and deep learning.

Citation (CITATION.cff) 

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
    - family-names: Heindl
      given-names: Christoph
      orcid: https://orcid.org/0000-0002-6362-8976
title: "py-microdots and the Anoto Codec"
version: 1.0.0
doi: 10.5281/zenodo.7009235
date-released: 2022-08-19

GitHub Events

Total
  • Watch event: 5
  • Fork event: 1
Last Year
  • Watch event: 5
  • Fork event: 1

Issues and Pull Requests

Last synced: 12 months ago

All Time
  • Total issues: 0
  • Total pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: less than a minute
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • 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
  • cheind (1)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

.github/workflows/python-package.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v3 composite
requirements/dev-requirements.txt pypi
  • black * development
  • flake8 * development
  • ipython * development
  • pandas * development
  • pytest * development
requirements/requirements.txt pypi
  • matplotlib *
  • numpy *
setup.py pypi