PMIDBasedArticleSelector 使用指南

##Update 2025/5/24
2.0 and 2.1 uploaded--- Set up the environment first, then run PMIDBasedArticleSelector.py to use GUI.

中文说明

1. 下载或克隆代码：
   下载项目或通过 Git 克隆代码仓库。

   git clone https://github.com/xonix2001/PMIDBasedArticleSelector.git

2. 配置环境：
   根据 requirements.txt 中的依赖，安装所需的 Python 包。

   pip install -r requirements.txt

3. 配置翻译器：
   打开 translator.py，填写你的 OpenAI API 密钥及基础配置。
   如果没有 API 密钥，请访问 ChatAnywhere 商店 购买。

   # translator.py 示例:
   openai.api_key = "#your key"
   openai.api_base = "#base"

4. 准备 PubMed API 账户：
   确保你拥有有效的 PubMed API 账户。

5. 填写账户信息：
   打开 extend.py，输入你的账户相关信息。

   # extend.py 示例:
   email = "#enter here"
   api_key = "#enter here"

6. 设置输入输出路径：
   指定包含 PMID 列表的 TXT 文件的输入路径，以及生成结果 Excel 文件的输出路径。

   # extend.py 示例:
   processor_extended.run("#enter here")  # 输入文件 (.txt) 路径

7. 运行程序：
   执行 extend.py 开始处理。

   python extend.py

---

English Instructions

PMIDBasedArticleSelector Usage Guide

1. Download or Git Clone:
   Download the project or clone it from the repository.

   git clone https://github.com/xonix2001/PMIDBasedArticleSelector.git

2. Set Up the Environment:
   Install the required packages by running the commands listed in requirements.txt.

   pip install -r requirements.txt

3. Configure Translator Settings:
   Open translator.py and enter your OpenAI API key and the base configuration.
   If you don't have any key, try to buy one at ChatAnywhere Shop.

   # Example in translator.py:
   openai.api_key = '#your key'
   openai.api_base = '#base'

4. Prepare PubMed API Account:
   Ensure you have a valid PubMed API account.

5. Enter Your Account Information:
   Open extend.py and input your account details.

   # Example in extend.py:
   email = "#enter here"
   api_key = "#enter here"

6. Specify Input and Output Paths:
   Set the input path for the PMIDs list (a TXT file) and the desired output path for the resulting Excel file.

   # Example usage in extend.py:
   processor_extended.run('#enter here')  # input (.txt) path

7. Run the Application:
   Execute extend.py to start processing.

   python extend.py

---

辅助脚本

1. seach_strategy_generator.py

输入自然语言描述，程序将自动生成对应的 PubMed 检索表达式

2. PMIDs_generator.py

根据预先配置的检索词，该脚本将调用 PubMed API 获取符合条件的 PMID 列表，并将结果保存到指定路径的 TXT 文件中。

备注： 你也可以在 PubMed 官网手动导出 PMID 序列，并以 TXT 文件形式使用。

---

Supplementary Scripts

1. seach_strategy_generator.py

Provide a natural language description as input, and the script will generate a corresponding PubMed search expression automatically.

2. PMIDs_generator.py

Based on the preconfigured search strategy, the script will call the PubMed API to fetch a list of PMIDs that meet the criteria and save the results to a TXT file at the specified location.

Note: You can also manually export a PMID sequence from the PubMed website and use it as a TXT file.

---