Đối chiếu kết quả và tốc độ

Trang này ghi các mốc dùng để đối chiếu kết quả của vnstock_quant và điều kiện của những phép đo tốc độ. Khi đọc bảng sai số, hãy xem từng hàm được so với nguồn nào, trên bộ dữ liệu nào và theo quy ước tính nào. Số đo tốc độ chỉ phản ánh môi trường thử nghiệm đã ghi, không dự báo thời gian chạy trên máy của bạn.

1. Phạm vi kiểm tra

Các nhóm hàm được kiểm tra

Các kết quả dưới đây bao phủ năm nhóm hàm của thư viện:

• 58 chỉ báo kỹ thuật (TA) kế thừa bề mặt API thân thuộc của pandas-ta.
• 100 chỉ số báo cáo tài chính VAS (FA) chuẩn hoá cho 4 mô hình ngành.
• 33 thước đo rủi ro & hiệu suất (Risk) chuẩn CFA Institute.
• 38 hàm quản lý & tối ưu hoá danh mục (Portfolio) có tham số phí và thuế giao dịch tại Việt Nam.
• Mô hình định giá chiết khấu cổ tức và P/E hợp lý (Valuation) theo giáo trình CFA.

Điều kiện cài đặt và tính toán

• Gói cài dựng sẵn: Bạn cài bằng pip install -U --extra-index-url https://vnstocks.com/api/packages vnstock_quant, hoặc vnstock install vnstock_quant khi đã có vnstock thế hệ 5. Bạn không cần cài TA-Lib C để tính chỉ báo.
• Phần lõi Rust: Các phép tính đi qua cùng một phần lõi, không đổi cách tính theo việc máy có cài TA-Lib C hay không.
• So sánh kết quả: Muốn kiểm tra một số đo, hãy dùng cùng dữ liệu đầu vào và cùng quy ước về kỳ tính, dữ liệu thiếu và giai đoạn đầu chuỗi.

2. Hệ thống mốc chuẩn đối chiếu thực nghiệm

Các nhóm phép tính được đối chiếu với những nguồn sau:

3. Báo cáo kiểm định 58 chỉ báo kỹ thuật

Báo cáo được trích xuất từ quy trình kiểm thử tự động trên 4 bộ dữ liệu kiểm định (daily, ticks_flat, gaps, range_index) và tập dữ liệu tham chiếu của QuantConnect LEAN.

Các mức đối chiếu

Mỗi chỉ báo trong vnstock_quant đều được gắn nhãn tin cậy minh bạch trong catalog:

• Mức A (34 chỉ báo): Được đối chiếu với TA-Lib C core 0.8.1, với sai số tương đối được ghi nhận từ $0.0\text{e}+00$ đến $10^{-12}$ trên dữ liệu kiểm tra.
• Mức B (14 chỉ báo): Khớp với dữ liệu kiểm thử của QuantConnect LEAN hoặc công thức bài báo khoa học gốc (sai số $\le 10^{-8}$).
• Mức C (10 chỉ báo): Khớp với định nghĩa của chính tác giả phát minh (John Ehlers, Bill Williams, John Carter TTM Squeeze).

Bảng đối chiếu sai số chi tiết

Dưới đây là kết quả kiểm định số học của 58 chỉ báo so với các thư viện quốc tế và sự cải tiến so với thế hệ cũ:

(Ghi chú: Bảng rút gọn hiển thị các chỉ báo tiêu biểu. Toàn bộ 58 chỉ báo đều vượt qua 100% các ca kiểm thử hồi quy tự động).

16 chỉ báo đã sửa so với vnstock_ta 1.x

Trong vnstock_ta 1.x, một số chỉ báo lệch định nghĩa gốc do lỗi vòng lặp hoặc lỗi công thức. vnstock_quant đã sửa như sau:

1. psar: Sửa lỗi nhảy điểm đảo chiều không đúng công thức gia tốc của Wilder.
2. supertrend: Sửa lỗi trôi dải band trong các đợt biến động mạnh kéo dài.
3. dm: Sửa thuật toán cộng dồn Wilder Directional Movement.
4. cci: Sửa phép tính độ lệch tuyệt đối trung bình (Mean Absolute Deviation).
5. stdev & variance: Sửa việc nhầm lẫn giữa độ lệch chuẩn mẫu ($N-1$) và độ lệch chuẩn tổng thể ($N$), đồng bộ hoàn toàn với TA-Lib C.
6. obv: Sửa lỗi xử lý nến đứng giá (Close bằng phiên trước thì giữ nguyên khối lượng tích luỹ, không bị cộng dồn sai).
7. vp (Volume Profile): Sửa lỗi phân bố lại các bin khối lượng và bảo toàn 100% tổng khối lượng giao dịch.
8. squeeze & squeeze_pro: Sửa lỗi công thức dải Keltner Channel bên trong khiến tín hiệu siết/bung nén bị ngược pha.
9. cmo: Sửa phép làm mượt không đúng định nghĩa nguyên bản của Tushar Chande.
10. cg & fisher: Sửa hiện tượng tràn số thực khi giá trị tiến gần biên độ dao động.
11. kst: Sửa hệ số nhân trọng số 4 khung thời gian của Martin Pring.
12. nvi: Sửa điều kiện so sánh khối lượng sụt giảm so với phiên liền trước.
13. mfi: Sửa lỗi chia cho 0 khi dòng tiền âm bằng 0 trong giai đoạn thị trường tăng kịch trần liên tục.
14. pivots: Sửa lỗi lệch ngày khi tính điểm xoay trên dữ liệu intraday.
15. adx: Khắc phục hiện tượng không hội tụ số khởi động giữa các nền tảng.
16. macd: Chuẩn hoá chính xác giá trị khởi động của chuỗi EMA 12 và EMA 26.

4. Báo cáo hiệu năng thực tế (Benchmark Results)

Môi trường và phương pháp đo kiểm

• Phần cứng thử nghiệm: Apple M4 (10 nhân, 16 GB RAM, macOS arm64), đo ngày 06/10/2026, một luồng.
• Phần mềm: vnstock_quant 0.1.0 (lõi Rust biên dịch ở chế độ --release), Python 3.14, numpy 2.2, pandas 2.3.
• Dữ liệu đo: Dữ liệu tổng hợp 5.000 phiên ngày (khoảng 20 năm), mô phỏng bước giá và đặc thù thị trường chứng khoán Việt Nam.
• Lưu ý: Đây là số đo tham khảo trên một máy cụ thể; máy khác cho số khác. Tỷ lệ giữa các thư viện ổn định hơn số tuyệt đối.
• Tiêu chuẩn đo lường: Chạy lặp tối thiểu 7 lần sau 2 lượt warm-up; tính giá trị trung vị (median).

Tốc độ tính toán trọn bộ 58 chỉ báo kỹ thuật

Bảng so sánh tốc độ xử lý khi tính toàn bộ 58 chỉ báo cho cùng một mã cổ phiếu (5.000 phiên):

So sánh thời gian xử lý từng chỉ báo tiêu biểu

Thời gian đo bằng đơn vị micro giây (µs). $1\text{ ms} = 1.000\text{ µs}$:

Năng lực tính toán trên quy mô toàn sàn (1.600 mã chứng khoán)

Mô phỏng bài toán lọc cổ phiếu hằng ngày: tính 15 chỉ báo cốt lõi (sma, ema, wma, rsi, macd, bbands, atr, stoch, adx, cci, willr, mfi, obv, vwap, hlc3) trên 1.600 chuỗi dữ liệu tổng hợp, cỡ toàn bộ mã niêm yết tại HOSE, HNX và UPCoM (mỗi chuỗi 1.250 phiên ~ 5 năm, dữ liệu đã nằm trong bộ nhớ):

Nhờ lõi Rust, thời gian tính chỉ báo kỹ thuật cho cỡ toàn bộ cổ phiếu trên sàn giảm từ 14 giây xuống chỉ còn hơn 1 giây (nhanh hơn 11.6 lần).

Khả năng co giãn theo kích thước dữ liệu

Thử nghiệm độ phức tạp thuật toán với chuỗi dữ liệu nến 1 phút kéo dài từ 1.000 đến 1.000.000 phiên trên tổ hợp 13 chỉ báo:

Kích thước chuỗi     vnstock_quant         vnstock_ta cũ         Tương quan
-------------------------------------------------------------------------
1.000 phiên              0.53 ms               14.3 ms             27.0x
10.000 phiên             1.28 ms              111.9 ms             87.1x
100.000 phiên            8.86 ms              819.7 ms             92.6x
1.000.000 phiên         97.10 ms            8.171.3 ms             84.2x

Lõi Rust duy trì sự tối ưu hoá bộ nhớ đệm CPU L1/L2/L3, giúp tốc độ xử lý nhanh hơn từ 84x đến 92x khi xử lý dữ liệu nến phút.

5. Chuẩn hoá học thuật & Khắc phục sai lệch mô hình Tài chính, Rủi ro, Danh mục

Ngoài chỉ báo kỹ thuật, các phần về báo cáo tài chính, danh mục và rủi ro cũng được đối chiếu theo những quy ước nêu dưới đây.

Khắc phục các sai lệch kinh điển trong phân tích tài chính (FA)

Quá trình rà soát và đối chiếu thực nghiệm đã xử lý các lỗi tính toán định lượng hay gặp sau:

1. Lỗi không quy đổi dòng tiền theo năm: Một lỗi hay gặp khi tự tính là chia lợi nhuận của một quý đơn lẻ cho vốn chủ sở hữu cuối kỳ mà không quy đổi theo năm ($x4$ hoặc 4 quý gần nhất - TTM), dẫn đến ROE bị tính sai lệch gấp 3–4 lần. vnstock_quant tự động chuẩn hoá theo chu kỳ 4 quý gần nhất (TTM) hoặc quy đổi theo năm chính xác.
2. Lỗi không lấy bình quân mẫu số: Các chỉ số hiệu quả hoạt động (ROA, ROE, vòng quay tài sản) theo CFA tính trên tài sản và vốn chủ bình quân. vnstock_quant dùng bình quân đầu năm và cuối năm cho kỳ năm, và bình quân 4 điểm cuối quý (hồ sơ cfa: 5 điểm) cho kỳ quý, kể cả quý 4.
3. Minh bạch bằng cột reason: Thư viện không tự điền số 0 khi thiếu dữ liệu. Ô không có số mang mã lý do trong cột reason, ví dụ INSUFFICIENT_HISTORY khi doanh nghiệp chưa đủ 4 quý lịch sử, MISSING_INPUT:<mã> khi thiếu chỉ tiêu, NOT_APPLICABLE khi chỉ số không dành cho mẫu ngành đó, để bộ lọc tự động của bạn nhận biết và bỏ qua. Mẫu số âm (ví dụ vốn chủ âm do lỗ luỹ kế) vẫn cho ra số âm, nên hãy kiểm tra dấu của mẫu số khi sàng lọc theo ROE hay P/B.

Chuẩn hoá đo lường rủi ro (Risk)

• Chuẩn hoá tỷ số Sharpe: Tính toán chuẩn mực với tử số là giá trị trung bình số học của phần bù rủi ro kỳ vọng ($\overline{R - R_f}$) chia cho độ lệch chuẩn số học, tránh lỗi dùng CAGR (trung bình hình học) ở tử số khiến Sharpe ratio bị đảo dấu âm/dương sai lệch.
• Thích ứng với biên độ trần/sàn Việt Nam: Với quy định biên độ giá $\pm 7\%$ (HOSE) hay $\pm 10\%$ (HNX), phân phối lợi suất chứng khoán Việt Nam có hiện tượng đuôi béo và bất đối xứng rõ rệt. vnstock_quant cung cấp mô hình Cornish-Fisher VaR/CVaR và chỉ số thanh khoản Amihud (2002) được kiểm định theo đúng công thức bài báo khoa học gốc.
• Căn chỉnh lịch giao dịch thực tế: Khắc phục lỗi ghép dữ liệu theo số thứ tự dòng thay vì theo ngày giao dịch (Trading Date Index), tránh lệch phiên khi cổ phiếu bị tạm ngừng giao dịch.

Quản lý danh mục & Tối ưu hoá (Portfolio)

• Tái cân bằng theo dòng thời gian: portfolio_returns tính lợi suất danh mục theo lịch tái cân bằng (tháng, quý, năm hoặc khi tỷ trọng lệch quá dải cho phép), tỷ trọng trôi theo giá giữa hai lần tái cân bằng. Việc tỷ trọng mục tiêu không dùng thông tin tương lai (Lookahead Bias) do bạn tự kiểm soát.
• Tối ưu hoá chỉ mua (Long-only Constrained Optimization): Giải thuật tối ưu hoá danh mục phương sai tối thiểu (GMV) và tỷ trọng rủi ro bằng nhau (ERC) được tích hợp điều kiện biên chặt chẽ: $w_i \ge 0$, $\sum w_i = 1$, và quy tắc làm tròn lô 100 cổ phiếu theo quy định giao dịch tại Việt Nam, không âm thầm trả về danh mục chia đều $1/N$ khi solver gặp ràng buộc khó.
• Tính cả chi phí giao dịch: Truyền bộ tham số pm.VN_COSTS (phí giao dịch $0.15\%$, thuế bán chứng khoán $0.1\%$) vào portfolio_returns để lợi suất danh mục theo lịch tái cân bằng đã trừ phí và thuế.

6. Tổng kết giá trị mang lại cho người dùng

vnstock_quant chạy bộ kiểm thử hồi quy tự động trước mỗi bản phát hành.

Đọc tiếp

• Chỉ báo kỹ thuật — Tính toán 58 chỉ báo kỹ thuật với lõi Rust.
• Chỉ số tài chính — Tự tính 100 chỉ số BCTC VAS và mô hình dòng tiền CFA.
• Đo lường rủi ro và hiệu suất — 33 thước đo hiệu suất và rủi ro chuẩn CFA.
• Chuyển đổi từ vnstock_ta — Hướng dẫn nâng cấp từ vnstock_ta 1.x sang vnstock_quant.