ChessWithQuests
/

Notation (model.misc.notation)

model.misc.notation

Algebraic coordinate conversion helpers for translating between (row, col) and chess notation.

algebraic_to_pos(algebraic)

Convert an algebraic notation coordinate string to a 0-indexed (row, col) tuple.

Parameters:

Name Type Description Default
algebraic str

Coordinate string (e.g. 'e4', 'a1').

 required

Returns:

Type Description
Tuple[int, int]

Tuple of (row, col) 0-indexed coordinates.
Source code in src/model/misc/notation.py 
21
22
23
24
25
26
27
28
29
30
31
32
def algebraic_to_pos(algebraic: str) -> Tuple[int, int]:
    """Convert an algebraic notation coordinate string to a 0-indexed (row, col) tuple.

    Args:
        algebraic: Coordinate string (e.g. 'e4', 'a1').

    Returns:
        Tuple of (row, col) 0-indexed coordinates.
    """
    col = ord(algebraic[0].lower()) - ord("a")
    row = int(algebraic[1]) - 1
    return (row, col)

pos_to_algebraic(position)

Convert a (row, col) coordinate tuple to standard algebraic notation (e.g. (0, 4) -> 'e1').

Parameters:

Name Type Description Default
position Tuple[int, int]

Tuple of (row, col) 0-indexed coordinates.

 required

Returns:

Type Description
str

Algebraic string notation (e.g. 'e4').
Source code in src/model/misc/notation.py 
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
def pos_to_algebraic(position: Tuple[int, int]) -> str:
    """Convert a (row, col) coordinate tuple to standard algebraic notation (e.g. (0, 4) -> 'e1').

    Args:
        position: Tuple of (row, col) 0-indexed coordinates.

    Returns:
        Algebraic string notation (e.g. 'e4').
    """
    row, col = position
    col_letter = chr(ord("a") + col)
    row_num = str(row + 1)
    return f"{col_letter}{row_num}"
ChessWithQuests