pk4adi.pkc
==========

.. py:module:: pk4adi.pkc

.. autoapi-nested-parse::

   @File    :   pkc.py
   @Contact :   Jiang Feng(silencejiang@zju.edu.cn)
   @License :   (C)Copyright 2004-2020, Zhejiang University



Functions
---------

.. autoapisummary::

   pk4adi.pkc.compare_pks
   pk4adi.pkc.print_pks


Module Contents
---------------

.. py:function:: compare_pks(pk1, pk2, auto_print=True)

   Compare two answers of the pk values, which is the output of the function calculate_pk().
       print_pks() will be called before returning ans by default.

   :param pk1: The output of the function calculate_pk().
   :type pk1: a dict.
   :param pk2: The output of the function calculate_pk().
   :type pk2: a dict.
   :param auto_print: Whether to print the ans before returning it or not.
   :type auto_print: bool.

   :returns: **ans** -- A dict containing all the matrix and variables involved.
             Use the script 'print(ans.keys())' to get the details.
             Specially, the P values and the interal it located will
             be calculated using the scipy.stats packages.
             The most important variables have already been printed.
   :rtype: a dict.

   .. rubric:: 引用

   To be added.

   .. rubric:: 备注

   To be added.


.. py:function:: print_pks(result, floatfmt='.3f', tablefmt='simple')

   Pretty display of two pk calculation result comparison.

   :param result: Must be the return value of function compare_pks().
   :type result: a dict.
   :param floatfmt: Decimal number formatting.
   :type floatfmt: string.
   :param tablefmt: Table format (e.g. 'simple', 'plain', 'html', 'latex', 'grid', 'rst').
                    For a full list of available formats, please refer to
                    https://pypi.org/project/tabulate/
   :type tablefmt: string.

   :rtype: Nothing will be returned.

   .. rubric:: 备注

   To be added.