class Trigram(BaseModel):
"""A Trigram (八卦) in the I Ching"""
# 0: changing yin, 1: static yang, 2: static yin, 3: changing yang
NAME_MAP: ClassVar[dict[tuple[int, int, int], str]] = {
(1, 1, 1): "乾",
(1, 1, 0): "兑",
(1, 0, 1): "离",
(1, 0, 0): "震",
(0, 1, 1): "巽",
(0, 1, 0): "坎",
(0, 0, 1): "艮",
(0, 0, 0): "坤",
}
lines: list[Line]
interpretation: TrigramInterpretationBase[LineInterpretationBase] | None = None
@field_validator("lines", mode="before")
@classmethod
def validate_line_length(cls, lines: list[Line]) -> list[Line]:
if len(lines) != 3:
raise ValueError("Trigram should have exactly 3 lines")
return lines
@property
def value(self) -> list[int]:
return [line.value for line in self.lines]
@property
def name(self) -> str:
# 0: changing yin, 1: static yang, 2: static yin, 3: changing yang
return self.NAME_MAP[(self.value[0] % 2, self.value[1] % 2, self.value[2] % 2)]
@cached_property
def transformed(self) -> "Trigram":
transformed_lines = [line.get_transformed() if line.is_transform else line for line in self.lines]
return Trigram(lines=transformed_lines)
@classmethod
def from_binary(cls, lines: list[int]) -> Self:
assert len(lines) == 3
return cls(lines=[Line(status=LineStatus(i)) for i in lines])
@classmethod
def random(cls) -> Self:
return cls(lines=[Line.random() for _ in range(3)])
def __repr__(self):
return "\n".join(repr(line) for line in self.lines[::-1])
@property
def pre_trigram_number(self) -> int:
# 返回先天卦数
value = (self.value[0] % 2, self.value[1] % 2, self.value[2] % 2)
return list(self.NAME_MAP.keys()).index(value) + 1
@classmethod
def from_pre_trigram_number(cls, trigram_number: int) -> Self:
# 给定先天卦数，返回对应的八卦
assert 1 <= trigram_number <= 8
name_map = {v: k for k, v in cls.NAME_MAP.items()}
name_list = list(name_map.keys())
trigram_name = name_list[trigram_number - 1]
lines_number = list(map(lambda x: 2 if x == 0 else x, name_map[trigram_name]))
return cls(lines=[Line(status=LineStatus(i)) for i in lines_number])