.. _analytics:

:mod:`analytics` -- 股票分析模組
==================================

.. module:: analytics

:mod:`analytics` 提供了 :class:`Analytics` 股票基本分析以及 :class:`BestFourPoint`
四大買賣點分析。:class:`Analytics` 會直接由 :py:class:`stock.Stock` 繼承，因此可以在
:class:`stock.Stock` 之中直接使用。


.. note::

   :mod:`analytics` 之分析，僅適用於 :class:`stock.Stock` 歷史資料，無法針對
   :mod:`realtime` 之資料進行分析。



基本分析模組 - Analytics
-------------------------

.. class:: Analytics

   基本股票分析模組。

   .. method:: continuous(data)

      :param data: 資料樣本
      :type data: list

      分析 ``data`` 持續上升之天數。

   .. method:: moving_average(data, days)

      :param data: 資料樣本
      :type data: list
      :param days: 天數
      :type days: int

      分析 ``data`` 中之 ``days`` 日之平均數::

          >>> stock.moving_average(stock.price, 5)     # 分析 5 日均價
          >>> stock.moving_average(stock.capacity, 5)  # 分析 5 日均量

   .. method:: ma_bias_ratio(day1, day2)

      :param day1: n 日
      :type day1: int
      :param day2: m 日
      :type day2: int

      分析乖離率 (均價), ``day1`` - ``day2``


   .. method:: ma_bias_ratio_pivot(data, sample_size=5, positive=False)

      :param data: 資料樣本, 通常使用 ``price``
      :type data: list
      :param sample_size: 計算的區間樣本數量
      :type sample_size: int
      :param positive: 正乖離 (``True``), 負乖離 (``False``)
      :type positive: bool

      計算正負乖離轉折位置


四大買賣點分析 - BestFourPoint
-------------------------------

.. class:: BestFourPoint(stock)

   :param stock: 欲分析之股票
   :type stock: :class:`stock.Stock`

   四大買賣點判斷

   .. method:: bias_ratio(position=False)

      :param positive: 正乖離 (``True``), 負乖離 (``False``)
      :type positive: bool

      判斷 3, 6 日正負乖離率

   .. method:: plus_bias_ratio()

      判斷 3, 6 日正乖離率

   .. method:: mins_bias_ratio()

      判斷 3, 6 日負乖離率

   .. method:: best_buy_1()

      :rtype: bool

      判斷買點一: 是否量大收紅

   .. method:: best_buy_2()

      :rtype: bool

      判斷買點二: 是否量縮價不跌

   .. method:: best_buy_3()

      :rtype: bool

      判斷買點三: 是否三日均價由下往上

   .. method:: best_buy_4()

      :rtype: bool

      判斷買點四: 三日均價大於六日均價

   .. method:: best_sell_1()

      :rtype: bool

      判斷賣點一: 是否量大收黑

   .. method:: best_sell_2()

      :rtype: bool

      判斷賣點二: 是否量縮價跌

   .. method:: best_sell_3()

      :rtype: bool

      判斷賣點三: 是否三日均價由上往下

   .. method:: best_sell_4()

      :rtype: bool

      判斷賣點四: 三日均價小於六日均價

   .. method:: best_four_point_to_buy()

      :rtype: bool, str

      如果為買點，回傳所有符合之買點原則，否則回傳 False

   .. method:: best_four_point_to_sell()

      :rtype: bool, str

      如果為賣點，回傳所有符合之賣點原則，否則回傳 False

   .. method:: best_four_point()

      :rtype: (bool, str), None

      如果為買點，回傳 ``(True, msg)``，如果為賣點，回傳 ``(False, msg)``，
      如果皆不符合，回傳 ``None``。