AceChart股票程式化分析軟體

更新通知(170711)

2017-07-11T11:16:00.002+08:00

因應Yahoo finance連結形式變動做了一些更新~有需要可以重新下載~
或更新其中的AC-DataServer.jar

更新通知(170608)

2017-06-08T21:34:00.004+08:00

因應證交所資料格式變動做了一些更新~有需要可以重新下載~

新版發布AC5.41

2017-05-16T20:30:00.001+08:00

因應台指期5/15開始的盤後電子盤修正了一些問題.

新版發布AC5.40

2017-05-07T18:15:00.000+08:00

這個版本已經放將近一年了,因為一直忙於交易的事務就耽擱了.

下載AC(150MB)

範例 - 2D選股(列表視窗)

2016-05-31T16:03:00.001+08:00

2D指的是個股的"時間軸"與"價格"，就像看一般技術分析的K線圖一樣，只看得到當下的標的，沒辦法做整體分析，這我稱為2D。而3D就是同時能看到"所有標的"的"時間軸"與"價格"，可以參考排序與過濾(選股)。

2D分析的邏輯就是僅能針對單一標的逐個執行，從腳本中可能看不太出來，不過事情就是這樣。

lib "personal";

public class MyScript extends CustomCorePersonal
{
 //選單需要的變數
 double MA_N = 10;
 double PRICE = 10;

 MA ma = null;
 public void init()
 {
  dbg.open();
  //初始化圖形指標介面 (但要關閉一些項目)
  cc_cfg.SHOW_MENU = false;
  cc_cfg.PAINT_LAYER = false;
  CustomCore_UI_INIT();

  //加入指標 (程式碼從圖形介面導出)
  ma = addIdct("K線", "移動平均_2", new MA("N[0]="+MA_N));

  //加入欄位
  tbl.addCol("日期", 2, RIGHT, true);
  tbl.addCol("收盤", 2, RIGHT, true);
  tbl.addCol(MA_N+"MA", 2, RIGHT, true);
  tbl.addCol("交易量", 2, RIGHT, true);
 }

 //製作選單
 public void eventShowInput()
 {
  HtmlInputHelper html = new HtmlInputHelper(LIGHTGRAY);
  html.add("選出", new InpNum("MA_N", 1, 3), "日均線向上");
  html.add("且 收盤價大於", new InpNum("PRICE", 1, 3), "的股票");

  updateInput(html.get());
 }

 public void endOfPeriod(int type)
 {
  //於EOH時才執行過濾判斷
  if (type == EOH)
  {
   //stop()用於通知系統這個核心已經不再需要執行
   //若是在盤中仍需執行則不用stop(),但須注意記憶體的用量
   if (close.ref(0)<PRICE)
    {stop();return;}
   if (ma.isNullRef(1) || ma.ref(0)<ma.ref(1))
    {stop();return;}

   //通過選股條件後,新增一列資料到列表中
   AcTableRow row = tbl.newRow(symbol, name);
   tbl.addRow(row);

   row.setDate(date.ref(0));

   row.setCell(0, date.ref(0).getTime(), date2Str(date.get(t), "yyyy-MM-dd"), black);

   row.setCell(1, close.ref(0), close.ref(0), black);

   row.setCell(2, ma.ref(0), round(ma.ref(0), 2), black);

   row.setCell(3, (long)vol.ref(0), black);
   
   stop();
  }
 }
}

程式碼很好懂，看看程式註解應該就能掌握了。

比較會有問題的部分可能在設定，常有選股結果一片空白的情況，通常是下面幾種情形:
1.) 股票池的標的太少，試試看用[設定]>>[列表庫]>>[台股全部]。
2.) 報價資料的天數不夠，例如要找50ma向上的股票，但報價只有給40天。
3.) 選股條件太嚴苛。

大致上是這樣，設定的部分有哪些?可以看一下這個圖。

2D選股還有一種做法，不用寫腳本，用圖形介面點點選選就可以了，腳本在script/chart/99.AC提供/自訂選股.java。

怎麼進行版本更新?

2016-05-29T17:57:00.000+08:00

AC一路上更新了很多次版本，也有改到面目全非的程度，好似換了軟體一樣，但軟體功能一直往上提升，有些陣痛也是值得的。

發展至今一直沒有"自動更新"的模組，其實也不是的，一開始是有的，但隨著更新過程不斷推翻太多的東西，自動更新也開始不適用了，所以還是要請各位手動更新，在此提供各位幾個小技巧，減少更新的陣痛。

小技巧
* 如果舊版本運做得很好，建議不要更新，或新舊版本並行。

* 要更新時，以新版本為基底，從舊版本選擇要保留的檔案覆蓋到新版本。

* 將自己開發的腳本放在屬於自己建立的目錄，更新時可以直接搬走。

* 要更新前先備份舊版本，並大膽嘗試直接覆蓋config目錄或其他xml設定檔到新版本。

* 最保險的方式就是全部用新版本，只將腳本搬過去，其餘再手動設定。

* 資料庫以5.x版為分界，前後版不能共用。

lib-api - 各指標API(accustomcore)

2016-05-29T17:13:00.000+08:00

雖然我覺得很容易，但可能還是要提一下。我們已經知道如何透過圖形介面新增指標，也知道怎麼把指標的程式碼導出寫到腳本上，但是在腳本要怎麼取得這些指標的各種數值?

例如一個KD指標，我要如果分別取得k跟d值呢?我先講解一個例子，後面就依樣畫葫了。

KD (script\library\accustomcore\src\IDCTs\02.指標\KD.java)
KD指標的長的像是這樣，但剃除了多餘的部分，僅留下你們會用到的部分。

public class KD extends IDCT
{
 public MovinNum k;
 public MovinNum d;
}

用法範例如下 : (14與15行)

public class MyScript extends CustomCorePersonal
{
 KD kd = addIdct("KD", "KD_3", new KD("")); 

 public void init()
 {
  CustomCore_UI_INIT();
 }

 public void endOfPeriod(int type)
 {
  if (type == EOH)
  {
   dbg.print("K為 : " + kd.k.ref(0));
   dbg.print("D為 : " + kd.d.ref(0));
  }
 }
}

MA
再看一個最常用的均線。

public class MA extends IDCT
{
 MovinNum[] value_arr = new MovinNum[DEF_VAR_SIZE];
}

稍微有點不一樣，變成是一個MovinNum的陣列了，會這樣設計是為了讓使用者透過一個指標設定多條均線，但用法大同小異。

1
2
3

dbg.print("預設(同第一條均線) " + ma.ref(0));
dbg.print("第一條均線 " + ma.value_arr[0].ref(0));
dbg.print("第二條均線 " + ma.value_arr[1].ref(0));

---

大致上都可以用類似kd.ref(0)直接取得該指標預設的值，除非該指標含有多種數值，就需要用類似kd.d.ref(0)的寫法。

恕我沒能將所有指標都像這樣帶各位瀏覽一遍，是覺得有點麻煩，但其實accustomcore這個部分是有開放原始碼的，大概看一下變數的宣告其實就知道有什麼變數能用，不算太難，也算是一個小小的考驗吧。

程式交易系統(ACTrader)

2016-05-29T13:02:00.000+08:00

這個交易系統我執行了差不多四、五年了，一直沒有釋出，只有幾個朋友在玩，因為早期的版本不完善、不容易上手，直到最近感覺各方面似乎都還挺不錯的，才有了釋出的想法。

其實我認知到有程式交易時，還沒聽過MC、AB、MT等知名交易軟體，只是一股腦的想怎麼實現整個交易過程，之後知道這些軟體時，早已經沉醉在寫程式的苦海中了，頭都洗一半了...。所以這套交易系統的規劃算是個人經驗的累積，包含資金控管、績效回測、滑價模擬、限價模擬、轉倉等等，再整合即時報價、盤後回補與下單API做到一條龍的程式交易系統，不需要再安裝第三方軟體即可運作(當然券商的API等還是需要的)。

先看看圖形介面可供設定的選項，對系統有初步認識後，再看交易策略腳本怎麼寫吧。

選單畫面
首先是選擇策略

整體設定 - 資控
點進"中控"可以看到...

第一次看到這個畫面會覺得有些混亂，解說一下。最上方看到[整體策略]跟[周K突破]，分別點選後都會看到不同的選單，[整體策略]是針對群體的設定，其他例如[周K突破]是針對個別策略的設定。以這張圖來說，看到的是[整體策略]的設定(因為[整體策略]是以紅字顯示)，整個看到的是[整體策略]>>[設定]>>[資控]

記錄檔:實單交易時須給定紀錄名稱，並選定紀錄方式到"不重置"。
執行模式:實單交易時須設定成"實單"。
資控:整體資控主要是設定本金與盈餘的分配比例。

整體設定 - 商品
點進"中控"可以看到...

這些是預設的可操作商品，設計上主要是針對期貨，選擇權也可以下，只有"台股"是不能下實單的，當然日後也是可以擴充的。策略中也可以設定成混和操作的方式。

整體設定 - 查價

當策略分析的商品與實際下單商品不同時就會有查價的需求，通常不用理會，只有在交易"非熱門合約"時需要設定成"以商品合約報價"。

交易撮合延遲可以用來模擬滑價的情形，這段延遲就相當於下單到交易所撮合成交的時間。

整體設定 - 追蹤

可以在特定的時間點暫停腳本，在策略開發期間可以用來檢視每個信號的合理性，也有助於類似覆盤的型態觀察。

整體設定 - 報價群

這裡可以看到所有策略執行需要的報價者，每一個都相當於一個副腳本執行核心(ScriptCore/InnerCore)，負責提供報價、指標等數據供策略參考。

個別策略設定 - 策略設定
點選個別策略後可以看到...

這裡邊的設定可以減少開發策略腳本的困擾，自動平倉、轉倉等，減少腳本需要處理的事務。

個別策略設定 - 風險控制

主要是準備金的設定，與交易量的動態調控。

個別策略設定 - 信號規則

主要是抑制信號量，也可以直接在策略腳本中控制，都行。

個別策略設定 - 委託

實單交易時委託下單機構須設定為"康和期貨"，這也是ACTrader唯一支援的期貨商，可以再擴充其他家，但暫時沒有需求與必要性，系統還算穩定。

個別策略設定 - 動作

這部分是用來手動干預信號或部位用的，畢竟有時還是會"出槌"，像是報價斷線、下單失敗等，這麼多年還是有遇過幾次。

外掛 - 下單API

一樣只支援康和期貨。帳號密碼輸入完記得按下[Enter]鍵，再測試登入，確定沒問題後再勾"自動登入"。
芭樂單的測試會委託一個不可能成交的價位，只要券商軟體有看到委託，即算是有成功。

---

至此，加上先前介紹過的即時報價外掛，與程式交易相關的畫面大概都看完了。這套系統現在最大的限制就是只能下"康和期貨"，因為從幼幼一直用到現在，穩定度還可以。

---

系統概述
在講策略怎麼寫前，容我先簡單陳述一下ACTrader的架構。整個系統有三個主要類別:

1.) ACTradeCenter : 如其名，它就是系統的中控，負責協調各個部分，也是MyScript(主腳本)必須繼承的對象。但這個部分已經有一個固定的腳本叫"策略集"，會替開發者搜尋"library/策略集"下的所有策略，再透過圖形介面點選即可已加入策略。

2.) ACQuoter : 報價者。負責提供報價、指標等數據供交易策略參考，本身是以InnerCore(副腳本)的方式存在。

3.) ACTrader : 交易(策略)者，相當於交易策略。ACTradeCenter會在適合的時間點讓交易策略執行。

對策略開發者而言，要知道一個ACTrader(交易者)一定要配一個ACQuoter(報價者)，之後衍生出另一種整合ACQuoter與ACTrader的類別，叫ACTactic，本身是一個ACQuoter，開發者需在其類別內建立一個ACTrader，即ACTrader宣告在ACQuoter內，也是現在最常用的方式。

ACQuoter的部分其實就相當於一個繼承了CustomCore的MyScript，照樣像以前一樣建立需要的指標即可。而交易動作的部分則集中在ACTrader上，為因應期貨、選擇權的操作屬性，又做了一個叫TWFOTrader的類別來繼承ACTrader，這個類別中附加了平倉的方式與時間，還可以選定交易商品、模式等，減少開發者的工作，若有不足時，也可以改寫另一個適合的類別，這就是物件導向繼承的好處。

策略範例
所以現在我們可以看一下策略要怎麼寫了。

class BREAK_WEEK extends ACTactic
{
 static String nickname = "周K突破";

 //指標宣告(程式碼與參數從UI導出)
 MA ma = addIdct("K線", "均線", new MA("N[0]=100.0&_color[0]=4291020916&_paint_width[0]=2.0&_cut_daily[0]=false")); 
 TIMEFRAME week = addIdct("K線", "周K", new TIMEFRAME("period=5&validsize=10&_syncz[1]=true&_show[1]=true&_syncz_sft[1]=1.0&_syncz[2]=true&_syncz_sft[2]=1.0&_show[2]=true&_paint_width[2]=2.0&_color[2]=4278216345&_color[1]=4294927872&_paint_width[1]=2.0&_cut_daily[1]=true&_cut_daily[2]=true")); 

 public BREAK_WEEK()
 {
  //給定預設值,不給也可以,之後再透過UI修改
  CFG_PERIOD_N = 15;
  CFG_PERIOD_TYPE = PERIOD_MIN;
 }

 class MyTrader extends TWFOTrader
 {
  public MyTrader()
  {
   //給定預設值,不給也可以,之後再透過UI修改
   CFG_BAR_SIGCNT = 1;
   CFG_DAY_SIGCNT = 1;
  }

  //交易策動
  public void trader_trade()
  {
   //確保能參考到需要的資料
   if (ma.isNullRef(1) || week.high.isNullRef(5))
    return;

   double week3HL = ???;

   if (getSig() != D.STYPE_LONG && ???)
   {
    if (week3HL < ??? && ???)
     setSig(D.STYPE_LONG); //建立多方信號
    else
     setSig(D.STYPE_CLS); //建立平倉信號
   }

   if (getSig() != D.STYPE_SHORT && ???)
   {
    if (week3HL < ??? && ???)
     setSig(D.STYPE_SHORT); //建立空方信號
    else
     setSig(D.STYPE_CLS); //建立平倉信號
   }
  }
 }
}

這裡面可以看到兩個類別(class)的宣告，分別繼承(extends)了ACTactic、TWFOTrader，其中ACTactic相當於ACQuoter，TWFOTrader相當於ACTrader，也就是一個"交易者"包在一個"報價者"裡面的架構。

寫好後只需把這個腳本放在"library/策略集"下即可，之後再將圖格中腳本切換到"策略集"，就可以看到寫好的策略選項。

---

接著大概看一下需要認識的API有哪些。對於一般的投資人，其實透過方才的範例就已經學到了足夠的API可以編寫策略了(即getSig與setSig)。

API - 中控(ACTradeCenter)

public abstract class ACTradeCenter extends ScriptCore
{
 //當中控準備完成會呼叫這個函數,通常會在此時建立策略
 public abstract void center_ready();

 //加入一個ACTactic
 public void addTactic(String ID, ACTactic tactic)

 //寄信(gmail). 寄收件人由UI設定. RTQOnly為true表示只有在盤中寄送.
 public void mailNotice(boolean RTQOnly, String title, String content)

 //暫停執行. 偵測交易狀況用. 繼續執行的按鈕在除錯視窗中.
 public void pause(ACTrader trader)

 //取得某ACTrader的初始資本
 public double getInitPrincipal(ACTrader trader)

 //取得某ACTrader的可再投資資本
 public double getReinvest(ACTrader trader)

 //取得某ACTrader的可投資資本 (即InitPrincipal+Reinvest)
 public double getInvestableFund(ACTrader trader)
}

在ACTrader中可以用"center"這個變數名稱對應到ACTradeCenter。

還有些跟選股回測相關的沒列出來，手上也沒有好的範例，暫時就別徒增困擾了。

API - 報價者(ACQuoter)

public class ACQuoter extends CustomCore implements ParamIns
{
 //指定報價符號
 public String CFG_SYMBOL = "";

 //指定結算商品
 public String CFG_SELLTE_COMM = "";

 //指定K線週期N
 public int CFG_PERIOD_N = 10;

 //指定K線週期
 public int CFG_PERIOD_TYPE = PERIOD_MIN;

 //指定報價刻度
 public int CFG_PRECISE_TYPE = PERIOD_AUTO;

 //指定K棒保留數量 (避免多策略時造成記憶體不足)
 public int CFG_VALID_KSIZE = 10000;

//---

 //報價者ID
 public String QID = null;

 //中控
 public ACTradeCenter center;

 //K線圖層
 Layer lay_k = null;

 //信號圖層
 Layer lay_sig = null;

//---

 //報價init()
 public void quoter_init() {}

 //報價run()
 public void quoter_run() {}

 //取得報價對應合約的剩餘天數
 public int getValidDays()

 //檢查時間是否已過合約收盤時間-backward_time(ms)
 public boolean timesup(long backward_time) //ms

 //檢查時間是否穿越hhmmss
 public boolean timecross(int hhmmss)

 //檢查時間是否在hhmmss1與hhmmss2之間
 public boolean timeinside(int hhmmss1, int hhmmss2)
}

有初始值設定(CFG_開頭)的部分，以及getValidDays()用來取得距離結算的天數。如果還有額外的指標或變數要運算可以寫在quoter_run()中。

API - 交易者(ACTrader)

public abstract class ACTrader extends ScriptBasic implements CorePartner, ParamIns
{
//---信號限制設定主要是基於安全性 更細部的動作控制還是要寫到策略中

 //設定一日的信號數量
 public int CFG_DAY_SIGCNT = 99;
 //設定一根K棒的信號數量
 public int CFG_BAR_SIGCNT = 1;

//---

 //交易者ID
 public String TID;

 //中控
 public ACTradeCenter center = null;

 //監視的報價者
 public ACQuoter quoter = null;

 //統計
 public STATS stats = null;

 //當下信號
 public RecSig curr_sig = null;

//---(事件類型,供複寫(Override))

 //策略部分.
 public void trader_init(){};
 public void trader_run(){};
 public void trader_eop(int type){};
 public void trader_menu(HtmlInputHelper html){};
 //策略處理.
 public abstract void trader_trade();

 //信號部分.
 public void sighd_init(){};
 public void sighd_run(){};
 public void sighd_eop(int type){};
 public boolean sighd_trade(){return true;};
 public void sighd_menu(HtmlInputHelper html){};
 //信號處理 (產生標的物及目標口數)
 public abstract void sighd_sig(final int stype);

//---

 //設定信號
 public boolean setSig(int stype) {return setSig(stype, null);};
 public boolean setSig(int stype, String desc)

 //取得當下信號
 public int getSig()

//---

 //取得交易合約
 public Contract getContract(String comm_key, int cont_shift)

 //取得選擇權交易合約
 public Contract getContract(String comm_key, int cont_shift, int cp, double price, int p_shift)

//---

 //信號發生的t點
 public int sigT = -1;

 //信號清除(平倉)的t點
 public int clsT = -1;

 //信號發生或清除的t點
 public int actT = -1;
}

大致比較有機會用上的有這些。在前面的範例中我們只用到了trader_trade()、getSig()、setSig()就足以完成一個策略，其他像是交易商品、結算、準備金、口數控制等都可以透過圖形介面修改，除非要做比較特別的交易方式，不然這樣差不多夠了。

擴充類別

有兩個功能是可以擴充的，分別是風險控制(交易量調控、RiskCtrl)與停損停利(StopCtrl)，只要分別繼承(extends)這兩個類別放在程式碼中，就可以在UI選單中找到，若放在library中就可以讓所有策略共同使用這些功能，不用一直重寫，也方便嘗試不同搭配。詳細的寫法在library/ACTrader中都可以找到範例(搜尋關鍵字類似"extends RiskCtrl")。

總結

本著童叟無欺的理念，最後還是要很客觀的評價自己的東西。如果你是一個放眼世界的投資人，AC不會是一個好選擇，甚至不會是一個選項，這是可以理解的，畢竟小弟隻身一人、沒有團隊支援、沒有財經背景，也是盡了很大的努力才只有這樣的進度。

---

2017-05-07更新

花了幾個月的時間熟悉了一下Multicharts,很快就進入狀況了,報價與下單也都整合的不錯,我的程式交易平台已經完全轉移到MC上了,也就是說我已經放棄AC程式交易的部分了,以一個程式開發者而言我感到有些遺憾,但以一個交易者而言我感覺得到了解脫,終於能夠認真地從事交易了.

lib-api - 指標圖形介面(accustomcore)

2016-05-25T14:15:00.001+08:00

除非是要做系統應用的開發，否則這個章節用到的東西極少，一般專注在指標使用、策略、選股等的使用者可以跳過不看。

為求簡單，這個章節只就介面部分提及一些比較有可能用到的變數、函數、類別，更精準用法可以直接參考原始碼(script/library/accustomcore)。

樣本
樣本本身會是一個NumSet的類型，可以用字串來索引，除了一些系統預設的"基樣"外，命名方法是以"指標名稱.變數值名稱"。

型別	名稱	說明
String	SAMPLE_ID_CLOSE	基樣.收盤價
String	SAMPLE_ID_OPEN	基樣.開盤價
String	SAMPLE_ID_HIGH	基樣.最高價
String	SAMPLE_ID_LOW	基樣.最低價
String	SAMPLE_ID_VOL	基樣.成交量

取得樣本的方法。

函數	說明

NumSet getNumSample(String sid)	取得某樣本
NumSet getSynczNumSample(String sid)	取得某已同步的樣本

指標

函數	說明

T addIdct(String layer_name, String idct_name, IDCT idct)	加入指標
IDCT getIdct(String idct_name)	取得指標

圖層

函數	說明

Layer getLayer(String layer_name)	以主圖格名稱取得Layer
Layer getIdctLayer(String idct_name)	以指標名稱取得Layer

...

好像沒什麼好說的了??應該說這個library中開發者比較會參與到的部分是指標的IDCT類別，但在"自訂指標類別"的範例中其實已經解說過了，剩下很多的東西都是內部系統控制的部分，說了也是徒增開發者的困擾。

這邊順帶一提"開發者要怎麼研究程式碼?"
1.) 猜看看變數名稱有什麼意義
2.) 改看看會有什麼結果
3.) 找看看別的地方的程式碼怎麼用(用變數、函數名稱等關鍵字串搜尋目錄內的所有java檔)

說穿了其實看程式碼要有些想像力，對應用也要有些概念，試著把一些分散的邏輯組合成完整的功能，有時候對我而言還蠻有趣的...但有時候也很痛苦，要看出發點是什麼，才能決定能走多遠。

範例 - 排序與過濾(3D選股)

2016-05-24T20:32:00.002+08:00

選股的兩大手段，想做機械或程式化者必看。

哪天是最高價？

跟選股沒關係，但在時間軸分析時或許用得上。

lib "personal";

public class MyScript extends CustomCorePersonal
{
 public void init()
 {
  //對CustomCore_UI初始化
  CustomCore_UI_INIT();
 }

 public void endOfPeriod(int type)
 {
  //在主副腳本都執行完歷史資料時顯示最後一天的報價
  if (type == EOH)
  {
   int[] sft_arr = sort(high, 0, 10, B2S);
   int Ht = sft_arr[0];
   dbg.print("近10根的最高價在第" + Ht + "根");

   Layer layer = getLayer("K線");
   layer.drawSteadyNext();
   layer.drawStr(Ht, high.get(Ht), "H", blue, transp(red, 22), black, LEFT, 0, true);
  }
 }
}

重點在16行的排序函數，其實也就是在ScriptBasic裡的一個函數，可以回傳排序後的t，很簡單，主要是看個人怎麼運用。

股價排行榜

上一個範例是將一個動態陣列排序，而這一個是將多檔股票的收盤價排序。

lib "personal";

public class MyScript extends CustomCorePersonal
{
 ArrayList<MyInnerScript> inners = new ArrayList<MyInnerScript>();

 public void init()
 {
  CustomCore_UI_INIT();

  //取得水泥股的全部符號
  String[] arr = getCateSymbols("證所分類|金融傳產類|水泥工業");
  for (int i=0; arr!=null&&i<arr.length; i++)
  {
   //建立副腳本核心
   MyInnerScript inner = new MyInnerScript();
   inners.add(inner);
   addInnerCore(inner, arr[i], null, null, 1, PERIOD_DAY, PRECISE_DAY, false);
  }
 }

 public void endOfPeriod(int type)
 {
  //在主副腳本核心都執行完歷史資料時
  if (type == EOAH)
  {
   //排序inners陣列
   ArrayList<MyInnerScript> sorted_inners = sort(inners, 0, B2S);

   //顯示排序結果
   dbg.open();
   dbg.print("價格排行");
   dbg.print("--------------");
   for (int i=0; i<sorted_inners.size(); i++)
   {
    MyInnerScript inner = sorted_inners.get(i);
    dbg.print(inner.name + " 收盤 : " + inner.close.ref(0));
   }
  }
 }
}

//需要被排序的類別必須實做Sortable介面
class MyInnerScript extends CustomCorePersonal implements Sortable
{
 public void init()
 {
  CustomCore_UI_INIT();
 }

 //Sortable需要時做的函數
 public Double getSortValue(int keyidx)
 {
  //可依keyidx決定依何變數進行排序
  return close.ref(0);
 }
}

12~19行 : 建立多檔股票的副腳本核心(InnerCore)。
28行 : 排序。
44~57行 : 需排序的類別需時做Sortable介面，即getSortValue函數。

選股範例

再來一個完整的選股範例，有選單有表格，改一下選股的條件是可以符合你的需求，完整一個全域的選股機制。

大致先講一下這個範例的選股邏輯，就只是很簡單的將價格前幾N名與量能前幾N名選出，如果價格與量能都在前N名，則加到列表中。(這只是技術性說明...沒什麼邏輯...我知道)

lib "personal";

public class MyScript extends CustomCorePersonal implements InpEventListener
{
 HtmlPanel my_panel = new HtmlPanel(LIGHTGRAY, BLACK, false, JScrollPane.HORIZONTAL_SCROLLBAR_NEVER, JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);
 AcTable tbl = null;

 String CFG_CATE = "證所分類|金融傳產類|水泥工業";
 int CFG_PRICE_LIMIT = 50;
 int CFG_VOL_LIMIT = 50;

 ArrayList<MyInnerScript> inners = new ArrayList<MyInnerScript>();

 public void init()
 {
  dbg.open();
  CustomCore_UI_INIT();

  //製作選單
  HtmlInputHelper html = new HtmlInputHelper(LIGHTGRAY);
  html.add(new InpMenu("CFG_CATE", getSymbolCates(), getSymbolCates(), 0, this));
  html.add("價格前 : ", new InpNum("CFG_PRICE_LIMIT", 1, 2, this), "%");
  html.add("量能前 : ", new InpNum("CFG_VOL_LIMIT", 1, 2, this), "%");
  my_panel.setText(html.get());


  //製作表格
  tbl = new AcTable();
  tbl.setTableClickListener(new TableClickListener()
  {
   //處理表格點擊事件
   public void clicked(AcTableRow row)
   {
    changeView((ScriptCore)row.custom_carry);
   }
  });
  tbl.addCol("名稱", 2, ScriptBasic.CENTRAL, true);
  tbl.init();


  //將選單與表格加入左側選單
  AcPanel panel = new AcPanel(new BorderLayout());
  panel.add(my_panel, BorderLayout.NORTH);
  panel.add(tbl, BorderLayout.CENTER);
  addTabPanel("選股", panel);


  //取得選定的股票池的全部符號
  String[] arr = getCateSymbols(CFG_CATE);
  for (int i=0; arr!=null&&i<arr.length; i++)
  {
   //建立副腳本核心
   MyInnerScript inner = new MyInnerScript();
   inners.add(inner);
   addInnerCore(inner, arr[i], null, null, 1, PERIOD_DAY, PRECISE_DAY, false);
  }
 }

 //處理選單事件
 public boolean eventOccurred(InpComponent comp, Args arg)
 {
  //事件發生時重新執行腳本
  return true;
 }

 public void endOfPeriod(int type)
 {
  //在主副腳本核心都執行完歷史資料時
  if (type == EOAH)
  {
   //排序"價格"
   ArrayList<MyInnerScript> sorted_1 = sort(inners, 0, B2S);
   //排序"量能"
   ArrayList<MyInnerScript> sorted_2 = sort(inners, 1, B2S);

   //"價格"中取出前CFG_PRICE_LIMIT%
   sorted_1 = new ArrayList<MyInnerScript>(sorted_1.subList(0, (int)(sorted_1.size()*(CFG_PRICE_LIMIT/100.0))));

   //"量能"中取出前CFG_VOL_LIMIT%
   sorted_2 = new ArrayList<MyInnerScript>(sorted_2.subList(0, (int)(sorted_2.size()*(CFG_VOL_LIMIT/100.0))));

   //顯示"價格"選出結果
   dbg.print("價格前" + CFG_PRICE_LIMIT + "%");
   dbg.print("--------------");
   for (int i=0; i<sorted_1.size(); i++)
   {
    MyInnerScript inner = sorted_1.get(i);
    dbg.print(inner.name + " 收盤 : " + inner.close.ref(0));
   }
   dbg.print("");

   //顯示"量能"選出結果
   dbg.print("量能前" + CFG_VOL_LIMIT + "%");
   dbg.print("--------------");
   for (int i=0; i<sorted_2.size(); i++)
   {
    MyInnerScript inner = sorted_2.get(i);
    dbg.print(inner.name + " 量 : " + inner.vol.ref(0));
   }

   //從"價格"中保留與"量能"重疊的部分
   sorted_1.retainAll(sorted_2);

   //將最終剩下的加到表格中顯示
   for (int i=0; i<sorted_1.size(); i++)
   {
    MyInnerScript inner = sorted_1.get(i);

    AcTableRow row = tbl.newRow(inner.symbol, inner.name);
    tbl.addRow(row);

    row.setCell(0, inner.name, Color.black);
    row.custom_carry  = inner;
   }
  }
 }
}

//需要被排序的類別必須實做Sortable介面
class MyInnerScript extends CustomCorePersonal implements Sortable
{
 public void init()
 {
  CustomCore_UI_INIT();
 }

 //Sortable需要時做的函數
 public Double getSortValue(int keyidx)
 {
  //可依keyidx決定依何變數進行排序
  if (keyidx == 0)
   return close.ref(0);
  else
   return vol.ref(0);
 }
}

主要的排序與過濾動作在71~102行，排序就是區別強弱程度，過濾就是透過一些機制淘汰或保留一些股票。可以先從單一標的下手，分析單純的時間、價格，用指標、趨勢、型態等，再轉換到全域的選股、績效回測。

範例 - 多符號(股票)並行(InnerCore)

2016-05-24T15:35:00.001+08:00

大多數狀況下我們的腳本都在處理單一標的物，但面對股票市場，除了單一標的物的時間價格分析外，還必須分析整體的強弱程度，不僅要讓程式告訴我們哪裡進出場，還要能告訴我們該進什麼股票...當然這是一個很大的題目，但我們在這僅討論工具的實現，如果哪天我有資格討論財富的實現，一定會大肆分享一番的XD。

這裡用一個簡單的範例說明如何加入一個副腳本(InnerCore)。

lib "personal";

public class MyScript extends CustomCorePersonal implements InpEventListener
{
 HtmlPanel my_panel = new HtmlPanel(BLACK, BLACK, false, JScrollPane.HORIZONTAL_SCROLLBAR_NEVER, JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);
 MyInnerScript inner = null;
 
 public void init()
 {
  dbg.open();
  CustomCore_UI_INIT();

  //建立副腳本核心,並令其以周K執行
  inner = new MyInnerScript();
  addInnerCore(inner, "tw.IX.0001", null, null, 1, PERIOD_WEEK, PRECISE_DAY, false);

  //在側邊選單加入按鈕
  HtmlInputHelper html = new HtmlInputHelper(LIGHTGRAY);
  html.add(new InpBtn("主核心", this, new Args("cmd=main")));
  html.add(new InpBtn("副核心", this, new Args("cmd=inner")));
  my_panel.setText(html.get());

  addTabPanel("選擇顯示", my_panel);
 }

 public void endOfPeriod(int type)
 {
  //在主副腳本都執行完歷史資料時顯示最後一天的報價
  if (type == EOAH)
  {
   dbg.print("主:" + name + " " + YMD(date.ref(0)) + " 收盤 : " + close.ref(0));
   dbg.print("副:" + inner.name + " " + YMD(inner.date.ref(0)) + " 收盤 : " + inner.close.ref(0));
  }
 }

 //處理按鈕事件
 public boolean eventOccurred(InpComponent comp, Args arg)
 {
  if (arg != null && arg.get("cmd").equals("main"))
   changeView(this);
  if (arg != null && arg.get("cmd").equals("inner"))
   changeView(inner);
  return false;
 }
}

class MyInnerScript extends CustomCorePersonal
{
 KD kd = addIdct("KD", "KD_2", new KD(""));
 public void init()
 {
  CustomCore_UI_INIT();
 }

 //給副腳本一個不同於主腳本的Instance Name,可以區別兩者的指標設定
 public String getInsName()
 {
  return "inner";
 }
}

重點在15行，以及46~60的副腳本類別。可以在主腳本執行期間加入N個副腳本，並動態指定標的物符號、K線週期、執行時間區域等參數，詳細函數參數可以直接參考文件。

這種執行方式我又稱"多核心"，核心指的是ScriptCore，但怕語意不明，所以沒用在標題上。通常都是用在選股或需要比較強弱的狀況下，後面會再有一篇介紹如何排序結果。

範例 - 引用外部程式+SQLite範例

2016-05-23T16:53:00.000+08:00

所謂引用外部程式，就是借助其他外部的.java或.jar程式碼或檔案，使腳本功能得以被擴充，像是SQLite與JFreeChart都是我會引用的jar檔。其實我們一直都在"引用"，看看下面這個熟悉的範例。

lib "personal";

public class MyScript extends CustomCorePersonal
{
 public void init()
 {
  //對CustomCore_UI初始化
  CustomCore_UI_INIT();
 }
}

第一行的敘述就是引用外部程式，這裡引用一個目錄(script/library/personal)，目錄下的所有.java檔都會一併被引用，最終也會引用到CustomCore(script/library/accustomcore)。

這邊另外提一件事，就是MyScript為什麼不直接繼承CustomCore，而要透過personal裡的CustomCorePersonal在去繼承CustomCore，其實主要是將腳色分配清楚，accustomcore由AC維護，personal由使用者自行維護，可在CustomCorePersonal中追加功能，如果AC要更新時就會比較容易替換。

---

也可以引用jar檔(一種壓縮檔，裡面放了很多編譯好的類別)，這裡藉著引用jar檔的範例，順便示範一下SQLite的用法。

lib "personal";
lib "sqlite-jdbc-3.8.7.jar";

import java.sql.*;
import org.sqlite.SQLiteConfig;
import org.sqlite.SQLiteDataSource;

public class MyScript extends CustomCorePersonal implements InpEventListener
{
 HtmlPanel my_panel = new HtmlPanel(BLACK, BLACK, false, JScrollPane.HORIZONTAL_SCROLLBAR_NEVER, JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);
 MyDB mydb = new MyDB();

 public void init()
 {
  //對CustomCore_UI初始化
  CustomCore_UI_INIT();

  //在側邊選單加入按鈕
  HtmlInputHelper html = new HtmlInputHelper(LIGHTGRAY);
  html.add(new InpBtn("建立資料表", this, new Args("cmd=create")));
  html.add(new InpBtn("新增資料", this, new Args("cmd=new")));
  html.add(new InpBtn("列出資料", this, new Args("cmd=list")));
  my_panel.setText(html.get());

  addTabPanel("資料庫", my_panel);
 }

 //處理按鈕事件
 public boolean eventOccurred(InpComponent comp, Args arg)
 {
  try
  {
   dbg.open();
   dbg.clear();

   if (arg != null && arg.get("cmd").equals("create"))
   {
    mydb.createTable();
    dbg.print("已建立資料表");
   }
   if (arg != null && arg.get("cmd").equals("new"))
   {
    String data = inpDialog("輸入資料", "輸入資料", "ABC");
    if (data != null && data.length() > 0)
    {
     mydb.insert(data);
     dbg.print("資料新增完成");
    }
   }
   if (arg != null && arg.get("cmd").equals("list"))
    mydb.listAll();
  }
  catch (Exception ex) {EX_HANDLE(EX_INT, ex);}
  return false;
 }


 //腳本終結時呼叫
 public void uninit()
 {
  //記得db要close
  if (mydb != null)
   mydb.close();
 }


 class MyDB
 {
  final String dbname = "mydbtest";
  final String tblname = "test";
  Connection con = null;

  public MyDB()
  {
   try
   {
    SQLiteConfig config = new SQLiteConfig();
    config.setSharedCache(true);
    config.enableRecursiveTriggers(true);

    SQLiteDataSource ds = new SQLiteDataSource(config);
    ds.setUrl("jdbc:sqlite:sqldb/"+dbname+".db");
    con = ds.getConnection();
   }
   catch (Exception ex) {EX_HANDLE(EX_INT, ex);}
  }

  //create Table
  public void createTable() throws SQLException
  {
   String sql = "DROP TABLE IF EXISTS "+tblname+" ;create table "+tblname+" (id INTEGER PRIMARY KEY AUTOINCREMENT, name STRING);";
   Statement stat = null;
   stat = con.createStatement();
   stat.executeUpdate(sql);
   
  }

  //drop table
  public void dropTable() throws SQLException
  {
   String sql = "drop table "+tblname+" ";
   Statement stat = null;
   stat = con.createStatement();
   stat.executeUpdate(sql);
  }
  
  //新增
  public void insert(String name) throws SQLException
  {
   String sql = "INSERT INTO "+tblname+" (name) VALUES ('" + name + "')";

   Statement stat = con.createStatement();
   stat.executeUpdate(sql);
  }

  //修改
  public void update(int id, String name) throws SQLException
  {
   String sql = "update "+tblname+" set name = ? where id = ?";
   PreparedStatement pst = null;
   pst = con.prepareStatement(sql);
   int idx = 1 ;
   pst.setString(idx++, name);
   pst.setInt(idx++, id);
   pst.executeUpdate();
  }

  //刪除
  public void delete(int id) throws SQLException
  {
   String sql = "delete from "+tblname+" where id = ?";
   PreparedStatement pst = null;
   pst = con.prepareStatement(sql);
   int idx = 1 ;
   pst.setInt(idx++, id);
   pst.executeUpdate();
  }
  
  //列出
  public void listAll() throws SQLException
  {
   String sql = "select * from "+tblname+"";
   Statement stat = null;
   ResultSet rs = null;
   stat = con.createStatement();
   rs = stat.executeQuery(sql);
   int cnt = 0;
   while(rs.next())
   {
    cnt++;
    dbg.print(rs.getInt("id")+" : \t"+rs.getString("name"));
   }
   dbg.print("-------");
   dbg.print("共"+cnt+"筆");
  }

  public void close()
  {
   try
   {
    if (con != null)
     con.close();
   }
   catch (Exception ex) {EX_HANDLE(EX_INT, ex);}
  }
 }

}

引用的部分比較需要看的在2~6行，第二行引用的"sqlite-jdbc-3.8.7.jar"已經被放在script/library/下，其他幾行的import是java引用package的敘述，通常這種公開的jar檔在網路上都可以查到文件或範例。

---

另外一提，腳本還有一個固定會引用的目錄，就是script/library/default，裡面可以放一些使用者固定會引用java或jar檔，方便簡化開發流程。

範例 - 自訂指標類別

2016-05-22T23:34:00.000+08:00

這一章用一個計算N日高點的指標作為一個自訂指標的範例。

lib "personal";

public class MyScript extends CustomCorePersonal
{
 //這行是指標做後才從UI導出的程式碼
 EXAMPLE_HIGHEST idct = addIdct("K線", "N日高_2", new EXAMPLE_HIGHEST(""));

 public void init()
 {
  //對CustomCore_UI初始化
  CustomCore_UI_INIT();
 }

 public void endOfPeriod(int type)
 {
  if (type == EOH)
   dbg.print("最後的N日高為 " + idct.ref(0));
 }
}

//指標類別必須繼承IDCT
class EXAMPLE_HIGHEST extends IDCT
{
 //一定要有cate與title
 final static String cate = "範例";
 final static String title = "N日高";

 //建構子
 public EXAMPLE_HIGHEST(String param)
 {
  super(param);

  //設定參數初始值
  _ref_sample_id[0] = CustomCoreUI.SAMPLE_ID_HIGH;
  _color[0] = GOLD;
 }

 //指標初始化
 public void init()
 {
  //取得參考樣本
  sample = getRefSample(0);

  //使value與樣本資料量同步
  setGrowWith(value, sample);

  //將指標加入CorePartner,與腳本同步執行
  core.addCorePartner(this);

  //設定數值ID與其對應
  regValue("值", value, LINE);
 }

 //週期參數N
 public int N = 5;

 //宣告並實體化一個動態陣列 用來放置計算出來的數值
 public MovinNum value = new MovinNum(null);

 //宣告參考樣本
 public NumSet sample = null;

 //計算指標
 public void befTickRun()
 {
  try
  {
   //將value的值 設定為 sample的N日最高值
   value.set(highest(sample, 0, N));
  }
  catch (Throwable e) { /*e.printStackTrace();*/ }
 }

 //設定選單
 public void setMenu(HtmlInputHelper html)
 {
  html.add("參考樣本", core.new InpMenu("_ref_sample_id[0]", core.ARR_SAMPLE_DIR, core.ARR_SAMPLE_ID, 0, this));
  html.add("週期", core.new InpNum("N", 1, this));
 }
}

這邊的指標(IDCT)其實泛指所有能做成一個有意義的模組的類別，是從CustomCore的library中衍生，並不一定是技術分析裡所講的指標。

逐行的解釋可以先看程式碼的註解，大致的流程是:
1.) 物件初始化(建構子)時先將會用到的參數初始化，改成自己設想好的，或直接不做，後續再透過圖形介面(UI)點選。

2.) 指標初始化(init)時，此時指標後台已經備妥，可以開始做一些相關的指定。第一個regValue的MovinNum即為這個指標的預設參考變數，也就是idct.ref(0)同等於idct.value.ref(0)。

3.) 在befTickRun中計算指標值。

成功執行後就可以在指標的選單上找到"範例>N日高"了。

---

都是蠻制式的寫法，主要幾個名詞需要定義一下。

1.) 樣本(sample)，就是指數值取樣的來源，像是計算均線一樣，樣本可以是收盤價，也有人用開盤價。每個樣本都會有自己名字可以對應，像是"基樣.收盤價"("指標名稱.值的名稱")，有些系統預設的。

同樣的，在這個指標範例中的"value"變數也會變成一個樣本，可供其他指標參考。

2.) 資料量同步。因為樣本也可能是一個異步週期，例如核心是日線，但樣本是周線，兩者資料量就會不同，造成無法顯示在同一個週期的圖上。所以這裡的做法是，若樣本是一個異步資料，會先讓指標資料量跟樣本同步(也就是同樣與核心異步)，需要同步時(要顯示時)再透過圖形介面(UI)點選，此時會產生另一個同步的動態陣列。這部分聽起來會比較不好理解，其實也不用想太多，就是複製貼上照抄就好。

---

通常指標在開發時我會這樣寫，就是一個檔案裡把MyScript跟IDC寫在一起，但開發完成後我會將指標的部分移到\script\library\personal或\script\library\default下，因為這樣每個腳本都可以用這個指標，主腳本看起來也會比較乾淨。

AC內部寫好的指標都放在\script\library\accustomcore\src\IDCTs\下，大致都有分類，也盡量給予有意義的檔案名稱，是很好的參照範例。

---

此外在66~71處有一個try-catch，是Java的意外捕捉陳述，意思就是說如果try{}裡面的程式碼執行時出現"意外"，就會被中斷跳至catch{}裡的程式碼執行。那什麼是意外呢?舉個例子，現在只有50根K棒，但是要函數算出100根K棒的平均價，這時候就會產生一個意外。在AC中通常可以不用處理意外，因為有意外發生大多是該次的run()被中斷，下幾次run()可能就沒問題了，這裡會特別處理是不想AC在除錯視窗回報有意外，因為這是一件已經被理解的意外。

範例 - 圖層使用

2016-05-22T21:59:00.001+08:00

圖層的部分在"acs-api快速入門(4) - 畫圖與雜項"裡介紹了一些，不再贅述，這裡就直接切入進階的用法。

主要有兩個重點，1.) 與圖格游標互動 2.) 自訂畫圖類別

lib "personal";

public class MyScript extends CustomCorePersonal
{
 public void init()
 {
  CustomCore_UI_INIT();

  Layer layer = getLayer("K線");

  //加入自訂的畫圖元件
  layer.addSteady(new MyPaintElem());

  //用MotionAdapter偵測滑鼠HiLight的位置
  layer.setMotionAdapter(new MotionAdapter()
  {
   //當滑鼠移動X軸改變t時會呼叫這裡
   public void move(int t)
   {
    dbg.print("move " + " t:" + t);
   }
   //當滑鼠移動X或Y軸時會呼叫這裡
   public void move(int t, double value)
   {
    price = value;
    dbg.print("move " + " t:" + t + " v:" + value);
   }
   //當滑鼠點擊時會呼叫這裡
   public boolean click(int button, int t, double value) 
   {
    dbg.print("click button:" + button + " t:" + t + " v:" + value);
    return false;
   }
  });
 }

 double price = 0;

 //自訂畫圖類別
 class MyPaintElem extends SteadyElem
 {
  //當需要畫圖時會呼叫這裡,之後可以透過Java的畫圖函數任意揮灑
  public void paint(Graphics g, int runID, int idxFrom, int idxEnd, int idxHili, PaintBlockInfo block, PaintScaleInfo scalement)
  {
   int x1 = block.getBarPosCenterXByIdx(idxHili-idxFrom);
   int y1 = scalement.Vaule2Pos(price);

   g.setColor(black);
   g.drawString(""+price, x1, y1);
  }
 }
}

程式碼上已經有些註解可以輔助了解內容了，程式執行起來可以看到一個隨著滑鼠移動的價格提示字串。

範例 - 輸入元件(介面)

2016-05-19T19:21:00.001+08:00

輸入元件是腳本互動性很重要的一環，就像指標如果無法改變參數造成的困擾一樣，不過如果有繼承CustomCore(指標圖形介面)，就不太需要自己做輸入元件的介面了。但對於需要自行開發指標或參數選單的人，這一章可以得到很多東西。

AC可以儲存的變數類型有int、long、double、boolean、String與以上類型的陣列，儲存的方式是透過"變數的名稱"(字串)，所以元件的初始化都要給變數的名稱。可以顯示輸入介面的地方有圖格右鍵選單、圖格左側選單、列表則是固定在上方。詳細的用法就透過範例來了解吧。

圖格右鍵選單(或列表選單)

lib "personal";

public class MyScript extends CustomCorePersonal implements InpEventListener
{
 public void init()
 {
  CustomCore_UI_INIT();
 }

 int a = 5;
 public void eventShowInput()
 {
  HtmlInputHelper html = new HtmlInputHelper(LIGHTGRAY);
  html.add("輸入a : ", new InpNum("a", 1, 2, this));

  updateInput(html.get());
 }

 public boolean eventOccurred(InpComponent comp, Args arg)
 {
  dbg.open();
  dbg.print("a為 : " + a);
  return false;
 }
}

Line 3 : 最後面接了implements InpEventListener，表示這個類別會實做InpEventListener的介面函數，就是第19行的函數。

Line 11 : eventShowInput函數是當有顯示選單需求時會被呼叫的函數，這個函數裡要的事情就是把輸入元件的介面HTML字串做出來，再透過updateInput函數傳給系統。

Line 13 : HtmlInputHelper是一個簡化HTML語法的小工具，基本上的佈局配置(Layout)就是每次add為一行，每行可以很多欄。

Line 14 : 實體化了一個InpNum元件用來輸入變數"a"，後面接的參數不多說明了，自己亂改看看就知道牽動的關聯了。

Line 19 : eventOccurred函數，當輸入元件被更動時就會透過這個函數告知腳本。如果函數回傳true就表示腳本需要重新執行，若不需要可以回傳false。

---

看起來會很複雜嗎?其實很多都是固定的格式了，重點沒有幾行，如果真的還看不懂，你可能需要加強一下Java語言的能力，或動手亂改看看，反正改壞了重新下載解壓縮就還原了，給他亂整一通，很快就進入狀況了。

圖格左側選單

lib "personal";

public class MyScript extends CustomCorePersonal implements InpEventListener
{
 HtmlPanel my_panel = new HtmlPanel(BLACK, BLACK, false, JScrollPane.HORIZONTAL_SCROLLBAR_NEVER, JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);
 
 public void init()
 {
  CustomCore_UI_INIT();

  show_menu();
  addTabPanel("選單", my_panel);
 }

 int a = 5;
 public void show_menu()
 {
  HtmlInputHelper html = new HtmlInputHelper(LIGHTGRAY);
  html.add("輸入a : ", new InpNum("a", 1, 2, this));

  my_panel.setText(html.get());
 }

 public boolean eventOccurred(InpComponent comp, Args arg)
 {
  dbg.open();
  dbg.print("a為 : " + a);
  return false;
 }
}

Line 5 : 實體化一個HTML面板。

Line 12 : 把上述的HTML面板加到左側選單。

Line 21 : 把輸入元件的HTML字串設定給HTML面板。

左側頁籤選單
如果選項很多需要分類，可以用類似這樣的方式顯示。

lib "personal";

public class MyScript extends CustomCorePersonal
{
 AcTabbedPane tabpane1 = new AcTabbedPane("T1");

 public void init()
 {
  CustomCore_UI_INIT();

  HtmlPanel htmlp1 = new HtmlPanel();
  HtmlPanel htmlp2 = new HtmlPanel();

  htmlp1.print("我是HTML-1");
  htmlp1.setSidePanelSelectedListener(new SidePanelSelectedListener()
  {
   public void selected()
   {
    dbg.open();
    dbg.print("我被選到了!");
   }
  });

  tabpane1.insertTab("HTML-1", null, htmlp1, "", tabpane1.getTabCount());
  tabpane1.insertTab("HTML-2", null, htmlp2, "", tabpane1.getTabCount());
  addTabPanel("頁籤", tabpane1);
 }
}

這幾乎都是複製貼上的用法，不逐行解釋了。

全元件示範

lib "personal";

public class MyScript extends CustomCorePersonal implements InpEventListener
{
 HtmlPanel my_panel = new HtmlPanel(BLACK, BLACK, false, JScrollPane.HORIZONTAL_SCROLLBAR_NEVER, JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);
 
 public void init()
 {
  CustomCore_UI_INIT();

  show_menu();
  addTabPanel("選單", my_panel);
 }

 int value1 = 20;
 Date date_ = new Date();

 String[] slt_arr = new String[]{"選項0", "選項1", "選項2"};
 int slt_1_idx = 0;
 String slt_1_text = slt_arr[1];
 int slt_2_idx = 0;
 int slt_3_idx = 0;

 String text = "";

 boolean check1 = false;
 boolean[] check2 = new boolean[3];
 int check_s_int = 0;
 String check_s_str = "";

 Color color = Color.blue;

 double num = 3;
 int[] num_arr = new int[]{5, 10};

 public void show_menu()
 {
  HtmlInputHelper html = new HtmlInputHelper(LIGHTGRAY);
  html.add("勾選1", new InpChk("check1", ""));
  html.add("數字 : ", new InpNum("num", 0.5, 2));
  html.add("陣列數字 : ", new InpNum("num_arr[0]", 1, 2), new InpNum("num_arr[1]", 1, 2));
  html.add("日期 : ", new InpDate("date_"));
  html.add("字串輸入 : ", new InpText("text", 10));
  html.add("顏色 : ", new InpColor("color"));

  html.add("===========================");

  html.add("選項1 : ", new InpSlt("slt_1_idx", slt_arr), " (數字變數)");
  html.add("選項1 : ", new InpSlt("slt_1_text", slt_arr), " (字串變數)");
  html.add("選項2 : ", new InpSlt2("slt_2_idx", slt_arr), " 選單 : ", new InpMenu("slt_3_idx", slt_arr));

  html.add("===========================");

  html.add("勾選(多選多)", new InpChk("check2[0]", "A"), new InpChk("check2[1]", "B"), new InpChk("check2[2]", "C"));
  html.add("勾選(數字多選一)", new InpChk_S("check_s_int#0", "0"), new InpChk_S("check_s_int#1", "1"), new InpChk_S("check_s_int#2", "2"));
  html.add("勾選(字串多選一)", new InpChk_S("check_s_str#A", "A"), new InpChk_S("check_s_str#B", "B"), new InpChk_S("check_s_str#C", "C"));

  html.add("===========================");

  html.add(new InpBtn("按鈕1", this, new Args("")));
  html.add(new InpBtn("按鈕2", this).setListener(new InpEventListener()
   {
    public boolean eventOccurred(InpComponent comp, Args arg)
    {
     dbg.print("按下了按鈕2 (另一種處理方式)");
     return false;
    }
   })
  );

  my_panel.setText(html.get());
 }

 public boolean eventOccurred(InpComponent comp, Args arg)
 {
  dbg.open();
  dbg.print("變動了 '" + comp.vname + "' 的值");
  return false;
 }
}

這...應該也不用解釋了。

進階-建立有參數物件
用Java的好處就是物件導向，很多類別可透過繼承產生，同樣的類別也能無數次的實體化，當系統越做越"功夫"的時候，就產生了在自訂的物件上儲存參數的需求了。

lib "personal";

public class MyScript extends CustomCorePersonal implements InpEventListener
{
 HtmlPanel my_panel = new HtmlPanel(BLACK, BLACK, false, JScrollPane.HORIZONTAL_SCROLLBAR_NEVER, JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);

 InClass icls1 = null;
 InClass icls2 = null;

 OutClass1 a1cls = null;
 OutClass2 a2cls = null;

 public void init()
 {
  CustomCore_UI_INIT();

  icls1 = new InClass("ins_1");
  icls2 = new InClass("ins_2");

  a1cls = new OutClass1("a1", this);
  a2cls = new OutClass2("a2", this);
  
  show_menu();
  addTabPanel("選單", my_panel);
 }

 public void show_menu()
 {
  HtmlInputHelper html = new HtmlInputHelper(LIGHTGRAY);

  icls1.appendMenu(html);
  icls2.appendMenu(html);
  html.add("===========================");

  a1cls.appendMenu(html);
  a2cls.appendMenu(html);
  html.add("===========================");

  my_panel.setText(html.get());
 }

 public boolean eventOccurred(InpComponent comp, Args arg)
 {
  dbg.open();
  dbg.print("A:變動了 '" + comp.ins.getClass().getSimpleName() + " - " + comp.ins.getInsName() + " - " + comp.vname + "' 的值");
  return false;
 }

 class InClass implements ParamIns
 {
  int value = 20;
  final String insname;
  public InClass(String insname)
  {
   this.insname = insname;
   addParamIns(this);
  }
  final public String getInsName()
  {
   return insname;
  }

  public void appendMenu(HtmlInputHelper html)
  {
   html.add("內部類別("+insname+") : value : ", new InpNum("value", 1, 2, this));
  }
 }
}

//------------------------

class OutClass implements ParamIns, InpEventListener
{
 final String insname;
 final ScriptCore core;
 double value = 20;
 public OutClass(String insname, ScriptCore core)
 {
  this.core = core;
  this.insname = insname;
  core.addParamIns(this);
 }
 final public String getInsName()
 {
  return insname;
 }

 public void appendMenu(HtmlInputHelper html)
 {
  html.add("外部類別("+insname+") : value : ", core.new InpNum("value", 1, 2, this));
 }

 public boolean eventOccurred(InpComponent comp, Args arg)
 {
  core.dbg.open();
  core.dbg.print("B:變動了 '" + comp.ins.getClass().getSimpleName() + " - " + comp.ins.getInsName() + " - " + comp.vname + "' 的值");
  return false;
 }
}

class OutClass1 extends OutClass
{
 public OutClass1(String insname, ScriptCore core)
 {
  super(insname, core);
 }
}
class OutClass2 extends OutClass
{
 public OutClass2(String insname, ScriptCore core)
 {
  super(insname, core);
 }
}

這個範例中示範了內部與外部類別的用法，其實是差不多的，只是外部類別因為沒有包含在MyScript裡，也就沒有辦法直接使用MyScript繼承的函數，所以會把MyScript自己(this)丟給外部類別，讓外部類別能間接使用。可以看17~21行，OutClass比InClass多了一個this的參數。

一個類別要能夠儲存變數有幾個要點:
1.必須實做ParamIns介面好讓物件間有InsName可以辨別。
2.實體化後要執行addParamIns函數，把物件丟給AC核心認識，並覆載參數初始值。

acs-api快速入門(4) - 畫圖與雜項

2016-05-16T17:07:00.001+08:00

這是最後一個章節，也是重點比較少的章節，用一個範例快速解決它吧!剩下的以後再以範例解說。

public class MyScript extends ScriptCore
{
  //建立一個圖層
  Layer layer = addLayer(null, 0, "range=0~0.98;blank=3%;Y-AXIS=價格");

  //建立一個叫ma5的資料容器
  MovinNum ma5 = addMovinNum(null);

  public void init()
  {
    //畫K線
    layer.drawSteadyKBar(open, high, low, close, new ColorRef(close, open, colorup, colorbd, colordn, colorbd));
    
    //畫均線
    layer.drawSteadyLine(ma5, 2, true, new ColorRef(blue));

    //新增標籤
    layer.addValueTag(new ValueTag()
    {
      public void update(int t)
      {
        text = new String[]{"收盤價", ""+close.get(t)};
        value = close.get(t);
        bgcolor = new Color(0x505050);
        textcolor = gold;
      }
    });
  }

  public void run()
  {
    //計算ma5
    ma5.ma(close, 0, 5);
  }

  public void eventHilightMovin(int t)
  {
    //更新標題列
    updateTitle("<b>" + date2Str(date.get(t), "yyyy-MM-dd(E) ") + name);
  }
}

執行結果:

講兩個重點就好:

1. layer.draw...與layer.drawSteady...的差別 :

drawSteady是在init()時一次性設定後就完事了，內部會依照給入參數全部K棒一起畫。而沒有加Steady的draw是針對單一K棒或單一事件的畫法，每次畫完的下一次run()必須重新再呼叫函數畫過一次，否則圖樣就會消失，若要圖樣不消失可以在draw函數呼叫前先呼叫drawSteadyNext()，即可將圖樣釘住。

千萬不要把drawSteady放在run()裡，因為run()通常有可能跑上千次，會變成一樣的東西重複畫幾千遍，導致系統緩慢。另外若是畫圖的函數不夠用其實也是可以自建的，往後的範例會再提到。

2. ColorRef是什麼?

我稱它叫顏色參考，依照給入的值與顏色，可以判斷什麼情況使用什麼顏色。詳細可以參考文件。

3. 加入價格標籤?

參考18~27行，很容易理解。

---

不知道大家有沒發現這個範例沒有CustomCore_UI_INIT();也沒繼承CustomCore而是直接繼承ScriptCore?其實就是說這個範例沒有用"指標圖形介面"的library，為什麼不用呢?因為"指標圖形介面"其實已經整合了很多相關畫圖的功能，使用者其實不太需要自己處理圖層的部分，除非不打算使用"指標圖形介面"的library，或是要做比較低階的開發。

---

四個章節大概講完了acs-api的主要議題，還有些東西要用範例講會比較好，一方面我好解說，另一方面你們可以複製貼上。就降拉~謝謝收看!

acs-api快速入門(3) - 資料容器

2016-05-16T15:53:00.000+08:00

資料容器，就是放置一連串歷史資料的容器(類別)，這是寫腳本最最最常用的東西了，所以講的淺顯一點。

既然是一串資料，讀取資料時就必須指定資料的位置(時間、索引)，所以我們先看看資料存放的樣子。

\	前天	昨天	今天
	5月10日	5月11日	5月12日

t	0	1	2
sft	2	1	0
報價	100	105	108

又過一天...

\	大前天	前天	昨天	今天
	5月10日	5月11日	5月12日	5月13日

t	0	1	2	3
sft	3	2	1	0
報價	100	105	108	109

取值
t跟sft都是這個資料容器的索引，只是t是順時間算，而sft是逆時間算，只要有新的K棒出現這兩個值就會有些變化。t的特性是特定的t永遠能取得特定日期的資料，例如t等於1時永遠是5月11日。sft的特性是永遠能取得與今天保持特定距離的資料，例如sft等於1時永遠能取得'昨天'的資料。通常是sft比較符合我們分析資料的習慣，接下來我直接舉例用法比較快。

lib "personal";

public class MyScript extends CustomCorePersonal
{
 public void init()
 {
  CustomCore_UI_INIT();
 }

 //建立一個叫ma5的資料容器
 MovinNum ma5 = addMovinNum(null);
 public void run()
 {
  //透過MovinNum的內部連續運算(加速)方法運算5日均價
  ma5.ma(close, 0, 5);
  if (t == 100)
  {
   dbg.print("今天的收盤價 : " + close.get(t) + " 或 " + close.ref(0));
   dbg.print("昨天的收盤價 : " + close.ref(1));

   dbg.print("---");
   dbg.print("今天的5ma : " + ma5.ref(0));
   dbg.print("昨天的5ma : " + ma5.ref(1));

   //以下highest、lowest、avg函數在ScriptBasic中可以找到
   dbg.print("---");
   dbg.print("近5日的最高價 : " + highest(high, 5));
   dbg.print("近5日的最低價 : " + lowest(low, 5));
   dbg.print("---");
   dbg.print("今天的5ma : " + avg(close, 0, 5));
   dbg.print("昨天的5ma : " + avg(close, 1, 5));

   //到t等於100時結束腳本執行
   dbg.oprn();
   stop();
  }
 }
}

執行結果:
close就是"收盤價"的資料容器，後面接了get(t)與ref(sft)就是操作容器的函數(方法)，這兩個函數都是取值用的，如果還看不懂?自己執行一次試試看吧。

應該不算難理解吧?比較怪的是22跟30行，兩個都可以取得5日均價，其實兩個寫法都沒問題，主要是ma5.ma(close, 0, 5);與avg(close, 0, 5);的用處稍有不同，前者是用MovinNum內部的ma函數，有運算加速功能，後者是用ScriptBasic提供的avg函數，寫法比較簡短。如果ma5會在腳本中一直反覆被使用，建議用前者，如果只是偶爾用或求方便不考慮執行速度，可以用後者。

怎麼宣告?
直接看範例。

lib "personal";

public class MyScript extends CustomCorePersonal
{
 //從核心取得一個每個元素初始值為50的MovinNum
 public MovinNum var_1 = addMovinNum(50);

 //從核心取得一個沒有初始值MovinNum
 public MovinNum var_2 = addMovinNum();

 //自己建立一個每個元素初始值為MovinNum(異步)
 public MovinNum var_3 = new MovinNum(50);

 //自己建立一個沒有初始值MovinNum(異步)
 public MovinNum var_4 = new MovinNum();

 public void init()
 {
  //將自己建立的MovinNum加入核心(異步轉同步)
  joinMovinNum(var_3);
 }

 public void endOfPeriod(int type)
 {
  if (type == EOH)
  {
   dbg.open();
   dbg.print("執行了 : " + (t+1) + "根K棒");
   dbg.print("---");
   dbg.print("var_1 元素量 : " + var_1.size());
   dbg.print("var_2 元素量 : " + var_2.size());
   dbg.print("var_3 元素量 : " + var_3.size());
   dbg.print("var_4 元素量 : " + var_4.size());

   dbg.print("---");
   dbg.print("var_4 push 一個值進去 ");
   var_4.push(99);
   dbg.print("var_4 元素量 : " + var_4.size());
  }
 }
}

這裡宣告四個MovinNum，不同之處參考看註解，比較特別的是var_3跟var_4之後的用法。var_3之後在init時做了joinMovinNum的動作，其實就相當於透過addMovinNum函數得到的MovinNum，通常會這樣寫都是在宣告時不確定這個變數未來是會與K棒數量同步還是異步。var_4則沒有join，所以會變成一個異步的MovinNum，資料必須透過push的動作才會增加。

MovinNum的API
最後大致提一下操作資料容器常用的函數，這章就結束了。

函數	說明

double get(int t)	以t取值
double ref(int sft)	以sft取值
NumSet set(int t, Number value)	寫值,回傳自己
NumSet set(Number value)	寫值,回傳自己

boolean isNull(int t)	檢查第t個元素是否為null
boolean isNullRef(int sft)	檢查第sft個元素是否為null

NumSet highest(NumSet sample, int shift, int periodN)	最大值運算
NumSet lowest(NumSet sample, int shift, int periodN)	最小值運算
NumSet median(NumSet sample, int shift, int periodN)	中位數運算
NumSet stddev(NumSet sample, int shift, int periodN)	標準差運算
NumSet linear(NumSet sample, int shift, int periodN)	線性迴歸運算

NumSet avg(NumSet sample)	整體平均值運算
NumSet sum(NumSet sample, int shift, int periodN)	加總運算
NumSet ma(NumSet sample, int shift, int periodN)	移動平均運算
NumSet ema(NumSet sample, int shift, int periodN)	指數移動平均運算
NumSet sma(NumSet sample, int shift, int periodN)	平滑移動平均運算
NumSet wma(NumSet sample, int shift, int periodN)	加權移動平均運算

acs-api快速入門(2) - ScriptBasic

2016-05-13T14:37:00.001+08:00

承接上篇未完的acscriptcore，還欠ScriptBasic沒介紹到。

ScriptBasic - 腳本基礎
ScriptBasic中沒有任何的執行機制，純粹就是宣告常數，與一些常用的數學與系統函數。ScriptCore也繼承了這個類別，所以這些常數與函數都是可以直接使用的。

---

基礎數學運算。

函數	說明

double abs(double a)	取絕對值
long round(double a)	四捨五入
double round(double value, int digi)	保留小數的四捨五入
double ceil(double a)	無條件進位
double floor(double a)	無條件捨去
double pow(double a, double n)	次方運算
double sqrt(double a)	開根號
double log(double a)	取對數
double log(double a, double base)	取對數
double random(double min, double max)	取隨機值
double chgrate(Number value, Number base)	回傳變動率

---

"動態陣列"運算。寫指標或策略時這部分是最常用的。
因為同名函數的變形太多，這裡僅列出函數名稱，並以avg做概括說明。

函數名稱	說明

highest	取最大值
lowest	取最小值
sum	取總和
avg	取平均值
median	取中位數
stddev	取標準差
linear	取線性回歸值
change	取變動值
change_rate	取變動率

函數	說明

double avg(NumSet nset, int range)	取nset陣列在range內的平均值
double avg(NumSet nset, int shift, int range)	取nset陣列位移shift在range內的平均值 double ma5 = avg(close, 0, 5);

在函數參數裡有一個叫NumSet(數字集合)類別，其實就是MovinNum的父類別，所以丟"動態陣列"進去是完全ok的。

這裡大致解釋一下t跟sft的關係。t是我們比較習慣用來描述時間進行的方向，t等於零就是"最早的時候"，t越大表示時間經過越久。而sft的概念剛好顛倒，sft等於零是最"接近現在的時候"，sft越大表示離現在越遠，如下圖所示。

\	前天	昨天	今天

t	0	1	2
sft	2	1	0
close	100	105	108

在看K線時通常比較會用sft的角度看，也就是以今天為基準往以前看，所以這些函數也是一樣，例如avg(close, 1, 2)，就是說基準定在昨天(sft等於1)，取2日的平均值，也就是100跟105的平均值。

---

Java原生數字陣列運算。
因為同名函數的變形太多，這裡僅列出函數名稱，並以highest做概括說明。

函數名稱	說明

highest	取最大值
lowest	取最小值
sum	取總和
avg	取平均值
median	取中位數
stddev	取標準差
linear	取線性回歸值

函數	說明

double highest(double value, double... arr)	highest(1.5, 4.3, 3.1) 回傳4.3
double highest(double[] arr)	取最陣列中大值

---

時間函數。

函數	說明

int YMD(Date date)	日期轉數字例如20130101
int HMS(Date date)	日期轉數字例如134500
long YMDHMS(Date date)	日期轉數字例如20130101134500
int getTimeOfDay(Date date)	取得日期當天經過的毫秒數
int date2Int(Date date, String fmt)	日期轉數字
String date2Str(Date date, String fmt)	日期格式化
Date str2Date(String str, String fmt)	日期字串轉物件

boolean sameDate(Date date1, Date date2)	檢查兩個日期是否為同一天
boolean sameDate(long time1, long time2)	檢查兩個日期是否為同一天
boolean sameHour(Date date1, Date date2)	檢查兩個日期是否為同一小時
long daysBetween(Date date1, Date date2)	取得兩日期的天數差

便捷條件或選擇。

函數	說明

T iif(boolean bool, T a, T b)	便捷條件。若條件成立則回傳a,否則回傳b
T iif(double a, double b, T r1, T r2, T r3)	便捷條件。若數字a大於數字b則回傳r1,或數字a小於數字b則回傳r2,否則回傳r3
T select(int idx, T... obj)	便捷選擇。回傳與索引值相當序數的物件, 例如select(0, a, b, c)會回傳a

排序與搜尋。

函數	說明

T sort(T coll, int keyidx, boolean sortAsc)	排序 (排序的集合需繼承或實作Sortable)
int find(T sroted_coll, int keyidx, boolean sortAsc, int find_type, double target)	搜尋 (排序的集合需繼承或實作Sortable).

double[] sort(double[] arr)	數字陣列排序. (衍生於Java的Arrays物件)
int[] sort(NumSet num, int shift, int range, boolean sortAsc)	排序後回傳索引(偏移位置)陣列.

boolean isS2B(double... arr)	檢查數字排列是否由小到大
boolean isB2S(double... arr)	檢查數字排列是否由大到小
boolean isSeq(double... arr)	檢查數字排列是否有順序

其他函數。

函數	說明

void sleep(int us)	暫停(微秒)
String hex(int value)	十進制數字轉十六進制字串
String hex(Color color)	顏色轉十六進制字串
Color transp(Color color, int transp)	顏色加入透明度(透明度 0~255 0是完全透明)
Point getCrossPoint(Point L1A, Point L1B, Point L2A, Point L2B)	取得兩線交叉座標
void mailto(String usermail, String password, String toaddr, String subject, String contents)	寄出郵件 (僅支援gmail)
void sound(File file)	撥放聲音
String[] getSymbolCates()	取得符號分類選單陣列(做選單用)
String[] getCateSymbols(String cate)	取得特定符號分類的全部符號
String[] listSymbol(String match)	列出符號
String getSymbolName(String symbol)	取得符號名稱
boolean confirmDialog(String title, String msg)	彈出確認對話框
void msgDialog(String title, String msg)	彈出訊息對話框
String inpDialog(String title, String msg, String init_value)	彈出字串數入對話框
String fmtNum1(double value)	鉅額數字格式化1 例如'1億2345萬'
String fmtNum2(double value)	鉅額數字格式化2 例如'1.23億'
String readTextFile(File file)	讀取文字檔(一次讀完)
String readTextFile(File file, String charsetName)	讀取文字檔(一次讀完)
boolean saveTextFile(String text, File file)	寫入文字檔
boolean saveTextFile(String text, File file, String charsetName)	寫入文字檔
boolean saveImage(Component comp, String type, int width, int height, File file)	儲存圖檔
void webBrowser(String url)	開啟瀏覽器

--以下為常數定義--

方位。現僅用於畫字串(drawString)時指定方位。

型別	名稱	說明
int	CENTRAL	中央
int	TOP	上
int	BUTTON	下
int	LEFT	左
int	RIGHT	右
int	TOP_RIGHT	右上
int	TOP_LEFT	左上
int	BUTTON_RIGHT	右下
int	BUTTON_LEFT	左下

列表方向。用於列表物件，寫法大致如tbl.setListMode(TBL_LIST_UP);。

型別	名稱	說明
int	LIST_DOWN	向下表列
int	LIST_UP	向上表列

資料刻度。

型別	名稱	說明
int	PRECISE_AUTO	自動(通常會選擇'日')
int	PRECISE_DAY	日
int	PRECISE_MIN	分
int	PRECISE_SEC	秒
int	PRECISE_TICK	Tick

K線週期。

名稱	說明
PERIOD_AUTO	自動(通常會選擇'日')
PERIOD_TICK	Tick
PERIOD_SEC	秒
PERIOD_MIN	分
PERIOD_HOUR	小時
PERIOD_DAY	天
PERIOD_WEEK	周
PERIOD_MONTH	月
PERIOD_QUARTER	季
PERIOD_HALFYEAR	半年
PERIOD_YEAR	年
PERIOD_VOL	量
PERIOD_OC_CHANGE	開收價格變動
PERIOD_OC_CHANGER	開收價格變動百分比
PERIOD_HL_CHANGE	高低價格變動
PERIOD_HL_CHANGER	高低價格變動百分比
PERIOD_CUSTOM	自訂

排序序向。

型別	名稱	說明
int	S2B	正序(小到大)
int	B2S	倒序(大到小)

搜尋。

型別	名稱	說明
int	FIND_EQUAL	相等
int	FIND_BEFORE	相等或前一個
int	FIND_AFTER	相等或後一個

過濾。

型別	名稱	說明
boolean	IN_LIST	名單內
boolean	OUT_LIST	名單外

例外(Exception)處理方式。

型別	名稱	說明
int	EX_WRN	顯示警告後繼續執行
int	EX_ERR	稍後中斷,顯示警告後走完這次執行再中斷
int	EX_INT	立即中斷,顯示警告後立即中斷

週期結束(EO)類型。

