Qur'an-Align 项目使用教程

Qur'an-Align 项目使用教程

quran-alignWord-accurate timestamps for Qur'anic audio.项目地址:https://gitcode.com/gh_mirrors/qu/quran-align

1. 项目目录结构及介绍

quran-align/
├── align/
│   ├── main.cc
│   └── ...
├── README.md
├── LICENSE
└── ...

• align/: 包含项目的主要代码文件，如 main.cc。
• README.md: 项目的介绍和基本使用说明。
• LICENSE: 项目的开源许可证，本项目使用 MIT 许可证。

2. 项目启动文件介绍

align/main.cc

main.cc 是项目的启动文件，负责加载配置、处理输入数据并生成输出。以下是文件的主要功能模块：

• 加载 Quran 文本:

  std::ifstream quran_file(argv[1]);
  std::unordered_map<unsigned int, std::string> quran_text;
  while (quran_file.good()) {
      std::string value;
      std::getline(quran_file, value, '|');
      int surah_ayah_key = stoi(value) * 1000;
      std::getline(quran_file, value, '|');
      surah_ayah_key += stoi(value);
      std::getline(quran_file, value, '\n');
      quran_text[surah_ayah_key] = value;
  }
  quran_file.close();
  

• 加载 Liaise-Point 定义:

  std::ifstream quran_liaise_file(argv[2]);
  std::unordered_map<unsigned int, std::vector<LiaisePoint>> liaise_points;
  while (quran_liaise_file.good()) {
      uint16_t surah_num, ayah_num, word, flags;
      quran_liaise_file >> surah_num >> ayah_num >> word >> flags;
      liaise_points[surah_num * 1000 + ayah_num].push_back({word, (LiaiseFlags)flags});
  }
  

• 生成任务并分配到工作队列:

  const unsigned int worker_ct = std::thread::hardware_concurrency();
  

3. 项目配置文件介绍

quran.txt

quran.txt 是输入文件，用于生成识别语言模型。文件格式为 Tanzil.net 格式，包含 Quran 的文本数据。

quran.liaise.txt

quran.liaise.txt 是 Liaise-Point 定义文件，包含需要进行过渡区分的 Surah-Ayah-WordIndex-Flags 列表。Flags 字段设置为 1 表示开始。

ps.cfg

ps.cfg 是项目的配置文件，用于配置项目的运行参数。具体配置项需要根据项目需求进行设置。

---

以上是 Qur'an-Align 项目的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用该项目。

quran-alignWord-accurate timestamps for Qur'anic audio.项目地址:https://gitcode.com/gh_mirrors/qu/quran-align