MatrixStepGenerator (core/matrix_step_generator.py)

专门为矩阵运算设计的步骤生成器,负责收集和管理矩阵计算的各个步骤,并将它们格式化为美观的 LaTeX 对齐环境输出。它特别适用于需要显示多行矩阵运算的教学场景。

一.  类概述

MatrixStepGenerator 专注于矩阵计算步骤的管理和展示:

它与其它类的关系如下:

二.  设计原则

三.  属性

属性名 类型 描述 访问级别
steps List[str] 存储所有计算步骤的列表,每个步骤都是 LaTeX 格式的字符串 公共

设计说明: steps 列表直接存储 LaTeX 字符串,这使得 MatrixStepGenerator 特别适合处理复杂的矩阵表达式和多行数学公式,因为开发者可以完全控制每个步骤的 LaTeX 格式。

四.  方法

1.  初始化与状态管理

__init__(self) -> None

初始化矩阵步骤生成器实例,创建空的步骤列表。

执行效果: 创建空的 self.steps 列表

clear(self) -> None

清除所有存储的计算步骤,重置生成器状态。

使用场景:

2.  步骤管理方法

add_step(self, step: str) -> None

向步骤集合中添加单个计算步骤。

参数:

参数名 类型 描述 默认值
step str 表示一个计算步骤的 LaTeX 格式化字符串 必需

注意事项:

3.  输出方法

get_steps_latex(self) -> str

生成包含所有计算步骤的 LaTeX align 环境。

返回值: str - 包含所有步骤的 LaTeX 格式化字符串

输出格式: