Các loại biểu đồ
Cộng đồngBản Cộng đồngvnstock_chart v1.0.0Cập nhật
Mục lục
Mọi hàm đều nằm trên lớp Chart, nhận vào một DataFrame hoặc Series và trả về (fig, ax) (một số trả thêm trục phụ). Bạn tự fig.savefig(...) hoặc fig.show() — vnstock_chart không tự lưu file.
Python
from vnstock_chart import Chart
fig, ax = Chart.line(series, title="...")Xu hướng theo thời gian
| Hàm | Dùng khi | Dữ liệu vào |
|---|---|---|
Chart.line(data) | Giá, chỉ số theo thời gian, một hoặc nhiều dải | Series hoặc DataFrame, chỉ mục thời gian |
Chart.candle(data, volume=True, overlays=[...]) | Nến OHLC, có thể chèn đường chỉ báo (MA, EMA…) lên cùng biểu đồ | DataFrame có open/high/low/close, tuỳ chọn volume |
Chart.combo(bar_data, line_data) | Khối lượng dạng cột, giá dạng đường trên cùng một biểu đồ, hai trục Y | Hai Series/DataFrame cùng chỉ mục thời gian |
Nến và khối lượng (mplfinance)
Chart.candle dựng trên mplfinance: hỗ trợ subplots để thêm bảng chỉ báo phụ (RSI, MACD…) dưới biểu đồ chính, overlays để vẽ đường chồng lên nến.
Số lượng và phân phối
| Hàm | Dùng khi |
|---|---|
Chart.bar(data) | So sánh số lượng theo nhóm (doanh thu, lợi nhuận theo năm…) |
Chart.hist(data) | Phân phối một biến (lợi suất ngày, khối lượng…) |
Chart.boxplot(data) | Phân phối theo nhóm, phát hiện giá trị bất thường |
Chart.table(data) | Trình bày bảng dữ liệu dạng ảnh, tiện chia sẻ kèm logo |
Tương quan
| Hàm | Dùng khi |
|---|---|
Chart.scatter(data, x=, y=) | Tương quan hai biến |
Chart.pairplot(data) | Ma trận tương quan nhiều biến cùng lúc |
Chart.heatmap(data) | Ma trận tương quan dạng nhiệt, ví dụ df.corr() |
Tỉ lệ
| Hàm | Dùng khi |
|---|---|
Chart.pie(data, labels=) | Tỉ trọng cổ đông, phân bổ tài sản |
Chart.treemap(values=, labels=) | Tỉ trọng nhiều nhóm, trực quan hơn pie khi có nhiều mục — cần pip install "vnstock-chart[all]" |
Định lượng (kết hợp vnstock_quant, vnstock_bt)
| Hàm | Dùng khi |
|---|---|
Chart.equity_curve(data, benchmark=...) | Đường vốn và drawdown của một chiến lược, so với benchmark |
Chart.returns_heatmap(data) | Lợi suất theo tháng/năm dạng nhiệt |
Chart.rrg(...) | Relative Rotation Graph — so sánh tương đối sức mạnh/động lượng nhiều mã hoặc ngành |
Chart.summary_card(ticker=, company_name=, current_price=, ...) | Thẻ tóm tắt một mã: giá, % thay đổi, dạng ảnh chia sẻ nhanh |
Khác
| Hàm | Dùng khi |
|---|---|
Chart.wordcloud(text) | Mô tả doanh nghiệp, tin tức — cần pip install "vnstock-chart[all]" |
Tuỳ biến chung
Mọi hàm nhận thêm các tham số dùng lại được: title, figsize, color_palette ('vnstock', 'percentage', 'amount', 'category', 'trend', 'flatui'…), palette_shuffle, font_name. Đặt một lần cho toàn bộ biểu đồ sau đó bằng:
Python
Chart.set_theme(theme_name='vnstock', font_name='Inter', lang='vi')Chi tiết tham số từng hàm: gọi help(Chart.candle) (hay tên hàm tương ứng) ngay trong Python, hoặc xem Tham chiếu đầy đủ tham số — bảng tên/kiểu/giá trị mặc định của mọi hàm, lấy thẳng từ mã nguồn.