JStockChart -- Getting Started(Timeseries)
本文以一個(gè)示例介紹了如何利用JStockChart生成金融時(shí)序圖。(2009.11.23最后更新)
1. 環(huán)境要求
需要JDK 1.5或更高版本。
2. 下載與安裝
從JStockChart的站點(diǎn)中下載它的最新版本，當(dāng)前版本是0.4.2。
解壓JStockChart的zip文件(jstockchart-0.4.2.zip)后，將jstockchart目錄中的jstockchart-0.4.2.jar和jstockchart/lib目錄中的jcommon-1.0.16.jar和jfreechart-1.0.13.jar加到classpath中。
3. 示例
在JStockChart的發(fā)行包中，有一個(gè)demo目錄。該目錄包含了一個(gè)簡單的例子，展示了如何利用JStockChart去生成時(shí)序圖。demo目錄中有一個(gè)Ant腳本build.xml，在該目錄下執(zhí)行命令ant即可運(yùn)行該示例程序。下面是該示例的關(guān)鍵代碼及其說明。
public class TimeseriesChartDemo {
public static void main(String[] args) throws IOException {
// 
// 創(chuàng)建一個(gè)包含TimeseriesItem的List實(shí)例。
// 在此處，通過查詢db4o的數(shù)據(jù)庫文件，直接獲得該List．
// 注意：所有的數(shù)據(jù)，都必須在"同一天"內(nèi)。
List data = ;
// 創(chuàng)建SegmentedTimeline實(shí)例，表示時(shí)間區(qū)間"00:00-11:30，13:00-24:00"(即24小時(shí)中空缺了"11:31-12:59"這段時(shí)間)。
SegmentedTimeline timeline = new SegmentedTimeline(
SegmentedTimeline.MINUTE_SEGMENT_SIZE, 1351, 89);
timeline.setStartTime(SegmentedTimeline.firstMondayAfter1900()
+ 780 * SegmentedTimeline.MINUTE_SEGMENT_SIZE);
// 創(chuàng)建TimeseriesDataset實(shí)例，時(shí)間間隔為1分鐘。
TimeseriesDataset dataset = new TimeseriesDataset(Minute.class, 1, timeline, true);
// 向dataset中加入TimeseriesItem的List。
dataset.addDataItems(data);
// 創(chuàng)建邏輯價(jià)格坐標(biāo)軸。指定中間價(jià)為21，顯示9個(gè)坐標(biāo)值，坐標(biāo)值的格式為".00"。
CentralValueAxis fixedPriceAxis = new CentralValueAxis(new Double("21"), new Range(
dataset.getMinPrice().doubleValue(), dataset.getMaxPrice().doubleValue()),
9, new DecimalFormat(".00"));
// 創(chuàng)建價(jià)格區(qū)域
PriceArea priceArea = new PriceArea(fixedPriceAxis);
// 創(chuàng)建邏輯量坐標(biāo)軸。顯示5個(gè)坐標(biāo)值，坐標(biāo)值的格式為"0"。
FixedNumberAxis fixedVolumeAxis = new FixedNumberAxis(new Range(dataset
.getMinVolume().doubleValue(), dataset.getMaxVolume()
.doubleValue()), 5, new DecimalFormat("0"));
// 創(chuàng)建量區(qū)域
VolumeArea volumeArea = new VolumeArea(fixedVolumeAxis);
// 創(chuàng)建時(shí)序圖區(qū)域
TimeseriesArea timeseriesArea = new TimeseriesArea(priceArea,
volumeArea, createFixedDateAxis(DateUtils.createDate(2008, 1, 1)));
// 通過JStockChartFactory的工廠方法生成JFreeChart實(shí)例。
// 指定了該圖的標(biāo)題為"Timeseries Chart Demo"，并且不生成圖例(legend)。
JFreeChart jfreechart = JStockChartFactory.createTimeseriesChart(
"Timeseries Chart Demo", dataset, timeline, timeseriesArea, false);
// 創(chuàng)建圖像文件。圖像格式為PNG，長為545，寬為300。
ChartUtilities.saveChartAsPNG(new File(imageFile), jfreechart, 545, 300);
}
// 指定時(shí)期坐標(biāo)軸中的邏輯坐標(biāo)。
private static FixedDateAxis createFixedDateAxis(Date baseDate) {
FixedDateAxis fixedDateAxis = new FixedDateAxis(baseDate,
new SimpleDateFormat("HH:mm"));
fixedDateAxis.addDateTick("09:30", TickAlignment.START);
fixedDateAxis.addDateTick("10:00");
fixedDateAxis.addDateTick("10:30");
fixedDateAxis.addDateTick("11:00");
fixedDateAxis.addDateTick("11:30", TickAlignment.END);
fixedDateAxis.addDateTick("13:00", TickAlignment.START);
fixedDateAxis.addDateTick("13:30");
fixedDateAxis.addDateTick("14:00");
fixedDateAxis.addDateTick("14:30");
fixedDateAxis.addDateTick("15:00", TickAlignment.END);
return fixedDateAxis;
}
}
運(yùn)行該示例程序后，可以生成如下圖片：
4. 定制圖表
由于JFreeChart具有高度的可定制性，所以當(dāng)生成了JFreeChart實(shí)例后，你可以從中獲取圖表中的各個(gè)元素，如Plot，然后再定制它們的屬性。詳細(xì)信息請參見JFreeChart的站點(diǎn)和論壇。
另外，在創(chuàng)建JStockChart的XXXArea對象時(shí)，也可以直接定制若干屬性。如，通過PriceArea類，可以設(shè)置價(jià)格線的顏色(PriceArea.setPriceColor)，均線的顏色(PriceArea.setAverageColor)；是否顯示均線(PriceArea.setAverageVisible)；是否顯示漲跌幅(PriceArea.setRateVisible)；...。詳細(xì)信息請參見JStockChart的API文檔。