型別	名稱	說明
int	EOB	end of bar
int	EOD	end of day
int	EOW	end of week
int	EOM	end of month
int	EOY	end of year
int	EOH	end of history
int	EOAH	end of all history(包含InnerCore)

特定常數轉為有意義文字陣列。

型別	名稱	說明
String[]	PERIOD_TEXT	K線週期文字陣列
String[]	PRECISE_TEXT	資料刻度文字陣列
String[]	DAY_TEXT	星期文字陣列
String[]	EO_TEXT	EO類型文字陣列

其他。

型別	名稱	說明
String	AC_LOCATION	程式執行路徑

acs-api快速入門(1) - ScriptCore

2016-05-13T12:03:00.000+08:00

前面已經介紹過acs-api在系統中的角色了，這邊就直接切入程式的部分吧!

首先從package的分類開始看

PACKAGE	說明

acscriptcore	腳本核心
acscriptcore.period	週期控制
acscriptcore.inpcom	圖形輸入元件

acscriptcore.datactnr	資料容器
acscriptcore.dataset	資料集
acscriptcore.calc	統計運算

acscriptcore.layer	圖層類
acscriptcore.table	表格類
acscriptcore.gears	小工具

這些PACKAGE中約莫有50個類別，要都看一遍?實在很乏味...所以這一系列講api的文章，我盡量挑常用的講，用瀏覽的方式看過一遍即可，是你用得上的東西自然就會記住，暫時用不上的留個印象即可，往後會再拿腳本實例來說明如何使用，就比較會不感到艱澀，或硬要搞懂一些與自身無關的東西，浪費時間。

然而最詳細準確的asc-api內容架構仍請參考docs/acsapi/index.html

acscriptcore - 腳本核心
與腳本運作有最直接的關聯。

ScriptCore類別 : 一直不斷的提到core、核心、腳本核心一詞，好像有些抽象，具體說到底是什麼?其實就是一個讓腳本能夠正常運作的內部機制，而這個機制主要來自於繼承ScriptCore，所以每個腳本的MyScript類別都必須繼承ScriptCore，無論是透過CustomCore或CustomCorePersonal都會繼承到ScriptCore。

系統執行常數。腳本中用來參考得知以何設定執行，也就是說這些變數是拿來讀的，不能寫入。

型別	名稱	說明
int	_SETTING_KSCALE_PERIOD	週期類型(年、月、周、日、分、秒等...)
int	_SETTING_KSCALE_N	週期基數
int	_SETTING_KSCALE_PRECISE	資料源刻度
String	symbol	符號(代碼)
String	name	符號名稱

系統執行變數。

型別	名稱	說明
int	t	時間點。從0起算，每根K棒+1。
int	tickofbar	當下K棒執行(run)的次數，即報價(Tick)次數。
int	tickofday	當日執行(run)的次數。
int	barofday	當下K棒位於當日的第幾根K棒
int	barsofaday	前日的K棒數量
int	tradedays	當下經過的交易天數
boolean	isEOH	歷史報價結束
boolean	isRTQuote	即時報價開始
boolean	isNewMin	此次報價為新的1分鐘

報價變數。為一類似陣列的型態，後面會再提及。

型別	名稱	說明
MovinDate	date	日期
MovinNum	close	收盤價
MovinNum	open	開盤價
MovinNum	high	最高價
MovinNum	low	最低價
MovinNum	vol	成交量

紀錄參考變數。大致都是記錄前一次報價的狀況，方便在下一次做比較，例如是否創新高、報價的單量等都可推算。

型別	名稱	說明
Date	first_date	第一個執行的日期
Date	prev_date	前一個執行的日期
double	prev_tick	前一個執行的收盤價位
double	prev_high	前一個執行的高點價位(當下K棒)
double	prev_low	前一個執行的低點價位(當下K棒)
long	prev_vol	前一個執行的量(當下K棒)

可控制物件。

型別	名稱	說明
DbgWin	dbg	除錯視窗
Table	tbl	列表控制元件
QUOTE	ds	報價資料集合

新增動態數字陣列。

函數	說明

MovinNum addMovinNum()	新增動態數字陣列
MovinNum addMovinNum(Number value)	新增動態數字陣列並給予初始值
MovinNum joinMovinNum(MovinNum arr)	加入動態數字陣列。同addMovinNum，但自己宣告arr物件。

MovinNum addSyncMovinNum(MovinNum arr)	新增動態數字陣列，並指定該陣列尾端數據與arr同步。
MovinNum addSyncMovinNum(MovinNum arr, int sync_sft)	同上，但同步的位置加上位移。

這個部分會稍微有點混亂。所謂"動態數字陣列"就是一個隨著K棒數量增加的陣列，要得到一個這樣的物件除了將他宣告實體化出來以外，還必須透過add或join讓ScriptCore認識，ScriptCore就會適時的替它增加資料量。當然也可以選擇不要add或join，改採自己增加資料量的方式(push)，也就是讓這個"動態數字陣列"做為一個"異步資料"，意即資料量與ScriptCore不相當，沒辦法用系統t取到t時間的值。在資料容器中會有範例。

另外後兩項也提到"同步"(sync)，但這裡指的同步就不是資料量的同步，而是"值"的同步。

加入合作物件或子核心。

函數	說明

void addCorePartner(CorePartner listener)	加入與Core合作的物件
removeCorePartner(CorePartner listener)	移除與Core合作的物件

boolean addInnerCore(ScriptCore inner_core, String symbol, Date from_date, Date end_date, int kscale_n, int kscale_period, int kscale_precise, boolean exec_inside)	加入另一個core(子核心)與當下的core時間同步執行
boolean isInnerCore()	判斷是否為子核心
void removeInnerCore(ScriptCore inner_core)	移除同步執行的core

CorePartner是一個介面類別(Interface)，所謂介面類別就像是一個模型外觀，只要仿造這個外觀再實做(implements)內容，就可以符合規範與特定api接合，就像是手機充電孔一樣，只要接頭符合就插得進去，不一定只能充電。
也就是說只要你有一個物件符合CorePartner的介面就可以加入核心，與核心同步執行，詳細的介面內容後面會再介紹。
而InnerCore(子核心)，有"內插"的意涵，作用就是可以在一個腳本核心裡面再建立核心，變成一個主核心+N個子核心的應用，就能夠一併分析或整合更多的資訊。

外觀控制。

函數	說明

void changeView(ScriptCore core)	切換當下圖格顯示的腳本核心
void changeView(String chart_name, ScriptCore core)	切換特定圖格顯示的腳本核心
void assignChartsSymbol(String symbol)	模擬類似在列表上點擊標的物的動作
void moveChartToFrom(Date date)	移動圖格起始日期
void moveChartToEnd(Date date)	移動圖格結束日期
void moveChartToRange(Date date1, Date date2)	移動圖格到區間日期
boolean saveChartImage(int width, int height, File file)	將圖格存成圖檔

資料或報價查詢。

函數	說明

Quote queryPrice(String symbol, Date date, int precise)	查詢標的物特定時間的報價
Object[] queryData(String symbol, Date date, String fmtID)	查詢標的物特定時間的資料

類別建構子	說明

PriceFlow(String symbol, int precise)	報價流。報價內容將隨著主腳本的時間自動更新。
DataFlow(String symbol, String fmtID)	資料流。資料內容將隨著主腳本的時間自動更新。

其他...

函數	說明

Layer addLayer(Layer master, int z_order, String params)	新增圖層
void updateTitle(String text)	更新圖格資訊標題(TitleBar)。使用HTML。
void updateInput(String text)	更新輸入面板。使用HTML。
void stop()	終止腳本執行。在列表腳本中若非即時盤應用，都需在最後加上stop()，避免佔用記憶體。
void restart()	重新執行腳本

參數實體。

函數	說明

void addParamIns(ParamIns obj)	加入參數實體
void removeParamIns(ParamIns ins)	移除參數實體
void clearParamIns(ParamIns ins)	清除參數實體的所有參數紀錄

boolean isParamRecored(ParamIns ins, String vname)	檢查某"參數實體"的參數是否已記錄
Args getInsParams(ParamIns ins, Class cls)	取得某"參數實體"的全部已記錄參數
boolean recParam(ParamIns ins, String vname)	記錄某"參數實體"的特定參數
InpComponent getInpComp(ParamIns ins, String vname)	取得屬於某特定參數實體的某項輸入元件

參數實體(ParamIns)指的是一個變數可以被記錄的物件，所以某個物件只要實做ParamIns的介面就可以擁有變數被記錄的特性。舉例說我們一直在用的MyScript就是一個ParamIns，因為MyScript繼承了ScriptCore，而ScriptCore裡實做(implements)了ParamIns的介面，如果你自己做的物件也需要這樣的功能，那就實做ParamIns介面吧。
這個部分與"輸入元件"是相關聯的，因為輸入元件的調整的參數就是對應到ParamIns中的變數。

面板元件。

類別	說明

class AcPanel	AC中用來取代JPanel
class AcTabbedPane	AC中用來取代JTabbedPane
class HtmlPanel	HTML面板
class AcTable	表格類別

AcPanel與AcTabbedPane主要用於圖格的側邊選單，能夠記錄前次操作停留的位置。HtmlPanel主要用來顯示"輸入元件"，所有的輸入元件都是轉成HTML碼顯示。

輸入元件。

類別	說明

class InpNum	數字
class InpDate	日期
class InpSlt	選項1(Spinner)
class InpSlt2	選項2(ComboBox)
class InpMenu	選單(matrix)
class InpText	字串欄
class InpBtn	按鈕
class InpChk	勾選元件-True/False
class InpChk_S	勾選元件-多選一
class InpColor	顏色選擇
class InpLab	文字標籤(類似InpBtn)

acscriptcore.inpcom - 圖形輸入元件
這個部分其實只剩下類別介面(Interface)與輸入元件的父類別，真正會被實體化的輸入元件都直接宣告在ScriptCore裡了(InpNum、InpDate...)，所以這個部分沒什麼好看的了，後續再看看輸入元件的使用範例即可。

---

沒想到簡短的整理出來還是這麼一長串，但應該還是比直接看文件有系統性。接著挑戰吧!

腳本應用型態

2016-05-11T13:13:00.000+08:00

AC中腳本的應用主要有兩種型態，一種是圖格，另一種就是列表，除了顯示輸出的方式不同外，下圖可以看出執行上的差異。

圖格腳本 - 個別分析
(放置在/script/chart/下)
左邊為圖格腳本運作的情形，主要是針對"單一標的物"的分析，並以圖形輸出結果。

列表腳本 - 批次個別分析
(放置在/script/table/下)
右邊為列表腳本運作的情形，主要是針對"一群標的物"的"個別分析"，並以列表輸出結果。特別要注意的是，列表腳本在運作時是將每一個標的物個別產生執行核心，也就是N個標的物就會產生N個MyScript物件，每個核心物件都是獨立運作。

另一種運用是盤中的即時盤，例如盤中即時通知出量或黃金交叉的個股。

整體分析
如果是做期貨或個股操作，以上兩種應用的模式大概就足夠了，但股票世界裡還有一個更棘手的問題，就是選股。

選股通常是要做整體分析，數據量化、互相比較、排序、剔除等，這時候就會用一個圖格腳本為基礎，再以內部動態產生innerCore的方式分析每檔標的物，並讓一個主核心操作所有子核心，最後再用列表物件顯示在側邊選單。

這樣的用法除了拿來做選股外，還可以做一些特別的應用，像是AC內建的"台股交易大富翁"...

---

這篇就寫到這了，感覺並沒有寫出我所想表達的內容，但該說的又都說了...是怎樣...

我想結論就是...要看到K線圖的就把腳本放在/script/chart/裡，要用圖表顯示個別資訊的就把腳本放在/script/table/裡，要集兩者於一身的...比較複雜，可以參考多符號(股票)並行(InnerCore)。

腳本系統架構

2016-05-04T21:29:00.000+08:00

先談一下何謂API(程式介面)，舉例來說，我寫了一個功能強大的程式，在你的程式中想要用我程式中的某些功能，這時候透過的就是所謂的API，即程式與程式間的接合介面。我們先看一下哪些部份有提供API讓腳本使用。

java-api:Java語言原生的程式介面。

ac-api:AC系統提供給使用者開發Plugin(外掛)的程式介面。

acs-api:AC系統提供給使用者開發腳本的程式介面。

plugin-api:Plugin(外掛)提供給使用者開發腳本的程式介面。

library-api:使用者自行設計、或第三方提供給使用者開發腳本的程式介面。

