开源项目教程：py4DSTEM - 四维扫描透射电子显微镜数据处理与分析工具

开源项目教程：py4DSTEM - 四维扫描透射电子显微镜数据处理与分析工具

py4DSTEM项目地址:https://gitcode.com/gh_mirrors/py/py4DSTEM

---

项目介绍

py4DSTEM 是一个用于四维扫描传输电子显微镜（4D-STEM）数据处理和分析的开源Python库。这个项目旨在提供一套强大的工具集，帮助科研人员对复杂的数据进行高效处理，涵盖了从数据导入、预处理、核心处理到可视化等多个环节。在最新的版本0.14.9中，经历了一次重大的重构，旧有的教程笔记本可能不再适用，例如类名已简化（如 DPCReconstruction 变为 DPC），并且正则化函数去除了 _iter 后缀，转而通过布尔标志指定。

项目快速启动

要迅速上手py4DSTEM，首先确保您的环境中安装了Python。推荐的做法是创建一个新的虚拟环境来安装py4DSTEM及其依赖，以避免与其他项目冲突。

安装py4DSTEM

最基本的方式是通过pip安装最新版py4DSTEM：

pip install py4DSTEM

如果您因重大更新遇到兼容性问题，可以选择安装特定的老版本，例如：

pip install py4DSTEM==0.13.17  # 安装0.13系列的最后一个版本

快速运行示例

一旦安装完成，你可以尝试加载并处理4D-STEM数据的简单示例：

from py4DSTEM import Reader

# 假设有一个名为"data.h5"的4D-STEM数据文件
data_file = "path_to_your/data.h5"
data = Reader.readSTEM(data_file)

# 打印数据的基本信息
print(data.info())

应用案例和最佳实践

为了深入理解py4DSTEM的强大功能，查阅其官方提供的教程和示例至关重要。项目提供了详细的工作流程展示，比如如何执行差分相位衬度（DPC）重建、处理偏轴效应等。重要的是要注意，在0.14.9版本之后，涉及到的类名变更以及参数设置需参照最新的教程调整。

• 最佳实践：建议从官方文档的教程开始学习，特别关注如何正确地初始化对象和调用方法，利用其新式的API结构来避免因版本差异导致的问题。

典型生态项目

py4DSTEM不仅仅作为一个单一库存在，它还支持和一些其他项目集成，提供了更丰富的生态系统，包括GUI浏览器、与深度学习结合的增强版本等。例如：

• py4D-browser: 一个4D-STEM数据的图形界面浏览器，便于数据的直观查看和初步分析。
• py4DSTEM-lite: 轻量级版本，旨在支持更多平台，包括web和移动设备的Pyodide兼容环境。
• py4DSTEM-napari: 结合Napari，提供了一个多维度图像查看器，适合于大尺寸数据的交互式探索。

这些生态项目的结合，使得py4DSTEM成为了一个全面而灵活的4D-STEM数据分析解决方案。

---

以上简要概述了py4DSTEM的核心内容和基础操作，对于深入学习，务必参考官方文档和最新的教程资源，以获取最详尽的操作指南和技术细节。

py4DSTEM项目地址:https://gitcode.com/gh_mirrors/py/py4DSTEM