Better documentation for driver/engines

Removed the REST v2.0 documentation in favor of getting v1.0 working with driver/engine model

server/app/driver/driver.py

@@ -14,18 +14,10 @@ class CXGDriver(metaclass=ABCMeta):
     def _load_or_infer_schema(data):
         pass
 
-    @abstractmethod
-    def _set_cell_ids(self):
-        pass
-
     @abstractmethod
     def cells(self):
         pass
 
-    @abstractmethod
-    def cellids(self):
-        pass
-
     @abstractmethod
     def genes(self):
         pass
@@ -34,21 +26,25 @@ class CXGDriver(metaclass=ABCMeta):
     def filter_cells(self, filter):
         """
         Filter cells from data and return a subset of the data
+        A filter is a dictionary where the key is a metadatata category
+        Value is dictionary
+            value_type: int, float, string
+            variable_type: continuous, categorical
+            query: filter value, for categorical [val1, val2], for continuous {min: x, max:y}
+        Filters are combined with the and operator
         :param filter:
         :return: filtered dataframe
         """
         pass
 
-    # Should this return the order of metadata fields as the first value?
     @abstractmethod
     def metadata(self, df, fields=None):
         """
-        Generator for metadata. Gets the metadata values cell by cell and returns all value
-        or only certain values if names is not None
+         Gets metadata key:value for each cells
 
         :param df: from filter_cells, dataframe
         :param fields: list of keys for metadata to return, returns all metadata values if not set.
-        :return: Iterator for cellid + list of cells metadata values  ex. [cell-id, val1, val2, val3]
+        :return: list of metadata values
         """
         pass
 
@@ -57,7 +53,7 @@ class CXGDriver(metaclass=ABCMeta):
         """
         Computes a n-d layout for cells through dimensionality reduction.
         :param df: from filter_cells, dataframe
-        :return: Iterator for [cellid-1, pos1, pos2], [cellid-2, pos1, pos2]
+        :return:  [cellid, x, y]
         """
         pass
 
@@ -65,14 +61,21 @@ class CXGDriver(metaclass=ABCMeta):
     def diffexp(self, df1, df2):
         """
         Computes the top differentially expressed genes between two clusters
-
-        :param df1: First set of cells
-        :param df2: Second set of cells
-        :return: Up in the air: I recommend [gene name, mean_expression_cells1,
-                                            mean_expression_cells2, average_difference, statistic_value]
+        :param df1: from filter_cells, dataframe containing first set of cells
+        :param df2: from filter_cells, dataframe containing second set of cells
+        :return: top genes, stats and expression values for top genes
         """
         pass
 
     @abstractmethod
     def expression(self, df):
+        """
+        Retrieves expression for each gene for cells in data frame
+        :param df:
+        :return: {
+            "genes": list of genes,
+            "cells": list of cells and expression list,
+            "nonzero_gene_count": number of nonzero genes
+        }
+        """
         pass