conversions.binary_to_gray_code
===============================

.. py:module:: conversions.binary_to_gray_code

.. autoapi-nested-parse::

   Convert between Binary and Gray Code representations.

   Gray Code (also known as reflected binary code) is a binary numeral system where
   two successive values differ in only one bit. This property makes it useful in
   error correction, digital communications, and position encoders.

   Wikipedia: https://en.wikipedia.org/wiki/Gray_code



Attributes
----------

.. autoapisummary::

   conversions.binary_to_gray_code.binary


Functions
---------

.. autoapisummary::

   conversions.binary_to_gray_code.binary_to_gray
   conversions.binary_to_gray_code.decimal_to_gray
   conversions.binary_to_gray_code.gray_to_binary
   conversions.binary_to_gray_code.gray_to_decimal


Module Contents
---------------

.. py:function:: binary_to_gray(binary_number: int) -> int

   Convert a binary number to its Gray Code equivalent.

   The algorithm works by XORing the binary number with itself right-shifted by 1.
   Formula: gray = binary XOR (binary >> 1)

   Args:
       binary_number: A positive integer representing a binary number

   Returns:
       The Gray Code equivalent as an integer

   Examples:
   >>> binary_to_gray(0)
   0
   >>> binary_to_gray(1)
   1
   >>> binary_to_gray(2)
   3
   >>> binary_to_gray(3)
   2
   >>> binary_to_gray(4)
   6
   >>> binary_to_gray(7)
   4
   >>> binary_to_gray(10)
   15
   >>> binary_to_gray(15)
   8
   >>> binary_to_gray(255)
   128
   >>> binary_to_gray(-1)
   Traceback (most recent call last):
       ...
   ValueError: Input must be a non-negative integer
   >>> binary_to_gray(3.5)
   Traceback (most recent call last):
       ...
   TypeError: Input must be an integer


.. py:function:: decimal_to_gray(decimal_number: int) -> str

   Convert a decimal number to its Gray Code representation as a binary string.

   Args:
       decimal_number: A positive integer in decimal

   Returns:
       Gray Code representation as a binary string

   Examples:
   >>> decimal_to_gray(0)
   '0'
   >>> decimal_to_gray(1)
   '1'
   >>> decimal_to_gray(2)
   '11'
   >>> decimal_to_gray(3)
   '10'
   >>> decimal_to_gray(4)
   '110'
   >>> decimal_to_gray(10)
   '1111'
   >>> decimal_to_gray(15)
   '1000'
   >>> decimal_to_gray(-1)
   Traceback (most recent call last):
       ...
   ValueError: Input must be a non-negative integer


.. py:function:: gray_to_binary(gray_number: int) -> int

   Convert a Gray Code number to its binary equivalent.

   The algorithm works by repeatedly XORing the gray code with itself right-shifted,
   until the right-shifted value becomes 0.

   Args:
       gray_number: A positive integer representing a Gray Code number

   Returns:
       The binary equivalent as an integer

   Examples:
   >>> gray_to_binary(0)
   0
   >>> gray_to_binary(1)
   1
   >>> gray_to_binary(3)
   2
   >>> gray_to_binary(2)
   3
   >>> gray_to_binary(6)
   4
   >>> gray_to_binary(4)
   7
   >>> gray_to_binary(15)
   10
   >>> gray_to_binary(8)
   15
   >>> gray_to_binary(128)
   255
   >>> gray_to_binary(-1)
   Traceback (most recent call last):
       ...
   ValueError: Input must be a non-negative integer
   >>> gray_to_binary(5.5)
   Traceback (most recent call last):
       ...
   TypeError: Input must be an integer


.. py:function:: gray_to_decimal(gray_string: str) -> int

   Convert a Gray Code binary string to its decimal equivalent.

   Args:
       gray_string: A string of 0s and 1s representing Gray Code

   Returns:
       The decimal equivalent as an integer

   Examples:
   >>> gray_to_decimal('0')
   0
   >>> gray_to_decimal('1')
   1
   >>> gray_to_decimal('11')
   2
   >>> gray_to_decimal('10')
   3
   >>> gray_to_decimal('110')
   4
   >>> gray_to_decimal('1111')
   10
   >>> gray_to_decimal('1000')
   15
   >>> gray_to_decimal('invalid')
   Traceback (most recent call last):
       ...
   ValueError: Invalid binary string
   >>> gray_to_decimal('')
   Traceback (most recent call last):
       ...
   ValueError: Input string cannot be empty


.. py:data:: binary