机器人 / 系统课时
配置 Python 数值计算环境
配置 Python 数值计算环境
机器人位姿计算从向量、矩阵和三维旋转开始。本课在 Python 3.12 中建立独立虚拟环境,安装 NumPy、SciPy 和 Matplotlib,并用绕 Z 轴旋转 90° 的例子同时验证数值运算、旋转接口与图片输出。
学习目标
- 创建并确认使用 Python 3.12 的项目虚拟环境。
- 安装三个科学计算库,并记录实际安装的依赖版本。
- 运行矩阵乘法、SciPy 三维旋转和 Matplotlib 绘图的联合自检。
创建 Python 3.12 虚拟环境
先安装 Python 3.12,并在新建的项目目录 robot_kinematics 中打开终端。虚拟环境放在 .venv,可防止全局 Python 或其他项目的依赖干扰计算结果。Windows PowerShell 使用:
py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -c "import sys; print(sys.version_info[:2], sys.prefix != sys.base_prefix)"预期输出(最后一条命令):
(3, 12) TruemacOS 或 Linux 终端使用:
python3.12 -m venv .venv
source .venv/bin/activate
python -c 'import sys; print(sys.version_info[:2], sys.prefix != sys.base_prefix)'预期输出同样是 (3, 12) True。前半部分确认主次版本,True 表示当前解释器确实位于虚拟环境中;若是 False,不要继续安装依赖。
安装并锁定数值计算依赖
确认环境已经激活,再通过 python -m pip 安装。这样 pip 与运行脚本的 Python 使用同一解释器,而不会误装到系统环境。
python -m pip install --upgrade pip
python -m pip install numpy scipy matplotlib
python -m pip check
python -m pip freeze > requirements.txt预期结果:安装命令正常退出,pip check 打印:
No broken requirements found.项目目录还会生成 requirements.txt,其中记录 NumPy、SciPy、Matplotlib 实际安装的版本以及间接依赖。安装时不预设固定版本号,让包管理器选择支持当前 Python 3.12 的发行版;完成验证后保留该文件,后续可用 python -m pip install -r requirements.txt 重建环境。跨操作系统复制环境时,应重新检查二进制包的兼容性。
验证矩阵乘法、旋转和绘图
在项目根目录新建 verify_env.py,写入以下完整脚本。采用右手坐标系和列向量约定:将 (1, 0, 0) 绕正 Z 轴旋转 90°,应得到 (0, 1, 0)。Rotation.from_euler 的 degrees=True 表示角度按度传入,as_matrix() 返回可直接用于 NumPy @ 乘法的旋转矩阵。
import sys
import numpy as np
import scipy
import matplotlib
matplotlib.use("Agg") # 使用无窗口绘图后端,远程终端也能保存图片
import matplotlib.pyplot as plt
from scipy.spatial.transform import Rotation
assert sys.version_info[:2] == (3, 12), "需要 Python 3.12"
print("Python: 3.12")
print("Libraries: OK")
# 列向量绕 Z 轴正向旋转,预期 X 轴方向转到 Y 轴方向
rotation = Rotation.from_euler("z", 90, degrees=True)
matrix = rotation.as_matrix()
vector = np.array([1.0, 0.0, 0.0])
rotated = matrix @ vector
print("Matrix shape:", matrix.shape)
print("Rotated vector:", np.round(rotated, 6).tolist())
print("Orthogonal:", bool(np.allclose(matrix.T @ matrix, np.eye(3))))
fig, ax = plt.subplots(figsize=(5, 4))
ax.plot([0, vector[0]], [0, vector[1]], marker="o", label="before")
ax.plot([0, rotated[0]], [0, rotated[1]], marker="o", label="after")
ax.set(xlim=(-0.2, 1.2), ylim=(-0.2, 1.2), xlabel="X", ylabel="Y")
ax.set_aspect("equal", adjustable="box")
ax.grid(True)
ax.legend()
fig.savefig("rotation_check.png", dpi=150)
plt.close(fig)
print("Plot: rotation_check.png")运行脚本:
python verify_env.py预期输出:
Python: 3.12
Libraries: OK
Matrix shape: (3, 3)
Rotated vector: [0.0, 1.0, 0.0]
Orthogonal: True
Plot: rotation_check.png还应在当前工作目录找到 rotation_check.png:图中 before 沿 X 轴,after 沿 Y 轴。实际矩阵元素可能含有约 2.22e-16 的浮点残差,因此打印向量时四舍五入,但正交性判断使用 np.allclose,不要求浮点数严格相等。图像由代码直接生成,不依赖弹出的绘图窗口。
处理常见安装和运行故障
- 找不到
py -3.12或python3.12:先确认 Python 3.12 已安装,且相应启动命令能被终端识别;不要直接拿 Python 3.13 或系统自带的旧版本代替。 - Windows 提示禁止运行
Activate.ps1:可跳过激活,直接把后续命令中的python改为.\.venv\Scripts\python.exe,不必修改系统级脚本执行策略。 - 报
ModuleNotFoundError:运行python -c "import sys; print(sys.executable)",预期路径位于本项目.venv;如不在,重新激活虚拟环境,并使用python -m pip install numpy scipy matplotlib安装。 - 未生成 PNG:检查终端的当前工作目录是否为项目目录,以及程序是否执行到
fig.savefig。无图形界面的机器应保留matplotlib.use("Agg"),并确保它在导入pyplot前调用。
只要三个库可导入、旋转结果和正交性校验正确、PNG 文件实际存在,数值计算环境就具备继续实现坐标变换和位姿求解的必要条件。