机器人 / 系统课时

配置 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 使用:

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)"

预期输出(最后一条命令):

text
(3, 12) True

macOS 或 Linux 终端使用:

bash
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 使用同一解释器,而不会误装到系统环境。

bash
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 打印:

text
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 @ 乘法的旋转矩阵。

python
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")

运行脚本:

bash
python verify_env.py

预期输出:

text
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 文件实际存在,数值计算环境就具备继续实现坐标变换和位姿求解的必要条件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 Python 数值计算环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通