Python-MNIST 项目启动与配置教程

1. 项目的目录结构及介绍

Python-MNIST 项目是一个简单的 MNIST 和 EMNIST 数据解析器，它完全使用 Python 语言编写。以下是项目的目录结构及其各部分的简要介绍：

python-mnist/
├── bin/                      # 存放用于获取和预览数据的脚本文件
│   ├── mnist_get_data.sh     # 获取 MNIST 数据的脚本
│   ├── mnist_preview         # 预览 MNIST 数据的脚本
│   ├── emnist_get_data.sh    # 获取 EMNIST 数据的脚本
│   └── emnist_preview        # 预览 EMNIST 数据的脚本
├── mnist/                    # 包含 MNIST 数据处理的核心代码
│   ├── __init__.py
│   └── MNIST.py              # MNIST 数据解析类
├── tests/                    # 包含测试代码的目录
│   ├── __init__.py
│   └── test.py               # 测试 MNIST 类的功能
├── .gitignore                # 指定 Git 忽略的文件和目录
├── AUTHORS                   # 项目贡献者列表
├── LICENSE                   # 项目许可证信息
├── MANIFEST.in               # 打包时包含的文件列表
├── README.rst                # 项目说明文件
├── meta.yaml                 # Conda 打包配置文件
├── setup.cfg                 # 设置打包配置
├── setup.py                  # 项目打包脚本
└── test.sh                   # 脚本文件，用于测试

2. 项目的启动文件介绍

项目的启动主要是通过 bin 目录下的脚本文件来完成的。

• mnist_get_data.sh: 这是一个 Shell 脚本，用于下载和提取 MNIST 数据集。
• mnist_preview: 这是一个 Python 脚本，用于预览 MNIST 数据集中的图像。

要启动项目，首先需要通过 mnist_get_data.sh 脚本获取数据集，然后可以使用 mnist_preview 脚本查看数据。

# 克隆项目仓库
git clone https://github.com/sorki/python-mnist.git
cd python-mnist

# 获取 MNIST 数据
./bin/mnist_get_data.sh

# 预览 MNIST 数据
PYTHONPATH=. ./bin/mnist_preview

3. 项目的配置文件介绍

Python-MNIST 项目的配置主要通过代码中的参数设置来完成，并没有专门的配置文件。以下是一些关键的配置选项：

• mndata.gz: 这个布尔值参数决定了是否加载经过 gzip 压缩的数据文件。默认为 True，如果数据文件未压缩，应设置为 False。
• mndata.select_emnist(dataset_name): 用于选择 EMNIST 数据集中的特定子集，例如 balanced, byclass, bymerge, digits, letters, mnist。

以下是一个使用 MNIST 类加载训练数据的例子：

from mnist import MNIST

# 创建 MNIST 对象
mndata = MNIST('./dir_with_mnist_data_files')

# 加载训练数据
images, labels = mndata.load_training()

# 如果数据文件是 gzip 压缩的，设置 mndata.gz 为 True
mndata.gz = True

请根据实际的数据文件路径和是否压缩来调整这些配置。