模型转换文件结构

本文解释了模型转换工作流程中生成的文件结构以及每个文件夹和文件的目的，包括缓存处理、历史跟踪、推理等。

在创建模型项目并运行几次后，文件结构可能如下所示：

model_project_name/
├── model_lab.workspace.config
└── huggingface_microsoft_resnet-50_v1/
    ├── .gitignore
    ├── imagenet.py
    ├── inference_sample.ipynb
    ├── model_project.config
    ├── README.md
    ├── requirements.txt
    ├── resnet_ptq_qnn.json
    ├── cache/
    └── history/
        └── history_1(20250414_161046)/
            ├── model/
            ├── footprints.json
            ├── history.config
            ├── history.config.user
            ├── inference_sample.ipynb
            ├── log.txt
            ├── metrics.json
            ├── model_config.json
            ├── olive_config.json
            ├── output_footprint.json
            └── run_history.txt
        └── history_2/
        └── history_3/

在模型项目名称文件夹，每个模型的工作流程存储在单独的文件夹中。

要求.txt列出运行工作流和推理样本所需的依赖项。
resnet_ptq_qnn.json，imagenet.py: Olive 用来转换模型的 JSON 文件。有些可能需要额外的 Python 文件进行定制。
自述文件.md描述模型的详细信息，例如模型的任务、性能指标和使用说明。
模型项目配置包含项目模板设置。某些设置可以被覆盖以满足您的特定需求。
inference_sample.ipynb: 样本以测试输出模型。此文件将被复制到历史文件夹，以启用使用不同的 Jupyter 笔记本来比较来自不同历史记录的模型。

缓存文件夹

这个缓存文件夹存储在工作流执行过程中生成的缓存文件。这些缓存结果可以帮助加速工作流的重复运行。

如果不再需要此文件夹，您可以删除它以释放空间。

历史文件夹

时间戳在历史文件夹名称表示运行时间，例如：2025年4月14日 16:10:46输入：.

模型模型文件。
model_config.json包含有关模型的详细信息。
脚印.json，输出足迹.json，运行历史.txt橄榄输出。
历史配置，历史.配置.用户模型转换使用的 : history 配置。
inference_sample.ipynb: 用于测试输出模型的样本。
log.txt包含日志。
metrics.json: 如果启用评估，则包含评估结果。
olive_config.json: 用于运行转换的配置。

关于Git

默认情况下，缓存和历史文件夹被排除在版本控制之外.gitignore), 除了以下两个配置文件：历史配置和olive_config.json

你可能会更新.gitignore文件包含特定历史文件夹，这些文件夹值得保存。

当其他人克隆该仓库时，这两个文件确保他们可以重新运行这些历史记录以重现转换结果。

__pycache__
/cache
/history/*/*
!/history/*/history.config
!/history/*/olive_config.json