Merge pull request #121 from LI-Yixuan/updated_delta_delta

updated delta-delta plot

Author: josesho

.gitignore

@@ -125,3 +125,6 @@ tex.cache/
 testtt.py
 real.py
 0to2_beforeduringafter.csv
+
+TEST.ipynb
+TrhCsCh.csv

dabest/_api.py

@@ -4,8 +4,10 @@
 # Email : joseshowh@gmail.com
 
 
-def load(data, idx, x=None, y=None, paired=None, id_col=None,
-        ci=95, resamples=5000, random_seed=12345, proportional=False):
+def load(data, idx=None, x=None, y=None, paired=None, id_col=None,
+        ci=95, resamples=5000, random_seed=12345, proportional=False, 
+        delta2 = False, experiment = None, experiment_label = None,
+        x1_level = None):
     '''
     Loads data in preparation for estimation statistics.
 
@@ -18,7 +20,10 @@ def load(data, idx, x=None, y=None, paired=None, id_col=None,
         List of column names (if 'x' is not supplied) or of category names
         (if 'x' is supplied). This can be expressed as a tuple of tuples,
         with each individual tuple producing its own contrast plot
-    x : string, default None
+    x : string or list, default None
+        Column name(s) of the independent variable. This can be expressed as
+        a list of 2 elements if and only if 'delta2' is True; otherwise it 
+        can only be a string.
     y : string, default None
         Column names for data to be plotted on the x-axis and y-axis.
     paired : string, default None
@@ -37,6 +42,19 @@ def load(data, idx, x=None, y=None, paired=None, id_col=None,
         reported are replicable.
     proportional : boolean, default False. 
         TO INCLUDE MORE DESCRIPTION ABOUT DATA FORMAT
+    delta2 : boolean, default False
+        Indicator of delta-delta experiment
+    experiment : String, default None
+        The name of the column of the dataframe which contains the label of 
+        experiments
+    experiment_lab : list, default None
+        A list of String to specify the order of subplots for delta-delta plots.
+        This can be expressed as a list of 2 elements if and only if 'delta2' 
+        is True; otherwise it can only be a string. 
+    x1_level : list, default None
+        A list of String to specify the order of subplots for delta-delta plots.
+        This can be expressed as a list of 2 elements if and only if 'delta2' 
+        is True; otherwise it can only be a string. 
 
     Returns
     -------
@@ -65,4 +83,4 @@ def load(data, idx, x=None, y=None, paired=None, id_col=None,
     '''
     from ._classes import Dabest
 
-    return Dabest(data, idx, x, y, paired, id_col, ci, resamples, random_seed, proportional)
+    return Dabest(data, idx, x, y, paired, id_col, ci, resamples, random_seed, proportional, delta2, experiment, experiment_label, x1_level)