(API一詞我們稱"介面"，對岸稱做"接口"，聽慣了也算蠻貼切的。)

這五個方塊中只有"腳本、Library、Plugin"是使用者能夠加以開發設計的，而Java與AC System就相當於是我們的執行平台，提供介面(接口)的。

腳本
腳本其實就是一個能與AC System結合的Java程式，保有原本Java的特性又有適合做金融分析的程式介面。上圖可以看到四個淺藍色的箭頭，就是腳本能夠使用的介面，其中Java-api與acs-api是有文件可以查詢的，但plugin跟library因為比較靈活多變，就只能看程式碼查詢了，但比較常用的部份我還是會寫教學的。

---

Library(程式/函式庫)
所謂library就像是一個人，腦袋裝不了所有的知識學問，但有需要的話只要上'圖書館'就萬事OK了。把一些有獨立功能的腳本放到library裡，讓其他的腳本也能借閱，就是library的功能，本身其實也是腳本，只是沒有"程式的進入點"，只能被動的被使用。

現在的AC中就有一個非常重要的library，就是CustomCore，CustomCore裡寫好了指標及圖形介面，所以主腳本(MyScript)都會繼承CustomCore，因為繼承後該有的東西就大概都有了，省時省力。

---

Plugin(外掛)
外掛程式是一個能與AC同時執行的程式，執行期間能透過ac-api向AC要求資料或進行命令，最常用的介面大概就是操作資料庫寫入報價之類。

另一個方面，外掛還可以提供介面讓腳本使用，舉例說，我可以寫一個腳本透過即時報價的外掛取得某個標的物的內外盤價、掛單量等。通常這些介面都是跟外掛本身的功能有關，不然直接寫library就可以了。

腳本中預先實體化指標

2016-05-03T16:05:00.001+08:00

在前面有介紹過指標圖形介面操作示範 ，教我們怎麼透過圖形介面在圖格中加上指標，但這樣建完了指標要怎麼在腳本中使用啊?

最陽春的腳本
既然都要提到腳本了，就先來看一下最陽春的腳本長什麼樣子

lib "personal";

public class MyScript extends CustomCorePersonal
{
 public void init()
 {
  CustomCore_UI_INIT();
 }
}

行1 : 引用script\library\personal下的程式碼。
行3 : MyScript是主腳本類別的固定名稱，後面並說明這個類別繼承了另一個叫CustomCorePersonal的類別。
行7 : CustomCore_UI_INIT()是指標圖形介面初始化的函數。
這樣的寫法幾乎是固定的，如果上面的解釋真的看不懂也無所謂，接觸多了自然就懂了。

腳本中預先實體化指標
1. 先點選[設定]
2. 再點選[導出指標參數]，就可以在除錯視窗中看到一串程式碼。

3. 再將這串程式碼貼到你的程式中即可。如下範例的5~10行。

lib "personal";

public class MyScript extends CustomCorePersonal
{
 IDCT_K idct_k = addIdct("K線", "K線", new IDCT_K("_tag[0]=true&_color[0]=4290752892")); 
 BOLL boll = addIdct("K線", "布林通道", new BOLL("_color[0]=4278203391")); 
 DEDUCTION deduction = addIdct("K線", "標記扣抵_3", new DEDUCTION("_color[0]=4278203391")); 
 IDCT_VOL idct_vol = addIdct("量", "成交量_4", new IDCT_VOL("")); 
 KD kd = addIdct("KD", "KD_5", new KD("")); 
 SIGNAL_TWO_LINE signal_two_line = addIdct("KD", "交叉信號_6", new SIGNAL_TWO_LINE("_ref_sample_id[0]=KD_5.K&_ref_sample_id[10]=KD_5.D")); 

 public void init()
 {
  CustomCore_UI_INIT();
 }
}

4. 之後取值可以寫成像是kd.ref(0)或kd.k.ref(0)之類，若要詳細知道指標裡有哪些變數，可以到script\library\accustomcore\src\IDCTs\下找找原始碼。

這個範例腳本執行出來會與原本用圖形介面建立的畫面有一些些差別，因為並沒有導出圖格選項的參數，未來會再加強。

是跟以往直接敲程式碼的方式有些不同，但我比較喜歡現在這樣，不用記太多類別名稱，宣告跟參數調整都透過圖形介面完成，確定了再貼上程式碼。

動態取得指標

還有另一種做法，比較不建議就是了，看看就好，或是直接跳過。

lib "personal";

public class MyScript extends CustomCorePersonal
{
 public void init()
 {
  //對CustomCore_UI初始化
  CustomCore_UI_INIT();

  IDCT kd = getIdct("KD_5"); //若指標"KD_5"沒找到會被中斷執行,可暫時將這行移除
  dbg.print("有取得指標'KD_5'嗎?" + (kd!=null?"yes":"no"));
 }
}

看第10行就好，這個方法連宣告都免了，直接用指標的名稱取得指標物件，但因為這樣的做法變成一定要先透過圖形介面建立好指標，否則腳本也不能運作，腳本就失去了獨立執行的機能，所以我比較不建議這樣做。

在列表式腳本中加上指標

上面講的都是圖格式的腳本，那列表式的腳本呢?

lib "personal";

public class MyScript extends CustomCore
{
 KD kd = addIdct("KD", "KD_5", new KD("")); 


 public void init()
 {
  cc_cfg.SHOW_MENU = false;
  cc_cfg.PAINT_LAYER = false;
  CustomCore_UI_INIT();

  tbl.addCol("收盤", 2, RIGHT, true);
  tbl.addCol("KD.K", 2, RIGHT, true);
 }

 public void endOfPeriod(int type)
 {
  if (type != EOH)
   return;
  if (t<=0)
   return;

  AcTableRow row = tbl.newRow(symbol, name);
  tbl.addRow(row);

  row.setCell(0, close.ref(0), close.ref(0), black);
  row.setCell(1, kd.ref(0), round(kd.ref(0), 1), black);
 }
}

也差不多，在CustomCore_UI_INIT()的前面加兩行，取消圖格與側邊選單的設定即可。

---

可能有人發現...KD的宣告都沒設定週期參數?...
其實只要在圖形介面設定過再導出一次就會有了，如果都沒有設定過就會用預設值，也就不會導出了。

即時報價與盤後更新

2016-05-03T14:23:00.002+08:00

介紹兩個最常用的外掛，都跟報價有關，一個是即時報價，另一個是盤後更新。像我自己是做期貨的，盤中時跑即時報價，收盤再跑盤後更新，因為盤中的報價算是相對不穩定，所以盤後再複寫一次期交所公布的報價，確保隔日開盤所有的技術分析指標是正確的。

報價的用途應該不用多說吧!直接看看怎麼設定。

即時報價

大致看到的畫面是這樣，左邊是要報價的項目，右邊是報價源的設定。這邊以"康和期貨"的"全都賺"為例，進到報價項目的設定看看。

報價項目-大台

符號來源:指AC內部要被報價的符號。

連線符號:指給報價源(DDE)看的符號，通常要查券商軟體才知道。

報價來源:指定這個報價設定使用的報價來源。

自動連接:AC啟動後N秒內自動連接。

接收時間:系統時間不在接收時間內收到的報價會被丟棄。

開收時間:報價源時間不在開收盤時間內收到的報價會被丟棄。

儲存刻度:視腳本需求選擇適合的刻度。

報價時間以系統時間取代:當報價源(DDE)不提供時間欄位時須將此勾選。

報價項目-股票

符號來源:指AC內部要被報價的群組。

連線符號:指給報價源(DDE)看的符號，通常要查券商軟體才知道。
這裡用了一個大括號跟s1，舉例說AC內部的台泥代碼是tw.1101，
tw就是{s0}而1101就是{s1}，故取{s1}對應DDE的符號。
還有些特殊的轉換，像是{KS_MY}就是專門針對"E閃電"的。

DDE設定

欄位樣板:依樣板組成DDE字串。

{connsymbol}:會替換成上面講的連線符號。

{item}:會依類型替換成圖中的欄位。

FIRE:指這是最後一個收到的欄位，當收到時就完成了一個報價，一定要選擇一個欄位勾選。

如何知道我券商軟體的DDE設定?
以台証的看盤軟體大三元為例，通常都會有一頁設定，特別講述DDE的，或直接從某檔股票拖曳到Excel或OpenOffice的Calc中就會出現。

一個大三元DDE連線的表示式大致如下:
TS|KS!TXFD1.123
就是:
SERVICE|TOPIC!CONNSYMBOL.ITEM
對應成中文就是:
服務代號|連線主題!標的代碼.資料欄位代號

在Excel裡，這個表示式就藏在每個欄位裡，所以那些欄位的數據才會跳動...

盤後更新
這個部分重點不多，比較有困擾的就是更新偶爾會失效，因為官方網站有時會修改連結或內容，如果沒能及時更正還請各位見諒。
補充一個關於用RPT(一個由期交所提供下載的報價資料檔)回補期貨報價的部分，只要依設定裡的"範例路徑"置放檔案，並將"最新資料日期"倒回要更新的日期再按下更新即可。另外一個要注意的是如果要大量插入分、秒、Tick一類的資料，建議將標的物報價刪除再行更新，否則速度會非常慢。

另外還可加入Yahoo Finance的報價數據，如果有在追蹤國際股市或美股的投資人，這也是一個方便小工具。

指標圖形介面操作示範

2016-05-02T18:50:00.000+08:00

這個章節要示範怎麼透過圖形介面把指標加入到圖格中，並做成範本，再做成佈局。

指標設定畫面
在我的設定中，每個指標(或功能)都對應一個圖層，所以新增指標就要先新增圖層。圖層又區分主圖層跟子圖層，區別在於子圖層是依附在主圖層中，而圖格的定義是以其外觀視之，就類似這裡的主圖層。聽不懂!?沒關係~就通通當作圖層就好。

接著看看影片中的操作就懂了。

再重貼一次之前的"基礎導覽"，裡面有介紹一些內建的應用，沒看過的加減看。

這裡看完，AC的初階使用就大概結束了，後面接著會講腳本開發或比較進階的部分，對寫程式感到無力的朋友...希望下次還能見到你XD

檔案及目錄簡介

2016-05-02T12:30:00.000+08:00

從上一篇畫面及選單簡介其實可以看出來AC的選單選項並不是很多，但實際上還有一些不太常調整的設定沒有做出介面，透過這個章節將介紹一些相關的檔案與目錄架構讓你更上手。

根目錄

config:AC主要設定目錄。

database:數據資料庫。

docs:API文件。

plugin:外掛放置目錄。

plugin_dev:外掛開發原始碼放置目錄。

script:腳本放置目錄。

sound:聲音檔目錄(給腳本用)。

sqldb:SQLite資料庫放置目錄(給腳本用)。

---

AceChart.exe:AC的主要也是唯一執行檔。

ace.NAME.160309.license:授權檔，保留最新的即可，避免混淆。

acapi.jar:AC-API，供外掛使用的程式介面。

acsapi.jar:AC-Script-API，供腳本使用的程式介面。

vm.ini:可用來設定AC記憶體的大小。通常在巨大的回測系統才有修改的必要。

Config

layout:佈局檔放置目錄。

style:外觀設定檔放置目錄。(略失修)

symbol:列表庫(股票池)放置目錄。

template:範本放置目錄。

---

IndexComponents.xml:集合符號檔。

lang.xml:語系檔。(失修)

links.xml:"連結到..."的設定檔。

muxtable.xml:不再使用。

symbolspec.xml:符號特徵檔。現只用來規範開收盤時間。

syscfg.xml:AC的系統設定檔。很久沒整理有些亂，主要可以修改
"文字編輯器路徑"、"資料庫路徑"、"桌面數量"、"JDK路徑"。

Database

1day:報價-日刻度。

1min:報價-分刻度。

1sec:報價-秒刻度。

1tick:報價-Tick刻度。

---

AC-DataServer.xml:盤後資料更新設定檔(外掛程式使用)。

dbfmt.xml:資料格式檔。

namemap.cache:名稱對應快取檔

Script

chart:圖格式腳本放置目錄。

library:程式庫腳本放置目錄，可供各腳本引用。

report:報告式腳本放置目錄。

sys:系統腳本放置目錄，現只有一個給系統"快查"使用。

table:列表式腳本放置目錄。

大致上是這樣了，另外要注意的就是修改設定檔時一定要用"純文字編輯器"，不能用Office、Word之類的軟體，還有修改前要關閉AC，並且記得備份檔案。

純文字編輯器可以下載免費又有中文化的Notepad++。