Grikod (Gri Kod, Gray Code)

PyPI
Conda
DOI
License: MIT

A Python library for converting binary numbers to Gray Code with ease.

Tanım (Türkçe)

Gri Kod: Grikod İkili sayıları Gri Koda çevirir.

Description (English)

Gri Kod: Grikod converts binary numbers to Gray Code.

Kurulum (Türkçe) / Installation (English)

Python ile Kurulum / Install with pip, conda, mamba

pip install grikod -U
python -m pip install -U grikod
conda install bilgi::grikod -y
mamba install bilgi::grikod -y

- pip uninstall grikod -y
+ pip install -U grikod
+ python -m pip install -U grikod

PyPI

Test Kurulumu / Test Installation

pip install -i https://test.pypi.org/simple/ grikod -U

Github Master Kurulumu / GitHub Master Installation

Terminal:

pip install git+https://github.com/KuantumBS/grikod.git

Jupyter Lab, Notebook, Visual Studio Code:

!pip install git+https://github.com/KuantumBS/grikod.git
# or
%pip install git+https://github.com/KuantumBS/grikod.git

Kullanım (Türkçe) / Usage (English)

import grikod
grikod.ikili_2_gri_kod("1010")

'1111'

# Restart Kernel veya/or Restart Kernel and Clear Outputs
import importlib
import grikod

# Önce alt modülü yeniden yükleyin
import grikod.grikod  # gerekirse otomatik import edilir
importlib.reload(grikod.grikod)  # grikod.py dosyasını yeniden çalıştır

# Ardından paketi yeniden yükleyin (isteğe bağlı)
importlib.reload(grikod)

# Run this cell (Shift+Enter): Input: 100
# Output example
# 000:000
# 001:001
# 010:011
# 011:010
# 100:110
# 101:111
# 110:101
# 111:100

import grikod
grikod.__version__

import grikod
grikod.main()  # CLI'ı başlat

or

import importlib
import grikod

importlib.reload(grikod)  # Modülü yeniden yükle
grikod.main()  # Şimdi çalışmalı

Enter a binary number (or 'q' to quit):  100
Gray Code number: 110
Enter a binary number (or 'q' to quit):  111
Gray Code number: 100
Enter a binary number (or 'q' to quit):  q
Exiting...

Development

# Clone the repository
git clone https://github.com/KuantumBS/grikod.git
cd grikod

# Install in development mode
python -m pip install -ve . # Install package in development mode

# Run tests
pytest

Notebook, Jupyterlab, Colab, Visual Studio Code
!python -m pip install git+https://github.com/KuantumBS/grikod.git

Citation

If this library was useful to you in your research, please cite us. Following the GitHub citation standards, here is the recommended citation.

BibTeX

@software{kececi_2025_12731345,
  author       = {Keçeci, Mehmet},
  title        = {Grikod},
  month        = may,
  year         = 2025,
  publisher    = {GitHub, PYPI (Python Package Index, Python
                   Software Foundation), Anaconda, Zenodo
                  },
  doi          = {10.5281/zenodo.12731345},
  url          = {https://doi.org/10.5281/zenodo.12731345},
}

@software{Kececi_Gri_Kod_2024,
    author = {Keçeci, Mehmet},
    license = {MIT},
    month = nov,
    title = {{Gri Kod}},
    url = {https://pypi.org/project/grikod/},
    version = {1.1.0},
    year = {2025}
}

@software{Kececi_Gri_Kod_2024,
    author = {Keçeci, Mehmet},
    license = {MIT},
    month = nov,
    title = {{Gri Kod}},
    url = {https://pypi.org/project/grikod/},
    version = {1.0.80},
    year = {2024}
}

### APA

Keçeci, M. (2025). Grikod [Data set]. WorkflowHub. https://doi.org/10.48546/workflowhub.datafile.12.1; https://doi.org/10.48546/workflowhub.datafile.12.2

Keçeci, M. (2025). Grikod. Zenodo. https://doi.org/10.5281/zenodo.12731345

### Chicago

Keçeci, Mehmet. "Grikod" [Data set]. WorkflowHub, 2025. https://doi.org/10.48546/workflowhub.datafile.12.1; https://doi.org/10.48546/workflowhub.datafile.12.2

Keçeci, Mehmet. "Grikod". Zenodo, 06 Mayıs 2025. https://doi.org/10.5281/zenodo.12731345.

### Lisans (Türkçe) / License (English)

This project is licensed under the MIT License.

Pixi:

pixi init try-grikod

cd try-grikod

pixi workspace channel add https://repo.prefix.dev/bilgi --prepend

✔ Added https://repo.prefix.dev/bilgi

pixi add grikod

✔ Added grikod >=1.1.9,<2

pixi install

pixi shell

pixi run python -c "import grikod; print(grikod.version)"

Çıktı: 1.1.6

pixi remove grikod

conda install -c https://prefix.dev/bilgi grikod

pixi run python -c "import grikod; print(grikod.version)"

Çıktı: 1.1.6

pixi run pip list | grep grikod

grikod 1.1.6

pixi run pip show grikod

Name: grikod

Version: 1.1.6

Summary: Converts binary numbers to Gray Code. Grikod (Gray Code, Grey Code)

Home-page: https://github.com/KuantumBS/grikod

Author: Mehmet Keçeci

Author-email: Mehmet Keçeci <...>

License: MIT License

Copyright (c) 2024 Mehmet Keçeci