Quant1X 量化交易实验室

✨ 特性

📋 环境要求

系统要求

语言版本

🚀 快速开始

1. 环境配置

1.1 默认均为64位操作系统

1.2 环境安装推荐使用brew

1.3 安装quant1x配置文件

1.3.1 go语言版本是目前比较稳定的生产版本, 配置文件目录名因为历史原因使用了全拼接的quant1x路径, 支持~/runtime/etc/quant1x.yaml

cp examples/quant1x.yaml ~/.quant1x/quant1x.yaml

1.3.2 c++语言版本是具备跨平台的生产能力, 目录名为~/.q1x/

cp examples/quant1x.yaml ~/.q1x/quant1x.yaml

1.3.3 rust版本以C++版本为基础,尽可能1:1还原c++的业务逻辑,目录名为~/.q1x-rs/

cp examples/quant1x.yaml ~/.q1x-rs/quant1x.yaml

1.3.4 python版本没有直接的二进制数据,只提供基于go/c++/rust的数据导出功能

2. python

2.1 安装pyenv

brew install pyenv

2.1.1 查看已安装的版本

pyenv versions

 system
 3.8.16
* 3.12.9 (set by /Users/${USERNAME}/.pyenv/version)

2.1.2 查看可安装的版本

pyenv install -l

2.1.3 安装指定版本的python, 本文指定3.12.9或3.12.x更新版本

pyenv install 3.12.9

2.1.4 pip类库管理工具

2.1.5 python基础工具

2.1.6 pip 源配置

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set install.trusted-host https://pypi.tuna.tsinghua.edu.cn

2.2 依赖库

2.2.1 安装项目依赖的库

pip install -r requirements.txt

2.2.2 检测项目依赖输出到requirements.txt

pip freeze > requirements.txt

2.2.3 交叉依赖

pip install pipreqs
pipreqs ./ --encoding utf8

2.3 上传package到PyPi

2.3.1 安装或更新setuptools、wheel、twine

pip install --upgrade setuptools wheel twine

2.3.2 打包并生成tar.gz和whl文件

python setup.py sdist bdist_wheel

2.3.3 上传package到PyPi的测试环境

twine upload --repository testpypi dist/*

2.3.4 上传package到PyPi的正式环境

twine upload dist/*

2.4 Matplotlib中文乱码问题解决方案

2.4.1 编写如下代码,获取matplotlib包所在的配置文件的路径

import matplotlib
matplotlib.matplotlib_fname() #输出matplotlib包所在的配置文件的路径

2.4.2 根据上面的路径打开文件夹(根据自己实际的输出路径去操作)

cp -r /Users/${USERNAME}/Library/Fonts/SimHei.ttf fonts/ttf/

2.4.3 编辑2.4.1获得路径matplotlibrc文件

2.4.3.1 找到 #font.sans-serif,去掉前面的#,并在:后面写上在准备工作加入的中文字体的名称SimHei

2.4.3.2 找到#axes.unicode_minus,去掉前面的#,并在:改为False

2.4.4 控制台切换到~/.matplotlib目录, 删除tex.cache文件和fontList.json文件

cd ~/.matplotlib
rm -rf *

3. golang 开发环境

3.1 环境设定

go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOPRIVATE=gitee.com

3.2 安装protobuf

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

4. Rust 开发环境

4.1 安装 Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

4.2 更新 Rust 工具链到最新版本

rustup update

Rust: 构建与运行 q1x 二进制

cargo build --bin q1x

cargo build --release --bin q1x

# 打印程序帮助(包含子命令和选项)
cargo run --bin q1x -- --help

# 管理服务(install/uninstall/start/stop/status/run)
cargo run --bin q1x -- service install
cargo run --bin q1x -- service start
# 更新缓存数据(calendar / servers / all / base / features)
cargo run --bin q1x -- update --all
cargo run --bin q1x -- update --calendar

直接示例:从已构建二进制查看帮助

# Debug 二进制
.\target\debug\q1x.exe --help
# Release 二进制
.\target\release\q1x.exe --help

quant1x - Rust edition
--------------------------------------------------------------------------------
 Version : 0.6.10
 Author : Quant1X Team
--------------------------------------------------------------------------------
Usage: q1x.exe [OPTIONS] [COMMAND]
Commands:
 service Manage the service.
 update Update cached data (base / features)
 help Print this message or the help of the given subcommand(s)
Options:
 --version
 Print build version information and exit
 --verbose
 显示日志信息到终端
 --debug
 打开日志的调试模式
 -h, --help
 Print help (see a summary with '-h')

5. c/c++ 开发环境

vcpkg install yaml-cpp zlib asio xtensor mimalloc spdlog fmt duktape benchmark catch2 flatbuffers capnproto

cmake -DCMAKE_BUILD_TYPE=Debug -G Ninja -S . -B cmake-build-debug
cmake --build cmake-build-debug --target q1x -j 18

ninja -C cmake-build-debug install

ctest --test-dir cmake-build-debug --output-on-failure

./cmake-build-debug/bin/q1x --help

⚡ 多语言性能对齐:Vyukov Ringbuffer

📊 获取K线数据示例

Python

from quant1x.factors.base import get_cross_section_forward_adjusted_bars
# 获取前复权K线数据
code = "sh600000"
as_of_date = "2024-12-26"
bars = get_cross_section_forward_adjusted_bars(code, as_of_date)
print(f"Loaded {len(bars)} adjusted bar records for {code}")
# 显示最近5条记录
for bar in bars[-5:]:
 print(f"Date: {bar.date}, Open: {bar.open:.2f}, Close: {bar.close:.2f}")

Go

package main
import (
 "fmt"
 "gitee.com/quant1x/quant1x/quant1x/factors"
)
func main() {
 code := "sh600000"
 asOfDate := "2024-12-26"
 
 // 获取前复权K线数据
 bars := factors.GetCrossSectionForwardAdjustedBars(code, asOfDate)
 
 fmt.Printf("Loaded %d adjusted bar records for %s\n", len(bars), code)
 
 // 显示最近5条记录
 start := len(bars) - 5
 if start < 0 {
 start = 0
 }
 for _, bar := range bars[start:] {
 fmt.Printf("Date: %s, Open: %.2f, Close: %.2f\n", bar.Date, bar.Open, bar.Close)
 }
}

Rust

use quant1x::factors::base::get_cross_section_forward_adjusted_bars;
fn main() {
 let code = "sh600000";
 let as_of_date = "2024-12-26";
 
 // 获取前复权K线数据
 let bars = get_cross_section_forward_adjusted_bars(code, as_of_date);
 
 println!("Loaded {} adjusted bar records for {}", bars.len(), code);
 
 // 显示最近5条记录
 let start = if bars.len() > 5 { bars.len() - 5 } else { 0 };
 for bar in &bars[start..] {
 println!("Date: {}, Open: {:.2}, Close: {:.2}", 
 bar.date, bar.open, bar.close);
 }
}

🤝 贡献

开发规范

📄 许可证

📚 相关链接