2. 安装

QuantStudio 依赖很多的外部库:

• numpy>=1.14.4+mkl
• numexpr>=2.6.1
• pandas>=0.19.0
• scipy>=0.18.1
• matplotlib>=2.2.3
• plotly>=2.0.6
• patsy
• statsmodels>=0.9.0
• h5py>=2.6.0
• cx-Oracle>=5.2.1
• pymongo>=3.4.0
• pymssql>=2.1.3
• mysql-connector-python
• pyodbc>=4.0.14
• arctic>=1.67.0
• chardet>=3.0.4
• progressbar2>=3.10.1
• pyface>=6.0.0
• traits>=4.6.0
• traitsui>=6.0.0
• bs4>=0.0.1
• tushare>=1.2.12
• xlrd>=0.9.0
• xlwt>=1.3.0
• PyQt5>=5.9.2

以 root 权限运行 pip:

$ sudo pip install --upgrade QuantStudio

（在 Windows 上，在管理员权限的 CMD 中去掉 sudo 运行这条命令。)

注意

本文档所有的代码均假定是最新版本的 QuantStudio, 如果代码出现错误, 请按上述命令升级安装 QuantStudio 再尝试运行.

2.1. 配置文件

QuantStudio 中的很多对象可以通过读取给定的配置文件来初始化参数, 配置文件是一个 json 格式的文件(字符编码为 utf-8, 扩展名为 json), 以键值对的形式给出各个参数的取值. 比如因子库对象 HDF5DB 有一个参数 “主目录”, 该参数表示该因子库的数据文件存放的文件夹路径, 则配置文件的内容为:

{
    "主目录": "C:\\HDF5Data"
}

QuantStudio 对象配置文件的默认存放位置为用户目录下的 “QuantStudioConfig” 文件夹, 比如 Windows 系统下通常为 “C:\Users\你的用户名\QuantStudioConfig”, Linux 系统下通常为 “/home/你的用户名/QuantStudioConfig”, Mac OS 下通常为 “/Users/你的用户名/QuantStudioConfig”, 或者可以运行下面的代码获取该路径:

>>>from QuantStudio import __QS_ConfigPath__
>>>print(__QS_ConfigPath__)

用户可以自行创建该文件夹, 并将自己的配置文件放置其中, 每个对象的默认配置文件名参见相应的 API 说明.

2.2. 其他软件环境要求

下列组建需要其他软件支持, 如果未安装则相应功能无法使用:

• 因子库 WindDB 需要 Wind 金融工程数据库
• 因子库 WindDB2 需要 Wind 量化研究数据库
• 因子库 ArcticDB 需要 MongoDB 数据库
• 因子库 SQLDB 需要 Oracle, SQL Server 或者 MySQL 数据库中的一个
• 投资组合构造器 MatlabPC 需要 MATLAB, MATLAB Engine for Python 以及 yamlip(参见: “https://yalmip.github.io”)
• 投资组合构造器 CVXPC 需要 cvxpy(参见: “https://www.cvxpy.org”)